# RangeCorrel - 指令碼與圖表函數

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() 函數可針對每個 ID1 值在六對 x,y 的範圍中找到 Correl 值。

結果表格

| 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，因此該結果從載入表格 XY 中產生一系列的四個 x-y 值。

結果表格

| 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)，最後一個產生 Null 值結果。

## 瞭解更多資訊

* [Correl - 圖表函數](https://help.qlik.com/zh-TW/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/correl.htm)