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

用法