quat_normalize_image — QUAT algebra op

• Datenarten: qimage → qimage

• Aufruf: import fullseye as fs; fs.ledger.quat_normalize_image(qimage) -> 'np.ndarray' (die Implementierung direkt: import quatimage; quatimage.quat_normalize_image(qimage) -> 'np.ndarray'; aus dem Register: opsquat.get("quat_normalize_image"))

Verwendung

Normierung pro Pixel auf Einheitsbetrag. → (H, W, 4).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie quaternion_monogenic

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

Typkompatible Folge-Operatoren (nehmen qimage als Eingabe)

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

Gleiche Kategorie (algebra)

quat_conjugate_image · quat_image_multiply


*Provenance: quatimage.py — QUAT Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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