Back to Aurora Vision Studio website

You are here: Start » Filter Reference » Computer Vision » Line Finder » FindSingleLine

FindSingleLine

Basic

Module: MetrologyPro

Finds a single straight line within a rectangular scan field.

Applications

Detection of a single straight line in the presence of multiple competing lines or noisy backgrounds.
Name Type Range Description
Input value inImage Image Input image
Input value inScanField SegmentScanField Region where the scans are performed
Input value inScanFieldAlignment CoordinateSystem2D*
Input value inScanWidth Integer 1 - How many pixels are sampled perpendicularly at each scan line's positions
Input value inScanStep Integer 1 - Pixel distance between the centers of consecutive scan lines
Input value inScanLimit Integer 1 - Maximum number of scan lines
Input value inEdgeScanParams EdgeScanParams Parameters of 1D edge detection along a single scan line
Input value inPointBlindness Real 0.0 - 1.0 Defines a threshold for rejecting edge points that are weaker than a certain portion of the strongest edge point
Input value inMaxSlant Real 0.0 - 45.0 Maximum angle deviation of the resulting line from 90 degrees to the scan axis
Input value inMinLength Real 0.0 - Minimum length of the resulting line
Input value inMaxGap Real 0.0 - Maximum gap within a resulting line
Input value inMinPointCount Integer 2 - Minimum number of edge points that a resulting line must contain (otherwise it is rejected)
Input value inLineSelection LineSelection Selection criteria for edge lines
Input value inLineBlindness Real 0.0 - 1.0 Defines a threshold for rejecting entire lines that are weaker than a certain portion of the strongest line
Input value inEdgeMeasure EdgeMeasure Several options for measuring a single edge point
Input value inLineFinderMethod LineFinderMethod Several alternative algorithms for finding lines within the detected cloud of edge points
Input value inMaxPointDeviation Real 0.0 - Maximum pixel distance between a detected line and its supporting edge points
Input value inMaxTurnAngle Real 0.0 - 90.0 Maximum turn angle at any interior vertex of the line path
Input value inOutlierSuppression LineMEstimator* A method for removing outlying points
Input value inRefineEndpoints Bool Turns on a method for refining the length of the detected line
Output value outLine Segment2D?
Output value outLineStrength Real
Output value outResponseProfiles ProfileArray Edge response profiles, one per scan line
Output value outAlignedScanField SegmentScanField
Output value outSelectedPoints Point2DArray List of points associated with the returned line
Diagnostic input diagScanLines Segment2DArray
Diagnostic input diagCandidatePoints Point2DArray

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Complexity Level

This filter is available on Basic Complexity Level.