Tie-points locator Moravec strategy. More...

#include <TiePointsLocatorMoravecStrategy.h>

Inheritance diagram for te::rp::TiePointsLocatorMoravecStrategy:

Classes
class	ExecuteMatchingByCorrelationThreadEntryParams
	The parameters passed to the matchCorrelationEuclideanThreadEntry method. More...

class	MoravecLocatorThreadParams
	The parameters passed to the moravecLocatorThreadEntry method. More...

Public Member Functions
	~TiePointsLocatorMoravecStrategy ()

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
bool	executeMatchingByCorrelation (const FloatsMatrix &featuresSet1, const FloatsMatrix &featuresSet2, const InterestPointsSetT &interestPointsSet1, const InterestPointsSetT &interestPointsSet2, te::gm::GeometricTransformation const *const raster1ToRaster2TransfPtr, const double raster1ToRaster2TransfDMapError, MatchedInterestPointsSetT &matchedPoints) const
	Match each feature using correlation. More...

unsigned int	getAutoMaxTiePointsNumber () const
	Returns a automatically calculated optimum maximum amount tie-points following the current parameters. More...

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

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

bool	locateMoravecInterestPoints (const unsigned int maxInterestPoints, const FloatsMatrix &rasterData, UCharsMatrix const *maskRasterDataPtr, InterestPointsSetT &interestPoints) const
	Moravec interest points locator. More...

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

	TiePointsLocatorMoravecStrategy ()

Static Protected Member Functions
static bool	applyMeanFilter (const FloatsMatrix &inputData, FloatsMatrix &outputData, const unsigned int iterationsNumber)
	Mean Filter. More...

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	executeMatchingByCorrelationThreadEntry (ExecuteMatchingByCorrelationThreadEntryParams *paramsPtr)
	Correlation/Euclidean match thread entry. More...

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

static bool	generateCorrelationFeatures (const InterestPointsSetT &interestPoints, const unsigned int correlationWindowWidth, const FloatsMatrix &rasterData, FloatsMatrix &features, InterestPointsSetT &validInteresPoints)
	Generate correlation features ( normalized - unit vector ) matrix for the given interes points. 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...

static void	locateMoravecInterestPointsThreadEntry (MoravecLocatorThreadParams *paramsPtr)
	Movavec locator thread entry. More...

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

Protected Attributes
te::rp::TiePointsLocatorInputParameters	m_inputParameters
	Input parameters. More...

bool	m_isInitialized
	true if this instance is initialized. More...

Friends
class	TiePointsLocator

Detailed Description

Tie-points locator Moravec strategy.

Definition at line 46 of file TiePointsLocatorMoravecStrategy.h.

Member Typedef Documentation

te::rp::TiePointsLocatorStrategy::DoublesMatrix

protectedinherited

A matrix do store double values.

Definition at line 71 of file TiePointsLocatorStrategy.h.

te::rp::TiePointsLocatorStrategy::FloatsMatrix

protectedinherited

A matrix do store float values.

Definition at line 65 of file TiePointsLocatorStrategy.h.

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

protectedinherited

Interest points list container type

Definition at line 128 of file TiePointsLocatorStrategy.h.

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

protectedinherited

Interest points set container type

Definition at line 124 of file TiePointsLocatorStrategy.h.

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

protectedinherited

Matched interest points container type

Definition at line 171 of file TiePointsLocatorStrategy.h.

te::rp::TiePointsLocatorStrategy::UCharsMatrix

protectedinherited

A matrix do store unsigned char values.

Definition at line 77 of file TiePointsLocatorStrategy.h.

Constructor & Destructor Documentation

te::rp::TiePointsLocatorMoravecStrategy::~TiePointsLocatorMoravecStrategy ( )

Definition at line 40 of file TiePointsLocatorMoravecStrategy.cpp.

References reset().

te::rp::TiePointsLocatorMoravecStrategy::TiePointsLocatorMoravecStrategy ( )

protected

Definition at line 35 of file TiePointsLocatorMoravecStrategy.cpp.

References reset().

Member Function Documentation

bool te::rp::TiePointsLocatorMoravecStrategy::applyMeanFilter	(	const FloatsMatrix &	inputData,
		FloatsMatrix &	outputData,
		const unsigned int	iterationsNumber
	)

staticprotected

Mean Filter.

Parameters

inputData	The input data.
outputData	The output data.
iterationsNumber	The number of filter iterations.

Returns: true if ok, false on errors.

Definition at line 676 of file TiePointsLocatorMoravecStrategy.cpp.

