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) 的别名。此设置是一个更合理的名称,用于控制误差条帽在点中的粗细属性。为了向后兼容,如果提供了 mew 或 markeredgewidth,它们将覆盖 capthick。这在未来的版本中可能会有所改变。
- 为了向后兼容,如果提供了 mew 或 markeredgewidth,它们将覆盖 capthick。这在未来的版本中可能会有所改变。
barsabove布尔值,默认值:False
- xlolims, ylolims, zlolims布尔值,默认值:False
这些参数可用于指示某个值仅给出下限。在这种情况下,会使用脱字符号来指示。lims 参数可以是标量,也可以是与误差长度相同的类数组。要在反转轴上使用限制,必须在调用
errorbar
之前调用set_xlim
、set_ylim
或set_zlim
。请注意参数名称的巧妙之处:例如,将 ylolims 设置为 True 意味着 y 值是真实值的下限,因此只会绘制一个向上的箭头!- xuplims, yuplims, zuplims布尔值,默认值:False
与上述相同,但用于控制上限。
- 这些参数可用于指示一个值仅表示上限/下限。在这种情况下,将使用一个尖角符号来表示。lims 参数可以是标量,也可以是与 xerr 和 yerr 长度相同的类数组对象。要与反转轴一起使用限制,必须在调用
set_xlim
或set_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
,如果s
是data
中的一个键,则将其解释为data[s]
x, y, z, xerr, yerr, zerr
- **kwargs
所有其他用于设置误差条线条样式的关键字参数都传递给
Line3DCollection
。
示例