Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Computer Vision » Shape Adjustment » AdjustPathArraysToEdges

AdjustPathArraysToEdges


Module: FoundationPro

Translates, rotates and scales multiple contour sets (PathArray), each separately, to the edges of the input image with subpixel precision.

Applications

Fine-tune results of edge-based template matching.
Name Type Range Description
inImage Image Input image.
inPaths PathArrayArray Paths to be adjusted. For sparse, synthetic paths the inPointSpacing needs to be specified.
inPointSpacing Real* 1.0 - If set, sampling points of the input path will be equidistant with specified spacing. Useful for increasing density of synthetic, sparse paths.
inAlignments CoordinateSystem2DArray* Alignments to be corrected, usually connect to outObjects.Alignment[] of LocateObjects:Multiple filter.
inAttractionRadius Real 0.1 - Expected initial distance between inPaths and edges of the input image.
inAdjustmentMetric AdjustmentMetric Metric 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.
inAdjustTranslation Bool Compute the translation part of adjustment transform. Must be true when using AttractPathTangents estimation method.
inAdjustRotation Bool Compute the rotation part of adjustment transform.
inAdjustScale Bool Compute the scale part of adjustment transform.
inIterationCount Integer 0 - 100 Number of iterations of internal adjustment algorithm.
inBaseGradient Real 0.1 - Threshold for suppression of weak input image gradients. Increase for very noisy images.
outAdjustedPaths PathArrayArray Adjusted output paths.
outAlignments CoordinateSystem2DArray Corrected alignments - inAlignments input modified with estimated adjustment parameters.
diagAttractionVectors Segment2DArrayArray Attraction vectors from first iteration.

Hints

Hardware Acceleration

This operation is optimized for SSSE3 technology for pixels of type: UINT8.

This operation is optimized for AVX2 technology for pixels of type: UINT8.

This operation is optimized for NEON technology for pixels of type: UINT8.

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError inPaths and inAlignments have different size
DomainError To use SegmentDistance adjustment metric, inAdjustTranslation must be enabled.

Complexity Level

This filter is available on Advanced Complexity Level.

See Also

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