Chapter 7: Quickplots

This chapter presents quickplots that are collections of DISLIN routines to display data with one command.

The following rules are applied to quickplots:

Note:

7.1 The PLOT Command

The command PLOT makes a quickplot of two or more floatingpoint arrays.
The call is:
PLOT xray1, yray1 [,xray2, yray2, ... , xrayn, yrayn]

xray1, yray1
are floatingpoint arrays.

Example:
x = falloc (100)
plot x, sin (x), x, cos (x)

7.2 The SCATTR Command

The command SCATTR makes a quickplot of two or more floatingpoint arrays where the points are marked with symbols.
The call is:
SCATTR xray1, yray1 [,xray2, yray2, ... , xrayn, yrayn]

xray1, yray1
are floatingpoint arrays.

7.3 The PLOT3 Command

The command PLOT3 makes a 3-D colour plot.
The call is:
PLOT3 xray, yray, zray
xray, yray, zray
are floatingpoint arrays containing X-, Y- and Z-coordinates.

7.4 The PLOT3R Command

The command PLOT3R makes a 3-D colour plot where the data are specified as rectangles.
The call is:
PLOT3R x1ray, y1ray, x2ray, y2ray, zray
x1ray, y1ray
are floatingpoint arrays containing X- and Y- coordinates of rectangle corners.
x2ray, y2ray
are floatingpoint arrays containing the opposite rectangle corners.
zray
is a floatingpoint array containing Z-coordinates.

7.5 The SURF3 Command

The command SURF3 makes a 3-D colour plot of a matrix. The columns of the matrix will be plotted as rows.
The call is:
SURF3 zmat [,xray [, yray]]
zmat
is a two-dimensional floatingpoint array with m rows and n columns.
xray
is a floatingpoint array with the dimension m. It will be used to position the rows of zmat. If xray is missing, an array with the values { 0.5, 1.5, ..., m - 0.5} will be used.
yray
is a floatingpoint array with the dimension n. It will be used to position the columns of zmat. If yray is missing, an array with the values { 0.5, 1.5, ..., n - 0.5} will be used.

7.6 The SURFACE Command

The command SURFACE makes a surface plot of a matrix.
The call is:
SURFACE zmat [,xray, yray]
zmat
is a two-dimensional floatingpoint array with nx rows and ny columns.
xray
is a floatingpoint array with the dimension nx. It will be used to position the rows of zmat. If xray is missing, an array with the values {0., 1., ..., nx - 1} will be used.
yray
is a floatingpoint array with the dimension ny. It will be used to position the columns of zmat. If yray is missing, an array with the values {0., 1., ..., ny - 1} will be used.

7.7 The SURSHADE Command

The command SURSHADE makes a shaded surface plot of a matrix.
The call is:
SURSHADE zmat [,xray, yray]
zmat
is a two-dimensional floatingpoint array with nx rows and ny columns.
xray
is a floatingpoint array with the dimension nx. It will be used to position the rows of zmat. If xray is missing, an array with the values {0., 1., ..., nx - 1} will be used.
yray
is a floatingpoint array with the dimension ny. It will be used to position the columns of zmat. If yray is missing, an array with the values {0., 1., ..., ny - 1} will be used.

7.8 The CONTOUR Command

The command CONTOUR makes a contour plot of a matrix.
The call is:
CONTOUR zmat [,xray, yray, zlvray]
or:
CONTOUR zmat, zlvray
zmat
is a two-dimensional floatingpoint array with nx rows and ny columns.
xray
is a floatingpoint array with the dimension nx. It will be used to position the rows of zmat. If xray is missing, an array with the values {0., 1., ..., nx - 1} will be used.
yray
is a floatingpoint array with the dimension ny. It will be used to position the columns of zmat. If yray is missing, an array with the values {0., 1., ..., ny - 1} will be used.
zlvray
is a floatingpoint array containing the levels. If zlvray is missing, 10 levels between the minimum and maximum of zmat will be generated.

7.9 The CONSHADE Command

