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

将Y和X绘制为带有附加误差线的直线和/或标记。

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

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

数据位置。

谢尔浮点或数组状,形状(N,)或形状(2,N),可选

误差条大小:

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

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

指定误差线的不同方法 例如 xerryerr .

fmtstr,默认值:“”

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

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

ecolor颜色,默认值:无

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

elinewidth浮点,默认值:无

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

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

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

capthick浮点,默认值:无

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

barsabovebool,默认值:False

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

lolims、uplms、xlolims、xuplimsbool,默认值:False

这些参数可用于指示值仅给出上限/下限。在这种情况下,使用插入符号来表示这一点。 lims -参数可以是标量,也可以是与 xerryerr . 使用倒轴限制, set_xlimset_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)

在哪里? mfcmecmsmew 是较长属性名的别名, 标记彩色标记彩色图像标记尺寸标记宽度 .

标记属性的有效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 标记样式字符串, PathMarkerStyle
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] (除非引起例外): xyxerryerr .

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

使用实例 matplotlib.pyplot.errorbar