vol_label_legend — VOLCOLOR `measure` op

• Data kinds: labels → table

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

Usage

A legend table: which colour is which component, and what its measurements are.

> The detailed description below is the original text — the summary and the headings are translated.

色だけを出して意味の読めない図を作らないための 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*.

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

Ops the type connects to (they accept `table` as input)

—

Same category (`measure`)

vol_label_shape_stats

*Provenance: volcolor.py — VOLCOLOR operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

vol_label_legend — VOLCOLOR measure op