1. Home
  2. PEN directive

PEN directive

Defines the properties of “pens” for high-resolution graphics.

Options

RESET = string token Whether to reset the pen definitions to their default values (yes, no); default no
BOXUNITS = string token Units to use for text boxes (characters, distance); the default is to retain the existing setting

Parameters

NUMBER = scalars Numbers associated with the pens
COLOUR = texts or scalars Colour to use with each pen unless otherwise specified by the CSYMBOL, CLINE, CFILL or CAREA parameters
LINESTYLE = texts or scalars Style for line used by each pen when joining points
METHOD = string tokens Method for determining line (point, line, monotonic, closed, open, fill, spline, polygon)
SYMBOL = texts, scalars, pointers or matrices Defines the plotting symbol for each pen, by a text or scalar for a pre-defined symbol, a pointer for a user-defined symbol, or a matrix to supply a bitmap
LABELS = texts or factors Define labels that will be printed alongside the plotting symbols
ROTATION = scalars or variates Rotation required for the plotting symbols and labels (in degrees)
JOIN = string tokens Order in which points are to be joined by each pen (ascending, given)
BRUSH = scalars Number of the type of area filling used with each pen when drawing pie charts or histograms
FONT = texts or scalars Font to be used for any text written by each pen
THICKNESS = scalars Thickness with which any lines are drawn by each pen
SIZEMULTIPLIER = scalars or variates Multiplier used in the calculation of the size in which to draw symbols and labels by each pen unless otherwise specified by SMSYMBOL or SMLABEL
CSYMBOL = texts or scalars Colour to use with each pen when drawing symbols
CLINE = texts or scalars Colour to use with each pen when drawing lines
CFILL = texts or scalars Colour to use with each pen when filling areas inside hollow symbols
CAREA = texts or scalars Colour to use with each pen when filling areas inside polygons and bars of histograms
SMSYMBOL = scalars or variates Multiplier used in the calculation of the size in which to draw symbols by each pen
SMLABEL = scalars or variates Multiplier used in the calculation of the size in which to draw labels by each pen
DFSPLINE = scalars Number of degrees of freedom to use when METHOD=spline
YMISSING = string token How to treat missing y-values when METHOD=spline (break, interpolate)
XMISSING = string token How to treat missing x-values when METHOD=spline (break, ignore)
YLPOSITION = string token How to position labels in the y-direction with respect to the points (above, centre, below, automatic)
XLPOSITION = string token How to position labels in the x-direction with respect to the points (left, centre, right, automatic)
YLSIZE = scalars or variates Sizes of the y-direction of the text boxes into which to plot labels
XLSIZE = scalars or variates Sizes of the x-direction of the text boxes
YLOFFSET = scalars or variates Offsets in the y-direction of the text boxes
XLOFFSET = scalars or variates Offsets in the x-direction of the text boxes
BARTHICKNESS = scalars Thickness with which any error bars are drawn by each pen
BARCAPWIDTH = scalars Width of the cap drawn by each pen at the top and bottom of any error bars
DESCRIPTION = texts Description for points plotted by the pen, to be used by the Data Information tool in the Graphics Viewer
TSYMBOL = scalars Defines the transparency of symbols drawn by each pen, on a scale of 0 (opaque) to 255 (completely transparent)
TLINE = scalars Defines the transparency of lines drawn by each pen
TFILL = scalars Defines the transparency to use when filling areas inside hollow symbols with each pen
TAREA = scalars Defines the transparency to use when filling areas inside polygons and bars of histograms with each pen
SAVE = pointers Saves details of the current settings for the pen concerned

Description

Graphical displays are drawn using graphical pens. The graphics commands each have particular pens that they use by default, but most allow you to specify alternatives (see DGRAPH, D3GRAPH, DCONTOUR, DHISTOGRAM etc). The attributes of the pens, such as colour, font and symbol-type, determine how the plots are generated. The PEN directive allows you to change these attributes, so that you can modify the resulting display. Different attributes are relevant for different types of plot: for example symbols and labels are used only within DGRAPH and D3GRAPH (and the graphics procedures that use them to construct their plots).

