You are here: Start » Function Reference » Geometry 2D Fitting » FitLineToPoints_LTE

FitLineToPoints_LTE

Header:	FIL.h
Namespace:	fil

Approximates points with a line using Least Trimmed Error algorithm.

Syntax

void fil::FitLineToPoints_LTE
(
	const ftl::Array<fil::Point2D>& inPoints,
	int inSeedSubsetSize,
	ftl::Optional<int> inEvalSubsetSize,
	fil::Line2D& outLine,
	ftl::Optional<ftl::Array<fil::Point2D>&> outLTInliers = ftl::NIL,
	ftl::Optional<float&> outLTError = ftl::NIL,
	int& diagIterationCount = ftl::Dummy&lt;int&gt;()
)

Parameters

Name	Type	Range	Default	Description
inPoints	const Array<Point2D>&			Input points
inSeedSubsetSize	int	2 - 10	3	Number of points in one combination for getting a sample line
inEvalSubsetSize	Optional<int>	3 -	NIL	Number of closest points used for evaluation of a sample line, or Auto if seed points are to be used
outLine	Line2D&			Fitted line
outLTInliers	Optional<Array<Point2D>&>		NIL	Inlying points of the best LTE line
outLTError	Optional<float&>		NIL	The Least Trimmed Error
diagIterationCount	int&			Number of combinations considered

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outLine, outLTInliers, outLTError.

Errors

List of possible exceptions:

Error type	Description
DomainError	Empty array of points in FitLineToPoints_LTE.