Back to Aurora Vision Library website
You are here: Start » Function Reference » Geometry 3D » Geometry 3D Features » Points3DMedian
Points3DMedian
Header: | AVL.h |
---|---|
Namespace: | avl |
Module: | Vision3DLite |
Computes the geometric median of the input points.
Syntax
C++
C#
void avl::Points3DMedian ( const atl::Array<avl::Point3D>& inPoints, atl::Optional<const atl::Array<float>&> inWeights, const int inMaxIterationCount, avl::Point3D& outGeometricMedian, atl::Optional<float&> outDistanceSum = atl::NIL, atl::Array<avl::Point3D>& diagApproximationSteps = atl::Dummy<atl::Array<Point3D>>() )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inPoints | const Array<Point3D>& | Input points | |||
inWeights | Optional<const Array<float>&> | NIL | Optional input weights | ||
inMaxIterationCount | const int | 1 - | 10 | Maximum number of iterations | |
outGeometricMedian | Point3D& | Geometric median | |||
outDistanceSum | Optional<float&> | NIL | Sum of distances from input points to geometric median | ||
diagApproximationSteps | Array<Point3D>& | Approximate geometric medians calculated during subsequent iterations |
Optional Outputs
The computation of following outputs can be switched off by passing value atl::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. |