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" .
  • default The 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.