TerraLib 4.1
TeGeometricTransformation Class Reference

This is the base class to deal with a geometric trasformation direct and inverse mapping the tie-points TeCoordPair::pt1 space into TeCoordPair::pt2 space. More...

#include <TeGeometricTransformation.h>

Inheritance diagram for TeGeometricTransformation:
Te2ndDegPolinomialGT TeAffineGT TeProjectiveGT

List of all members.

Classes

class  ExcTPDataNode
 Excluded tie-points data.
class  TPDataNode
 Tie-points data.

Public Types

typedef TeSharedPtr
< TeGeometricTransformation
pointer

Public Member Functions

virtual ~TeGeometricTransformation ()
 Default Destructor.
void directMap (const TeCoord2D &pt1, TeCoord2D &pt2) const
 Direct mapping ( from pt1 space into pt2 space ).
void inverseMap (const TeCoord2D &pt2, TeCoord2D &pt1) const
 Inverse mapping ( from pt2 space into pt1 space ).
bool reset (const TeGTParams &newparams)
 Reset the current transformation following the new supplied parameters.
void getParameters (TeGTParams &params) const
 Returns a copy of the current internal transformation parameters.
const TeGTParamsgetParameters () const
 Returns a reference of the current internal transformation parameters.
double getDirectMappingError () const
 Calculates the current transformation maximum direct mapping error ( from pt1 space into pt2 space ).
double getInverseMappingError () const
 Calculates the current transformation maximum inverse mapping error ( from pt2 space into pt1 space ).
double getDMapRMSE () const
 Calculates root mean square direct mapping error ( from pt1 space into pt2 space ).
double getIMapRMSE () const
 Calculates root mean square inverse mapping error ( from pt2 space into pt1 space ).
double getDirectMappingError (const TeCoordPair &tie_point) const
 Calculates the direct mapping error for the supplied tie-point ( from pt1 space into pt2 space ).
double getInverseMappingError (const TeCoordPair &tie_point) const
 Calculates the inverse mapping error for the supplied tie-point ( from pt2 space into pt1 space ).
virtual unsigned int getMinRequiredTiePoints () const =0
 Returns the minimum number of required tie-points for the current transformation.

Static Public Member Functions

static TeGeometricTransformationDefaultObject (const TeGTParams &)
 Returns a default object.

Protected Member Functions

virtual bool isTransDefined (const TeGTParams &params) const =0
 Verifies if the supplied parameters already has a defined transformation.
 TeGeometricTransformation ()
 Default Constructor.
virtual void directMap (const TeGTParams &params, const TeCoord2D &pt1, TeCoord2D &pt2) const =0
 Direct mapping ( from pt1 space into pt2 space ).
virtual void inverseMap (const TeGTParams &params, const TeCoord2D &pt2, TeCoord2D &pt1) const =0
 Inverse mapping ( from pt2 space into pt1 space ).
virtual bool computeParameters (TeGTParams &params) const =0
 Calculate the transformation parameters following the new supplied tie-points.
double getDirectMappingError (const TeGTParams &params) const
 Calculates maximum direct mapping error for the supplied parameters ( from pt1 space into pt2 space ).
double getInverseMappingError (const TeGTParams &params) const
 Calculates maximum inverse mapping error for the supplied parameters ( from pt2 space into pt1 space ).
double getDMapRMSE (const TeGTParams &params) const
 Calculates root mean square direct mapping error for the supplied parameters ( from pt1 space into pt2 space ).
double getIMapRMSE (const TeGTParams &params) const
 Calculates root mean square inverse mapping error for the supplied parameters ( from pt2 space into pt1 space ).
double getDirectMappingError (const TeCoordPair &tie_point, const TeGTParams &params) const
 Calculates the direct mapping error for the supplied tie-point. ( from pt1 space into pt2 space ).
double getInverseMappingError (const TeCoordPair &tie_point, const TeGTParams &params) const
 Calculates the inverse mapping error for the supplied tie-point. ( from pt2 space into pt1 space ).

Detailed Description

This is the base class to deal with a geometric trasformation direct and inverse mapping the tie-points TeCoordPair::pt1 space into TeCoordPair::pt2 space.

Author:
Emiliano F. Castejon <castejon@dpi.inpe.br>

Member Typedef Documentation


Constructor & Destructor Documentation

TeGeometricTransformation::~TeGeometricTransformation ( ) [virtual]

Default Destructor.

TeGeometricTransformation::TeGeometricTransformation ( ) [protected]

Default Constructor.


Member Function Documentation

virtual bool TeGeometricTransformation::computeParameters ( TeGTParams params) const [protected, pure virtual]

Calculate the transformation parameters following the new supplied tie-points.

Parameters:
paramsTransformation parameters.
Returns:
true if OK, false on errors.

Implemented in Te2ndDegPolinomialGT, TeAffineGT, and TeProjectiveGT.

TeGeometricTransformation * TeGeometricTransformation::DefaultObject ( const TeGTParams ) [static]

Returns a default object.

Returns:
A default object.
void TeGeometricTransformation::directMap ( const TeCoord2D pt1,
TeCoord2D pt2 
) const [inline]

Direct mapping ( from pt1 space into pt2 space ).

Parameters:
pt1pt1 coordinate.
pt2pt2 coordinate.
virtual void TeGeometricTransformation::directMap ( const TeGTParams params,
const TeCoord2D pt1,
TeCoord2D pt2 
) const [protected, pure virtual]

