Back to Adaptive Vision Library websiteYou are here:
Start »
Function Reference »
Geometry 3D Fitting »
FitPlaneToPoints
Approximates points with a plane using the Least Squares method.
Syntax
C++
C#
void avl::FitPlaneToPoints
(
const atl::Array<avl::Point3D>& inPoints,
avl::Plane3D& outPlane,
atl::Optional<atl::Array<float>&> outDistances = atl::NIL,
atl::Optional<float&> outSignedDistanceSum = atl::NIL,
atl::Optional<float&> outDistanceSum = atl::NIL,
atl::Optional<atl::Array<float>&> outSquaredDistances = atl::NIL,
atl::Optional<float&> outSquaredDistanceSum = atl::NIL
)
void FitPlaneToPoints
(
Point3D[] inPoints,
out Plane3D outPlane,
out float[] outDistances,
out float? outSignedDistanceSum,
out float? outDistanceSum,
out float[] outSquaredDistances,
out float? outSquaredDistanceSum
)
Parameters
|
Name |
Type |
Default |
Description |
|
inPoints |
const Array<Point3D>& |
|
|
|
outPlane |
Plane3D& |
|
Fitted plane |
|
outDistances |
Optional<Array<float>&> |
NIL |
Distances of the input points to a resulting plane |
|
outSignedDistanceSum |
Optional<float&> |
NIL |
Sum of signed distances of the input points to a resulting plane |
|
outDistanceSum |
Optional<float&> |
NIL |
Sum of distances of the input points to a resulting plane |
|
outSquaredDistances |
Optional<Array<float>&> |
NIL |
Squared distances of the input points to a resulting plane |
|
outSquaredDistanceSum |
Optional<float&> |
NIL |
Sum of squared distances of the input points to a resulting plane |
Errors
Error type |
Description |
DomainError |
Empty point array on input in FitPlaneToPoints. |