topology_signature — 3D `medial` op

• Datenarten: voxel → table

• Aufruf: import fullseye as fs; fs.ledger.topology_signature(skeleton) (die Implementierung direkt: import medial; medial.topology_signature(skeleton); aus dem Register: ops3d.get("topology_signature"))

Verwendung

Baut aus den 26er-Nachbarschaftsgraden eines Skeletts einen Topologiedeskriptor. Liefert die Anzahl der Endpunkte, Knoten, gewöhnlichen und isolierten Punkte.

Zählt für jedes Skelett-Voxel die Anzahl der Skelett-Voxel in seiner 26-Nachbarschaft (Grad) und

Grad 1 = Endpunkt (endpoint)

Grad 2 = normaler Punkt (Mitte des Skeletts)

Grad>=3 = Verzweigungspunkt (branch)

Grad 0 = isolierter Punkt (isolated)

klassifiziert es entsprechend. Die Anzahlen sind invariant gegenüber Translation und Rotation (90 Grad) und bilden einen Deskriptor, der die Topologie der Form grob zusammenfasst.

Achtung (honest): Der Grad in der 26-Nachbarschaft kann nahe Verzweigungen durch diagonale Nachbarschaft zu hoch gezählt werden (bekannte Eigenschaft diskreter Skelette). Die Endpunktzahl ist an jedem Astende exakt, die Zahl der Verzweigungspunkte kann aber etwas zu hoch ausfallen.

Args:

skeleton: Skelett-Voxel (bool / 0-1, 3D).

Returns:

dict: endpoints, branches, normal, isolated, total (Gesamtzahl der Skelett-Voxel),

degree_hist (Grad -> Anzahl).

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)

• medial_topology — py -3.11 examples_3d/medial_topology.py

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

fuse_to_voxel · mesh_select_lod

Gleiche Kategorie (`medial`)

distance_ridge · skeletonize_vol · medial_axis_points · medial_match · skeleton_junctions3d · skeleton_endpoints3d · skeleton_prune3d · skeleton_branches3d

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

topology_signature — 3D medial op