numpy.fmin

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

Элемент-поэлементный минимум элементов массива.

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

См. также

fmax

Элемент-поэлементный максимум двух массивов, игнорирует NaN.

minimum

Элемент-поэлементный минимум двух массивов, распространяет NaN.

amin

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

nanmin

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

maximum, amax, nanmax

Примечания

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

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

Примеры

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

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

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