numpy.exceptions.AxisError#

exception exceptions.AxisError(axis, ndim=None, msg_prefix=None)[源代码]#

提供的轴无效.

每当指定的 axis 参数大于数组维度数量时,会引发此错误.为了与针对旧版 numpy 编写的代码兼容,这些代码在这种情况下会引发 ValueError 和 IndexError 的混合,此异常继承了两者,以确保 except ValueError 和 except IndexError 语句继续捕获 AxisError.

在 1.13 版本加入.

参数:
axisint 或 str

越界轴或自定义异常消息.如果提供了轴,则应同时指定 ndim.

ndimint, 可选

数组的维度数量.

msg_prefixstr, 可选

异常消息的前缀.

示例

>>> import numpy as np
>>> array_1d = np.arange(10)
>>> np.cumsum(array_1d, axis=1)
Traceback (most recent call last):
  ...
numpy.exceptions.AxisError: axis 1 is out of bounds for array of dimension 1

负轴被保留:

>>> np.cumsum(array_1d, axis=-2)
Traceback (most recent call last):
  ...
numpy.exceptions.AxisError: axis -2 is out of bounds for array of dimension 1

类的构造函数通常以轴和数组的维度作为参数:

>>> print(np.exceptions.AxisError(2, 1, msg_prefix='error'))
error: axis 2 is out of bounds for array of dimension 1

或者,可以传递自定义的异常消息:

>>> print(np.exceptions.AxisError('Custom error message'))
Custom error message
属性:
axisint, 可选

越界轴或 None 如果提供了自定义异常消息.这应该是用户传递的轴,在任何解析负索引的标准化之前.

在 1.22 版本加入.

ndimint, 可选

数组的维度数量,或者如果提供了自定义异常消息,则为 None.

在 1.22 版本加入.

On this page