riesz op• 数据种类:qimage → image2d
• 调用: import fullseye as fs; fs.ledger.monogenic_orientation(qimage, display: 'bool' = False) -> 'np.ndarray'(要直接调用实现,import quatimage; quatimage.monogenic_orientation(qimage, display: 'bool' = False) -> 'np.ndarray';从台账取用则 opsquat.get("monogenic_orientation"))
单演信号的局部方向 atan2(R2, R1)。→ (H, W)。
> 以下的详细说明为原文 —— 摘要与标题已翻译。
Radians in [0, pi): an orientation is defined modulo pi (a grating at 10 degrees and one at 190 degrees are the same grating), and the value is folded into that range rather than left in (-pi, pi] where the same structure would read as two different numbers on either side of a contrast reversal. display=True maps it to [0, 1].
Continuous, not quantised — the angle is read directly from two filters, for any angle, where a steerable bank with K orientations interpolates between its K. Measured against eight grid-exact grating orientations the error is at most 3.6e-15 rad, including the obliques. (Whether that buys anything downstream is a separate question, and the measured answer is mostly *no* — see riesz_displacement.)
Where it is undefined, and the mask is not the one you expect. The orientation dies where the *Riesz vector* dies, which is at every even-symmetric point — local phase 0 or pi, the crest of a bright or dark line — and the amplitude is at full strength there. Measured on a 45-degree grating, the worst orientation error over the whole frame is 0.2764 rad, at a pixel where |R| = 6.8e-16 and monogenic_amplitude reads 1.0000. So masking on the amplitude does not protect you; mask on hypot(q[..., 1], q[..., 2]), the Riesz magnitude. With that mask the error over the same eight orientations is at most 3.6e-15 rad.
Where the Riesz vector is exactly zero, atan2(0, 0) = 0 is returned — a *value*, not a measurement.
Raises ValueError: the input is not a valid quaternion field, or its k component is non-zero; *display* is not a bool.
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• 算法的正典(作者、年份)与用途见上面的族使用指南。
• quaternion_monogenic — py -3.11 examples/quaternion_monogenic.py
image2d 作为输入)riesz_transform · monogenic_signal
riesz)riesz_transform · monogenic_signal · monogenic_amplitude · monogenic_phase
*Provenance: quatimage.py — QUAT 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.