Tie-points locator strategy. More...

#include <TiePointsLocatorStrategy.h>

Inheritance diagram for te::rp::TiePointsLocatorStrategy:

Classes
class	InterestPointT

class	MatchedInterestPointsT

Public Member Functions
virtual void	getDefaultSpecStrategyParams (std::unique_ptr< TiePointsLocatorStrategyParameters > &defaultSpecParamsPtr) const =0
	Returns a sub-sampled version of the given locator strategy specific input parameters. More...

const std::string &	getErrorMessage () const
	Return the current error message if there is any. More...

virtual void	getSubSampledSpecStrategyParams (const double subSampleOptimizationRescaleFactor, const TiePointsLocatorStrategyParameters &inputSpecParams, std::unique_ptr< TiePointsLocatorStrategyParameters > &subSampledSpecParamsPtr) const =0
	Returns a sub-sampled version of the given locator strategy specific input parameters. More...

virtual	~TiePointsLocatorStrategy ()

Protected Types
typedef te::rp::Matrix< double >	DoublesMatrix
	A matrix do store double values. More...

typedef te::rp::Matrix< float >	FloatsMatrix
	A matrix do store float values. More...

typedef std::list< InterestPointT >	InterestPointsListT

typedef std::multiset< InterestPointT >	InterestPointsSetT

typedef std::multiset< MatchedInterestPointsT >	MatchedInterestPointsSetT

typedef te::rp::Matrix< unsigned char >	UCharsMatrix
	A matrix do store unsigned char values. More...

Protected Member Functions
virtual unsigned int	getAutoMaxTiePointsNumber () const =0
	Returns a automatically calculated optimum maximum amount tie-points following the current parameters. More...

virtual bool	getMatchedInterestPoints (te::gm::GeometricTransformation const *const raster1ToRaster2TransfPtr, const double raster1ToRaster2TransfDMapError, MatchedInterestPointsSetT &matchedInterestPoints)=0
	Try to find matched interest points. More...

virtual bool	initialize (const te::rp::TiePointsLocatorInputParameters &inputParameters)=0
	Initialize the strategy. More...

virtual void	reset ()
	Clear all internal allocated resources and go back to the initial not-initialized state. More...

void	setErrorMessage (const std::string &newErrorMessage)
	Set the current error message. More...

	TiePointsLocatorStrategy ()

Static Protected Member Functions
static bool	checkForDuplicatedInterestPoints (const InterestPointsSetT &interestPoints, double &x, double &y)
	Check for duplicated interest points. More...

static void	createTifFromMatrix (const FloatsMatrix &rasterData, const InterestPointsSetT &interestPoints, const std::string &tifFileName)
	Moravec interest points locator. More...

static void	features2Tiff (const DoublesMatrix &features, const InterestPointsSetT &interestPoints, const std::string &fileNameBeginning)
	Save the generated features to tif files. More...

static bool	loadRasterData (te::rst::Raster const rasterPtr, const std::vector< unsigned int > &rasterBands, te::rst::Raster const maskRasterPtr, const unsigned int maskRasterBand, const unsigned int rasterTargetAreaLineStart, const unsigned int rasterTargetAreaColStart, const unsigned int rasterTargetAreaWidth, const unsigned int rasterTargetAreaHeight, const double desiredRescaleFactorX, const double desiredRescaleFactorY, const te::rst::Interpolator::Method rasterInterpMethod, const unsigned char maxMemPercentUsage, std::vector< boost::shared_ptr< FloatsMatrix > > &loadedRasterData, UCharsMatrix &loadedMaskRasterData, double &achievedRescaleFactorX, double &achievedRescaleFactorY)
	Load rasters data (normalized between 0 and 1). More...

template<typename BufferElementT >
static void	roolUpBuffer (BufferElementT **bufferPtr, const unsigned int &bufferLinesNumber)
	RoolUp a buffer of lines. More...

