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)*Provenance: match3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.