The command CONSHADE makes a shaded contour plot of a matrix.
The call is:
CONSHADE zmat [,xray, yray, zlvray]
or:
CONSHADE zmat, zlvray
zmat
is a two-dimensional floatingpoint array with nx rows and ny columns.
xray
is a floatingpoint array with the dimension nx. It will be used to position the rows of zmat. If xray is missing, an array with the values {0., 1., ..., nx - 1} will be used.
yray
is a floatingpoint array with the dimension ny. It will be used to position the columns of zmat. If yray is missing, an array with the values {0., 1., ..., ny - 1} will be used.
zlvray
is a floatingpoint array containing the levels. If zlvray is missing, 10 levels between the minimum and maximum of zmat will be generated.

7.10 Scaling of Quickplots

Normally, quickplots are scaled automatically in the range of the data. This behaviour can be changed if certain variables are defined.

The variables for the X-axis are:

  1. If the system variables %XMIN and %XMAX are defined, the X-axis will be scaled automatically in the range %XMIN, %XMAX.
  2. If the system variables %XMIN, %XMAX, %XOR and %XSTEP are defined, the scaling and labeling of the X-axis is completly defined by the user.
  3. If the system variable %XAUTO is defined and set to 1, the variables %XMIN, %XMAX, %XOR and %XSTEP will be ignored and scaling will be done automatically in the range of the data.

Analog:
Y-axis, Z-axis.

Note:
For logarithmic scaling, the parameters must be exponents of base 10.

7.11 Quickplot Variables

There is a set of variables that can modify the appearance of quickplots. The corresponding DISLIN routines are given in parenthesis.
%X
defines the X-axis title (NAME).
%Y
defines the Y-axis title (NAME).
%Z
defines the Z-axis title (NAME).

%T1
defines line 1 of the axis system title (TITLIN).
%T2
defines line 2 of the axis system title (TITLIN).
%T3
defines line 3 of the axis system title (TITLIN).
%T4
defines line 4 of the axis system title (TITLIN).

%XTIC
sets the number of ticks for the X-axis (TICKS).
%YTIC
sets the number of ticks for the Y-axis (TICKS).
%ZTIC
sets the number of ticks for the Z-axis (TICKS).

%XDIG
sets the number of digits for the X-axis (LABDIG).
%YDIG
sets the number of digits for the Y-axis (LABDIG).
%ZDIG
sets the number of digits for the Z-axis (LABDIG).

%XSCL
defines the scaling of the X-axis (AXSSCL).
%YSCL
defines the scaling of the Y-axis (AXSSCL).
%ZSCL
defines the scaling of the Z-axis (AXSSCL).

%XLAB
defines the labels of the X-axis (LABELS).
%YLAB
defines the labels of the Y-axis (LABELS).
%ZLAB
defines the labels of the Z-axis (LABELS).

%H
defines the character size (HEIGHT).
%HNAME
defines the size of axis titles (HNAME).
%HTITLE
defines the size of the axis sytem title (HTITLE).

%XPOS
defines the X-Position of the axis system (AXSPOS).
%YPOS
defines the Y-Position of the axis system (AXSPOS).

%XLEN
defines the size of an axis system in X-direction (AXSLEN).
%YLEN
defines the size of an axis system in Y-direction (AXSLEN).
%ZLEN
defines the size of an axis system in Z-direction (AX3LEN).

%POLCRV
defines an interpolation method used by CURVE (POLCRV).
%INCMRK
defines line or symbol mode for CURVE (INCMRK).
%MARKER
selctes a symbol for CURVE (MARKER).
%HSYMBL
defines the size of symbols (HSYMBL).

%XRES
sets the width of points plotted by PLOT3 (SETRES).
%YRES
sets the height of points plotted by PLOT3 (SETRES).

%X3VIEW
sets the X-position of the viewpoint in absolut 3-D coordinates (VIEW3D).
%Y3VIEW
sets the Y-position of the viewpoint in absolut 3-D coordinates (VIEW3D).
%Z3VIEW
sets the Z-position of the viewpoint in absolut 3-D coordinates (VIEW3D).

%X3LEN
defines the X-axis length of the 3-D box (AXIS3D).
%Y3LEN
defines the Y-axis length of the 3-D box (AXIS3D).
%Z3LEN
defines the Z-axis length of the 3-D box (AXIS3D).

%VTITLE
defines vertical shifting for the axis system title (VKYTIT).
%CONSHD
selects an algorithm used for contour filling (SHDMOD).

Note:
The variables can also be used, to initalize plotting parameters in DISINI.

Example:
%X = 'X-axis'
%Y = 'Y-axis'
xray = falloc (10)
plot xray, xray

Next | Previous | Contents