CCG_MX3x - 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. The vectorised pixel indices corresponding to the maxima are also returned in POSIND.

Invocation:

CALL CCG_MX3x( BAD, NPIX, NLINES, STACK, RESULT, POSIND, WRK1, NBAD, 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.

RESULT( NPIX ) = ? (Returned)

The output line of data.

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 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, RESULT, and WRK1 arguments supplied to the routine must have the data type specified.