KPG1_DARAx

Determines the data limits for an array using a variety of methods

Description:

This routine derives a data range applicable to the supplied array. It is intended to be used to specify the data limits for histogram plots and scaling data for image display. There is a variety of methods available to derive the limits, of which a subset of appropriate methods can be defined by argument METHOD.

The method is selected by the user through the literal parameter specified by PARAM. The supplied string should consist of up to three sub-strings or elements, separated by commas. In all but one method, the first element must specify the method to use. If supplied, the other two elements should be numerical values as described below (default values will be used if these elements are not provided). The following options are available.

The above method names can be abbreviated to one character.

If the parameter name is supplied as blank, then " Range" is assumed (i.e. LOWER and UPPER are chosen so that the encompasses the entire data range).

The extreme values are reported unless the limits parameter PARAM is specified on the command line. In this case extreme values are only calculated where necessary for the chosen method.

Invocation

CALL KPG1_DARAx( PARAM, EL, ARRAY, METHDS, BAD, LOWER, UPPER, STATUS )

Arguments

PARAM = CHARACTER ∗ ( ∗ ) (Given)
The name of the parameter to use to get the method for chosing the default limits for the axis. May be blank.
EL = INTEGER (Given)
The number of elements of the array to be analysed.
ARRAY( EL ) = ? (Given)
The array for which the chosen statistics are required.
METHDS = CHARACTER ∗ ( ∗ ) (Given)
A comma-separated list of methods by which the data limits may be specified. Different tasks may require only a subset of the methods available. The allowed methods are " Faint" , " Extended" , " Limit" , " Percentiles" , " Range" , and " Sigmas" . See the description for details of these methods.
BAD = LOGICAL (Given and Returned)
True when bad pixels may be present.
LOWER = DOUBLE PRECISION (Returned)
The lower limit.
UPPER = DOUBLE PRECISION (Returned)
The upper limit.
STATUS = INTEGER( Given & Returned )
Global status.

Notes: