USGS

Isis 3.0 Object Programmers' Reference

Home

Isis::Calculator Class Reference

Calculator for arrays. More...

#include <Calculator.h>

Inheritance diagram for Isis::Calculator:
Inheritance graph
Collaboration diagram for Isis::Calculator:
Collaboration graph

Public Member Functions

 Calculator ()
 Constructor.
 
virtual ~Calculator ()
 Virtual Constructor.
 
void Negative ()
 Pops an element, negates it, then pushes the result.
 
void Multiply ()
 Pops two elements, multiplies them, then pushes the product on the stack.
 
void Add ()
 Pops two elements, adds them, then pushes the sum on the stack.
 
void Subtract ()
 Pops two elements, subtracts them, then pushes the difference on the stack.
 
void Divide ()
 Pops two, divides them, then pushes the quotient on the stack.
 
void Modulus ()
 Pops two elements, mods them, then pushes the result on the stack.
 
void Exponent ()
 Pops two elements, computes the power then pushes the result on the stack The exponent has to be a scalar.
 
void SquareRoot ()
 Pop an element, compute its square root, then push the root on the stack.
 
void AbsoluteValue ()
 Pop an element, compute its absolute value, then push the result on the stack.
 
void Log ()
 Pop an element, compute its log, then push the result on the stack.
 
void Log10 ()
 Pop an element, compute its base 10 log, then push the result on the stack.
 
void LeftShift ()
 Pop the top element, then perform a left shift with zero fill.
 
void RightShift ()
 Pop the top element, then perform a right shift with zero fill.
 
void MinimumPixel ()
 Pop two elements, then push the minimum on a pixel by pixel basis back on the stack.
 
void MaximumPixel ()
 Pop two elements, then push the maximum on a pixel by pixel basis back on the stack.
 
void MinimumLine ()
 Pop one element, then push the minimum on the stack.
 
void MaximumLine ()
 Pop one element, then push the maximum on the stack.
 
void Minimum2 ()
 
void Maximum2 ()
 
void GreaterThan ()
 Pop two elements off the stack and compare them to see where one is greater than the other, then push the results on the stack.
 
void LessThan ()
 Pop two elements off the stack and compare them to see where one is less than the other, then push the results on the stack.
 
void Equal ()
 Pop two elements off the stack and compare them to see where one is equal to the other, then push the results on the stack.
 
void LessThanOrEqual ()
 Pop two elements off the stack and compare them to see where one is less than or equal to the other, then push the results on the stack.
 
void GreaterThanOrEqual ()
 Pop two elements off the stack and compare them to see where one is greater than or equal to the other, then push the results on the stack.
 
void NotEqual ()
 Pop two elements off the stack and compare them to see where one is not equal to the other, then push the results on the stack.
 
void And ()
 Pop two elements, AND them, then push the result on the stack.
 
void Or ()
 Pop two elements, OR them, then push the result on the stack.
 
void Sine ()
 Pops one element and push the sine.
 
void Cosine ()
 Pops one element and push the cosine.
 
void Tangent ()
 Pops one element and push the tangent.
 
void Secant ()
 Pops one element and push the secant.
 
void Cosecant ()
 Pops one element and push the cosecant.
 
void Cotangent ()
 Pops one element and push the cotangent.
 
void Arcsine ()
 Pops one element and push the arcsine.
 
void Arccosine ()
 Pops one element and push the arccosine.
 
void Arctangent ()
 Pops one element and push the arctangent.
 
void Arctangent2 ()
 Pops two elements and push the arctangent.
 
void SineH ()
 Pops one element and push the hyperbolic sine.
 
void CosineH ()
 Pops one element and push the hyperbolic cosine.
 
void TangentH ()
 Pops one element and push the hyperbolic tangent.
 
void ArcsineH ()
 Pops one element and push the inverse hyperbolic sine.
 
void ArccosineH ()
 Pops one element and push the inverse hyperbolic cosine.
 
void ArctangentH ()
 Pops one element and push the inverse hyperbolic tangent.
 
void Push (double scalar)
 Push a scalar onto the stack.
 
void Push (Buffer &buff)
 Push a buffer onto the stack.
 
void Push (QVector< double > &vect)
 Push a vector onto the stack.
 
QVector< double > Pop (bool keepSpecials=false)
 Pop an element off the stack.
 
