/GRAPHICS_HPLOT

Draw various HPLOT objects (symbols, errors, key, etc.).

/GRAPHICS/HPLOT/SYMBOLS x y n [ isymb ssize ]

X C Vector of X coordinates
Y C Vector of Y coordinates
N I Number of points D=1
ISYMB I Symbol number D=24
SSIZE R Symbol size D=0.28

Draw the same symbol at several points x,y in the current normalisation transformation.

/GRAPHICS/HPLOT/ERRORS x y ex ey n [ isymb ssize chopt ]

X C Vector of X coordinates
Y C Vector of Y coordinates
EX C Vector of X error bars
EY C Vector of Y error bars
N I Number of points D=1
ISYMB I Symbol number D=24
SSIZE R Symbol size D=0.28
CHOPT C Options D=' '

CHOPT:

'' '' Coordinates are expressed in histogram coordinates (of the last drawn histogram). Error bars are drawn.
'C' Coordinates are expressed in centimeters.
'W' A new window is defined and axis are drawn.
'1' Draw small lines at the end of the error bars.
'2' Draw error rectangles.
'3' Draw a filled area through the end points of the vertical error bars.
'4' Draw a smoothed filled area through the end points of the vertical error bars.
'0' Turn off the symbols clipping.

Draw (according to the CHOPT value) a series of points using a symbol and error bars in horizontal and vertical direction in the current normalisation transformation.

By default, the symbols are not drawn if they are on the edges of the plot: the option '0' allows to turn off this symbols clipping.

With Option 1, the size of the tick marks at the end of the error bars is equal to the marker size and can be changed with SET KSIZ.

If ISYMB = 0 or SSIZE = 0. no symbol is drawn.

Note that the options can be cumulated.

/GRAPHICS/HPLOT/AERRORS x y exl exu eyl eyu n [ isymb ssize chopt ]

X C Vector of X coordinates
Y C Vector of Y coordinates
EXL C Vector of X error bars (Low)
EXU C Vector of X error bars (Up)
EYL C Vector of Y error bars (Low)
EYU C Vector of Y error bars (Up)
N I Number of points D=1
ISYMB I Symbol number D=24
SSIZE R Symbol size D=0.28
CHOPT C Options D=' '

CHOPT:

'' '' Coordinates are expressed in histogram coordinates (of the last drawn histogram). Error bars are drawn.
'C' Coordinates are expressed in centimeters.
'W' A new window is defined and axis are drawn.
'1' Draw small lines at the end of the error bars.
'2' Draw error rectangles.
'3' Draw a filled area through the end points of the vertical error bars.
'4' Draw a smoothed filled area through the end points of the vertical error bars.
'0' Turn off the symbols clipping.

Draw (according to the CHOPT value) a series of points using a symbol and asymmetric error bars in horizontal and vertical direction in the current normalisation transformation.

By default, the symbols are not drawn if they are on the edges of the plot: the option '0' allows to turn off this symbols clipping.

With Option 1, the size of the tick marks at the end of the error bars is equal to the marker size and can be changed with SET KSIZ.

If ISYMB = 0 or SSIZE = 0. no symbol is drawn.

Note that the options can be cumulated.

/GRAPHICS/HPLOT/KEY x y [ iatt text dx chopt ]

X R X coordinate of comment
Y R Y coordinate of comment
IATT I Attribute value D=24
TEXT C Legend D=' '
DX R Box width D=1.
CHOPT C Options D=' '

CHOPT:

'' '' IATT is a marker type
'F' IATT is a fill area color index
'H' IATT is a hatches type
'L' IATT is a line type
'W' IATT is a line width

Draw one legend and its explanation at a point x,y in the current normalisation transformation.

The legend can be:

- A marker type (default) - A filled box (CHOPT=F), in this case IATT is a color and DX is the width of the box. - A hatched box (CHOPT=H), in this case IATT is a hatches type and DX is the width of the box. - A line (CHOPT=L), in this case IATT is a line type and DX is the length of the line. - A line (CHOPT=W), in this case IATT is a line width and DX is the length of the line.

Example

SET * ; OPT * | Reset the defaults NUL 0 10 0 8 A | Draw a frame KEY 5 2 ! 'Key 1' | Key with marker KEY 5 3 2 'Key 2' ! F | Key with filled box SET FACI 3 | Change color for next key key 5 4 2 'Key 3' 2 H | Key with hatches. DX is modified key 5 5 2 'Key 4' ! L | Key with line type SET PLCI 4 | Change color for next key SET CSIZ .4 | Change key size KEY 5 6 8 'Key 5' 1.5 W | Key with line width

