quat_normalize_image — QUAT algebra op

• データ種: qimage → qimage

• 呼び出し: import fullseye as fs; fs.ledger.quat_normalize_image(qimage) -> 'np.ndarray' (実装を直接呼ぶなら import quatimage; quatimage.quat_normalize_image(qimage) -> 'np.ndarray'、台帳から引くなら opsquat.get("quat_normalize_image"))

使い方

Per-pixel normalisation to unit modulus. → (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 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。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

型が繋がる次の op(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 operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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