void PrintTop ()
 Print the vector at the top of the stack.
 
bool Empty ()
 Check if the stack is empty.
 
virtual void Clear ()
 Clear out the stack.
 

Protected Member Functions

void PerformOperation (QVector< double > &results, QVector< double >::iterator arg1Start, QVector< double >::iterator arg1End, double operation(double))
 Performs the mathematical operations on each argument.
 
void PerformOperation (QVector< double > &results, QVector< double >::iterator arg1Start, QVector< double >::iterator arg1End, QVector< double >::iterator arg2Start, QVector< double >::iterator arg2End, double operation(double, double))
 Performs the mathematical operation on each pair of arguments, or a set of agruments against a single argument.
 
int StackSize ()
 Returns the current stack size.
 

Private Attributes

QStack< QVector< double > > * p_valStack
 The current stack of arguments.
 

Detailed Description

Calculator for arrays.

This class is a RPN calculator on arrays. It uses classic push/pop/operator methods. That is, push array1, push array2, add, pop arrayResult.

Author
2007-04-01 Sean Crosby
History:

2007-06-11 Jeff Anderson - Fixed bug in Push(Buffer) method. NAN was not computed properly.

2007-08-21 Steven Lambright - Moved the infix to postfix conversion into its own class.

2008-01-28 Steven Lambright - Added more support for the power operator

2008-03-28 Steven Lambright - Condensed math methods to just call PerformOperation(...). Converted valarray's to vectors (in order to use iterators)

2008-06-18 Christopher Austin - Added as well as fixed documentation

2010-02-23 Steven Lambright - Added Minimum2, Maximum2 and all min/max operations now ignore special pixels.

2010-04-08 Steven Lambright - Made min, max have proper implementations and vectors are now QVectors.

Definition at line 66 of file Calculator.h.

Constructor & Destructor Documentation

Isis::Calculator::Calculator ( )

Constructor.

Definition at line 302 of file Calculator.cpp.

Isis::Calculator::~Calculator ( )
virtual

Virtual Constructor.

Constructor.

Definition at line 309 of file Calculator.cpp.

Member Function Documentation

void Isis::Calculator::AbsoluteValue ( )

Pop an element, compute its absolute value, then push the result on the stack.

Definition at line 420 of file Calculator.cpp.

void Isis::Calculator::Add ( )

Pops two elements, adds them, then pushes the sum on the stack.

Definition at line 343 of file Calculator.cpp.

References Isis::AddOperator().

void Isis::Calculator::And ( )

Pop two elements, AND them, then push the result on the stack.

Definition at line 692 of file Calculator.cpp.

References Isis::BitwiseAndOperator().

void Isis::Calculator::Arccosine ( )

Pops one element and push the arccosine.

Definition at line 790 of file Calculator.cpp.

void Isis::Calculator::ArccosineH ( )

Pops one element and push the inverse hyperbolic cosine.

Definition at line 820 of file Calculator.cpp.

void Isis::Calculator::Arcsine ( )

Pops one element and push the arcsine.

Definition at line 780 of file Calculator.cpp.

void Isis::Calculator::ArcsineH ( )

Pops one element and push the inverse hyperbolic sine.

Definition at line 810 of file Calculator.cpp.

void Isis::Calculator::Arctangent ( )

Pops one element and push the arctangent.

Definition at line 800 of file Calculator.cpp.

void Isis::Calculator::Arctangent2 ( )

Pops two elements and push the arctangent.

Definition at line 840 of file Calculator.cpp.

void Isis::Calculator::ArctangentH ( )

Pops one element and push the inverse hyperbolic tangent.

Definition at line 830 of file Calculator.cpp.

void Isis::Calculator::Clear ( )
virtual

Clear out the stack.

Reimplemented in Isis::CubeCalculator.

Definition at line 1023 of file Calculator.cpp.

void Isis::Calculator::Cosecant ( )

Pops one element and push the cosecant.

Definition at line 750 of file Calculator.cpp.

References Isis::CosecantOperator().

void Isis::Calculator::Cosine ( )

Pops one element and push the cosine.

Definition at line 730 of file Calculator.cpp.

void Isis::Calculator::CosineH ( )

Pops one element and push the hyperbolic cosine.

