scale_bar — ANNOTATE `furniture` op

• 資料種類:image2d → image2d

• 呼叫: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)(或 opsannotate.get("scale_bar"))

用法

物理長度的比例尺。像素↔物理的換算由參數給出(不自行假定)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

バーの画素長は `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 未満、

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

詳細使用指南

• figure_annotation 族使用指南

背景知識指南(該運算子背後的物理與規範)

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

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者・年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

型別可銜接的下一個運算子(可接受 `image2d` 作為輸入)

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

同類別(`furniture`)

legend_box · color_bar

*Provenance: annotate.py — ANNOTATE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

scale_bar — ANNOTATE furniture op

用法