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, *, data=None, **kwargs)[源代码][源代码]#
绘制带有误差线的线条和/或标记。
x/y/z 定义数据位置，xerr/yerr/zerr 定义误差棒大小。默认情况下，这会绘制数据标记/线条以及误差棒。使用 fmt='none' 仅绘制误差棒。
- 参数:
- x, y, z浮点数或类似数组
数据位置。
- xerr, yerr, zerr浮点数或类似数组，形状为 (N,) 或 (2, N)，可选
误差条大小：
标量：所有数据点的对称 +/- 值。
shape(N,): 每个数据点的对称 +/- 值。
shape(2, N): 为每个条形图分别提供 - 和 + 值。第一行包含较低的误差，第二行包含较高的误差。
None: 无误差条。
请注意，所有错误数组应具有 正值。
- fmtstr, 默认值: ''
数据点/数据行的格式。详情请参见
plot。使用 'none'（不区分大小写）来绘制没有数据标记的误差线。
- ecolor : color, 默认: None颜色, 默认值: 无
误差线的颜色。如果为 None，则使用连接标记的线的颜色。
- elinewidthfloat, 默认值: None
误差线的线宽。如果为 None，则使用当前样式的线宽。
- capsize : float, 默认值:
rcParams["errorbar.capsize"](default:0.0)float, 默认值: 误差条帽子的长度，单位为点。
- capthickfloat, 默认值: None
关键字参数 markeredgewidth*（也称为 *mew）的别名。此设置是控制误差条帽厚度的属性的更合理名称，以点为单位。为了向后兼容，如果给出了 mew 或 markeredgewidth，那么它们将覆盖 capthick。这可能在未来的版本中发生变化。
- barsabovebool, 默认: False
如果为 True，将在绘图符号上方绘制误差线。默认是在下方。
- xlolims, ylolims, zlolimsbool, 默认: False
这些参数可以用来指示一个值仅给出下限。在这种情况下，使用插入符号来表示这一点。lims 参数可以是标量，或者是与误差长度相同的类数组。要使用带有倒置轴的限制，必须在
errorbar之前调用set_xlim、set_ylim或set_zlim。注意这些棘手的参数名称：例如，将 ylolims 设置为 True 意味着 y 值是真值的 下限，因此，只会绘制一个 向上 的箭头！- xuplims, yuplims, zuplimsbool, 默认: False
与上述相同，但用于控制上限。
- erroreveryint 或 (int, int)，默认值：1
在数据的一个子集上绘制误差线。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 轴值时误差线的重叠。
- 返回:
- errlines列表
包含错误条线的
Line3DCollection实例列表。- caplines列表
包含
Line3D实例的列表，每个实例都包含一个 capline 对象。- limmarks列表
包含
Line3D实例的列表，每个实例包含一个带有上限或下限的标记。
- 其他参数:
- 数据可索引对象，可选
如果提供，以下参数还接受一个字符串
s，如果s是data中的一个键，则解释为data[s]：x, y, z, xerr, yerr, zerr
- **kwargs
所有用于样式化误差线的其他关键字参数都会传递给
Line3DCollection。
示例
(
Source code,2x.png,png)
