Start » Filter Reference » Surface » Surface Fitting » FitPlaneToSurface_M

FitPlaneToSurface_M


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.