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绘制为带有附加误差线的直线和/或标记。
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
)