numpy.nanmedian

numpy.nanmedian(a, axis=None, out=None, overwrite_input=False, keepdims=<class numpy._globals._NoValue at 0x40b6a26c>) [source]

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

Возвращает медиану элементов массива.

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

Параметры:

a : array_like Вводной массив или объект, который можно преобразовать в массив. axis : {int, последовательность int, None}, необязательно Ось или оси, по которым вычисляются медианы. По умолчанию вычисляется медиана по уплощенной версии массива. Последовательность осей поддерживается с версии 1.9.0. out : ndarray, необязательно Альтернативный выходной массив, в который следует поместить результат. Он должен иметь ту же форму и длину буфера, что и ожидаемый результат, но тип (результата) будет преобразован при необходимости. overwrite_input : bool, необязательно Если True, разрешено использовать память входного массива a для вычислений. Входной массив будет изменён вызовом median. Это позволит сэкономить память, когда вам не нужно сохранять содержимое входного массива. Обращайтесь с входными данными как с неопределёнными, но, скорее всего, они будут полностью или частично отсортированы. По умолчанию False. Если overwrite_input равно True и a ещё не является ndarray, будет поднято исключение. keepdims : bool, необязательно Если это значение равно True, оси, которые были уменьшены, остаются в результате как размерности с размером один. С этим параметром результат будет корректно транслироваться относительно исходного a. Если это значение не равно значению по умолчанию, оно будет передано (в случае пустого массива) функции mean подлежащего массива. Если массив является подклассом и mean не имеет ключевого параметра keepdims, будет поднята ошибка RuntimeError.

Возвращает:

median : ndarray Новый массив, содержащий результат. Если входной массив содержит целые числа или числа с плавающей запятой, меньшие, чем float64, то тип данных выходных данных равен np.float64. В противном случае тип данных выходных данных такой же, как у входных данных. Если out указан, возвращается этот массив.

См. также

mean, median, percentile

Примечания

Учитывая вектор V длины N, медиана V — это среднее значение отсортированной копии V, V_sorted — т.е., V_sorted[(N-1)/2], когда N нечётно, и среднее из двух средних значений V_sorted когда N чётно.

Примеры

>>> a = np.array([[10.0, 7, 4], [3, 2, 1]])
>>> a[0, 1] = np.nan
>>> a
array([[ 10.,  nan,   4.],
   [  3.,   2.,   1.]])
>>> np.median(a)
nan
>>> np.nanmedian(a)
3.0
>>> np.nanmedian(a, axis=0)
array([ 6.5,  2.,  2.5])
>>> np.median(a, axis=1)
array([ 7.,  2.])
>>> b = a.copy()
>>> np.nanmedian(b, axis=1, overwrite_input=True)
array([ 7.,  2.])
>>> assert not np.all(a==b)
>>> b = a.copy()
>>> np.nanmedian(b, axis=None, overwrite_input=True)
3.0
>>> assert not np.all(a==b)