match_phase_3d — 3D `match_pose` op

• Datenarten: voxel × voxel → shift

• Aufruf: import fullseye as fs; fs.ledger.match_phase_3d(a, b, device='cpu') (die Implementierung direkt: import match3d; match3d.match_phase_3d(a, b, device='cpu'); aus dem Register: ops3d.get("match_phase_3d"))

• GPU: Dieser Operator hat einen GPU-Pfad (device="cuda")

Verwendung

3-D-Phasenkorrelation (FFT). Liefert die ganzzahlige Verschiebung (dz, dy, dx), die b auf a ausrichtet.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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 の順)。

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• shape_desc_pose — py -3.11 examples_3d/shape_desc_pose.py

Typkompatible Folge-Operatoren (nehmen `shift` als Eingabe)

fuse_to_voxel

Gleiche Kategorie (`match_pose`)

match_pca · moment_axes · match_logpolar_z

*Provenance: match3d.py — 3D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

match_phase_3d — 3D match_pose op