Back to FabImage Studio website

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

FitLineToPoints_M

Advanced

Module: FoundationBasic

Approximates points with a line using selected M-estimator for outlier suppression.

Applications

Finding a locally optimal line. Good enough when the number of outliers is small.
Name Type Range Description
Input value
 inPoints Point2DArray
Input value
 inRange Range* Determines which array points take part in fitting process
Input value
 inOutlierSuppression MEstimator
Input value
 inClippingFactor Real 0.675 - 6.0 Multitude of standard deviation within which points are considered inliers
Input value
 inIterationCount Integer 0 - Number of iterations of outlier suppressing algorithm
Input value
 inInitialLine Line2D* Initial approximation (if available)
Output value
 outLine Line2D
Output value
 outInliers Point2DArray Points matching the computed line

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_M.
DomainError Range exceeds the input point array in FitLineToPoints_M.

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of FitLineToPoints filter group.