euclidean_cluster — 3D segment op

• Datenarten: points → labels

• Aufruf: import fullseye as fs; fs.ledger.euclidean_cluster(points, tol: 'float', min_size: 'int' = 10) -> 'np.ndarray' (die Implementierung direkt: import segment3d; segment3d.euclidean_cluster(points, tol: 'float', min_size: 'int' = 10) -> 'np.ndarray'; aus dem Register: ops3d.get("euclidean_cluster"))

Verwendung

Distanzclustering über die Zusammenhangskomponenten des Nachbarschaftsgraphen mit Radius tol (−1 = Rauschen).

Fasst Punkte, die (transitiv) innerhalb von tol zueinander liegen, zu einem Cluster zusammen. Räumlich getrennte Objekte werden zu getrennten Clustern (dient nach dem Entfernen der Bodenebene zur Trennung, "welcher Klumpen ein greifbares Objekt ist"). Zusammenhangskomponenten kleiner als min_size gelten als Rauschen, -1. Die Labels sind 0,1,2,... in absteigender Clustergröße (deterministisch).

Args:

points: (N,3)-Punktwolke.

tol: Nähe-Radius, ab dem Punkte als derselbe Cluster gelten (ein Abstand, muss > 0 sein).

min_size: Zusammenhangskomponenten kleiner als dieser Wert sind Rauschen (-1).

Returns:

labels: (N,) int. 0..(n_clusters-1) sind Cluster, -1 ist Rauschen. Eine leere Eingabe ergibt shape (0,).

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)

• object_segmentation — py -3.11 examples_3d/object_segmentation.py

Typkompatible Folge-Operatoren (nehmen labels als Eingabe)

fuse_to_voxel · vol_region_props

Gleiche Kategorie (segment)

region_growing · plane_segmentation · vol_watershed


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

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