Scilab Function
Last update : 13/12/2005

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.