violinplot

基于患者年龄向量创建单个小提琴图。使用该小提琴图分析年龄分布。

加载 patients 数据集。Age 向量包含 100 位患者的年龄。创建一个小提琴图以可视化年龄分布。

load patients
violinplot(Age)
ylabel("Age (years)")

小提琴图的轮廓由概率密度函数的核密度估计值 (kde) 确定。kde 呈钟形，在垂直轴上的峰值接近 40。绘图显示 Age 中的数据近似正态分布，患者年龄中位数约为 40。

生成一个由正态分布的随机数组成的矩阵。为矩阵每列中的数据创建一个小提琴图。

ydata = randn(100,3);
violinplot(ydata)

三个小提琴图具有分组标签 1、2 和 3。由于数据的随机性，各小提琴图的形状略有不同。然而，每个小提琴图都具有正态分布特有的钟形特征。

自 R2025a 起

将海啸数据集加载到一个表中。为经度和纬度变量创建小提琴图。

T = readtable('tsunamis.xlsx');
violinplot(T,["Longitude","Latitude"])

三个小提琴图具有分组标签 1、2 和 3。

生成一个由正态分布随机数组成的向量，并创建一个分组数据向量。

ydata = randn(100,1);
xgroupdata = categorical(repelem(["group1";"group2";"group3"],[20,50,30]));

为 ydata 中的数据创建一组小提琴图，并按照 xgroupdata 中的唯一值进行分组。图窗中的每个小提琴图对应 xgroupdata 中的一个唯一值。

violinplot(xgroupdata,ydata)

生成两个正态分布数据向量和三个分组数据向量。

ydata1 = randn(100,1);
ydata2 = randn(100,1)+5;

xgroupdata1 = categorical(repelem(["group1";"group2"],[90,10]));
xgroupdata2 = categorical(repelem(["group1";"group2"],[10,90]));
xgroupdata3 = categorical(repelem(["group3";"group4"],[25,75]));

变量 ydata1 和 ydata2 包含均值分别为 0 和 5 的正态分布数据。xgroupdata1 和 xgroupdata2 包含相同分组标签的不同序列。xgroupdata3 包含与 xgroupdata1 和 xgroupdata2 中的分组标签不同的分组标签。

基于样本数据和分组数据创建一个表。

tbl = table(xgroupdata1,xgroupdata2,xgroupdata3, ...
    ydata1,ydata2,VariableNames=["X1","X2","X3","Y1","Y2"]);

使用 ydata1 中的数据创建一组叠加的小提琴图，并按照 xgroupdata1 和 xgroupdata2 进行分组。

violinplot(tbl,["X1","X2"],"Y1")

图窗显示两组叠加的小提琴图。蓝色小提琴图表示按照 xgroupdata1 分组的 ydata1 中的数据，橙色小提琴图表示按照 xgroupdata2 分组的相同数据。叠加图显示，不同分组并不会显著更改每组的中位数值。但是，它们对每组对应的小提琴图形状有明显影响。这一结果表明，每组中数据的分布受数据分组方式的影响。

使用 ydata1 中的数据（按照 xgroupdata1 分组）和 ydata2 中的数据（按照 xgroupdata3 分组）创建另一组小提琴图。

violinplot(tbl,["X1","X3"],["Y1","Y2"])

与组 1 和 2 对应的蓝色图表示 ydata1 中的数据，与组 3 和 4 对应的橙色图表示 ydata2 中的数据。绘图显示，组 3 和 4 中数据的中位数大于组 1 和 2 中数据的中位数。

生成一个由正态分布的随机数组成的向量。创建两个用于表示位置和颜色分组数据的向量。

ydata = randn(100,1);

xgroupdata = categorical(repelem(["group1";"group2";"group3"],[20;50;30]));
cgroupdata = categorical(repelem(["a";"b";"a";"b";"c";"d";"e"],[10;10;25;25;10;10;10]));

变量 ydata 包含均值为 0 的正态分布数据。xgroupdata 包含三个不同组的标签。cgroupdata 中的标签将 xgroupdata 中的前两组拆分为相同的两种颜色，并将 xgroupdata 中的第三组拆分为三种不同颜色。

使用 xgroupdata 作为位置分组数据、cgroupdata 作为颜色分组数据绘制 ydata 中的数据。

violinplot(xgroupdata,ydata,GroupByColor=cgroupdata)

