numpy.minimum

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

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

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

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

**kwargs

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

Возвращает

yndarray or scalar

Минимальное значение элементов x1 и x2 попарно. Это скаляр, если x1 и x2 являются скалярами.

См. также

maximum

Элемент-по-элемент максимальное значение двух массивов, обрабатывает NaN.

fmin

Элемент-по-элемент минимальное значение двух массивов, игнорирует NaN.

amin

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

nanmin

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

fmax, amax, nanmax

Примечания

Минимальное значение эквивалентно np.where(x1 <= x2, x1, x2) когда ни x1, ни x2 не являются NaN, но оно быстрее и корректно обрабатывает трансляцию.

Примеры

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

>>> np.minimum(np.eye(2), [0.5, 2]) # broadcasting
array([[ 0.5,  0. ],
       [ 0. ,  1. ]])

>>> np.minimum([np.nan, 0, np.nan],[0, np.nan, np.nan])
array([nan, nan, nan])
>>> np.minimum(-np.Inf, 1)
-inf