KPG1_POWx

Raises each element of a vectorised array to a specified power

Description:

The routine raises each element of a vectorised array to a specified power. Any associated variance values are also modified appropriately. For general non-integer powers the result is calculated as EXP(powerLOG(data)). This enables bad output pixels to be detected by checking the magnitude of LOG(data). For integer powers, the result is calcualted using the Fortran " " operator, which is more efficient.

Invocation

CALL KPG1_POWx( BAD, VAR, POWER, EL, DIN, VIN, DOUT, VOUT, NBAD, STATUS )

Arguments

BAD = LOGICAL (Given)
Whether to check for bad values in the input arrays.
VAR = LOGICAL (Given)
Have associated variances been supplied?
POWER = DOUBLE PRECISION (Given)
The required power.
EL = INTEGER (Given)
Number of array elements to process.
DIN( EL ) = ? (Given)
Input data array.
VIN( EL ) = ? (Given)
Input variance array. Only accessed if VAR is .TRUE.
DOUT( EL ) = ? (Given)
Output data array.
VOUT( EL ) = ? (Given)
Output variance array. Only accessed if VAR is .TRUE.
NBAD( 2 ) = INTEGER (Returned)
Element 1 has the number of bad values stored in DOUT, and Element 2 has the number of bad values stored in VOUT.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: