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

Alignment class, used to calculate the best transformation between matching pairs of points. More...

Public Member Functions

None __init__ (self)
 Creates a eVision.Easy3D.EFeaturesAligner object.
None __init__ (self, eVision.Easy3D.EFeaturesAligner other)
 Copy constructor for eVision.Easy3D.EFeaturesAligner.
eVision.Easy3D.E3DTransformMatrix Compute (self, list[eVision._eVision.Easy3D.E3DPoint] measuredPoints)
 Computes the best transformation matrix for a given Measured points list.
eVision.Easy3D.E3DTransformMatrix Compute (self, list[eVision._eVision.Easy3D.E3DPoint] measuredPoints, eVision.Easy3D.EErrorStatistics errorStatistics)
 Computes the best transformation matrix for a given Measured points list.
None Load (self, str path)
 Loads the eVision.Easy3D.EFeaturesAligner object configuration.
None Load (self, eVision.ESerializer|None serializer)
 Loads the eVision.Easy3D.EFeaturesAligner object configuration.
None Save (self, str path)
 Saves the eVision.Easy3D.EFeaturesAligner object configuration.
None Save (self, eVision.ESerializer|None serializer)
 Saves the eVision.Easy3D.EFeaturesAligner object configuration.
list[eVision._eVision.Easy3D.E3DPoint] ModelPoints (self)
 Sets/Gets the model points list.
 ModelPoints (self, list[eVision._eVision.Easy3D.E3DPoint] value)
 Sets/Gets the model points list.
eVision.Easy3D.EAlignmentPolarity PolarityTransform (self)
 Sets/Gets the polarity of the transformation from eVision.Easy3D.EAlignmentPolarity.
 PolarityTransform (self, eVision.Easy3D.EAlignmentPolarity value)
 Sets/Gets the polarity of the transformation from eVision.Easy3D.EAlignmentPolarity.
eVision.Easy3D.EAlignmentType AlignmentType (self)
 eVision.Easy3D.EAlignmentType of the eVision.Easy3D.EFeaturesAligner.
 AlignmentType (self, eVision.Easy3D.EAlignmentType value)
 eVision.Easy3D.EAlignmentType of the eVision.Easy3D.EFeaturesAligner.
eVision.EFloatRange XAngleRange (self)
 Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the x-axes of the model and measured referentials.
 XAngleRange (self, eVision.EFloatRange value)
 Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the x-axes of the model and measured referentials.
eVision.EFloatRange YAngleRange (self)
 Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the y-axes of the model and measured referentials.
 YAngleRange (self, eVision.EFloatRange value)
 Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the y-axes of the model and measured referentials.
eVision.EFloatRange ZAngleRange (self)
 Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the z-axes of the model and measured referentials.
 ZAngleRange (self, eVision.EFloatRange value)
 Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the z-axes of the model and measured referentials.

Detailed Description

Alignment class, used to calculate the best transformation between matching pairs of points.

The object eVision.Easy3D.EFeaturesAligner contains a list of points called the 'Model points list'. The method eVision.Easy3D.EFeaturesAligner.Compute takes a second list of points as argument which is called the 'Measured points list' and produces a eVision.Easy3D.E3DTransformMatrix as result.

Remarks:

License(s): Easy3D

Constructor & Destructor Documentation

◆ __init__() [1/2]

None eVision.Easy3D.EFeaturesAligner.__init__ ( self)

◆ __init__() [2/2]

None eVision.Easy3D.EFeaturesAligner.__init__ ( self,
eVision.Easy3D.EFeaturesAligner other )

Copy constructor for eVision.Easy3D.EFeaturesAligner.

Parameters
otherReference to the object used for the initialization.

Member Function Documentation

◆ AlignmentType() [1/2]

eVision.Easy3D.EAlignmentType eVision.Easy3D.EFeaturesAligner.AlignmentType ( self)

◆ AlignmentType() [2/2]

eVision.Easy3D.EFeaturesAligner.AlignmentType ( self,
eVision.Easy3D.EAlignmentType value )

