quantileInterpolatedWeighted

Добавленный в: v23.1.0

Вычисляет квантиль числовой последовательности с помощью линейной интерполяции с учетом веса каждого элемента.

Чтобы получить интерполированное значение, все переданные значения объединяются в массив, а затем сортируются по соответствующим весам. После этого интерполяция квантиля выполняется с использованием метода взвешенных процентилей: строится накопленное распределение на основе весов, затем с помощью весов и значений выполняется линейная интерполяция для вычисления квантилей.

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

Синтаксис

quantileInterpolatedWeighted(level)(expr, weight)

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

Параметры

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

Аргументы

• expr — Выражение над значениями столбца, результат которого имеет числовой тип данных, Date, DateTime или DateTime64. (U)Int* или Int128 или UInt128 или Int256 или UInt256 или Float* или Decimal* или Date или DateTime или DateTime64
• weight — Столбец с весами элементов последовательности. Вес — это число вхождений значения. UInt*

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

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

Примеры

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

CREATE TABLE t (
    n Int32,
    val UInt32
) ENGINE = Memory;

INSERT INTO t VALUES (0, 3), (1, 2), (2, 1), (5, 4);

SELECT quantileInterpolatedWeighted(n, val) FROM t;

┌─quantileInterpolatedWeighted(n, val)─┐
│                                    1 │
└──────────────────────────────────────┘

См. также

• median
• quantiles