2D Projective Geometric transformation. More...

#include <ProjectiveGT.h>

Inheritance diagram for te::gm::ProjectiveGT:

Public Member Functions
GeometricTransformation *	clone () const
	Creat a clone copy of this instance. More...

void	directMap (const GTParameters &params, const double &pt1X, const double &pt1Y, double &pt2X, double &pt2Y) const
	Direct mapping (from pt1 space into pt2 space). More...

void	directMap (const double &pt1X, const double &pt1Y, double &pt2X, double &pt2Y) const
	Direct mapping ( from pt1 space into pt2 space ). More...

void	directMap (const GTParameters &params, const Coord2D &pt1, Coord2D &pt2) const
	Direct mapping (from pt1 space into pt2 space). More...

void	directMap (const Coord2D &pt1, Coord2D &pt2) const
	Direct mapping (from pt1 space into pt2 space). More...

double	getDirectMappingError (const GTParameters::TiePoint &tiePoint, const GTParameters &params) const
	Calculates the direct mapping error for the supplied tie-point. More...

double	getDirectMappingError (const GTParameters::TiePoint &tiePoint) const
	Calculates the direct mapping error for the supplied tie-point. More...

double	getDirectMapRMSE (const std::vector< GTParameters::TiePoint > &tiePoints, const GTParameters &params) const
	Calculates root mean square direct mapping error for the supplied tie-points using the supplied parameters. More...

double	getDirectMapRMSE (const GTParameters &params) const
	Calculates root mean square direct mapping error for the supplied parameters. More...

double	getDirectMapRMSE (const std::vector< GTParameters::TiePoint > &tiePoints) const
	Calculates root mean square direct mapping error for the supplied tie-points. More...

double	getDirectMapRMSE () const
	Calculates root mean square direct mapping error. More...

double	getInverseMappingError (const GTParameters::TiePoint &tiePoint, const GTParameters &params) const
	Calculates the inverse mapping error for the supplied tie-point. More...

double	getInverseMappingError (const GTParameters::TiePoint &tiePoint) const
	Calculates the inverse mapping error for the supplied tie-point. More...

double	getInverseMapRMSE (const std::vector< GTParameters::TiePoint > &tiePoints, const GTParameters &params) const
	Calculates root mean square inverse mapping error for the supplied tie-points using the supplied parameters. More...

double	getInverseMapRMSE (const GTParameters &params) const
	Calculates root mean square inverse mapping error for the supplied parameters. More...

double	getInverseMapRMSE (const std::vector< GTParameters::TiePoint > &tiePoints) const
	Calculates root mean square inverse mapping error for the supplied tie-points. More...

double	getInverseMapRMSE () const
	Calculates root mean square inverse mapping error. More...

double	getMaxDirectMappingError (const GTParameters &params) const
	Calculates maximum direct mapping error for the supplied parameters. More...

double	getMaxDirectMappingError () const
	Calculates the current transformation maximum direct mapping error. More...

double	getMaxInverseMappingError (const GTParameters &params) const
	Calculates maximum inverse mapping error for the supplied parameters. More...

double	getMaxInverseMappingError () const
	Calculates the current transformation maximum inverse mapping error. More...

unsigned int	getMinRequiredTiePoints () const
	Returns the minimum number of required tie-points for the current transformation. More...

const std::string &	getName () const
	Returns the current transformation name. More...

const GTParameters &	getParameters () const
	Returns a reference of the current internal transformation parameters. More...

bool	initialize (const GTParameters &newParameters)
	Initialize the current transformation following the new supplied parameters. More...

void	inverseMap (const GTParameters &params, const double &pt2X, const double &pt2Y, double &pt1X, double &pt1Y) const
	Inverse mapping (from pt2 space into pt1 space). More...

void	inverseMap (const double &pt2X, const double &pt2Y, double &pt1X, double &pt1Y) const
	Inverse mapping (from pt2 space into pt1 space). More...

void	inverseMap (const GTParameters &params, const Coord2D &pt2, Coord2D &pt1) const
	Inverse mapping ( from pt2 space into pt1 space ). More...

void	inverseMap (const Coord2D &pt2, Coord2D &pt1) const
	Inverse mapping (from pt2 space into pt1 space). More...

bool	isValid (const GTParameters &params) const
	Verifies if the supplied parameters already has a valid transformation. More...

bool	isValid () const
	Tells if the current instance has a valid transformation. More...

	ProjectiveGT ()
	Default constructor. More...

	~ProjectiveGT ()
	Destructor. More...

Protected Member Functions
bool	computeParameters (GTParameters &params) const
	Calculate the transformation parameters following the new supplied tie-points. More...

Protected Attributes
GTParameters	m_internalParameters
	The current internal parameters. More...

