CCG_MX1x - Combines data lines using the maximum value

Description:

This routine accepts an array consisting a series of (vectorised) lines of data. The data values in the lines are then collapsed to the maximum value in each line. The output maxima are returned in the array RESULT. Each output variance value is the corresponding variance of the maximum data value, propagated from the input variances given in array VARNCE and are returned in the array RESVAR. The vectorised pixel indices corresponding to the maxima are also returned in POSIND.

Invocation:

CALL CCG_MX1x( BAD, NPIX, NLINES, STACK, VARNCE, RESULT, RESVAR, POSIND, WRK1, NCON, NBAD, STATUS )

Arguments:

BAD = LOGICAL (Given)

If true, there may be bad pixels present in the array. If false, it is safe not to check for bad values.

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.

VARNCE( NPIX, NLINES ) = ? (Given)

The data variances.

RESULT( NPIX ) = ? (Returned)

The output line of data.

RESVAR( NPIX ) = ? (Returned)

The output variances.

POSIND( NPIX ) = INTEGER (Returned)

The pixel indices of the maxima in each output pixel.

WRK1( NLINES ) = ? (Returned)

Workspace for calculations.

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 RESULT 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 each numeric data type: replace "x" in the routine name by D, R, I, W, UW, B or UB as appropriate. The STACK, VARNCE, RESULT, RESVAR, and WRK1 arguments supplied to the routine must have the data type specified.