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, или кортеж из 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])