◆ Compute() [1/2]

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.EFeaturesAligner.Compute ( self,
list[eVision._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 ( self,
list[eVision._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]

None eVision.Easy3D.EFeaturesAligner.Load ( self,
eVision.ESerializer | None serializer )

Loads the eVision.Easy3D.EFeaturesAligner object configuration.

The given eVision.ESerializer must have been created for reading.

Parameters
serializerThe serializer.

◆ Load() [2/2]

None eVision.Easy3D.EFeaturesAligner.Load ( self,
str path )

Loads the eVision.Easy3D.EFeaturesAligner object configuration.

The given eVision.ESerializer must have been created for reading.

Parameters
pathThe file path.

◆ ModelPoints() [1/2]

list[eVision._eVision.Easy3D.E3DPoint] eVision.Easy3D.EFeaturesAligner.ModelPoints ( self)

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.

◆ ModelPoints() [2/2]

eVision.Easy3D.EFeaturesAligner.ModelPoints ( self,
list[eVision._eVision.Easy3D.E3DPoint] value )

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() [1/2]

eVision.Easy3D.EAlignmentPolarity eVision.Easy3D.EFeaturesAligner.PolarityTransform ( self)

Sets/Gets the polarity of the transformation from eVision.Easy3D.EAlignmentPolarity.

Remarks:

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

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

◆ PolarityTransform() [2/2]

eVision.Easy3D.EFeaturesAligner.PolarityTransform ( self,
eVision.Easy3D.EAlignmentPolarity value )

Sets/Gets the polarity of the transformation from eVision.Easy3D.EAlignmentPolarity.

Remarks:

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

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

◆ Save() [1/2]

None eVision.Easy3D.EFeaturesAligner.Save ( self,
eVision.ESerializer | None serializer )

Saves the eVision.Easy3D.EFeaturesAligner object configuration.

The given eVision.ESerializer must have been created for writing.

Parameters
serializerThe serializer.

◆ Save() [2/2]

None eVision.Easy3D.EFeaturesAligner.Save ( self,
str path )

Saves the eVision.Easy3D.EFeaturesAligner object configuration.

The given eVision.ESerializer must have been created for writing.

Parameters
pathThe file path.

◆ XAngleRange() [1/2]

eVision.EFloatRange eVision.Easy3D.EFeaturesAligner.XAngleRange ( self)

Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the x-axes of the model and measured referentials.

This allows to filter out symmetries when the eVision.Easy3D.EFeaturesAligner.AlignmentType is eVision.Easy3D.EAlignmentType.Unordered.

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

◆ XAngleRange() [2/2]

eVision.Easy3D.EFeaturesAligner.XAngleRange ( self,
eVision.EFloatRange value )

Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the x-axes of the model and measured referentials.

This allows to filter out symmetries when the eVision.Easy3D.EFeaturesAligner.AlignmentType is eVision.Easy3D.EAlignmentType.Unordered.

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

◆ YAngleRange() [1/2]

eVision.EFloatRange eVision.Easy3D.EFeaturesAligner.YAngleRange ( self)

Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the y-axes of the model and measured referentials.

This allows to filter out symmetries when the eVision.Easy3D.EFeaturesAligner.AlignmentType is eVision.Easy3D.EAlignmentType.Unordered.

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

◆ YAngleRange() [2/2]

eVision.Easy3D.EFeaturesAligner.YAngleRange ( self,
eVision.EFloatRange value )

Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the y-axes of the model and measured referentials.

This allows to filter out symmetries when the eVision.Easy3D.EFeaturesAligner.AlignmentType is eVision.Easy3D.EAlignmentType.Unordered.

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

◆ ZAngleRange() [1/2]

eVision.EFloatRange eVision.Easy3D.EFeaturesAligner.ZAngleRange ( self)

Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the z-axes of the model and measured referentials.

This allows to filter out symmetries when the eVision.Easy3D.EFeaturesAligner.AlignmentType is eVision.Easy3D.EAlignmentType.Unordered.

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

◆ ZAngleRange() [2/2]

eVision.Easy3D.EFeaturesAligner.ZAngleRange ( self,
eVision.EFloatRange value )

Sets/Gets the range of allowed angles in eVision.Easy.SetAngleUnit between the z-axes of the model and measured referentials.

This allows to filter out symmetries when the eVision.Easy3D.EFeaturesAligner.AlignmentType is eVision.Easy3D.EAlignmentType.Unordered.

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