numpy.ma.median

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

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

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

Параметры:

a : array_like Входной массив или объект, который может быть преобразован в массив. axis : int, необязательно Ось, по которой вычисляются медианы. По умолчанию (None) вычисляется медиана по сплющенной версии массива. out : ndarray, необязательно Альтернативный выходной массив, в который следует поместить результат. Он должен иметь такую же форму и длину буфера, как ожидаемый результат, но тип будет приведен, если необходимо. overwrite_input : bool, необязательно Если True, разрешено использование памяти входного массива (a) для вычислений. Входной массив будет изменен в ходе вызова median. Это сэкономит память, если вам не нужно сохранять содержимое входного массива. Обращайтесь с входным массивом как с неопределенным, но, скорее всего, он будет полностью или частично отсортирован. Значение по умолчанию — False. Обратите внимание, что, если overwrite_input имеет значение True, а входной массив не является ndarray, будет выброшено исключение. keepdims : bool, необязательно Если установлено в 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)