You are here: Start » AVL.NET » Function Reference » Point3DGrid » Point3DGrid Fitting » AVL.AdjustPointGrids3DGlobal
AVL.AdjustPointGrids3DGlobal
Aligns (rotation + translation) a point grid to match best the reference point grid using a global registration algorithm.
| Namespace: | AvlNet |
|---|---|
| Assembly: | AVL.NET.dll |
Syntax
C++
C#
public static void AdjustPointGrids3DGlobal ( AvlNet.Point3DGrid inPoints, AvlNet.Point3DGrid inReferencePoints, int inSampleCount, float inOverlap, float inDeltaCorrection, NullableRef<AvlNet.TransformLimits3D> inTransformLimits3D, float? inMaxTranslationDistance, int? inSeed, AvlNet.Point3DGrid outAlignedPoints, AvlNet.Matrix outAlignment, out float outDelta )
Parameters
| Name | Type | Range | Default | Description | |
|---|---|---|---|---|---|
 | inPoints | AvlNet.Point3DGrid | Data points to be aligned, may contain background clutter. | ||
| inReferencePoints | AvlNet.Point3DGrid | Reference points to align to, may contain background clutter. | ||
| inSampleCount | int | <1, INF> | 500 | Number of random samples used by the registration algorithm. Recommended values are from 200 to several thousands. Default value: 500. |
| inOverlap | float | <0.0f, 1.0f> | 0.8f | Defines the estimated overlap between two input grids (0 = no overlap, 1.0 = every point in inPoints is also in inReferencePoints). Default value: 0.8f. |
| inDeltaCorrection | float | <0.0f, INF> | 9.3f | Defines the accuracy of the final alignment. With smaller delta the amount of allocated memory increases. Default value: 9.3f. |
| inTransformLimits3D | AvlNet.NullableRef<AvlNet.TransformLimits3D> | Limits the maximum rotation angles and translation along each axis, of the final transform. Default value: atl::NIL. | ||
| inMaxTranslationDistance | float? | <0.0f, INF> | Limits the length of the translation vector of the final transform. Default value: atl::NIL. | |
| inSeed | int? | Seed for a random generator used by the algorithm. Default value: atl::NIL. | ||
 | outAlignedPoints | AvlNet.Point3DGrid | The aligned input points. | ||
| outAlignment | AvlNet.Matrix | The transform that aligns best the input points to the reference points. | ||
| outDelta | float | Returns estimated value of the parameter delta. |
Errors
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. |
