vol_label_color_flicker — VOLCOLOR diagnose op

• Data kinds: voxel → table

• Call: import fullseye as fs; fs.ledger.vol_label_color_flicker(vol_binary, axis='z', seed: 'int' = 0, connectivity: 'int' = 26, connectivity_2d: 'int' = 8) (implementation को सीधे call करना हो तो import volcolor; volcolor.vol_label_color_flicker(vol_binary, axis='z', seed: 'int' = 0, connectivity: 'int' = 26, connectivity_2d: 'int' = 8), registry से लेना हो तो opsvolcolor.get("vol_label_color_flicker"))

उपयोग

"पहले segment फिर रंग" और "पहले रंग फिर segment" के अंतर को गिनता है।

एक ही 2-valued (binary) volume पर 2 प्रक्रियाएँ चलाई जाती हैं:

A. हर slice पर -- हर section को 2-D में connected component labelling करके,

imgio.colorize_labels वाली palette से रंगा जाता है।

हर section पर number फिर से दिए जाते हैं, इसलिए एक ही part का रंग भी layer बदलने पर बदल सकता है।

B. volume पर -- volops.vol_label से labelling करके

vol_colorize_labels से रंगा जाता है, और बाद में काटा जाता है।

dict लौटाता है:

n_components 3-D component की संख्या · n_slices section की संख्या ·

slices_with_change A में जिन section में कम से कम 1 component का रंग बदला, उनकी संख्या ·

changed_pairs A में रंग बदलने वाले (component, section) जोड़ों की संख्या ·

changed_components A में कम से कम एक बार रंग बदलने वाले component की संख्या ·

volume_slices_with_change / volume_changed_pairs /

volume_changed_components B की वही मात्राएँ (संरचना से ही 0) ·

pairs_checked तुलना किए गए (component, section) की कुल संख्या ·

flicker_rate changed_pairs / pairs_checked।

तुलना की परिभाषा: हर 3-D component c के लिए, c जिस पहले section में दिखे वहाँ का रंग reference है, और बाद के section में c के pixel का सबसे आम रंग reference से अलग हो तो उसे 1 गिना जाता है (1 3-D component 1 section में कई 2-D टुकड़ों में बँट सकता है, इसलिए प्रतिनिधि सबसे आम रंग है; बराबरी पर RGB dictionary order में छोटा वाला = deterministic)।

measured ((24, 48, 48), 16 sphere वाला reference phantom, seed=0, axis="z", connectivity=26 / connectivity_2d=8): pairs_checked=108, slices_with_change=20 / 24, changed_pairs=62 (57.4 %), changed_components=16 / 16। B की ओर सभी 3 मान 0 हैं -- संरचना से 0 है, संयोग से 0 नहीं (क्योंकि label number पूरे volume में अद्वितीय हैं)।

ग़लत volume, अज्ञात *axis*, या ऐसी *connectivity* पर जो 6 / 18 / 26 (2-D: 4 / 8) न हो, 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 के (diagnose)

—


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