monogenic_phase — QUAT riesz op

資料種類:qimageimage2d

呼叫:import quatimage; quatimage.monogenic_phase(qimage, display: 'bool' = False) -> 'np.ndarray'(或 opsquat.get("monogenic_phase"))

用法

單演訊號的局部相位 `atan2(|R|, f)`。→ (H, W)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

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.

詳細使用指南

quaternion_monogenic 族使用指南

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者・年份)與用途見上面的族使用指南

可執行的範例(實際呼叫該運算子並已驗證的樣例)

quaternion_monogenicpy -3.11 examples/quaternion_monogenic.py

型別可銜接的下一個運算子(可接受 image2d 作為輸入)

riesz_transform · monogenic_signal

同類別(riesz)

riesz_transform · monogenic_signal · monogenic_amplitude · monogenic_orientation


*Provenance: quatimage.py — QUAT 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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