## Documentation Center |

Waterfall plot

`waterfall(Z)waterfall(X,Y,Z)waterfall(...,C)waterfall(axes_handles,...)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(axes_handles,...)`
plots into the axes with handle `axes_handle` instead
of the current axes (`gca`).

`h = waterfall(...)` returns
the handle of the `patch` graphics object used
to draw the plot.

Was this topic helpful?