numpy.sign

numpy.sign(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature, extobj]) = <ufunc 'sign'>

返回按元素指示的数字符号。

这个 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输入返回复杂(NaN,0)。

参数
xarray_like

输入值。

outndarray、none或ndarray和none的元组,可选

存储结果的位置。如果提供,它必须具有输入广播到的形状。如果未提供或没有,则返回新分配的数组。元组(只能作为关键字参数)的长度必须等于输出数。

where阵列式,可选

这种情况通过输入广播。在条件为真的位置 out 数组将被设置为ufunc结果。在其他地方 out 数组将保留其原始值。请注意,如果未初始化 out 数组是通过默认值创建的 out=None ,其中条件为False的位置将保持未初始化状态。

**kwargs

有关其他仅限关键字的参数,请参见 ufunc docs .

返回
y恩达雷

符号 x . 这是一个标量,如果 x 是标量。

笔记

复数常用的符号定义不止一个。这里使用的定义相当于 x/\sqrt{{x*x}} 这不同于一般的选择, x/|x| .

实例

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