rgb_to_quaternion — QUAT `convert` op

• Datenarten: rgbimage → qimage

• Aufruf: import quatimage; quatimage.rgb_to_quaternion(image_rgb) -> 'np.ndarray' (oder opsquat.get("rgb_to_quaternion"))

Verwendung

Bettet ein Farbbild als reine Quaternionen `0 + R i + G j + B k` ein. → (H, W, 4).

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

Sangwine's 1996 encoding, and the entry point of the whole colour half of

this module: once a pixel is a quaternion, `q x conj(q)` rotates its colour

and :func:qft2 transforms the three channels as one hypercomplex signal

instead of three unrelated real ones.

The scalar (`w`) component is set to exactly zero — a *pure* quaternion —

because that is what makes the conjugation a 3-D rotation. Values are not

clamped: linear RGB after black-level subtraction legitimately goes negative,

and clipping it would change the colour direction, which is the quantity

every operator downstream reads.

Raises `ValueError: *image_rgb* is not a finite (H, W, 3)` numeric

array, is complex / bool / string-typed / masked, or exceeds

:data:MAX_PIXELS.

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_normalize_image · quat_image_multiply · monogenic_amplitude · monogenic_phase · monogenic_orientation

Gleiche Kategorie (`convert`)

quaternion_to_rgb · quat_norm

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

rgb_to_quaternion — QUAT convert op