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, x2 : array_like Массивы, содержащие элементы для сравнения. Если x1.shape != x2.shape, они должны быть совместимы для трансляции к общему виду (который становится формой результата). out : ndarray, None, or tuple of ndarray and None, optional Местоположение, в которое сохраняется результат. Если указано, оно должно иметь форму, к которой транслируются входные данные. Если не указано или None, возвращается только что выделенный массив. Кортеж (возможный только в качестве ключевого аргумента) должен иметь длину, равную числу выходных данных. where : array_like, optional Это условие транслируется по входным данным. В местах, где условие истинно, массив out будет установлен на результат ufunc. В противном случае массив out сохранит свое исходное значение. Обратите внимание, что если массив out создается через стандартное значение out=None, места в нем, где условие ложно, останутся неинициализированными. **kwargs Для других ключевых аргументов см. документацию ufunc.

Возвращает:

y : ndarray 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