Performs arithmetic operation over raster data. More...

#include <ArithmeticOperations.h>

Inheritance diagram for te::rp::ArithmeticOperations:

Classes
class	ExecStackElement
	Execution stack element. More...

class	InputParameters
	ArithmeticOperations input parameters. More...

class	OutputParameters
	ArithmeticOperations output parameters. More...

Public Member Functions
	ArithmeticOperations ()

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...

	~ArithmeticOperations ()

Protected Types
typedef void(ArithmeticOperations::*	BinOpFuncPtrT) (const double &inputValue1, const double &inputValue2, double &outputValue) const
	Type definition for a operation function pointer. More...

typedef std::stack< ExecStackElement >	ExecStackT
	Execution stack type definition. More...

Protected Member Functions
void	additionBinOp (const double &inputValue1, const double &inputValue2, double &outputValue) const
	Addition binary operator function. More...

bool	allocResultRaster (const te::rst::Grid &grid, std::auto_ptr< te::rst::Raster > &rasterPtr) const
	Allocate a new RAM memory raster. More...

void	divisionBinOp (const double &inputValue1, const double &inputValue2, double &outputValue) const
	Division binary operator function. More...

bool	execBinaryOperator (const std::string &token, ExecStackT &execStack, bool generateOutput) const
	Execute the given binary operator using the current given execution stack. More...

bool	execBinaryOperatorRasterXRaster (const te::rst::Raster &inRaster1, const unsigned int band1, const te::rst::Raster &inRaster2, const unsigned int band2, const BinOpFuncPtrT binOptFunctPtr, std::auto_ptr< te::rst::Raster > &outRasterPtr) const
	Execute the given binary operator using the given input rasters. More...

bool	execBinaryOperatorRasterXReal (const te::rst::Raster &inRaster, const unsigned int bandIdx, const double value, const BinOpFuncPtrT binOptFunctPtr, std::auto_ptr< te::rst::Raster > &outRasterPtr, const bool realNumberIsRigthtTerm) const
	Execute the given binary operator using the given input raster and a real number. More...

bool	execUnaryOperator (const std::string &token, ExecStackT &execStack, bool generateOutput) const
	Execute the given unary operator using the current given execution stack. More...

bool	executeString (const std::string &aStr, const std::vector< te::rst::Raster * > &inRasters, std::auto_ptr< te::rst::Raster > &outRaster, bool generateOutput, te::common::TaskProgress *const progressPtr) const
	Execute the automata parsing the given input string. More...

void	getTokensStrs (const std::string &inputStr, std::vector< std::string > &outTokens) const
	Split the input string into a vector of token strings. More...

void	inFix2PostFix (const std::vector< std::string > &input, std::vector< std::string > &output) const
	Convert the input tokens vector from the infix notation to postfix notation. More...

bool	isBinaryOperator (const std::string &inputToken) const
	Returns true if the given token is a binary operator. More...

bool	isOperator (const std::string &inputToken) const
	Returns true if the given token is an operator. More...

bool	isRasterBandToken (const std::string &token, unsigned int &rasterIdx, unsigned int &bandIdx) const
	Returns true if the given token is a raster data token. More...

bool	isRealNumberToken (const std::string &token, double &realValue) const
	Returns true if the given token is a real number. More...

bool	isUnaryOperator (const std::string &inputToken) const
	Returns true if the given token is a unary operator. More...

void	multiplicationBinOp (const double &inputValue1, const double &inputValue2, double &outputValue) const
	Multiplication binary operator function. More...

bool	op1HasGreaterOrEqualPrecedence (const std::string &operator1, const std::string &operator2) const
	Returns true if operator1 has greater of equal precedence over operator2. More...

void	printTokens (const std::vector< std::string > &input) const
	Print tokens to stout. More...

void	subtractionBinOp (const double &inputValue1, const double &inputValue2, double &outputValue) const
	Subtraction binary operator function. More...

Protected Attributes
ArithmeticOperations::InputParameters	m_inputParameters
	Input execution parameters. More...

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

Detailed Description

Performs arithmetic operation over raster data.

The expression (arithmetic stringIt) must be formed by a combination of the following elements, separated by spaces:

Operators: +, -, *, /

Real Numbers (negative numbers must follow the form "-1.0")

