numpy.amax

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

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

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

Новая в версии 1.15.0.

wherearray_like булевых значений, необязательно

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

Новая в версии 1.17.0.

Возвращает

amaxndarray или скаляр

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

См. также

amin

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

nanmax

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

maximum

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

fmax

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

argmax

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

nanmin, minimum, fmin

Примечания

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

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

Примеры

>>> a = np.arange(4).reshape((2,2))
>>> a
array([[0, 1],
       [2, 3]])
>>> np.amax(a)           # Maximum of the flattened array
3
>>> np.amax(a, axis=0)   # Maxima along the first axis
array([2, 3])
>>> np.amax(a, axis=1)   # Maxima along the second axis
array([1, 3])
>>> np.amax(a, where=[False, True], initial=-1, axis=0)
array([-1,  3])
>>> b = np.arange(5, dtype=float)
>>> b[2] = np.NaN
>>> np.amax(b)
nan
>>> np.amax(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])

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

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