numpy.nanmean

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

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

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

Для срезков, содержащих только NaN, возвращается NaN, и поднимается RuntimeWarning.

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

Параметры:

aarray_like

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

axis{int, кортеж из int, None}, необязательно

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

dtypeтип данных, необязательно

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

outndarray, необязательно

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

keepdimsbool, необязательно

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

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

wherearray_like типа bool, необязательно

Элементы, которые следует включить в среднее значение. См. reduce для получения подробностей.

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

Возвращаемое значение:

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