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'绘制没有任何数据标记的误差线。

参数:
x, y浮点数或类似数组的

数据位置。

谢尔浮点或数组状，形状（N，）或形状（2，N），可选

误差条大小：

  • 标量：所有数据点的对称+/-值。
  • 形状（n，）：每个数据点的对称+/-值。
  • 形状（2，N）：为每个条形图单独设置-和+值。第一行包含下面的错误，第二行包含上面的错误。
  • None 没有错误栏。

请注意，所有错误数组都应该 积极的 价值观。

见 指定误差线的不同方法 例如 xerr 和 yerr .

fmtstr，默认值：“”

数据点/数据行的格式。见 plot 有关详细信息。

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

ecolor颜色，默认值：无

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

elinewidth浮点，默认值：无

误差线的线条宽度。如果没有，则使用当前样式的线条宽度。

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

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

capthick浮点，默认值：无

关键字参数的别名 标记宽度 （又名 mew ）对于控制点中误差线帽厚度的属性，此设置是更合理的名称。为了向后兼容，如果 mew 或 标记宽度 如果给了他们，他们就会骑过头了 卡普斯 . 这在将来的版本中可能会改变。

barsabovebool，默认值：False

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

lolims、uplms、xlolims、xuplimsbool，默认值：False

这些参数可用于指示值仅给出上限/下限。在这种情况下，使用插入符号来表示这一点。 lims -参数可以是标量，也可以是与 xerr 和 yerr . 使用倒轴限制， set_xlim 或 set_ylim 必须在之前调用 errorbar() . 注意棘手的参数名称：设置例如。 洛利姆斯 为True表示y值为 降低 真值的极限，所以，只有 向上的 -将绘制指向箭头！

erroreveryint或（int，int），默认值：1

在数据子集上绘制误差线。 每一个错误 =N在点（x）上绘制误差线 [::N] Y [::N] ） 每一个错误 =（start，N）在点（x）上绘制误差线 [开始：：N] Y [开始：：N] ). e、 g.errorevery=（6，3）将误差条添加到（x）处的数据 [6] ，X [9] ，X [12] ，X [15] , ...). 当两个系列共享x轴值时，用于避免误差条重叠。
返回:
ErrorbarContainer

容器包含：

  • 情节主线： Line2D X、Y绘图标记和/或线条的实例。
  • Caplines:一组 Line2D 误差线帽的实例。
  • BarlineCols：一个 LineCollection 水平和垂直误差范围。
其他参数:
**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 是较长属性名的别名， 标记彩色 ， 标记彩色图像 ， 标记尺寸 和 标记宽度 .

标记属性的有效Kwarg为 Line2D 性能：

财产 描述
agg_filter 一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha 浮动或无
animated 布尔
antialiased 或者aa 布尔
clip_box Bbox
clip_on 布尔
clip_path 面片或（路径、变换）或无
color 或c 颜色
contains 未知的
dash_capstyle “对接”、“圆形”、“突出”
dash_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'
gid STR
in_layout 布尔
label 对象
linestyle 或ls '-'、'-'、'-'、'-'、'：'、'、'、'（偏移量、开/关顺序）、…
linewidth 或lw 浮动
marker 标记样式字符串， Path 或 MarkerStyle
markeredgecolor 或mec 颜色
markeredgewidth 或者喵喵 浮动
markerfacecolor 或mfc 颜色
markerfacecoloralt 或mfcalt 颜色
markersize 或ms 浮动
markevery None或int or（int，int）或slice或List [int] 或float或（float，float）或List [bool]
path_effects AbstractPathEffect
picker 未知的
pickradius 浮动
rasterized 布尔或无
sketch_params （比例：浮动，长度：浮动，随机性：浮动）
snap 布尔或无
solid_capstyle “对接”、“圆形”、“突出”
solid_joinstyle 'miter'、'round'、'bevel'
transform matplotlib.transforms.Transform
url STR
visible 布尔
xdata 一维阵列
ydata 一维阵列
zorder 浮动

笔记

注解

除了上述参数外，此函数还可以 data 关键字参数。如果这样的话 data 参数，下列参数也可以是字符串 s ，解释为 data[s] （除非引起例外）： x ， y ， xerr ， yerr .

作为传递的对象 data 必须支持项目访问 (data[s] ）和会员资格测试 (s in data ）