mars.tensor.log10#

mars.tensor.log10(x, out=None, where=None, **kwargs)[来源]#

返回输入张量的逐元素的以10为底的对数。

Parameters

  • x (array_like) – 输入值。

  • out (Tensor, None, 或 tuple 的 tensor 和 None, 可选) – 结果存储的位置。如果提供，它必须具有与输入广播到的形状。如果没有提供或None，将返回一个新分配的tensor。一个元组（仅作为关键字参数可能）必须具有与输出数量相等的长度。

  • where (array_like, 可选) – 值为 True 表示在该位置计算 ufunc，值为 False 表示保持输出中的该值不变。

  • **kwargs –

Returns

y – x的以10为底的对数，逐元素计算。当x为负时，返回NaN。

Return type

张量

备注

对数是一个多值函数：对于每个 x，存在无穷多个 z，使得 10**z = x。惯例是返回虚部位于 [-pi, pi] 的 z。

对于实值输入数据类型， log10 总是返回实数输出。对于每个无法表示为实数或无穷大的值，它返回 nan 并设置 invalid 浮点错误标志。

对于复值输入，log10 是一个复分析函数，具有分支切割 [-inf, 0]，并且在其上方连续。log10 将浮点负零视为一个无限小的负数，符合 C99 标准。

参考文献

1

M. Abramowitz 和 I.A. Stegun，《数学函数手册》， 第10次印刷，1964，第67页。 http://www.math.sfu.ca/~cbm/aands/

2

维基百科，“对数”。 http://en.wikipedia.org/wiki/Logarithm

示例

>>> import mars.tensor as mt

>>> mt.log10([1e-15, -3.]).execute()
array([-15.,  NaN])