References te::rp::Matrix< TemplateElementType >::AutoMemPol, te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rp::Matrix< TemplateElementType >::reset(), and TERP_TRUE_OR_RETURN_FALSE.

Referenced by getMatchedInterestPoints().

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

staticprotectedinherited

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.

Definition at line 363 of file TiePointsLocatorStrategy.cpp.

Referenced by te::rp::TiePointsLocatorSURFStrategy::locateSurfInterestPointsThreadEntry().

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

staticprotectedinherited

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.

Definition at line 222 of file TiePointsLocatorStrategy.cpp.

References te::rst::BlueCInt, te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rst::GreenCInt, te::sa::Grid, te::rst::RasterFactory::make(), te::rst::RedCInt, TERP_TRUE_OR_THROW, and te::dt::UCHAR_TYPE.

bool te::rp::TiePointsLocatorMoravecStrategy::executeMatchingByCorrelation	(	const FloatsMatrix &	featuresSet1,
		const FloatsMatrix &	featuresSet2,
		const InterestPointsSetT &	interestPointsSet1,
		const InterestPointsSetT &	interestPointsSet2,
		te::gm::GeometricTransformation const *const	raster1ToRaster2TransfPtr,
		const double	raster1ToRaster2TransfDMapError,
		MatchedInterestPointsSetT &	matchedPoints
	)		const

protected

Match each feature using correlation.

Parameters

featuresSet1	Features set 1.
featuresSet2	Features set 2.
interestPointsSet1	The interest pionts set 1 (full raster 1 indexed coods reference).
interestPointsSet2	The interest pionts set 2 (full raster 1 indexed coods reference).
raster1ToRaster2TransfPtr	A pointer to a transformation 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.
matchedPoints	The matched points (full raster 1 indexed coods reference).

Note: Each matched point feature value ( MatchedInterestPoint::m_feature ) will be set to the absolute value of the correlation between then.

Definition at line 1504 of file TiePointsLocatorMoravecStrategy.cpp.

References executeMatchingByCorrelationThreadEntry(), te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rp::Matrix< TemplateElementType >::getMemPolicy(), te::common::GetPhysProcNumber(), te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_corrMatrixPtr, te::rp::TiePointsLocatorInputParameters::m_enableMultiThread, te::rp::TiePointsLocatorStrategy::MatchedInterestPointsT::m_feature, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_featuresSet1Ptr, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_featuresSet2Ptr, m_inputParameters, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_interestPointsSet1Ptr, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_interestPointsSet2Ptr, te::rp::TiePointsLocatorInputParameters::m_moravecMinAbsCorrelation, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_nextFeatureIdx1ToProcessPtr, te::rp::TiePointsLocatorStrategy::MatchedInterestPointsT::m_point1, te::rp::TiePointsLocatorStrategy::MatchedInterestPointsT::m_point2, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_raster1ToRaster2TransfPtr, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_searchOptTreeSearchRadius, te::rp::TiePointsLocatorMoravecStrategy::ExecuteMatchingByCorrelationThreadEntryParams::m_syncMutexPtr, te::rp::Matrix< TemplateElementType >::RAMMemPol, te::rp::Matrix< TemplateElementType >::reset(), and TERP_TRUE_OR_RETURN_FALSE.

Referenced by getMatchedInterestPoints().

void te::rp::TiePointsLocatorMoravecStrategy::executeMatchingByCorrelationThreadEntry ( ExecuteMatchingByCorrelationThreadEntryParams * paramsPtr )

staticprotected

Correlation/Euclidean match thread entry.

Parameters

paramsPtr A pointer to the thread parameters.

Definition at line 1667 of file TiePointsLocatorMoravecStrategy.cpp.

Referenced by executeMatchingByCorrelation().

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

staticprotectedinherited

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.

Definition at line 298 of file TiePointsLocatorStrategy.cpp.

References te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::sa::Grid, te::rst::RasterFactory::make(), MAX, MIN, te::rst::RedCInt, TERP_TRUE_OR_THROW, and te::dt::UCHAR_TYPE.

bool te::rp::TiePointsLocatorMoravecStrategy::generateCorrelationFeatures	(	const InterestPointsSetT &	interestPoints,
		const unsigned int	correlationWindowWidth,
		const FloatsMatrix &	rasterData,
		FloatsMatrix &	features,
		InterestPointsSetT &	validInteresPoints
	)

staticprotected

Generate correlation features ( normalized - unit vector ) matrix for the given interes points.

Parameters

