numpy.exceptions.AxisError#

exception exceptions.AxisError(axis, ndim=None, msg_prefix=None)[原始碼]#

提供的軸無效。

當指定的 axis 參數大於陣列維度數時，會引發此例外。為了與針對舊版 NumPy 撰寫的程式碼相容，舊版 NumPy 在這種情況下會混合引發 ValueError 和 IndexError，此例外繼承了兩者，以確保 except ValueError 和 except IndexError 陳述式會繼續捕捉 AxisError。

參數:

axisint 或 str: 超出範圍的軸或自訂例外訊息。如果提供軸，則也應指定 ndim。
ndimint, optional: 陣列維度數。
msg_prefixstr, optional: 例外訊息的前綴。

範例

>>> 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, optional: 超出範圍的軸，如果提供了自訂例外訊息，則為 None。這應該是使用者傳遞的軸，在任何正規化以解析負索引之前。

1.22 版本新增。
ndimint, optional: 陣列維度數，如果提供了自訂例外訊息，則為 None。

1.22 版本新增。