select op• Data kinds: labels → labels
• Call: import fullseye as fs; fs.ledger.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria) (implementation को सीधे call करना हो तो import volcolor; volcolor.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria), registry से लेना हो तो opsvolcolor.get("vol_select_labels"))
• Ledger के ज़रिए return value: fullseye.ledger.vol_select_labels(...) केवल घोषित out type labels का value लौटाता है (मूल function सहायक जानकारी भी लौटाता है)। जो हिस्सा छोड़ दिया गया है उसकी ज़रूरत हो तो fullseye.ledger.vol_select_labels.raw(...) का उपयोग करें, या volcolor.vol_select_labels को सीधे call करें।
3-D feature से component को छानता है (2-D blob चयन का 3-D रूप)।
(labels_out, kept_ids) लौटाता है। हटाए गए component के voxel 0 (background) बन जाते हैं।
*props* vol_label_shape_stats या volops.vol_region_props का return value है। None हो तो vol_label_shape_stats को वहीं call किया जाता है।
शर्तें (सभी वैकल्पिक, दी गई शर्तें AND होती हैं): min_volume max_volume min_voxels max_voxels min_sphericity max_sphericity min_elongation max_elongation min_isotropy max_isotropy min_equivalent_diameter max_equivalent_diameter। इसके अलावा exclude_border=True से volume के किनारे को छूने वाले component हटते हैं (CT के field of view से कटे particle को measurement से बाहर करने की standard प्रक्रिया), और keep=[...] से रखे जाने वाले id सीधे दिए जाते हैं।
ज़रूरी key props में न हो तो ValueError। उदाहरण के लिए min_sphericity को vol_label_shape_stats के result पर देने पर, sphericity वह मात्रा है जो वह नहीं देता, इसलिए अस्वीकार किया जाता है -- छूटी key को default value से भरने पर "शर्त लिखी फिर भी एक भी नहीं हटा" ऐसा filter चुपचाप बन जाता है।
relabel:
• False (default) -- मूल id को जस का तस रखता है। इसलिए vol_colorize_labels को पहले और बाद में call करने पर भी बचे component के रंग नहीं बदलते। "छानते जाओ, रंग बने रहें" वाली figure इसी default के कारण संभव है।
• True -- बचे component को 1..k पर फिर से number करता है। रंग पूरी तरह बदल जाते हैं (क्योंकि label number ही palette का row number है)। केवल तब इस्तेमाल करें जब downstream लगातार number माँगे। यह 1 argument ही वह अकेली जगह है जो इस family की ख़ूबी तोड़ सकती है, इसलिए इसे explicit बनाया गया।
(labels_out int32 (D, H, W), kept_ids np.ndarray int64) लौटाता है। अज्ञात criterion, ऐसा criterion जिसकी key *props* में न हो, मौजूद label को cover न करने वाला *props*, या ऐसा *keep* जिसमें volume में न होने वाला label हो, इन पर ValueError देता है।
• 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 के स्रोत।
• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।
• voxel_labels_color — py -3.11 examples/voxel_labels_color.py
labels को input के रूप में लेते हैं)vol_colorize_labels · vol_label_overlay · vol_label_shape_stats · vol_label_legend · vol_labels_to_meshes · vol_label_volume_render
select)—
*Provenance: volcolor.py — VOLCOLOR operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.