vol_label_palette — VOLCOLOR `palette` op

• 資料種類:無 → matrix(僅由參數決定的運算子 —— 不接受影像或資料輸入)

• 呼叫:import volcolor; volcolor.vol_label_palette(n_labels, seed: 'int' = 0, background=(0.0, 0.0, 0.0))(或 opsvolcolor.get("vol_label_palette"))

標籤 `0..n_labels 的 RGB 調色盤 (n_labels + 1, 3)` float64。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

:func:imgio.colorize_labels と同じ乱数列である ――

`np.random.default_rng(seed).random((n + 1, 3)) の行 k がラベル k` の

色、行 0 は *background*(既定は黒 = 2-D 側と同一)。PCG64 の標本列は逐次

生成なので `n` を増やしても先頭行は変わらず、**同じラベル番号・同じ seed なら

2-D の 1 枚でも 3-D のボリュームでも色が一致する**。この一致は

`tests/test_volcolor.py が np.array_equal` で固定している。

実測(seed=0、RGB ユークリッド距離、取りうる最大は sqrt(3)=1.732):最近接の

色対の距離は 16 色で 0.1439、64 色で 0.0385、256 色で 0.0274。**色は識別子では

なく目印**であり、区別が要る図には :func:vol_label_legend の表を添える。

Raises `ValueError` for a negative / non-integer *n_labels*, an *n_labels*

over :data:MAX_LABELS, a negative *seed*, or a *background* outside [0, 1].

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

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

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

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

—

—

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

vol_label_palette — VOLCOLOR palette op