vol_label_legend — VOLCOLOR 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 的非零項。不把 labels.max() 當作成分數, 所以編號有缺號也不會打亂件數與名次(tests/test_volcolor.py::test_stats_do_not_invent_the_component_count_from_max)。

當 *measure* 不是 *props* 的數值鍵、*props* 未涵蓋實際存在的標籤,或 *top* 不正確時,拋出 ValueError。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

型別可銜接的下一個運算子(可接受 table 作為輸入)

—

同類別(measure)

vol_label_shape_stats


*Provenance: volcolor.py — VOLCOLOR 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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