The NUMBER parameter lists the numbers of the pens, in the range 1 to 256 or -1 to -12, that you wish to redefine. By default, any aspects of these pens that are not set explicitly retain the values that they had immediately before the PEN statement. Alternatively, you can specify option RESET=yes to reset their definitions to the default values defined by Genstat at the start of each job.

Pens 1 to 256 are used for the information that is plotted in a graph (points, lines, and so on). In most of the graphics commands, the default is to use these pens in succession for the different structures that are plotted, so that the various data sets can easily be distinguished. The negatively numbered pens are used as the initial defaults for the axes and their associated marks and labels (see XAXIS), or for gridlines, overall title and key (see FRAME), or for default gridlines in shade plots (see DSHADE), or for default outlines in histograms, bar charts and pie charts (see DHISTOGRAM, BARCHART and DPIE), or for error bars (see BARCHART), or for the overall title (see DSTART). Details are given in the Methods Section below. They cannot be used for any other purposes.

The COLOUR, CSYMBOL, CLINE, CFILL and CAREA parameters specify the colours to be used by the pen. The COLOUR parameter defines the colour for everything plotted by the pen apart from the colour for filling “hollow” symbols (e.g. a circle but not a cross), while the other parameters define specific aspects (overriding any setting of COLOUR): CSYMBOL defines the colour to be used for drawing symbols, CLINE defines the colour for lines, CFILL defines the colour for filling areas inside “hollow” symbols, and CAREA defines the colour for filling areas inside polygons and bars of histograms. The parameters can be set any of the following: a text containing the name of one of Genstat’s pre-defined colours; a scalar containing a number defining a colour using the RGB system; or a hexadecimal digit defined in a string of the form '#rgb', '0xrgb' or '0Xrgb' where rgb are the pairs of hexadecimal digits 00-FF that give the red, green and blue intensities of the colour respectively. For example, '#FF0000', '#00FF00' and '#0000FF' give pure red, green and blue respectively. The leading zeros can be dropped, so '#FF00' and '#FF' also define green and blue respectively. You can use the RGB function to construct these colour numbers from their red, green and blue components: for example

CALCULATE xgold = RGB(255; 215; 0)

PEN 2; CSYMBOL=xgold

sets xgold to the colour gold (which has red, green and blue values 255, 215 and 0 respectively), and uses this as the colour for symbols drawn by pen 2. The numbers give you access to the complete spectrum supported by most colour graphics devices. (Note, though, that the colours are mapped automatically onto a grey scale if the device is defined with a grey-scale palette; see DEVICE). Alternatively, the pre-defined colours define the standard colours used by many web browsers, and mainly use the same names. The names, and their corresponding red, green and blue values, are listed in Methods section. They can be given in either upper or lower case, or in any mixture, but they must not be abbreviated.

There are two special strings that can be used for colours. The string 'background' uses the colour defined in the BACKGROUND option or parameter of FRAME. The string 'match' which can be used with CFILL to take the colour from CSYMBOL, or with CAREA to take the colour from CLINE. For example,

PEN 1,2,3; COLOUR='red','blue','green'; CFILL='match'
PEN 4,5,6; CLINE='red','blue','green'; CAREA='match'

plots filled symbols in the same colour as their outlines for pens 1 to 3, and filled areas in the same colour as their outlines for pens 4 to 5. Note, COLOUR sets all of CSYMBOL, CLINE and CAREA to the same value, so you only need to set CFILL='match' to set all colours of a pen to the same value. Also, if you want all your symbols filled, you could specify

PEN 1...256; CFILL='match'

You can also use the number −1 to specify the background colour. A missing value represents a hollow symbol for CFILL or the background colour for CSYMBOL, CLINE and CAREA.

The TSYMBOL, TLINE, TFILL and TAREA parameters accompany the parameters CSYMBOL, CLINE, CFILL and CAREA, respectively, and define the transparency of the corresponding colours. Their values can range from 0 (opaque) to 255 (completely transparent). The pens all have initial defaults of 0 for the transparencies.

The SYMBOL parameter defines the symbol that is drawn at each point, for example by DGRAPH. You can mark different points with different symbols (for example to indicate groupings in the data) by setting the PEN parameter of DGRAPH to a variate or factor specifying a pen with the appropriate symbol for each point.

