Matplot

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])
// draw the current colormap 
Matplot((1:xget("lastpattern")))
 
  

See also

colormap, plot2d, Matplot1

Author

J.Ph.C.