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 распространяются.

Parameters

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.

Returns

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