colorize op• Datenarten: voxel × labels → rgbvolume
• Aufruf: import fullseye as fs; fs.ledger.vol_label_overlay(vol, labels, seed: 'int' = 0, alpha: 'float' = 0.5, vmin=None, vmax=None, mode: 'str' = 'fill') (die Implementierung direkt: import volcolor; volcolor.vol_label_overlay(vol, labels, seed: 'int' = 0, alpha: 'float' = 0.5, vmin=None, vmax=None, mode: 'str' = 'fill'); aus dem Register: opsvolcolor.get("vol_label_overlay"))
Das ursprüngliche Graustufenvolumen mit darübergelegten farbigen Labels, als (D, H, W, 3).
Die Form, die in medizinischer CT / Industrie-CT tatsächlich verwendet wird -- ein "Bild nur mit Segmentierung" zeigt nicht, wo ausgeschnitten wurde, und ein "Bild nur mit dem Original" zeigt nicht, was gemessen wurde.
*vol* ist (D, H, W). Das Anzeigefenster wird explizit mit vmin / vmax angegeben (None bedeutet Minimum / Maximum von vol). Das Fenster wird nicht implizit bestimmt, weil bei einem anderen Fenster dasselbe Gewebe in anderer Helligkeit erscheint -- derselbe Grund wie bei CT window/level.
*alpha* reicht von 0 (Originalbild unverändert) bis 1 (mit Farbe ausgefüllt). *mode* ist "fill" (die ganze Komponente einfärben) oder "boundary" (nur Voxel einfärben, deren 6-Nachbar ein anderes Label hat = Konturdarstellung, die darunterliegende Struktur bleibt vollständig sichtbar).
Ein background-Argument gibt es nicht. Dieses op legt auf Voxel mit Label 0 überhaupt keine Farbe (dort ist das Originalbild selbst) und liest Palettenzeile 0 nie. Ein Argument, das angenommen wird und nichts tut, wird zur stillen Lüge der Form "ich habe eine Hintergrundfarbe angegeben, aber sie wirkt nicht".
Gemessen ((24, 48, 48), 16 Komponenten, verrauschter grauer Körper, seed=0, mode="fill"):
die mittlere absolute Differenz zum Originalbild auf Vordergrundvoxeln ist 0.0000 bei alpha=0.00, 0.0679 bei 0.25, 0.1359 bei 0.50, 0.2038 bei 0.75, 0.2718 bei 1.00 -- linear in alpha (Bestätigung, dass die Komposition linear ist). Hintergrundvoxel liegen unabhängig von alpha bei 0.0000 (Farbe landet nur auf dem Vordergrund).
Löst ValueError aus, wenn *vol* und *labels* verschiedene Formen haben, bei nicht endlichem *vol*, bei vmin >= vmax, bei *alpha* außerhalb von [0, 1] oder bei unbekanntem *mode*.
• 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.
• voxel_labels_color — py -3.11 examples/voxel_labels_color.py
rgbvolume als Eingabe)vol_label_slice_rgb · vol_label_mpr_rgb
colorize)*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.