This section describes functions from file plotmtv.ct.
[] = annotate(primitive...)
annotate("primitive"[,options]) adds MTV annotations to the previous
graph. The plot command(s) and the annotate command(s) must appear
inside hold(on) ... hold(off) in order to work correctly.
--------------------------------------------
Here may be the proper place to list the most frequently used
PlotMTV options. These are used by giving them as optional args
(option-value pairs) to graphics functions. See the PlotMTV data
format definition (DataFormat.ps) for all the available options.
Option name(s) Possible value(s) Explanation
"xlabel" string X-axis label
"ylabel" string Y-axis label
"zlabel" string Z-axis label
"toplabel" string Plot title
"subtitle" string Text below title
"comment" string Text on right corner
"xmin","xmax" real number X-axis min,max
"ymin","ymax" real number Y-axis min,max
"zmin","zmax" real number Z-axis min,max
"xgrid" real vector X gridpoints (nonuniform)
"ygrid" real vector Y gridpoints (nonuniform)
"cmin","cmax" real number Contour min/max
"nsteps" integer Number of contours
"cstep" real number Contour spacing
"contstyle" 1: normal contours, 2: colored (pcolor),
3: 3D surface
"hiddenline" "true": colored 3D surface, "false": wireframe
"linecolor" color value (integer)
"linewidth" integer
"linestyle" solid,dashed etc.; integers; 0 is no line
"markertype" integers; 0 is no marker (the default)
"markersize" real number
"markercolor" color value (integer)
Some color (red,green,blue,pink etc.) names have been defined
in telainit.t. Use them for clarity if possible.
The most usual PlotMTV command line options (always start with
minus sign):
-3d Initially view in 3D
-colorps Produce color PostScript
-landscape Produce landscape (rotated) PostScript
-scale s PostScript scale factor, default 1
-nodate Drop the date from PostScript figure
-title 'my title' PlotMTV window title
For an example in using the annotations, see e.g. the file
"3windows.t", usual location is /usr/local/lib/tela/t/.
See also:
plotopt,
hold,
plot,
pcolor,
mesh,
contour,
vplot,
colormap.
Error codes:
1: Could not open temporary MTV file
2: First argument not a string
3: Syntax error in graph options
[] = bar(x,y,z...)
bar(grouplabels,data,barnames[,options]) produces a bar chart.
Example 1:
bar(strmat("DEC","HP"),#(111,150.6),"Speed")
See also:
plot,
hist.
Error codes:
1: First argument not int nor real array
2: First argument not a vector nor matrix
3: Second argument not int nor real array
4: Second argument not a vector nor matrix
5: Dimension mismatch between first and second arg
6: If second arg is vector, third arg must be a string
7: Third arg must be a string or a string matrix
8: If second arg is matrix, third arg must be a string matrix
9: Dimension mismatch between second and third arg
10: Syntax error in graph options
11: First arg must not be real matrix
12: Could not open temporary MTV file
[] = closefig(n)
closefig(n) (n>1) closes the nth graphics window.
The active window is not changed, so if n is the active
window, subsequent plot commands will reopen it.
If the window has never been opened or has already been
closed, closefig is silent about it.
closefig("all") closes all figures.
See also:
figure.
Error codes:
1: Argument not an integer
2: Argument not positive
3: This Tela installation does not support the closefig command
4: No n>1 figures are currently open (and X11 initialization has failed)
[] = colormap(r;g,b)
colormap(r,g,b) sets the colormap (palette) for the next
opened graphics window. The arguments r,g,b must be real vectors
with equal lengths and with entries in the range 0..1. If they
are outside range, they are silently truncated.
The colormap has an effect only in pcolor plots, and in contour
and mesh plots if suitable options are used. The colormap is reset
to its default value after each plot.
colormap(c), where c is a Nx3 matrix, is also accepted.
NOTICE: you need PlotMTV1.4.2t or later for this feature
to work. If you try to use it with older PlotMTV's, a warning
message about unknown option will be displayed.
See also:
plot,
annotate.
Error codes:
1: Argument is not real vector
2: Arguments have unequal lengths
3: Argument length less than 2 is not allowed
4: You must give either 1 or 3 input arguments
5: Single argument is not a Nx3 real matrix
[] = contour(z...)
contour(z[,options]) plots the matrix z as a filled contour plot.
contour(z,"xgrid",<x-grid-vector>,"ygrid",<y-grid-vector>[,other opts])
specifies a nonuniform grid in X and Y.
See also:
contour3,
annotate,
plot,
mesh,
pcolor,
vplot.
Error codes:
1: Could not open temporary MTV file
2: First argument is not a numeric 2D array
3: Syntax error in graph options
4: Write error in MTV file - file system full?
[] = contour3(z...)
contour3(z[,options]) plots the 3D array as a
"volume" plot. Currently this only means that all
six faces of the volume are contoured and colored
according to options.
See also:
annotate,
plot,
mesh,
pcolor,
vplot.
contour.
Error codes:
1: Could not open temporary MTV file
2: First argument is not a real 3D array
3: Syntax error in graph options
4: Write error in MTV file - file system full?
[] = figure(n)
figure(n) causes subsequent plot commands to use
window (figure) number n (n=1,2,...). Figures with
n>1 are drawn over by each new plot command.
figure(-1) restores the default behavior, which is
to create standalone windows. These plots are never
replaced by new graphics and are quit only by the user.
Using this command for n>1 requires that you use the
Tela-compatible PlotMTV version.
See also:
closefig.
Error codes:
1: Argument is not an integer
2: Figure number zero is reserved, don't use it
3: This Tela installation does not support the figure command
4: Failed X11 initialization, cannot synchronize with PlotMTV
[X,Y] = grid(x,y)
[X,Y] = grid(x,y) produces matrices X,Y that are formed from vectors x,y
such that X[i,j] = x[i] for all j, and Y[i,j] = y[j] for all i.
See also:
grid3.
Error codes:
-1: Input argument is array but not a vector
-2: Input argument is not real array
[X,Y,Z] = grid3(x,y,z)
[X,Y,Z] = grid3(x,y,z) produces 3D arrays X,Y,Z that ar
formed from vectors x,y,z such that
X[i,j,k] = x[i] for all j,k,
Y[i,j,k] = y[j] for all i,k, and
Z[i,j,k] = z[k] for all i,j.
See also:
grid.
Error codes:
-1: Input arg is array but not a vector
-2: Input arg not a real array
[;ndata,xdata] = hist(x...)
hist(x) produces a histogram of vector x.
The range min(x)..max(x) is divided in bins, and the
number of x values in each bin is counted. The count determines
the height of each bin.
hist(x) uses 10 bins, hist(x,n) uses n bins.
hist(x,n,a) starts from x=a.
hist(x,n,a,b) ignores x values outside interval a..b.
Rest of the args may contain other MTV options.
[ndata,xdata] = hist(args) returns the count and abscissa vectors
but does not draw anything. bar(xdata,ndata,"lab") can be used to draw
the histogram later. Graphics options are ignored in this case.
See also:
plot,
bar.
Error codes:
1: First argument not a (real) vector
2: Second arg not a positive integer
3: Third arg not a (real) scalar
4: Fourth arg not a (real) scalar
5: Third arg greater of equal than fourth arg
6: Could not open temporary MTV file
7: Syntax error in graph options
[] = hold(flag)
hold(on) and hold(off) set the graphics hold mode on and off.
When hold is on, all graphics commands will be accumulated and
performed only until hold(off).
If hold(on) is called many times in succession, also hold(off)
must be called as many times until the plots are produced.
For example, if
function f() {hold(on); plot1(); plot2(); hold(off)};
and it is called as
hold(on); f(); plot3(); hold(off);
then all three plots are actually combined in one plot.
hold(-1) can be used to reset the internal counter.
Use it in emergency.
See also:
plot,
holdmode.
Error codes:
1: Argument not an integer
[result] = holdmode(;flag)
holdmode(overlay) causes held plots to be combined in same figure.
holdmode(paging) shows them as sequential pages in one window.
holdmode(stacking) draws them as subplots in one window.
holdmode() returns the current setting.
See also:
hold.
Error codes:
1: Argument not an integer
2: Bad value for argument
[] = mesh(z...)
mesh(z[,options]) plots the matrix z as a 3D mesh.
mesh(z,"xgrid",<x-grid-vector>,"ygrid",<y-grid-vector>[,other opts])
specifies a nonuniform grid in X and Y.
See also:
annotate,
plot,
contour,
pcolor,
vplot.
Error codes:
1: Could not open temporary MTV file
2: First argument is not a numeric 2D array
3: Syntax error in graph options
4: Write error in MTV file - file system full?
[] = pcolor(z...)
pcolor(z[,options]) plots the matrix z as a pseudocolor density plot.
pcolor(z,"xgrid",<x-grid-vector>,"ygrid",<y-grid-vector>[,other opts])
specifies a nonuniform grid in X and Y.
See also:
annotate,
plot,
contour,
mesh,
vplot.
Error codes:
1: Could not open temporary MTV file
2: First argument is not a numeric 2D array
3: Syntax error in graph options
4: Write error in MTV file - file system full?
[] = pixmap(flag)
pixmap(off) tells PlotMTV not to use pixmaps for faster redraw.
pixmap(on) turns the pixmap mode on, which is the default.
If your X server uses backing store, you can save memory
by turning pixmap(off) without hurting performance.
Error codes:
1: Argument is not an integer
[] = plot(...)
plot(x1,y1,[options1], x2,y2,[options2],...) is the basic 2D plot function.
Each vector yi is plotted versus the corresponding xi. All curves yi are
displayed in the same figure. The option sequences must consist of keyword-
value pairs. Example:
x = 0:0.1:4*pi;
plot(x,sin(x), "linewidth",3,"linecolor",2);
The abscissa x may be missing, in which case the default of 1:length(y)
is used. The ordinates y may be matrices; then each row produces one
curve. If also abscissa x is matrix, the x-value may be different for each
curve.
See also:
plot3,
annotate,
plotopt,
mesh,
contour,
pcolor,
vplot,
colormap.
Error codes:
1: Could not open temporary MTV file
2: Nonnumeric or complex data argument
3: Syntax error in graph options
4: The abscissa ("x") must be a vector or a matrix
5: The ordinate ("y") must be a vector or a matrix
6: x and y dimensions disagree
[] = plotopt(s)
plotopt("-3d -colorps -landscape...") sets a set of PlotMTV command
line options for subsequent graphics commands (global setting).
See also:
plot,
annotate.
NOTICE: plotopt is usually not required. You can pass the option string
to all plot commands directly, for example:
plot(x,sin(x),"-3d -landscape");
These options affect only the current (or next outputted, if hold is used)
plot. All graphics function optional string args which start with minus sign
are assumed to be PlotMTV command line options.
Error codes:
1: Argument not a string
[] = plot3(x,y,z...)
plot3(x,y,z[,options]) produces parametric space curves.
The quantities x,y,z must have equal ranks, and they can
be either vectors or matrices. If they are vectors, only
one space curve is drawn. If they are matrices, the number
of curves produces equals the number of rows.
See also:
plot,
annotate.
Error codes:
1: Could not open temporary MTV file
2: y dimensionality disagrees with x dimensionality
3: z dimensionality disagrees with x dimensionality
4: Input arrays must be integer or real arrays
5: Input arrays must have rank equal to 1 or 2
6: Syntax error in graph options
[] = reset_alt_display()
reset_alt_display() must be used after set_alt_display
to return to normal settings (to direct X11 commands to
DISPLAY environment variable again).
See also:
set_alt_display.
[] = set_alt_display(s)
set_alt_display("X display name") informs Tela that
subsequent PlotMTV commands use the given X display name
instead of the default (DISPLAY environment variable).
If you want to temporarily redirect your display to somewhere
else, be it mydisplay:1 do the following:
closefig(1); ... // close all figures that you will manipulate below
set_alt_display("mydisplay:1");
plotopt("-display mydisplay:1 ...");
// Do your graphics commands here ...
reset_alt_display(); // return to normal setting
plotopt("..."); // i.e without -display argument
You MUST ensure that the display given to PlotMTV via
p|otopt (or directly, using a plot command option) is the same
as that used in set_alt_display.
See also:
plot,
reset_alt_display.
Error codes:
-1: Argument not a string
[] = vplot(x,y,vx,vy...)
vplot(x,y,vx,vy[,options]) produces a 2D vector plot of the vector
field (vx,vy). All arguments x,y,vx and vy must be 2D integer or
real arrays and of the same size. Each 2D vector will be positioned
at (x[i,j],y[i,j]) and its direction will be (vx[i,j],vy[i,j]) where
(i,j) run over rows and columns of the matrices.
See also:
annotate,
plot,
mesh,
contour,
pcolor.
Error codes:
1: Could not open temporary MTV file
2: One of first four args is not a numeric array
3: One of first four args has rank not equal to 2
4: Dimensions of first four args disagree
5: Syntax error in graph options