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 से भाग देकर दें।

पृष्ठभूमि 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.