numpy.fmin

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

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

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

См. также

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