matplotlib.axes.Axes.boxplot

Axes.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, *, data=None)[源代码]

制作一个盒子和胡须图。

为每列 x 或按顺序排列的每个向量 x . 该框从数据的下四分位数扩展到上四分位数，中间有一条线。胡须从盒子里伸出来显示数据的范围。飞点是那些超过胡须末端的点。

参数:
x向量数组或向量序列。

输入数据。

notchbool，默认值：False

是否绘制注框图 (True )，或矩形方框图 (False ). 缺口代表中位数周围的置信区间（CI）。的文档 引导程序 描述如何计算切口的位置。

注解

如果CI值小于下四分位数或大于上四分位数，则槽口将延伸到方框之外，使其具有独特的“翻转”外观。这是预期的行为，并且与其他统计可视化包一致。

sym可选的STR

传单点的默认符号。空字符串（''）隐藏传单。如果 None ，则传单默认为“b+”。更多的控制由 飞碟 参数。

vertbool，默认值：True

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

whisfloat或（float，float），默认值：1.5

胡须的位置。

如果是浮子，下触须位于上面的最低基准 Q1 - whis*(Q3-Q1) ，以及下面最高基准面上的晶须 Q3 + whis*(Q3-Q1) ，其中Q1和Q3是第一个和第三个四分位数。的默认值 whis = 1.5 对应于Tukey最初对boxplots的定义。

如果一对浮点数，它们表示绘制胡须的百分位数（例如，（5，95））。尤其是，将此值设置为（0，100）会导致胡须覆盖整个数据范围。”range”是（0，100）的已弃用同义词。

在边缘的情况下，在哪里 Q1 == Q3 ， whis 如果 奥特罗姆 是True。

在触须之外，数据被视为异常值，并绘制为单独的点。

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) . 非“无”的每个条目都会强制对应槽口的位置（仅当 缺口 是 True ). 对于 None ，则通过其他参数指定的方法计算切口（例如。， 引导程序 ）

positions类似数组，可选

设置框的位置。刻度和限制将自动设置为与位置匹配。默认为 range(1, N+1) 其中n是要绘制的框数。

widths浮点数或类似数组的

使用标量或序列设置每个框的宽度。默认值为0.5，或 0.15*(distance between extreme positions) 如果这是较小的。

patch_artistbool，默认值：False

如果 False 使用Line2d艺术家制作方框。否则，盒和贴片艺术家绘制。

labels序列，可选

每个数据集的标签（每个数据集一个）。

manage_ticksbool，默认值：True

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

autorangebool，默认值：False

什么时候？ True 数据的分布使得25%和75%相等， whis 设置为（0，100），使得晶须末端位于数据的最小值和最大值。

meanlinebool，默认值：False

如果 True （和 展示手段 是 True ，将尝试将平均值呈现为一条跨越方框全宽的线，根据 吝啬鬼 （见下文）。不建议，如果 显示缺口 这也是事实。否则，方法将显示为点。

Z阶 ：float，默认值： Line2D.zorder = 2浮动，默认值：

设置箱线图的zorder。
返回:
双关语

将箱线图的每个组件映射到 Line2D 实例已创建。该字典有以下键（假设为垂直箱线图）：

  • boxes ：框线图的主体，显示四分位数和中位数的置信区间（如果启用）。
  • medians ：每个方框中间的水平线。
  • whiskers ：延伸至最极端、非异常数据点的垂直线。
  • caps ：胡须末端的水平线。
  • fliers ：表示超出胡须（传单）范围的数据的点。
  • means ：表示平均值的点或线。
其他参数:
showcapsbool，默认值：True

把帽子戴在胡须的末端。

showboxbool，默认值：True

显示中心框。

showfliersbool，默认值：True

显示超出上限的异常值。

showmeansbool，默认值：False

显示算术平均值。

cappropsdict，默认值：无

帽子的样式。

boxpropsdict，默认值：无

盒子的样式。

whiskerpropsdict，默认值：无

胡须的样式。

flierpropsdict，默认值：无

传单的风格。

medianpropsdict，默认值：无

中间带的样式。

meanpropsdict，默认值：无

中庸的风格。

笔记

注解

除了上述参数外，此函数还可以 data 关键字参数。如果这样的话 data 参数，其他每个参数也可以是字符串 s ，解释为 data[s] （除非引起例外）。

作为传递的对象 data 必须支持项目访问 (data[s] ）和会员资格测试 (s in data ）