vol_colorize_labels — VOLCOLOR colorize op

• Data kinds: labels → rgbvolume

• Call: import fullseye as fs; fs.ledger.vol_colorize_labels(labels, seed: 'int' = 0, background=(0.0, 0.0, 0.0)) (to call the implementation directly, import volcolor; volcolor.vol_colorize_labels(labels, seed: 'int' = 0, background=(0.0, 0.0, 0.0)); from the registry, opsvolcolor.get("vol_colorize_labels"))

Usage

3-D label volume -> an RGB volume, (D, H, W, 3) float64.

The entry point for "colour first, then slice" rather than "slice first, then colour". The colour of label k is exactly row k of vol_label_palette, and it matches byte for byte the result of calling imgio.colorize_labels(labels, seed) on the same array (pinned by tests/test_volcolor.py).

That the slicing order matters at all is counted by vol_label_color_flicker. Measured (reference phantom of 16 spheres, (24, 48, 48), connectivity=26, seed=0):

re-colouring per slice changes the colour of at least 1 component in 20 of 24 slices, the (component, slice) changes are 62 out of 108 pairs, and all 16 components change colour at least once. Colouring the volume and then slicing makes all 3 of these 0.

Raises ValueError on a non-3-D, float, or negative label volume, on a label

over MAX_LABELS, or on more than MAX_COLOR_VOXELS voxels.

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.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

Ops the type connects to (they accept rgbvolume as input)

vol_label_slice_rgb · vol_label_mpr_rgb

Same category (colorize)

vol_label_overlay


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

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