Back to FabImage Studio website

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

AdjustPointGrids3DGlobal


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
inMaxAngle Real* 0.0 - 360.0 Limits the maximum rotation angle 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.