Waterfall plot

`waterfall(Z)`

waterfall(X,Y,Z)

waterfall(...,C)

waterfall(ax,...)

h = waterfall(...)

The `waterfall`

function draws a mesh similar
to the `meshz`

function, but it does not generate
lines from the columns of the matrices. This produces a “waterfall”
effect.

`waterfall(Z)`

creates a
waterfall plot using `x = 1:size(Z,2)`

and ```
y
= 1:size(Z,1)
```

. `Z`

determines the color,
so color is proportional to surface height.

`waterfall(X,Y,Z)`

creates
a waterfall plot using the values specified in `X`

, `Y`

,
and `Z`

. `Z`

also determines the
color, so color is proportional to the surface height. If `X`

and `Y`

are
vectors, `X`

corresponds to the columns of `Z`

,
and `Y`

corresponds to the rows, where ```
length(x)
= n
```

, `length(y) = m`

, and ```
[m,n]
= size(Z)
```

. `X`

and `Y`

are
vectors or matrices that define the *x-* and *y*-coordinates
of the plot. `Z`

is a matrix that defines the *z*-coordinates
of the plot (i.e., height above a plane). If `C`

is
omitted, color is proportional to `Z`

.

`waterfall(...,C)`

uses
scaled color values to obtain colors from the current colormap. Color
scaling is determined by the range of `C`

, which
must be the same size as `Z`

. MATLAB^{®} performs
a linear transformation on `C`

to obtain colors from
the current colormap.

`waterfall(ax,...)`

plots into the axes
`ax`

instead of the current axes (`gca`

).

`h = waterfall(...)`

returns the patch graphics object
used to draw the plot.

For column-oriented data analysis, use `waterfall(Z')`

or `waterfall(X',Y',Z')`

.

The range of `X`

, `Y`

, and `Z`

,
or the current setting of the axes `XLim`

, `YLim`

,
and `ZLim`

properties, determines the range of the
axes (also set by `axis`

). The range of `C`

,
or the current setting of the axes `CLim`

property,
determines the color scaling (also set by `caxis`

).

The `CData`

property for the patch graphics
objects specifies the color at every point along the edge of the patch,
which determines the color of the lines.

The waterfall plot looks like a mesh surface; however, it is
a patch graphics object. To create a surface plot similar to `waterfall`

,
use the `meshz`

function and set the `MeshStyle`

property
of the surface to `'Row'`

. For a discussion of parametric
surfaces and related color properties, see `surf`

.