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