numpy.ma.median

numpy.ma.median(a, axis=None, out=None, overwrite_input=False, keepdims=False) [source]

Вычисление медианы по указанной оси.

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

Параметры:

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

Возвращает:

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

См. также

mean

Примечания

Для вектора V с N немаскированными значениями, медиана V — это среднее значение отсортированной копии V (Vs) — т.е. Vs[(N-1)/2], когда N нечётное, или {Vs[N/2 - 1] + Vs[N/2]}/2 когда N чётное.

Примеры

>>> x = np.ma.array(np.arange(8), mask=[0]*4 + [1]*4)
>>> np.ma.median(x)
1.5

>>> x = np.ma.array(np.arange(10).reshape(2, 5), mask=[0]*6 + [1]*4)
>>> np.ma.median(x)
2.5
>>> np.ma.median(x, axis=-1, overwrite_input=True)
masked_array(data = [ 2.  5.],
             mask = False,
       fill_value = 1e+20)