monogenic_phase — QUAT riesz op

• Data kinds: qimage → image2d

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

उपयोग

monogenic signal का local phase atan2(|R|, f)। → (H, W)।

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

In [0, pi] — the monogenic phase is measured against the *magnitude* of the Riesz vector, whose sign is carried by the orientation instead, so the range is a half turn rather than a full one. That is the standard convention (Felsberg & Sommer) and it is stated here because a caller arriving from complexops.cx_phase (whose raw range is (-pi, pi]) will otherwise assume a full turn and see a "wrapped" map that is not wrapped.

display=True maps [0, pi] to [0, 1] for viewing; the default is False — the opposite of cx_phase's default, deliberately, because the consumers of this quantity in this module are numerical, and a display scaling that arrives silently in a measurement is a factor of pi that nothing announces.

Phase is the quantity a translation shifts linearly, which is why the whole motion half of this module reads it. For an edge, phase 0 means the peak of a bright line, pi/2 a step edge and pi the peak of a dark line — the local *structure type*, independent of contrast.

Raises ValueError: the input is not a valid quaternion field, or its k component is non-zero; *display* is not a bool.

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

riesz_transform · monogenic_signal

इसी category के (riesz)

riesz_transform · monogenic_signal · monogenic_amplitude · monogenic_orientation


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