numpy.maximum

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

Элементное максимальное значение элементов массива.

Сравните два массива и верните новый массив, содержащий элементное максимальное значение. Если один из сравниваемых элементов является NaN, то возвращается этот элемент. Если оба элемента являются NaN, то возвращается первый. Это различие важно для комплексных NaN, которые определяются как по крайней мере одна из действительных или мнимых частей является NaN. Результат — распространение NaN.

Параметры

x1, x2array_like

Массивы, содержащие сравниваемые элементы. Если x1.shape != x2.shape, они должны быть совместимы для трансляции до общей формы (которая становится формой результата).

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

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

wherearray_like, optional

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

**kwargs

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

Возвращает

yndarray or scalar

Максимальное значение x1 и x2, поэлементно. Это скаляр, если оба x1 и x2 являются скалярами.

См. также

minimum

Поэлементное минимальное значение двух массивов, распространяет NaN.

fmax

Поэлементное максимальное значение двух массивов, игнорирует NaN.

amax

Максимальное значение массива вдоль заданной оси, распространяет NaN.

nanmax

Максимальное значение массива вдоль заданной оси, игнорирует NaN.

fmin, amin, nanmin

Примечания

Максимум эквивалентен np.where(x1 >= x2, x1, x2) когда ни x1, ни x2 не являются NaN, но он быстрее и выполняет правильную трансляцию.

Примеры

>>> np.maximum([2, 3, 4], [1, 5, 2])
array([2, 5, 4])

>>> np.maximum(np.eye(2), [0.5, 2]) # broadcasting
array([[ 1. ,  2. ],
       [ 0.5,  2. ]])

>>> np.maximum([np.nan, 0, np.nan], [0, np.nan, np.nan])
array([nan, nan, nan])
>>> np.maximum(np.Inf, 1)
inf