Tie points locator. More...

#include <TiePointsLocator.h>

Inheritance diagram for te::rp::TiePointsLocator:

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

class	ExecuteMatchingByEuclideanDistThreadEntryParams
	The parameters passed to the executeMatchingByEuclideanDistThreadEntry method. More...

class	InputParameters
	TiePointsLocator input parameters. More...

class	InterestPointT

class	MatchedInterestPointsT

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

class	OutputParameters
	TiePointsLocator output parameters. More...

class	SurfLocatorThreadParams
	The parameters passed to the surfLocatorThreadEntry method. More...

Public Member Functions
bool	execute (AlgorithmOutputParameters &outputParams) throw ( te::rp::Exception )
	Executes the algorithm using the supplied parameters. More...

bool	initialize (const AlgorithmInputParameters &inputParams) throw ( te::rp::Exception )
	Initialize the algorithm instance making it ready for execution. More...

bool	isInitialized () const
	Returns true if the algorithm instance is initialized and ready for execution. More...

void	reset () throw ( te::rp::Exception )
	Clear all internal allocated objects and reset the algorithm to its initial state. More...

	TiePointsLocator ()

	~TiePointsLocator ()

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	executeMoravec (const double raster1XRescFact, const double raster1YRescFact, const double raster2XRescFact, const double raster2YRescFact, te::common::TaskProgress progressPtr, TiePointsLocator::OutputParameters outParamsPtr, std::vector< double > &tiePointsWeights) throw ( te::rp::Exception )
	Executes the Moravec algorithm using the supplied parameters. More...

bool	executeSurf (const double raster1XRescFact, const double raster1YRescFact, const double raster2XRescFact, const double raster2YRescFact, te::common::TaskProgress progressPtr, TiePointsLocator::OutputParameters outParamsPtr, std::vector< double > &tiePointsWeights) throw ( te::rp::Exception )
	Executes the SURF algorithm using the supplied parameters. More...

bool	locateSurfInterestPoints (const FloatsMatrix &integralRasterData, UCharsMatrix const *maskRasterDataPtr, InterestPointsSetT &interestPoints) const
	SURF interest points locator. More...

Static Protected Member Functions
static bool	applyGaussianFilter (const DoublesMatrix &inputData, DoublesMatrix &outputData, const unsigned int iterationsNumber)
	Gaussian Filter. More...

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

static bool	createIntegralImage (const FloatsMatrix &inputData, FloatsMatrix &outputData)
	Create an integral image. More...

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

static bool	executeMatchingByCorrelation (const FloatsMatrix &featuresSet1, const FloatsMatrix &featuresSet2, const InterestPointsSetT &interestPointsSet1, const InterestPointsSetT &interestPointsSet2, const unsigned int maxPt1ToPt2PixelDistance, const unsigned int enableMultiThread, const double minAllowedAbsCorrelation, MatchedInterestPointsSetT &matchedPoints)
	Match each feature using correlation. More...

static void	executeMatchingByCorrelationThreadEntry (ExecuteMatchingByCorrelationThreadEntryParams *paramsPtr)
	Correlation/Euclidean match thread entry. More...

static bool	executeMatchingByEuclideanDist (const FloatsMatrix &featuresSet1, const FloatsMatrix &featuresSet2, const InterestPointsSetT &interestPointsSet1, const InterestPointsSetT &interestPointsSet2, const unsigned int maxPt1ToPt2PixelDistance, const double maxEuclideanDist, const unsigned int enableMultiThread, MatchedInterestPointsSetT &matchedPoints)
	Match each feature using eucliean distance. More...

