scale_bar — ANNOTATE `furniture` op

• Datenarten: image2d → image2d

• Aufruf: 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) (oder opsannotate.get("scale_bar"))

Verwendung

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

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

バーの画素長は `round(length / units_per_pixel)` ―― これが構成的な真値で、

:mod:tests.test_annotate はこの一致を数字で確かめている。

Parameters

----------

length : float

バーが表す物理長(`unit` の単位で)。

units_per_pixel : float

1 画素が何 `unit` に相当するか。倍率ではなく分解能を渡す。

unit : str

単位の表記(`'µm', 'mm', 'px'` など)。

xy : (x,y) or None

バーの基準点。None なら `anchor 側の隅から margin` 内側。

label : bool

`"200 µm"` のラベルを併記するか。

Returns

-------

ndarray

Raises

------

ValueError

length / units_per_pixel が非正・非有限、画素長が 1 未満、

バー(とラベル)が画像に収まらない。

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie figure_annotation

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• dataset_conventions — 学習データセット規約の知識 — COCO / YOLO / VOC と外観検査での落とし穴

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