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*.

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

voxel_labels_colorpy -3.11 examples/voxel_labels_color.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

같은 카테고리(measure)

vol_label_shape_stats


*Provenance: volcolor.py — VOLCOLOR 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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