matplotlib.axes.Axes.errorbar #

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

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

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

参数：

x, y浮点数或类似数组

数据位置。

xerr, yerr float or array-like, shape(N,) or shape(2, N), optional

误差条大小：

标量：所有数据点的对称 +/- 值。
shape(N,)：每个数据点的对称 +/- 值。
shape(2, N)：为每个条形分隔 - 和 + 值。第一行包含较低的错误，第二行包含较高的错误。
无：没有错误栏。

所有值必须 >= 0。

有关和的用法的示例，请参见指定误差线的不同方式。xerryerr

fmt str，默认值：''

数据点/数据线的格式。详情请参阅plot。

使用“无”（不区分大小写）绘制没有任何数据标记的误差线。

ecolor颜色，默认：无

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

elinewidth浮点数，默认值：无

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

翻船浮动，默认值：（rcParams["errorbar.capsize"]默认值0.0：）

误差线上限的长度（以磅为单位）。

capthick浮动，默认值：无

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

barabove bool，默认值：False

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

lolims, uplims, xlolims, xuplims bool, 默认值：False

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

errorevery int 或 (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

容器包含：

plotline：Line2Dx、y 绘图标记和/或线的实例。
caplines：Line2D误差线上限实例的元组。
barlinecols：LineCollection具有水平和垂直误差范围的元组。

其他参数：

数据可索引对象，可选

如果给定，以下参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）：

x , y , xerr ,耶尔

**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 是：

破折号
dash_capstyle
dash_joinstyle
画风
填充样式
线型
标记
标记边缘颜色
标记边宽
标记面颜色
标记面coloralt
标记大小
马克韦尔
solid_capstyle
solid_joinstyle

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

财产	描述
`agg_filter`	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
`alpha`	标量或无
`animated`	布尔
`antialiased`或aa	布尔
`clip_box`	`Bbox`
`clip_on`	布尔
`clip_path`	补丁或（路径，变换）或无
`color`或 c	颜色
`dash_capstyle`	`CapStyle`或 {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle`或 {'miter', 'round', 'bevel'}
`dashes`	浮动序列（以点为单位的开/关墨水）或（无，无）
`data`	(2, N) 数组或两个一维数组
`drawstyle`或 ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值：'default'
`figure`	`Figure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	颜色或无
`gid`	字符串
`in_layout`	布尔
`label`	目的
`linestyle`或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth`或 lw	漂浮
`marker`	标记样式字符串，`Path`或`MarkerStyle`
`markeredgecolor`或机械	颜色
`markeredgewidth`或者喵喵	漂浮
`markerfacecolor`或 mfc	颜色
`markerfacecoloralt`或 mfcalt	颜色
`markersize`或毫秒	漂浮
`markevery`	无或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
`mouseover`	布尔
`path_effects`	`AbstractPathEffect`
`picker`	浮动或可调用[[艺术家，事件]，元组[布尔，字典]]
`pickradius`	未知
`rasterized`	布尔
`sketch_params`	（比例：浮动，长度：浮动，随机性：浮动）
`snap`	布尔或无
`solid_capstyle`	`CapStyle`或 {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle`或 {'miter', 'round', 'bevel'}
`transform`	未知
`url`	字符串
`visible`	布尔
`xdata`	一维数组
`ydata`	一维数组
`zorder`	漂浮