# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

# waterfall

Waterfall plot

## Syntax

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

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

## Examples

collapse all

Create a waterfall plot of the peaks function.

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

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

## See Also

#### Introduced before R2006a

Was this topic helpful?

#### The Manager's Guide to Solving the Big Data Conundrum

Download white paper