matplotlib.axes.Axes.bxp#

Axes.bxp(bxpstats, positions=None, *, widths=None, vert=None, orientation='vertical', patch_artist=False, shownotches=False, showmeans=False, showcaps=True, showbox=True, showfliers=True, boxprops=None, whiskerprops=None, flierprops=None, medianprops=None, capprops=None, meanprops=None, meanline=False, manage_ticks=True, zorder=None, capwidths=None, label=None)[源代码]#

从预计算的统计数据绘制箱线图。

箱体从数据的第一个四分位数q1延伸到第三个四分位数q3，中位数处（med）有一条线。触须从whislow延伸到whishi。异常值点是触须末端以外的标记。请参阅https://en.wikipedia.org/wiki/Box_plot以供参考。

      whislow    q1    med    q3    whishi
                  |-----:-----|
  o      |--------|     :     |--------|    o  o
                  |-----:-----|
flier                                      fliers

注意

这是一个低级绘图函数，适用于您已拥有统计参数的情况。如果您想基于数据集绘制箱线图，请使用boxplot。

参数:
bxpstats字典列表

一个字典列表，包含每个箱线图的统计数据。必需的键有

  • med: 中位数（浮点数）。

  • q1, q3: 第一和第三四分位数（浮点数）。

  • whislo, whishi: 下触须和上触须位置（浮点数）。

可选键有

  • mean: 均值（浮点数）。如果showmeans=True，则需要。

  • fliers: 触须以外的数据（类数组）。如果showfliers=True，则需要。

  • cilo, cihi: 中位数下限和上限置信区间。如果shownotches=True，则需要。

  • label: 数据集名称（字符串）。如果可用，这将用作箱线图的刻度标签

positions类数组，默认值: [1, 2, ..., n]

箱体的位置。刻度线和限制会自动设置为与位置匹配。

widths浮点数或类数组，默认值: None

箱体的宽度。默认值为clip(0.15*(极端位置之间的距离), 0.15, 0.5)。

capwidths浮点数或类数组，默认值: None

可以是标量或向量，设置每个帽的宽度。默认值为0.5*(箱体宽度)，详见widths。

vert布尔值，可选

自 3.11 版本废弃: 请使用orientation代替。

这在 3.10 中是待定废弃，在 3.11 中完全废弃，并在 3.13 中移除。如果在废弃期内提供此参数，它将覆盖orientation参数。

如果为 True，垂直绘制箱体。如果为 False，水平绘制箱体。

orientation{'vertical', 'horizontal'}，默认值: 'vertical'

如果为 'horizontal'，则水平绘制箱体。否则，垂直绘制箱体。

自 3.10 版本新增。

patch_artist布尔值，默认值: False

如果为False，则使用Line2D艺术家生成箱体。如果为True，则使用Patch艺术家生成箱体。

shownotches, showmeans, showcaps, showbox, showfliers布尔值

是否绘制置信区间（CI）刻槽、均值（两者默认为 False）、帽、箱体和异常值（三者均默认为 True）。

boxprops, whiskerprops, capprops, flierprops, medianprops, meanprops字典，可选

箱体、触须、帽、异常值、中位数和均值的艺术家属性。

meanline布尔值，默认值: False

如果为True（且showmeans为True），将尝试根据meanprops将均值渲染为横跨箱体全宽的线。如果shownotches也为 True，则不建议使用。否则，均值将显示为点。

manage_ticks布尔值，默认值: True

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

label字符串或字符串列表，可选

图例标签。当所有箱体样式相同时，并且您只希望它们有一个图例条目时，请使用单个字符串。使用字符串列表单独标记所有箱体。为了可区分，箱体应单独设置样式，这目前只能通过修改返回的艺术家来实现，例如参见箱线图。

在单个字符串的情况下，图例条目在技术上只与第一个箱体关联。默认情况下，图例将显示中位数线（result["medians"]）；如果patch_artist为 True，图例将改为显示箱体Patch艺术家（result["boxes"]）。

自 3.9 版本新增。

zorder浮点数，默认值: Line2D.zorder = 2

生成箱线图的 zorder 值。

返回:
字典

一个字典，将箱线图的每个组件映射到所创建的Line2D实例列表。该字典具有以下键（假设是垂直箱线图）

  • boxes: 箱线图的主体，显示四分位数，如果启用则显示中位数的置信区间。

  • medians: 每个箱体中位数处的水平线。

  • whiskers: 垂直线，直到最后一个非异常值数据。

  • caps: 触须末端的水平线。

  • fliers: 表示触须以外数据（异常值）的点。

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

另请参阅

boxplot

从数据而不是预计算的统计数据绘制箱线图。

使用matplotlib.axes.Axes.bxp的示例#

箱线图的单独计算和绘制

箱线图的单独计算和绘制
在此页