Definition at line 863 of file Calculator.cpp.

void Isis::Calculator::Cotangent ( )

Pops one element and push the cotangent.

Definition at line 770 of file Calculator.cpp.

References Isis::CotangentOperator().

void Isis::Calculator::Divide ( )

Pops two, divides them, then pushes the quotient on the stack.

Definition at line 367 of file Calculator.cpp.

References Isis::DivideOperator().

bool Isis::Calculator::Empty ( )

Check if the stack is empty.

Returns
bool True if the stack is empty

Definition at line 1015 of file Calculator.cpp.

void Isis::Calculator::Equal ( )

Pop two elements off the stack and compare them to see where one is equal to the other, then push the results on the stack.

Definition at line 630 of file Calculator.cpp.

References Isis::EqualOperator().

void Isis::Calculator::Exponent ( )

Pops two elements, computes the power then pushes the result on the stack The exponent has to be a scalar.

Exceptions
Isis::iException::Math

Definition at line 395 of file Calculator.cpp.

void Isis::Calculator::GreaterThan ( )

Pop two elements off the stack and compare them to see where one is greater than the other, then push the results on the stack.

Definition at line 600 of file Calculator.cpp.

References Isis::GreaterThanOperator().

void Isis::Calculator::GreaterThanOrEqual ( )

Pop two elements off the stack and compare them to see where one is greater than or equal to the other, then push the results on the stack.

Definition at line 645 of file Calculator.cpp.

References Isis::GreaterThanOrEqualOperator().

void Isis::Calculator::LeftShift ( )

Pop the top element, then perform a left shift with zero fill.

Exceptions
Isis::iException::Math

Definition at line 454 of file Calculator.cpp.

References _FILEINFO_.

void Isis::Calculator::LessThan ( )

Pop two elements off the stack and compare them to see where one is less than the other, then push the results on the stack.

Definition at line 615 of file Calculator.cpp.

References Isis::LessThanOperator().

void Isis::Calculator::LessThanOrEqual ( )

Pop two elements off the stack and compare them to see where one is less than or equal to the other, then push the results on the stack.

Definition at line 660 of file Calculator.cpp.

References Isis::LessThanOrEqualOperator().

void Isis::Calculator::Log ( )

Pop an element, compute its log, then push the result on the stack.

Exceptions
Isis::iException::Math

Definition at line 432 of file Calculator.cpp.

void Isis::Calculator::Log10 ( )

Pop an element, compute its base 10 log, then push the result on the stack.

Definition at line 442 of file Calculator.cpp.

void Isis::Calculator::MaximumLine ( )

Pop one element, then push the maximum on the stack.

Definition at line 550 of file Calculator.cpp.

References Isis::IsSpecial().

void Isis::Calculator::MaximumPixel ( )

Pop two elements, then push the maximum on a pixel by pixel basis back on the stack.

Definition at line 585 of file Calculator.cpp.

References Isis::MaximumOperator().

void Isis::Calculator::MinimumLine ( )

Pop one element, then push the minimum on the stack.

Definition at line 531 of file Calculator.cpp.

References Isis::IsSpecial().

void Isis::Calculator::MinimumPixel ( )

Pop two elements, then push the minimum on a pixel by pixel basis back on the stack.

Definition at line 570 of file Calculator.cpp.

References Isis::MinimumOperator().

void Isis::Calculator::Modulus ( )

Pops two elements, mods them, then pushes the result on the stack.

Definition at line 379 of file Calculator.cpp.

References Isis::ModulusOperator().

void Isis::Calculator::Multiply ( )

Pops two elements, multiplies them, then pushes the product on the stack.

Definition at line 330 of file Calculator.cpp.

References Isis::MultiplyOperator().

void Isis::Calculator::Negative ( )

Pops an element, negates it, then pushes the result.

Definition at line 320 of file Calculator.cpp.

References Isis::NegateOperator().

void Isis::Calculator::NotEqual ( )

Pop two elements off the stack and compare them to see where one is not equal to the other, then push the results on the stack.

Definition at line 675 of file Calculator.cpp.

References Isis::NotEqualOperator().

void Isis::Calculator::Or ( )

Pop two elements, OR them, then push the result on the stack.

Definition at line 706 of file Calculator.cpp.

References Isis::BitwiseOrOperator().