Detailed Description

2D Projective Geometric transformation.

Note: The transformation parameters (inside GTParameters::m_directParameters) are disposed on the following form:

| u |   | a b c | * | x |
| v | = | d e f |   | y |
| 1 |   | g h 1 |   | 1 |
u = a.x + b.y + c
    -------------------
    g.x + h.y + 1
v = d.x + e.y + f
    -------------------
    g.x + h.y + 1
|u0|   |x0   y0  1  0   0  0  -x0*u0 -y0*v0|.|a|
|v0|   |0    0   0 x0  y0  1  -x0*v0 -y0*v0| |b|
|u1|   |...................................| |c|
|v1| = |...................................| |d|
|..|   |...................................| |e|
|..|   |...................................| |f|
|..|   |...................................| |g|
|..|   |...................................| |h|
GTParameters::m_directParameters = [ a b c d e f g h ]

Definition at line 72 of file ProjectiveGT.h.

Constructor & Destructor Documentation

te::gm::ProjectiveGT::ProjectiveGT ( )

Default constructor.

Definition at line 36 of file ProjectiveGT.cpp.

te::gm::ProjectiveGT::~ProjectiveGT ( )

Destructor.

Definition at line 40 of file ProjectiveGT.cpp.

Member Function Documentation

te::gm::GeometricTransformation * te::gm::ProjectiveGT::clone ( ) const

virtual

Creat a clone copy of this instance.

