colorize op• 資料種類:voxel × labels → rgbvolume
• 呼叫: import fullseye as fs; fs.ledger.vol_label_overlay(vol, labels, seed: 'int' = 0, alpha: 'float' = 0.5, vmin=None, vmax=None, mode: 'str' = 'fill')(要直接呼叫實作,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(顏色只加在前景上)。
當 *vol* 與 *labels* 形狀不同、*vol* 非有限、vmin >= vmax、*alpha* 在 [0, 1] 之外或 *mode* 未知時,拋出 ValueError。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 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 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.