CCG_TM3x - Combines data lines using a trimmed mean

Description:

This routine accepts an array consisting a series of (vectorised) lines of data. The data values in the lines are then combined to form an alpha trimmed mean line. The output means are returned in the array RESULT.

Invocation:

CALL CCG_TM3x( ALPHA, NPIX, NLINES, STACK, MINPIX, RESULT, WRK1, POINT, USED, NCON, NBAD, STATUS )

Arguments:

ALPHA = REAL (Given)

The fraction of data to trim from upper and lower orders. It must be greater than 0.0 and less 0.5.

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.

MINPIX = INTEGER (Given)

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

RESULT( NPIX ) = ? (Returned)

The output line of data.

WRK1( NLINES ) = ? (Returned)

Workspace for calculations.

POINT( NLINES ) = INTEGER (Returned)

Workspace to hold pointers to the original positions of the data before extraction and conversion in to the WRK1 array.

USED( NLINES ) = LOGICAL (Returned)

Workspace used to indicate which values have been used in estimating a resultant value.

NCON( NLINES ) = DOUBLE PRECISION (Returned)

The actual number of contributing pixels.

NBAD = INTEGER (Returned)

The number of bad values in the output array.

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