Back to FabImage Library website

You are here: Start » Function Reference » Geometry 3D » Geometry 3D Fitting » FitSegmentToPoints3D_LTE

FitSegmentToPoints3D_LTE


Header: FIL.h
Namespace: fil
Module: Vision3DStandard

Approximates points in 3D with a segment using a RANSAC algorithm.

Syntax

C++
C#
 
void fil::FitSegmentToPoints3D_LTE
(
	const ftl::Array<fil::Point3D>& inPoints,
	int inSeedSubsetSize,
	ftl::Optional<int> inEvalSubsetSize,
	fil::Segment3D& outSegment,
	ftl::Optional<ftl::Array<fil::Point3D>&> outLTInliers = ftl::NIL,
	ftl::Optional<float&> outLTError = ftl::NIL,
	int& diagIterationCount = ftl::Dummy<int>()
)

Parameters

Name Type Range Default Description
Input value
 inPoints const Array<Point3D>&
Input value
 inSeedSubsetSize int 2 - 10 3 Number of points in one combination for getting a sample segment
Input value
 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
Output value
 outSegment Segment3D& Fitted segment
Output value
 outLTInliers Optional<Array<Point3D>&> NIL Inlying points of the best LTE segment
Output value
 outLTError Optional<float&> NIL The Least Trimmed Error
Diagnostic input
 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: outLTInliers, outLTError.

Read more about Optional Outputs.

Errors

List of possible exceptions:

Error type Description
DomainError Empty inPoints array in FitSegmentToPoints3D_LTE.