2D Affine Geometric transformation. More...

#include <AffineGT.h>

Inheritance diagram for te::gm::AffineGT:

Public Member Functions
	AffineGT ()
	Default constructor. More...

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

void	directMap (const Coord2D &pt1, Coord2D &pt2) 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 GTParameters &params, const double &pt1X, const double &pt1Y, double &pt2X, double &pt2Y) const
	Direct mapping (from pt1 space into pt2 space). More...

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

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

double	getDirectMapRMSE () const
	Calculates root mean square direct mapping error. 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 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	getInverseMappingError (const GTParameters::TiePoint &tiePoint) const
	Calculates the inverse mapping error for the supplied tie-point. More...

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

double	getInverseMapRMSE () const
	Calculates root mean square inverse mapping error. 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 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	getMaxDirectMappingError () const
	Calculates the current transformation maximum direct mapping error. More...

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

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

double	getMaxInverseMappingError (const GTParameters &params) const
	Calculates maximum inverse mapping error for the supplied parameters. 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 Coord2D &pt2, Coord2D &pt1) 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 GTParameters &params, const double &pt2X, const double &pt2Y, double &pt1X, double &pt1Y) const
	Inverse mapping (from pt2 space into pt1 space). More...

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

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

	~AffineGT ()
	Destructor. More...

Static Public Member Functions
static bool	decompose (const std::vector< double > &transfParams, double &translationX, double &translationY, double &scalingFactorX, double &scalingFactorY, double &skew, double &squeeze, double &scaling, double &rotation)
	Returns the basic set of transform parameters given by the decomposition of a given affine transformation parameters as described above. More...

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

Protected Attributes
boost::numeric::ublas::matrix< double >	m_computeParameters_A

boost::numeric::ublas::matrix< double >	m_computeParameters_At

unsigned int	m_computeParameters_index1

unsigned int	m_computeParameters_index2

boost::numeric::ublas::matrix< double >	m_computeParameters_L

boost::numeric::ublas::matrix< double >	m_computeParameters_N

boost::numeric::ublas::matrix< double >	m_computeParameters_N_inv

unsigned int	m_computeParameters_tiepointsSize

unsigned int	m_computeParameters_tpIdx

boost::numeric::ublas::matrix< double >	m_computeParameters_U

boost::numeric::ublas::matrix< double >	m_computeParameters_X

boost::numeric::ublas::matrix< double >	m_computeParameters_XExpanded

boost::numeric::ublas::matrix< double >	m_computeParameters_XExpandedInv

GTParameters	m_internalParameters
	The current internal parameters. More...

Detailed Description

2D Affine Geometric transformation.

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

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

Definition at line 66 of file AffineGT.h.

Constructor & Destructor Documentation

◆ AffineGT()

te::gm::AffineGT::AffineGT ( )

Default constructor.

◆ ~AffineGT()

te::gm::AffineGT::~AffineGT ( )

Destructor.

Member Function Documentation

◆ clone()

GeometricTransformation* te::gm::AffineGT::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.

◆ computeParameters()

bool te::gm::AffineGT::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.

◆ decompose()

static bool te::gm::AffineGT::decompose	(	const std::vector< double > &	transfParams,
		double &	translationX,
		double &	translationY,
		double &	scalingFactorX,
		double &	scalingFactorY,
		double &	skew,
		double &	squeeze,
		double &	scaling,
		double &	rotation
	)

static

Returns the basic set of transform parameters given by the decomposition of a given affine transformation parameters as described above.

Parameters

transfParams	Input affine transformation parameters.
translationX	X axis translation (combination of a squeeze and scaling).
translationY	Y axis translation (combination of a squeeze and scaling).
scalingFactorX	X axis scaling.
scalingFactorX	Y axis scaling.
skew	Skew.
squeeze	Aspect ratio changes.
scaling	Uniform scaling.
rotation	Rotation angle (radians).

Returns: true if ok, false on errors.

◆ directMap() [1/4]

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.

◆ directMap() [2/4]

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.

◆ directMap() [3/4]

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.

◆ directMap() [4/4]

void te::gm::AffineGT::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.

◆ getDirectMappingError() [1/2]

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.

◆ getDirectMappingError() [2/2]

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.

◆ getDirectMapRMSE() [1/4]

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.

◆ getDirectMapRMSE() [2/4]

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.

◆ getDirectMapRMSE() [3/4]

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.

◆ getDirectMapRMSE() [4/4]

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.

◆ getInverseMappingError() [1/2]

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.

◆ getInverseMappingError() [2/2]

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.

◆ getInverseMapRMSE() [1/4]

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.

◆ getInverseMapRMSE() [2/4]

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.

◆ getInverseMapRMSE() [3/4]

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.

◆ getInverseMapRMSE() [4/4]

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.

◆ getMaxDirectMappingError() [1/2]

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.

