You are here: Start » AVL.NET » Function Reference » Point3DGrid » Point3DGrid Fitting » AVL.GoldenTemplate3D
Compares points on the input with the golden object. Any significant differences are considered defects.
Namespace: | AvlNet |
---|---|
Assembly: | AVL.NET.dll |
Syntax
C++
C#
public static void GoldenTemplate3D ( AvlNet.Point3DGrid inObject, AvlNet.Point3DGrid inGoldenObject, float inMaxDistance, float inVoxelSize, int inNeighborCount, int inSampleCount, float inDeltaCorrection, NullableRef<AvlNet.TransformLimits3D> inTransformLimits3D, bool inRefineWithICP, float? inMaxTranslationDistance, float inOverlap, IList<AvlNet.Point3D> outMissing, IList<AvlNet.Point3D> outExcessive, AvlNet.Matrix outAlignment, AvlNet.Point3DGrid diagCleanedGoldenObject, AvlNet.Point3DGrid diagAlignedObject )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inObject | AvlNet.Point3DGrid | Input Point3DGrid. | |||
inGoldenObject | AvlNet.Point3DGrid | Point3DGrid with the golden object. | |||
inMaxDistance | float | <0.0f, INF> | Maximal allowed distance between corresponding vertices of the input and the golden object. | ||
inVoxelSize | float | <0.0f, INF> | 0.0f | Defines a voxel size used to subsample both grids. Default value: 0.0f. | |
inNeighborCount | int | <1, INF> | 15 | Defines number of neighbors used to compute average distances between vertices during noise removal. Default value: 15. | |
inSampleCount | int | <1, INF> | 10000 | Defines number of samples used by the registration algorithm. Default value: 10000. | |
inDeltaCorrection | float | <0.0f, INF> | 12.0f | Defines the accuracy of the alignment. With smaller delta the amount of allocated memory increases. Default value: 12.0f. | |
inTransformLimits3D | AvlNet.NullableRef<AvlNet.TransformLimits3D> | Limits the maximum rotation angles and translation along each axis, of the final transform. Default value: atl::NIL. | |||
inRefineWithICP | bool | False | Defines whether the alignment should be refined with ICP. Default value: False. | ||
inMaxTranslationDistance | float? | <0.0f, INF> | Limits the length of the translation vector of the final transform. Default value: atl::NIL. | ||
inOverlap | float | <0.0f, 1.0f> | 0.95f | Defines the estimated overlap between two input grids (0 = no overlap, 1.0 = every point in inObject is also in inGoldenObject). Default value: 0.95f. | |
outMissing | System.Collections.Generic.IList<AvlNet.Point3D> | Points from the golden object not present in the input object. | |||
outExcessive | System.Collections.Generic.IList<AvlNet.Point3D> | Points from the input object not present in the golden object. | |||
outAlignment | AvlNet.Matrix | The transform that aligns best the input object to the golden object. | |||
diagCleanedGoldenObject | AvlNet.Point3DGrid | Golden object after subsampling and noise removal. | |||
diagAlignedObject | AvlNet.Point3DGrid | Aligned and cleaned input object. |
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Grids are empty after noise removal in GoldenTemplate3D. |
DomainError | inNeighborCount is larger than the number of valid points in GoldenTemplate3D. |
DomainError | Input grid has no valid points in GoldenTemplate3D. |
DomainError | Input grid is empty in GoldenTemplate3D. |
DomainError | Parameter inDeltaCorrection in GoldenTemplate3D has to be greater than 0.0 |
DomainError | Parameter inVoxelSize in GoldenTemplate3D has to be greater than or equal to 0.0 |
DomainError | Pitch limits are out of range. Please use values between -180 and 180. |
DomainError | Pitch Max limit should be greater than the min limit. |
DomainError | Roll limits are out of range. Please use values between -180 and 180. |
DomainError | Roll Max limit should be greater than the min limit. |
DomainError | X Translation Max limit should be greater than the min limit. |
DomainError | Y Translation Max limit should be greater than the min limit. |
DomainError | Yaw limits are out of range. Please use values between -180 and 180. |
DomainError | Yaw Max limit should be greater than the min limit. |
DomainError | Z Translation Max limit should be greater than the min limit. |
Function Overrides
- GoldenTemplate3D(Point3DGrid, Point3DGrid, Single, Single, Int32, Int32, Single, Boolean, Single, IList<Point3D>, IList<Point3D>, Matrix)
- GoldenTemplate3D(Point3DGrid, Point3DGrid, Single, Single, Int32, Int32, Single, NullableRef<TransformLimits3D>, Boolean, Nullable<Single>, Single, IList<Point3D>, IList<Point3D>, Matrix)