Back to Aurora Vision Library website

You are here: Start » Function Reference » Geometry 3D » Geometry 3D Fitting » FitCircleToPoints3D

FitCircleToPoints3D


Header: AVL.h
Namespace: avl
Module: Vision3DStandard

Approximates points in 3D with a circle using selected outliers suppression method.

Syntax

C++
C#
 
void avl::FitCircleToPoints3D
(
	const atl::Array<avl::Point3D>& inPoints,
	avl::CircleFittingMethod::Type inFittingMethod,
	atl::Optional<avl::MEstimator::Type> inOutlierSuppression,
	atl::Optional<const avl::Plane3D&> inPlane,
	atl::Conditional<avl::Circle3D>& outCircle,
	atl::Optional<atl::Array<avl::Point3D>&> outInliers = atl::NIL
)

Parameters

Name Type Default Description
Input value inPoints const Array<Point3D>&
Input value inFittingMethod CircleFittingMethod::Type
Input value inOutlierSuppression Optional<MEstimator::Type> NIL
Input value inPlane Optional<const Plane3D&> NIL
Output value outCircle Conditional<Circle3D>& Fitted circle or nothing if method failed to converge,
Output value outInliers Optional<Array<Point3D>&> NIL

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.

Errors

List of possible exceptions:

Error type Description
DomainError Empty point array on input in FitCircleToPoints3D.