KPG1_PLTLN

Produces a graphical representation of a set of points in two dimensions

Description:

This routine produces a graphical representation of a set of points in two-dimensional space (e.g. a data value and a position, or two data values). Errors in both data values may be represented by error bars. No annotated axes are drawn. The calling routine should do this if required by passing the supplied Plot (IPLOT) to routine KPG1_ASGRD.

PGPLOT should be active, and the viewport should correspond to the DATA picture in which the plot is to be drawn. PGPLOT world co-ordinates within the viewport should be GRAPHICS co-ordinates (millimetres from the bottom-left corner of the view surface).

The Plotting style is accessed using one or more environment parameters specified by PARAM, and may include the following synonyms for graphical elements: " Err(Bars)" - Specifies colour, etc. for error bars. Size(errbars) scales the size of the serifs used if ERSHAP=1 (i.e. a size value of 1.0 produces a default size). " Sym(bols)" - Specifies colour, etc. for markers (used in Modes 3 and 5). " Lin(es)" - Specifies colour, etc. for lines (used in Modes 1, 2, 4 and 5).

Invocation

CALL KPG1_PLTLN( N, ILO, IHI, X, Y, XERROR, YERROR, XBAR, YBAR, XSTEP, PARAM, IPLOT, MODE, MTYPE, ERSHAP, FREQ, APP, STATUS )

Arguments

N = INTEGER (Given)
Number of points to be plotted.
ILO = INTEGER (Given)
The index of the first grid point to be used.
IHI = INTEGER (Given)
The index of the last grid point to be used.
X( N ) = DOUBLE PRECISION (Given)
The X value at each point, in PGPLOT world co-ordinate (i.e. millimetres from the bottom-left corner of the view surface).
Y( N ) = DOUBLE PRECISION (Given)
The Y value at each point, in PGPLOT world co-ordinate (i.e. millimetres from the bottom-left corner of the view surface).
XERROR = LOGICAL (Given)
Display X error bars?
YERROR = LOGICAL (Given)
Display Y error bars?
XBAR( N, 2 ) = DOUBLE PRECISION (Given)
Row 1 contains the lower limit and Row 2 contains the upper limit for each horizontal error bar, in PGPLOT world co-ordinate (i.e. millimetres from the bottom left corner of the view surface). Only accessed if XERROR is .TRUE.
YBAR( N, 2 ) = DOUBLE PRECISION (Given)
Row 1 contains the lower limit and Row 2 contains the upper limit for each vertical error bar, in PGPLOT world co-ordinate (i.e. millimetres from the bottom-left corner of the view surface). Only accessed if YERROR is .TRUE.
XSTEP( N, 2 ) = DOUBLE PRECISION (Given)
Row 1 contains the lower limit and Row 2 contains the upper limit for each horizontal step, in PGPLOT world co-ordinate (i.e. millimetres from the bottom-left corner of the view surface). Only accessed if MODE is 4.
PARAM = CHARACTER ( ) (Given)
The names of one or more style parameters to be used when obtaining the plotting style. If more than one parameter is supplied, the list should be separated by commas. The supplied parameters will be used in the order supplied, with later parameters allowing attributes obtained via earlier parameters to be assigned new values.
IPLOT = INTEGER (Given)
An AST Plot which can be used to do the drawing. The Base Frame should be GRAPHICS co-ordinates (millimetres from the bottom- left corner of the PGPLOT view surface). The Current Frame should be the Frame in which annotation is required.
MODE = INTEGER (Given)
Determines the way in which the data points are represented. The options are as follows. 1 - A " staircase" histogram, in which each horizontal line is centred on the X position. Bad values are flanked by vertical lines drawn down to the lower edge of the viewport. 2 - The points are joined by straight lines. 3 - A marker is placed at each point (see MTYPE). 4 - Mark each point with a horizontal line of width given by XW. 5 - A " chain" in which each point is marker by a marker and also join by straight lines to its neighbouring points. 6 - The same as Mode 1, except that bad values are not flanked by vertical lines drawn down to the lower edge of the viewport (a simple gap is left instead). 7 - The data points are not drawn.
MTYPE = INTEGER (Given)
The PGPLOT marker type to use if MODE is 3 or 5.
ERSHAP = INTEGER (Given)
Determines the way in which error bars are drawn: 1 - X and Y errors are represented by horizontal and vertical lines respectively. Serifs are drawn at the ends of each line. The size of these sreifs is controlled by the size(errbar) plotting attribute. 2 - A cross is drawn joining the corners of the box encompassing the X and Y errors. 3 - A Diamond is drawn joining the ends of the horizontal and vertical error bars which would have been drawn if ERSHAP had been 1. These will all produce the same result (i.e. a single straight line) if errors are available only on one axis (see XERROR and YERROR). Not accessed if XERROR and YERROR are both .FALSE.
FREQ = INTEGER (Given)
The frequency at which errors are to be plotted. A value of 1 means " plot errors for every point" , 2 means " plot errors for every second point" , etc. Not accessed if XERROR and YERROR are both .FALSE.
APP = CHARACTER ( ) (Given)
The name of the calling application in the form <package >_ <application > (eg " KAPPA_DISPLAY" ).
STATUS = INTEGER (Given and Returned)
The global status.