scipy.stats.mstats.kendalltau(x, y, use_ties=True, use_missing=False, method='auto', alternative='two-sided')[source]#

Computes Kendall’s rank correlation tau on two variables x and y.


First data list (for example, time).


Second data list.

use_ties{True, False}, optional

Whether ties correction should be performed.

use_missing{False, True}, optional

Whether missing data should be allocated a rank of 0 (False) or the average rank (True)

method{‘auto’, ‘asymptotic’, ‘exact’}, optional

Defines which method is used to calculate the p-value [1]. ‘asymptotic’ uses a normal approximation valid for large samples. ‘exact’ computes the exact p-value, but can only be used if no ties are present. As the sample size increases, the ‘exact’ computation time may grow and the result may lose some precision. ‘auto’ is the default and selects the appropriate method based on a trade-off between speed and accuracy.

alternative{‘two-sided’, ‘less’, ‘greater’}, optional

Defines the alternative hypothesis. Default is ‘two-sided’. The following options are available:

  • ‘two-sided’: the rank correlation is nonzero

  • ‘less’: the rank correlation is negative (less than zero)

  • ‘greater’: the rank correlation is positive (greater than zero)


An object containing attributes:


The tau statistic.


The p-value for a hypothesis test whose null hypothesis is an absence of association, tau = 0.



Maurice G. Kendall, “Rank Correlation Methods” (4th Edition), Charles Griffin & Co., 1970.