Genstat provides a choice of standard symbols, listed below, that can be specified either by giving the name (in a text with a single value), or the number (in a scalar).

1    'Cross'
2    'Circle'
3    'Plus'
4    'Star'
5    'Square'
6    'Diamond'
7    'Triangle'
8    'Nabla'
9    'Asterisk'
10  'Minus'
11  'Heavyminus'
12  'Heavyplus'
13  'Heavycross'
14  'Smallcircle'
15  'Tinycircle'
16  'Female'
17  'Male'
18  'Rhombus
19  'Circlecross
20  'Circleplus'
21  'Squarecross'
22  'Squareplus'
-1   'Sphere'
-2   'Cone'
-3   'Cylinder
-4   'Cube'

The final four symbols (numbered -1 to -4) are intended mainly for 3-dimensional plots, and may not be available on some devices. You can set SYMBOL='none' or SYMBOL=0 if you do not want to plot symbols at the data points, as for example if you only want to draw a line through the points. You can also use SYMBOL=0 together with the LABELS parameter (described below) to plot a character at the data points instead of a symbol. For example

PEN 1; SYMBOL='none'; LABEL='A'

or

PEN 1; SYMBOL=0; LABEL='A'

will identify the points plotted by pen 1 with the letter A.

To define a symbol of your own, you can set SYMBOL to a pointer containing a pair of variates defining the coordinates of a set of points to be joined by straight line segments. The points should be within a notional square with bounds -1.0 to 1.0 in each direction. The square is centred on the data point, and scaled to the same size as the standard symbols. Missing values can be included in the coordinates, to use separate pen strokes to draw the line segments. The final possibility is to set SYMBOL to a matrix of RGB colour values, representing a bitmap.

The LABELS parameter allows you to label each point with a string or number. You can set it to a text structure to specify strings to be plotted at each point. If the text has a single string, this will be be plotted at every point; otherwise the text must have the same number of values as the Y and X variates that are to be plotted. You can also set LABELS to a factor. If the factor has labels, then these are used; otherwise the points are labelled by its levels. This provides another way of representing grouped data.

The positioning of the labels with respect to the points is controlled by the YLPOSITION and XLPOSITION parameters. The initial default is to determine the positions automatically according to their type (e.g. labels for points, or for tick marks on the y-axis, or on the x-axis, and so on). The labels are plotted into text boxes whose widths in the x- and y-directions can be defined by the YLSIZE and XLSIZE parameters; if these are not set, the boxes are defined to plot the labels as a single line of characters. The amounts by which the boxes are offset in the the x- and y-directions can be defined by the YLOFFSET and XLOFFSET parameters; if these are not set, the positions of the boxes are defined automatically as appropriate for the positions defined by the YLPOSITION and XLPOSITION parameters. The BOXUNITS option defines what units to use when defining the sizes and positions of the text boxes. The initial default is to measure these in numbers of characters of an average width in the defined font and size (see parameters FONT and SMLABEL), but you can set option BOXUNITS=distance to use the distances as defined by the axes of the graph.

The graphical symbols are drawn so that they are centred at the specified position. If LABELS are specified they are aligned alongside the markers, unless you have set SYMBOL=0 to suppress the markers, in which case the labels start from the specified (x,y) position. For compatibility with previous releases of Genstat you can also set SYMBOL to a factor, which has the same effect as setting LABELS with SYMBOL=0.

The Genstat Graphics Viewer with Genstat for Windows has a “Data Information” tool that allows you to display information about each point when you place the cursor over the point. If you want to replace the default information, you can set the DESCRIPTION parameter to a text (with one line for each point) containing your own information.

