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 возвращается complex(nan, 0).

Параметры

xarray_like

Входные значения.

outndarray, None, or tuple of ndarray and None, optional

Местоположение, в которое сохраняется результат. Если предоставлено, оно должно иметь форму, к которой ведут входные данные. Если не предоставлено или равно None, возвращается свежевыделенный массив. Кортеж (возможен только как ключевой аргумент) должен иметь длину, равную числу выходов.

wherearray_like, optional

Это условие транслируется по входным данным. В местах, где условие истинно, массив out будет установлен в результат ufunc. В противном случае массив out сохранит свое исходное значение. Обратите внимание, что если массив out создается с помощью значения по умолчанию out=None, места в нем, где условие ложно, останутся неинициализированными.

**kwargs

Для других ключевых аргументов см. документацию по ufunc.

Возвращает

yndarray

Знак x. Это скаляр, если x скаляр.

Примечания

Существует более одного определения знака, используемого для комплексных чисел. Используемое здесь определение эквивалентно , что отличается от общепринятой альтернативы .

Примеры

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