label_points — ANNOTATE `pointer` op

• Datenarten: image2d × pairs → image2d

• Aufruf: import fullseye as fs; fs.ledger.label_points(img, points, labels=None, color='reference', font_size=12, pad=3, marker_size=0, scheme='okabe_ito', allow_overlap=False, **text_kw) (die Implementierung direkt: import annotate; annotate.label_points(img, points, labels=None, color='reference', font_size=12, pad=3, marker_size=0, scheme='okabe_ito', allow_overlap=False, **text_kw); aus dem Register: opsannotate.get("label_points"))

Verwendung

Nummeriert oder beschriftet eine Punktmenge. Überlappungsfrei platziert (sonst eine Ausnahme).

Parameters

points : (N,2)

Folge von (x,y)-Punkten.

labels : sequence or None

Text für jeden Punkt. Bei None Nummern ab 1.

marker_size : int

Ist er größer als 0, wird an jedem Punkt zusätzlich ein Kreuz-Marker gesetzt.

allow_overlap : bool

Bei True werden Überlappungen erlaubt und das Label an den ersten Kandidaten gesetzt (Standard ist False = Exception).

Returns

ndarray

Raises

ValueError

keine Punkte / nicht endlich / Anzahl der labels passt nicht / an jeder Kandidatenposition

Überlappung mit einem bestehenden Label (bei allow_overlap=False).

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

Typkompatible Folge-Operatoren (nehmen `image2d` als Eingabe)

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

Gleiche Kategorie (`pointer`)

arrow · leader_line · crosshair

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

label_points — ANNOTATE pointer op