void Isis::Calculator::PerformOperation ( QVector< double > &  results,
QVector< double >::iterator  arg1Start,
QVector< double >::iterator  arg1End,
double   operationdouble 
)
protected

Performs the mathematical operations on each argument.

Parameters
results[out] The results of the performed operation
arg1StartThe first argument to have the operation done on
arg1EndOne argument beyond the final argument to have the operation done upon
operationThe operation to be done on all arguments

Definition at line 1039 of file Calculator.cpp.

void Isis::Calculator::PerformOperation ( QVector< double > &  results,
QVector< double >::iterator  arg1Start,
QVector< double >::iterator  arg1End,
QVector< double >::iterator  arg2Start,
QVector< double >::iterator  arg2End,
double   operationdouble, double 
)
protected

Performs the mathematical operation on each pair of arguments, or a set of agruments against a single argument.

Parameters
results[out] The results of the performed operation
arg1StartThe first of the primary argument to have the operation done on
arg1EndOne arguement beyond the final primary argument to have the operation done upon
arg2StartThe first of the secondaty argument to have the operation done on
arg2EndOne arguement beyond the final secondary argument to have the operation done upon
operationThe operation to be done on all pairs of arguments

Definition at line 1068 of file Calculator.cpp.

References _FILEINFO_.

QVector< double > Isis::Calculator::Pop ( bool  keepSpecials = false)

Pop an element off the stack.

Parameters
keepSpecialsIf true, special pixels will be preserved; otherwise, they will be mapped to double values
Returns
The top of the stack, which gets popped

Definition at line 958 of file Calculator.cpp.

References _FILEINFO_, Isis::Hrs, Isis::Lrs, and Isis::Null.

void Isis::Calculator::PrintTop ( )

Print the vector at the top of the stack.

Definition at line 998 of file Calculator.cpp.

void Isis::Calculator::Push ( double  scalar)

Push a scalar onto the stack.

Parameters
scalarThe scalar that will be pushed on the stack

Definition at line 902 of file Calculator.cpp.

void Isis::Calculator::Push ( Buffer buff)

Push a buffer onto the stack.

Parameters
buffThe buffer that will be pushed on the stack

Definition at line 914 of file Calculator.cpp.

References Isis::IsHisPixel(), Isis::IsHrsPixel(), Isis::IsLisPixel(), Isis::IsLrsPixel(), Isis::IsNullPixel(), Isis::IsSpecial(), and Isis::Buffer::size().

void Isis::Calculator::Push ( QVector< double > &  vect)

Push a vector onto the stack.

Parameters
vectThe vector that will be pushed on the stack

Definition at line 892 of file Calculator.cpp.

void Isis::Calculator::RightShift ( )

Pop the top element, then perform a right shift with zero fill.

Exceptions
Isis::iException::Math

Definition at line 493 of file Calculator.cpp.

References _FILEINFO_.

void Isis::Calculator::Secant ( )

Pops one element and push the secant.

Definition at line 760 of file Calculator.cpp.

References Isis::SecantOperator().

void Isis::Calculator::Sine ( )

Pops one element and push the sine.

Definition at line 720 of file Calculator.cpp.

void Isis::Calculator::SineH ( )

Pops one element and push the hyperbolic sine.

Definition at line 853 of file Calculator.cpp.

void Isis::Calculator::SquareRoot ( )

Pop an element, compute its square root, then push the root on the stack.

Exceptions
Isis::iException::Math

Definition at line 410 of file Calculator.cpp.

int Isis::Calculator::StackSize ( )
protected

Returns the current stack size.

Get the current stack size.

Definition at line 883 of file Calculator.cpp.

void Isis::Calculator::Subtract ( )

Pops two elements, subtracts them, then pushes the difference on the stack.

Definition at line 355 of file Calculator.cpp.

References Isis::SubtractOperator().

void Isis::Calculator::Tangent ( )

Pops one element and push the tangent.

Definition at line 740 of file Calculator.cpp.

void Isis::Calculator::TangentH ( )

Pops one element and push the hyperbolic tangent.

Definition at line 873 of file Calculator.cpp.

Member Data Documentation

QStack< QVector<double> >* Isis::Calculator::p_valStack
private

The current stack of arguments.

Definition at line 146 of file Calculator.h.


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