quantileExactLow

Добавленный в: v20.8.0

Подобно quantileExact, эта функция вычисляет точный квантиль последовательности числовых данных.

Чтобы получить точное значение, все переданные значения объединяются в массив, который затем полностью сортируется. Сложность алгоритма сортировки составляет O(N·log(N)), где N = std::distance(first, last).

Возвращаемое значение зависит от уровня квантиля и количества элементов в выборке: если уровень равен 0.5, то для чётного числа элементов функция возвращает меньшее из двух средних значений, а для нечётного — средний элемент. Медиана вычисляется аналогично реализации median_low, используемой в Python.

Для всех остальных уровней возвращается элемент по индексу, соответствующему значению level * size_of_array.

При использовании нескольких функций quantile* с разными уровнями в одном запросе внутренние состояния не объединяются (то есть запрос работает менее эффективно, чем мог бы). В этом случае используйте функцию quantiles.

Синтаксис

quantileExactLow(level)(expr)

Псевдонимы: medianExactLow

Параметры

level — Необязательный параметр. Уровень квантиля. Константное число с плавающей точкой от 0 до 1. Рекомендуется использовать значение level в диапазоне [0.01, 0.99]. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медиану. Float*

Аргументы

expr — Выражение над значениями столбца, возвращающее числовые типы данных, Date, DateTime или DateTime64. (U)Int* или Float* или Decimal* или Date или DateTime или DateTime64

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

Возвращает квантиль указанного уровня. Для числовых типов данных выходной формат совпадает с входным форматом. (U)Int* или Float* или Decimal* или Date или DateTime или DateTime64

Примеры

Вычисление точного нижнего квантиля

SELECT quantileExactLow(number) FROM numbers(10);

┌─quantileExactLow(number)─┐
│                        4 │
└──────────────────────────┘

Вычисление квантиля заданного уровня

SELECT quantileExactLow(0.1)(number) FROM numbers(10);

┌─quantileExactLow(0.1)(number)─┐
│                             1 │
└───────────────────────────────┘