vol_nearest_label — 3D `medial` op

• Data kinds: voxel → voxel

• Call: import fullseye as fs; fs.ledger.vol_nearest_label(vol_labels, spacing=None) (to call the implementation directly, import volops; volops.vol_nearest_label(vol_labels, spacing=None); from the registry, ops3d.get("vol_nearest_label"))

Usage

Label volume (D, H, W) in which each zero voxel is given the nearest non-zero label (Voronoi partition of the labels, voxel).

The input is integer labels (output of vol_label / vol_rle_components, 0 = unassigned). Each 0 voxel receives, by physical distance (spacing), the label of the nearest non-zero voxel; non-zero voxels stay as they are. Used to cut out "the volume that branch governs" from EM segmentation fragments or skeleton branch labels (per-branch volume and wall thickness). Non-integer labels are rejected (not rounded into another label); if not even 1 non-zero voxel exists, ValueError. Returns 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]

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

Runnable examples (verified samples that actually call this op)

• nearest_seed_partition — py -3.11 examples_3d/nearest_seed_partition.py

Ops the type connects to (they accept `voxel` as input)

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

Same category (`medial`)

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

*Provenance: volops.py — 3D operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

vol_nearest_label — 3D medial op