Back to FabImage Studio website

You are here: 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.