numpy.ma.average

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

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

Параметры:

a : array_like Данные для усреднения. Маскированные значения не учитываются при вычислении. axis : int, необязательно Ось, по которой вычисляется среднее значение. По умолчанию вычисляется среднее значение сплющенного массива. weights : array_like, необязательно Значение важности каждого элемента при вычислении среднего. Массив весов может быть одномерным (в этом случае его длина должна быть равна размеру a вдоль заданной оси) или иметь ту же форму, что и a. Если weights=None, то все данные в a предполагаются с весом, равным единице. Если weights является комплексным, мнимые части игнорируются. returned : bool, необязательно Флаг, указывающий, следует ли возвращать кортеж (result, sum of weights) в качестве выходных данных (True), или только результат (False). По умолчанию False.

Возвращает:

average, [sum_of_weights] : (кортеж) скаляр или MaskedArray Среднее значение по указанной оси. Когда возвращается True, возвращается кортеж со средним значением в качестве первого элемента и суммой весов во втором элементе. Тип возвращаемого значения np.float64 если a целого типа и плавающие числа меньше float64, или тип данных входных данных, в противном случае. Если возвращается кортеж, sum_of_weights всегда float64.

Примеры

>>> a = np.ma.array([1., 2., 3., 4.], mask=[False, False, True, True])
>>> np.ma.average(a, weights=[3, 1, 0, 0])
1.25

>>> x = np.ma.arange(6.).reshape(3, 2)
>>> print x
[[ 0.  1.]
 [ 2.  3.]
 [ 4.  5.]]
>>> avg, sumweights = np.ma.average(x, axis=0, weights=[1, 2, 3],
...                                 returned=True)
>>> print avg
[2.66666666667 3.66666666667]