eVision .NET API
Loading...
Searching...
No Matches
eVision.Easy3D.EFeaturesAligner Class Reference

Alignment class, used to calculate the best transformation between matching pairs of points. The object EFeaturesAligner contains a list of points called the 'Model points list'. The method EFeaturesAligner.Compute takes a second list of points as argument which is called the 'Measured points list' and produces a E3DTransformMatrix as result. More...

Inheritance diagram for eVision.Easy3D.EFeaturesAligner:
Collaboration diagram for eVision.Easy3D.EFeaturesAligner:

Public Member Functions

 EFeaturesAligner ()
 Creates a EFeaturesAligner object.
 EFeaturesAligner (eVision.Easy3D.EFeaturesAligner other)
 Copy constructor for EFeaturesAligner.
eVision.Easy3D.E3DTransformMatrix Compute (eVision.Easy3D.E3DPoint[] measuredPoints)
 Computes the best transformation matrix for a given Measured points list.
eVision.Easy3D.E3DTransformMatrix Compute (eVision.Easy3D.E3DPoint[] measuredPoints, eVision.Easy3D.EErrorStatistics errorStatistics)
 Computes the best transformation matrix for a given Measured points list.
void Load (string path)
 Loads the EFeaturesAligner object configuration. The given ESerializer must have been created for reading.
void Load (eVision.ESerializer serializer)
 Loads the EFeaturesAligner object configuration. The given ESerializer must have been created for reading.
void Save (string path)
 Saves the EFeaturesAligner object configuration. The given ESerializer must have been created for writing.
void Save (eVision.ESerializer serializer)
 Saves the EFeaturesAligner object configuration. The given ESerializer must have been created for writing.

Properties

eVision.Easy3D.E3DPoint[] ModelPoints [get, set]
 Sets/Gets the model points list. The model point list is a list of points that is used either as source or as destination of the transformation to calculate. The model points list should at least contain 3 unaligned points.
eVision.Easy3D.EAlignmentPolarity PolarityTransform [get, set]
 Sets/Gets the polarity of the transformation from EAlignmentPolarity.
eVision.Easy3D.EAlignmentType AlignmentType [get, set]
 EAlignmentType of the EFeaturesAligner. By default, alignment type is EAlignmentType.EAlignmentType_Ordered.
eVision.EFloatRange XAngleRange [get, set]
 Sets/Gets the range of allowed angles in Easy.AngleUnit between the x-axes of the model and measured referentials. This allows to filter out symmetries when the EFeaturesAligner.AlignmentType is EAlignmentType.EAlignmentType_Unordered.
eVision.EFloatRange YAngleRange [get, set]
 Sets/Gets the range of allowed angles in Easy.AngleUnit between the y-axes of the model and measured referentials. This allows to filter out symmetries when the EFeaturesAligner.AlignmentType is EAlignmentType.EAlignmentType_Unordered.
eVision.EFloatRange ZAngleRange [get, set]
 Sets/Gets the range of allowed angles in Easy.AngleUnit between the z-axes of the model and measured referentials. This allows to filter out symmetries when the EFeaturesAligner.AlignmentType is EAlignmentType.EAlignmentType_Unordered.

Detailed Description

Alignment class, used to calculate the best transformation between matching pairs of points. The object EFeaturesAligner contains a list of points called the 'Model points list'. The method EFeaturesAligner.Compute takes a second list of points as argument which is called the 'Measured points list' and produces a E3DTransformMatrix as result.

License(s): Easy3D

Constructor & Destructor Documentation

◆ EFeaturesAligner() [1/2]

eVision.Easy3D.EFeaturesAligner.EFeaturesAligner ( )

Creates a EFeaturesAligner object.

◆ EFeaturesAligner() [2/2]

eVision.Easy3D.EFeaturesAligner.EFeaturesAligner ( eVision.Easy3D.EFeaturesAligner other)

Copy constructor for EFeaturesAligner.

Parameters
otherReference to the object used for the initialization.

Member Function Documentation

