POW - Takes the specified power of each pixel of an NDF

Description:

This routine copies the supplied input NDF , raising each value in the DATA array to the specified power. The VARIANCE  component, if present, is modified appropriately. Negative data values will only generate good output pixels when the power is an integer.

Usage:

pow in power out

Parameters:

IN = NDF (Read)

The input NDF structure.

OUT = NDF (Write)

The output NDF structure.

POWER = _DOUBLE (Read)

The power.

TITLE = LITERAL (Read)

A title for the output NDF. A null value will cause the title of the NDF supplied for Parameter IN to be used instead. [!]

Examples:

pow m51 2 m51sq

Square all values in the NDF called m51, and store the results in the NDF called m51sq.

Related Applications :

KAPPA: ADD, CADD, CMULT, CDIV, CSUB, DIV, MATHS, MULT, SUB.

Implementation Status:

• This routine correctly processes the AXIS, DATA, QUALITY, LABEL, TITLE, UNITS, HISTORY, WCS, and VARIANCE  components of an NDF data structure and propagates all extensions.

• Processing of bad pixels and automatic quality masking are supported.

• All non-complex numeric data types can be handled. Arithmetic is performed using single-precision floating point, or double precision, if appropriate, but the numeric type of the input pixels is preserved in the output NDF.