本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

area

填充区二维绘图

语法

area(Y)
area(X,Y)
area(...,basevalue)
area(...,Name,Value)
area(ax,...)
ar = area(...)

说明

区域图将 Y 中的元素显示为一个或多个曲线并填充每个曲线下方的区域。如果 Y 为矩阵,则曲线堆叠在一起,显示每行元素占每个 x 区间的曲线总高度的相对量。

area(Y) 绘制向量 Y 或将矩阵 Y 中每一列作为单独曲线绘制并堆叠显示。x 轴自动缩放到 1:size(Y,1)Y 中的值可以是数值或持续时间值。

area(X,Y) 绘制 YX 的图,并填充 0Y 之间的区域。X 的值可以是数值、日期时间、持续时间或分类值。

  • 如果 Y 是向量,则将 X 指定为由递增值组成的向量,其长度等于 Y。如果 X 的值不增加,则 area 将在绘制之前对值进行排序。

  • 如果 Y 是矩阵,则将 X 指定为由递增值组成的向量,其长度等于 Y 的行数。areaY 的列绘制为填充区域。对于每个 X,最终结果是 Y 行的相应值的和。您还可以将 X 指定为大小等于 Y 的矩阵。为了避免 X 为矩阵时出现意外输出,请将 X 的列指定为重复列。

area(...,basevalue) 指定区域填充的基值。默认 basevalue0。将基值指定为数值。

area(...,Name,Value) 使用一个或多个名称-值对组参数修改区域图。

area(ax,...) 将图形绘制到 ax 坐标区中,而不是当前坐标区 (gca) 中。

ar = area(...) 返回一个或多个 Area 对象。area 函数将为向量输入参数创建一个 Area 对象。它会为矩阵输入参数的每一列创建一个对象。

创建 m×n 矩阵的区域图会创建 n 个区域序列对象(即每列一个),而 1×n 向量创建一个区域序列对象。

您在单个区域序列对象中设置的一些区域序列对象属性会设置图形中的所有区域序列对象的值。有关特定属性的信息,请参阅 Area 属性

示例

全部折叠

将矩阵 Y 中的数据绘制成区域图。

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

默认情况下,area 使用 y 轴作为基值。通过将 basevalue 输入参数设置为 -4 改变基值。

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

创建 Y 区域图,并使用点线样式。返回数组 h 中的三个区域对象。area 函数为 Y 中的每列创建一个区域对象。

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

使用 RGB 三元组颜色值更改区域颜色。使用圆点表示法设置属性。

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

通过将 FaceColor 属性设置为 'flat',创建一个使用颜色图颜色的区域图。

y = [1 3 5; 3 2 7; 3 4 2];
area(y,'FaceColor','flat')

提示

  • 如果 Y 包含 NaN 值,则 area 函数会在缺失值附近的区域断开绘图。

扩展功能

在 R2006a 之前推出