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.

Flacht sh_descriptor(a, L, nradii) und sh_descriptor(b, L, nradii) ab, normiert sie per L2 und liefert das Skalarprodukt als float. Bandenergien sind nicht negativ, daher liegt der Wert in [0, 1] (nie negativ). Ist einer der Deskriptoren komplett 0 (leeres Volume), 0.

• a, b sind Würfel-Volumes (Voraussetzung von sh_descriptor). Die Formen dürfen verschieden sein, aber die Shell-Radien werden

durch das jeweilige N bestimmt, daher gelten Objekte unterschiedlicher Skalierung als verschieden und erzielen niedrige Werte (nicht skaleninvariant). Auch empfindlich gegen Zentrumsversatz (vorher am Schwerpunkt zentrieren).

• Invariant gegen Rotation (Bandenergie). Ein Spiegelbild ergibt allerdings denselben Wert.

• ntheta/nphi sind auf den Standard (32×64) fixiert. Nur Vergleiche mit gleichen Einstellungen sind sinnvoll.

• Liefert keine Position. "Wo ist es" ist match_shape_3d usw., "ist es dieselbe Form" ist dieser 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