numpy.mean

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

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

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

Параметры:

a : array_like Массив, содержащий числа, среднее значение которых необходимо. Если a не является массивом, выполняется попытка преобразования. axis : None or int or tuple of ints, optional Ось или оси, по которым вычисляются средние значения. По умолчанию вычисляется среднее значение уплощенного массива. Введено в версии 1.7.0. Если это кортеж целых чисел, среднее значение вычисляется по нескольким осям, а не по одной оси или всем осям, как раньше. dtype : data-type, optional Тип, используемый при вычислении среднего значения. Для целочисленных входных данных значение по умолчанию float64; для входных данных с плавающей точкой оно совпадает с типом входных данных. out : ndarray, optional Альтернативный массив вывода, в который следует поместить результат. По умолчанию None; если он указан, он должен иметь такую же форму, как и ожидаемый вывод, но тип будет преобразован при необходимости. См. doc.ufuncs для получения подробностей. keepdims : bool, optional Если это установлено в True, оси, по которым происходит сокращение, остаются в результате как измерения с размером один. С этим параметром результат будет корректно транслироваться относительно входного массива. Если передано значение по умолчанию, то keepdims не будет передано методу mean подклассов ndarray, однако любое отличное от значения по умолчанию будет. Если метод подкласса не реализует keepdims, будут подняты исключения.

Возвращает:

m : ndarray, see dtype parameter above Если 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