numpy.corrcoef

numpy.corrcoef(x, y=None, rowvar=True, bias=<no value>, ddof=<no value>, *, dtype=None) [source]

Возвращает коэффициенты корреляции Пирсона.

Обратитесь к документации cov для получения более подробной информации. Связь между матрицей коэффициентов корреляции, R, и матрицей ковариаций, C, такая:

Значения R находятся в интервале от -1 до 1 включительно.

Параметры

xarray_like

Одномерный или двумерный массив, содержащий несколько переменных и наблюдений. Каждая строка в x представляет переменную, а каждый столбец — отдельное наблюдение всех этих переменных. Также см. rowvar ниже.

yarray_like, optional

Дополнительный набор переменных и наблюдений. y имеет такую же форму, что и x.

rowvarbool, optional

Если rowvar равно True (по умолчанию), то каждая строка представляет переменную, а столбцы содержат наблюдения. В противном случае связь транспонирована: каждый столбец представляет переменную, а строки содержат наблюдения.

bias_NoValue, optional

Не оказывает никакого влияния, не используйте.

Устарело начиная с версии 1.10.0.

ddof_NoValue, optional

Не оказывает никакого влияния, не используйте.

Устарело начиная с версии 1.10.0.

dtypedata-type, optional

Тип данных результата. По умолчанию тип данных результата будет иметь по крайней мере точность numpy.float64.

Введено в версии 1.20.

Возвращает

Rndarray

Матрица коэффициентов корреляции переменных.

См. также

cov

Матрица ковариаций

Примечания

Из-за округления с плавающей запятой результирующий массив может не быть эрмитовым, диагональные элементы могут не быть равны 1, а элементы могут не удовлетворять неравенству abs(a) <= 1. Вещественная и мнимая части обрезаются до интервала [-1, 1] в попытке улучшить это положение дел, но это мало помогает в комплексном случае.

Эта функция принимает, но игнорирует аргументы bias и ddof. Это сделано для обеспечения обратной совместимости с предыдущими версиями этой функции. Эти аргументы не оказывали никакого влияния на значения возвращаемых функцией и могут быть безопасно проигнорированы в этой и предыдущих версиях numpy.

Примеры

В этом примере мы генерируем два случайных массива, xarr и yarr, и вычисляем коэффициенты корреляции Пирсона по строкам и по столбцам, R. Поскольку rowvar по умолчанию равно true, мы сначала находим коэффициенты корреляции Пирсона по строкам между переменными xarr.

>>> import numpy as np
>>> rng = np.random.default_rng(seed=42)
>>> xarr = rng.random((3, 3))
>>> xarr
array([[0.77395605, 0.43887844, 0.85859792],
       [0.69736803, 0.09417735, 0.97562235],
       [0.7611397 , 0.78606431, 0.12811363]])
>>> R1 = np.corrcoef(xarr)
>>> R1
array([[ 1.        ,  0.99256089, -0.68080986],
       [ 0.99256089,  1.        , -0.76492172],
       [-0.68080986, -0.76492172,  1.        ]])

Если мы добавим другой набор переменных и наблюдений yarr, мы можем вычислить коэффициенты корреляции Пирсона по строкам между переменными в xarr и yarr.

>>> yarr = rng.random((3, 3))
>>> yarr
array([[0.45038594, 0.37079802, 0.92676499],
       [0.64386512, 0.82276161, 0.4434142 ],
       [0.22723872, 0.55458479, 0.06381726]])
>>> R2 = np.corrcoef(xarr, yarr)
>>> R2
array([[ 1.        ,  0.99256089, -0.68080986,  0.75008178, -0.934284  ,
        -0.99004057],
       [ 0.99256089,  1.        , -0.76492172,  0.82502011, -0.97074098,
        -0.99981569],
       [-0.68080986, -0.76492172,  1.        , -0.99507202,  0.89721355,
         0.77714685],
       [ 0.75008178,  0.82502011, -0.99507202,  1.        , -0.93657855,
        -0.83571711],
       [-0.934284  , -0.97074098,  0.89721355, -0.93657855,  1.        ,
         0.97517215],
       [-0.99004057, -0.99981569,  0.77714685, -0.83571711,  0.97517215,
         1.        ]])

Наконец, если мы используем параметр rowvar=False, столбцы теперь рассматриваются как переменные, и мы найдем коэффициенты корреляции Пирсона по столбцам между переменными в xarr и yarr.

>>> R3 = np.corrcoef(xarr, yarr, rowvar=False)
>>> R3
array([[ 1.        ,  0.77598074, -0.47458546, -0.75078643, -0.9665554 ,
         0.22423734],
       [ 0.77598074,  1.        , -0.92346708, -0.99923895, -0.58826587,
        -0.44069024],
       [-0.47458546, -0.92346708,  1.        ,  0.93773029,  0.23297648,
         0.75137473],
       [-0.75078643, -0.99923895,  0.93773029,  1.        ,  0.55627469,
         0.47536961],
       [-0.9665554 , -0.58826587,  0.23297648,  0.55627469,  1.        ,
        -0.46666491],
       [ 0.22423734, -0.44069024,  0.75137473,  0.47536961, -0.46666491,
         1.        ]])