Private Member Functions
TiePointsLocatorStrategy &	operator= (const TiePointsLocatorStrategy &)

	TiePointsLocatorStrategy (const TiePointsLocatorStrategy &)

Private Attributes
std::string	m_errorMessage
	Current error message. More...

Friends
class	TiePointsLocator

Detailed Description

Tie-points locator strategy.

Definition at line 52 of file TiePointsLocatorStrategy.h.

Member Typedef Documentation

◆ DoublesMatrix

te::rp::TiePointsLocatorStrategy::DoublesMatrix

protected

A matrix do store double values.

Definition at line 99 of file TiePointsLocatorStrategy.h.

◆ FloatsMatrix

te::rp::TiePointsLocatorStrategy::FloatsMatrix

protected

A matrix do store float values.

Definition at line 93 of file TiePointsLocatorStrategy.h.

◆ InterestPointsListT

typedef std::list< InterestPointT > te::rp::TiePointsLocatorStrategy::InterestPointsListT

protected

Interest points list container type

Definition at line 156 of file TiePointsLocatorStrategy.h.

◆ InterestPointsSetT

typedef std::multiset< InterestPointT > te::rp::TiePointsLocatorStrategy::InterestPointsSetT

protected

Interest points set container type

Definition at line 152 of file TiePointsLocatorStrategy.h.

◆ MatchedInterestPointsSetT

typedef std::multiset< MatchedInterestPointsT > te::rp::TiePointsLocatorStrategy::MatchedInterestPointsSetT

protected

Matched interest points container type

Definition at line 199 of file TiePointsLocatorStrategy.h.

◆ UCharsMatrix

te::rp::TiePointsLocatorStrategy::UCharsMatrix

protected

A matrix do store unsigned char values.

Definition at line 105 of file TiePointsLocatorStrategy.h.

Constructor & Destructor Documentation

◆ ~TiePointsLocatorStrategy()

virtual te::rp::TiePointsLocatorStrategy::~TiePointsLocatorStrategy ( )

virtual

◆ TiePointsLocatorStrategy() [1/2]

te::rp::TiePointsLocatorStrategy::TiePointsLocatorStrategy ( )

protected

◆ TiePointsLocatorStrategy() [2/2]

te::rp::TiePointsLocatorStrategy::TiePointsLocatorStrategy ( const TiePointsLocatorStrategy & )

private

Member Function Documentation

◆ checkForDuplicatedInterestPoints()

static bool te::rp::TiePointsLocatorStrategy::checkForDuplicatedInterestPoints	(	const InterestPointsSetT &	interestPoints,
		double &	x,
		double &	y
	)

staticprotected

Check for duplicated interest points.

Parameters

x	The duplicated tie-points X coord.
y	The duplicated tie-points Y coord.

Returns: false if duplicated interest points were found.

◆ createTifFromMatrix()

static void te::rp::TiePointsLocatorStrategy::createTifFromMatrix	(	const FloatsMatrix &	rasterData,
		const InterestPointsSetT &	interestPoints,
		const std::string &	tifFileName
	)

staticprotected

Moravec interest points locator.

Parameters

rasterData	The loaded raster data.
interestPoints	The found raster 1 interest points (coords related to rasterData lines/cols).
tifFileName	Tif file name.

◆ features2Tiff()

static void te::rp::TiePointsLocatorStrategy::features2Tiff	(	const DoublesMatrix &	features,
		const InterestPointsSetT &	interestPoints,
		const std::string &	fileNameBeginning
	)

staticprotected

Save the generated features to tif files.

Parameters

features	The features to be saved.
validInteresPoints	The interest pionts related to each feature inside the features matrix.
fileNameStart	The output file name beginning.

◆ getAutoMaxTiePointsNumber()

virtual unsigned int te::rp::TiePointsLocatorStrategy::getAutoMaxTiePointsNumber ( ) const

protectedpure virtual

Returns a automatically calculated optimum maximum amount tie-points following the current parameters.

Returns: Returns a automatically calculated optimum maximum amount tie-points following the current parameters.

