Back to FabImage Library website

You are here: Start » Function Reference » Geometry 3D » Geometry 3D Features » Points3DMedian

Points3DMedian


Header: FIL.h
Namespace: fil
Module: Vision3DLite

Computes the geometric median of the input points.

Syntax

C++
C#
 
void fil::Points3DMedian
(
	const ftl::Array<fil::Point3D>& inPoints,
	ftl::Optional<const ftl::Array<float>&> inWeights,
	const int inMaxIterationCount,
	fil::Point3D& outGeometricMedian,
	ftl::Optional<float&> outDistanceSum = ftl::NIL,
	ftl::Array<fil::Point3D>& diagApproximationSteps = ftl::Dummy<ftl::Array<Point3D>>()
)

Parameters

Name Type Range Default Description
Input value inPoints const Array<Point3D>& Input points
Input value inWeights Optional<const Array<float>&> NIL Optional input weights
Input value inMaxIterationCount const int 1 - 10 Maximum number of iterations
Output value outGeometricMedian Point3D& Geometric median
Output value outDistanceSum Optional<float&> NIL Sum of distances from input points to geometric median
Diagnostic input diagApproximationSteps Array<Point3D>& Approximate geometric medians calculated during subsequent iterations

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outDistanceSum.

Read more about Optional Outputs.

Errors

List of possible exceptions:

Error type Description
DomainError Input arrays must be of the same size in Points3DMedian.
DomainError Input point array is empty in Points3DMedian.