overlay_labels — ANNOTATE overlay op

• Datenarten: image2d × labels → image2d

• Aufruf: import fullseye as fs; fs.ledger.overlay_labels(img, labels, alpha=0.5, colors=None, scheme='okabe_ito', background=0) (die Implementierung direkt: import annotate; annotate.overlay_labels(img, labels, alpha=0.5, colors=None, scheme='okabe_ito', background=0); aus dem Register: opsannotate.get("overlay_labels"))

Verwendung

Überlagert eine Farblabelkarte mit Alpha. Dieselbe Labelnummer erhält immer dieselbe Farbe.

Parameters

labels : (H,W) int

Karte der Label-Nummern. background (Standard 0) ist transparent.

colors : (k,3) or None

Nummer → Farbe. Bei None werden die 8 Okabe–Ito-Farben in Nummernreihenfolge zyklisch verwendet

(es werden keine Zufallszahlen benutzt, daher ergibt dieselbe Label-Karte immer dasselbe Bild).

Raises

ValueError

Formen ungleich / negatives Label / alpha außerhalb von [0,1] / Form von colors.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie figure_annotation

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• dataset_conventions — Konventionen für Trainingsdatensätze — COCO / YOLO / VOC und Fallstricke in der Sichtprüfung

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)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• poc_mri_bias_field — py -3.11 examples/poc_mri_bias_field.py

• poc_recycling_sorting — py -3.11 examples/poc_recycling_sorting.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar

Gleiche Kategorie (overlay)

overlay_mask · annotate_invert_visibility · annotate_invert · annotate_invert_path


*Provenance: annotate.py — ANNOTATE 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.