fit_circle_xld — SHAPE2D `descriptor` op

• Datenarten: contour → table

• Aufruf: import fullseye as fs; fs.ledger.fit_circle_xld(contour, method='geometric') (die Implementierung direkt: import fourierdesc; fourierdesc.fit_circle_xld(contour, method='geometric'); aus dem Register: opsshape2d.get("fit_circle_xld"))

• GPU: nein (nur CPU-Referenzimplementierung)

Verwendung

Passt an jede XLD-Kontur einen Kreis an und liefert Mittelpunkt (Zeile, Spalte) und Radius (table).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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 本も無い、非有限の座標、点が一直線に並ぶ(円が決まらない)。

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie shape_description_2d

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• fit_circle_xld_bore — py -3.11 examples/fit_circle_xld_bore.py

Typkompatible Folge-Operatoren (nehmen `table` als Eingabe)

from_xld

Gleiche Kategorie (`descriptor`)

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

*Provenance: fourierdesc.py — SHAPE2D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

fit_circle_xld — SHAPE2D descriptor op