numpy.maximum

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

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

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

Параметры:

x1, x2array_like

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

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

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

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

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

**kwargs

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

Возвращает:

yndarray или скаляр

Максимальное значение из 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