The METHOD parameter specifies the type of object to be plotted: points, lines or filled polygons. The initial default for every pen, METHOD=point, will result in points being plotted using the corresponding symbols, labels, colours and fonts. Various types of line can be drawn through the plotted points; either straight lines (line and polygon) or smooth curves (monotonic, open, closed and spline). The line and polygon settings differ in that, with polygon, a line is drawn also to connect the first and last points. The monotonic setting specifies that a smooth single-valued curve is to be drawn through the data points. The name is derived from the requirement that the x-values (rather than the fitted curve) must be strictly monotonic, so that there is only one y-value for each distinct x-value. To ensure this, a copy of the data is made and sorted before the curve is fitted. This setting is recommended for plotting curves fitted to data, for example with FITCURVE. You should ensure that the points are close enough for the plotted line to be a reasonable approximation. When you know the functional form of the curve, it may be advantageous to calculate extra points. The open and closed settings specify that a smooth, possibly multi-valued, curve is to be drawn through the data points, using the method of McConalogue (1970); the resulting curve is rotationally invariant, although it is not invariant under scaling. The closed setting connects the last point to the first. McConalogue’s method (open or closed) is more suited to the situation where the plotted curve is intended to represent the shape of an object. Alternatively, the spline setting plots a smoothing spline fitted through the points. The DFSPLINE parameter specifies how many degrees of freedom to use in the spline (initial default 4). The YMISSING parameter controls whether to break the spline at a missing y-value or to interpolate y-value, and the XMISSING parameter controls whether to break the spline at a missing x-value or to ignore the point; the initial default for both parameters is to break the spline. The setting METHOD=fill joins the data points by straight lines to produce one or more polygons. Each polygon is then shaded in the style specified by BRUSH (see below). The plotting method also determines how contours will be drawn. Also, the combination of SYMBOL=0 and METHOD=point will produce no plotting at all (and no warning) within DGRAPH.

If the requested plotting method produces a line through the points, the LINESTYLE parameter will specify what sort of line is drawn (for example a solid, dotted or dashed line). The type of style can be specified either by giving the name (in a text with a single value), or the number (in a scalar).

1    'Solid'

2    'Dot' or '.'

3    'Dash' or '-'

4    'Dotdash' or '.-'

5    'Tightdash' or 'T-'

6    'Longdash' or 'L-'

7    'Shortdash' or 'S-'

8    'Closedot' or 'C-'

9    'Finedot' or 'F.'

10  'Doubledotdash' or '..-'

Each text can all be abbreviated to the minimum number of characters required to distinguish it from the earlier styles.

The JOIN parameter controls the order in which points are connected when lines are to be drawn or the points define a polygon to be shaded. Given requests that the data are to be plotted in the order in which they are stored, whereas ascending implies that the data are copied and sorted so that the x-values are in ascending order before plotting. This parameter is ignored when METHOD=monotonic, as this requires that the data must always be sorted.

The BRUSH parameter controls how areas are shaded when METHOD is set to fill, or when plotting histograms and pie charts. There are 16 available patterns indicated by the integers 1 to 16. In general, the higher the number, the denser the hatching, and the longer such areas take to plot. The device-specific brush styles are generally faster, and produce smaller output files; however results are not guaranteed to be the same on every type of device. The CFILL parameter defines which colour is used by the pen to fill the areas.

The THICKNESS parameter allows you to specify an amount by which the standard thickness of plotted lines is to be multiplied. This allows you to increase the thickness of lines, perhaps to highlight some feature of a plot. You can also use thickness to emphasize the axes, by redefining the appropriate pen. For some devices, it is not possible to control the thickness of plotted lines; the THICKNESS parameter is then ignored. Similarly, the BARTHICKNESS parameter can provide a multiplier for the line thickness when the pen is used to draw an error bar, and the BARCAPWIDTH parameter can give a multiplier to adjust the standard width of the lines at the top and bottom of error bars.

The default sizes of symbols and the characters in labels are determined from the dimensions of the current window. The SIZEMULTIPLIER parameter can be used to modify the sizes of both of these, by specifying a value by which this default size is to be multiplied. Alternatively, you can use the SMSYMBOL parameter to modify just the symbol size, or the SMLABEL parameter to modify just the size of characters in labels. For example when plotting a graph in a small window you may wish to increase the size of annotation in order to make it legible. They can each be set to a scalar, or to a variate to allow the different points to be scaled in different ways.

The ROTATION parameter controls the angle (in degrees) at which to plot text or user-defined symbols. The initial setting of zero will produce text “conventionally” orientated. You can set ROTATION to a scalar value that will apply to all points, or to a variate that allows a different angle to be used at each point.

