quat_image_multiply — QUAT algebra op

Datenarten: qimage × qimageqimage

Aufruf: import quatimage; quatimage.quat_image_multiply(qimage, other, side) -> 'np.ndarray' (oder opsquat.get("quat_image_multiply"))

Verwendung

Hamilton-Produkt eines Quaternionenbildes mit einer Quaternion oder einem Feld. → (H, W, 4).

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

`side="left" computes other * qimage; side="right"` computes

`qimage * other. **There is no default** — see :func:_require_side`. The

two results are genuinely different objects, not a sign convention: measured

on a standard-normal `(32, 32, 4)` field against a unit rotor,

`max|left - right| = 3.143 and mean|left - right| = 0.4948` on data

whose own extreme is 3.372 — that is, the two answers differ by as much as

the data itself. Neither raises, neither is NaN, and both look like a

perfectly good quaternion image.

*other* is either a single quaternion (a `(4,)` array-like) or a full

`(H, W, 4)` field of the same shape; anything else is refused rather than

broadcast, because NumPy would happily broadcast a `(H, 4)` array along the

wrong axis and produce an image-shaped answer to a different question.

Raises `ValueError`: either input is not a valid quaternion field;

*other* is neither `(4,) nor exactly qimage`'s shape; *side* is not

`'left' / 'right'`.

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_monogenicpy -3.11 examples/quaternion_monogenic.py

Typkompatible Folge-Operatoren (nehmen qimage als Eingabe)

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

Gleiche Kategorie (algebra)

quat_conjugate_image · quat_normalize_image


*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.