numpy.average

numpy.average(a, axis=None, weights=None, returned=False) [source]

Вычислить взвешенное среднее значение по указанной оси.

Параметры:	a : array_like Массив, содержащий данные для усреднения. Если a не является массивом, попытка преобразования. axis : int, необязательно Ось, по которой вычислять среднее значение a. Если None, усреднение выполняется по уплощённому массиву. weights : array_like, необязательно Массив весов, связанных со значениями в a. Каждое значение в a вносит вклад в среднее значение в соответствии с его связанным весом. Массив весов может быть одномерным (в этом случае его длина должна быть равна размеру a по заданной оси) или иметь такую же форму, как a. Если weights=None, предполагается, что все данные в a имеют вес, равный единице. returned : bool, необязательно Значение по умолчанию — False. Если True, возвращается кортеж (average, sum_of_weights), в противном случае возвращается только среднее значение. Если weights=None, sum_of_weights эквивалентно числу элементов, по которым вычисляется среднее значение.
Возвращает:	average, [sum_of_weights] : array_type или double Возвращает среднее значение по указанной оси. Когда returned — True, возвращается кортеж со средним значением в качестве первого элемента и суммой весов в качестве второго элемента. Тип возвращаемого значения — Float если a имеет целочисленный тип, в противном случае — тот же тип, что и a. sum_of_weights имеет тот же тип, что и average.
Возможные исключения:	ZeroDivisionError При всех нулевых весах по оси. См. numpy.ma.average для версии, устойчивой к этому типу ошибки. TypeError Когда длина одномерного weights не совпадает с формой a по оси.

См. также

mean

ma.average

среднее для массивных массивов — полезно, если ваши данные содержат «пропущенные» значения

Примеры

>>> data = range(1,5)
>>> data
[1, 2, 3, 4]
>>> np.average(data)
2.5
>>> np.average(range(1,11), weights=range(10,0,-1))
4.0

>>> data = np.arange(6).reshape((3,2))
>>> data
array([[0, 1],
       [2, 3],
       [4, 5]])
>>> np.average(data, axis=1, weights=[1./4, 3./4])
array([ 0.75,  2.75,  4.75])
>>> np.average(data, weights=[1./4, 3./4])
Traceback (most recent call last):
...
TypeError: Axis must be specified when shapes of a and weights differ.