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。

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

fmt str,默认值:''

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

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

ecolor颜色,默认:无

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

elinewidth浮点数,默认值:无

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

翻船浮动,默认值:(rcParams["errorbar.capsize"]默认值0.0:)

误差线上限的长度(以磅为单位)。

capthick浮动,默认值:无

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

barabove bool,默认值:False

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

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

这些参数可用于指示一个值仅给出上限/下限。在这种情况下,使用插入符号来表示这一点。lims -参数可以是标量,或者与xerryerr长度相同的数组。要使用反转轴的限制,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)

其中mfcmecmsmew是更长的属性名称markerfacecolormarkeredgecolormarkersizemarkeredgewidth的别名。

标记属性的有效 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

标记样式字符串,PathMarkerStyle

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

漂浮

使用#的示例matplotlib.pyplot.errorbar

误差线限制选择

误差线限制选择

误差线限制选择