inner_box3 — 3D regionprops op

• Data kinds: voxel → primitive

• Call: import fullseye as fs; fs.ledger.inner_box3(vol) -> 'dict' (implementation को सीधे call करना हो तो import regionprops3d; regionprops3d.inner_box3(vol) -> 'dict', registry से लेना हो तो ops3d.get("inner_box3"))

उपयोग

binary voxel region में पूरी तरह inscribed सबसे बड़ा axis-aligned box (2-D inner_rectangle1 का 3-D संस्करण)।

सटीक हल: किसी भी depth interval [z0, z1] के लिए box को slices z0..z1 के logical AND (सभी slices में foreground वाले voxels) के भीतर होना चाहिए। उस AND के भीतर सबसे बड़ा inscribed 2-D rectangle (histogram method = inner_rectangle1 जैसा ही core) × interval की लंबाई candidate box है, और सभी intervals पर इसका अधिकतम ही सटीक सबसे बड़ा inscribed box है। O(D^2 * H * W)।

Returns

dict

(depth,row,col) axis क्रम में min / max corners, center (+ cd/cr/cc),

पूरी चौड़ाई size, और voxels की संख्या के रूप में volume।

Raises

ValueError

non-3-D input, या शून्य foreground वाला region (कोई inscribed box नहीं)।

अतिरिक्त:

• min / max दोनों सिरों सहित voxel indices हैं (float arrays)। size = max - min + 1, volume = prod(size)। center (min + max) / 2 है और इसमें .5 आ सकता है। 2-D तरफ़ का registered नाम r2_inner_rectangle1 है।

• हर depth interval के लिए Python loop से सबसे बड़ा rectangle खोजा जाता है, O(D²·H·W)। AND ख़ाली होते ही उस z0 की खोज रोक दी जाती है। बड़े volumes पर धीमा है।

• समान volume वाले कई candidates हों तो पहले मिला लौटाया जाता है (छोटा z0, और उनमें छोटा z1)।

• input में 0 के अलावा सबको foreground मानकर bool बनाया जाता है (NaN भी foreground)। axis क्रम (depth, row, col) है।

• आम प्रयोग: largest_component से वस्तु को 1 तक सीमित करके बुलाएँ (कई components मिले हों तो ज़रूरी नहीं कि box सबसे बड़े component का हो)।

पृष्ठभूमि guides (इस op के पीछे की physics और conventions)

• measurement_uncertainty — Measurement uncertainty और calibration — 'हम माप रहे हैं' कहने के लिए क्या चाहिए

संदर्भ (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 के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• inner_box_inspection — py -3.11 examples_3d/inner_box_inspection.py

वे अगले ops जिनसे type जुड़ता है (primitive को input के रूप में लेते हैं)

fuse_to_voxel · angle_between_lines · angle_between_planes · angle_line_plane · distance_point_plane · distance_point_line · distance_line_line · distance_segment_segment

इसी category के (regionprops)

label_components · region_props · largest_component · filter_by_volume · vol_label · vol_region_props

*Provenance: regionprops3d.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.