static void	executeMatchingByEuclideanDistThreadEntry (ExecuteMatchingByEuclideanDistThreadEntryParams *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	generateSurfFeatures (const InterestPointsSetT &interestPoints, const FloatsMatrix &integralRasterData, InterestPointsSetT &validInterestPoints, FloatsMatrix &features)
	Generate a Surf features matrix for the given interes points. More...

template<typename BufferType >
static float	getHaarXVectorIntensity (BufferType &buffer, const unsigned int &centerX, const unsigned int &centerY, const unsigned int &radius)
	Return a Haar X intesity vector for the window centered at the given point. More...

template<typename BufferType >
static float	getHaarYVectorIntensity (BufferType &buffer, const unsigned int &centerX, const unsigned int &centerY, const unsigned int &radius)
	Return a Haar Y intesity vector for the window centered at the given point. More...

template<typename BufferType >
static float	getIntegralBoxSum (BufferType &buffer, const unsigned int &upperLeftX, const unsigned int &upperLeftY, const unsigned int &lowerRightX, const unsigned int &lowerRightY)
	Return a sum of all pixels inside a box over the given integral image buffer. More...

static float	getSurfDxxDerivative (float **bufferPtr, const unsigned int &centerX, const unsigned int &centerY, const unsigned int &lobeWidth, const unsigned int &lobeRadius)
	Return a SURF box filter Dyy derivative centered over the given position from the given integral image buffer. More...

static float	getSurfDxyDerivative (float **bufferPtr, const unsigned int &centerX, const unsigned int &centerY, const unsigned int &lobeWidth)
	Return a SURF box filter Dxy derivative centered over the given position from the given integral image buffer. More...

static float	getSurfDyyDerivative (float **bufferPtr, const unsigned int &centerX, const unsigned int &centerY, const unsigned int &lobeWidth, const unsigned int &lobeRadius)
	Return a SURF box filter Dxx derivative centered over the given position from the given integral image buffer. More...

static unsigned int	getSurfFilterSize (const unsigned int &octaveIndex, const unsigned int &scaleIndex)
	Return the surf octave filter size (width). More...

static unsigned int	getSurfOctaveBaseFilterSize (const unsigned int &octaveIndex)
	Return the surf octave base filter size (width). More...

static unsigned int	getSurfOctaveFilterStepSize (const unsigned int &octaveIndex)
	Return the surf octave filter step size (width). 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 rescaleFactorX, const double rescaleFactorY, const te::rst::Interpolator::Method rasterInterpMethod, const unsigned char maxMemPercentUsage, std::vector< boost::shared_ptr< FloatsMatrix > > &loadedRasterData, UCharsMatrix &loadedMaskRasterData)
	Load rasters data (normalized between 0 and 1). More...

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

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

static void	locateSurfInterestPointsThreadEntry (SurfLocatorThreadParams *paramsPtr)
	Surf locator thread entry. More...

static void	printBuffer (double **buffer, const unsigned int nLines, const unsigned int nCols)
	Print the given buffer to std::out. More...

template<typename ElementT >
static void	printMatrix (const te::rp::Matrix< ElementT > &matrix)
	Print the given matrix to std::out. More...

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

template<typename BufferElementT >
static void	zeroFillBuffer (BufferElementT **bufferPtr, const unsigned int &bufferLinesNumber, const unsigned int &bufferColsNumber)
	Fill a buffer with zeroes. More...

Protected Attributes
TiePointsLocator::InputParameters	m_inputParameters
	TiePointsLocator input execution parameters. More...

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

Detailed Description

Tie points locator.

Designed to find tie-points inside raster areas.

Definition at line 55 of file TiePointsLocator.h.

Member Typedef Documentation

te::rp::TiePointsLocator::DoublesMatrix

protected

A matrix do store double values.

Definition at line 235 of file TiePointsLocator.h.

te::rp::TiePointsLocator::FloatsMatrix

protected

A matrix do store float values.

Definition at line 229 of file TiePointsLocator.h.

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

protected

Interest points list container type

Definition at line 292 of file TiePointsLocator.h.

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

protected

Interest points set container type

Definition at line 288 of file TiePointsLocator.h.

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

protected

Matched interest points container type

Definition at line 335 of file TiePointsLocator.h.

te::rp::TiePointsLocator::UCharsMatrix

protected

A matrix do store unsigned char values.

Definition at line 241 of file TiePointsLocator.h.

Constructor & Destructor Documentation

te::rp::TiePointsLocator::TiePointsLocator ( )

