Main Content

pie3

三维饼图

全页折叠
  • 3-D pie chart

语法

pie3(X)
pie3(X,explode)
pie3(X,labels)
pie3(X,explode,labels)
pie3(ax,___)
p = pie3(___)

说明

示例

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

示例

pie3(X,explode) 指定要从饼图的中心偏移哪些扇区。

示例

pie3(X,labels) 指定扇区的文本标签。标签数必须等于 X 中的元素数。

pie3(X,explode,labels) 偏移扇区并指定文本标签。

示例

pie3(ax,___) 将图形绘制到 ax 指定的坐标区中，而不是当前坐标区 (gca) 中。参量 ax 可以置于上述语法中的任何输入参量组合之前。

示例

p = pie3(___) 返回组成饼图的 Patch、Surface 和 Text 对象的向量。创建图后，使用 p 修改图属性。有关可以为这些对象设置的属性列表，请参阅 Patch 属性、Surface 属性 和 Text 属性。

示例

全部折叠

打开实时脚本

创建向量 X 的三维饼图。 

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

打开实时脚本

通过将对应的 explode 元素指定为 1，创建三维饼图并偏移扇区。

X = [1 3 0.5 2.5 2];
explode = [0 1 0 0 0];
pie3(X,explode)

打开实时脚本

创建三维饼图并指定文本标签。

X = 1:3;
labels = ["Taxes" "Expenses" "Profit"];
pie3(X,labels)

打开实时脚本

创建三维饼图并修改其中一个标签的字体样式。

首先，使用默认字体样式创建一个三维饼图。指定输出参量 p，以便您可以使用它来自定义饼图。

X = [1 2 3];
labels = ["Taxes" "Expenses" "Profit"];
p = pie3(X,labels);

饼图中的每个扇区在 p 中都有四个对应的元素：Patch、Surface、Patch 和 Text。 

p'
ans = 
  12x1 graphics array:

  Patch
  Surface    (Taxes)
  Patch
  Text       (Taxes)
  Patch
  Surface    (Expenses)
  Patch
  Text       (Expenses)
  Patch
  Surface    (Profit)
  Patch
  Text       (Profit)

获取标签 Expenses 的 Text 对象。通过使用圆点表示法设置相关联的属性来更改其颜色和字体大小。 

t = p(8);
t.Color = "red";
t.FontSize = 14;

打开实时脚本

通过使用分块图布局在同一图窗中绘制两个三维饼图来进行比较。

创建 2010 年和 2011 年两年的财务数据向量以及一组标签。

y2010 = [50 0 100 95];
y2011 = [65 22 97 120];
labels = ["Investments" "Cash" "Operations" "Sales"];

创建一个 2×1 分块图布局。在第一个图块中创建 2010 年的饼图，在第二个图块中创建 2011 年的饼图。为这两个饼图添加一个共享图例。

t = tiledlayout(1,2,"TileSpacing","None");
ax1 = nexttile;
pie3(ax1,y2010)
title("2010")

ax2 = nexttile;
pie3(ax2,y2011)
title("2011")

l = legend(labels);
l.Layout.Tile = "south";

输入参数

全部折叠

输入数组，指定为数值向量或矩阵。X 的每个元素对应于饼图的一个扇区。X 中所有元素的总和 S 确定 pie3 显示图的方式：

  • 如果 S = 1，则 X 中的值指定扇区的比例。

  • 如果 S < 1，则 X 中的值指定扇区的比例，而 pie3 绘制部分饼图。

  • 如果 S > 1，则 pie3 按 S 归一化每个扇区的大小。

偏移扇区，指定为与 X 大小相同的数值或逻辑向量或矩阵。要偏移扇区，请将对应的元素设置为非零值或 true。非零元素的值不影响偏移。

示例: [0 1 0 0] 偏移第二个扇区。

扇区的文本标签，指定为字符串数组或字符向量元胞数组。如果不指定标签，pie3 会自动显示百分比值。

目标坐标区，指定为 Axes 对象。如果未指定坐标区，则 MATLAB® 将在当前坐标区中进行绘制；或如果不存在 Axes 对象，则创建一个对象。

输出参量

全部折叠

组成饼图的图形对象，以 Patch、Surface 和 Text 对象的向量形式返回。

饼图中的每个扇区由四个对象组成，您可以使用这些对象来修改图外观。因此，输出向量的长度是 X 中元素数的四倍。每个扇区在 p 中有四个对应的元素，顺序如下：

  • Patch 对象 - 底层（在图像中不可见）

  • Surface 对象 - 顶层和底层之间的曲面（在图像中为橙色）

  • Patch 对象 - 顶层（在图像中为蓝色）

  • Text 对象 - 文本标签

3-D pie chart with three slices. One slice is offset. The visible top layer is blue. The surface around the slice is orange. The slice is labeled Expenses.

有关可以为这些对象设置的属性的详细信息，请参阅 Patch 属性、Surface 属性 和 Text 属性。

扩展功能

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