numpy.nanquantile

numpy.nanquantile(a, q, axis=None, out=None, overwrite_input=False, interpolation='linear', keepdims=<no value>) [source]

Вычислить q-тый квантиль данных по указанной оси, игнорируя значения nan. Возвращает q-тый квантиль(и) элементов массива.

Новое в версии 1.15.0.

Параметры:

a : array_like Входной массив или объект, который может быть преобразован в массив, содержащий значения nan, которые будут проигнорированы q : array_like of float Квантиль или последовательность квантилей для вычисления, которые должны быть в диапазоне от 0 до 1 включительно. axis : {int, tuple of int, None}, optional Ось или оси, по которым вычисляются квантили. По умолчанию квантиль(и) вычисляется по сплющенной версии массива. out : ndarray, optional Альтернативный выходной массив, в который следует поместить результат. Он должен иметь ту же форму и длину буфера, что и ожидаемый результат, но тип (результата) будет преобразован при необходимости. overwrite_input : bool, optional Если True, то разрешено изменять входной массив a промежуточными вычислениями, чтобы сэкономить память. В этом случае содержимое входного a после завершения этой функции не определено. interpolation : {‘linear’, ‘lower’, ‘higher’, ‘midpoint’, ‘nearest’} Этот необязательный параметр определяет метод интерполяции, который следует использовать, когда искомый квантиль находится между двумя точками данных i < j: линейный: i + (j - i) * fraction, где fraction - дробная часть индекса, окруженная i и j. нижний: i. верхний: j. ближайший: i или j, что ближе всего. середина: (i + j) / 2. keepdims : bool, optional Если это установлено в True, оси, которые были уменьшены, остаются в результате как измерения с размером один. С этим вариантом результат будет правильно транслироваться по отношению к исходному массиву a. Если это значение отлично от значения по умолчанию, оно будет передано (в особом случае пустого массива) в функцию mean базового массива. Если массив является подклассом и mean не имеет параметр keepdims, это вызовет ошибку RuntimeError.

Возвращает:

quantile : scalar or ndarray Если q - это единственный процентиль и axis=None, то результат является скаляром. Если заданы несколько квантилей, первая ось результата соответствует квантилям. Другие оси - это оси, которые остаются после сокращения a. Если входные данные содержат целые числа или числа с плавающей точкой меньше float64, тип данных выходных данных - float64. В противном случае тип данных выходных данных совпадает с типом данных входных данных. Если out указан, вместо него возвращается этот массив.

См. также

quantile, nanmean, nanmedian

nanmedian

эквивалентно nanquantile(..., 0.5)

nanpercentile

то же самое, что и nanquantile, но с q в диапазоне [0, 100].

Примеры

>>> a = np.array([[10., 7., 4.], [3., 2., 1.]])
>>> a[0][1] = np.nan
>>> a
array([[10.,  nan,   4.],
      [ 3.,   2.,   1.]])
>>> np.quantile(a, 0.5)
nan
>>> np.nanquantile(a, 0.5)
3.0
>>> np.nanquantile(a, 0.5, axis=0)
array([6.5, 2. , 2.5])
>>> np.nanquantile(a, 0.5, axis=1, keepdims=True)
array([[7.],
       [2.]])
>>> m = np.nanquantile(a, 0.5, axis=0)
>>> out = np.zeros_like(m)
>>> np.nanquantile(a, 0.5, axis=0, out=out)
array([6.5, 2. , 2.5])
>>> m
array([6.5,  2. ,  2.5])
>>> b = a.copy()
>>> np.nanquantile(b, 0.5, axis=1, overwrite_input=True)
array([7., 2.])
>>> assert not np.all(a==b)