arc — ANNOTATE `shape` op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.arc(img, center, radius, start_deg, end_deg, color='neutral', width=2, alpha=1.0, scheme='okabe_ito') (die Implementierung direkt: import annotate; annotate.arc(img, center, radius, start_deg, end_deg, color='neutral', width=2, alpha=1.0, scheme='okabe_ito'); aus dem Register: opsannotate.get("arc"))

Verwendung

Ein Kreisbogen. Winkel in Grad, im Uhrzeigersinn ab der Bildschirm-x-Achse (weil row nach unten zeigt).

Raises

ValueError

radius nicht positiv, Winkel nicht endlich, start == end, alpha außerhalb von [0,1].

Zeichnen: Es werden Pixel gefärbt, deren Abstand d vom Zentrum |d - radius| <= max(0.6, width/2) erfüllt und deren Azimut im Bereich (end_deg - start_deg) mod 360 im Uhrzeigersinn ab start_deg liegt (kein Anti-Aliasing). Der Azimut ist atan2(y - cy, x - cx), mit 0 Grad = rechts (+x), 90 Grad = unten (+y), im Uhrzeigersinn positiv.

• center: (x, y), x = Spalte, y = Zeile. Darf außerhalb des Bilds liegen (Überstand wird nur abgeschnitten).

• radius: positiv [px].

• start_deg, end_deg: Grad. Gezeichnet wird im Uhrzeigersinn von start bis end. Ist die Differenz ein Vielfaches von 360 (end - start ungleich 0, etwa 360), ergibt sich ein Vollkreis. start == end ist "Länge 0", daher ValueError.

• width: Linienbreite [px]. max(0.6, width/2) dient als halbe Breite, daher reißt die Linie auch unter 1 px nicht ab.

• img / color / alpha / scheme werden wie bei rounded_rect behandelt (float64-Kopie, [0, 1], Rollenname oder RGB).

• Rückgabewert: float64 in derselben Form wie die Eingabe.

Für die Konventionen wissenschaftlicher Abbildungen, in die Winkel eingetragen werden, kümmert sich annotate_angle bis hin zum Beschriftungstext.

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_polish_wipe_measure — py -3.11 examples/poc_polish_wipe_measure.py

• poc_weld_radiograph_porosity — py -3.11 examples/poc_weld_radiograph_porosity.py

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

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

Gleiche Kategorie (`shape`)

rounded_rect · filled_polygon · ellipse

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

arc — ANNOTATE shape op