vol_label_palette — VOLCOLOR palette op

Datenarten: keinematrix (ein Operator, der allein durch seine Argumente bestimmt ist — er nimmt kein Bild und keine Daten entgegen)

Aufruf: import volcolor; volcolor.vol_label_palette(n_labels, seed: 'int' = 0, background=(0.0, 0.0, 0.0)) (oder opsvolcolor.get("vol_label_palette"))

Verwendung

Eine RGB-Palette für die Labels `0..n_labels: (n_labels + 1, 3)` float64.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

: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.pynp.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].

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

voxel_labels_colorpy -3.11 examples/voxel_labels_color.py

Typkompatible Folge-Operatoren (nehmen matrix als Eingabe)

Gleiche Kategorie (palette)


*Provenance: volcolor.py — VOLCOLOR Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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