scale_bar — ANNOTATE `furniture` op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.scale_bar(img, length, units_per_pixel, unit='µm', xy=None, anchor='rb', color='neutral', thickness=5, margin=14, font_size=13, label=True, label_fmt='{:g}', font_path=None, scheme='okabe_ito', text_color=None) (die Implementierung direkt: import annotate; annotate.scale_bar(img, length, units_per_pixel, unit='µm', xy=None, anchor='rb', color='neutral', thickness=5, margin=14, font_size=13, label=True, label_fmt='{:g}', font_path=None, scheme='okabe_ito', text_color=None); aus dem Register: opsannotate.get("scale_bar"))

Verwendung

Ein Maßstabsbalken in physikalischer Länge. Die Umrechnung Pixel↔Physik wird als Argument übergeben (nie angenommen).

Die Pixellänge des Balkens ist round(length / units_per_pixel) -- das ist die Ground Truth per Konstruktion, und tests.test_annotate prüft diese Übereinstimmung mit Zahlen.

Parameters

length : float

Physikalische Länge, die der Balken darstellt (in Einheiten von unit).

units_per_pixel : float

Wie vielen unit 1 Pixel entspricht. Übergeben wird die Auflösung, nicht die Vergrößerung.

unit : str

Schreibweise der Einheit ('µm', 'mm', 'px' usw.).

xy : (x,y) or None

Bezugspunkt des Balkens. Bei None margin nach innen von der Ecke auf der anchor-Seite.

label : bool

Ob das Label "200 µm" daneben gesetzt wird.

Returns

ndarray

Raises

ValueError

length / units_per_pixel nicht positiv oder nicht endlich, Pixellänge unter 1,

Balken (und Label) passen nicht ins Bild.

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 · label_points · crosshair · legend_box · color_bar · axes_frame

Gleiche Kategorie (`furniture`)

legend_box · color_bar

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

scale_bar — ANNOTATE furniture op