annotate_leader_layout — ANNOTATE paper op

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

呼叫:import annotate; annotate.annotate_leader_layout(shape, points, labels=None, font_size=12, pad=4, gap=22, side='auto', font_path=None, min_font_size=9)(或 opsannotate.get("annotate_leader_layout"))

用法

回傳表(dict):以閉合式確定引出線的佈置(折點・文字位置・襯板矩形)。

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

各点について候補側を固定順に試し、**板が画像に収まり・他の板と重ならず・

他の点を覆わない**最初の候補を採る。どの候補も駄目なら肘を 1.6 倍、2.4 倍に

伸ばして再試行し、それでも駄目なら ValueError(黙って重ねない)。

Parameters

----------

shape : (H, W)

描く画像の大きさ。

points : (N, 2)

指す点 (x, y)

labels : sequence of str or None

各点の文字。None なら 1 始まりの番号。

gap : float

肘の長さ[px]。斜め腕 = gap、水平腕 = 0.6*gap。

side : {'auto','left','right'}

`'auto'` は画像中心から遠ざかる側を先に試す(対象の上に文字を

載せないため)。

Returns

-------

dict

``{"n", "gap", "items": [{"point", "elbow", "text_xy", "anchor",

"box", "side"}]}`box は板の (x, y, w, h)`。

Raises

------

ValueError

点が空・非有限、labels の数が合わない、未知の side、配置できない点。

詳細使用指南

figure_annotation 族使用指南

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

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

參考(範例資料・文獻)

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

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

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

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

paper_figurepy -3.11 examples/paper_figure.py

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

同類別(paper)

annotate_leader · annotate_markers · annotate_legend · annotate_dimension_layout · annotate_dimension · annotate_angle_layout · annotate_angle · annotate_scale_bar_layout


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

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