vol_region_props — 3D regionprops op

• データ種: labels → table

• 呼び出し: import fullseye as fs; fs.ledger.vol_region_props(labels, spacing=None, surface='auto') (実装を直接呼ぶなら import volops; volops.vol_region_props(labels, spacing=None, surface='auto')、台帳から引くなら ops3d.get("vol_region_props"))

使い方

Per-component quantitative descriptors from a label volume.

*labels* is the int volume returned by vol_label (or any integer labelling; voxels <= 0 are background). Pass *spacing* (sz, sy, sx) (or

a volio.VolumeMeta) to report physical volume in mm**3 and physical surface area in mm**2. *surface* selects the surface-area estimator:

"auto" (marching cubes when scikit-image is importable, else exposed faces), "marching" (require marching cubes), or "faces" (always the face count).

Returns a list[dict] (one per label 1..n, in ascending label order), each with:

label id · voxel_count · volume (voxels, or mm**3 with spacing) · centroid (z, y, x) in voxel-index coordinates · bbox (z0, z1, y0, y1, x0, x1) with exclusive upper bounds (slice stop) · surface_area (voxel-face units, or mm**2 with spacing) · sphericity (Wadell, ~1 for a sphere, lower for a slab; approximate — see module note).

背景知識ガイド(この op の手前にある物理・規約)

• measurement_uncertainty — 計測の不確かさと校正の知識 — 「測れている」を主張するために

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• vessel_metrology — py -3.11 examples_3d/vessel_metrology.py

型が繋がる次の op(table を入力に取れる)

fuse_to_voxel · mesh_select_lod

同カテゴリ(regionprops)

label_components · region_props · largest_component · filter_by_volume · inner_box3 · vol_label


*Provenance: volops.py — 3D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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