match_pose op• 資料種類:voxel × voxel → shift
• 呼叫: import fullseye as fs; fs.ledger.match_phase_3d(a, b, device='cpu')(要直接呼叫實作,import match3d; match3d.match_phase_3d(a, b, device='cpu');從台帳取用則 ops3d.get("match_phase_3d"))
• GPU:該運算子有 GPU 路徑(device="cuda")
3D 相位相關(FFT)。回傳把 b 對齊到 a 的整數位移 (dz,dy,dx)。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
Reddy & Chatterji の 3D 版。相互パワースペクトルの逆 FFT のピーク = 平行移動。テンプレート
不要・全 volume・O(N log N)。回転/スケールは別途(PCA / log-polar)。
引数: `a, b` は同形の 3-D 配列(違えば ValueError)。float32 に落として FFT する。
返り値: int の tuple `(dz, dy, dx)、各軸 (−N/2, N/2]` に折り返し済み。意味は
`np.roll(b, (dz,dy,dx), axis=(0,1,2)) ≈ a`(b をこれだけ動かすと a に重なる)。
• 循環相関なので、はみ出した部分は反対側から回り込む(窓掛けはしない)。シフトが volume の
半分を超えると符号が反転して見える。
• 位相のみ(`R/|R|`)なので振幅・コントラスト差に不変だが、ノイズが白色化されてピークが
埋もれることがある。全 0 の volume は 0 になり index 0 を返す。
• 整数精度。サブボクセルは `refine_translation_lk / refine_peak_newton` へ。
• 回転・スケールがあると効かない(`match_logpolar_z` → 回転補正 → 本 op の順)。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• shape_desc_pose — py -3.11 examples_3d/shape_desc_pose.py
shift 作為輸入)match_pose)match_pca · moment_axes · match_logpolar_z
*Provenance: match3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.