rle_region op• Data kinds: rle_region × rle_region → rle_region
• Call: import fullseye as fs; fs.ledger.vol_rle_difference(a, b) (implementation को सीधे call करना हो तो import volregion; volregion.vol_rle_difference(a, b), registry से लेना हो तो ops3d.get("vol_rle_difference"))
runs पर set difference a \ b (decode के बिना)।
उन voxels का region जो a में हैं और b में नहीं। Sweep engine (_rle_boolean) से जिन अंतरालों की coverage state ia & ~ib हो, उन्हें runs के रूप में रखा जाता है। Non-commutative (vol_rle_difference(a, b) != vol_rle_difference(b, a))। गणना की लागत runs की संख्या के लिए O(n log n) है।
Return value: उसी shape का नया VolRLE। अगर a पूरी तरह b में शामिल हो, तो 0 runs वाला region। vol_rle_decode(result) == decode(a) & ~decode(b) voxel स्तर पर सही रहता है।
जाँच (ValueError): कोई एक VolRLE न हो या run arrays की consistency जाँच में fail हो / a.shape != b.shape।
कहाँ उपयोग करें: पूरे mask से ROI के बाहर का हिस्सा या कोई ज्ञात component (vol_rle_components में से 1) हटाना, vol_rle_encode(mask) और erode परिणाम के अंतर से shell बनाना — ऐसे "घटाव" dense array बनाए बिना करना।
• 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
rle_region को input के रूप में लेते हैं)vol_rle_decode · vol_rle_volume · vol_rle_bbox · vol_rle_centroid · vol_rle_union · vol_rle_intersect · fuse_to_voxel
rle_region)vol_rle_encode · vol_rle_decode · vol_rle_volume · vol_rle_bbox · vol_rle_centroid · vol_rle_union · vol_rle_intersect · 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.