match_sh_descriptor — 3D describe op

• 資料種類:voxel × voxel → measurement

• 呼叫: import fullseye as fs; fs.ledger.match_sh_descriptor(a, b, L=8, nradii=12, device='cpu')(要直接呼叫實作,import match3d; match3d.match_sh_descriptor(a, b, L=8, nradii=12, device='cpu');從台帳取用則 ops3d.get("match_sh_descriptor"))

• GPU:該運算子有 GPU 路徑(device="cuda")

用法

兩個 SH 描述子的餘弦相似度(旋轉不變的形狀比對)。越接近 1 形狀越相似。voxel × SH 列。

將 sh_descriptor(a, L, nradii) 與 sh_descriptor(b, L, nradii) 攤平並做 L2 正規化, 以 float 回傳內積。頻帶能量非負,因此值在 [0, 1](不會為負)。任一描述子全為 0(空 volume)時為 0。

• a、b 為立方體 volume(sh_descriptor 的前提)。形狀可以不同,但 shell 半徑

由各自的 N 決定,因此 尺度不同的物體被視為不同物體而得分偏低(不具尺度不變性)。對中心偏移也敏感(先以質心對中)。

• 對旋轉不變(頻帶能量)。但鏡像也得到相同的值。

• ntheta/nphi 固定為預設值(32×64)。只有相同設定之間的比較才有意義。

• 不回傳位置。「在哪裡」用 match_shape_3d 等,「是否同形」用本 op。

參考(範例資料、文獻)

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

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

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

• sh_descriptor_retrieval — py -3.11 examples_3d/sh_descriptor_retrieval.py

• shape_descriptor — py -3.11 examples_3d/shape_descriptor.py

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

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

同類別(describe)

sh_descriptor

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

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