rle_region op• Data kinds: rle_region → measurement
• Call: import fullseye as fs; fs.ledger.vol_rle_volume(region) -> 'int' (implementation को सीधे call करना हो तो import volregion; volregion.vol_rle_volume(region) -> 'int', registry से लेना हो तो ops3d.get("vol_rle_volume"))
region का voxel count, runs पर गणना (decode के बिना)।
मापने पर dense mask का योग करने से ~300x तेज़।
गणना: sum(ends - starts) (अंतर int64 में लिया जाता है, इसलिए runs बहुत होने पर भी overflow नहीं होता)। Return value Python का int है (voxel की संख्या, इकाई voxel। अगर mm^3 में physical volume चाहिए, तो spacing का गुणनफल sz*sy*sx ख़ुद गुणा करें — यह op spacing नहीं लेता)।
Input की उपयोग से पहले _require_rle से जाँच होती है (VolRLE न हो, shape या run arrays में असंगति हो, या run range से बाहर हो तो ValueError)। खाली region 0 लौटाता है (इसे error नहीं माना जाता)। उद्देश्य है vol_rle_decode के बाद sum() करने जितना ही मान, dense array बनाए बिना लौटाना। vol_rle_components के हर component पर लगाने से हर component का volume मिलता है।
• 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 के स्रोत।
• rle_region_efficiency — py -3.11 examples_3d/rle_region_efficiency.py
measurement को input के रूप में लेते हैं)vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle
rle_region)vol_rle_encode · vol_rle_decode · vol_rle_bbox · vol_rle_centroid · vol_rle_union · vol_rle_intersect · vol_rle_difference · vol_rle_components
*Provenance: volregion.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.