Implemented in te::rp::TiePointsLocatorMoravecStrategy, and te::rp::TiePointsLocatorSURFStrategy.

◆ getDefaultSpecStrategyParams()

virtual void te::rp::TiePointsLocatorStrategy::getDefaultSpecStrategyParams ( std::unique_ptr< TiePointsLocatorStrategyParameters > & defaultSpecParamsPtr ) const

pure virtual

Returns a sub-sampled version of the given locator strategy specific input parameters.

Parameters

subSampleOptimizationRescaleFactor	Sub-sampled optimization tie-points search rescale factor.
inputSpecParams	Input parameters (sub-sample factor 1).
subSampledSpecParams	Sub-sampled parameters.

Implemented in te::rp::TiePointsLocatorMoravecStrategy, and te::rp::TiePointsLocatorSURFStrategy.

◆ getErrorMessage()

const std::string& te::rp::TiePointsLocatorStrategy::getErrorMessage ( ) const

Return the current error message if there is any.

Returns: Return the current error message if there is any.

◆ getMatchedInterestPoints()

virtual bool te::rp::TiePointsLocatorStrategy::getMatchedInterestPoints	(	te::gm::GeometricTransformation const *const	raster1ToRaster2TransfPtr,
		const double	raster1ToRaster2TransfDMapError,
		MatchedInterestPointsSetT &	matchedInterestPoints
	)

protectedpure virtual

Try to find matched interest points.

Parameters

matchedInterestPoints	The matched interest points.
raster1ToRaster2TransfPtr	A pointer to a transformation (estimation) direct mapping raster 1 indexed coords into raster 2 indexed coords, of an empty pointer if there is no transformation avaliable.
raster1ToRaster2TransfDMapError	The expected transformation error.

Returns: true if OK, false on errors.

Implemented in te::rp::TiePointsLocatorMoravecStrategy, and te::rp::TiePointsLocatorSURFStrategy.

◆ getSubSampledSpecStrategyParams()

virtual void te::rp::TiePointsLocatorStrategy::getSubSampledSpecStrategyParams	(	const double	subSampleOptimizationRescaleFactor,
		const TiePointsLocatorStrategyParameters &	inputSpecParams,
		std::unique_ptr< TiePointsLocatorStrategyParameters > &	subSampledSpecParamsPtr
	)		const

pure virtual

Returns a sub-sampled version of the given locator strategy specific input parameters.

Parameters

subSampleOptimizationRescaleFactor	Sub-sampled optimization tie-points search rescale factor.
inputSpecParams	Input parameters (sub-sample factor 1).
subSampledSpecParamsPtr	Sub-sampled parameters.

Implemented in te::rp::TiePointsLocatorMoravecStrategy, and te::rp::TiePointsLocatorSURFStrategy.

◆ initialize()

virtual bool te::rp::TiePointsLocatorStrategy::initialize ( const te::rp::TiePointsLocatorInputParameters & inputParameters )

protectedpure virtual

Initialize the strategy.

Parameters

inputParameters Input parameters.

Returns: true if OK, false on errors.

Implemented in te::rp::TiePointsLocatorMoravecStrategy, and te::rp::TiePointsLocatorSURFStrategy.

◆ loadRasterData()

static bool te::rp::TiePointsLocatorStrategy::loadRasterData	(	te::rst::Raster const *	rasterPtr,
		const std::vector< unsigned int > &	rasterBands,
		te::rst::Raster const *	maskRasterPtr,
		const unsigned int	maskRasterBand,
		const unsigned int	rasterTargetAreaLineStart,
		const unsigned int	rasterTargetAreaColStart,
		const unsigned int	rasterTargetAreaWidth,
		const unsigned int	rasterTargetAreaHeight,
		const double	desiredRescaleFactorX,
		const double	desiredRescaleFactorY,
		const te::rst::Interpolator::Method	rasterInterpMethod,
		const unsigned char	maxMemPercentUsage,
		std::vector< boost::shared_ptr< FloatsMatrix > > &	loadedRasterData,
		UCharsMatrix &	loadedMaskRasterData,
		double &	achievedRescaleFactorX,
		double &	achievedRescaleFactorY
	)

