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