Функции quantileExact

quantileExact

Точно вычисляет квантиль числовой последовательности данных.

Чтобы получить точное значение, все переданные значения объединяются в массив, который затем частично сортируется. Поэтому функция использует O(n) памяти, где n — это количество переданных значений. Тем не менее, для небольшого числа значений функция очень эффективна.

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

Синтаксис

Псевдоним: medianExact.

Аргументы

• level — Уровень квантиля. Опциональный параметр. Постоянное число с плавающей запятой от 0 до 1. Мы рекомендуем использовать значение level в диапазоне [0.01, 0.99]. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медину.
• expr — Выражение над значениями колонок, результирующее в числовых типах данных, Date или DateTime.

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

• Квантиль указанного уровня.

Тип:

• Для числовых типов данных выходной формат будет таким же, как и входной формат. Например:

• Date, если входные значения имеют тип Date.
• DateTime, если входные значения имеют тип DateTime.

Пример

Запрос:

Результат:

quantileExactLow

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

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

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

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

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

Синтаксис

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

Аргументы

• level — Уровень квантиля. Опциональный параметр. Постоянное число с плавающей запятой от 0 до 1. Мы рекомендуем использовать значение level в диапазоне [0.01, 0.99]. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медину.
• expr — Выражение над значениями колонок, результирующее в числовых типах данных, Date или DateTime.

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

• Квантиль указанного уровня.

Тип:

• Float64 для входного числового типа данных.
• Date, если входные значения имеют тип Date.
• DateTime, если входные значения имеют тип DateTime.

Пример

Запрос:

Результат:

quantileExactHigh

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

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

Возвращаемое значение зависит от уровня квантиля и количества элементов в выборке, т.е. если уровень равен 0.5, функция возвращает более высокое медианное значение для четного количества элементов и среднее медианное значение для нечетного количества элементов. Медина рассчитывается аналогично реализации median_high, используемой в Python. Для всех остальных уровней возвращается элемент по индексу, соответствующему значению level * size_of_array.

Эта реализация ведет себя точно так же, как текущая реализация quantileExact.

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

Синтаксис

Псевдоним: medianExactHigh.

Аргументы

• level — Уровень квантиля. Опциональный параметр. Постоянное число с плавающей запятой от 0 до 1. Мы рекомендуем использовать значение level в диапазоне [0.01, 0.99]. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медину.
• expr — Выражение над значениями колонок, результирующее в числовых типах данных, Date или DateTime.

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

• Квантиль указанного уровня.

Тип:

• Float64 для входного числового типа данных.
• Date, если входные значения имеют тип Date.
• DateTime, если входные значения имеют тип DateTime.

Пример

Запрос:

Результат:

quantileExactExclusive

Точно вычисляет квантиль числовой последовательности данных.

Чтобы получить точное значение, все переданные значения объединяются в массив, который затем частично сортируется. Поэтому функция использует O(n) памяти, где n — это количество переданных значений. Тем не менее, для небольшого числа значений функция очень эффективна.

Эта функция эквивалентна функции Excel PERCENTILE.EXC, (тип R6).

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

Синтаксис

Аргументы

• expr — Выражение над значениями колонок, результирующее в числовых типах данных, Date или DateTime.

Параметры

• level — Уровень квантиля. Опциональный. Возможные значения: (0, 1) — границы не включены. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медину. Float.

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

• Квантиль указанного уровня.

Тип:

• Float64 для входного числового типа данных.
• Date, если входные значения имеют тип Date.
• DateTime, если входные значения имеют тип DateTime.

Пример

Запрос:

Результат:

quantileExactInclusive

Точно вычисляет квантиль числовой последовательности данных.

Чтобы получить точное значение, все переданные значения объединяются в массив, который затем частично сортируется. Поэтому функция использует O(n) памяти, где n — это количество переданных значений. Тем не менее, для небольшого числа значений функция очень эффективна.

Эта функция эквивалентна функции Excel PERCENTILE.INC, (тип R7).

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

Синтаксис

Аргументы

• expr — Выражение над значениями колонок, результирующее в числовых типах данных, Date или DateTime.

Параметры

• level — Уровень квантиля. Опциональный. Возможные значения: [0, 1] — границы включены. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медину. Float.

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

• Квантиль указанного уровня.

Тип:

• Float64 для входного числового типа данных.
• Date, если входные значения имеют тип Date.
• DateTime, если входные значения имеют тип DateTime.

Пример

Запрос:

Результат:

Смотрите также

• median
• quantiles