CUMULVEC - Sums the values cumulatively in a one-dimensional NDF

Description:

This application forms the cumulative sum of the values of a one-dimensional NDF starting from the first to the last element. thus the first output pixel will be unchanged but the second will be the sum of the first two input pixels, third output pixel is the sum of the first three input pixels and so on. Anomalous values may be excluded from the summation by setting a threshold.

Usage:

cumulvec in out [thresh]

Parameters:

IN = NDF (Read)

The one-dimensional NDF containing the vector to be summed.

OUT = NDF (Write)

The NDF to contain the summed image.

THRESH = _DOUBLE (Read)

The maximum difference between adjacent elements for the summation to ocur. For increments outside the allowed range, the increment becomes zero. If null, !, is given, then there is no limit. [!]

TITLE = LITERAL (Read)

The title of the output NDF. A null (!) value means using the title of the input NDF. [!]

Examples:

cumulvec gradient profile

The one-dimensional NDF called gradient is summed cumulatively to form NDF profile.

cumulvec in=gradient out=profile thresh=20

As above but only adjacent values separated by less than 20 are included in the summation.

Related Applications :

KAPPA: HISTOGRAM.

Implementation Status:

• This routine correctly processes the AXIS, DATA, QUALITY, VARIANCE, LABEL, TITLE, UNITS, WCS, and HISTORY components of an NDF data structure and propagates all extensions.

• Processing of bad pixels and automatic quality masking are supported. Bad pixels are propagated and excluded from the summation.

• All non-complex numeric data types can be handled. Arithmetic is performed using single- or double-precision floating point as appropriate.