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(power∗LOG(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: