vol_label_palette — VOLCOLOR `palette` op

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

• Aufruf: import fullseye as fs; fs.ledger.vol_label_palette(n_labels, seed: 'int' = 0, background=(0.0, 0.0, 0.0)) (die Implementierung direkt: import volcolor; volcolor.vol_label_palette(n_labels, seed: 'int' = 0, background=(0.0, 0.0, 0.0)); aus dem Register: opsvolcolor.get("vol_label_palette"))

Verwendung

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

Es ist dieselbe Zufallsfolge wie bei imgio.colorize_labels -- Zeile k von np.random.default_rng(seed).random((n + 1, 3)) ist die Farbe von Label k, Zeile 0 ist *background* (Standard Schwarz = identisch zur 2-D-Seite). Die Stichprobenfolge von PCG64 wird sequenziell erzeugt, daher ändern sich die vorderen Zeilen nicht, wenn n wächst, und bei gleicher Labelnummer und gleichem seed stimmt die Farbe überein, ob in 1 einzelnen 2-D-Bild oder in einem 3-D-Volumen. Diese Übereinstimmung fixiert tests/test_volcolor.py mit np.array_equal.

Gemessen (seed=0, euklidischer RGB-Abstand, Maximum sqrt(3)=1.732): Der Abstand des nächstgelegenen Farbpaars ist 0.1439 bei 16 Farben, 0.0385 bei 64 Farben und 0.0274 bei 256 Farben. Farben sind keine Bezeichner, sondern Markierungen; Abbildungen, die Unterscheidung brauchen, bekommen die Tabelle von vol_label_legend dazu.

Löst ValueError aus bei negativem / nicht ganzzahligem *n_labels*, bei *n_labels*

über MAX_LABELS, bei negativem *seed* oder bei *background* außerhalb von [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_color — py -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).*

vol_label_palette — VOLCOLOR palette op