Scilab Function
Last update : 27/3/39996287
Matplot - 2D plot of a matrix using
colors
Calling Sequence
- Matplot(a,[strf,rect,nax])
- Matplot(a,<opt_args>)
Parameters
-
a: real matrix of size (n1,n2).
-
<opt_args>: This represents a sequence of statements key1=value1,
key2=value2,... where key1,
key2,... can be one of the following:
-
rect: sets the bounds of the plot. If this key is given and
neither frameflag nor strf is given
then the y character of strf is
supposed to be 7. See below for value.
-
nax: sets the grids definition. If this key is given and
neither axesflag nor strf is given
then the z character of strf is
supposed to be 1. See below for value.
-
frameflag: specifies how the frame of the plot is computed. The
value is an integer ranging from 0 to 8. It corresponds to the
y character of strf. See below.
-
axesflag: specifies what kind of axes are drawn around the plot.
The value is an integer ranging from 0 to 5. It corresponds to
the z character of strf. See
below.
-
strf: is a string of length 3 "xyz".
-
defaultThe default is "081".
-
x: controls the display of captions.
-
x=0: no caption.
-
x=1: captions are displayed. They are given by the
optional argument leg.
-
y: controls the computation of the actual coordinate ranges
from the minimal requested values. Actual ranges can be larger
than minimal requirements.
-
y=0: no computation, the plot use the previus (or
default) scale
-
y=1: from the rect arg
-
y=2: from the min/max of the x, y datas
-
y=3: built for an isometric scale from the rect
arg
-
y=4: built for an isometric plot from the min/max of
the x, y datas
-
y=5: enlarged for pretty axes from the rect arg
-
y=6: enlarged for pretty axes from the min/max of the
x, y datas
-
y=7: like y=1 but the previus plot(s) are redrawn to
use the new scale
-
y=8: like y=2 but the previus plot(s) are redrawn to
use the new scale
-
z: controls the display of information on the frame around
the plot. If axes are requested, the number of tics can be
specified by the nax optional argument.
-
z=0: nothing is drawn around the plot.
-
z=1: axes are drawn, the y=axis is displayed on the
left.
-
z=2: the plot is surrounded by a box without tics.
-
z=3: axes are drawn, the y=axis is displayed on the
right.
-
z=4: axes are drawn centred in the middle of the frame
box.
-
z=5: axes are drawn so as to cross at point
(0,0). If point (0,0) does not
lie inside the frame, axes will not appear on the
graph.
-
rect: This argument is used when the second character y of argument
strf is 1, 3 or 5. It is a row vector of size 4 and
gives the dimension of the frame:
rect=[xmin,ymin,xmax,ymax].
-
nax: This argument is used when the third character z of argument
strf is 1. It is a row vector with four entries
[nx,Nx,ny,Ny] where nx (ny)
is the number of subgraduations on the x (y) axis and
Nx (Ny) is the number of graduations on
the x (y) axis.
Description
The entries of matrix int(a) are used as colormap entries
in the current colormap. The color associated to a(i,j) is
used do draw a small square of length 1 with center at location
(x=j,y=(n1-i+1)).
Enter the command Matplot() to see a demo.
Examples
Matplot([1 2 3;4 5 6])
clf()
// draw the current colormap
Matplot((1:xget("lastpattern")))
See Also
colormap, plot2d, Matplot1, Matplot_properties,
Author
J.Ph.C.