You are here: Start » AVL.NET » Function Reference » Surface » Surface Fitting » AVL.FitPlaneToSurface_M
Approximates points of the input surface with a plane using selected M-estimator for outlier suppression.
Namespace: | AvlNet |
---|---|
Assembly: | AVL.NET.dll |
Syntax
C++
C#
public static void FitPlaneToSurface_M ( AvlNet.Surface inSurface, NullableRef<AvlNet.Region> inRoi, AvlNet.MEstimator inOutlierSuppression, float inClippingFactor, int inIterationCount, AvlNet.Plane3D? inInitialPlane, out AvlNet.Plane3D outPlane, IList<AvlNet.Point3D> outInliers, IList<float> outDistances, out float outSignedDistanceSum, out float outDistanceSum, IList<float> outSquaredDistances, out float outSquaredDistanceSum )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() | inSurface | AvlNet.Surface | Input surface. | ||
![]() | inRoi | AvlNet.NullableRef<AvlNet.Region> | Region of interest. Default value: atl::NIL. | ||
![]() | inOutlierSuppression | AvlNet.MEstimator | Selects a method for ignoring points being much different from the rest. | ||
![]() | inClippingFactor | float | <0.675f, 6.0f> | 2.5f | Multitude of standard deviation within which points are considered inliers. Default value: 2.5f. |
![]() | inIterationCount | int | <0, INF> | 5 | Number of iterations of outlier suppressing algorithm. Default value: 5. |
![]() | inInitialPlane | AvlNet.Plane3D? | Initial approximation (if available). Default value: atl::NIL. | ||
![]() | outPlane | AvlNet.Plane3D | Fitted plane. | ||
![]() | outInliers | System.Collections.Generic.IList<AvlNet.Point3D> | Points matching the computed plane. | ||
![]() | outDistances | System.Collections.Generic.IList<float> | Distances of the input points to a resulting plane. | ||
![]() | outSignedDistanceSum | float | Sum of signed distances of the input points to a resulting plane. | ||
![]() | outDistanceSum | float | Sum of distances of the input points to a resulting plane. | ||
![]() | outSquaredDistances | System.Collections.Generic.IList<float> | Squared distances of the input points to a resulting plane. | ||
![]() | outSquaredDistanceSum | float | Sum of squared distances of the input points to a resulting plane. |
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | No points to fit the plane to in FitPlaneToSurface_M. |
DomainError | Region of interest exceeds an input surface in FitPlaneToSurface_M. |
Function Overrides
- FitPlaneToSurface_M(Surface, MEstimator, Single, Int32, Plane3D)
- FitPlaneToSurface_M(Surface, NullableRef<Region>, MEstimator, Single, Int32, Nullable<Plane3D>, Plane3D)
- FitPlaneToSurface_M(Surface, NullableRef<Region>, MEstimator, Single, Int32, Nullable<Plane3D>, Plane3D, NullableRef<List<Point3D>>, NullableRef<List<Single>>, NullableValue<Single>, NullableValue<Single>, NullableRef<List<Single>>, NullableValue<Single>)