Back to FabImage Studio website

You are here: Start » Filter Reference » Geometry 2D » Geometry 2D Fitting » FitSegmentToPoints_TheilSen

FitSegmentToPoints_TheilSen

Advanced

Module: FoundationBasic

Approximates points with a segment using TheilSen algorithm, optionally with Siegel's improvement.

Applications

Finds a well matching segment, ignoring up to 29.3% (TheilSen) or 50.0% (Siegel) outliers. Outliers do have some influence on accuracy.
Name Type Range Description
Input value
 inPoints Point2DArray Input points
Input value
 inRange Range* Determines which array points take part in fitting process
Input value
 inVariant TheilSenVariant Switches between Theil-Sen and Siegel methods
Input value
 inSampleLimit Integer* 5 - How many pairs of points are used to estimate orientation
Input value
 inOutlierRatio Real* 0.0 - 0.99
Output value
 outSegment Segment2D Fitted segment
Diagnostic input
 diagOrientations RealArray Sample orientations used to determine the output line orientation

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 Empty array of points in FitSegmentToPoints_TheilSen.
DomainError Range exceeds the input point array in FitSegmentToPoints_TheilSen.

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of FitSegmentToPoints filter group.