maxframe.tensor.sign#

maxframe.tensor.sign(x, out=None, where=None, **kwargs)[源代码]#

返回一个数字符号的逐元素指示。

sign 函数返回 -1 if x < 0, 0 if x==0, 1 if x > 0。如果输入为 nan，则返回 nan。

对于复数输入，sign 函数返回 sign(x.real) + 0j if x.real != 0 else sign(x.imag) + 0j。

对于复数 nan 输入，返回 complex(nan, 0)。

参数:

x (array_like) -- 输入值。
out (Tensor, None, or tuple of Tensor and None, optional) -- 用于存储结果的位置。如果提供了该参数，则其形状必须与输入广播兼容。如果未提供或为 None，则返回一个新分配的 tensor。元组（仅可作为关键字参数）的长度必须等于输出的数量。
where (array_like, optional) -- 为 True 的值表示在该位置计算 ufunc，为 False 的值表示保留输出中的值不变。
**kwargs

返回:

y -- x 的符号。

返回类型:

Tensor

备注

对于复数，符号有多种常见定义。这里使用的定义等价于 \(x/\sqrt{x*x}\)，它与常见的替代定义 \(x/|x|\) 不同。

示例

>>> import maxframe.tensor as mt

>>> mt.sign([-5., 4.5]).execute()
array([-1.,  1.])
>>> mt.sign(0).execute()
0
>>> mt.sign(5-2j).execute()
(1+0j)