numpy.lib.scimath.log

lib.scimath.log(x)

计算 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

负参数会被“正确”处理（回想一下，对于实数 x < 0，exp(log(x)) == x 不 成立）

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