numpy.median

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

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

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

Параметры:

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, оси, которые были уменьшены, остаются в результате как измерения с размером один. С этим вариантом результат будет корректно транслироваться по отношению к исходному arr. Введено в версии 1.9.0.

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

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

См. также

mean, percentile

Примечания

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

Примеры

>>> a = np.array([[10, 7, 4], [3, 2, 1]])
>>> a
array([[10,  7,  4],
       [ 3,  2,  1]])
>>> np.median(a)
3.5
>>> np.median(a, axis=0)
array([ 6.5,  4.5,  2.5])
>>> np.median(a, axis=1)
array([ 7.,  2.])
>>> m = np.median(a, axis=0)
>>> out = np.zeros_like(m)
>>> np.median(a, axis=0, out=m)
array([ 6.5,  4.5,  2.5])
>>> m
array([ 6.5,  4.5,  2.5])
>>> b = a.copy()
>>> np.median(b, axis=1, overwrite_input=True)
array([ 7.,  2.])
>>> assert not np.all(a==b)
>>> b = a.copy()
>>> np.median(b, axis=None, overwrite_input=True)
3.5
>>> assert not np.all(a==b)