# waterfall

Waterfall plot

## Syntax

`waterfall(Z)waterfall(X,Y,Z)waterfall(...,C)waterfall(axes_handles,...)h = waterfall(...)`

## Description

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.

## Examples

collapse all

### Create Waterfall Plot

Create a waterfall plot of the peaks function.

```figure [X,Y,Z] = peaks(30); waterfall(X,Y,Z) ```

collapse all

### Tips

For column-oriented data analysis, use `waterfall(Z')` or `waterfall(X',Y',Z')`.

### Algorithms

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`.