filter_by_volume — 3D regionprops op

• Data kinds: voxel → voxel

• Call: import fullseye as fs; fs.ledger.filter_by_volume(vol, min_voxels: 'int', connectivity: 'int' = 26) -> 'np.ndarray' (implementation को सीधे call करना हो तो import regionprops3d; regionprops3d.filter_by_volume(vol, min_voxels: 'int', connectivity: 'int' = 26) -> 'np.ndarray', registry से लेना हो तो ops3d.get("filter_by_volume"))

उपयोग

min_voxels से कम वाले connected components हटाकर bool mask लौटाता है।

Parameters

vol : array_like

bool या 0/1 का 3D array।

min_voxels : int

इस threshold से "कम" (< min_voxels) वाले components हटाता है। threshold "या उससे अधिक" वाले रहते हैं।

connectivity : int

6 / 18 / 26।

Returns

ndarray(bool)

केवल शर्त पूरी करने वाले components True। foreground न हो या सभी components हट जाएँ तो पूरा False।

अतिरिक्त:

• min_voxels को int() से round करके तुलना होती है। 1 या कम हो तो सभी components बने रहते हैं।

• भीतर label_components → bincount → counts >= min_voxels वाले labels रखता है। labels की दोबारा numbering नहीं होती और केवल bool mask लौटता है, इसलिए numbers चाहिए तो परिणाम को फिर से label_components से गुज़ारें।

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

• Raises ValueError: 3-dimensional न होने वाला input, connectivity 6/18/26 के अलावा।

• voxels की संख्या spacing से corrected नहीं है, इसलिए वास्तविक माप में threshold रखना हो तो voxel volume से भाग देकर दें।

खाली इनपुट (vol में 0 तत्व) पर ValueError उठता है।

पृष्ठभूमि 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 करते हैं)

• region_props_3d — py -3.11 examples_3d/region_props_3d.py

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

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

इसी category के (regionprops)

label_components · region_props · largest_component · inner_box3 · 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.