interestPoints	The interest points (coords related to rasterData lines/cols).
correlationWindowWidth	The correlation window width used to correlate points between the images.
rasterData	The loaded raster data.
features	The generated features matrix (one feature per line, one feature per interes point).
validInteresPoints	The valid interest pionts related to each feature inside the features matrix (some interest points may be invalid and are removed).

Returns: true if ok, false on errors.

Definition at line 1232 of file TiePointsLocatorMoravecStrategy.cpp.

References te::rp::Matrix< TemplateElementType >::getColumnsNumber(), te::rp::Matrix< TemplateElementType >::getLinesNumber(), te::rp::Matrix< TemplateElementType >::reset(), ROUND, and TERP_TRUE_OR_RETURN_FALSE.

Referenced by getMatchedInterestPoints().

unsigned int te::rp::TiePointsLocatorMoravecStrategy::getAutoMaxTiePointsNumber ( ) const

protectedvirtual

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.

Implements te::rp::TiePointsLocatorStrategy.

Definition at line 598 of file TiePointsLocatorMoravecStrategy.cpp.

References te::common::GetTotalPhysicalMemory(), te::common::GetTotalVirtualMemory(), te::common::GetUsedVirtualMemory(), m_inputParameters, m_isInitialized, te::rp::TiePointsLocatorInputParameters::m_moravecCorrelationWindowWidth, te::rp::TiePointsLocatorInputParameters::m_raster1TargetAreaHeight, te::rp::TiePointsLocatorInputParameters::m_raster1TargetAreaWidth, te::rp::TiePointsLocatorInputParameters::m_raster2TargetAreaHeight, te::rp::TiePointsLocatorInputParameters::m_raster2TargetAreaWidth, te::rp::TiePointsLocatorInputParameters::m_subSampleOptimizationRescaleFactor, and TERP_TRUE_OR_THROW.

Referenced by initialize().

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

protectedvirtual

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.

Implements te::rp::TiePointsLocatorStrategy.

Definition at line 89 of file TiePointsLocatorMoravecStrategy.cpp.

bool te::rp::TiePointsLocatorMoravecStrategy::initialize ( const te::rp::TiePointsLocatorInputParameters & inputParameters )

protectedvirtual

Initialize the strategy.

Parameters

inputParameters Input parameters.

Returns: true if OK, false on errors.

Implements te::rp::TiePointsLocatorStrategy.

Definition at line 45 of file TiePointsLocatorMoravecStrategy.cpp.

References getAutoMaxTiePointsNumber(), m_inputParameters, te::rp::TiePointsLocatorInputParameters::m_inRaster1Bands, te::rp::TiePointsLocatorInputParameters::m_inRaster2Bands, m_isInitialized, te::rp::TiePointsLocatorInputParameters::m_maxTiePoints, te::rp::TiePointsLocatorInputParameters::m_moravecCorrelationWindowWidth, te::rp::TiePointsLocatorInputParameters::m_moravecMinAbsCorrelation, te::rp::TiePointsLocatorInputParameters::m_moravecWindowWidth, and TERP_TRUE_OR_RETURN_FALSE.

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
	)

staticprotectedinherited

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.

Definition at line 54 of file TiePointsLocatorStrategy.cpp.

References te::rp::Matrix< TemplateElementType >::AutoMemPol, te::rp::Matrix< double >::AutoMemPol, te::rst::Raster::getBand(), te::rst::Interpolator::getValue(), te::rst::Band::getValue(), MAX, te::rp::Matrix< TemplateElementType >::reset(), te::rp::TiePointsLocatorStrategy::reset(), and TERP_TRUE_OR_RETURN_FALSE.

Referenced by getMatchedInterestPoints(), and te::rp::TiePointsLocatorSURFStrategy::getMatchedInterestPoints().

bool te::rp::TiePointsLocatorMoravecStrategy::locateMoravecInterestPoints	(	const unsigned int	maxInterestPoints,
		const FloatsMatrix &	rasterData,
		UCharsMatrix const *	maskRasterDataPtr,
		InterestPointsSetT &	interestPoints
	)		const

protected

Moravec interest points locator.

Parameters

maxInterestPoints	The maximum number of interest points to find.
rasterData	The loaded raster data.
maskRasterDataPtr	The loaded mask raster data pointer (or zero if no mask is avaliable).
interestPoints	The found interest points (coords related to rasterData lines/cols).

Note: InterestPointT::m_feature1 will be sum of differences between the Moravec filter response of each pixel and its neighborhoods (always a positive value).