Chapter 7: Quick Plots

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

The following rules are applied to quick plots:

Additional note:

7.1 The PLOT Command

The command PLOT makes a quick plot of two or more floating point arrays.

The call is: PLOT xray1, yray1 [,xray2, yray2, ... , xrayn, yrayn]

xray1, yray1 are floating point arrays.

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

7.2 The SCATTR Command

The command SCATTR makes a quick plot of two or more floating point arrays where the points are marked with symbols.

The call is: SCATTR xray1, yray1 [,xray2, yray2, ... , xrayn, yrayn]

xray1, yray1 are floating point 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 floating point 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 floating point arrays containing X- and Y- coordinates of rectangle corners.
x2ray, y2ray are floating point arrays containing the opposite rectangle corners.
zray is a floating point 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 floating point array with m rows and n columns.
xray is a floating point 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 floating point 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 floating point array with nx rows and ny columns.
xray is a floating point 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 floating point 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 floating point array with nx rows and ny columns.
xray is a floating point 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 floating point 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 floating point array with nx rows and ny columns.
xray is a floating point 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 floating point 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 floating point 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 floating point array with nx rows and ny columns.
xray is a floating point 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 floating point 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 floating point array containing the levels. If zlvray is missing, 10 levels between the minimum and maximum of zmat will be generated.

7.10 Scaling of Quick Plots

Normally, quick plots 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.

Analogue: Y-axis, Z-axis.

Additional note:

7.11 Quick Plot Variables

There is a set of variables that can modify the appearance of quick plots. 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).

Additional note:

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


Next | Previous | Contents