| TerraLib 4.1

- Main Page
- Related Pages
- Modules
- Namespaces
- Classes
- Files
- Examples

- Class List
- Class Index
- Class Hierarchy
- Class Members

Classes | Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions
TeGeometricTransformation Class Reference
Geometric transformation.

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:

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 TeGTParams & | getParameters () 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 TeGeometricTransformation * | DefaultObject (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

TeSharedPtr< TeGeometricTransformation > TeGeometricTransformation::pointer

Type definition for a TeGeometricTransformation instance pointer.

## 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:

  params | Transformation 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:

  pt1 | pt1 coordinate.
  pt2 | pt2 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:

  params | Transformation parameters.
  pt1 | pt1 coordinate.
  pt2 | pt2 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_point | The 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:

  params | Transformation 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_point | The tie-point.
  params | Transformation 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:

  params | Transformation 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:

  params | Transformation 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_point | The tie-point.
  params | Transformation 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:

  params | Transformation 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_point | The 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:

  params | The 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:

  params | Transformation parameters.
  pt2 | pt2 coordinate.
  pt1 | pt1 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:

  pt2 | pt2 coordinate.
  pt1 | pt1 coordinate.

virtual bool TeGeometricTransformation::isTransDefined | ( | const TeGTParams & | params | ) | const`[protected, pure virtual]`

Verifies if the supplied parameters already has a defined transformation.

Parameters:

  params | Transformation 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:

  newparams | The new parameters.

Returns:
  true if OK, false on errors.

The documentation for this class was generated from the following files:

- E:/Projetos_Primeiro_Semestre_2012/TerraView/terralib/src/terralib/kernel/TeGeometricTransformation.h
- E:/Projetos_Primeiro_Semestre_2012/TerraView/terralib/src/terralib/kernel/TeGeometricTransformation.cpp

All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines