rgb_to_quaternion — QUAT convert op

• Data kinds: rgbimage → qimage

• Call: import fullseye as fs; fs.ledger.rgb_to_quaternion(image_rgb) -> 'np.ndarray' (implementation को सीधे call करना हो तो import quatimage; quatimage.rgb_to_quaternion(image_rgb) -> 'np.ndarray', registry से लेना हो तो opsquat.get("rgb_to_quaternion"))

उपयोग

colour image को pure quaternions 0 + R i + G j + B k के रूप में embed करता है। → (H, W, 4)।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

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

उपयोग की विस्तृत guide

• quaternion_monogenic family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py

वे अगले ops जिनसे type जुड़ता है (qimage को input के रूप में लेते हैं)

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

इसी category के (convert)

quaternion_to_rgb · quat_norm


*Provenance: quatimage.py — QUAT operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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