region_props — 3D `regionprops` op

• 数据种类:voxel → table

• 调用: import fullseye as fs; fs.ledger.region_props(vol, connectivity: 'int' = 26) -> 'list[dict]'(要直接调用实现,import regionprops3d; regionprops3d.region_props(vol, connectivity: 'int' = 26) -> 'list[dict]';从台账取用则 ops3d.get("region_props"))

用法

返回各连通成分的区域属性列表。

Parameters

vol : array_like

bool 或 0/1 的 3D 数组。

connectivity : int

6 / 18 / 26。

Returns

list[dict]

每个分量一个 dict。键:

• label : 标签编号 (int)

• volume : 体素数 (int)

• centroid : 质心 (z, y, x) 的 tuple(float)

• bbox : (z0, y0, x0, z1, y1, x1)。z1/y1/x1 为排他性上端(stop)

• extent : volume / bbox 体积(填充率,0..1)

• principal_axes : (3,3) 主轴向量(按行,特征值降序)

• principal_lengths: (3,) 主轴长 = 坐标协方差特征值的平方根(降序)

• equivalent_radius: 等效球半径 (3V/4π)^(1/3)

• surface_area : 暴露面计数近似(以体素面为单位)

• sphericity : 等体积球表面积 / 实际表面积(球接近 1,因离散化而 <1)

没有前景体素(或输入为空)时为空列表。

补充:

• 所有量均以体素为单位(无间距校正)。需要实际尺寸时,volume 乘以体素体积,centroid / bbox / principal_lengths 乘以各轴的间距(非各向同性时主轴方向会畸变)。

• principal_lengths 是坐标总体协方差(除以 N)特征值的平方根,不是分量的半径而是坐标的标准差。1 个体素的分量,principal_axes 为单位矩阵,principal_lengths 全为 0。

• surface_area 也计入与数组边缘接触的面(零 padding)。由于离散化,sphericity 即使是球上限也约为 0.66(参见模块 docstring)。

• 标签按 1..n 的顺序(与 label_components 相同的 scipy 扫描顺序),而非体积顺序。排序由调用方进行。

• 输入以 0 以外为前景转为 bool(NaN 也是前景)。Raises ValueError:非 3 维输入,connectivity 不是 6/18/26。

背景知识指南(该算子背后的物理与约定)

• measurement_uncertainty — 测量不确定度与校准知识 —— 为了能主张“测得准”

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

可运行的示例(实际调用该算子并已验证的样例)

• region_props_3d — py -3.11 examples_3d/region_props_3d.py

类型可衔接的下一个算子(可接受 `table` 作为输入)

fuse_to_voxel · mesh_select_lod

同类别(`regionprops`)

label_components · largest_component · filter_by_volume · inner_box3 · vol_label · vol_region_props

*Provenance: regionprops3d.py — 3D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

region_props — 3D regionprops op

用法