matplotlib.pyplot.errorbar#

matplotlib.pyplot.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。这在未来的版本中可能会有所改变。

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

barsabove布尔值，默认值：False

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

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

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

在数据子集上绘制误差条。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 : 一个 Line2D 实例，用于 x, y 绘图标记和/或线条。
caplines : 一个包含误差条帽的 Line2D 实例元组。
barlinecols : 一个包含水平和垂直误差范围的 LineCollection 元组。

其他参数:

data可索引对象，可选

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

x, y, xerr, yerr

**kwargs

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

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

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

标记属性的有效 kwargs 包括

dashes
dash_capstyle
dash_joinstyle
dash_joinstyle
fillstyle
linestyle
marker
marker
markeredgecolor
markeredgewidth
markerfacecolor
markerfacecoloralt
markevery
solid_capstyle
solid_joinstyle

有关更多详细信息，请参阅相应的 Line2D 属性

属性	描述
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`alpha`	浮点数或 None
`animated`	布尔值
`antialiased` 或 `aa`	布尔值
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔值
`clip_path`	Patch 或 (Path, Transform) 或 None
`color` 或 `c`	color
`dash_capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`dashes`	浮点数序列（点中的开/关墨迹）或 (None, None)
`data`	(2, N) 数组或两个一维数组
`drawstyle` 或 `ds`	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值: 'default'
`figure`	`Figure` 或 `SubFigure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	颜色或 None
`gid`	str
`in_layout`	布尔值
`label`	object
`linestyle` 或 `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` 或 `lw`	浮点数
`marker`	标记样式字符串，`Path` 或 `MarkerStyle`
`markeredgecolor` 或 `mec`	color
`markeredgewidth` 或 `mew`	浮点数
`markerfacecolor` 或 `mfc`	color
`markerfacecoloralt` 或 `mfcalt`	color
`markersize` 或 `ms`	浮点数
`markevery`	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
`solid_capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`transform`	未知
`url`	str
`visible`	布尔值
`xdata`	一维数组
`ydata`	一维数组
`zorder`	浮点数