> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 順位相関係数を計算します。

# rankCorr

<div id="rankCorr">
  ## rankCorr
</div>

導入バージョン: v20.9.0

順位相関係数を計算します。

x と y の順位に対する順位相関係数を返します。相関係数の値は -1 から +1 の範囲です。2 つ未満の引数が渡された場合、この関数は例外を返します。値が +1 に近い場合は強い線形関係を示し、一方の確率変数が増加すると、もう一方の確率変数も増加します。値が -1 に近い場合も強い線形関係を示し、一方の確率変数が増加すると、もう一方の確率変数は減少します。値が 0 に近い、または 0 に等しい場合は、2 つの確率変数の間に関係がないことを示します。

**関連項目**

* [スピアマンの順位相関係数](https://en.wikipedia.org/wiki/Spearman%27s_rank_correlation_coefficient)

**構文**

```sql theme={null}
rankCorr(x, y)
```

**引数**

* `x` — 任意の値。[`Float*`](/ja/reference/data-types/float)
* `y` — 任意の値。[`Float*`](/ja/reference/data-types/float)

**戻り値**

x と y の順位に対する順位相関係数を返します。値の範囲は -1 から +1 です。[`Float64`](/ja/reference/data-types/float)

**例**

**完全な相関**

```sql title=Query theme={null}
SELECT rankCorr(number, number) FROM numbers(100);
```

```response title=Response theme={null}
┌─rankCorr(number, number)─┐
│                        1 │
└──────────────────────────┘
```

**非線形な関係**

```sql title=Query theme={null}
SELECT roundBankers(rankCorr(exp(number), sin(number)), 3) FROM numbers(100);
```

```response title=Response theme={null}
┌─roundBankers(rankCorr(exp(number), sin(number)), 3)─┐
│                                              -0.037 │
└─────────────────────────────────────────────────────┘
```

**関連項目**

* [スピアマンの順位相関係数](https://en.wikipedia.org/wiki/Spearman%27s_rank_correlation_coefficient)