◆ getMaxDirectMappingError() [2/2]

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.

◆ getMaxInverseMappingError() [1/2]

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.

◆ getMaxInverseMappingError() [2/2]

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.

◆ getMinRequiredTiePoints()

unsigned int te::gm::AffineGT::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.

◆ getName()

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

virtual

Returns the current transformation name.

Returns: The current transformation name.

Implements te::gm::GeometricTransformation.

◆ getParameters()

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.

◆ initialize()

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.

◆ inverseMap() [1/4]

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.

◆ inverseMap() [2/4]

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.

◆ inverseMap() [3/4]

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.

◆ inverseMap() [4/4]

void te::gm::AffineGT::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.

◆ isValid() [1/2]

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.

◆ isValid() [2/2]

bool te::gm::AffineGT::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.

Member Data Documentation

◆ m_computeParameters_A

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_A

mutableprotected

Definition at line 124 of file AffineGT.h.

◆ m_computeParameters_At

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_At

mutableprotected

Definition at line 125 of file AffineGT.h.

◆ m_computeParameters_index1

unsigned int te::gm::AffineGT::m_computeParameters_index1

mutableprotected

Definition at line 120 of file AffineGT.h.

◆ m_computeParameters_index2

unsigned int te::gm::AffineGT::m_computeParameters_index2

mutableprotected

Definition at line 121 of file AffineGT.h.

◆ m_computeParameters_L

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_L

mutableprotected

Definition at line 123 of file AffineGT.h.

◆ m_computeParameters_N

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_N

mutableprotected

Definition at line 126 of file AffineGT.h.

◆ m_computeParameters_N_inv

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_N_inv

mutableprotected

Definition at line 128 of file AffineGT.h.

◆ m_computeParameters_tiepointsSize

unsigned int te::gm::AffineGT::m_computeParameters_tiepointsSize

mutableprotected

Definition at line 119 of file AffineGT.h.

◆ m_computeParameters_tpIdx

unsigned int te::gm::AffineGT::m_computeParameters_tpIdx

mutableprotected

Definition at line 122 of file AffineGT.h.

◆ m_computeParameters_U

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_U

mutableprotected

Definition at line 127 of file AffineGT.h.

◆ m_computeParameters_X

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_X

mutableprotected

Definition at line 129 of file AffineGT.h.

◆ m_computeParameters_XExpanded

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_XExpanded

mutableprotected

Definition at line 130 of file AffineGT.h.

◆ m_computeParameters_XExpandedInv

boost::numeric::ublas::matrix< double > te::gm::AffineGT::m_computeParameters_XExpandedInv

mutableprotected

Definition at line 131 of file AffineGT.h.

◆ m_internalParameters

GTParameters te::gm::GeometricTransformation::m_internalParameters

protectedinherited

The current internal parameters.

Definition at line 432 of file GeometricTransformation.h.

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

/home/castejon/castejon_files/develop/terralib5/git_release/src/terralib/geometry/AffineGT.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ AffineGT()

◆ ~AffineGT()

Member Function Documentation

◆ clone()

◆ computeParameters()

◆ decompose()

◆ directMap() [1/4]

◆ directMap() [2/4]

◆ directMap() [3/4]

◆ directMap() [4/4]

◆ getDirectMappingError() [1/2]

◆ getDirectMappingError() [2/2]

◆ getDirectMapRMSE() [1/4]

◆ getDirectMapRMSE() [2/4]

◆ getDirectMapRMSE() [3/4]

◆ getDirectMapRMSE() [4/4]

◆ getInverseMappingError() [1/2]

◆ getInverseMappingError() [2/2]

◆ getInverseMapRMSE() [1/4]

◆ getInverseMapRMSE() [2/4]

◆ getInverseMapRMSE() [3/4]

◆ getInverseMapRMSE() [4/4]

◆ getMaxDirectMappingError() [1/2]

◆ getMaxDirectMappingError() [2/2]

◆ getMaxInverseMappingError() [1/2]

◆ getMaxInverseMappingError() [2/2]

◆ getMinRequiredTiePoints()

◆ getName()

◆ getParameters()

◆ initialize()

◆ inverseMap() [1/4]

◆ inverseMap() [2/4]

◆ inverseMap() [3/4]

◆ inverseMap() [4/4]

◆ isValid() [1/2]

◆ isValid() [2/2]

Member Data Documentation

◆ m_computeParameters_A

◆ m_computeParameters_At

◆ m_computeParameters_index1

◆ m_computeParameters_index2

◆ m_computeParameters_L

◆ m_computeParameters_N

◆ m_computeParameters_N_inv

◆ m_computeParameters_tiepointsSize

◆ m_computeParameters_tpIdx

◆ m_computeParameters_U

◆ m_computeParameters_X

◆ m_computeParameters_XExpanded

◆ m_computeParameters_XExpandedInv

◆ m_internalParameters