numpy.sign

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

Возвращает элементную индикацию знака числа.

Функция sign возвращает -1 if x < 0, 0 if x==0, 1 if x > 0. Для входных данных nan возвращается nan.

Для комплексных входных данных функция sign возвращает x / abs(x), обобщение вышесказанного (и 0 if x==0).

Изменено в версии 2.0.0: Определение комплексного знака изменено в соответствии со стандартом Array API.

Параметры:

xarray_like

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

outndarray, None, или кортеж ndarray и None, необязательно

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

wherearray_like, необязательно

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

**kwargs

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

Возвращает:

yndarray

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

Примечания

Существует более одного определения знака для комплексных чисел. Используемое здесь определение эквивалентно \(x/\sqrt{x*x}\), что отличается от альтернативного определения \(x/|x|\).

Примеры

>>> np.sign([-5., 4.5])
array([-1.,  1.])
>>> np.sign(0)
0
>>> np.sign([3-4j, 8j])
array([0.6-0.8j, 0. +1.j ])