CCG_TCR3x - Combines data lines using a threshold clipped mean

Description:

This routine accepts an array consisting a series of (vectorised) lines of data. All values outside of the range VMIN to VMAX are rejected before a estimate of the (weighted) mean is made. The output mean values are returned in the array RESULT.

Invocation:

CALL CCG_TCR3x( VMIN, VMAX, NPIX, NLINES, STACK, VARS, MINPIX, RESULT, WRK1, WRK2, POINT, USED, NCON, NBAD, STATUS )

Arguments:

VMIN = ? (Given)

Minimum allowed value.

VMAX = ? (Given)

Maximum allowed value.

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( NLINES ) = ? (Given)

The variance to to used for each line of data.

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.

WRK2( 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 from each input line to the output line.

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