vol_label — 3D regionprops op

• Data kinds: voxel → labels

• Call: import fullseye as fs; fs.ledger.vol_label(vol_binary, connectivity=26) (implementation को सीधे call करना हो तो import volops; volops.vol_label(vol_binary, connectivity=26), registry से लेना हो तो ops3d.get("vol_label"))

• Ledger के ज़रिए return value: fullseye.ledger.vol_label(...) केवल घोषित out type labels का value लौटाता है (मूल function सहायक जानकारी भी लौटाता है)। जो हिस्सा छोड़ दिया गया है उसकी ज़रूरत हो तो fullseye.ledger.vol_label.raw(...) का उपयोग करें, या volops.vol_label को सीधे call करें।

• मूल function का return: (labels, n)

उपयोग

चुनने योग्य neighbourhood के साथ 3-D connected-component labelling।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

*connectivity* chooses the structuring element: 6 (face neighbours only), 18 (faces + edges), or 26 (faces + edges + corners — the default, ndimage.generate_binary_structure(3, 3)). A non-{0, 1} input is thresholded at > 0.5.

Returns (labels, n) — an int32 volume whose voxels are 0 (background) or a component id in 1..n, and the component count n. The neighbourhood genuinely matters: two blobs meeting only at a corner are *two* components under 6-connectivity but *one* under 26.

पृष्ठभूमि guides (इस op के पीछे की physics और conventions)

• measurement_uncertainty — Measurement uncertainty और calibration — 'हम माप रहे हैं' कहने के लिए क्या चाहिए

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• ct_bone_segmentation — py -3.11 examples_3d/ct_bone_segmentation.py

• molecule_atom_count — py -3.11 examples_3d/molecule_atom_count.py

• vessel_metrology — py -3.11 examples_3d/vessel_metrology.py

वे अगले ops जिनसे type जुड़ता है (labels को input के रूप में लेते हैं)

fuse_to_voxel · vol_region_props

इसी category के (regionprops)

label_components · region_props · largest_component · filter_by_volume · inner_box3 · vol_region_props


*Provenance: volops.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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