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

pie

说明

示例

pie(X) 使用 X 中的数据绘制饼图。饼图的每个扇区代表 X 中的一个元素。

  • 如果 sum(X) ≤ 1X 中的值直接指定饼图扇区的面积。如果 sum(X) < 1pie 仅绘制部分饼图。

  • 如果 sum(X) > 1,则 pie 通过 X/sum(X) 对值进行归一化,以确定饼图的每个扇区的面积。

  • 如果 Xcategorical 数据类型,则扇区对应于类别。每个扇区的面积是类别中的元素数除以 X 中的元素数的结果。

示例

pie(X,explode) 将扇区从饼图偏移一定位置。explode 是一个由与 X 对应的零值和非零值组成的向量或矩阵。pie 函数仅将对应于 explode 中的非零元素的扇区偏移一定的位置。

如果 Xcategorical 数据类型,则 explode 可以是由对应于类别的零值和非零值组成的向量,或者是由要偏移的类别名称组成的元胞数组。

示例

pie(X,labels) 指定扇区的文本标签。X 必须是数值数据类型。标签数必须等于 X 中的元素数。

示例

pie(X,explode,labels) 偏移扇区并指定文本标签。X 可以是数值或分类数据类型。对于数值数据类型的 X,标签数必须等于 X 中的元素数。对于分类数据类型的 X,标签数必须等于分类数。

示例

pie(ax,___) 将图形绘制到 ax 指定的坐标区中,而不是当前坐标区 (gca) 中。选项 ax 可以位于前面的语法中的任何输入参数组合之前。

示例

p = pie(___) 返回一个由补片和文本图形对象组成的向量。该输入可以是先前语法中的任意输入参数组合。

示例

全部折叠

创建向量 X 的饼图。

X = [1 3 0.5 2.5 2];
pie(X)

通过将对应的 explode 元素设置为 1 来偏移第二和第四块饼图扇区。

explode = [0 1 0 1 0];
pie(X,explode)

创建向量 X 的饼图并标记扇区。

X = 1:3;
labels = {'Taxes','Expenses','Profit'};
pie(X,labels)

创建一个标签饼图,然后修改文件标签的颜色和字体大小。

X = 1:3;
labels = {'Taxes','Expenses','Profit'};
p = pie(X,labels)

p = 
  1x6 graphics array:

    Patch    Text     Patch    Text     Patch    Text 

获取标签“Profit”的文本对象。更改其颜色和字体大小。从 R2014b 开始,您可以使用圆点表示法设置属性。如果您使用的是早期版本,请改用 set 函数。

t = p(6);
t.BackgroundColor = 'cyan';
t.EdgeColor = 'red';
t.FontSize = 14;

创建一个由向量 X 组成的饼图,其中各个元素之和小于 1。

X = [0.19 0.22 0.41];
pie(X)

由于元素的总和小于 1,因此 pie 绘制部分饼图。

创建包含两年财务数据的向量 y2010y2011。然后创建一个包含值标签的元胞数组。

y2010 = [50 0 100 95];
y2011 = [65 22 97 120];
labels = {'Investments','Cash','Operations','Sales'};

创建一个 2×1 分块图布局,并在第一个图块中显示 y2010 数据的饼图和图例。然后在第二个图块中显示 y2011 数据的饼图和图例。

t = tiledlayout(2,1);
ax1 = nexttile;
pie(ax1,y2010)
legend(labels)
title('2010')

ax2 = nexttile;
pie(ax2,y2011)
legend(labels)
title('2011')

绘制一个分类饼图,其中的偏移扇区与类别相对应。

X = categorical({'North','South','North','East','South','West'});
explode = {'North','South'};
pie(X,explode)

现在,使用逻辑向量将相同扇区偏移一定位置。

explode = [0 1 1 0];
pie(X,explode)

绘制一个不包含任何偏移扇区的分类饼图并标记扇区。当 Xcategorical 数据类型时,必须指定输入参数 explode。要指定不包含任何偏移扇区的标签,请将 explode 指定为一个空数组,将 labels 指定为标签。

X = categorical({'North','South','North','East','South','West'});
explode = {};
labels = {'E','N','S','W'};
pie(X,explode,labels)

现在,将扇区偏移一定位置并标记所有扇区。

X = categorical({'North','South','North','East','South','West'});
explode = {'West'};
labels = {'E','N','S','W'};
pie(X,explode,labels)

输入参数

全部折叠

输入向量或矩阵。

  • 如果 X 为数值,则 X 中的所有值必须为有限值。

  • 如果 X 是分类数组,则 pie 将忽略未定义的元素。

数据类型: double|categorical

偏移扇区,指定为数值向量、矩阵、字符向量元胞数组或字符串数组。

  • 如果 X 为数值,则 explode 必须是逻辑向量或数值向量,或由对应于 X 的零或非零值组成的矩阵。一个真(非零)值从饼图中心将相应的扇区偏移一定位置,这样如果 explode(i,j) 是非零值,则 X(i,j) 将从中心偏移。explodeX 的大小必须相同。

  • 如果 X 是分类数组,则 explode 可以是由类别名称组成的字符向量元胞数组或字符串数组。pie 将与 explode 中的类别对应的扇区偏移一定的位置。

  • 如果 X 是分类数组,explode 也可以是逻辑向量或数值向量,其中包含与 X 中的每个类别对应的元素。pie 函数按类别顺序将对应于 true(非零)的扇区偏移一定的位置。

扇区的文本标签,指定为字符向量元胞数组或字符串数组。

坐标区对象。使用 ax 在特定的坐标区而不是当前坐标区 (gca) 中绘制该饼图。

输出参数

全部折叠

PatchText 对象,以向量形式返回。有关详细信息,请参阅 Patch 属性Text 属性

兼容性考虑

全部展开

R2019b 中的行为有变化

扩展功能

在 R2006a 之前推出