nice_ticks — ANNOTATE plot op

• 資料種類:無 → signal(僅由參數決定的運算子 —— 不接受影像或資料輸入)

• 呼叫:import annotate; annotate.nice_ticks(lo, hi, n=5, scale='linear')(或 opsannotate.get("nice_ticks"))

用法

涵蓋 [lo, hi] 的「取整」刻度值(1/2/5 × 10^k,閉合式)。

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

端は含める(`lo や hi` がちょうど目盛りに乗るなら必ず出る)。

浮動小数の丸めで端が 1 個落ちる off-by-one を避けるため、判定には

`step*1e-9` の許容を使う。

`scale='log'` では 1/2/5 × 10^k の十進の刻みを返す(等間隔の刻みを

log 軸に置くと、目盛りが右へ行くほど潰れて読めなくなる)。

Raises

------

ValueError

lo == hi、非有限、n < 1、log で lo か hi が 0 以下。

詳細使用指南

• 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

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

data_to_pixel · plot_series

同類別(plot)

axes_transform · data_to_pixel · axes_frame · grid_lines · ticks · plot_series

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

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.