You are here: Start » AVL.NET » Function Reference » Point3DGrid » Point3DGrid Fitting » AVL.GoldenTemplate3D

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
inObjectAvlNet.Point3DGridInput Point3DGrid.
inGoldenObjectAvlNet.Point3DGridPoint3DGrid with the golden object.
inMaxDistancefloat<0.0f, INF>Maximal allowed distance between corresponding vertices of the input and the golden object.
inVoxelSizefloat<0.0f, INF>0.0fDefines a voxel size used to subsample both grids. Default value: 0.0f.
inNeighborCountint<1, INF>15Defines number of neighbors used to compute average distances between vertices during noise removal. Default value: 15.
inSampleCountint<1, INF>10000Defines number of samples used by the registration algorithm. Default value: 10000.
inDeltaCorrectionfloat<0.0f, INF>12.0fDefines the accuracy of the alignment. With smaller delta the amount of allocated memory increases. Default value: 12.0f.
inTransformLimits3DAvlNet.NullableRef<AvlNet.TransformLimits3D>Limits the maximum rotation angles and translation along each axis, of the final transform. Default value: atl::NIL.
inRefineWithICPboolFalseDefines whether the alignment should be refined with ICP. Default value: False.
inMaxTranslationDistancefloat?<0.0f, INF>Limits the length of the translation vector of the final transform. Default value: atl::NIL.
inOverlapfloat<0.0f, 1.0f>0.95fDefines the estimated overlap between two input grids (0 = no overlap, 1.0 = every point in inObject is also in inGoldenObject). Default value: 0.95f.
outMissingSystem.Collections.Generic.IList<AvlNet.Point3D>Points from the golden object not present in the input object.
outExcessiveSystem.Collections.Generic.IList<AvlNet.Point3D>Points from the input object not present in the golden object.
outAlignmentAvlNet.MatrixThe transform that aligns best the input object to the golden object.
diagCleanedGoldenObjectAvlNet.Point3DGridGolden object after subsampling and noise removal.
diagAlignedObjectAvlNet.Point3DGridAligned 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

See also