ADD - Adds two NDF data structures

Description:

The routine adds two NDF  data structures pixel-by-pixel to produce a new NDF.

Usage:

add in1 in2 out

Parameters:

IN1 = NDF (Read)

First NDF to be added.

IN2 = NDF (Read)

Second NDF to be added.

OUT = NDF (Write)

Output NDF to contain the sum of the two input NDFs.

TITLE = LITERAL (Read)

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

Examples:

add a b c

This adds the NDF called b to the NDF called a, to make the NDF called c. NDF c inherits its title from a.

add out=c in1=a in2=b title="Co-added image"

This adds the NDF called b to the NDF called a, to make the NDF called c. NDF c has the title "Co-added image".

Notes:

If the two input NDFs have different pixel-index bounds, then they will be trimmed to match before being added. An error will result if they have no pixels in common.

Related Applications :

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

Implementation Status:

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

• The UNITS  component is propagated only if it has the same value in both input NDFs.

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

• All non-complex numeric data types can be handled.