Definition at line 201 of file TiePointsLocator.cpp.

References reset().

te::rp::TiePointsLocator::~TiePointsLocator ( )

Definition at line 206 of file TiePointsLocator.cpp.

Member Function Documentation

bool te::rp::TiePointsLocator::applyGaussianFilter	(	const DoublesMatrix &	inputData,
		DoublesMatrix &	outputData,
		const unsigned int	iterationsNumber
	)

staticprotected

Gaussian 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 2736 of file TiePointsLocator.cpp.

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

bool te::rp::TiePointsLocator::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 2823 of file TiePointsLocator.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 executeMoravec().

bool te::rp::TiePointsLocator::createIntegralImage	(	const FloatsMatrix &	inputData,
		FloatsMatrix &	outputData
	)

staticprotected

Create an integral image.

Parameters

inputData	The input data.
outputData	The output data.

Note: The entry of an integral image IΣ(x) at a location x = (x, y) represents the sum of all pixels in the input image I of a rectangular region formed by the point x and the origi.

Returns: true if ok, false on errors.

Definition at line 2942 of file TiePointsLocator.cpp.

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

Referenced by executeSurf().

void te::rp::TiePointsLocator::createTifFromMatrix	(	const DoublesMatrix &	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.

Definition at line 2660 of file TiePointsLocator.cpp.

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

bool te::rp::TiePointsLocator::execute	(	AlgorithmOutputParameters &	outputParams	)
throw	(	te::rp::Exception
	)

virtual

Executes the algorithm using the supplied parameters.

Parameters

outputParams Output parameters.

Returns: true if OK, false on errors.

Implements te::rp::Algorithm.

Definition at line 210 of file TiePointsLocator.cpp.

Referenced by te::rp::SequenceMosaic::execute(), te::rp::GeometricRefining::execute(), te::qt::widgets::TiePointsLocatorDialog::on_autoAcquireTiePointsPushButton_clicked(), and te::qt::widgets::TiePointLocatorWidget::onAutoAcquireTiePointsToolButtonClicked().

bool te::rp::TiePointsLocator::executeMatchingByCorrelation	(	const FloatsMatrix &	featuresSet1,
		const FloatsMatrix &	featuresSet2,
		const InterestPointsSetT &	interestPointsSet1,
		const InterestPointsSetT &	interestPointsSet2,
		const unsigned int	maxPt1ToPt2PixelDistance,
		const unsigned int	enableMultiThread,
		const double	minAllowedAbsCorrelation,
		MatchedInterestPointsSetT &	matchedPoints
	)

staticprotected

Match each feature using correlation.

Parameters

featuresSet1	Features set 1.
featuresSet2	Features set 2.
interestPointsSet1	The interest pionts set 1.
interestPointsSet2	The interest pionts set 2.
maxPt1ToPt2PixelDistance	Zero (disabled) or the maximum distance (pixels) between a point from set 1 to a point from set 1 (points beyond this distance will not be correlated and will have zero as correlation value).
enableMultiThread	Enable/disable the use of threads.
minAllowedAbsCorrelation	The minimum acceptable absolute correlation value when matching features (when applicable).
matchedPoints	The matched points.

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

Definition at line 3623 of file TiePointsLocator.cpp.

Referenced by executeMoravec().

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

staticprotected

Correlation/Euclidean match thread entry.

Parameters

paramsPtr A pointer to the thread parameters.

Definition at line 3787 of file TiePointsLocator.cpp.

Referenced by executeMatchingByCorrelation().

bool te::rp::TiePointsLocator::executeMatchingByEuclideanDist	(	const FloatsMatrix &	featuresSet1,
		const FloatsMatrix &	featuresSet2,
		const InterestPointsSetT &	interestPointsSet1,
		const InterestPointsSetT &	interestPointsSet2,
		const unsigned int	maxPt1ToPt2PixelDistance,
		const double	maxEuclideanDist,
		const unsigned int	enableMultiThread,
		MatchedInterestPointsSetT &	matchedPoints
	)

staticprotected

Match each feature using eucliean distance.

Parameters

featuresSet1	Features set 1.
featuresSet2	Features set 2.
interestPointsSet1	The interest pionts set 1.
interestPointsSet2	The interest pionts set 2.
maxPt1ToPt2PixelDistance	Zero (disabled) or the maximum distance (pixels) between a point from set 1 to a point from set 1 (points beyond this distance will not be correlated and will have zero as correlation value).
maxEuclideanDist	//!< The maximum acceptable euclidean distance when matching features.
enableMultiThread	Enable/disable the use of threads.
matchedPoints	The matched points.

Note: Each matched point feature value ( MatchedInterestPoint::m_feature ) will be set to the inverse normalized distance in the range (0,1].

Definition at line 3921 of file TiePointsLocator.cpp.

Referenced by executeSurf().

void te::rp::TiePointsLocator::executeMatchingByEuclideanDistThreadEntry ( ExecuteMatchingByEuclideanDistThreadEntryParams * paramsPtr )

staticprotected

Correlation/Euclidean match thread entry.

Parameters

paramsPtr A pointer to the thread parameters.

Definition at line 4089 of file TiePointsLocator.cpp.

Referenced by executeMatchingByEuclideanDist().

bool te::rp::TiePointsLocator::executeMoravec	(	const double	raster1XRescFact,
		const double	raster1YRescFact,
		const double	raster2XRescFact,
		const double	raster2YRescFact,
		te::common::TaskProgress *	progressPtr,
		TiePointsLocator::OutputParameters *	outParamsPtr,
		std::vector< double > &	tiePointsWeights
	)
throw	(	te::rp::Exception
	)

protected

Executes the Moravec algorithm using the supplied parameters.

Parameters

raster1XRescFact	The X axis rescale factor to be aplied into raster 1.
raster1YRescFact	The Y axis rescale factor to be aplied into raster 1.
raster2XRescFact	The X axis rescale factor to be aplied into raster 2.
raster2YRescFact	The Y axis rescale factor to be aplied into raster 2.
progressPtr	A pointer to the progress instance or a NULL pointer if it is not used.
raster1Data	The raster 1 loaded data.
maskRaster1Data	The mask raster 1 loaded data.
outParamsPtr	Output parameters pointer.
tiePointsWeights	Ouptut tie-points weights.

Returns: true if OK, false on errors.

Definition at line 367 of file TiePointsLocator.cpp.

Referenced by execute().

bool te::rp::TiePointsLocator::executeSurf	(	const double	raster1XRescFact,
		const double	raster1YRescFact,
		const double	raster2XRescFact,
		const double	raster2YRescFact,
		te::common::TaskProgress *	progressPtr,
		TiePointsLocator::OutputParameters *	outParamsPtr,
		std::vector< double > &	tiePointsWeights
	)
throw	(	te::rp::Exception
	)

protected

Executes the SURF algorithm using the supplied parameters.

Parameters

raster1XRescFact	The X axis rescale factor to be aplied into raster 1.
raster1YRescFact	The Y axis rescale factor to be aplied into raster 1.
raster2XRescFact	The X axis rescale factor to be aplied into raster 2.
raster2YRescFact	The Y axis rescale factor to be aplied into raster 2.
progressPtr	A pointer to the progress instance or a NULL pointer if it is not used.
raster1Data	The raster 1 loaded data.
maskRaster1Data	The mask raster 1 loaded data.
outParamsPtr	Output parameters pointer.
tiePointsWeights	Ouptut tie-points weights.

Returns: true if OK, false on errors.

Definition at line 744 of file TiePointsLocator.cpp.

Referenced by execute().

void te::rp::TiePointsLocator::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.

Definition at line 3559 of file TiePointsLocator.cpp.

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

bool te::rp::TiePointsLocator::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 2972 of file TiePointsLocator.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 executeMoravec().

bool te::rp::TiePointsLocator::generateSurfFeatures	(	const InterestPointsSetT &	interestPoints,
		const FloatsMatrix &	integralRasterData,
		InterestPointsSetT &	validInterestPoints,
		FloatsMatrix &	features
	)

staticprotected

Generate a Surf features matrix for the given interes points.

Parameters

interestPoints	The interest points (coords related to rasterData lines/cols).
integralRasterData	The integral raster data.
validInterestPoints	The valid interest points.
features	The generated features matrix (one feature per line, one feature per interest point).

Returns: true if ok, false on errors.

Definition at line 3244 of file TiePointsLocator.cpp.

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

Referenced by executeSurf().

template<typename BufferType >

static float te::rp::TiePointsLocator::getHaarXVectorIntensity	(	BufferType &	buffer,
		const unsigned int &	centerX,
		const unsigned int &	centerY,
		const unsigned int &	radius
	)

inlinestaticprotected

Return a Haar X intesity vector for the window centered at the given point.

Parameters

buffer	Integral image buffer.
centerX	Center X.
centerY	Center Y.
radius	Window radius.

Definition at line 1080 of file TiePointsLocator.h.

Referenced by generateSurfFeatures().

template<typename BufferType >

static float te::rp::TiePointsLocator::getHaarYVectorIntensity	(	BufferType &	buffer,
		const unsigned int &	centerX,
		const unsigned int &	centerY,
		const unsigned int &	radius
	)

inlinestaticprotected

Return a Haar Y intesity vector for the window centered at the given point.

Parameters

buffer	Integral image buffer.
centerX	Center X.
centerY	Center Y.
radius	Window radius.

Definition at line 1112 of file TiePointsLocator.h.

Referenced by generateSurfFeatures().

template<typename BufferType >

static float te::rp::TiePointsLocator::getIntegralBoxSum	(	BufferType &	buffer,
		const unsigned int &	upperLeftX,
		const unsigned int &	upperLeftY,
		const unsigned int &	lowerRightX,
		const unsigned int &	lowerRightY
	)

inlinestaticprotected

Return a sum of all pixels inside a box over the given integral image buffer.

Parameters

bufferPtr	Buffer pointer.
upperLeftX	Box upper left X.
upperLeftY	Box upper left Y.
lowerRightX	Box lower right X.
lowerRightY	Box lower right X.

Definition at line 943 of file TiePointsLocator.h.

static float te::rp::TiePointsLocator::getSurfDxxDerivative	(	float **	bufferPtr,
		const unsigned int &	centerX,
		const unsigned int &	centerY,
		const unsigned int &	lobeWidth,
		const unsigned int &	lobeRadius
	)

inlinestaticprotected

Return a SURF box filter Dyy derivative centered over the given position from the given integral image buffer.

Parameters

bufferPtr	Buffer pointer.
centerX	Center X.
centerY	Center Y.
lobeWidth	Filter lobe width.
lobeRadius	Filter lobe radius.

Definition at line 999 of file TiePointsLocator.h.

Referenced by locateSurfInterestPointsThreadEntry().

static float te::rp::TiePointsLocator::getSurfDxyDerivative	(	float **	bufferPtr,
		const unsigned int &	centerX,
		const unsigned int &	centerY,
		const unsigned int &	lobeWidth
	)

inlinestaticprotected

Return a SURF box filter Dxy derivative centered over the given position from the given integral image buffer.

Parameters

bufferPtr	Buffer pointer.
centerX	Center X.
centerY	Center Y.
lobeWidth	Filter lobe width.

Definition at line 1030 of file TiePointsLocator.h.

Referenced by locateSurfInterestPointsThreadEntry().

static float te::rp::TiePointsLocator::getSurfDyyDerivative	(	float **	bufferPtr,
		const unsigned int &	centerX,
		const unsigned int &	centerY,
		const unsigned int &	lobeWidth,
		const unsigned int &	lobeRadius
	)

inlinestaticprotected

Return a SURF box filter Dxx derivative centered over the given position from the given integral image buffer.

Parameters

bufferPtr	Buffer pointer.
centerX	Center X.
centerY	Center Y.
lobeWidth	Filter lobe width.
lobeRadius	Filter lobe radius.

Definition at line 966 of file TiePointsLocator.h.

Referenced by locateSurfInterestPointsThreadEntry().

static unsigned int te::rp::TiePointsLocator::getSurfFilterSize	(	const unsigned int &	octaveIndex,
		const unsigned int &	scaleIndex
	)

inlinestaticprotected

Return the surf octave filter size (width).

Parameters

octaveIndex	Octave index (starting from zero).
scaleIndex	Scale index (starting from zero).

Definition at line 1159 of file TiePointsLocator.h.

Referenced by initialize(), locateSurfInterestPoints(), and locateSurfInterestPointsThreadEntry().

static unsigned int te::rp::TiePointsLocator::getSurfOctaveBaseFilterSize ( const unsigned int & octaveIndex )

inlinestaticprotected

Return the surf octave base filter size (width).

Parameters

octaveIndex Octave index (starting from zero).

Definition at line 1147 of file TiePointsLocator.h.

static unsigned int te::rp::TiePointsLocator::getSurfOctaveFilterStepSize ( const unsigned int & octaveIndex )

inlinestaticprotected

Return the surf octave filter step size (width).

Parameters

octaveIndex Octave index (starting from zero).

Definition at line 1137 of file TiePointsLocator.h.

bool te::rp::TiePointsLocator::initialize	(	const AlgorithmInputParameters &	inputParams	)
throw	(	te::rp::Exception
	)

virtual

Initialize the algorithm instance making it ready for execution.

Parameters

inputParams Input parameters.

Returns: true if OK, false on errors.

Note: A return error string can be obtained via te::rp::Module::getLastLogStr()

Implements te::rp::Algorithm.

Definition at line 1112 of file TiePointsLocator.cpp.

Referenced by te::rp::SequenceMosaic::execute(), te::rp::GeometricRefining::execute(), te::qt::widgets::TiePointsLocatorDialog::on_autoAcquireTiePointsPushButton_clicked(), and te::qt::widgets::TiePointLocatorWidget::onAutoAcquireTiePointsToolButtonClicked().

bool te::rp::TiePointsLocator::isInitialized ( ) const

virtual

Returns true if the algorithm instance is initialized and ready for execution.

Returns: true if the algorithm instance is initialized and ready for execution.

Implements te::rp::Algorithm.

Definition at line 1439 of file TiePointsLocator.cpp.

References m_isInitialized.

bool te::rp::TiePointsLocator::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	rescaleFactorX,
		const double	rescaleFactorY,
		const te::rst::Interpolator::Method	rasterInterpMethod,
		const unsigned char	maxMemPercentUsage,
		std::vector< boost::shared_ptr< FloatsMatrix > > &	loadedRasterData,
		UCharsMatrix &	loadedMaskRasterData
	)

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.
rescaleFactorX	Scale factor to be applied on the loaded data.
rescaleFactorY	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.

