annotate_markers — ANNOTATE paper op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.annotate_markers(img, points, labels=None, start=1, radius=9.0, color='emphasis', text_color=None, font_size=11, scheme='okabe_ito', font_path=None, min_contrast=2.0) (die Implementierung direkt: import annotate; annotate.annotate_markers(img, points, labels=None, start=1, radius=9.0, color='emphasis', text_color=None, font_size=11, scheme='okabe_ito', font_path=None, min_contrast=2.0); aus dem Register: opsannotate.get("annotate_markers"))

Verwendung

Liefert ein Bild (image2d): einen runden Marker mit Nummer (oder kurzem Text) an jedem Punkt.

Übergibt man dieselben start / labels wie an annotate_legend, stimmen die Nummern in der Abbildung und die Nummern in der Legende immer überein.

Parameters

points : (N, 2)

(x, y). Punkte außerhalb des Bilds sind ein ValueError.

labels : sequence of str or None

Bei None fortlaufende Nummern ab start.

radius : float

Kreisradius [px]. Passt der Text nicht hinein, ValueError.

Raises

ValueError

Punkte leer, nicht endlich oder außerhalb des Bilds, Anzahl der labels passt nicht, Text passt nicht in den Kreis,

zu wenig Kontrast zwischen Textfarbe und Kreisfarbe.

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)

• paper_figure — py -3.11 examples/paper_figure.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

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

Gleiche Kategorie (paper)

annotate_leader_layout · annotate_leader · annotate_legend · annotate_dimension_layout · annotate_dimension · annotate_angle_layout · annotate_angle · annotate_scale_bar_layout


*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.