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

FitSegmentToRidges3D

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

Header:	AVL.h

Syntax

void avl::FitSegmentToRidges3D
(
	const avl::Surface& inSurface,
	const SegmentFittingMap& inFittingMap,
	const RidgeScanParams3D& inRidgeScanParams,
	avl::Selection::Type inRidgeSelection,
	atl::Optional<const avl::LocalBlindness&> inLocalBlindness,
	atl::Optional<int> inMaxProfileGapWidth,
	float inMaxIncompleteness,
	atl::Optional<avl::MEstimator::Type> inOutlierSuppression,
	atl::Conditional<avl::Segment3D>& outSegment,
	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 FitSegmentToRidges3D
(
	Surface inSurface,
	SegmentFittingMap inFittingMap,
	RidgeScanParams3D inRidgeScanParams,
	Selection inRidgeSelection,
	LocalBlindness? inLocalBlindness,
	int? inMaxProfileGapWidth,
	float inMaxIncompleteness,
	MEstimator? inOutlierSuppression,
	out Segment3D? outSegment,
	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 segment to
inFittingMap	const SegmentFittingMap&			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
inOutlierSuppression	Optional<MEstimator::Type>		NIL	Selects a method for ignoring incorrectly detected points
outSegment	Conditional<Segment3D>&			Fitted segment 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 segment points and the corresponding reference segment 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 FitSegmentToRidges3D.