You are here: Start » Function Reference » Shape Fitting 3D » FitCircleToRidges3D

FitCircleToRidges3D

Performs a series of 1D ridge detections and finds a circle that best matches the detected points.

Header:	AVL.h

Syntax

void avl::FitCircleToRidges3D
(
	const avl::Surface& inSurface,
	const CircleFittingMap& inFittingMap,
	const RidgeScanParams3D& inRidgeScanParams,
	avl::Selection::Type inRidgeSelection,
	atl::Optional<const avl::LocalBlindness&> inLocalBlindness,
	atl::Optional<int> inMaxProfileGapWidth,
	float inMaxIncompleteness,
	avl::CircleFittingMethod::Type inFittingMethod,
	atl::Optional<avl::MEstimator::Type> inOutlierSuppression,
	atl::Conditional<avl::Circle3D>& outCircle,
	atl::Optional<atl::Array<atl::Conditional<avl::SurfaceRidge1D> >&> outRidges = atl::NIL,
	atl::Optional<atl::Conditional<avl::Profile>&> outDeviationProfile = atl::NIL,
	atl::Array<avl::Profile>& diagHeightProfiles,
	atl::Array<avl::Profile>& diagResponseProfiles
)

void FitCircleToRidges3D
(
	Surface inSurface,
	CircleFittingMap inFittingMap,
	RidgeScanParams3D inRidgeScanParams,
	Selection inRidgeSelection,
	LocalBlindness? inLocalBlindness,
	int? inMaxProfileGapWidth,
	float inMaxIncompleteness,
	CircleFittingMethod inFittingMethod,
	MEstimator? inOutlierSuppression,
	out Circle3D? outCircle,
	out SurfaceRidge1D?[] outRidges,
	out Profile? outDeviationProfile,
	out Profile[] diagHeightProfiles,
	out Profile[] diagResponseProfiles
)

Parameters

Name	Type	Range	Default	Description
inSurface	const Surface&			Surface to fit the circle to
inFittingMap	const CircleFittingMap&			Input fitting map
inRidgeScanParams	const RidgeScanParams3D&			Parameters controlling the ridge extraction process
inRidgeSelection	Selection::Type		SelectionBest	Selection mode of ridges
inLocalBlindness	Optional<const LocalBlindness&>		NIL	Defines conditions in which weaker ridges can be detected in the vicinity of stronger ridges
inMaxProfileGapWidth	Optional<int>	0 -	1	Maximal number of consecutive not existing profile points
inMaxIncompleteness	float	0.0 - 0.999	0.1f	Maximal fraction of ridge points not found
inFittingMethod	CircleFittingMethod::Type		AlgebraicTaubin	Method used to fit a circle
inOutlierSuppression	Optional<MEstimator::Type>		NIL	Selects a method for ignoring incorrectly detected points
outCircle	Conditional<Circle3D>&			Fitted circle or nothing if the fitting fails
outRidges	Optional<Array<Conditional<SurfaceRidge1D> >&>		NIL	Found ridges
outDeviationProfile	Optional<Conditional<Profile>&>		NIL	Profile of distances between the actual circle points and the corresponding reference circle points
diagHeightProfiles	Array<Profile>&			Extracted surface height profiles
diagResponseProfiles	Array<Profile>&			Profiles of the ridge operator response

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

Error type	Description
DomainError	Ridge operator parameters are too low in surface ridges detector in FitCircleToRidges3D.