numpy.mean

numpy.mean(a, axis=None, dtype=None, out=None, keepdims=<no value>, *, where=<no value>)[source]

Вычисление арифметического среднего по указанной оси.

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

Параметры:

aarray_like

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

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

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

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

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

dtypeтип данных, необязательно

Тип, используемый при вычислении среднего. Для целочисленных входных данных по умолчанию используется float64; для чисел с плавающей точкой — такой же, как и для входных данных.

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

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

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

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

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

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

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

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

Возвращает:

mndarray, см. параметр dtype выше

Если out=None, возвращается новый массив, содержащий средние значения, в противном случае возвращается ссылка на выходной массив.

См. также

average

Взвешенное среднее

std, var, nanmean, nanstd, nanvar

Примечания

Арифметическое среднее — это сумма элементов вдоль оси, деленная на количество элементов.

Обратите внимание, что для входных данных с плавающей точкой среднее вычисляется с той же точностью, что и у входных данных. В зависимости от входных данных результаты могут быть неточными, особенно для float32 (см. пример ниже). Использование аккумулятора с большей точностью с помощью ключевого слова dtype может помочь решить эту проблему.

По умолчанию результаты с типом float16 вычисляются с промежуточными значениями типа float32 для повышения точности.

Примеры

>>> a = np.array([[1, 2], [3, 4]])
>>> np.mean(a)
2.5
>>> np.mean(a, axis=0)
array([2., 3.])
>>> np.mean(a, axis=1)
array([1.5, 3.5])

В одинарной точности mean может быть неточным:

>>> a = np.zeros((2, 512*512), dtype=np.float32)
>>> a[0, :] = 1.0
>>> a[1, :] = 0.1
>>> np.mean(a)
0.54999924

Вычисление среднего значения в формате float64 более точно:

>>> np.mean(a, dtype=np.float64)
0.55000000074505806 # may vary

Указание аргумента where:

>>> a = np.array([[5, 9, 13], [14, 10, 12], [11, 15, 19]])
>>> np.mean(a)
12.0
>>> np.mean(a, where=[[True], [False], [False]])
9.0