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)[源代码][源代码]#

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

x, y 定义数据位置，xerr, yerr 定义误差条大小。默认情况下，这会绘制数据标记/线条以及误差条。使用 fmt='none' 来绘制没有数据标记的误差条。

Added in version 3.7: 大写字母和错误线在极坐标图上以极坐标绘制。

参数:

x, y浮点数或类似数组

数据位置。

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

误差条大小：

scalar: 所有数据点的对称 +/- 值。
shape(N,): 每个数据点的对称正负值。
shape(2, N): 为每个条形图分别提供 - 和 + 值。第一行包含较低的误差，第二行包含较高的误差。
None: 无误差条。

所有值必须 >= 0。

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

fmtstr, 默认值: ''

数据点/数据行的格式。详情请参见 plot。

使用 'none'（不区分大小写）来绘制没有数据标记的误差线。

ecolor : color, 默认: None颜色, 默认值: None

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

elinewidth浮点数，默认值：无

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

capsize : float, 默认值: rcParams["errorbar.capsize"] (default: 0.0)浮点数，默认值：

误差条帽子的长度，单位为点。

capthick浮点数，默认值：无

关键字参数 markeredgewidth*（又名 *mew）的别名。此设置是控制误差条帽厚度的属性的更合理的名称，单位为点。为了向后兼容，如果给出了 mew 或 markeredgewidth，那么它们将覆盖 capthick。这可能在未来的版本中发生变化。

barsabovebool, 默认值: False

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

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

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

erroreveryint 或 (int, int)，默认值：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 : 一个 Line2D 实例，表示 x, y 图的标记和/或线条。
caplines : 一个包含误差条帽的 Line2D 实例的元组。
barlinecols : 一个包含 LineCollection 的元组，表示水平和垂直误差范围。

其他参数:

数据可索引对象，可选

如果提供，以下参数还接受一个字符串 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 的别名。

标记属性的有效关键字参数包括：

dashes
dash_capstyle
dash_joinstyle
drawstyle
fillstyle
linestyle
标记
markeredgecolor
markeredgewidth
markerfacecolor
markerfacecoloralt
markersize
markevery
solid_capstyle
solid_joinstyle

更多详情请参考相应的 Line2D 属性：

属性	描述
`agg_filter`	一个过滤函数，它接收一个 (m, n, 3) 的浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
`alpha`	标量或无
`animated`	布尔
`抗锯齿` 或 aa	布尔
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔
`clip_path`	补丁或（路径，变换）或无
`颜色` 或 c	color
`dash_capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`dashes`	浮点数序列（开/关墨水以点为单位）或 (None, None)
`数据`	(2, N) 数组或两个一维数组
`drawstyle` 或 ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, 默认: 'default'
`figure`	`Figure` 或 `SubFigure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	color or None
`gid`	str
`in_layout`	布尔
`标签`	对象
`linestyle` 或 ls	{'-', '--', '-.', ':', '', (偏移, 开关序列), ...}
`linewidth` 或 lw	float
`标记`	标记样式字符串，`Path` 或 `MarkerStyle`
`markeredgecolor` 或 mec	color
`markeredgewidth` 或 mew	float
`markerfacecolor` 或 mfc	color
`markerfacecoloralt` 或 mfcalt	color
`markersize` 或 ms	float
`markevery`	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
`鼠标悬停`	布尔
`path_effects`	`AbstractPathEffect` 的列表
`picker`	浮点数或可调用对象[[Artist, Event], 元组[布尔值, 字典]]
`pickradius`	float
`光栅化`	布尔
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	布尔值或无
`solid_capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`transform`	未知
`url`	str
`可见`	布尔
`xdata`	一维数组
`ydata`	一维数组
`zorder`	float