# plot3

## Purpose

Plot points and lines in 3-space.

## Synopsis

````plot3(X,Y,Z)`
`plot3(X,Y,Z,'linetype')`
`plot3(X1,Y1,Z1,'linetype1',X2,Y2,Z2,'linetype2',...)`
h = plot3(...)
```

## Description

`plot3` is a three-dimensional analogue of` plot`.

`plot3(X,Y,Z)`, where `X`, `Y`, and `Z` are three vectors of the same length, plots a line in three-space through the points whose coordinates are the elements of `X`, `Y` and `Z`. If `X`, `Y`, and `Z` are three matrices of the same size, `plot3` plots several lines obtained from the columns of `X`, `Y`, and `Z`.

Various line types, plot symbols and colors can be obtained with `plot3(X,Y,Z,s)` where `s` is a `1`, `2`, or `3` character string made from the characters listed under the `plot` command.

`plot3(x1,y1,z1,s1,x2,y2,z2,s2,x3,y3,z3,s3,...)` combines the plots defined by the `(x,y,z,s)` fourtuples, where the `x`'s, `y`'s, and `z`'s are vectors or matrices and the `s`'s are strings.

`h = plot3(...)` returns a column vector of handles to `line` objects, one handle per line. The `line` objects created by `plot3` are children of the current `axes`.

The `x`,`y`,`z` triples, or` x`,`y`,`z`,`s` quads can be followed by parameter value pairs to specify additional properties of the lines.

## Examples

Plot a three-dimensional helix:

````t = 0:pi/50:10`*`pi;`
`plot3(sin(t),cos(t),t)`
`          `

```

(c) Copyright 1994 by The MathWorks, Inc.