colorize op• Data kinds: voxel × labels → rgbvolume
• Call: import fullseye as fs; fs.ledger.vol_label_overlay(vol, labels, seed: 'int' = 0, alpha: 'float' = 0.5, vmin=None, vmax=None, mode: 'str' = 'fill') (implementation को सीधे call करना हो तो import volcolor; volcolor.vol_label_overlay(vol, labels, seed: 'int' = 0, alpha: 'float' = 0.5, vmin=None, vmax=None, mode: 'str' = 'fill'), registry से लेना हो तो opsvolcolor.get("vol_label_overlay"))
मूल grey volume पर रंगीन label चढ़ाकर (D, H, W, 3) लौटाता है।
medical CT / industrial CT में सच में इस्तेमाल होने वाला रूप -- "केवल segmentation वाली तस्वीर" से पता नहीं चलता कि कहाँ से काटा गया, और "केवल मूल image वाली तस्वीर" से पता नहीं चलता कि क्या मापा गया।
*vol* (D, H, W) है। display window vmin / vmax से स्पष्ट रूप से दिया जाता है (None हो तो vol का min / max)। window को अपने-आप तय न करने का कारण यह है कि window अलग हो तो वही tissue अलग brightness में दिखता है -- यही कारण CT के window/level का भी है।
*alpha* 0 (मूल image जस का तस) से 1 (रंग से पूरा भरना) तक है। *mode* "fill" (पूरे component को रंगना) या "boundary" (केवल उन voxel को रंगना जिनका 6-neighbour दूसरा label है = contour display, नीचे की संरचना पूरी तरह दिखती है) है।
background argument नहीं है। यह op label 0 वाले voxel पर बिल्कुल रंग नहीं रखता (वहाँ मूल image ही है), और palette की row 0 कभी नहीं पढ़ता। जो argument ले लिया जाए और कुछ न करे, वह "background रंग दिया पर असर नहीं हुआ" जैसा एक चुपचाप झूठ बन जाता है।
measured ((24, 48, 48), 16 component, noise वाला grey body, seed=0, mode="fill"):
foreground voxel पर मूल image से औसत absolute अंतर alpha=0.00 पर 0.0000, 0.25 पर 0.0679, 0.50 पर 0.1359, 0.75 पर 0.2038, 1.00 पर 0.2718 है -- alpha के साथ सीधी रेखा (compositing linear होने की पुष्टि)। background voxel alpha से स्वतंत्र 0.0000 रहते हैं (रंग केवल foreground पर चढ़ता है)।
*vol* और *labels* का shape अलग होने पर, non-finite *vol* पर, vmin >= vmax पर, [0, 1] के बाहर *alpha* पर, या अज्ञात *mode* पर 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
rgbvolume को input के रूप में लेते हैं)vol_label_slice_rgb · vol_label_mpr_rgb
colorize)*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.