donutchart

根据数值向量创建一个环形图。默认情况下，每个扇区标签显示一个百分比值。

data = [1 2 3 4];
donutchart(data)

根据分类向量创建一个环形图。donutchart 函数对每个类别的实例数量进行计数，以确定每个扇区的大小。

通过调用 reordercats 函数控制扇区的顺序。

flavors = categorical(["Glazed","Pumpkin","Pumpkin","MATLAB","Boston Creme"]);
flavors = reordercats(flavors,["MATLAB","Pumpkin","Boston Creme","Glazed"]);
donutchart(flavors)

创建一个表，其中包含甜甜圈竞赛中烘焙师的姓名以及对应的得票数。

Bakers = ["Betty";"Abby";"Afiq";"Ravi";"Dave"];
Votes = [2; 5; 5; 2; 5];
tbl = table(Bakers,Votes)

tbl=5×2 table
    Bakers     Votes
    _______    _____

    "Betty"      2  
    "Abby"       5  
    "Afiq"       5  
    "Ravi"       2  
    "Dave"       5  

根据该表创建一个环形图。

donutchart(tbl,"Votes","Bakers")

您可以通过设置属性来指定旋转方向并沿圆移动所有扇区。您可以在调用 donutchart 函数时通过指定名称-值参量来设置属性，也可以稍后设置 DonutChart 对象的属性。

创建一个名为 data 的向量，并用它创建一个环形图。默认情况下，扇区按顺时针方向出现，第一个（蓝色）扇区的左边位于 0 度（12 点钟方向）。

data = [1 2 3 4];
donutchart(data)

创建另一个环形图，但这次通过将 Direction 属性指定为名称-值参量将该属性设置为 "counterclockwise"。带一个输出参量调用 donutchart 函数以存储 DonutChart 对象。

p = donutchart(data,Direction="counterclockwise");

通过将 DonutChart 对象的 StartAngle 属性设置为 -90，将扇区逆时针方向移位 90 度。

p.StartAngle = -90;

您可以通过设置 LabelStyle 属性，将扇区标签从百分比更改为计数。LabelStyle 属性具有用于显示扇区名称、数据值和百分比的不同组合的选项。

根据数值向量和名称向量创建一个环形图。指定输出参量以存储 DonutChart 对象。然后将标签更改为包含数据值而不是百分比。

data = [1 2 3];
names = ["Jelly","Glazed","Frosted"];
d = donutchart(data,names);
d.LabelStyle = "namedata";

另一个选项是仅显示名称，不显示任何数据或百分比值。

d.LabelStyle="name";

创建一个环形图，显示烘焙销售中每个参与者的销售额占总销售额的百分比。使用输出参量调用 donutchart 函数以存储 DonutChart 对象，以便稍后更改图的各个方面。

Bakers = ["Betty","Abby","Afiq","Ravi","Dave"];
Sales = [20 51.55 49.37 20.35 48.25];
d = donutchart(Sales,Bakers);

查询 DonutChart 对象的扇区名称。

d.Names

ans = 1×5 string
    "Betty"    "Abby"    "Afiq"    "Ravi"    "Dave"

将扇区名称更改为甜甜圈口味。

d.Names = ["Jelly","Glazed","Frosted","Chocolate","Plain"];

将每个标签显示为两行文本，第一行为甜甜圈口味，第二行为销售额。要组合每个标签的不同元素，请从 Names 属性开始，并添加换行符、美元符号和 Sales 向量（转换为字符串）。

d.Labels = d.Names + "\newline$" + string(Sales);

自 R2024b 起

您可以使用 colororder 函数更改环形图的颜色。例如，创建一个具有默认颜色的环形图。

donutchart([1 2 3 4])

您可以从几个命名的调色板中进行选择，包括 gem（默认值）、glow、sail、reef、meadow、dye 和 earth。将调色板更改为 meadow。

colororder meadow

将调色板更改为 sail。

colororder sail

通过设置 NumDisplayWedges 属性，可以将多个小扇区的数据合并到一个名为 "Others" 的扇区中。也可以通过设置 DisplayOrder 属性，按升序或降序排列扇区。

例如，创建一个环形图，显示公司每个部门的员工数量。在创建图时，指定输出参量来存储 DonutChart 对象，以便可以稍后修改它。

employees = [100 10 50 30 25 10 15];
departments = ["Engineering" "Sales" "User Experience" "Documentation" "IT" "HR" "Security"];
d = donutchart(employees,departments,LabelStyle="name");

根据员工数量按降序排列扇区。

d.DisplayOrder = "descend";

显示三个扇区，并将其他扇区合并到第四个名为 "Others" 的扇区中。由于扇区通过 DisplayOrder 属性按降序排序，因此将 NumDisplayWedges 设置为 3 会显示三个最大的扇区。

d.NumDisplayWedges = 3;

要在一个图窗中创建多个图，请使用分块图布局。

创建 1×2 分块图布局。通过先后调用 nexttile 函数和 donutchart 函数创建第一个图。然后通过调用 title 函数添加标题。对第二个图重复这些步骤。

tiledlayout(1,2)
nexttile
donutchart([1 2 3 4])
title("2022 Totals")
nexttile
donutchart([10 3 1 5 6 4])
title("2023 Totals")