# RangeCorrel — функция скриптa и диаграммы

RangeCorrel() возвращает коэффициент корреляции для двух наборов данных. Коэффициент корреляции — это мера отношений между наборами данных.

Синтаксис:

RangeCorrel(x\_value , y\_value[, Expression])

Возвращаемые типы данных: числовое значение

Серии данных необходимо добавлять в виде пар (x,y). Например, чтобы оценить две серии данных, диапазон 1 и диапазон 2, где диапазон 1 = 2, 6, 9, а диапазон 2 = 3, 8, 4, необходимо записать элемент `RangeCorrel
 (2,3,6,8,9,4)`, который возвращает значение 0,269.

Аргументы:

Аргументы

| Аргумент | Описание |
| --- | --- |
| x-value, y-value | Каждое значение является одиночным значением или диапазоном значений, возвращаемых функциями между записями с третьим дополнительным параметром. Каждое значение или диапазон значений должны соответствовать значению x-value или диапазону значений y-values. |
| Expression | Дополнительные выражения или поля, содержащие диапазон значений для измерения. |

Ограничения:

Для вычисления функции требуется хотя бы две пары координат.

Текстовые значения, значения NULL и отсутствующие значения возвращают NULL.

Примеры и результаты:

Примеры функции

| Примеры | Результаты |
| --- | --- |
| `RangeCorrel<br>(2,3,6,8,9,4,8,5)` | Возвращает 0,2492. Данную функцию можно загрузить в скрипт или добавить в визуализацию в редакторе выражения. |

Пример:

Добавьте образец скрипта в свое приложение и запустите. Чтобы увидеть результаты, добавьте поля, перечисленные в столбце результатов, в лист приложения.

`RangeList:` `Load * Inline [` `ID1|x1|y1|x2|y2|x3|y3|x4|y4|x5|y5|x6|y6` `01|46|60|70|13|78|20|45|65|78|12|78|22` `02|65|56|22|79|12|56|45|24|32|78|55|15` `03|77|68|34|91|24|68|57|36|44|90|67|27` `04|57|36|44|90|67|27|57|68|47|90|80|94` `] (delimiter is '|');` ` ` `XY:` `LOAD recno() as RangeID, * Inline [` `X|Y` `2|3` `6|8` `9|4` `8|5` `](delimiter is '|');`

В таблице с измерением ID1 и мерой RangeCorrel(x1,y1,x2,y2,x3,y3,x4,y4,x5,y5,x6,y6)) функция RangeCorrel() находит значение Correl, находящееся в диапазоне шести пар x,y, для каждого из значений ID1.

Результирующая таблица

| ID1 | MyRangeCorrel |
| --- | --- |
| 01 | -0.9517 |
| 02 | -0.5209 |
| 03 | -0.5209 |
| 04 | -0.1599 |

Пример:

`XY:` `LOAD recno() as RangeID, * Inline [` `X|Y` `2|3` `6|8` `9|4` `8|5` `](delimiter is '|');` ` `

В таблице с измерением RangeID и следующей мерой: RangeCorrel(Below(X,0,4,BelowY,0,4)) функция RangeCorrel() использует результаты функций Below(), которые на основе третьего аргумента (count), установленного на значение 4, формируют диапазон из четырех значений x-y из загруженной таблицы XY.

Результирующая таблица

| RangeID | MyRangeCorrel2 |
| --- | --- |
| 01 | 0.2492 |
| 02 | -0.9959 |
| 03 | -1.0000 |
| 04 | - |

Значение для параметра RangeID 01 совпадает с введенным вручную значением RangeCorrel(2,3,6,8,9,4,8,5). Для других значений параметра RangeID функция Below() приводит к созданию последовательности следующего вида: (6,8,9,4,8,5), (9,4,8,5) и (8,5), где последнее значение выводит нулевой результат.

## Подробнее

* [Correl — функция диаграммы](https://help.qlik.com/ru-RU/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/correl.htm)