Back to FabImage Studio website

You are here: Start » Filter Reference » Point3DGrid » Point3DGrid Fitting » AdjustPointGrids3DGlobal

AdjustPointGrids3DGlobal

Advanced

Module: Vision3DStandard

Aligns (rotation + translation) a point grid to match best the reference point grid using a global registration algorithm.

Name Type Range Description
Input value inPoints Point3DGrid Data points to be aligned, may contain background clutter.
Input value inReferencePoints Point3DGrid Reference points to align to, may contain background clutter.
Input value inSampleCount Integer 1 - Number of random samples used by the registration algorithm. Recommended values are from 200 to several thousands.
Input value inOverlap Real 0.0 - 1.0 Defines the estimated overlap between two input grids (0 = no overlap, 1.0 = every point in inPoints is also in inReferencePoints).
Input value inDeltaCorrection Real 0.0 - Defines the accuracy of the final alignment. With smaller delta the amount of allocated memory increases.
Input value inTransformLimits3D TransformLimits3D* Limits the maximum rotation angles and translation along each axis, of the final transform.
Input value inMaxTranslationDistance Real* 0.0 - Limits the length of the translation vector of the final transform.
Input value inSeed Integer* Seed for a random generator used by the algorithm.
Output value outAlignedPoints Point3DGrid The aligned input points.
Output value outAlignment Matrix The transform that aligns best the input points to the reference points.
Output value outDelta Real Returns estimated value of the parameter delta.

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 Input point array is empty in AdjustPointGrids3DGlobal.
DomainError Parameter inDeltaCorrection in AdjustPointGrids3DGlobal has to be greater than 0.0.

Complexity Level

This filter is available on Advanced Complexity Level.