measure op• 데이터 종류: labels → table
• 호출: import fullseye as fs; fs.ledger.vol_label_legend(labels, props=None, seed: 'int' = 0, spacing=None, measure: 'str' = 'volume', top=None)(구현을 직접 호출하려면 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 의 0 아닌 항목에서 취한다. labels.max() 를 성분 수로보지 않으므로, 번호에 결번이 있어도 건수도 순위도 어긋나지 않는다(tests/test_volcolor.py::test_stats_do_not_invent_the_component_count_from_max).
*measure* 가 *props* 의 수치 키가 아닐 때, *props* 가 실재하는 라벨을 다 포함하지 않을 때, 또는 잘못된 *top* 에 대해 ValueError 를 낸다.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• voxel_labels_color — py -3.11 examples/voxel_labels_color.py
table 를 입력으로 받는 것)—
measure)*Provenance: volcolor.py — VOLCOLOR 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.