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: 数据集的名称（str）。如果可用，这将作为箱线图的刻度标签。

职位类数组, 默认: [1, 2, ..., n]

盒子的位置。刻度和限制会自动设置以匹配这些位置。

宽度浮点数或类似数组的对象，默认值：None

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

capwidths浮点数或类似数组的对象，默认值：None

可以是标量或向量，并设置每个帽的宽度。默认值是 0.5*(盒子的宽度)，参见 宽度。

vertbool, 可选

自 3.10 版本弃用: 使用 orientation 代替。

如果在弃用期间给出此参数，它将覆盖 orientation 参数。

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

方向{'垂直', '水平'}, 默认: '垂直'

如果为 'horizontal'，则水平绘制盒子。否则，垂直绘制盒子。

Added in version 3.10.

patch_artistbool, 默认: False

如果 False 生成带有 Line2D 艺术家的框。如果 True 生成带有 Patch 艺术家的框。

shownotches, showmeans, showcaps, showbox, showfliers布尔

是否绘制CI缺口、均值（两者默认均为False）、帽、箱和离群值（这三者默认均为True）。

boxprops, whiskerprops, capprops, flierprops, medianprops, meanpropsdict, 可选

用于箱体、须线、帽线、离群值、中位数和均值的艺术家属性。

meanlinebool, 默认: False

如果 True （并且 showmeans 是 True），将尝试根据 meanprops 渲染一条横跨盒子的全宽的线来表示均值。如果 shownotches 也是 True，则不推荐使用。否则，均值将以点的形式显示。

管理刻度bool, 默认值: True

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

标签str 或 str 列表，可选

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

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

Added in version 3.9.

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

生成的箱线图的zorder。

返回:
dict

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

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

  • medians: 每个盒子的中位数处的水平线。

  • whiskers: 垂直线延伸至最后一个非异常值的数据点。

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

  • fliers: 表示超出须线（fliers）的数据点。

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

参见

箱线图

从数据中绘制箱线图，而不是使用预先计算的统计数据。

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

分离箱线图的计算和绘制

Separate calculation and plotting of boxplots
On this page