matplotlib.axes.Axes.violin#

Axes.violin(vpstats, positions=None, *, vert=None, orientation='vertical', widths=0.5, showmeans=False, showextrema=True, showmedians=False, side='both')[source]#

基于预计算的统计数据绘制小提琴图。

为 vpstats 的每一列绘制小提琴图。每个填充区域延伸表示整个数据范围，并可选地在均值、中位数、最小值、最大值和分位数处绘制线条。

参数:
vpstats字典列表

一个包含每个小提琴图统计数据的字典列表。必需的键包括：

  • coords: 包含小提琴图核密度估计评估坐标的标量列表。

  • vals: 包含在 coords 中给定每个坐标处的核密度估计值的标量列表。

  • mean: 此小提琴图数据集的均值。

  • median: 此小提琴图数据集的中位数。

  • min: 此小提琴图数据集的最小值。

  • max: 此小提琴图数据集的最大值。

可选的键包括：

  • quantiles: 包含此小提琴图数据集分位数值的标量列表。

positions类数组，默认值: [1, 2, ..., n]

小提琴图的位置；即垂直小提琴图的 x 轴坐标（或水平小提琴图的 y 轴坐标）。

vert布尔值，可选

自 3.10 版本弃用：请改用 orientation。

如果在弃用期内提供此参数，它将覆盖 orientation 参数。

如果为 True，则垂直绘制小提琴图。如果为 False，则水平绘制小提琴图。

orientation{'vertical', 'horizontal'}，默认值: 'vertical'

如果为 'horizontal'，则水平绘制小提琴图。否则，垂直绘制小提琴图。

自 3.10 版本新增。

widths浮点数或类数组，默认值：0.5

每个小提琴图在 positions 轴单位中的最大宽度。默认值为 0.5，在使用默认 positions 时，它是可用空间的一半。

showmeans布尔值，默认值：False

是否用线条显示均值。

showextrema布尔值，默认值：True

是否用线条显示极值。

showmedians布尔值，默认值：False

是否用线条显示中位数。

side{'both', 'low', 'high'}，默认值：'both'

'both' 绘制标准小提琴图。'low'/'high' 仅绘制位置值下方/上方的一侧。

返回:
字典

一个字典，将小提琴图的每个组件映射到相应的已创建集合实例列表。该字典包含以下键：

  • bodies: 包含每个小提琴图填充区域的 PolyCollection 实例列表。

  • cmeans: 一个 LineCollection 实例，标记每个小提琴图分布的均值。

  • cmins: 一个 LineCollection 实例，标记每个小提琴图分布的底部。

  • cmaxes: 一个 LineCollection 实例，标记每个小提琴图分布的顶部。

  • cbars: 一个 LineCollection 实例，标记每个小提琴图分布的中心。

  • cmedians: 一个 LineCollection 实例，标记每个小提琴图分布的中位数。

  • cquantiles: 一个 LineCollection 实例，用于识别每个小提琴图分布的分位数。

另请参阅

violinplot

从数据而不是预计算的统计数据绘制小提琴图。

在此页