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

Parameters

x1, x2array_like

Массивы, содержащие элементы для сравнения. Если x1.shape != x2.shape, они должны быть совместимы для трансляции к общей форме (которая становится формой выходных данных).

outndarray, None, or tuple of ndarray and None, optional

Расположение, в которое сохраняется результат. Если указано, оно должно иметь форму, к которой транслируются входные данные. Если не указано или None, возвращается свежевыделенный массив. Кортеж (возможен только как ключевой аргумент) должен иметь длину, равную числу выходов.

wherearray_like, optional

Это условие транслируется по входу. В местах, где условие True, массив out будет установлен в результат ufunc. В противном случае массив out сохранит своё исходное значение. Обратите внимание, что если неинициализированный массив out создан с помощью значения по умолчанию out=None, места в нём, где условие False, останутся неинициализированными.

**kwargs

Для других ключевых аргументов см. документацию ufunc.

Returns

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