staticprotected

Load rasters data (normalized between 0 and 1).

Parameters

rasterPtr	Input raster pointer.
rasterBands	Input raster bands.
maskRasterPtr	The related input mask raster pointer (or zero, if no mask raster is avaliable).
maskRasterBand	The input mask raster band to use.
rasterTargetAreaLineStart	The raster target area initial line.
rasterTargetAreaColStart	The raster target area initial column.
rasterTargetAreaWidth	The raster target area width.
rasterTargetAreaHeight	The raster target area height.
desiredRescaleFactorX	The desired Scale factor to be applied on the loaded data.
desiredRescaleFactorY	The desired Scale factor to be applied on the loaded data.
rasterInterpMethod	The interpolation used when loading the input raster.
maxMemPercentUsage	The maximum amount (percent) of memory to use for the loaded data [0,100].
loadedRasterData	The loaded raster data.
loadedMaskRasterData	The loaded mask raster data.
desiredRescaleFactorX	The real achieved Scale factor.
desiredRescaleFactorY	The real achieved Scale factor.

Returns: true if ok, false on errors.

◆ operator=()

TiePointsLocatorStrategy& te::rp::TiePointsLocatorStrategy::operator= ( const TiePointsLocatorStrategy & )

private

◆ reset()

virtual void te::rp::TiePointsLocatorStrategy::reset ( )

protectedvirtual

Clear all internal allocated resources and go back to the initial not-initialized state.

Reimplemented in te::rp::TiePointsLocatorMoravecStrategy, and te::rp::TiePointsLocatorSURFStrategy.

◆ roolUpBuffer()

template<typename BufferElementT >

static void te::rp::TiePointsLocatorStrategy::roolUpBuffer	(	BufferElementT **	bufferPtr,
		const unsigned int &	bufferLinesNumber
	)

inlinestaticprotected

RoolUp a buffer of lines.

Parameters

bufferPtr	Buffer pointer.
bufferLinesNumber	Buffer lines number.

Definition at line 297 of file TiePointsLocatorStrategy.h.

◆ setErrorMessage()

void te::rp::TiePointsLocatorStrategy::setErrorMessage ( const std::string & newErrorMessage )

protected

Set the current error message.

Parameters

newErrorMessage New error message;

Friends And Related Function Documentation

◆ TiePointsLocator

friend class TiePointsLocator

friend

Definition at line 54 of file TiePointsLocatorStrategy.h.

Member Data Documentation

◆ m_errorMessage

std::string te::rp::TiePointsLocatorStrategy::m_errorMessage

private

Current error message.

Definition at line 365 of file TiePointsLocatorStrategy.h.

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

/home/castejon/castejon_files/develop/terralib5/git_master/src/terralib/rp/TiePointsLocatorStrategy.h

Classes

Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ DoublesMatrix

◆ FloatsMatrix

◆ InterestPointsListT

◆ InterestPointsSetT

◆ MatchedInterestPointsSetT

◆ UCharsMatrix

Constructor & Destructor Documentation

◆ ~TiePointsLocatorStrategy()

◆ TiePointsLocatorStrategy() [1/2]

◆ TiePointsLocatorStrategy() [2/2]

Member Function Documentation

◆ checkForDuplicatedInterestPoints()

◆ createTifFromMatrix()

◆ features2Tiff()

◆ getAutoMaxTiePointsNumber()

◆ getDefaultSpecStrategyParams()

◆ getErrorMessage()

◆ getMatchedInterestPoints()

◆ getSubSampledSpecStrategyParams()

◆ initialize()

◆ loadRasterData()

◆ operator=()

◆ reset()

◆ roolUpBuffer()

◆ setErrorMessage()

Friends And Related Function Documentation

◆ TiePointsLocator

Member Data Documentation

◆ m_errorMessage