Filled area 2-D plot

`area(Y)`

area(X,Y)

area(...,basevalue)

area(...,Name,Value)

area(ax,...)

ar = area(...)

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

. The values in `Y`

can
be numeric or duration values.

`area(X,Y)`

plots `Y`

versus `X`

and
fills the area between `0`

and `Y`

.
The values in `X`

can be numeric, datetime, duration
or categorical values.

If

`Y`

is a vector, then specify`X`

as a vector of increasing values with length equal to`Y`

. If the values in`X`

are not increasing, then`area`

sorts the values before plotting.If

`Y`

is a matrix, then specify`X`

as a vector of increasing values with length equal to the number of rows in`Y`

.`area`

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`

. You also can specify`X`

as a matrix with size equal to`Y`

. To avoid unexpected output when`X`

is a matrix, specify`X`

so that the columns repeat.

`area(...,basevalue)`

specifies
the base value for the area fill. The default `basevalue`

is `0`

.
Specify the base value as a numeric value.

`area(...,Name,Value)`

modifies
the area chart using one or more name-value pair arguments.

`area(ax,...)`

plots into
the axes `ax`

instead of into the current axes (`gca`

).

`ar = area(...)`

returns
one or more `Area`

objects. The `area`

function
creates one `Area`

object for vector input arguments.
It creates one object per column for matrix input arguments.

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.

If

`Y`

contains`NaN`

values, then the`area`

function breaks up the area around the missing values.