Start » Filter Reference » Surface » Surface Fitting » FitPlaneToSurface_M

FitPlaneToSurface_M

Basic

Module: Vision3DStandard

Approximates points of the input surface with a plane using selected M-estimator for outlier suppression.

Applications

Finding a locally optimal plane. Good enough when the number of outliers is small.
Name Type Range Description
Input value
 inSurface Surface Input surface
Input value
 inRoi Region* Region of interest
Input value
 inOutlierSuppression MEstimator Selects a method for ignoring points being much different from the rest
Input value
 inClippingFactor Real 0.675 - 6.0 Multitude of standard deviation within which points are considered inliers
Input value
 inIterationCount Integer 0 - Number of iterations of outlier suppressing algorithm
Input value
 inInitialPlane Plane3D* Initial approximation (if available)
Output value
 outPlane Plane3D Fitted plane
Output value
 outInliers Point3DArray Points matching the computed plane
Output value
 outDistances RealArray Distances of the input points to a resulting plane
Output value
 outSignedDistanceSum Real Sum of signed distances of the input points to a resulting plane
Output value
 outDistanceSum Real Sum of distances of the input points to a resulting plane
Output value
 outSquaredDistances RealArray Squared distances of the input points to a resulting plane
Output value
 outSquaredDistanceSum Real Sum of squared distances of the input points to a resulting plane

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

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.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of FitPlaneToSurface filter group.