Back to Adaptive Vision Library website

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

FitCircleToPoints


Header:AVL.h
Namespace:avl

Approximates points with a circle using selected outliers suppression method.

Syntax

C++
C#
 
void avl::FitCircleToPoints
(
	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::Circle2D>& outCircle
)

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

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.

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.