Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Geometry 2D » Geometry 2D Fitting » FitCircleToPoints

FitCircleToPoints


Module: FoundationBasic

Approximates points with a circle using selected outliers suppression method.

Name Type Description
inPoints Point2DArray
inRange Range* Determines which array points take part in fitting process
inFittingMethod CircleFittingMethod
inOutlierSuppression MEstimator*
outCircle Circle2D? Fitted circle or nothing if method failed to converge
outInliers Point2DArray Points matching the computed circle

Description

The operation computes a circle which approximates the input points best. Several methods are available, AlgebraicKasa being the fastest one. It is also the most inaccurate when the input points are sampled along small arc only.

Examples

The resulting outCircle drawn with the input points, inFittingMethod = AlgebraicKasa and inOutlierSuppression = Auto.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Outlier suppression is supported only in algebraic fitting methods.
DomainError Range exceeds the input point array in FitCircleToPoints.

Complexity Level

This filter is available on Basic Complexity Level.

See Also

  • FitArcToPoints – Approximates points with an arc using the selected outliers suppression method.
  • FitLineToPoints – Approximates points with a line using the Least Squares method.