quat_normalize_image — QUAT `algebra` op

• Datenarten: qimage → qimage

• Aufruf: import quatimage; quatimage.quat_normalize_image(qimage) -> 'np.ndarray' (oder 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 :func: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).*

quat_normalize_image — QUAT algebra op