colorize op• 데이터 종류: voxel × labels → rgbvolume
• 호출: import volcolor; volcolor.vol_label_overlay(vol, labels, seed: 'int' = 0, alpha: 'float' = 0.5, vmin=None, vmax=None, mode: 'str' = 'fill')(또는 opsvolcolor.get("vol_label_overlay"))
원래 그레이 볼륨에 색 레이블을 겹친 `(D, H, W, 3)`.
> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.
医用 CT / 産業 CT で実際に使う形 ―― 「セグメンテーションだけの絵」は
どこを切り出したのかが分からず、「元画像だけの絵」は何を測ったのかが分からない。
*vol* は `(D, H, W)。表示窓は vmin / vmax` で明示する
(`None なら vol` の最小 / 最大)。窓を暗黙に決めないのは、窓が違えば
同じ組織が別の明るさで出るからで、CT の window/level と同じ理由である。
*alpha* は `0(元画像のまま)から 1`(色で塗り潰す)。*mode* は
`"fill"(成分全体を塗る)か "boundary"`(6 近傍で隣が別ラベルの
ボクセルだけを塗る = 輪郭表示、下の構造が完全に見える)。
**`background` 引数は無い**。この op はラベル 0 のボクセルに一切色を置かず
(そこは元画像そのもの)、パレット行 0 を一度も引かない。受け取っておいて
何もしない引数は「背景色を指定したのに効かない」という形の静かな嘘になる。
実測(`(24, 48, 48)・16 成分・ノイズ入りグレー体、seed=0、mode="fill"`):
前景ボクセルにおける元画像との平均絶対差は alpha=0.00 で 0.0000、
0.25 で 0.0679、0.50 で 0.1359、0.75 で 0.2038、1.00 で 0.2718 ――
alpha に対して直線(合成が線形であることの確認)。**背景ボクセルは
alpha に依らず 0.0000**(色は前景にしか乗らない)。
Raises `ValueError` when *vol* and *labels* differ in shape, on a non-finite
*vol*, on `vmin >= vmax`, on an *alpha* outside [0, 1], or on an unknown *mode*.
• 샘플 데이터 카탈로그(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
rgbvolume 를 입력으로 받는 것)vol_label_slice_rgb · vol_label_mpr_rgb
colorize)*Provenance: volcolor.py — VOLCOLOR 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.