Python matplotlib boxplot用法及代码示例

本文简要介绍 python 语言中 matplotlib.pyplot.boxplot 的用法。

用法

matplotlib.pyplot.boxplot(x, notch=None, sym=None, vert=None, whis=None, positions=None, widths=None, patch_artist=None, bootstrap=None, usermedians=None, conf_intervals=None, meanline=None, showmeans=None, showcaps=None, showbox=None, showfliers=None, boxprops=None, labels=None, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_ticks=True, autorange=False, zorder=None, capwidths=None, *, data=None)

绘制箱须图。

该框从数据的第一个四分位数 (Q1) 延伸到第三个四分位数 (Q3)，中间有一条线。须线从方框延伸到距方框 1.5 倍四分位数范围 (IQR) 内的最远数据点。飞行点是那些超出胡须末端的点。请参阅https://en.wikipedia.org/wiki/Box_plot 以供参考。

Q1-1.5IQR   Q1   median  Q3   Q3+1.5IQR
                  |-----:-----|
  o      |--------|     :     |--------|    o  o
                  |-----:-----|
flier             <----------->            fliers
                       IQR

参数：

x 数组或向量序列。

输入数据。如果是二维数组，则会为 x 中的每一列绘制一个箱线图。如果是一维数组序列，则会为 x 中的每个数组绘制箱线图。

notch 布尔值，默认值：假

是绘制一个缺口箱线图 ( True )，还是一个矩形箱线图 ( False )。缺口代表中位数周围的置信区间 (CI)。 bootstrap 的文档说明了默认情况下如何计算槽口的位置，但也可以通过设置 conf_intervals 参数来覆盖它们的位置。

注意

在 CI 值小于下四分位数或大于上四分位数的情况下，缺口将延伸到盒子之外，使其具有独特的 "flipped" 外观。这是预期的行为，并且与其他统计可视化包一致。

sym str，可选

飞行点的默认符号。空字符串 ('') 隐藏传单。如果 None ，则传单默认为 'b+'。 flierprops 参数提供更多控制。

vert 布尔值，默认值：真

如果 True ，则绘制垂直框。如果 False ，绘制水平框。

whis 浮点数或(浮点数，浮点数)，默认值：1.5

胡须的位置。

如果是浮点数，则下须线位于 Q1 - whis*(Q3-Q1) 上方的最低基准处，而上方须线位于 Q3 + whis*(Q3-Q1) 下方的最高基准处，其中 Q1 和 Q3 是第一和第三四分位数。 whis = 1.5 的默认值对应于 Tukey 对箱线图的原始定义。

如果是一对浮点数，它们表示绘制胡须的百分位数(例如，(5, 95))。特别是，将其设置为 (0, 100) 会导致胡须覆盖整个数据范围。

在 Q1 == Q3 的边情况下，如果 autorange 为 True，则 whis 会自动设置为 (0, 100)(覆盖整个数据范围)。

除了胡须，数据被认为是异常值，并被绘制为单个点。

bootstrap 整数，可选

指定是否在缺口箱线图的中位数附近引导置信区间。如果bootstrap 为无，则不执行自举，并使用基于高斯的渐近近似计算缺口(参见 McGill, R.、Tukey, J.W. 和 Larsen, W.A., 1978 以及 Kendall 和 Stuart, 1967)。否则，bootstrap 指定引导中位数以确定其 95% 置信区间的次数。建议使用 1000 到 10000 之间的值。

usermedians 一维数组，可选

长度为 len(x) 的类似一维数组。每个不是 None 的条目都会强制使用相应数据集的中位数。对于 None 的条目，中位数由 Matplotlib 正常计算。

conf_intervals 类似数组，可选

形状为 (len(x), 2) 的类似二维数组。每个不是 None 的条目都会强制指定相应凹口的位置(仅当 notch 为 True 时才绘制)。对于 None 的条目，缺口是通过其他参数指定的方法(例如 bootstrap )计算的。

positions 类似数组，可选

箱子的位置。刻度线和限制会自动设置以匹配位置。默认为range(1, N+1)，其中 N 是要绘制的框数。

widths 浮点或类似数组

盒子的宽度。默认值为 0.5 或 0.15*(distance between extreme positions) (如果较小)。

patch_artist 布尔值，默认值：假

如果 False 使用 Line2D 艺术家生成框。否则，将使用 Patch 艺术家绘制框。

labels 顺序，可选

每个数据集的标签(每个数据集一个)。

manage_ticks 布尔值，默认值：真

如果为 True，将调整刻度位置和标签以匹配箱线图位置。

autorange 布尔值，默认值：假

当 True 和数据分布使得第 25 个和第 75 个百分位数相等时，whis 设置为 (0, 100)，使得须线末端位于数据的最小值和最大值处。

meanline 布尔值，默认值：假

如果 True (并且 showmeans 是 True )，将尝试根据 meanprops 将平均值呈现为跨越框的整个宽度的线(见下文)。如果 shownotches 也是 True，则不推荐。否则，均值将显示为点。

zorder 浮点数，默认：Line2D.zorder = 2

箱线图的 zorder。

返回：

dict

将箱线图的每个组件映射到创建的 Line2D 实例列表的字典。该字典具有以下键(假设垂直箱线图)：

• boxes ：箱线图的主体显示四分位数和中位数的置信区间(如果启用)。

• medians ：每个盒子中间的水平线。

• whiskers：垂直线延伸到最极端的非异常数据点。

• caps ：胡须末端的水平线。

• fliers ：表示超出胡须(飞行物)的数据的点。

• means ：表示均值的点或线。

其他参数：

showcaps 布尔值，默认值：真

显示胡须末端的帽子。

showbox 布尔值，默认值：真

显示中央框。

showfliers 布尔值，默认值：真

显示超出上限的异常值。

showmeans 布尔值，默认值：假

显示算术平均值。

capprops 字典，默认值：无

帽子的样式。

capwidths 浮点数或数组，默认值：无

帽子的宽度。

boxprops 字典，默认值：无

盒子的样式。

whiskerprops 字典，默认值：无

胡须的样式。

flierprops 字典，默认值：无

传单的风格。

medianprops 字典，默认值：无

中位数的样式。

meanprops 字典，默认值：无

中庸的风格。

data 可索引对象，可选

如果给定，所有参数也接受一个字符串 s ，它被解释为 data[s] (除非这引发异常)。