# RangeCorrel Função de script e de gráfico

RangeCorrel() retorna o coeficiente da correlação para dois conjuntos de dados. O coeficiente da correlação é uma medida da relação entre os conjuntos de dados.

Sintaxe:

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

Tipo de dados de retorno: numérico

A série de dados deve ser inserida como pares (x,y). Por exemplo, para avaliar duas séries de dados, matriz 1 e matriz 2, onde a matriz 1 = 2,6,9 e matriz 2 = 3,8,4 você escreveria `RangeCorrel
 (2,3,6,8,9,4)` que retorna 0,269.

Argumentos:

Argumentos

| Argumento | Descrição |
| --- | --- |
| x-value, y-value | Cada valor representa um único valor ou um intervalo de valores retornado por funções inter-registro com um terceiro parâmetro opcional. Cada valor ou intervalo de valores deve corresponder a um valor x-value ou a um intervalo de valores y-values. |
| Expression | Expressões ou campos opcionais que contêm o intervalo de dados a ser medido. |

Limitações:

São necessários, pelo menos, dois pares de coordenadas para a função ser calculada.

Os valores de texto NULL e faltantes retornam NULL.

Exemplos e resultados:

Exemplos de funções

| Exemplos | Resultados |
| --- | --- |
| `RangeCorrel<br>(2,3,6,8,9,4,8,5)` | Retorna 0,2492. Essa função pode ser carregada no script ou adicionada em uma visualização no editor de expressões. |

Exemplo:

Adicione o script de exemplo ao seu aplicativo e execute-o. Para ver o resultado, adicione os campos listados na coluna de resultados a uma pasta no seu aplicativo.

`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 '|');`

Em uma tabela com ID1 como uma dimensão e a medida RangeCorrel(x1,y1,x2,y2,x3,y3,x4,y4,x5,y5,x6,y6)), a função RangeCorrel() encontra o valor de Correl em um intervalo de seis pares de x,y, para cada um dos valores de ID1.

Tabela resultante

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

Exemplo:

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

Em uma tabela com RangeID como dimensão e a medida: RangeCorrel(Below(X,0,4,BelowY,0,4)), a função RangeCorrel() usa os resultados das funções Below(), que, devido ao terceiro argumento (count) definido como 4, produzem um intervalo de quatro valores x-y da tabela carregada XY.

Tabela resultante

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

O valor para RangeID 01 é o mesmo que inserido manualmente RangeCorrel(2,3,6,8,9,4,8,5). Para os outros valores de RangeID, as séries produzidas pela função Below() são: (6,8,9,4,8,5), (9,4,8,5) e (8,5), o último que produz um resultado nulo.

## Saiba mais

* [Correl - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/correl.htm)