shape op• 資料種類:image2d → image2d
• 呼叫: import fullseye as fs; fs.ledger.ellipse(img, center, radii, angle_deg=0.0, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito')(要直接呼叫實作,import annotate; annotate.ellipse(img, center, radii, angle_deg=0.0, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito');從台帳取用則 opsannotate.get("ellipse"))
橢圓(用 `angle_deg 旋轉,fill=True` 時填充)。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
Raises
------
ValueError
半径が非正、非有限、alpha が [0,1] の外。
描画: 画素を `angle_deg だけ回した局所座標 (u, v)` に写し、
`q = (u/ra)^2 + (v/rb)^2 で判定する。fill=True は q <= 1`、
`fill=False は |sqrt(q) - 1| <= max(1, width) / (2 min(ra, rb))` の帯
(アンチエイリアス無し)。帯の幅を短軸で正規化しているので、扁平な楕円では
長軸の端ほど線が太く見える(近似)。
• `center: (x, y)`、x = 列・y = 行。画像外でもよい。
• `radii: (ra, rb) [px]。ra が angle_deg 方向、rb` がその直交方向。
両方とも正。
• `angle_deg`: 回転角 [度]。x 軸から時計回り(画面座標、y が下向き)。
• `width: 線幅 [px] (fill=False` のとき)。
• `img / color / alpha / scheme の扱いは rounded_rect` と同じ
(float64 複製、`[0, 1]`、役割名か RGB)。
• 返り値: 入力と同形の float64。
`ra == rb なら円。計測結果(楕円フィットの row, col, phi, ra, rb`)を
重ねるときは `center=(col, row)、angle_deg=degrees(phi)` に読み替える。
• 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
• poc_dimensional_inspection — py -3.11 examples/poc_dimensional_inspection.py
• poc_machine_condition_fusion — py -3.11 examples/poc_machine_condition_fusion.py
image2d 作為輸入)text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar
shape)rounded_rect · filled_polygon · arc
*Provenance: annotate.py — ANNOTATE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.