fit_circle_xld — SHAPE2D `descriptor` op

• 資料種類:contour → table

• 呼叫: import fullseye as fs; fs.ledger.fit_circle_xld(contour, method='geometric')(要直接呼叫實作,import fourierdesc; fourierdesc.fit_circle_xld(contour, method='geometric');從台帳取用則 opsshape2d.get("fit_circle_xld"))

• GPU:無(僅 CPU 參考實作)

用法

對每條 XLD 輪廓擬合圓，傳回圓心的列、行座標與半徑（table）。

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

HALCON fit_circle_contour_xld の Row / Column / Radius にあたる。進化 op の hx_fit_circle_contour は残差(正規化 feature)しか返さないので、輪郭から 位置と大きさを読むのはこちら。座標は XLD と同じ (row, col)、単位は画素。

method は "geometric"(既定。点から円までの距離の二乗和を Levenberg--Marquardt で最小化、Chernov & Lesort 2005 = measure.fit_circle_geometric) か "algebraic"(Kåsa / Coope の代数的最小二乗 = measure.fit_circle。短い円弧では半径が小さく偏る)。返す dict の row・col・radius・rms (点の動径残差の二乗平均平方根)・n_points は輪郭の並び順の list で、n_contours が当てた本数、n_skipped が点が 3 個未満で飛ばした本数、method が使った方法。

空の入力(contour が 0 要素 = 輪郭が 1 本も無い)は ValueError。拒否(ValueError): XLD の dict({"shape", "cs"})でない、未知の method、点が 3 個以上ある輪郭が 1 本も無い、非有限の座標、点が一直線に並ぶ(円が決まらない)。

詳細使用指南

• shape_description_2d 族使用指南

參考(範例資料、文獻)

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

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

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

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

• fit_circle_xld_bore — py -3.11 examples/fit_circle_xld_bore.py

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

from_xld

同類別(`descriptor`)

elliptic_fourier · reconstruct · invariants · normalize · descriptor_distance · fourier_smooth · from_xld · contour_fourier_complex

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

fit_circle_xld — SHAPE2D descriptor op

用法