Returns: true if ok, false on errors.

Definition at line 1444 of file TiePointsLocator.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(), reset(), and TERP_TRUE_OR_RETURN_FALSE.

Referenced by executeMoravec(), and executeSurf().

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

staticprotected

Moravec interest points locator.

Parameters

rasterData	The loaded raster data.
maskRasterDataPtr	The loaded mask raster data pointer (or zero if no mask is avaliable).
moravecWindowWidth	Moravec window width.
maxInterestPoints	The maximum number of interest points to find over raster 1.
enableMultiThread	Enable/disable multi-thread.
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).

Returns: true if ok, false on errors.

Definition at line 1607 of file TiePointsLocator.cpp.

Referenced by executeMoravec().

void te::rp::TiePointsLocator::locateMoravecInterestPointsThreadEntry ( MoravecLocatorThreadParams * paramsPtr )

staticprotected

Movavec locator thread entry.

Parameters

paramsPtr A pointer to the thread parameters.

Definition at line 1676 of file TiePointsLocator.cpp.

Referenced by locateMoravecInterestPoints().

bool te::rp::TiePointsLocator::locateSurfInterestPoints	(	const FloatsMatrix &	integralRasterData,
		UCharsMatrix const *	maskRasterDataPtr,
		InterestPointsSetT &	interestPoints
	)		const

