quaternion_to_rgb — QUAT convert op

• Data kinds: qimage → rgbimage

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

उपयोग

quaternion image का vector भाग, linear RGB के रूप में। → (H, W, 3)।

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

The inverse of rgb_to_quaternion — and, by default, a *checked* inverse. A quaternion image that picked up a scalar component somewhere (a Hamilton product with a non-pure quaternion, a monogenic signal handed here by mistake) is refused rather than silently truncated, because dropping the w component is exactly the kind of loss that produces a plausible picture from the wrong data. Pass allow_scalar=True to opt in to the truncation when it is what you meant.

The tolerance is relative to the field's own peak modulus (_MONOGENIC_K_TOL, 1e-9): a quaternion image that really is pure carries |w| at the 1e-17 level after a round trip through two FFTs, and anything with a meaningful scalar part is many orders above that. Nothing real lives in between.

Raises ValueError: *qimage* is not a finite (H, W, 4) array; or it has a non-negligible scalar part and allow_scalar is False.

उपयोग की विस्तृत 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 जुड़ता है (rgbimage को input के रूप में लेते हैं)

rgb_to_quaternion

इसी category के (convert)

rgb_to_quaternion · 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.