numpy.exceptions.AxisError

исключениеexceptions.AxisError(axis, ndim=None, msg_prefix=None)[source]

Указанный ось был неверным.

Это возбуждается всякий раз, когда axis параметр задан, который больше, чем количество измерений массива. Для совместимости с кодом, написанным по отношению к более старым версиям numpy, которые поднимали смесь ValueError и IndexError для этой ситуации, это исключение подклассифицирует оба, чтобы гарантировать, что except ValueError и except IndexError операторы по-прежнему перехватывают AxisError.

Добавлен в версии 1.13.

Параметры:

axisint или str

Ось за пределами границ или пользовательское сообщение об ошибке. Если указана ось, то ndim также следует указать.

ndimint, необязательно

Количество измерений массива.

msg_prefixstr, необязательно

Префикс для сообщения об ошибке.

Примеры

>>> 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.