MATLAB Function Reference |

**Syntax**

plot3(X1,Y1,Z1,...) plot3(X1,Y1,Z1,

`LineSpec`

,...) plot3(...,'

',PropertyValue,...) h = plot3(...)*PropertyName*

**Description**

The `plot3`

function displays a three-dimensional plot of a set of data points.

```
plot3(X1,Y1,Z1,...),
```

where `X1`

, `Y1`

, `Z1`

are vectors or matrices, plots one or more lines in three-dimensional space through the points whose coordinates are the elements of `X1`

, `Y1`

, and `Z1`

.

`plot3(X1,Y1,Z1,`

creates and displays all lines defined by the `LineSpec`

,...)
`Xn,Yn,Zn,LineSpec`

quads, where `LineSpec`

is a line specification that determines line style, marker symbol, and color of the plotted lines.

`plot3(...,'`

sets properties to the specified property values for all line graphics objects created by

',PropertyValue,...)
*PropertyName*`plot3`

.

```
h = plot3(...)
```

returns a column vector of handles to lineseries graphics objects, with one handle per object.

**Remarks**

If one or more of `X1`

, `Y1`

, `Z1`

is a vector, the vectors are plotted versus the rows or columns of the matrix, depending whether the vectors' lengths equal the number of rows or the number of columns.

You can mix `Xn,Yn,Zn`

triples with `Xn,Yn,Zn,`

quads, for example, *LineSpec*

See `LineSpec`

and `plot`

for information on line types and markers.

**Examples**

Plot a three-dimensional helix.

**See Also**

`axis`

, `bar3`

, `grid`

, `line`

, `LineSpec`

, `loglog`

, `plot`

, `semilogx`

, `semilogy`

, `subplot`

plot | plotbrowser |

© 1994-2005 The MathWorks, Inc.