Direct mapping ( from pt1 space into pt2 space ).

Parameters:
paramsTransformation parameters.
pt1pt1 coordinate.
pt2pt2 coordinate.

Implemented in Te2ndDegPolinomialGT, TeAffineGT, and TeProjectiveGT.

double TeGeometricTransformation::getDirectMappingError ( const TeCoordPair tie_point) const [inline]

Calculates the direct mapping error for the supplied tie-point ( from pt1 space into pt2 space ).

Parameters:
tie_pointThe tie-point.
Returns:
The current direct mapping error.
double TeGeometricTransformation::getDirectMappingError ( const TeGTParams params) const [protected]

Calculates maximum direct mapping error for the supplied parameters ( from pt1 space into pt2 space ).

Parameters:
paramsTransformation parameters.
Returns:
The maximum direct mapping error for the supplied parameters.
double TeGeometricTransformation::getDirectMappingError ( const TeCoordPair tie_point,
const TeGTParams params 
) const [protected]

Calculates the direct mapping error for the supplied tie-point. ( from pt1 space into pt2 space ).

Parameters:
tie_pointThe tie-point.
paramsTransformation parameters.
Returns:
The current maximum direct mapping error.
double TeGeometricTransformation::getDirectMappingError ( ) const [inline]

Calculates the current transformation maximum direct mapping error ( from pt1 space into pt2 space ).

Returns:
The current maximum direct mapping error.
double TeGeometricTransformation::getDMapRMSE ( const TeGTParams params) const [protected]

Calculates root mean square direct mapping error for the supplied parameters ( from pt1 space into pt2 space ).

Parameters:
paramsTransformation parameters.
Returns:
The root mean square error.
double TeGeometricTransformation::getDMapRMSE ( ) const [inline]

Calculates root mean square direct mapping error ( from pt1 space into pt2 space ).

Returns:
The root mean square error.
double TeGeometricTransformation::getIMapRMSE ( const TeGTParams params) const [protected]

Calculates root mean square inverse mapping error for the supplied parameters ( from pt2 space into pt1 space ).

Parameters:
paramsTransformation parameters.
Returns:
The root mean square error.
double TeGeometricTransformation::getIMapRMSE ( ) const [inline]

Calculates root mean square inverse mapping error ( from pt2 space into pt1 space ).

Returns:
The root mean square error.
double TeGeometricTransformation::getInverseMappingError ( ) const [inline]

Calculates the current transformation maximum inverse mapping error ( from pt2 space into pt1 space ).

Returns:
The current maximum inverse mapping error.
double TeGeometricTransformation::getInverseMappingError ( const TeCoordPair tie_point,
const TeGTParams params 
) const [protected]

Calculates the inverse mapping error for the supplied tie-point. ( from pt2 space into pt1 space ).

Parameters:
tie_pointThe tie-point.
paramsTransformation parameters.
Returns:
The current maximum inverse mapping error.
double TeGeometricTransformation::getInverseMappingError ( const TeGTParams params) const [protected]

Calculates maximum inverse mapping error for the supplied parameters ( from pt2 space into pt1 space ).

Parameters:
paramsTransformation parameters.
Returns:
The maximum inverse mapping error for the supplied parameters.
double TeGeometricTransformation::getInverseMappingError ( const TeCoordPair tie_point) const [inline]

Calculates the inverse mapping error for the supplied tie-point ( from pt2 space into pt1 space ).

Parameters:
tie_pointThe tie-point.
Returns:
The current inverse mapping error.
virtual unsigned int TeGeometricTransformation::getMinRequiredTiePoints ( ) const [pure virtual]

Returns the minimum number of required tie-points for the current transformation.

Returns:
The minimum number of required tie-points for the current transformation.

Implemented in Te2ndDegPolinomialGT, TeAffineGT, and TeProjectiveGT.

void TeGeometricTransformation::getParameters ( TeGTParams params) const

Returns a copy of the current internal transformation parameters.

Parameters:
paramsThe internal parameters copy.
const TeGTParams & TeGeometricTransformation::getParameters ( ) const

Returns a reference of the current internal transformation parameters.

Returns:
A reference of the current internal transformation parameters..
virtual void TeGeometricTransformation::inverseMap ( const TeGTParams params,
const TeCoord2D pt2,
TeCoord2D pt1 
) const [protected, pure virtual]

Inverse mapping ( from pt2 space into pt1 space ).

Parameters:
paramsTransformation parameters.
pt2pt2 coordinate.
pt1pt1 coordinate.

Implemented in Te2ndDegPolinomialGT, TeAffineGT, and TeProjectiveGT.

void TeGeometricTransformation::inverseMap ( const TeCoord2D pt2,
TeCoord2D pt1 
) const [inline]

Inverse mapping ( from pt2 space into pt1 space ).

Parameters:
pt2pt2 coordinate.
pt1pt1 coordinate.
virtual bool TeGeometricTransformation::isTransDefined ( const TeGTParams params) const [protected, pure virtual]

Verifies if the supplied parameters already has a defined transformation.

Parameters:
paramsTransformation parameters.
Returns:
true if a transformation is already defined, false otherwise.

Implemented in Te2ndDegPolinomialGT, TeAffineGT, and TeProjectiveGT.

bool TeGeometricTransformation::reset ( const TeGTParams newparams)

Reset the current transformation following the new supplied parameters.

Parameters:
newparamsThe new parameters.
Returns:
true if OK, false on errors.

The documentation for this class was generated from the following files:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines