SciPy

numpy.corrcoef

numpy.corrcoef(x, y=None, rowvar=1, bias=<class numpy._NoValue at 0x40a7274c>, ddof=<class numpy._NoValue at 0x40a7274c>)[source]

Return Pearson product-moment correlation coefficients.

Please refer to the documentation for cov for more detail. The relationship between the correlation coefficient matrix, R, and the covariance matrix, C, is

R_{ij} = \frac{ C_{ij} } { \sqrt{ C_{ii} * C_{jj} } }

The values of R are between -1 and 1, inclusive.

Parameters:

x : array_like

A 1-D or 2-D array containing multiple variables and observations. Each row of x represents a variable, and each column a single observation of all those variables. Also see rowvar below.

y : array_like, optional

An additional set of variables and observations. y has the same shape as x.

rowvar : int, optional

If rowvar is non-zero (default), then each row represents a variable, with observations in the columns. Otherwise, the relationship is transposed: each column represents a variable, while the rows contain observations.

bias : _NoValue, optional

Has no affect, do not use.

Deprecated since version 1.10.0.

ddof : _NoValue, optional

Has no affect, do not use.

Deprecated since version 1.10.0.

Returns:

R : ndarray

The correlation coefficient matrix of the variables.

See also

cov
Covariance matrix

Notes

This function accepts but discards arguments bias and ddof. This is for backwards compatibility with previous versions of this function. These arguments had no effect on the return values of the function and can be safely ignored in this and previous versions of numpy.

Previous topic

numpy.nanvar

Next topic

numpy.correlate