numpy.nanmax

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

Возвращает максимальное значение массива или максимальное значение по оси, игнорируя значения NaN. Если встречаются слайсы, содержащие только NaN, генерируется RuntimeWarning и для этого слайса возвращается NaN.

Параметры:

aarray_like

Массив, содержащий числа, для которых требуется найти максимальное значение. Если a не является массивом, выполняется попытка преобразования.

axis{int, tuple of int, None}, optional

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

outndarray, optional

Альтернативный массив вывода, в который поместить результат. По умолчанию None; если задан, он должен иметь такую же форму, как ожидаемый результат, но тип будет преобразован при необходимости. Подробнее см. Определение типа результата.

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

keepdimsbool, optional

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

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

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

initialscalar, optional

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

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

wherearray_like of bool, optional

Элементы, которые следует сравнивать для определения максимума. Подробнее см. reduce.

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

Возвращает:

nanmaxndarray

Массив с формой, совпадающей с формой a, с удаленной указанной осью. Если a является 0-мерным массивом или если ось равна None, возвращается скалярный ndarray. Возвращается тот же тип данных, что и a.

См. также

nanmin

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

amax

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

fmax

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

maximum

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

isnan

Показывает, какие элементы являются числами Not a Number (NaN).

isfinite

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

amin, fmin, minimum

Примечания

NumPy использует стандарт IEEE для бинарной плавающей точки арифметики (IEEE 754). Это означает, что Not a Number не эквивалентно бесконечности. Положительная бесконечность обрабатывается как очень большое число, а отрицательная бесконечность – как очень маленькое (отрицательное) число.

Если входной массив имеет целочисленный тип, функция эквивалентна np.max.

Примеры

>>> a = np.array([[1, 2], [3, np.nan]])
>>> np.nanmax(a)
3.0
>>> np.nanmax(a, axis=0)
array([3.,  2.])
>>> np.nanmax(a, axis=1)
array([2.,  3.])

Когда присутствуют положительная и отрицательная бесконечности:

>>> np.nanmax([1, 2, np.nan, -np.inf])
2.0
>>> np.nanmax([1, 2, np.nan, np.inf])
inf