numpy.fmax

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

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

Сравнивает два массива и возвращает новый массив, содержащий элементные максимумы. Если один из сравниваемых элементов — NaN, то возвращается элемент, не являющийся 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 являются скалярами.

См. также

fmin

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

maximum

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

amax

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

nanmax

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

minimum, amin, nanmin

Примечания

Введено в версии 1.3.0.

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

Примеры

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

>>> np.fmax(np.eye(2), [0.5, 2])
array([[ 1. ,  2. ],
       [ 0.5,  2. ]])

>>> np.fmax([np.nan, 0, np.nan],[0, np.nan, np.nan])
array([ 0.,  0., nan])