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