mpl_toolkits.mplot3d.axes3d.Axes3D.errorbar#

Axes3D.errorbar(x, y, z, zerr=None, yerr=None, xerr=None, fmt='', barsabove=False, errorevery=1, ecolor=None, elinewidth=None, capsize=None, capthick=None, xlolims=False, xuplims=False, ylolims=False, yuplims=False, zlolims=False, zuplims=False, axlim_clip=False, *, data=None, **kwargs)[source]#

绘制带有误差条的线条和/或标记。

x/y/z 定义数据位置,而 xerr/yerr/zerr 定义误差条的大小。默认情况下,这会绘制数据标记/线条以及误差条。使用 fmt='none' 只绘制误差条。

参数:
x, y, z浮点数或类数组

数据位置。

xerr, yerr, zerr浮点数或类数组,形状为 (N,) 或 (2, N),可选

误差条大小

  • 标量:所有数据点的对称 +/- 值。

  • 形状为 (N,):每个数据点的对称 +/- 值。

  • 形状(2, N):每个条形图的单独 - 和 + 值。第一行包含较低误差,第二行包含较高误差。

  • None:无误差条。

请注意,所有误差数组都应具有值。

fmtstr,默认值:''

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

使用 'none'(不区分大小写)可以仅绘制误差条而不绘制任何数据标记。

ecolor颜色,默认值:None

误差线的颜色。如果为 None,则使用连接标记的线条颜色。

elinewidth浮点数,默认值:None

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

capsize浮点数,默认值:rcParams["errorbar.capsize"] (默认值:0.0)

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

capthick浮点数,默认值:None

关键字参数 markeredgewidth (亦称 mew) 的别名。此设置是一个更合理的名称,用于控制误差条帽在点中的粗细属性。为了向后兼容,如果提供了 mewmarkeredgewidth,它们将覆盖 capthick。这在未来的版本中可能会有所改变。

为了向后兼容,如果提供了 mewmarkeredgewidth,它们将覆盖 capthick。这在未来的版本中可能会有所改变。

barsabove布尔值,默认值:False

xlolims, ylolims, zlolims布尔值,默认值:False

这些参数可用于指示某个值仅给出下限。在这种情况下,会使用脱字符号来指示。lims 参数可以是标量,也可以是与误差长度相同的类数组。要在反转轴上使用限制,必须在调用 errorbar 之前调用 set_xlimset_ylimset_zlim。请注意参数名称的巧妙之处:例如,将 ylolims 设置为 True 意味着 y 值是真实值的下限,因此只会绘制一个向上的箭头!

xuplims, yuplims, zuplims布尔值,默认值:False

与上述相同,但用于控制上限。

这些参数可用于指示一个值仅表示上限/下限。在这种情况下,将使用一个尖角符号来表示。lims 参数可以是标量,也可以是与 xerryerr 长度相同的类数组对象。要与反转轴一起使用限制,必须在调用 set_xlimset_ylim 之前调用 errorbar()。请注意这些容易混淆的参数名称:例如,将 lolims 设置为 True 意味着 y 值是真实值的下限,因此只会绘制一个向上指向的箭头!

在数据子集上绘制误差条。errorevery =N 在点 (x[::N], y[::N], z[::N]) 上绘制误差条。errorevery =(start, N) 在点 (x[start::N], y[start::N], z[start::N]) 上绘制误差条。例如,errorevery =(6, 3) 会向 (x[6], x[9], x[12], x[15], ...) 处的数据添加误差条。用于避免当两个序列共享 x 轴值时误差条重叠。

axlim_clip布尔值, 默认值: False

是否隐藏超出轴限制的误差条。

自 3.10 版本新增。

返回:
errlines列表

Line3DCollection 实例的列表,每个实例包含一条误差条线。

caplines列表

Line3D 实例的列表,每个实例包含一个帽线对象。

limmarks列表

Line3D 实例的列表,每个实例包含一个带有上限或下限的标记。

其他参数:
data可索引对象,可选

如果给定,以下参数也接受字符串 s,如果 sdata 中的一个键,则将其解释为 data[s]

x, y, z, xerr, yerr, zerr

**kwargs

所有其他用于设置误差条线条样式的关键字参数都传递给 Line3DCollection

示例

(源代码, 2x.png, png)

使用 mpl_toolkits.mplot3d.axes3d.Axes3D.errorbar 的示例#

三维误差条

三维误差条