numpy.minimum

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

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

Сравнивает два массива и возвращает новый массив, содержащий элементное минимальное значение. Если один из сравниваемых элементов является NaN, то возвращается этот элемент. Если оба элемента являются NaN, возвращается первый. Последнее различие важно для комплексных NaN, которые определяются как по крайней мере одна из действительной или мнимой частей является NaN. Результирующее воздействие заключается в том, что NaN распространяются.

Параметры:

x1, x2array_like

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

outndarray, None, или кортеж из ndarray и None, необязательно

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

wherearray_like, необязательно

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

**kwargs

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

Возвращаемое значение:

yndarray или скаляр

Минимальное значение 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