The FONT parameter defines the font family to be used by each pen to plot textual information, for example, in titles, axis annotation, plotting symbols and keys. This can be set to a text containing the name of a font family, or to a scalar containing an integer between 1 and 25. The initial default for each pen is to use the default graphics font, which can be defined either by using menus in the Genstat Client or Graphics Viewer, or by using the DFONT directive. You can find out the names of the fonts, available to specify in a text, by looking at any of the controls for specifying fonts in the Client or Graphics Viewer. The integers refer to fonts that should always be available. You can list these using the DHELP procedure. Font 1 has a special status, in that it automatically maps to the currently-defined default graphics font. If you change the default graphics font, this will be used as the default font in any graphs that are then displayed or redisplayed, including those that have been stored in Genstat graphics meta files (i.e. files with the gmf suffix). If you specify a font that is unavailable on your computer, the default font is used instead.

The current settings of each pen can be saved in a pointer supplied by the SAVE parameter. The elements of the pointer are labelled to identify the components. Initial default settings are represented by missing values; the actual values used for these attributes when plotting will depend on the output device.

Options: RESET, BOXUNITS.

Parameters: NUMBER, COLOUR, LINESTYLE, METHOD, SYMBOL, LABELS, ROTATION, JOIN, BRUSH, FONT, THICKNESS, SIZEMULTIPLIER, CSYMBOL, CLINE, CFILL, CAREA, SMSYMBOL, SMLABEL, DFSPLINE, YMISSING, XMISSING, YLPOSITION, XLPOSITION, YLSIZE, XLSIZE, YLOFFSET, XLOFFSET, BARTHICKNESS, BARCAPWIDTH, DESCRIPTION, TSYMBOL, TLINE, TFILL, TAREA, SAVE.

Method

The names of the standard pre-defined colours are listed below with their corresponding red, green and blue values for use e.g. in the RGB function.

Red colors

IndianRed RGB(205; 92; 92)
LightCoral RGB(240; 128; 128)
Salmon RGB(250; 128; 114)
DarkSalmon RGB(233; 150; 122)
LightSalmon RGB(255; 160; 122)
Crimson RGB(220; 20; 60)
Red RGB(255; 0; 0)
FireBrick RGB(178; 34; 34)
DarkRed RGB(139; 0; 0)

Pink colors

Pink RGB(255; 192; 203)
LightPink RGB(255; 182; 193)
HotPink RGB(255; 105; 180)
DeepPink RGB(255; 20; 147)
MediumVioletRed RGB(199; 21; 133)
PaleVioletRed RGB(219; 112; 147)

Orange colors

LightSalmon RGB(255; 160; 122)
Coral RGB(255; 127; 80)
Tomato RGB(255; 99; 71)
OrangeRed RGB(255; 69; 0)
DarkOrange RGB(255; 140; 0)
Orange RGB(255; 165; 0)

Yellow colors

Gold RGB(255; 215; 0)
Yellow RGB(255; 255; 0)
LightYellow RGB(255; 255; 224)
LemonChiffon RGB(255; 250; 205)
LightGoldenrodYellow RGB(250; 250; 210)
PapayaWhip RGB(255; 239; 213)
Moccasin RGB(255; 228; 181)
PeachPuff RGB(255; 218; 185)
PaleGoldenrod RGB(238; 232; 170)
Khaki RGB(240; 230; 140)
DarkKhaki RGB(189; 183; 107)

Purple colors

Lavender RGB(230; 230; 250)
Thistle RGB(216; 191; 216)
Plum RGB(221; 160; 221)
Violet RGB(238; 130; 238)
Orchid RGB(218; 112; 214)
Fuchsia RGB(255; 0; 255)
Magenta RGB(255; 0; 255)
MediumOrchid RGB(186; 85; 211)
MediumPurple RGB(147; 112; 219)
BlueViolet RGB(138; 43; 226)
DarkViolet RGB(148; 0; 211)
DarkOrchid RGB(153; 50; 204)
DarkMagenta RGB(139; 0; 139)
Purple RGB(128; 0; 128)
Indigo RGB( 75; 0; 130)
SlateBlue RGB(106; 90; 205)
DarkSlateBlue RGB( 72; 61; 139)

Green colors

