annotate_invert_path — ANNOTATE `overlay` op

• データ種: image2d × pairs → image2d

• 呼び出し: import fullseye as fs; fs.ledger.annotate_invert_path(img, points, width=1.5, closed=False, dash=None, mode='complement', alpha=1.0, bits=128, min_contrast=1.5, on_invisible='warn') (実装を直接呼ぶなら import annotate; annotate.annotate_invert_path(img, points, width=1.5, closed=False, dash=None, mode='complement', alpha=1.0, bits=128, min_contrast=1.5, on_invisible='warn')、台帳から引くなら opsannotate.get("annotate_invert_path"))

使い方

折れ線(line)を反転色で描く。アンチエイリアスつき。

線は領域より不利で、そこがこの op を分けている理由 —— 太さ 1.5 画素の

線は端の画素の被覆率が 0.3 程度しかないため、**反転しても被覆の分しか

動かない**。中間調の地では領域よりさらに先に消える。判定は「被覆率

0.5 以上の画素」で行う(それ未満は元から半透明なので、見えなくても

それは反転のせいではない)。

Parameters

----------

points : (N,2)

折れ線の頂点 `(x, y)`(画素座標)。

width : float

線の太さ(画素、0.5 以上)。

closed : bool

真なら最後の点と最初の点を結ぶ。

dash : (on, off) or None

破線の刻み(画素)。:func:_dash_pieces と同じ規則。

mode, alpha, min_contrast, on_invisible :

:func:annotate_invert と同じ。

Returns

-------

(H,W[,C]) float64

反転を乗せた複製。

Examples

--------

>>> import numpy as np, annotate

>>> img = np.zeros((16, 32))

>>> out = annotate.annotate_invert_path(img, [(2, 8), (29, 8)], width=3)

>>> float(out[8, 15]) # 黒地の上なので白い線になる

1.0

>>> float(out[2, 15]) # 線から離れたところは元のまま

0.0

詳しい使い方ガイド

• figure_annotation ファミリガイド

背景知識ガイド(この op の手前にある物理・規約)

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

参考(サンプルデータ・文献)

• サンプルデータカタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• annotate_paper_tour — py -3.11 examples/annotate_paper_tour.py

型が繋がる次の op(`image2d` を入力に取れる)

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

同カテゴリ(`overlay`)

overlay_mask · overlay_labels · annotate_invert_visibility · annotate_invert

*Provenance: annotate.py — ANNOTATE operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

annotate_invert_path — ANNOTATE overlay op

使い方