quat_normalize_image — QUAT algebra op

• 데이터 종류: qimage → qimage

• 호출: import quatimage; quatimage.quat_normalize_image(qimage) -> 'np.ndarray'(또는 opsquat.get("quat_normalize_image"))

사용법

화소별로 크기 1 로 정규화. → (H, W, 4).

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

Fail-closed on a zero pixel. A quaternion image routinely contains exact

zeros — a black pixel is `(0,0,0,0)` — so the case is not hypothetical, and

a zero quaternion has no direction to normalise towards. It is refused by

name, with the count and the first offending pixel's row and column in the

message, rather than divided by `norm + eps`: that idiom returns zero, and

a zero used as a rotor becomes the identity rotation with no exception

and no NaN to mark it. (`pose_quat.quat_normalize` did exactly that until

2026-09-01 and now fail-closes too; see :func:quat_color_rotate.)

Raises `ValueError`: any pixel has modulus 0.

자세한 사용 가이드

• quaternion_monogenic 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

타입이 이어지는 다음 연산자(qimage 를 입력으로 받는 것)

quaternion_to_rgb · quat_norm · quat_conjugate_image · quat_image_multiply · monogenic_amplitude · monogenic_phase · monogenic_orientation · quat_color_rotate

같은 카테고리(algebra)

quat_conjugate_image · quat_image_multiply

*Provenance: quatimage.py — QUAT 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.