- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑
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.
- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