KPG1_GRLM1

Finds the default limits for a graph axis

Description:

This routine returns one or both default limits for a graph axis. Any limits which are supplied by the calling routine are used as supplied. The user is only allowed to over-ride limits which are supplied as VAL__BADR. The way in which these 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__BADR), then only 1 numerical value can be supplied in the above limit descriptions.

Invocation

CALL KPG1_GRLM1( PARAM, N, D1, D2, NSIGMA, SIGMA, 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 ) = REAL (Given)
The central data value at each point.
D2( N ) = REAL (Given)
An associated mask array. D1( I ) is only used if both D1( I ) and D2( I ) are not equal to VAL__BADR.
NSIGMA = REAL (Given)
Controls the length of the error bars. The error bars are assumed to extended from D1( I ) - NSIGMASIGMA( I ) to D1( I ) + NSIGMASIGMA( I ). A value of zero suppresses error bars.
SIGMA( N ) = REAL (Given)
The standard deviation associated with each Y value. Not accessed if NSIGMA is zero.
LIM1 = REAL (Given and Returned)
The chosen low data limit. Only returned if a value of VAL__BADR is supplied, Otherwise, the supplied value is returned unchanged.
LIM2 = REAL (Given and Returned)
The chosen high data limit. Only returned if a value of VAL__BADR is supplied, Otherwise, the supplied value is returned unchanged.
STATUS = INTEGER (Given and Returned)
The global status.