numpy.lib.scimath.log#

lib.scimath.log(x)[source]#

計算 x 的自然對數。

傳回 \(log_e(x)\) 的「主值」(有關此描述,請參閱 numpy.log)。對於實數 x > 0,這是一個實數(log(0) 傳回 -inf,而 log(np.inf) 傳回 inf)。否則,將傳回複數主值。

參數:
xarray_like

需要計算對數的值。

傳回值:
outndarray 或 純量

x 值的對數。如果 x 是純量,則 out 也是純量;否則,將傳回陣列。

另請參閱

numpy.log

註解

對於當實數 x < 0 時傳回 NAN 的 log(),請使用 numpy.log(但請注意,在其他情況下,numpy.log 和此 log 是相同的,也就是說,對於 x = 0 兩者都傳回 -inf,對於 x = inf 兩者都傳回 inf,並且值得注意的是,如果 x.imag != 0,則傳回複數主值)。

範例

>>> import numpy as np
>>> np.emath.log(np.exp(1))
1.0

負數引數會「正確地」處理(回想一下,exp(log(x)) == x 對於實數 x < 0 成立)

>>> np.emath.log(-np.exp(1)) == (1 + np.pi * 1j)
True