vol_labels_to_meshes — VOLCOLOR render op

• Data kinds: labels → table

• Call: import fullseye as fs; fs.ledger.vol_labels_to_meshes(labels, ids=None, spacing=None, seed: 'int' = 0, level: 'float' = 0.5, axes: 'str' = 'xyz') (implementation को सीधे call करना हो तो import volcolor; volcolor.vol_labels_to_meshes(labels, ids=None, spacing=None, seed: 'int' = 0, level: 'float' = 0.5, axes: 'str' = 'xyz'), registry से लेना हो तो opsvolcolor.get("vol_labels_to_meshes"))

उपयोग

हर component पर marching cubes चलाकर रंगीन mesh का समूह बनाता है।

list[dict] लौटाता है, हर element {"label", "vertices" (nv, 3) float64, "faces" (nf, 3) int64, "color" (r, g, b)} है। रंग vol_colorize_labels वाली palette से ही आते हैं, इसलिए section view और 3-D display में एक ही part का रंग एक ही होता है।

हर component के लिए केवल bbox को 1 voxel pad करके बना sub-volume काटकर उस पर marching cubes चलाया जाता है (पूरा volume component की संख्या जितनी बार नहीं घूमा जाता)। padding volume के किनारे को छूने वाले component की surface बंद करने के लिए है; ऐसा न करने पर केवल किनारे वाले component छेद वाले mesh बन जाते हैं।

axes:

• "xyz" (default) -- vertex को (x, y, z) में लौटाता है। render3d / mesh का vertex क्रम यही है, इसलिए इन्हें सीधे render3d.render_mesh को दिया जा सकता है।

• "zyx" -- volume के index क्रम में ही लौटाता है। यह vol_label_shape_stats के centroid वाले क्रम जैसा है।

चुपचाप उलट-पुलट होने पर exception नहीं आता -- जो निकलता है वह ऊपर-नीचे और आगे-पीछे बदली हुई,

विश्वसनीय दिखने वाली तस्वीर है। tests/test_volcolor.py::test_mesh_axes_order_is_explicit

दोनों centroid को stats के centroid से मिलाकर इसे पक्का करता है।

*spacing* देने पर vertex physical coordinate (mm) में होते हैं। *ids* से component छाँटे जा सकते हैं (None हो तो सभी मौजूद label, पर अधिकतम MAX_MESHES)।

marching cubes उपलब्ध न होने पर ImportError (pip install scikit-image संदेश के साथ) देता है, और ग़लत *axes*, (0, 1) के बाहर *level*, मौजूद न होने वाले label को बताने वाले *ids*, या MAX_MESHES से अधिक component पर 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 के (render)

vol_label_volume_render

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