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 игнорируются, когда это возможно.

Параметры

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