SCULIB_COADD - coadd exposure into coadded result

Description:

This routine coadds the current exposure to the input coadd arrays and puts the result in the output coadd arrays. The input and output arrays can be the same. The coadd result is the average of exposures that have been input. The coadd variance is calculated from the spread of the input exposures about the mean if more than one exposure has been added in. If only one exposure is available then the coadd variance is set equal to variance on the input data if present, otherwise it is set equal to zero. Input pixels with bad quality are ignored.

Invocation:

CALL SCULIB_COADD (N, IN_DATA, IN_VARIANCE, IN_QUALITY, INCOADD_DATA, INCOADD_VAR, INCOADD_QUAL, INCOADD_NUMBER, OUTCOADD_DATA, OUTCOADD_VAR, OUTCOADD_QUAL, OUTCOADD_NUMBER, BADBIT, VARIANCE, STATUS)

Arguments:

N = INTEGER (Given)

Number of elements in arrays.

IN_DATA (N) = REAL (Given)

data to be added to coadd

IN_VARIANCE (N) = REAL (Given)

variance on input data

IN_QUALITY (N) = BYTE (Given)

quality on input data

INCOADD_DATA (N) = REAL (Given)

Input coadd.

INCOADD_VAR (N) = REAL (Given)

Input coadd variance.

INCOADD_QUAL (N) = BYTE (returned)

Input coadd quality.

INCOADD_NUMBER (N) = INTEGER (Given)

Number of exposures coadded in input coadd.

OUTCOADD_DATA (N) = REAL (Returned)

Output coadd.

OUTCOADD_VAR (N) = REAL (Returned)

Output coadd variance.

OUTCOADD_QUAL (N) = BYTE (returned)

Output coadd quality.

OUTCOADD_NUMBER (N) = INTEGER (Returned)

Number of exposures coadded in output coadd.

BADBIT = BYTE (Given)

Bad bit mask

VARIANCE = LOGICAL (Given)

T if input data has variance associated with it

STATUS = INTEGER (Given & Returned)

Global status

Copyright

Copyright ©1995,1996,1997,1998,1999 Particle Physics and Astronomy Research Council. All Rights Reserved.