area

Filled area 2-D plot

Syntax

`area(Y)area(X,Y)area(...,basevalue)area(...,'PropertyName',PropertyValue,...)area(axes_handle,...)h = area(...)`

Description

An area graph displays elements in `Y` as one or more curves and fills the area beneath each curve. When `Y` is a matrix, the curves are stacked showing the relative contribution of each row element to the total height of the curve at each x interval.

`area(Y)` plots the vector `Y` or plots each column in matrix `Y` as a separate curve and stacks the curves. The x-axis automatically scales to `1:size(Y,1)`.

`area(X,Y)` For vectors `X` and `Y`, `area(X,Y)` is the same as `plot(X,Y)` except that the area between `0` and `Y` is filled. When `Y` is a matrix, `area(X,Y)` plots the columns of `Y` as filled areas. For each `X`, the net result is the sum of corresponding values from the rows of `Y`.

If `X` is a vector, `length(X)` must equal `length(Y)`. If `X` is a matrix, `size(X)` must equal `size(Y)`.

`area(...,basevalue)` specifies the base value for the area fill. The default `basevalue` is `0`.

`area(...,'PropertyName',PropertyValue,...)` specifies property name and property value pairs for the patch graphics object created by `area`.

`area(axes_handle,...)` plots into the axes with the handle `axes_handle` instead of into the current axes (`gca`).

`h = area(...)` returns handles of `area` graphics objects.

Creating an area graph of an m-by-n matrix creates n area objects (that is, one per column), whereas a 1-by-n vector creates one area object.

Some area object properties that you set on an individual area object set the values for all area objects in the graph. See Area Properties for information on specific properties.

Examples

collapse all

Create Area Graph

Plot the data in matrix Y as an area graph.

```Y = [1, 5, 3; 3, 2, 7; 1, 5, 3; 2, 6, 1]; figure area(Y) ```

Adjust Base Value of Area Graph

By default, `area` uses the y-axis as the base value. Change the base value by setting the `basevalue` input argument to -4.

```Y = [1, 5, 3; 3, 2, 7; 1, 5, 3; 2, 6, 1]; figure basevalue = -4; area(Y,basevalue) ```

Specify Color and Line Style for Area Plot

Create an area plot of `Y` and use a dotted line style. Return the three area objects in array `h`. The `area` function creates one area object for each column in `Y`.

```Y = [1, 5, 3; 3, 2, 7; 1, 5, 3; 2, 6, 1]; h = area(Y,'LineStyle',':'); ```

Change the area colors using RGB triplet color values. Starting in R2014b, you can use dot notation to set properties. If you are using an earlier release, use the `set` function instead.

```h(1).FaceColor = [0 0.25 0.25]; h(2).FaceColor = [0 0.5 0.5]; h(3).FaceColor = [0 0.75 0.75]; ```