numpy.ma.max

ma.max(obj, axis=None, out=None, fill_value=None, keepdims=<no value>)[source]

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

Параметры:

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

Ось, по которой нужно выполнить операцию. По умолчанию, axis равно None, и используется уплощенное входное значение. .. versionadded:: 1.7.0 Если это кортеж из целых чисел, максимальное значение выбирается по нескольким осям, а не по одной оси или всем осям, как раньше.

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

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

fill_valueскаляр или None, необязательно

Значение, используемое для заполнения пропущенных значений. Если None, используется результат maximum_fill_value().

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

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

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

amaxarray_like

Новый массив, содержащий результат. Если out было указано, возвращается out.

См. также

ma.maximum_fill_value

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

Примеры

>>> import numpy.ma as ma
>>> x = [[-1., 2.5], [4., -2.], [3., 0.]]
>>> mask = [[0, 0], [1, 0], [1, 0]]
>>> masked_x = ma.masked_array(x, mask)
>>> masked_x
masked_array(
  data=[[-1.0, 2.5],
        [--, -2.0],
        [--, 0.0]],
  mask=[[False, False],
        [ True, False],
        [ True, False]],
  fill_value=1e+20)
>>> ma.max(masked_x)
2.5
>>> ma.max(masked_x, axis=0)
masked_array(data=[-1.0, 2.5],
             mask=[False, False],
       fill_value=1e+20)
>>> ma.max(masked_x, axis=1, keepdims=True)
masked_array(
  data=[[2.5],
        [-2.0],
        [0.0]],
  mask=[[False],
        [False],
        [False]],
  fill_value=1e+20)
>>> mask = [[1, 1], [1, 1], [1, 1]]
>>> masked_x = ma.masked_array(x, mask)
>>> ma.max(masked_x, axis=1)
masked_array(data=[--, --, --],
             mask=[ True,  True,  True],
       fill_value=1e+20,
            dtype=float64)