vol_label_legend — VOLCOLOR `measure` op

• Datenarten: labels → table

• Aufruf: import fullseye as fs; fs.ledger.vol_label_legend(labels, props=None, seed: 'int' = 0, spacing=None, measure: 'str' = 'volume', top=None) (die Implementierung direkt: import volcolor; volcolor.vol_label_legend(labels, props=None, seed: 'int' = 0, spacing=None, measure: 'str' = 'volume', top=None); aus dem Register: opsvolcolor.get("vol_label_legend"))

Verwendung

Eine Legendentabelle: welche Farbe zu welcher Komponente gehört und welche Messwerte sie hat.

Ein op, damit keine Abbildungen entstehen, die nur Farben zeigen, deren Bedeutung man nicht lesen kann. Rückgabe ist list[dict]:

label · rgb (r, g, b) float [0, 1] · hex "#rrggbb" ·

voxel_count · volume · measure Name der zum Sortieren verwendeten Größe ·

value deren Wert · rank Rang ab 1 · share Anteil an der

*measure*-Summe über alle Komponenten.

*measure* darf jeder numerische Schlüssel in props sein ("volume" "voxel_count" "equivalent_diameter", und "sphericity", wenn volops.vol_region_props übergeben wurde). Absteigend sortiert, Gleichstände nach aufsteigender Labelnummer aufgelöst (deterministisch). Mit *top* werden nur die obersten N zurückgegeben.

Vorhandene Labels werden aus den von null verschiedenen Einträgen von np.bincount genommen. labels.max() wird nicht als Komponentenzahl betrachtet, daher bringen Lücken in der Nummerierung weder Anzahl noch Rang durcheinander (tests/test_volcolor.py::test_stats_do_not_invent_the_component_count_from_max).

Löst ValueError aus, wenn *measure* kein numerischer Schlüssel von *props* ist, wenn *props* die vorhandenen Labels nicht abdeckt oder bei ungültigem *top*.

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 `table` als Eingabe)

—

Gleiche Kategorie (`measure`)

vol_label_shape_stats

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

vol_label_legend — VOLCOLOR measure op