You are here: Start » AVL.NET » Function Reference » Path » Path Features » AVL.PathTurnAngleLocalMaxima

AVL.PathTurnAngleLocalMaxima

Finds the local maxima of the profile of turn angles of a path.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void PathTurnAngleLocalMaxima
(
	AvlNet.Path inPath,
	AvlNet.TurnAngleDirection inAllowedTurnDirection,
	AvlNet.TurnAnglePrecision inResultPrecision,
	float inMinTurnAngle,
	float inMinDistance,
	float inSmoothingStdDev,
	IList<float> outTurnAngleMaximaIndices,
	IList<AvlNet.Point2D> outTurnAngleMaximaPoints,
	IList<float> outTurnAngleMaximaAngles
)

Parameters

Name Type Range Default Description
inPathAvlNet.PathInput path.
inAllowedTurnDirectionAvlNet.TurnAngleDirectionAllAllows to detect only left-turns, only right-turns or both. Default value: All.
inResultPrecisionAvlNet.TurnAnglePrecisionSwitches between pixel-precise or subpixel-precise detection of the found maxima.
inMinTurnAnglefloat<0.0f, 180.0f>30.0fMinimal value of a relevant angle. Default value: 30.0f.
inMinDistancefloat<0.0f, INF>0.0fMinimal distance on the path between two local maxima assuming each path segment has unit length. Default value: 0.0f.
inSmoothingStdDevfloat<0.0f, INF>0.6fStandard deviation of the gaussian smoothing applied to the input path. Default value: 0.6f.
outTurnAngleMaximaIndicesSystem.Collections.Generic.IList<float>Indices of found local maxima.
outTurnAngleMaximaPointsSystem.Collections.Generic.IList<AvlNet.Point2D>Found local maxima of turn angle profile of the smoothed input path.
outTurnAngleMaximaAnglesSystem.Collections.Generic.IList<float>Turn angles of found local maxima.

Description

The operation computes the profile of turn angles of a path and finds the local maxima of the profile having value at least inMinTurnAngle. The inAllowedTurnDirection parameter restricts kind of turns taken into consideration (left-turns only, right-turns only or both), while inResultPrecision determines the precision of the resulting maxima points. Found maxima have to be at least inMinDistance from each other (the distance is measured along the input path assuming each path segment has unit length).

Examples

PathTurnAngleLocalMaxima run on the sample path with inAllowedTurnDirection = Right

Function Overrides

See also