numpy.nanmean

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

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

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

Для срезов, состоящих только из NaN, возвращается NaN и генерируется RuntimeWarning.

Новая в версии 1.8.0.

Параметры

aarray_like

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

axis{int, tuple of int, None}, optional

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

dtypedata-type, optional

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

outndarray, optional

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

keepdimsbool, optional

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

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

Возвращает

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

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

См. также

average

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

mean

Арифметическое среднее, вычисляемое без игнорирования NaN

var, nanvar

Примечания

Арифметическое среднее — это сумма элементов, не равных NaN, по оси, делённая на количество элементов, не равных NaN.

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

Примеры

>>> a = np.array([[1, np.nan], [3, 4]])
>>> np.nanmean(a)
2.6666666666666665
>>> np.nanmean(a, axis=0)
array([2.,  4.])
>>> np.nanmean(a, axis=1)
array([1.,  3.5]) # may vary