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, x2 : array_like Массивы, содержащие элементы для сравнения. Если x1.shape != x2.shape, они должны быть совместимы для трансляции к общему размеру (который становится размером выходных данных). out : ndarray, None, or tuple of ndarray and None, optional Место, в которое сохраняется результат. Если предоставлено, оно должно иметь размер, к которому вводятся входные данные. Если не предоставлено или None, возвращается новый массив. Кортеж (возможен только как ключевое слово) должен иметь длину, равную количеству выходов. where : array_like, optional Это условие транслируется по вводу. В местах, где условие истинно, массив out будет установлен в результат ufunc. В противном случае массив out сохранит свое исходное значение. Обратите внимание, что если неинициализированный массив out создается по умолчанию out=None, места в нём, где условие ложно, останутся неинициализированными. **kwargs Для других ключевых аргументов см. документацию ufunc.

Возвращает:

y : ndarray 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])