/GRAPHICS/HPLOT/TICKS [ chopt xval yval ]

CHOPT C Options D=' '
XVAL R Intersection on the X-axis D=1.E30
YVAL R Intersection on the Y-axis D=1.E30

CHOPT:

'' '' Tick marks are drawn on the edges of the picture
'X' Cross-wire drawn perpendicular to the X-axis
'Y' Cross-wire drawn perpendicular to the Y-axis
'A' Value drawn Above cross-wire
'B' Value drawn Below cross-wire
'L' Value drawn Left of cross-wire
'R' Value drawn Right of cross-wire

Draw 'cross-wires' on a picture, optionally with tick marks and values. Cross-wires are lines perpendicular to the X and/or Y axis.

The values of XVAL are always histogram coordinates.

The tick marks will be drawn on both side of the cross wire, unless the cross-wires are requested on the boundary of the box surrounding the histogram (i.e. at the extreme limits of the drawn histogram). In this case tick marks will only be drawn inside the box.

The options 'A' and 'B' (for Above and Below) refer only to the cross-wire perpendicular to the Y axis. In each case only one cross-wire will be drawn.

Similarly 'L' and 'R' (Left and Right) refer only to the cross-wires perpendicular to the X-axis.

It is possible to redefine the length of tick marks on the X or Y axis with SET XTIC or SET YTIC.

The position of the axis values may be changed with SET XVAL or SET YVAL.

The Number of divisions can be cahnged with SET NDVX and SET NDVY.

This command combines with the command NUL is a easy way to redraw axis on the current plot.

Example:

SET * ; OPT * | Reset the defaults Nul 0 1 0 1 | draw an empty frame with axis Set ndvy 5 | Change number of Y divisions Nul 0 10 0 10 ABS | Redefine the scales Tic XR 5 ! | Axis in the new coordinates

/GRAPHICS/HPLOT/ATITLE [ xtit ytit ztit ialgn chopt ]

XTIT C X Axis title D=' '
YTIT C Y Axis title D=' '
ZTIT C Z Axis title D=' '
IALGN I Axis titles alignment D=0
CHOPT C Options D=' '

CHOPT:

'' '' Axis title are drawn on the left and on the bottom of the plot.
'R' Y axis title is drawn on the right of the plot.
'T' X axis title is drawn on the top of the plot.

Draw axis titles on the axes of the present plot zone. The parameter IALGN defined where the title is aligned i.e: on the beginning, the middle or at the end of the axis. The alignment parameter has 3 digits (one for each axis): xyz where x, y and z may have independently the following values:

1: Begining of the axis 2: Middle of the axis 3: End of the axis (0 is equivalent to 3)

Example:

NUL 0 10 0 10 NUL 0 100 0 100 S ATITLE 'End of axis' 'Middle of axis on the right' ! 320 R ATITLE 'Beginning of axis' 'End of axis' ! 130 ATITLE 'Middle of axis on the top' 'Beginning of axis' ! 210 T

/GRAPHICS/HPLOT/GRID

Draw a grid in cm. The grid appearance is controlled with the line and text attributes (cf command SET).

/GRAPHICS/HPLOT/NULL [ xmin xmax ymin ymax chopt ]

XMIN R Low range in X D=0.
XMAX R High range in X D=1.
YMIN R Low range in Y D=0.
YMAX R High range in Y D=1.
CHOPT C Options D=' '

CHOPT:

'' '' Draw a frame box only.
'S' Redefine the scale for the current zone.
'A' Axis labels and tick marks are not drawn.
'B' The box is not drawn.

Define an empty 2D space of coordinates. If XMIN, XMAX, etc. are given, draw a frame box with the window coordinates set to XMIN, XMAX, YMIN, YMAX. Axis labels and tick marks are drawn by default.

/GRAPHICS/HPLOT/3DNULL [ xmin xmax ymin ymax zmin zmax theta phi chopt ]

XMIN R Low range in X D=0.
XMAX R High range in X D=1.
YMIN R Low range in Y D=0.
YMAX R High range in Y D=1.
ZMIN R Low range in Z D=0.
ZMAX R High range in Z D=1.
THETA R Angle THETA in degrees D=30.
PHI R Angle PHI in degrees D=30.
CHOPT C Options D='WFB'

CHOPT:

'' '' Redefine the scale for the current zone.
'B' Draw the back box
'F' Draw the front box
'W' Start a new window

Define an empty 3D space of coordinates. If XMIN, XMAX, etc. are given, draw a frame box with the window coordinates set to XMIN, XMAX, YMIN, YMAX. Axis labels and tick marks are drawn by default.