numpy.isinf#

numpy.isinf(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature]) = <ufunc 'isinf'>#

元素級地測試正負無窮大。

返回與 x 形狀相同的布林陣列,若 x == +/-inf 則為 True,否則為 False。

參數:
xarray_like

輸入值

outndarray, None, 或 ndarray 和 None 的元組, 可選

儲存結果的位置。如果提供,則必須具有輸入廣播到的形狀。 如果未提供或為 None,則會返回新分配的陣列。 元組(可能僅作為關鍵字參數)的長度必須等於輸出的數量。

wherearray_like, 可選

此條件會廣播到輸入。 在條件為 True 的位置,out 陣列將設定為 ufunc 結果。 在其他位置,out 陣列將保留其原始值。 請注意,如果透過預設 out=None 建立未初始化的 out 陣列,則其中條件為 False 的位置將保持未初始化。

**kwargs

對於其他僅限關鍵字參數的引數,請參閱 ufunc 文件

返回:
ybool (純量) 或布林 ndarray

x 為正或負無窮大則為 True,否則為 False。 如果 x 是純量,則此為純量。

另請參閱

isneginf, isposinf, isnan, isfinite

注意事項

NumPy 使用 IEEE 二進位浮點算術標準 (IEEE 754)。

如果第一個引數是純量時提供了第二個引數,或者如果第一個和第二個引數具有不同的形狀,則會產生錯誤。

範例

>>> import numpy as np
>>> np.isinf(np.inf)
True
>>> np.isinf(np.nan)
False
>>> np.isinf(-np.inf)
True
>>> np.isinf([np.inf, -np.inf, 1.0, np.nan])
array([ True,  True, False, False])
>>> x = np.array([-np.inf, 0., np.inf])
>>> y = np.array([2, 2, 2])
>>> np.isinf(x, y)
array([1, 0, 1])
>>> y
array([1, 0, 1])