Back to Aurora Vision Library website
You are here: Start » Function Reference » Geometry 2D » Geometry 2D Fitting » FitSegmentToPoints_LTE
![](../../img/icon/FitSegmentToPoints.png)
FitSegmentToPoints_LTE
Header: | AVL.h |
---|---|
Namespace: | avl |
Module: | FoundationBasic |
Approximates points with a segment using Least Trimmed Error algorithm.
Applications: Brute-force finding of a segment that best matches a subset of the input points. Very efficient against outliers, but possibly slow for bigger subsets.
Syntax
C++
C#
void avl::FitSegmentToPoints_LTE ( const atl::Array<avl::Point2D>& inPoints, atl::Optional<const avl::Range&> inRange, int inSeedSubsetSize, atl::Optional<int> inEvalSubsetSize, avl::Segment2D& outSegment, atl::Optional<atl::Array<avl::Point2D>&> outLTInliers = atl::NIL, atl::Optional<float&> outLTError = atl::NIL, int& diagIterationCount = atl::Dummy<int>() )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() |
inPoints | const Array<Point2D>& | Input points | ||
![]() |
inRange | Optional<const Range&> | NIL | Determines which array points take part in fitting process | |
![]() |
inSeedSubsetSize | int | 2 - 10 | 3 | Number of points in one combination for getting a sample segment |
![]() |
inEvalSubsetSize | Optional<int> | 3 - ![]() |
NIL | Number of closest points used for evaluation of a sample segment, or Auto if seed points are to be used |
![]() |
outSegment | Segment2D& | Fitted segment | ||
![]() |
outLTInliers | Optional<Array<Point2D>&> | NIL | Inlying points of the best LTE segment | |
![]() |
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 atl::NIL
to these parameters: outLTInliers, outLTError.
Read more about Optional Outputs.
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Empty array of points in FitSegmentToPoints_LTE. |
DomainError | Range exceeds the input point array in FitSegmentToPoints_LTE. |