matplotlib.axes.Axes.violin

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

从预计算的统计数据中绘制小提琴图。

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

参数:

vpstats列表字典

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

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

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

• mean: 这个小提琴图数据集的平均值。

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

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

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

可选键包括：

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

职位类似数组，默认值：[1, 2, ..., n]

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

垂直bool, 可选

自 3.10 版本弃用: 使用 orientation 代替。

如果在弃用期间给出此参数，它将覆盖 orientation 参数。

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

方向{'vertical', 'horizontal'}, 默认: 'vertical'

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

Added in version 3.10.

宽度浮点数或类似数组的对象，默认值：0.5

每个小提琴图的最大宽度，以 positions 轴的单位表示。默认值是 0.5，当使用默认 positions 时，这是可用空间的一半。

显示均值bool, 默认值: False

是否用一条线显示平均值。

显示极值bool, 默认值: True

是否用线条显示极值。

showmediansbool, 默认值: False

是否用线条显示中位数。

侧边{'both', 'low', 'high'}, 默认: 'both'

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

返回:

dict

一个字典，将小提琴图的每个组成部分映射到相应的集合实例列表。该字典具有以下键：

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

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

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

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

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

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

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

参见

小提琴

从数据中绘制小提琴图，而不是使用预先计算的统计数据。