Back to Aurora Vision Library website

You are here: Start » Function Reference » Geometry 2D » Geometry 2D Fitting » FitArcToPoints


Header: AVL.h
Namespace: avl
Module: FoundationBasic

Approximates points with an arc using the selected outliers suppression method.


void avl::FitArcToPoints
	const atl::Array<avl::Point2D>& inPoints,
	atl::Optional<const avl::Range&> inRange,
	avl::CircleFittingMethod::Type inFittingMethod,
	atl::Optional<avl::MEstimator::Type> inOutlierSuppression,
	atl::Conditional<avl::Arc2D>& outArc,
	atl::Optional<atl::Array<avl::Point2D>&> outInliers = atl::NIL


Name Type Default Description
Input value
inPoints const Array<Point2D>&
Input value
inRange Optional<const Range&> NIL Determines which array points take part in fitting process
Input value
inFittingMethod CircleFittingMethod::Type
Input value
inOutlierSuppression Optional<MEstimator::Type> NIL
Output value
outArc Conditional<Arc2D>& Fitted arc or nothing if the computations failed to converge
Output value
outInliers Optional<Array<Point2D>&> NIL Points matching the fitting arc

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outInliers.

Read more about Optional Outputs.


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


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 FitArcToPoints.