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, 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 являются скалярами.

См. также

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])