vol_label_legend — VOLCOLOR measure op

数据种类:labelstable

调用:import volcolor; volcolor.vol_label_legend(labels, props=None, seed: 'int' = 0, spacing=None, measure: 'str' = 'volume', top=None)(或 opsvolcolor.get("vol_label_legend"))

用法

图例表:哪个颜色对应哪个成分,以及它的测量值。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

色だけを出して意味の読めない図を作らないための op。返りは `list[dict]`:

`label · rgb (r, g, b) float [0, 1] · hex "#rrggbb"` ·

`voxel_count · volume · measure` 並べ替えに使った量の名前 ·

`value その値 · rank 1 始まりの順位 · share` 全成分の

*measure* 合計に対する割合。

*measure* は props に載っている数値キーなら何でもよい(`"volume"`

`"voxel_count" "equivalent_diameter"volops.vol_region_props` を

渡したなら `"sphericity"` も)。降順に並べ、同点はラベル番号の昇順で割る

(決定的)。*top* を与えると上位 N 件だけ返す。

実在するラベルは `np.bincount の非ゼロから取る。labels.max()` を成分数と

見なさないので、番号に欠番があっても件数も順位も狂わない

(`tests/test_volcolor.py::test_stats_do_not_invent_the_component_count_from_max`)。

Raises `ValueError` when *measure* is not a numeric key of *props*, when

*props* does not cover the labels present, or on a bad *top*.

参考(示例数据・文献)

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

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

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

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

voxel_labels_colorpy -3.11 examples/voxel_labels_color.py

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

同类别(measure)

vol_label_shape_stats


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

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