# Octave Programming Tutorial/Plotting

Octave can work with gnuplot, Grace, PLplot. Some people deem PLplot is a replacement of the traditional gnuplot in Octave.

## Contents

## 2D plots[edit]

plot(y)

If a single data argument is supplied, it is taken as the set of Y coordinates and the X coordinates are taken to be the indices of the elements, starting with 1.

plot(x, y)

- If the first argument is a vector and the second is a matrix, the vector is plotted versus the columns (or rows) of the matrix. (using whichever combination matches, with columns tried first.)
- If the first argument is a matrix and the second is a vector, the columns (or rows) of the matrix are plotted versus the vector. (using whichever combination matches, with columns tried first.)
- If both arguments are vectors, the elements of Y are plotted versus the elements of X.
- If both arguments are matrices, the columns of Y are plotted versus the columns of X. In this case, both matrices must have the same number of rows and columns and no attempt is made to transpose the arguments to make the number of rows match.

linspace(b, l, n)

results in a vector with n linearly spaced numbers between b and l. It is often used to produce the vector X in the two-argument form of plot.

### Example[edit]

```
x = linspace(0, 2*pi, 100);
y = sin(x);
plot(x, y);
```

### Non-linear plots[edit]

semilogx, semilogy, loglog, polar

### Formatting[edit]

The plot may be formatted using an additional FMT argument:

```
plot (x, [y,] FMT, …)
```

In the argument any number of the following options may appear:

`-' Set lines plot style (default). `.' Set dots plot style. `@' Set points plot style. `-@' Set linespoints plot style. `^' Set impulses plot style. `L' Set steps plot style. `N' Interpreted as the plot color if N is an integer in the range 1 to 6. `NM' If NM is a two digit integer and M is an integer in the range 1 to 6, M is interpreted as the point style. This is only valid in combination with the `@' or `-@' specifiers. `C' If C is one of `"r"', `"g"', `"b"', `"m"', `"c"', or `"w"', it is interpreted as the plot color (red, green, blue, magenta, cyan, or white). `";title;"' Here `"title"' is the label for the key. `+' `*' `o' `x' Used in combination with the points or linespoints styles, set the point style. The color line styles have the following meanings on terminals that support color. Number Gnuplot colors (lines)points style 1 red * 2 green + 3 blue o 4 magenta x 5 cyan house 6 white there exists The FMT argument can also be used to assign key titles. To do so, include the desired title between semi-colons after the formatting sequence described above, e.g. "+3;Key Title;" Note that the last semi-colon is required and will generate an error if it is left out.

Furthermore, a set of property-value pairs may also be applied, simultanously, to each "line" drawn by plot.

```
plot (x, [y,] FMT, property, value, …)
```

### Example[edit]

Here instead of line plot we place a '+' marker on the graph for each datapoint, choose the first color (red), and add a legend.

```
x = linspace(0, 2*pi, 50);
y = sin(x);
plot(x, y, '+1;sin(x);');
```

The second example adds another line and some property-value pairs as well.

```
x = linspace(0, 2*pi, 100);
y = sin(x);
y2 = cos(x);
plot(x, y, '+1;sin(x);', "markersize", 10, x, y2, ";cos(x);", "markersize", 5, "marker", '*');
```

### [edit]

xlabel, ylabel, title and refresh

## 3D plots[edit]

mesh, meshgrid, surf

## Contour plots[edit]

contour

contour (Z)

contour (Z, VN)

contour (X, Y, Z)

contour (X, Y, Z, VN)

contour (..., STYLE)

contour (H, ...)

[C, H] = contour (...)

Plot level curves (contour lines) of the matrix Z, using the contour matrix C computed by `contourc' from the same arguments; see the latter for their interpretation. The set of contour levels, C, is only returned if requested. For example: x = 0:2; y = x; z = x' * y; contour (x, y, z, 2:3) The style to use for the plot can be defined with a line style STYLE in a similar manner to the line styles used with the `plot' command. Any markers defined by STYLE are ignored. The optional input and output argument H allows an axis handle to be passed to `contour' and the handles to the contour objects to be returned.

**contourc**

[C, LEV] = contourc (X, Y, Z, VN)

Compute isolines (contour lines) of the matrix Z. Parameters X, Y and VN are optional. The return value LEV is a vector of the contour levels. The return value C is a 2 by N matrix containing the contour lines in the following format C = [lev1, x1, x2, ..., levn, x1, x2, ... len1, y1, y2, ..., lenn, y1, y2, ...] in which contour line N has a level (height) of LEVN and length of LENN. If X and Y are omitted they are taken as the row/column index of Z. VN is either a scalar denoting the number of lines to compute or a vector containing the values of the lines. If only one value is wanted, set `VN = [val, val]'; If VN is omitted it defaults to 10.

For example, x = 0:2; y = x; z = x' * y; contourc (x, y, z, 2:3) => 2.0000 2.0000 1.0000 3.0000 1.5000 2.0000 2.0000 1.0000 2.0000 2.0000 2.0000 1.5000

## Images[edit]

colormap, image, imshow, hsv2rgb

>> help colormap 'colormap' is a function from the file C:\Octave\Octave-4.0.1\share\octave\4.0.1\ m\image\colormap.m

-- Function File: CMAP = colormap () -- Function File: CMAP = colormap (MAP) -- Function File: CMAP = colormap ("default") -- Function File: CMAP = colormap ("MAP_NAME") -- Function File: CMAP = colormap (HAX, ...) -- Command: colormap MAP_NAME -- Function File: CMAPS = colormap ("list") -- Function File: colormap ("register", "NAME") -- Function File: colormap ("unregister", "NAME") Query or set the current colormap.

With no input arguments, `colormap' returns the current color map.

`colormap (MAP)' sets the current colormap to MAP. The colormap should be an N row by 3 column matrix. The columns contain red, green, and blue intensities respectively. All entries must be between 0 and 1 inclusive. The new colormap is returned.

`colormap ("default")' restores the default colormap (the `jet' map with 64 entries). The default colormap is returned.

The map may also be specified by a string, "MAP_NAME", where MAP_NAME is the name of a function that returns a colormap.

If the first argument HAX is an axes handle, then the colormap for the parent figure of HAX is queried or set.

For convenience, it is also possible to use this function with the command form, `colormap MAP_NAME'.

`colormap ("list")' returns a cell array with all of the available colormaps. The options "register" and "unregister" add or remove the colormap NAME from this list.

See also: jet.

## Saving and printing graphs[edit]

Print a graph to a printer or save it to a file

print("-Pprinter") print("filename", "-ddevice")

Devices:

`ps' `ps2' `psc' `psc2' Postscript (level 1 and 2, mono and color) `eps' `eps2' `epsc' `epsc2' Encapsulated postscript (level 1 and 2, mono and color) `ill' `aifm' Adobe Illustrator `cdr' `corel' CorelDraw `hpgl' HP plotter language `fig' XFig `dxf' AutoCAD `mf' Metafont `png' Portable network graphics `pbm' PBMplus

If the device is omitted, it is inferred from the file extension, or if there is no filename it is sent to the printer as postscript.

# See also[edit]

Return to the Octave Programming tutorial index