seaborn.boxenplot#

seaborn.boxenplot(data=None, *, x=None, y=None, hue=None, order=None, hue_order=None, orient=None, color=None, palette=None, saturation=0.75, fill=True, dodge='auto', width=0.8, gap=0, linewidth=None, linecolor=None, width_method='exponential', k_depth='tukey', outlier_prop=0.007, trust_alpha=0.05, showfliers=True, hue_norm=None, log_scale=None, native_scale=False, formatter=None, legend='auto', scale=<deprecated>, box_kws=None, flier_kws=None, line_kws=None, ax=None, **kwargs)[源代码]#

为较大的数据集绘制增强的箱线图。

这种图表最初被称为“字母值”图，因为它展示了许多被定义为“字母值”的分位数。它类似于箱线图，绘制了一个分布的非参数表示，其中所有特征都对应于实际观测值。通过绘制更多的分位数，它提供了关于分布形状的更多信息，特别是在尾部。

更多信息请参见 教程。

备注

默认情况下，此函数将其中一个变量视为分类变量，并在相关轴上按序数位置（0, 1, … n）绘制数据。自版本0.13.0起，可以通过设置 native_scale=True 来禁用此功能。

参数:
数据DataFrame, Series, 字典, 数组, 或数组列表

用于绘图的数据集。如果 x 和 y 不存在，则解释为宽格式。否则，预期为长格式。

x, y, hue : data 中的变量名称或向量数据变量名

绘制长格式数据的输入。请参阅示例以进行解释。

order, hue_order字符串列表

指定分类级别的绘制顺序；否则，级别将从数据对象中推断。

orient“v” | “h” | “x” | “y”

图形的方向（垂直或水平）。这通常根据输入变量的类型推断，但在 x 和 y 都是数值或绘制宽格式数据时，可以用来解决歧义。

在 v0.13.0 版本发生变更: 添加了 ‘x’/’y’ 作为选项，等同于 ‘v’/’h’。

颜色matplotlib 颜色

图表中元素的单一颜色。

调色板调色板名称、列表或字典

用于 hue 变量不同级别的颜色。应该是可以被 color_palette() 解释的内容，或者是一个将色调级别映射到 matplotlib 颜色的字典。

饱和度浮动

用于绘制填充颜色的原始饱和度比例。大面积的色块通常用去饱和的颜色看起来更好，但如果您希望颜色与输入值完全匹配，请将其设置为 1。

填充布尔

如果为真，使用实心填充。否则，绘制为线条艺术。

在 v0.13.0 版本加入.

躲避“auto” 或 bool

当使用色调映射时，是否应沿方向轴缩小和移动元素以消除重叠。如果为 "auto"，则在方向变量与分类变量交叉时设置为 True，否则设置为 False。

在 0.13.0 版本发生变更: 新增了 "auto" 模式作为新的默认设置。

宽度浮动

在方向轴上分配给每个元素的宽度。当 native_scale=True 时，它是相对于原生刻度中两个值之间的最小距离的。

间隙浮动

按此因子在方向轴上缩小，以在躲避的元素之间添加间隙。

在 0.13.0 版本加入.

行宽浮动

包围绘图元素的线条宽度。

linecolor颜色

当 fill 为 True 时，用于线条元素的颜色。

在 v0.13.0 版本加入.

width_method{“exponential”, “linear”, “area”}

用于字母值框宽度的方法：

  • "exponential"：表示相应的百分位数

  • "linear"：每个盒子减少一个固定量

  • "area": 表示该框中数据点的密度

k_depth{“tukey”, “比例”, “可信”, “完整”} 或 int

在每个尾部计算和绘制的层数：

  • "tukey": 使用 log2(n) - 3 层级，覆盖与箱线图须相似的范围

  • "proportion"：大约留下 outlier_prop 个离群值

  • "trusthworthy"：扩展到至少具有 trust_alpha 置信度的级别

  • “full”：使用 log2(n) + 1 层级，并扩展到最极端的点

outlier_prop浮动

预期为异常值的数据比例；当 k_depth="proportion" 时使用。

信任_阿尔法浮动

最极端水平的置信度阈值；当 k_depth="trustworthy" 时使用。

showfliers布尔

如果为 False，则抑制异常值的绘图。

hue_norm : 元组或 matplotlib.colors.Normalize 对象元组或

应用于 hue 变量时的数据单位归一化，当 hue 为数值型时。如果 hue 是分类变量，则不相关。

在 v0.12.0 版本加入.

log_scale布尔值或数字，或布尔值或数字对

将轴比例设置为对数。单个值设置图中任何数值轴的数据轴。一对值分别独立设置每个轴。数值被解释为所需的对数底数（默认10）。当为 None 或 False 时，seaborn 将遵循现有的 Axes 比例。

在 v0.13.0 版本加入.

native_scale布尔

当为 True 时，分类轴上的数值或日期时间值将保持其原始比例，而不是被转换为固定索引。

在 v0.13.0 版本加入.

格式化器可调用

用于将分类数据转换为字符串的函数。影响分组和刻度标签。

在 v0.13.0 版本加入.

图例“auto”、“brief”、“full”或False

如何绘制图例。如果为“brief”，数值型的 hue 和 size 变量将用均匀间隔的值样本表示。如果为“full”，每个组都会在图例中获得一个条目。如果为“auto”，则根据级别的数量在简短或完整表示之间选择。如果为 False，则不会添加图例数据，也不会绘制图例。

在 v0.13.0 版本加入.

box_kws: dict

box artists 的关键字参数；传递给 matplotlib.patches.Rectangle。

在 v0.12.0 版本加入.

line_kws: dict

表示中位数线的关键字参数；传递给 matplotlib.axes.Axes.plot()。

在 v0.12.0 版本加入.

flier_kws: dict

用于表示异常观测值的散点图的关键字参数；传递给 matplotlib.axes.Axes.scatter()。

在 v0.12.0 版本加入.

axmatplotlib Axes

要在其上绘制图形的 Axes 对象，否则使用当前的 Axes。

kwargs键, 值 映射

其他关键字参数传递给 matplotlib.patches.Rectangle，被 box_kws 中的参数覆盖。

返回:
axmatplotlib Axes

返回带有绘图的 Axes 对象。

参见

violinplot

箱线图和核密度估计的结合。

boxplot

一个具有类似API的传统箱线图。

catplot

将分类图与 FacetGrid 结合。

注释

要获得更详细的解释，您可以阅读介绍该图形的论文：https://vita.had.co.nz/papers/letter-value-plot.html

示例