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 ) [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。
有关和 的用法的示例,请参见指定误差线的不同方式。
xerr
yerr
- 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:
Line2D
x、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
属性:财产
描述
一个过滤器函数,它接受一个 (m, n, 3) 浮点数组和一个 dpi 值,并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
标量或无
布尔
antialiased
或aa布尔
布尔
补丁或(路径,变换)或无
color
或 c颜色
CapStyle
或 {'butt', 'projecting', 'round'}JoinStyle
或 {'miter', 'round', 'bevel'}浮动序列(以点为单位的开/关墨水)或(无,无)
(2, N) 数组或两个一维数组
drawstyle
或 ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'},默认值:'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
颜色或无
字符串
布尔
目的
linestyle
或 ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth
或 lw漂浮
标记样式字符串,
Path
或MarkerStyle
颜色
markeredgewidth
或者喵喵漂浮
markerfacecolor
或 mfc颜色
markerfacecoloralt
或 mfcalt颜色
markersize
或毫秒漂浮
无或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
布尔
浮动或可调用[[艺术家,事件],元组[布尔,字典]]
未知
布尔
(比例:浮动,长度:浮动,随机性:浮动)
布尔或无
CapStyle
或 {'butt', 'projecting', 'round'}JoinStyle
或 {'miter', 'round', 'bevel'}未知
字符串
布尔
一维数组
一维数组
漂浮