numpy.expm1

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

計算陣列中所有元素的 exp(x) - 1。

參數:

xarray_like

輸入值。

outndarray, None, 或 tuple of ndarray and None, optional

結果儲存的位置。若提供，其形狀必須能與輸入值廣播。若未提供或為 None，則會回傳新配置的陣列。元組（僅能作為關鍵字引數）的長度必須等於輸出的數量。

wherearray_like, optional

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

**kwargs

關於其他僅限關鍵字引數，請參閱 ufunc 文件。

回傳值:

outndarray 或 純量

元素級指數減一：out = exp(x) - 1。若 x 為純量，則此為純量。

另請參閱

log1p

log(1 + x)，expm1 的反函數。

註解

對於 x 的小數值，此函數提供比 exp(x) - 1 更高的精確度。

範例

exp(1e-10) - 1 的真值約為 1.00000000005e-10，精確到約 32 位有效數字。此範例展示了在此情況下 expm1 的優越性。

>>> import numpy as np

>>> np.expm1(1e-10)
1.00000000005e-10
>>> np.exp(1e-10) - 1
1.000000082740371e-10