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

FitPathToRidges3D

Performs a series of 1D ridge detections and creates a path from the detected points.

Header:	AVL.h

Syntax

void avl::FitPathToRidges3D
(
	const avl::Surface& inSurface,
	const PathFittingMap& inFittingMap,
	const RidgeScanParams3D& inRidgeScanParams,
	avl::Selection::Type inRidgeSelection,
	atl::Optional<const avl::LocalBlindness&> inLocalBlindness,
	atl::Optional<int> inMaxProfileGapWidth,
	atl::Optional<int> inMaxPathInterpolationLength,
	atl::Optional<float> inMaxDeviationDelta,
	float inMaxIncompleteness,
	atl::Conditional<atl::Array<avl::Point3D> >& outPath,
	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 FitPathToRidges3D
(
	Surface inSurface,
	PathFittingMap inFittingMap,
	RidgeScanParams3D inRidgeScanParams,
	Selection inRidgeSelection,
	LocalBlindness? inLocalBlindness,
	int? inMaxProfileGapWidth,
	int? inMaxPathInterpolationLength,
	float? inMaxDeviationDelta,
	float inMaxIncompleteness,
	out Point3D[] outPath,
	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 path to
inFittingMap	const PathFittingMap&			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
inMaxPathInterpolationLength	Optional<int>		NIL	Maximal number of consecutive points not found
inMaxDeviationDelta	Optional<float>	0.0 -	NIL	Maximal difference between deviations of consecutive path points
inMaxIncompleteness	float	0.0 - 0.999	0.1f	Maximal fraction of ridge points not found
outPath	Conditional<Array<Point3D> >&			Fitted path or nothing if the fitting failed
outRidges	Optional<Array<Conditional<SurfaceRidge1D> >&>		NIL	Found ridges
outDeviationProfile	Optional<Conditional<Profile>&>		NIL	Profile of distances between the actual path points and the corresponding reference path 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 FitPathToRidges3D.