numpy.fmax

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

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

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

См. также

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