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
pow in power out
IN = NDF (Read)
The input NDF
OUT = NDF (Write)
The output NDF structure.
POWER = _DOUBLE (Read)
TITLE = LITERAL (Read)
for the output NDF. A null value will
cause the title of the NDF supplied for Parameter IN to be used instead.
pow m51 2 m51sq Square all values in the NDF called m51, and
store the results in the NDF called m51sq.
This routine correctly processes the AXIS, DATA, QUALITY, LABEL, TITLE, UNITS,
HISTORY, WCS, and VARIANCE components of an NDF data structure and propagates all
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.