KPG1_GRLM2

Finds the default limits for a graph axis

Description:

This routine returns the default limits for a graph axis. The way in which the limits are chosen is specified by the user through the parameter specified by PARAM. This parameter can take the following values:

The above strings can be abbreviated to one character.

If the parameter name is supplied as blank, then " Extended" is assumed (i.e. LIM1 and LIM2 are chosen so that the axis encompasses the entire data range including error bars, with 2.5% margin at each end).

If only 1 limit is required (i.e. if LIM1 or LIM2 are supplied not equal to VAL__BADD), then only 1 numerical value can be supplied in the above limit descriptions.

Invocation

CALL KPG1_GRLM2( PARAM, N, D1, D2, USEBAR, BAR, LIM1, LIM2, 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.
N = INTEGER (Given)
No. of points
D1( N ) = DOUBLE PRECISION (Given)
The central data value at each point.
D2( N ) = DOUBLE PRECISION (Given)
An associated mask array. D1( I ) is only used if both D1( I ) and D2( I ) are not equal to VAL__BADD.
USEBAR = LOGICAL (Given)
Should BAR be used?
BAR( N,2 ) = DOUBLE PRECISION (Given)
The upper and lower ends of each error bar. Assumed equal to D1 if USEBAR is .FALSE. (i.e. no error bars).
LIM1 = DOUBLE PRECISION (Given and Returned)
The chosen low data limit. Only returned if a value of VAL__BADD is supplied, Otherwise, the supplied value is returned unchanged.
LIM2 = DOUBLE PRECISION (Given and Returned)
The chosen high data limit. Only returned if a value of VAL__BADD is supplied, Otherwise, the supplied value is returned unchanged.
STATUS = INTEGER (Given and Returned)
The global status.