Start » Filter Reference » Geometry 2D » Geometry 2D Fitting » FitLineToPoints_TheilSen

FitLineToPoints_TheilSen

Advanced

Module: FoundationBasic

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

Applications

Finds a well matching line, 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
 outLine Line2D Fitted line
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 FitLineToPoints_TheilSen.
DomainError Range exceeds the input point array in FitLineToPoints_TheilSen.

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of FitLineToPoints filter group.