vol_label_volume_render — VOLCOLOR `render` op

• Datenarten: labels → rgbimage

• Aufruf: import fullseye as fs; fs.ledger.vol_label_volume_render(labels, axis='z', mode: 'str' = 'front', seed: 'int' = 0, alpha: 'float' = 0.35, background=(0.0, 0.0, 0.0)) (die Implementierung direkt: import volcolor; volcolor.vol_label_volume_render(labels, axis='z', mode: 'str' = 'front', seed: 'int' = 0, alpha: 'float' = 0.35, background=(0.0, 0.0, 0.0)); aus dem Register: opsvolcolor.get("vol_label_volume_render"))

Verwendung

Eine komponierte Projektion der farbigen Labels, (H, W, 3), allein mit numpy erzeugt.

*mode*:

• "front" -- die Farbe des ersten Nicht-Hintergrund-Voxels entlang der Blickrichtung (opake Darstellung).

• "back" -- das zuletzt getroffene (die Form von der Rückseite gesehen).

• "alpha" -- front-to-back-over-Komposition (Porter & Duff 1984). Nicht-Hintergrund-Voxel werden von vorn gestapelt, jedes mit der Deckkraft *alpha*. Überlappungen in der Tiefe werden sichtbar, dafür kommt die vordere Farbe immer kräftiger heraus als die dahinter.

mode="max" wird abgewiesen (ValueError). Nimmt man das Maximum von RGB je Kanal, entsteht eine Farbe, die zu keinem Teil gehört, mit dem Rotanteil von Teil A und dem Grünanteil von Teil B. Gemessen (3 in z versetzt überlappende Platten, (16, 16, 16), seed=0, axis="z"): Die kanalweise max-Projektion (16, 16) erzeugte von 168 Vordergrundpixeln in 90 Pixeln Farben, die mit keiner Palettenzeile übereinstimmen. Bei derselben Eingabe liefert "front" in allen 256 Pixeln Palettenfarben (tests/test_volcolor.py::test_channelwise_max_would_invent_colours).

*axis* ist "z"/0 (liefert (H, W, 3)), "y"/1 ((D, W, 3)), "x"/2 ((D, H, 3)).

Löst ValueError aus bei unbekanntem *mode* / *axis*, bei *alpha* außerhalb von [0, 1] oder bei einem ungültigen Labelvolumen.

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

—

Gleiche Kategorie (`render`)

vol_labels_to_meshes

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

vol_label_volume_render — VOLCOLOR render op