GreenYellow RGB(173; 255; 47)
Chartreuse RGB(127; 255; 0)
LawnGreen RGB(124; 252; 0)
Lime RGB( 0; 255; 0)
LimeGreen RGB( 50; 205; 50)
PaleGreen RGB(152; 251; 152)
LightGreen RGB(144; 238; 144)
MediumSpringGreen RGB( 0; 250; 154)
SpringGreen RGB( 0; 255; 127)
MediumSeaGreen RGB( 60; 179; 113)
SeaGreen RGB( 46; 139; 87)
ForestGreen RGB( 34; 139; 34)
Green RGB( 0; 128; 0)
DarkGreen RGB( 0; 100; 0)
YellowGreen RGB(154; 205; 50)
OliveDrab RGB(107; 142; 35)
Olive RGB(128; 128; 0)
DarkOliveGreen RGB( 85; 107; 47)
MediumAquamarine RGB(102; 205; 170)
DarkSeaGreen RGB(143; 188; 143)
LightSeaGreen RGB( 32; 178; 170)
DarkCyan RGB( 0; 139; 139)
Teal RGB( 0; 128; 128)

Blue colors

Aqua RGB( 0; 255; 255)
Cyan RGB( 0; 255; 255)
LightCyan RGB(224; 255; 255)
PaleTurquoise RGB(175; 238; 238)
Aquamarine RGB(127; 255; 212)
Turquoise RGB( 64; 224; 208)
MediumTurquoise RGB( 72; 209; 204)
DarkTurquoise RGB( 0; 206; 209)
CadetBlue RGB( 95; 158; 160)
SteelBlue RGB( 70; 130; 180)
LightSteelBlue RGB(176; 196; 222)
PowderBlue RGB(176; 224; 230)
LightBlue RGB(173; 216; 230)
PurwaBlue RGB(155; 225; 255)
SkyBlue RGB(135; 206; 235)
LightSkyBlue RGB(135; 206; 250)
DeepSkyBlue RGB( 0; 191; 255)
DodgerBlue RGB( 30; 144; 255)
CornflowerBlue RGB(100; 149; 237)
MediumSlateBlue RGB(123; 104; 238)
RoyalBlue RGB( 65; 105; 225)
Blue RGB( 0; 0; 255)
MediumBlue RGB( 0; 0; 205)
DarkBlue RGB( 0; 0; 139)
Navy RGB( 0; 0; 128)
MidnightBlue RGB( 25; 25; 112)

Brown colors

Cornsilk RGB(255; 248; 220)
BlanchedAlmond RGB(255; 235; 205)
Bisque RGB(255; 228; 196)
NavajoWhite RGB(255; 222; 173)
Wheat RGB(245; 222; 179)
BurlyWood RGB(222; 184; 135)
Tan RGB(210; 180; 140)
RosyBrown RGB(188; 143; 143)
SandyBrown RGB(244; 164; 96)
Goldenrod RGB(218; 165; 32)
DarkGoldenrod RGB(184; 134; 11)
Peru RGB(205; 133; 63)
Chocolate RGB(210; 105; 30)
SaddleBrown RGB(139; 69; 19)
Sienna RGB(160; 82; 45)
Brown RGB(165; 42; 42)
Maroon RGB(128; 0; 0)

White colors

White RGB(255; 255; 255)
Snow RGB(255; 250; 250)
Honeydew RGB(240; 255; 240)
MintCream RGB(245; 255; 250)
Azure RGB(240; 255; 255)
AliceBlue RGB(240; 248; 255)
GhostWhite RGB(248; 248; 255)
WhiteSmoke RGB(245; 245; 245)
Seashell RGB(255; 245; 238)
Beige RGB(245; 245; 220)
OldLace RGB(253; 245; 230)
FloralWhite RGB(255; 250; 240)
Ivory RGB(255; 255; 240)
AntiqueWhite RGB(250; 235; 215)
Linen RGB(250; 240; 230)
LavenderBlush RGB(255; 240; 245)
MistyRose RGB(255; 228; 225)

Grey colors

