matplotlib.axes.Axes.errorbar#

Axes.errorbar(x, y, yerr=None, xerr=None, fmt='', *, ecolor=None, elinewidth=None, capsize=None, barsabove=False, lolims=False, uplims=False, xlolims=False, xuplims=False, errorevery=1, capthick=None, data=None, **kwargs)[source]#

将 y 对 x 绘制为带有误差线的线和/或标记。

x, y 定义数据位置，xerr, yerr 定义误差条大小。默认情况下，此函数会绘制数据标记/线条以及误差条。使用 fmt='none' 可以仅绘制误差条而不绘制任何数据标记。

版本 3.7 新增: 在极坐标图中，端点帽和误差线以极坐标绘制。

参数:

x, y浮点数或类数组对象

数据位置。

xerr, yerr浮点数或类数组对象，形状为 (N,) 或 (2, N)，可选

误差条大小

标量：所有数据点的对称 +/- 值。
形状为 (N,)：每个数据点的对称 +/- 值。
形状(2, N)：每个条形图的单独 - 和 + 值。第一行包含较低误差，第二行包含较高误差。
None：无误差条。

所有值必须 >= 0。

有关 xerr 和 yerr 的用法示例，请参阅指定误差条的不同方式。

fmtstr，默认值：''

数据点/数据线的格式。有关详细信息，请参阅plot。

使用 'none'（不区分大小写）可以仅绘制误差条而不绘制任何数据标记。

ecolor颜色，默认值：None

误差线的颜色。如果为 None，则使用连接标记的线条颜色。

elinewidth浮点数，默认值：None

误差线的线宽。如果为 None，则使用当前样式的线宽。

capsize浮点数，默认值：rcParams["errorbar.capsize"]（默认值：0.0）

误差线帽的长度（以点为单位）。

capthick浮点数，默认值：None

关键字参数 markeredgewidth（又称 mew）的别名。此设置是用于控制误差条端点帽以点为单位的厚度的属性的更合理的名称。

为了向后兼容，如果提供了 mew 或 markeredgewidth，它们将覆盖 capthick。这在未来的版本中可能会有所改变。

barsabove布尔值，默认值：False

如果为 True，误差条将绘制在绘图符号的上方。默认在下方。

lolims, uplims, xlolims, xuplims布尔值或类数组对象，默认值：False

这些参数可用于指示一个值仅表示上限/下限。在这种情况下，将使用一个尖角符号来表示。lims 参数可以是标量，也可以是与 xerr 和 yerr 长度相同的类数组对象。要与反转轴一起使用限制，必须在调用 set_xlim 或 set_ylim 之前调用 errorbar()。请注意这些容易混淆的参数名称：例如，将 lolims 设置为 True 意味着 y 值是真实值的下限，因此只会绘制一个向上指向的箭头！

errorevery整数或 (整数, 整数)，默认值：1

返回:

在数据的子集上绘制误差条。errorevery = N 会在点 (x[::N], y[::N]) 上绘制误差条。errorevery = (start, N) 会在点 (x[start::N], y[start::N]) 上绘制误差条。例如，errorevery=(6, 3) 会在 (x[6], x[9], x[12], x[15], ...) 处的数据添加误差条。用于避免当两个系列共享 x 轴值时误差条重叠。

ErrorbarContainer

容器包含
data_line : x, y 绘图标记和/或线条的 Line2D 实例。
caplines : 误差条端点帽的 Line2D 实例元组。

其他参数:

data可索引对象，可选

barlinecols : 带有水平和垂直误差范围的 LineCollection 元组。

如果给出，以下参数也接受字符串 s，如果 s 是 data 中的键，则将其解释为 data[s]

x, y, xerr, yerr

**kwargs

x, y, yerr = rand(3, 10)
errorbar(x, y, yerr, marker='s', mfc='red',
         mec='green', ms=20, mew=4)

所有其他关键字参数都会传递给绘制标记的 plot 调用。例如，此代码绘制了带有粗绿色边缘的红色大方块

其中 mfc、mec、ms 和 mew 是较长属性名称，即 markerfacecolor、markeredgecolor、markersize 和 markeredgewidth 的别名。

标记属性的有效 kwargs 包括
dashes
dash_capstyle
dash_joinstyle
drawstyle
fillstyle
linestyle
marker
markeredgecolor
markeredgewidth
markerfacecolor
markerfacecoloralt
markersize
markevery
solid_capstyle

solid_joinstyle

属性	描述
`有关更多详细信息，请参阅相应的` `Line2D 属性`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`agg_filter`	浮点数或 None
`alpha`	布尔值
`antialiased` or `aa`	布尔值
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔值
`clip_path`	Patch 或 (Path, Transform) 或 None
`color` or `c`	color
`dashes`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`dash_capstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`标记属性的有效 kwargs 包括`	浮点数序列（点中的开/关墨迹）或 (None, None)
`data`	(2, N) 数组或两个一维数组
`drawstyle` or `ds`	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值: 'default'
`figure`	`Figure` or `SubFigure`
`drawstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	颜色或 None
`gid`	str
`in_layout`	布尔值
`label`	object
`linestyle` or `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` or `lw`	浮点数
`linestyle`	标记样式字符串，`Path` 或 `MarkerStyle`
`markeredgecolor` or `mec`	color
`markeredgewidth` or `mew`	浮点数
`markerfacecolor` or `mfc`	color
`markerfacecoloralt` or `mfcalt`	color
`markersize` or `ms`	浮点数
`markersize`	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
`mouseover`	布尔值
`path_effects`	`AbstractPathEffect` 列表
`picker`	浮点数或 callable[[Artist, Event], tuple[bool, dict]]
`pickradius`	浮点数
`rasterized`	布尔值
`sketch_params`	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
`snap`	布尔值或 None
`markevery`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`solid_capstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`transform`	未知
`url`	str
`visible`	布尔值
`xdata`	一维数组
`ydata`	一维数组
`zorder`	浮点数