Returns: A clone copy of this instance (the caller of this method must take the ownership of the returned object and delete it when appropriate.

Implements te::gm::GeometricTransformation.

Definition at line 121 of file ProjectiveGT.cpp.

References te::gm::GeometricTransformation::m_internalParameters.

bool te::gm::ProjectiveGT::computeParameters ( GTParameters & params ) const

protectedvirtual

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

Parameters

params Transformation parameters.

Returns: true if OK, false on errors.

Implements te::gm::GeometricTransformation.

Definition at line 128 of file ProjectiveGT.cpp.

References te::common::getInverseMatrix(), te::gm::GTParameters::m_directParameters, te::gm::GTParameters::m_inverseParameters, te::gm::GTParameters::m_tiePoints, te::gm::Coord2D::x, and te::gm::Coord2D::y.

void te::gm::ProjectiveGT::directMap	(	const GTParameters &	params,
		const double &	pt1X,
		const double &	pt1Y,
		double &	pt2X,
		double &	pt2Y
	)		const

virtual

Direct mapping (from pt1 space into pt2 space).

Parameters

params	Transformation parameters.
pt1X	pt1 X coordinate.
pt1Y	pt1 Y coordinate.
pt2X	pt2 X coordinate.
pt2Y	pt2 Y coordinate.

Implements te::gm::GeometricTransformation.

Definition at line 56 of file ProjectiveGT.cpp.

References te::gm::GTParameters::m_directParameters.

void te::gm::GeometricTransformation::directMap	(	const double &	pt1X,
		const double &	pt1Y,
		double &	pt2X,
		double &	pt2Y
	)		const

inlineinherited

Direct mapping ( from pt1 space into pt2 space ).

Parameters

pt1X	pt1 X coordinate.
pt1Y	pt1 Y coordinate.
pt2X	pt2 X coordinate.
pt2Y	pt2 Y coordinate.

Definition at line 133 of file GeometricTransformation.h.

void te::gm::GeometricTransformation::directMap	(	const GTParameters &	params,
		const Coord2D &	pt1,
		Coord2D &	pt2
	)		const

inlineinherited

Direct mapping (from pt1 space into pt2 space).

Parameters

params	Transformation parameters.
pt1	pt1 coordinate.
pt2	pt2 coordinate.

Definition at line 150 of file GeometricTransformation.h.

References te::gm::Coord2D::x, and te::gm::Coord2D::y.

void te::gm::GeometricTransformation::directMap	(	const Coord2D &	pt1,
		Coord2D &	pt2
	)		const

inlineinherited

Direct mapping (from pt1 space into pt2 space).

Parameters

pt1	pt1 coordinate.
pt2	pt2 coordinate.

Definition at line 161 of file GeometricTransformation.h.

References te::gm::Coord2D::x, and te::gm::Coord2D::y.

double te::gm::GeometricTransformation::getDirectMappingError	(	const GTParameters::TiePoint &	tiePoint,
		const GTParameters &	params
	)		const

inherited

Calculates the direct mapping error for the supplied tie-point.

Parameters

tiePoint	The tie-point.
params	Transformation parameters.

Returns: The current maximum direct mapping error.

Definition at line 167 of file GeometricTransformation.cpp.

References te::gm::Coord2D::x, and te::gm::Coord2D::y.

double te::gm::GeometricTransformation::getDirectMappingError ( const GTParameters::TiePoint & tiePoint ) const

inlineinherited

Calculates the direct mapping error for the supplied tie-point.

Parameters

tiePoint The tie-point.

Returns: The current direct mapping error.

Definition at line 374 of file GeometricTransformation.h.

double te::gm::GeometricTransformation::getDirectMapRMSE	(	const std::vector< GTParameters::TiePoint > &	tiePoints,
		const GTParameters &	params
	)		const

inherited

Calculates root mean square direct mapping error for the supplied tie-points using the supplied parameters.

Parameters

tiePoints	The tie-points.
params	Transformation parameters.

Returns: The root mean square error.

Definition at line 109 of file GeometricTransformation.cpp.

double te::gm::GeometricTransformation::getDirectMapRMSE ( const GTParameters & params ) const

inlineinherited

Calculates root mean square direct mapping error for the supplied parameters.

Parameters

params Transformation parameters.

Returns: The root mean square error.

Definition at line 283 of file GeometricTransformation.h.

References te::gm::GTParameters::m_tiePoints.

double te::gm::GeometricTransformation::getDirectMapRMSE ( const std::vector< GTParameters::TiePoint > & tiePoints ) const

inlineinherited

Calculates root mean square direct mapping error for the supplied tie-points.

Parameters

tiePoints The tie-points.

Returns: The root mean square error.

Definition at line 295 of file GeometricTransformation.h.

double te::gm::GeometricTransformation::getDirectMapRMSE ( ) const

inlineinherited

Calculates root mean square direct mapping error.

Returns: The root mean square error.

Definition at line 305 of file GeometricTransformation.h.

double te::gm::GeometricTransformation::getInverseMappingError	(	const GTParameters::TiePoint &	tiePoint,
		const GTParameters &	params
	)		const

inherited

Calculates the inverse mapping error for the supplied tie-point.

Parameters

tiePoint	The tie-point.
params	Transformation parameters.

Returns: The current maximum inverse mapping error.

Definition at line 181 of file GeometricTransformation.cpp.

References te::gm::Coord2D::x, and te::gm::Coord2D::y.

double te::gm::GeometricTransformation::getInverseMappingError ( const GTParameters::TiePoint & tiePoint ) const

inlineinherited

Calculates the inverse mapping error for the supplied tie-point.

Parameters

tiePoint The tie-point.

Returns: The current inverse mapping error.

Definition at line 397 of file GeometricTransformation.h.

double te::gm::GeometricTransformation::getInverseMapRMSE	(	const std::vector< GTParameters::TiePoint > &	tiePoints,
		const GTParameters &	params
	)		const

inherited

Calculates root mean square inverse mapping error for the supplied tie-points using the supplied parameters.

Parameters

tiePoints	The tie-points.
params	Transformation parameters.

Returns: The root mean square error.

Definition at line 138 of file GeometricTransformation.cpp.

double te::gm::GeometricTransformation::getInverseMapRMSE ( const GTParameters & params ) const

inlineinherited

Calculates root mean square inverse mapping error for the supplied parameters.

Parameters

params Transformation parameters.

Returns: The root mean square error.

Definition at line 329 of file GeometricTransformation.h.

References te::gm::GTParameters::m_tiePoints.

double te::gm::GeometricTransformation::getInverseMapRMSE ( const std::vector< GTParameters::TiePoint > & tiePoints ) const

inlineinherited

Calculates root mean square inverse mapping error for the supplied tie-points.

Parameters

tiePoints The tie-points.

Returns: The root mean square error.

Definition at line 341 of file GeometricTransformation.h.

double te::gm::GeometricTransformation::getInverseMapRMSE ( ) const

inlineinherited

Calculates root mean square inverse mapping error.

Returns: The root mean square error.

Definition at line 351 of file GeometricTransformation.h.

double te::gm::GeometricTransformation::getMaxDirectMappingError ( const GTParameters & params ) const

inherited

Calculates maximum direct mapping error for the supplied parameters.

Parameters

params Transformation parameters.

Returns: The maximum direct mapping error for the supplied parameters.

Definition at line 64 of file GeometricTransformation.cpp.

References te::gm::GTParameters::m_tiePoints.

double te::gm::GeometricTransformation::getMaxDirectMappingError ( ) const

inlineinherited

Calculates the current transformation maximum direct mapping error.

Returns: The current maximum direct mapping error.

Definition at line 240 of file GeometricTransformation.h.

double te::gm::GeometricTransformation::getMaxInverseMappingError ( const GTParameters & params ) const

inherited

Calculates maximum inverse mapping error for the supplied parameters.

Parameters

params Transformation parameters.

Returns: The maximum inverse mapping error for the supplied parameters.

Definition at line 86 of file GeometricTransformation.cpp.

References te::gm::GTParameters::m_tiePoints.

double te::gm::GeometricTransformation::getMaxInverseMappingError ( ) const

inlineinherited

Calculates the current transformation maximum inverse mapping error.

Returns: The current maximum inverse mapping error.

Definition at line 259 of file GeometricTransformation.h.

unsigned int te::gm::ProjectiveGT::getMinRequiredTiePoints ( ) const

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.

Implements te::gm::GeometricTransformation.

Definition at line 116 of file ProjectiveGT.cpp.

const std::string & te::gm::ProjectiveGT::getName ( ) const

virtual

Returns the current transformation name.

Returns: The current transformation name.

Implements te::gm::GeometricTransformation.

Definition at line 44 of file ProjectiveGT.cpp.

const GTParameters& te::gm::GeometricTransformation::getParameters ( ) const

inlineinherited

Returns a reference of the current internal transformation parameters.

Returns: A reference of the current internal transformation parameters.

Definition at line 105 of file GeometricTransformation.h.

bool te::gm::GeometricTransformation::initialize ( const GTParameters & newParameters )

inherited

Initialize the current transformation following the new supplied parameters.

Parameters

newparams The new parameters.

Returns: true if OK, false on errors.

Definition at line 36 of file GeometricTransformation.cpp.

References te::gm::GTParameters::reset().

void te::gm::ProjectiveGT::inverseMap	(	const GTParameters &	params,
		const double &	pt2X,
		const double &	pt2Y,
		double &	pt1X,
		double &	pt1Y
	)		const

virtual

Inverse mapping (from pt2 space into pt1 space).

Parameters

params	Transformation parameters.
pt1X	pt1 X coordinate.
pt1Y	pt1 Y coordinate.
pt2X	pt2 X coordinate.
pt2Y	pt2 Y coordinate.

Implements te::gm::GeometricTransformation.

Definition at line 86 of file ProjectiveGT.cpp.

References te::gm::GTParameters::m_inverseParameters.

void te::gm::GeometricTransformation::inverseMap	(	const double &	pt2X,
		const double &	pt2Y,
		double &	pt1X,
		double &	pt1Y
	)		const

inlineinherited

Inverse mapping (from pt2 space into pt1 space).

Parameters

pt1X	pt1 X coordinate.
pt1Y	pt1 Y coordinate.
pt2X	pt2 X coordinate.
pt2Y	pt2 Y coordinate.

Definition at line 191 of file GeometricTransformation.h.

void te::gm::GeometricTransformation::inverseMap	(	const GTParameters &	params,
		const Coord2D &	pt2,
		Coord2D &	pt1
	)		const

inlineinherited

Inverse mapping ( from pt2 space into pt1 space ).

Parameters

params	Transformation parameters.
pt2	pt2 coordinate.
pt1	pt1 coordinate.

Definition at line 208 of file GeometricTransformation.h.

References te::gm::Coord2D::x, and te::gm::Coord2D::y.

void te::gm::GeometricTransformation::inverseMap	(	const Coord2D &	pt2,
		Coord2D &	pt1
	)		const

inlineinherited

Inverse mapping (from pt2 space into pt1 space).

Parameters

pt2	pt2 coordinate.
pt1	pt1 coordinate.

Definition at line 219 of file GeometricTransformation.h.

References te::gm::Coord2D::x, and te::gm::Coord2D::y.

bool te::gm::ProjectiveGT::isValid ( const GTParameters & params ) const

virtual

Verifies if the supplied parameters already has a valid transformation.

Parameters

params Transformation parameters.

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

Implements te::gm::GeometricTransformation.

Definition at line 50 of file ProjectiveGT.cpp.

References te::gm::GTParameters::m_directParameters, and te::gm::GTParameters::m_inverseParameters.

bool te::gm::GeometricTransformation::isValid ( ) const

inlineinherited

Tells if the current instance has a valid transformation.

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

Definition at line 86 of file GeometricTransformation.h.

Member Data Documentation

GTParameters te::gm::GeometricTransformation::m_internalParameters

protectedinherited

The current internal parameters.

Definition at line 432 of file GeometricTransformation.h.

Referenced by te::gm::SecondDegreePolynomialGT::clone(), te::gm::ThirdDegreePolynomialGT::clone(), te::gm::RSTGT::clone(), te::gm::AffineGT::clone(), and clone().

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

/home/castejon/castejon_files/develop/terralib5/git/src/terralib/geometry/ProjectiveGT.h
/home/castejon/castejon_files/develop/terralib5/git/src/terralib/geometry/ProjectiveGT.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation