seaborn.boxplot

seaborn.boxplot(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, whis=1.5, linecolor='auto', linewidth=None, fliersize=None, hue_norm=None, native_scale=False, log_scale=None, formatter=None, legend='auto', 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 版本加入.

whis浮点数或一对浮点数

控制须长度的参数。如果是标量，须会画到距离最近铰链 whis * IQR 范围内的最远数据点。如果是元组，则解释为须所代表的百分位数。

linecolor颜色

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

在 v0.13.0 版本加入.

行宽浮动

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

fliersize浮动

用于指示异常观测值的标记大小。

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 版本加入.

axmatplotlib Axes

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

kwargs键, 值 映射

其他关键字参数会传递给 matplotlib.axes.Axes.boxplot()。

返回:

axmatplotlib Axes

返回带有绘图的 Axes 对象。

参见

violinplot

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

stripplot

一个散点图，其中一变量为分类变量。可以与其他图表结合使用，以显示每个观察结果。

swarmplot

一个分类散点图，其中点不会重叠。可以与其他图表一起使用，以显示每个观察结果。

catplot

将分类图与 FacetGrid 结合。

示例