vol_select_labels — VOLCOLOR select op

• 数据种类:labels → labels

• 调用: import fullseye as fs; fs.ledger.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria)(要直接调用实现,import volcolor; volcolor.vol_select_labels(labels, props=None, spacing=None, relabel: 'bool' = False, exclude_border: 'bool' = False, keep=None, **criteria);从台账取用则 opsvolcolor.get("vol_select_labels"))

• 经台账调用的返回值: fullseye.ledger.vol_select_labels(...) 只返回声明的 out 类型 labels 的值(底层函数还会返回辅助信息)。需要被丢弃的部分时,使用 fullseye.ledger.vol_select_labels.raw(...),或直接调用 volcolor.vol_select_labels。

用法

按 3-D 特征筛选成分(2-D 斑点筛选的 3-D 版)。

返回 (labels_out, kept_ids)。被去掉的成分的体素变为 0(背景)。

*props* 是 vol_label_shape_stats 或 volops.vol_region_props 的返回值。None 时当场调用 vol_label_shape_stats。

条件(全部可省略、给出的条件取 AND): min_volume max_volume min_voxels max_voxels min_sphericity max_sphericity min_elongation max_elongation min_isotropy max_isotropy min_equivalent_diameter max_equivalent_diameter。另外 exclude_border=True 会去掉接触体数据边缘的成分(把被 CT 视场截断的颗粒排除在测量之外的标准步骤),keep=[...] 直接指定保留的 id。

props 中没有所需的键则 ValueError。例如对 vol_label_shape_stats 的结果指定 min_sphericity 时,由于 sphericity 是那一方不输出的量,所以拒绝 —— 若用默认值填补缺失的键,就会默默做出"写了条件却一件也没去掉"的过滤器。

relabel:

• False(默认)—— 原样保留原来的 id。因此即使在前后调用 vol_colorize_labels,留下的成分的颜色也不变。"过筛后颜色依然保留"的图之所以成立,全靠这一默认值。

• True —— 把留下的成分重新编号为 1..k。颜色会全部更换 (因为标签编号就是调色板的行号)。仅在下游要求连续编号时使用。这 1 个参数是唯一能破坏这一族卖点的地方,所以把它做成了显式的。

返回 (labels_out int32 (D, H, W), kept_ids np.ndarray int64)。对未知的条件、键不在 *props* 中的条件、未覆盖实际存在标签的 *props*,或包含体数据中不存在标签的 *keep*,抛出 ValueError。

参考(示例数据、文献)

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

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

• 算法的正典(作者、年份)与用途见上面的族使用指南。

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

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

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

vol_colorize_labels · vol_label_overlay · vol_label_shape_stats · vol_label_legend · vol_labels_to_meshes · vol_label_volume_render

同类别(select)

—

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

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