vol_nearest_label — 3D medial op

• Datenarten: voxel → voxel

• Aufruf: import fullseye as fs; fs.ledger.vol_nearest_label(vol_labels, spacing=None) (die Implementierung direkt: import volops; volops.vol_nearest_label(vol_labels, spacing=None); aus dem Register: ops3d.get("vol_nearest_label"))

Verwendung

Labelvolumen (D, H, W), in dem jedes Null-Voxel das nächstgelegene von null verschiedene Label erhält (Voronoi-Zerlegung der Labels, voxel).

Die Eingabe sind ganzzahlige Labels (Ausgabe von vol_label / vol_rle_components, 0 = nicht zugewiesen). Jedes 0-Voxel erhält nach physikalischer Distanz (spacing) das Label des nächsten Voxels ungleich null; Voxel ungleich null bleiben unverändert. Dient dazu, aus EM-Segmentfragmenten oder Ast-Labels des Skeletts "das Volumen, das dieser Ast beherrscht", herauszuschneiden (Volumen und Wandstärke je Ast). Nicht ganzzahlige Labels werden abgewiesen (nicht zu einem anderen Label gerundet); gibt es nicht 1 einziges Voxel ungleich null, ValueError. Die Rückgabe ist int64.

>>> L = np.zeros((1, 1, 7)); L[0, 0, 0] = 1; L[0, 0, 6] = 2

>>> vol_nearest_label(L)[0, 0].tolist()

[1, 1, 1, 1, 2, 2, 2]

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)

• nearest_seed_partition — py -3.11 examples_3d/nearest_seed_partition.py

Typkompatible Folge-Operatoren (nehmen voxel als Eingabe)

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

Gleiche Kategorie (medial)

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


*Provenance: volops.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.