numpy.min

numpy.min(a, axis=None, out=None, keepdims=<no value>, initial=<no value>, where=<no value>)[source]

Возвращает минимальное значение массива или минимальное значение по оси.

Параметры:

aarray_like

Входные данные.

axisNone или int или кортеж из целых чисел, необязательно

Ось или оси, по которым нужно выполнить операцию. По умолчанию используется уплощенный вход.

Введено в версии 1.7.0.

Если это кортеж из целых чисел, минимальное значение выбирается по нескольким осям вместо одной оси или всех осей, как раньше.

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

Альтернативный массив вывода, в который следует поместить результат. Он должен иметь ту же форму и длину буфера, что и ожидаемый результат. См. Определение типа вывода для получения более подробной информации.

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

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

Если передано значение по умолчанию, то keepdims не будет передано в метод min подклассов ndarray, но любое отличное от значения по умолчанию значение будет. Если метод подкласса не реализует keepdims, будут подняты исключения.

initialскаляр, необязательно

Максимальное значение элемента вывода. Должно быть указано, чтобы позволить вычисления на пустом срезе. См. reduce для получения подробной информации.

Введено в версии 1.15.0.

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

Элементы для сравнения, чтобы найти минимальное значение. См. reduce для получения подробной информации.

Введено в версии 1.17.0.

Возвращает:

minndarray или скаляр

Минимальное значение a. Если axis равно None, результат — скалярное значение. Если axis — целое число, результат — массив размерности a.ndim - 1. Если axis — кортеж, результат — массив размерности a.ndim - len(axis).

См. также

amax

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

nanmin

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

minimum

Поэлементное минимальное значение двух массивов, обрабатывая любые NaN.

fmin

Поэлементное минимальное значение двух массивов, игнорируя любые NaN.

argmin

Возвращает индексы минимальных значений.

nanmax, maximum, fmax

Примечания

Значения NaN распространяются, то есть если хотя бы один элемент — NaN, соответствующее минимальное значение тоже будет NaN. Чтобы игнорировать значения NaN (поведение MATLAB), используйте nanmin.

Не используйте min для поэлементного сравнения 2 массивов; когда a.shape[0] равно 2, minimum(a[0], a[1]) быстрее, чем min(a, axis=0).

Примеры

>>> a = np.arange(4).reshape((2,2))
>>> a
array([[0, 1],
       [2, 3]])
>>> np.min(a)           # Minimum of the flattened array
0
>>> np.min(a, axis=0)   # Minima along the first axis
array([0, 1])
>>> np.min(a, axis=1)   # Minima along the second axis
array([0, 2])
>>> np.min(a, where=[False, True], initial=10, axis=0)
array([10,  1])

>>> b = np.arange(5, dtype=float)
>>> b[2] = np.nan
>>> np.min(b)
np.float64(nan)
>>> np.min(b, where=~np.isnan(b), initial=10)
0.0
>>> np.nanmin(b)
0.0

>>> np.min([[-50], [10]], axis=-1, initial=0)
array([-50,   0])

Обратите внимание, что начальное значение используется как один из элементов, для которого определяется минимум, в отличие от аргумента по умолчанию функции max в Python, который используется только для пустых итерируемых объектов.

Обратите внимание, что это не то же самое, что аргумент по умолчанию Python default.

>>> np.min([6], initial=5)
5
>>> min([6], default=5)
6