MATLAB Functions Help Desk

area

Purpose

Area fill of a two-dimensional plot

Syntax

Description

An area plot 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 the sum of each column in matrix Y. The x-axis automatically scales depending on length(Y) when Y is a vector, and on size(Y,1)when Y is a matrix.

area(X,Y) plots Y at the corresponding values of X. If X is a vector, length(X) must equal length(Y) and X must be monotonic. If X is a matrix, size(X) must equal size(Y) and each column in X must be monotonic. To make a vector or matrix monotonic, use sort.

area(...,ymin) specifies the lower limit in the y direction for the area fill. The default ymin is 0.

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

h = area(...) returns handles of Patch graphics objects. area creates one Patch object per column in Y.

Remarks

area creates one curve from all elements in a vector or one curve per column in a matrix. The colors of the curves are selected from equally spaced intervals throughout the entire range of the colormap.

Examples

Plot the values in Y as a stacked area plot:

See Also



[ Previous | Help Desk | Next ]