Man Scilab

Matplot Scilab Function

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

Author

J.Ph.C.