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

FitCircleToPoints

Header:	FIL.h
Namespace:	fil
Module:	FoundationBasic

Approximates points with a circle using selected outliers suppression method.

Syntax

void fil::FitCircleToPoints
(
	const ftl::Array<fil::Point2D>& inPoints,
	ftl::Optional<const fil::Range&> inRange,
	fil::CircleFittingMethod::Type inFittingMethod,
	ftl::Optional<fil::MEstimator::Type> inOutlierSuppression,
	ftl::Conditional<fil::Circle2D>& outCircle,
	ftl::Optional<ftl::Array<fil::Point2D>&> outInliers = ftl::NIL
)

Parameters

Name	Type	Default	Description
inPoints	const Array<Point2D>&
inRange	Optional<const Range&>	NIL	Determines which array points take part in fitting process
inFittingMethod	CircleFittingMethod::Type
inOutlierSuppression	Optional<MEstimator::Type>	NIL
outCircle	Conditional<Circle2D>&		Fitted circle or nothing if method failed to converge
outInliers	Optional<Array<Point2D>&>	NIL	Points matching the computed circle

Optional Outputs

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

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

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.