ellipse — ANNOTATE `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)。

詳細使用指南

• figure_annotation 族使用指南

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

• 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_driving_crossing — py -3.11 examples/poc_driving_crossing.py

• poc_driving_lateral — py -3.11 examples/poc_driving_lateral.py

• poc_driving_pass — py -3.11 examples/poc_driving_pass.py

• poc_machine_condition_fusion — py -3.11 examples/poc_machine_condition_fusion.py

• poc_peg_insertion_tactile — py -3.11 examples/poc_peg_insertion_tactile.py

• poc_public_camera_heading_real — py -3.11 examples/poc_public_camera_heading_real.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 自動產生(請勿手動編輯)。*

ellipse — ANNOTATE shape op

用法