Python dask.array.log1p用法及代码示例

用法: dask.array.log1p(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature, extobj]) = <ufunc 'log1p'>

此文档字符串是从 numpy.log1p 复制的。

可能存在与 Dask 版本的一些不一致之处。

按元素返回输入数组加一的自然对数。

计算 log(1 + x) 。

参数：

x：array_like: 输入值。
out：ndarray，None，或 ndarray 和 None 的元组，可选: 存储结果的位置。如果提供，它必须具有输入广播到的形状。如果未提供或 None，则返回一个新分配的数组。元组(只能作为关键字参数)的长度必须等于输出的数量。
where：数组，可选: 此条件通过输入广播。在条件为 True 的位置，out 数组将设置为 ufunc 结果。在其他地方，out 数组将保留其原始值。请注意，如果通过默认 out=None 创建未初始化的 out 数组，则其中条件为 False 的位置将保持未初始化状态。
**kwargs：: 对于其他仅关键字参数，请参阅 ufunc 文档。

y：ndarray: 1 + x 的自然对数，逐元素。如果x 是标量，则这是一个标量。

注意：

对于实值输入，log1p 对于 x 也是准确的，小到 1 + x == 1 的浮点精度。

对数是一个多值函数：对于每个 x 有无限数量的 z 使得 exp(z) = 1 + x 。约定是返回 z ，其虚部位于 [-pi, pi] 。

对于实值输入数据类型，log1p 始终返回实数输出。对于每个不能表示为实数或无穷大的值，它会产生 nan 并设置 invalid 浮点错误标志。

对于complex-valued 输入，log1p 是一个复杂的分析函数，它有一个分支切割[-inf, -1]，并且从上面是连续的。 log1p 将浮点负零处理为无穷小的负数，符合 C99 标准。

参考：

1: M. Abramowitz 和 I.A. Stegun，“数学函数手册”，第 10 次印刷，1964 年，第 67 页。https://personal.math.ubc.ca/~cbm/aands/page_67.htm
2: 维基百科，“Logarithm”。 https://en.wikipedia.org/wiki/Logarithm

例子：

>>> np.log1p(1e-99)  
1e-99
>>> np.log(1 + 1e-99)  
0.0

相关用法

注：本文由纯净天空筛选整理自dask.org大神的英文原创作品 dask.array.log1p。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

用法:

参数：

返回：

注意：

参考：

例子：