图窗显示一组小提琴图，分别对应 xgroupdata 中的三个分组标签。组 1 和 2 的集合各包含一个橙色小提琴图和一个蓝色小提琴图。组 3 的小提琴图集合包含一个黄色小提琴图、一个紫色小提琴图和一个绿色小提琴图。

生成一个随机数向量。通过计算核密度估计值 (kde) 来估计数据的 pdf。

ydata = [randn(100,1); 6+2*randn(100,1)];
[f,xf] = kde(ydata,Bandwidth=0.6);

f 包含 kde 的值，xf 包含对应的计算点。

使用 f 作为密度值、xf 作为计算点来创建一个小提琴图。小提琴图的形状显示数据具有双峰特征。

violinplot(EvaluationPoints=xf,DensityValues=f)

创建两个由随机生成数据组成的向量。创建两个由位置分组数据组成的向量。

ydata1 = randn(100,1);
ydata2 = [randn(25,1)+2;randn(75,1)+5];

xgroupdata1 = repelem([1;2],[50;50]);
xgroupdata2 = repelem([1;2],[25;75]);;

变量 ydata1 和 ydata2 包含随机生成的数据。xgroupdata1 和 xgroupdata2 包含两个相同分组标签的不同序列。

比较根据 xgroupdata1 中标签分组的 ydata1 中的数据与根据 xgroupdata2 中标签分组的 ydata2 中的数据。对于每个组，创建一个水平小提琴图，其中 ydata1 中的数据以上半部分表示，ydata2 中的数据以下半部分表示。

violinplot(xgroupdata1,ydata1,Orientation="horizontal",DensityDirection="positive")
hold on
violinplot(xgroupdata2,ydata2,Orientation="horizontal",DensityDirection="negative")
legend("ydata1","ydata2")

这些小提琴图显示，对于每个组，ydata1 和 ydata2 的数据近似正态分布，并且 ydata1 的数据均值小于 ydata2 的数据均值。此外，ydata2 的数据在组 2 中的均值大于在组 1 中的均值。

根据患者数据创建小提琴图，以比较吸烟者和非吸烟者的血压。绘图显示吸烟者的收缩压和舒张压高于非吸烟者。

加载 patients 数据集。将 Smoker 转换为 categorical 变量，并使用描述性的类别名称 Smoker 和 Nonsmoker，而不是 1 和 0。

load patients
Smoker = categorical(Smoker,logical([1 0]),["Smoker","Nonsmoker"]);

使用 tiledlayout 函数创建一个 1×2 分块图布局。通过调用 nexttile 函数，创建第一个坐标区 ax1。在第一个坐标区中，显示两个表示收缩压值的小提琴图，一个用于吸烟者，另一个用于非吸烟者。通过调用 nexttile 函数，在分块图布局中创建第二个坐标区 ax2。在第二个坐标区中，对舒张压执行同样的操作。

tiledlayout(1,2)

% Left axes
ax1 = nexttile;
violinplot(ax1,Systolic,GroupByColor=Smoker)
ylabel(ax1,'Systolic Blood Pressure')
legend("Smoker","Nonsmoker")

% Right axes
ax2 = nexttile;
violinplot(ax2,Diastolic,GroupByColor=Smoker)
ylabel(ax2,"Diastolic Blood Pressure")
legend("Smoker","Nonsmoker")

加载 patients 数据集，并将 Smoker 变量转换为 categorical。

load patients
Smoker = categorical(Smoker,logical([1 0]),["Smoker","Nonsmoker"]);

变量 Diastolic 和 Smoker 包含患者舒张压和是否为吸烟者的数据。

为 Diastolic 中的数据创建一组小提琴图，并按照 Smoker 进行分组。

v = violinplot(Diastolic,GroupByColor=Smoker)

v = 
  1×2 ViolinPlot array:

    ViolinPlot    ViolinPlot

v 是一个包含两个 ViolinPlot 对象的数组。您可以通过指定 v 中 ViolinPlot 对象的属性来修改小提琴图。有关详细信息，请参阅ViolinPlot Properties。

更新小提琴图的颜色，使吸烟者的图为粉色，非吸烟者的图为绿色。

v(1).FaceColor = [1 0 1]; % Pink
v(2).FaceColor = [0 1 0]; % Green
legend("Smoker","Nonsmoker")