vol_label_legend — VOLCOLOR measure op

• Data kinds: labels → table

• Call: import fullseye as fs; fs.ledger.vol_label_legend(labels, props=None, seed: 'int' = 0, spacing=None, measure: 'str' = 'volume', top=None) (implementation को सीधे call करना हो तो import volcolor; volcolor.vol_label_legend(labels, props=None, seed: 'int' = 0, spacing=None, measure: 'str' = 'volume', top=None), registry से लेना हो तो opsvolcolor.get("vol_label_legend"))

• GPU: नहीं (केवल CPU reference implementation)

उपयोग

"कौन सा रंग कौन सा component है, और उसके माप कितने हैं" की legend table लौटाता है।

ऐसा op जिससे केवल रंग दिखाने वाली और अर्थ न पढ़ी जा सकने वाली figure न बने। list[dict] लौटाता है:

label · rgb (r, g, b) float [0, 1] · hex "#rrggbb" ·

voxel_count · volume · measure sort के लिए इस्तेमाल हुई मात्रा का नाम ·

value उसका मान · rank 1 से शुरू होने वाला क्रम · share सभी component के

*measure* योग में हिस्सा।

*measure* props में मौजूद कोई भी numeric key हो सकती है ("volume" "voxel_count" "equivalent_diameter", और volops.vol_region_props दिया हो तो "sphericity" भी)। घटते क्रम में sort होता है, बराबरी label number के बढ़ते क्रम से तोड़ी जाती है (deterministic)। *top* देने पर केवल ऊपर के N लौटते हैं।

मौजूद label np.bincount की non-zero entries से लिए जाते हैं। labels.max() को component की संख्या नहीं माना जाता, इसलिए numbering में ख़ाली नंबर हों तो भी गिनती और क्रम नहीं बिगड़ते (tests/test_volcolor.py::test_stats_do_not_invent_the_component_count_from_max)।

जब *measure* *props* की numeric key न हो, जब *props* मौजूद label को cover न करे, या ग़लत *top* पर ValueError देता है।

संदर्भ (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 के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

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

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

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

—

इसी category के (measure)

vol_label_shape_stats

*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.