Gainsboro RGB(220; 220; 220)
LightGray or LightGrey RGB(211; 211; 211)
Silver RGB(192; 192; 192)
DarkGray or DarkGrey RGB(169; 169; 169)
Gray or Grey RGB(128; 128; 128)
DimGray or DimGrey RGB(105; 105; 105)
LightSlateGray or LightSlateGrey RGB(119; 136; 153)
SlateGray or SlateGrey RGB(112; 128; 144)
DarkSlateGray or DarkSlateGrey RGB( 47; 79; 79)
Black RGB( 0; 0; 0)

In addition, the string Background can be used to refer to the background colour that has been defined (e.g. by FRAME) for the particular part of the screen where the pen is being used, and the string Transparent can be used for example to define a colour that will not obscure anything that is plotted below it (e.g. in another window). Alternatively, you can define the colour intensity with three pairs of hexadecimal digits (00-FF), by using a string that starts with either #, 0x or # and then contains the three pairs of digits: i.e. you can specify either '#rgb', '0xrgb' or '0Xrgb', where rgb are the pairs of hexadecimal digits that give the red, green and blue intensities of the colour respectively..

The roles of the negatively-numbered pens are listed below:

-1      initial default for PENTITLE parameter of XAXIS, YAXIS and ZAXIS

-2      initial default for PENAXIS parameter of XAXIS, YAXIS and ZAXIS

-3      initial default for PENLABEL parameter of XAXIS, YAXIS and ZAXIS

-4      initial default for PENGRID parameter of FRAME

-5      initial default for PENTITLE parameter of FRAME

-6      initial default for PENKEY parameter of FRAME

-7      default for PENGRID option of DSHADE

default for PENGRID option of DBITMAP

-8      default for PENOUTLINE option of DHISTOGRAM

-9      default for PENOUTLINE option of BARCHART

-10    default for PENOUTLINE option of DPIE

-11    default for XBARPEN and YBARPEN parameters of DGRAPH

default for PENERRORBARS parameter of BARCHART

-12    pen for title in DSTART

Reference

McConalogue, D.J. (1970). A quasi-intrinsic scheme for passing a smooth curve through a discrete set of points. Computer Journal, 13, 392-396.

See also

Directives: DFONT, DLOAD, DSAVE, COLOUR.

Procedures: DHELP, GETRGB.

Functions: BLUE, GREEN, GRAY, GREY, RED, RGB.

Commands for: Graphics.

Example

" Example DGRA-1: Draw a scatter plot"

" File DGRA-1.DAT contains data on deaths from lung cancer and smoking
  rates in 11 countries in 1930, from a US report in 1964."

" Read the data recorded in the file."
FILEREAD [NAME='%gendir%/examples/DGRA-1.DAT'] country,deaths,cigarettes

" Display the data in a high-resolution graph."
TEXT cancer; VALUES='Lung cancer and smoking in 1930'
DGRAPH [TITLE=cancer; WINDOW=3; KEYWINDOW=0] deaths; cigarettes

" Add the axis titles and bounds, and a grid."
XAXIS WINDOW=3; TITLE='Cigarettes per man per year'; LOWER=0
YAXIS WINDOW=3; TITLE='Deaths per million'; LOWER=0
FRAME [GRID=xy] WINDOW=3
DGRAPH [TITLE=cancer; WINDOW=3; KEYWINDOW=0] deaths; cigarettes

" Specify the axis labelling precisely."
XAXIS WINDOW=3; MARKS=!(0,300...1500)
YAXIS WINDOW=3; MARKS=!(0,100...500); NSUBTICKS=3
DGRAPH [TITLE=cancer; WINDOW=3; KEYWINDOW=0] deaths; cigarettes

" Label the points with the names of the countries."
PEN 1; LABELS=country; SYMBOLS=0
DGRAPH [TITLE=cancer; WINDOW=3; KEYWINDOW=0] deaths; cigarettes; PEN=1

" Fit a linear regression line (assuming variance proportional
  to the square of the mean) to the relationship and
  add the fitted line to the graph."
MODEL [DISTRIBUTION=gamma; LINK=identity] deaths
FIT [PRINT=*] cigarettes
RKEEP FITTEDVALUES=fit
PEN 2; METHOD=line; SYMBOLS=0; CLINE=2
DGRAPH [SCREEN=keep; WINDOW=3; KEYWINDOW=0] fit; cigarettes; PEN=2
Updated on October 28, 2020

Was this article helpful?