protected

SURF interest points locator.

Parameters

integralRasterData	Integral image 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).

Returns: true if ok, false on errors.

Note: InterestPointT::m_feature1 will be sum of differences between the hessian matrix determinant each pixel and its neighborhoods (always a positive value).; InterestPointT::m_feature2 will be used filter width (pixels).; InterestPointT::m_feature3 will 1 if the laplacian sign is positive, or zero if negative.

Definition at line 2001 of file TiePointsLocator.cpp.

Referenced by executeSurf().

void te::rp::TiePointsLocator::locateSurfInterestPointsThreadEntry ( SurfLocatorThreadParams * paramsPtr )

staticprotected

Surf locator thread entry.

Parameters

paramsPtr A pointer to the thread parameters.

Definition at line 2071 of file TiePointsLocator.cpp.

Referenced by locateSurfInterestPoints().

void te::rp::TiePointsLocator::printBuffer	(	double **	buffer,
		const unsigned int	nLines,
		const unsigned int	nCols
	)

staticprotected

Print the given buffer to std::out.

Parameters

buffer	Buffer pointer.
nLines	Number of lines.
nCols	Number of columns.

Definition at line 4209 of file TiePointsLocator.cpp.

template<typename ElementT >

static void te::rp::TiePointsLocator::printMatrix ( const te::rp::Matrix< ElementT > & matrix )

