# Correl - chart function

Correl() returns the aggregated correlation coefficient for two data sets. The correlation function is a measure of the relationship between the data sets and is aggregated for (x,y) value pairs iterated over the chart dimensions.

Syntax:

Correl([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] value1, value2 )

Return data type: numeric

Arguments:

* value1, value2: The expressions or fields containing the two sample sets for which the correlation coefficient is to be measured.

* SetExpression: By default, the aggregation function will aggregate over the set of possible records defined by the selection. An alternative set of records can be defined by a set analysis expression.

* DISTINCT: If the word DISTINCT occurs before the function arguments, duplicates resulting from the evaluation of the function arguments are disregarded.

* TOTAL: If the word TOTAL occurs before the function arguments, the calculation is made over all possible values given the current selections, and not just those that pertain to the current dimensional value, that is, it disregards the chart dimensions. The TOTAL qualifier may be followed by a list of one or more field names within angle brackets <fld>. These field names should be a subset of the chart dimension variables.

  [Defining the aggregation scope](https://help.qlik.com/en-US/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)

Limitations:

The parameter of the aggregation function must not contain other aggregation functions, unless these inner aggregations contain the TOTAL qualifier. For more advanced nested aggregations, use the advanced function Aggr, in combination with a specified dimension.

Text values, NULL values and missing values in any or both pieces of a data-pair result in the entire data-pair being disregarded.

Examples:

Examples and results

| Example | Result |
| --- | --- |
| `Correl(Age, Salary)` | For a table including the dimension `Employee name` and the measure `Correl(Age, Salary)`, the result is 0.9270611. The result is only displayed for the totals cell. |
| `Correl(TOTAL Age, Salary))` | 0.927. This and the following results are shown to three decimal places for readability. |

**Data used in examples:**

`Salary:` `LOAD  * inline [` `"Employee name"|Gender|Age|Salary` `Aiden Charles|Male|20|25000` `Brenda Davies|Male|25|32000` `Charlotte Edberg|Female|45|56000` `Daroush Ferrara|Male|31|29000` `Eunice Goldblum|Female|31|32000` `Freddy Halvorsen|Male|25|26000` `Gauri Indu|Female|36|46000` `Harry Jones|Male|38|40000` `Ian Underwood|Male|40|45000` `Jackie Kingsley|Female|23|28000` `] (delimiter is '|');`

## Learn more

* [Aggr](https://help.qlik.com/en-US/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/aggr.htm)
* [Avg - chart function](https://help.qlik.com/en-US/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [RangeCorrel - script and chart function](https://help.qlik.com/en-US/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/RangeFunctions/rangecorrel.htm)
* [Set analysis and set expressions](https://help.qlik.com/en-US/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/SetAnalysis/set-analysis-expressions.htm)