You are here: Start » AVL.NET » AVL.AdjustPathArrayToEdges Method

AVL.AdjustPathArrayToEdges Method

Translates, rotates and scales the given contour set to the edges of the input image with subpixel precision.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void AdjustPathArrayToEdges(
	AvlNet.Image inImage,
	AvlNet.Path[] inPaths,
	float inAttractionRadius,
	AvlNet.AdjustmentMetric inAdjustmentMetric,
	bool inAdjustTranslation,
	bool inAdjustRotation,
	bool inAdjustScale,
	int inIterationCount,
	float inBaseGradient,
	out AvlNet.Path[] outAdjustedPaths,
	out AvlNet.CoordinateSystem2D outAlignment,
	out AvlNet.Segment2D[] diagAttractionVectors
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inPathsAvlNet.PathPaths to be adjusted. For sparse, synthetic paths the inPointSpacing needs to be specified.
inAttractionRadiusfloat<0.1f, INF>2.0fExpected initial distance between inPaths and edges of the input image. Default value: 2.0f.
inAdjustmentMetricAvlNet.AdjustmentMetricSegmentDistanceMetric used for path attraction. The SegmentDistance minimizes distances along path normal vectors, and thus adjustment is more accurate. PointDistance_* minimize euclidean distance, adjustment tends to be more stable. Default value: SegmentDistance.
inAdjustTranslationboolTrueCompute the translation part of adjustment transform. Must be true when using AttractPathTangents estimation method. Default value: True.
inAdjustRotationboolTrueCompute the rotation part of adjustment transform. Default value: True.
inAdjustScaleboolFalseCompute the scale part of adjustment transform. Default value: False.
inIterationCountint<0, 100>6Number of iterations of internal adjustment algorithm. Default value: 6.
inBaseGradientfloat<0.1f, INF>1.0fThreshold for suppression of weak input image gradients. Increase for very noisy images. Default value: 1.0f.
outAdjustedPathsAvlNet.PathOutput paths, adjusted.
outAlignmentAvlNet.CoordinateSystem2DCorrected alignment - the inAlignment input modified with estimated adjustment parameters.
diagAttractionVectorsAvlNet.Segment2DAttraction vectors from first iteration.

Examples

Improving results of template matching. Blue – input paths, orange – attraction vectors, green – corrected paths.

Errors

Error type Description
DomainError ComputeTranslation must be enabled for SegmentDistance adjustment metric

See also