inlinestaticprotected

Print the given matrix to std::out.

Parameters

matrix The given matrix.

Definition at line 897 of file TiePointsLocator.h.

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

void te::rp::TiePointsLocator::reset	(		)
throw	(	te::rp::Exception
	)

virtual

Clear all internal allocated objects and reset the algorithm to its initial state.

Implements te::rp::Algorithm.

Definition at line 1106 of file TiePointsLocator.cpp.

References m_inputParameters, m_isInitialized, and te::rp::TiePointsLocator::InputParameters::reset().

Referenced by initialize(), te::rp::TiePointsLocator::InputParameters::InputParameters(), loadRasterData(), te::rp::TiePointsLocator::InputParameters::operator=(), te::rp::TiePointsLocator::OutputParameters::operator=(), te::rp::TiePointsLocator::OutputParameters::OutputParameters(), TiePointsLocator(), te::rp::TiePointsLocator::InputParameters::~InputParameters(), and te::rp::TiePointsLocator::OutputParameters::~OutputParameters().

template<typename BufferElementT >

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

inlinestaticprotected

RoolUp a buffer of lines.

Parameters

bufferPtr	Buffer pointer.
bufferLinesNumber	Buffer lines number.

Definition at line 652 of file TiePointsLocator.h.

Referenced by locateMoravecInterestPointsThreadEntry(), and locateSurfInterestPointsThreadEntry().

template<typename BufferElementT >

static void te::rp::TiePointsLocator::zeroFillBuffer	(	BufferElementT **	bufferPtr,
		const unsigned int &	bufferLinesNumber,
		const unsigned int &	bufferColsNumber
	)

inlinestaticprotected

Fill a buffer with zeroes.

Parameters

bufferPtr	Buffer pointer.
bufferLinesNumber	Buffer lines number.
bufferColsNumber	Buffer columns number.

Definition at line 680 of file TiePointsLocator.h.

Member Data Documentation

TiePointsLocator::InputParameters te::rp::TiePointsLocator::m_inputParameters

protected

TiePointsLocator input execution parameters.

Definition at line 460 of file TiePointsLocator.h.

Referenced by execute(), executeMoravec(), executeSurf(), initialize(), locateSurfInterestPoints(), and reset().

bool te::rp::TiePointsLocator::m_isInitialized

protected

Tells if this instance is initialized.

Definition at line 463 of file TiePointsLocator.h.

Referenced by execute(), initialize(), isInitialized(), and reset().

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

C:/BB_TL5/terralib5/src/terralib/rp/TiePointsLocator.h
C:/BB_TL5/terralib5/src/terralib/rp/TiePointsLocator.cpp

Classes

Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation