numpy.errstate

class numpy.errstate(**kwargs)

用于浮点错误处理的上下文管理器.

使用 errstate 的实例作为上下文管理器允许在该上下文中执行语句,并具有已知的错误处理行为.进入上下文时,使用 seterr 和 seterrcall 设置错误处理,退出时,将其重置为之前的状态.

在 1.17.0 版本发生变更: errstate 也可用作函数装饰器,如果包装整个函数,则可以节省一个缩进级别.

在 2.0 版本发生变更: 现在, errstate 是完全线程和 asyncio 安全的,但不能多次进入.使用 errstate 装饰异步函数是不安全的.

参数:

kwargs{divide, over, under, invalid}

关键字参数.有效的关键字是可能的浮点异常.每个关键字应该有一个字符串值,用于定义对特定错误的处理方式.可能的值有 {‘ignore’, ‘warn’, ‘raise’, ‘call’, ‘print’, ‘log’}.

参见

seterr , geterr , seterrcall , geterrcall

注释

有关浮点异常类型和处理选项的完整文档,请参阅 `seterr ` .

示例

Try it in your browser!

>>> import numpy as np
>>> olderr = np.seterr(all='ignore')  # Set error handling to known state.

>>> np.arange(3) / 0.
array([nan, inf, inf])
>>> with np.errstate(divide='ignore'):
...     np.arange(3) / 0.
array([nan, inf, inf])

>>> np.sqrt(-1)
np.float64(nan)
>>> with np.errstate(invalid='raise'):
...     np.sqrt(-1)
Traceback (most recent call last):
  File "<stdin>", line 2, in <module>
FloatingPointError: invalid value encountered in sqrt

在此上下文之外,错误处理行为没有改变:

>>> np.geterr()
{'divide': 'ignore', 'over': 'ignore', 'under': 'ignore', 'invalid': 'ignore'}
>>> olderr = np.seterr(**olderr)  # restore original state

Go BackOpen In Tab

方法

__call__ (func)

将 self 作为函数调用.