CCG_ME1x - Combines data lines using a weighted mean

Description:

This routine accepts an array consisting of a series of (vectorised) lines of data. The data values in the lines are then combined to form a weighted mean. The weights used are are the reciprocal of values given in the array VARS. The output means are returned in the array RESULT. The output variances are estimated from the VARS values and are returned in RESVAR.

Invocation:

CALL CCG_ME1x( NPIX, NLINES, STACK, VARS, MINPIX, RESULT, RESVAR, NCON, NBAD, STATUS )

Arguments:

NPIX = INTEGER (Given)

The number of pixels in a line of data.

NLINES = INTEGER (Given)

The number of lines of data in the stack.

STACK( NPIX, NLINES ) = ? (Given)

The array of lines which are to be combined into a single line.

VARS( NPIX, NLINES ) = ? (Given)

The data variances.

MINPIX = INTEGER (Given)

The minimum number of pixels required to contribute to an output pixel.

RESULT( NPIX ) = ? (Returned)

The output line of data.

RESVAR( NPIX ) = ? (Returned)

The output variances.

NCON( NLINES ) = DOUBLE PRECISION (Returned)

The actual number of contributing pixels from each input line to the output line.

NBAD = INTEGER (Returned)

The number of bad values in the output array created while forming the statistics. It excludes those bad values whose corresponding values along the collapse axis are all bad.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• There is a routine for real and double-precision: replace "x" in the routine name by D or R as appropriate. The STACK, VARS, RESULT, and RESVAR arguments supplied to the routine must have the data type specified.

• This routine performs its work in double precision.