annotate_outline — ANNOTATE `paper` op

• 資料種類:image2d × mask → image2d

• 呼叫: import fullseye as fs; fs.ledger.annotate_outline(img, mask, label=None, color='emphasis', width=1.5, alpha=1.0, dash=None, font_size=12, label_offset=(0, 0), box_alpha=0.6, text_color=None, scheme='okabe_ito', font_path=None, layout=None)(要直接呼叫實作,import annotate; annotate.annotate_outline(img, mask, label=None, color='emphasis', width=1.5, alpha=1.0, dash=None, font_size=12, label_offset=(0, 0), box_alpha=0.6, text_color=None, scheme='okabe_ito', font_path=None, layout=None);從台帳取用則 opsannotate.get("annotate_outline"))

用法

回傳影像(image2d):把遮罩輪廓畫成(抗鋸齒的)閉合折線,並在重心處放文字。

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

Raises

------

ValueError

mask の形が画像と違う、真の画素が無い、alpha が [0,1] の外。

手順: `layout が無ければ annotate_outline_layout(mask)` で境界ループ

(画素の辺に沿う `(x, y)` の閉多角形、外周と穴の両方、成分ごと)と重心を

求め、各ループを距離被覆率のアンチエイリアス折れ線で載せる。`label` が

あれば重心 + `label_offset に text_box(anchor="cm"`、下敷き付き)を置く。

• `img: (H, W) / (H, W, 1|3|4)、float64 複製・[0, 1]`。

• `mask: (H, W)、画像と同じ形([row, col] 添字)。bool 以外は > 0.5`

で二値化、非有限は `ValueError。真の画素が無ければ ValueError`。

• `width: 線幅 [px]、0.5 以上。dash=(on, off) [px] で破線(on > 0`、

`off >= 0`)。

• `alpha: [0, 1]。box_alpha` は文字の下敷きの不透明度。

• `label_offset: (dx, dy)` [px]。重心が輪郭の外に落ちる形(三日月など)は

ここでずらす。

• `layout: annotate_outline_layout` の返り値を渡すと再計算せず同じ配置を

別の絵に使い回せる(`contours / centroid` を読む)。

• 返り値: 入力と同形の float64。

塗りで示すなら `overlay_mask、複数領域に番号を振るなら annotate_markers`。

詳細使用指南

• figure_annotation 族使用指南

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

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

參考(範例資料・文獻)

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

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

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

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

• paper_figure — py -3.11 examples/paper_figure.py

• poc_rotation_invariance_audit — py -3.11 examples/poc_rotation_invariance_audit.py

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

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

同類別(`paper`)

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

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

annotate_outline — ANNOTATE paper op

用法