◆ Compute() [1/2]

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.EFeaturesAligner.Compute ( eVision.Easy3D.E3DPoint[] measuredPoints)

Computes the best transformation matrix for a given Measured points list.

This will compute the best transformation for the alignment between the Measured points and the Model points.

Parameters
measuredPointsThe measured points list; the measured points list should at least contain 3 unaligned points.

◆ Compute() [2/2]

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.EFeaturesAligner.Compute ( eVision.Easy3D.E3DPoint[] measuredPoints,
eVision.Easy3D.EErrorStatistics errorStatistics )

Computes the best transformation matrix for a given Measured points list.

This will compute the best transformation for the alignment between the Measured points and the Model points.

Parameters
measuredPointsThe measured points list; the measured points list should at least contain 3 unaligned points.
errorStatisticsOptional parameter passed by reference. This object will contains the error statistics (deviation between model and aligned points).

◆ Load() [1/2]

void eVision.Easy3D.EFeaturesAligner.Load ( eVision.ESerializer serializer)

Loads the EFeaturesAligner object configuration. The given ESerializer must have been created for reading.

Parameters
serializerThe serializer.

◆ Load() [2/2]

void eVision.Easy3D.EFeaturesAligner.Load ( string path)

Loads the EFeaturesAligner object configuration. The given ESerializer must have been created for reading.

Parameters
pathThe file path.

◆ Save() [1/2]

void eVision.Easy3D.EFeaturesAligner.Save ( eVision.ESerializer serializer)

Saves the EFeaturesAligner object configuration. The given ESerializer must have been created for writing.

Parameters
serializerThe serializer.

◆ Save() [2/2]

void eVision.Easy3D.EFeaturesAligner.Save ( string path)

Saves the EFeaturesAligner object configuration. The given ESerializer must have been created for writing.

Parameters
pathThe file path.

Property Documentation

◆ AlignmentType

eVision.Easy3D.EAlignmentType eVision.Easy3D.EFeaturesAligner.AlignmentType
getset

◆ ModelPoints

eVision.Easy3D.E3DPoint [] eVision.Easy3D.EFeaturesAligner.ModelPoints
getset

Sets/Gets the model points list. The model point list is a list of points that is used either as source or as destination of the transformation to calculate. The model points list should at least contain 3 unaligned points.

◆ PolarityTransform

eVision.Easy3D.EAlignmentPolarity eVision.Easy3D.EFeaturesAligner.PolarityTransform
getset

Sets/Gets the polarity of the transformation from EAlignmentPolarity.

If polarity is EAlignmentPolarity.EAlignmentPolarity_ModelToMeasured, calculates the best transformation from the Model points list to the Measured points list (default).

If the polarity is EAlignmentPolarity.EAlignmentPolarity_MeasuredToModel, calculates the best transformation from the Measured points list to the Model points list.

◆ XAngleRange

eVision.EFloatRange eVision.Easy3D.EFeaturesAligner.XAngleRange
getset

Sets/Gets the range of allowed angles in Easy.AngleUnit between the x-axes of the model and measured referentials. This allows to filter out symmetries when the EFeaturesAligner.AlignmentType is EAlignmentType.EAlignmentType_Unordered.

By default, the range is [0°, 180°].

◆ YAngleRange

eVision.EFloatRange eVision.Easy3D.EFeaturesAligner.YAngleRange
getset

Sets/Gets the range of allowed angles in Easy.AngleUnit between the y-axes of the model and measured referentials. This allows to filter out symmetries when the EFeaturesAligner.AlignmentType is EAlignmentType.EAlignmentType_Unordered.

By default, the range is [0°, 180°].

◆ ZAngleRange

eVision.EFloatRange eVision.Easy3D.EFeaturesAligner.ZAngleRange
getset

Sets/Gets the range of allowed angles in Easy.AngleUnit between the z-axes of the model and measured referentials. This allows to filter out symmetries when the EFeaturesAligner.AlignmentType is EAlignmentType.EAlignmentType_Unordered.

By default, the range is [0°, 180°].