match_sh_descriptor — 3D `describe` op

• Datenarten: voxel × voxel → measurement

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

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

Verwendung

Die Kosinusähnlichkeit zweier SH-Deskriptoren (rotationsinvarianter Formabgleich). Näher an 1 heißt ähnlichere Form. Die Spalte Voxel × SH.

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

`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。

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)

• sh_descriptor_retrieval — py -3.11 examples_3d/sh_descriptor_retrieval.py

• shape_descriptor — py -3.11 examples_3d/shape_descriptor.py

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

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

Gleiche Kategorie (`describe`)

sh_descriptor

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

match_sh_descriptor — 3D describe op