Raster bands: R0:1, R0:1, R1:0, .... (R0:1 is a reference to the first raster - with index 0 - from feeder, second band - with index 1).

Note: Reference: TerraLib 4 - Image Processing Module

Definition at line 66 of file ArithmeticOperations.h.

Member Typedef Documentation

typedef void(ArithmeticOperations::* te::rp::ArithmeticOperations::BinOpFuncPtrT) (const double &inputValue1, const double &inputValue2, double &outputValue) const

protected

Type definition for a operation function pointer.

Definition at line 203 of file ArithmeticOperations.h.

typedef std::stack< ExecStackElement > te::rp::ArithmeticOperations::ExecStackT

protected

Execution stack type definition.

Definition at line 198 of file ArithmeticOperations.h.

Constructor & Destructor Documentation

te::rp::ArithmeticOperations::ArithmeticOperations ( )

te::rp::ArithmeticOperations::~ArithmeticOperations ( )

Member Function Documentation

void te::rp::ArithmeticOperations::additionBinOp	(	const double &	inputValue1,
		const double &	inputValue2,
		double &	outputValue
	)		const

inlineprotected

Addition binary operator function.

Definition at line 213 of file ArithmeticOperations.h.

bool te::rp::ArithmeticOperations::allocResultRaster	(	const te::rst::Grid &	grid,
		std::auto_ptr< te::rst::Raster > &	rasterPtr
	)		const

protected

Allocate a new RAM memory raster.

Parameters

grid	The output raster grid.
rasterPtr	The output raster pointer.

Returns: Returns true if OK, false on errors.

void te::rp::ArithmeticOperations::divisionBinOp	(	const double &	inputValue1,
		const double &	inputValue2,
		double &	outputValue
	)		const

inlineprotected

Division binary operator function.

Definition at line 231 of file ArithmeticOperations.h.

bool te::rp::ArithmeticOperations::execBinaryOperator	(	const std::string &	token,
		ExecStackT &	execStack,
		bool	generateOutput
	)		const

protected

Execute the given binary operator using the current given execution stack.

Parameters

token	Operator token.
execStack	Execution stack.
generateOutput	if true the execution will generate valid output data, if false only dummy stack elements will be generated.

Returns: true if OK, false on errors..

bool te::rp::ArithmeticOperations::execBinaryOperatorRasterXRaster	(	const te::rst::Raster &	inRaster1,
		const unsigned int	band1,
		const te::rst::Raster &	inRaster2,
		const unsigned int	band2,
		const BinOpFuncPtrT	binOptFunctPtr,
		std::auto_ptr< te::rst::Raster > &	outRasterPtr
	)		const

protected

Execute the given binary operator using the given input rasters.

Parameters

inRaster1	Input raster 1.
band1	Input raster 1 band.
inRaster2	Input raster 2.
band2	Input raster 2 band.
binOptFunctPtr	The binary operation function pointer.
outRasterPtr	The generated output raster.

Returns: true if OK, false on errors..

bool te::rp::ArithmeticOperations::execBinaryOperatorRasterXReal	(	const te::rst::Raster &	inRaster,
		const unsigned int	bandIdx,
		const double	value,
		const BinOpFuncPtrT	binOptFunctPtr,
		std::auto_ptr< te::rst::Raster > &	outRasterPtr,
		const bool	realNumberIsRigthtTerm
	)		const

protected

Execute the given binary operator using the given input raster and a real number.

Parameters

inRaster	Input raster.
bandIdx	Input raster band.
binOptFunctPtr	The binary operation function pointer.
outRasterPtr	The generated output raster.
realNumberIsRigthtTerm	true if the real number is the right term.

Returns: true if OK, false on errors..

bool te::rp::ArithmeticOperations::execUnaryOperator	(	const std::string &	token,
		ExecStackT &	execStack,
		bool	generateOutput
	)		const

protected

Execute the given unary operator using the current given execution stack.

Parameters

token	Operator token.
execStack	Execution stack.
generateOutput	if true the execution will generate valid output data, if false only dummy stack elements will be generated.

Returns: true if OK, false on errors..

bool te::rp::ArithmeticOperations::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.

bool te::rp::ArithmeticOperations::executeString	(	const std::string &	aStr,
		const std::vector< te::rst::Raster * > &	inRasters,
		std::auto_ptr< te::rst::Raster > &	outRaster,
		bool	generateOutput,
		te::common::TaskProgress *const	progressPtr
	)		const

protected

Execute the automata parsing the given input string.

Parameters

aStr	The input arithmetic expression string.
inRasters	Input rasters pointers.
outRaster	Output raster pointer (pre-initiated).
generateOutput	If true, the output raster data will be generated, if false only the automata execution will be performed..
progressPtr	A pointer to a progress interface to be pulsed on each operation or a null pointer.

void te::rp::ArithmeticOperations::getTokensStrs	(	const std::string &	inputStr,
		std::vector< std::string > &	outTokens
	)		const

protected

Split the input string into a vector of token strings.

Parameters

inputStr	The input string.
outTokens	The generated output tokens vector.

void te::rp::ArithmeticOperations::inFix2PostFix	(	const std::vector< std::string > &	input,
		std::vector< std::string > &	output
	)		const

protected

Convert the input tokens vector from the infix notation to postfix notation.

Parameters

input	The input tokens vector.
output	The output tokens vector.

bool te::rp::ArithmeticOperations::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.

bool te::rp::ArithmeticOperations::isBinaryOperator ( const std::string & inputToken ) const

protected

Returns true if the given token is a binary operator.

Parameters

inputToken Input token.

Returns: Returns true if the given token is a binary operator.

bool te::rp::ArithmeticOperations::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.

bool te::rp::ArithmeticOperations::isOperator ( const std::string & inputToken ) const

protected

Returns true if the given token is an operator.

Parameters

inputToken Input token.

Returns: Returns true if the given token is an operator.

bool te::rp::ArithmeticOperations::isRasterBandToken	(	const std::string &	token,
		unsigned int &	rasterIdx,
		unsigned int &	bandIdx
	)		const

protected

Returns true if the given token is a raster data token.

Parameters

token	Input token.
rasterIdx	The output converted raster index value.
bandIdx	The output converted band index value.

Returns: Returns true if the given token is a raster data token.

bool te::rp::ArithmeticOperations::isRealNumberToken	(	const std::string &	token,
		double &	realValue
	)		const

protected

Returns true if the given token is a real number.

Parameters

token	Input token.
realValue	The output converted value.

Returns: Returns true if the given token is a real number.

bool te::rp::ArithmeticOperations::isUnaryOperator ( const std::string & inputToken ) const

protected

Returns true if the given token is a unary operator.

Parameters

inputToken Input token.

Returns: Returns true if the given token is a unary operator.

void te::rp::ArithmeticOperations::multiplicationBinOp	(	const double &	inputValue1,
		const double &	inputValue2,
		double &	outputValue
	)		const

inlineprotected

Multiplication binary operator function.

Definition at line 225 of file ArithmeticOperations.h.

bool te::rp::ArithmeticOperations::op1HasGreaterOrEqualPrecedence	(	const std::string &	operator1,
		const std::string &	operator2
	)		const

protected

Returns true if operator1 has greater of equal precedence over operator2.

Parameters

operator1	Operator1 input token.
operator2	Operator2 input token.

Returns: Returns true if operator1 has greater of equal precedence over operator2.

void te::rp::ArithmeticOperations::printTokens ( const std::vector< std::string > & input ) const

protected

Print tokens to stout.

Parameters

input The input tokens vector.

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

virtual

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

Implements te::rp::Algorithm.

void te::rp::ArithmeticOperations::subtractionBinOp	(	const double &	inputValue1,
		const double &	inputValue2,
		double &	outputValue
	)		const

inlineprotected

Subtraction binary operator function.

Definition at line 219 of file ArithmeticOperations.h.

Member Data Documentation

ArithmeticOperations::InputParameters te::rp::ArithmeticOperations::m_inputParameters

protected

Input execution parameters.

Definition at line 206 of file ArithmeticOperations.h.

bool te::rp::ArithmeticOperations::m_isInitialized

protected

Tells if this instance is initialized.

Definition at line 208 of file ArithmeticOperations.h.

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

C:/CC_master/terralib5/src/terralib/rp/ArithmeticOperations.h

Classes

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation