numpy.max

numpy.max(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 не будет передано в метод max подклассов ndarray, однако любое нестандартное значение будет. Если метод подкласса не реализует keepdims, будут вызваны исключения.

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

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

Добавлена в версии 1.15.0.

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

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

Добавлена в версии 1.17.0.

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

maxndarray или скаляр

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

См. также

amin

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

nanmax

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

maximum

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

fmax

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

argmax

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

nanmin, minimum, fmin

Примечания

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

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

Примеры

>>> a = np.arange(4).reshape((2,2))
>>> a
array([[0, 1],
       [2, 3]])
>>> np.max(a)           # Maximum of the flattened array
3
>>> np.max(a, axis=0)   # Maxima along the first axis
array([2, 3])
>>> np.max(a, axis=1)   # Maxima along the second axis
array([1, 3])
>>> np.max(a, where=[False, True], initial=-1, axis=0)
array([-1,  3])
>>> b = np.arange(5, dtype=float)
>>> b[2] = np.nan
>>> np.max(b)
np.float64(nan)
>>> np.max(b, where=~np.isnan(b), initial=-1)
4.0
>>> np.nanmax(b)
4.0

Можно использовать начальное значение для вычисления максимального значения пустого среза или для его инициализации другим значением:

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

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

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