kendallTrendTest: Kendall's Nonparametric Test for Montonic Trend

Description

Perform a nonparametric test for a monotonic trend based on Kendall's tau statistic, and optionally compute a confidence interval for the slope.

Usage

kendallTrendTest(y, ...)
# S3 method for formula
kendallTrendTest(y, data = NULL, subset, 
  na.action = na.pass, ...)
# S3 method for default
kendallTrendTest(y, x = seq(along = y), 
  alternative = "two.sided", correct = TRUE, ci.slope = TRUE, 
  conf.level = 0.95, warn = TRUE, data.name = NULL, data.name.x = NULL, 
  parent.of.data = NULL, subset.expression = NULL, ...)

Arguments

an object containing data for the trend test. In the default method, the argument y must be numeric vector of observations. In the formula method, y must be a formula of the form y ~ 1 or y ~ x. The form y ~ 1 indicates use the observations in the vector y for the test for trend and use the default value of the argument x in the call to kendallTrendTest.default. The form y ~ x indicates use the observations in the vector y for the test for trend and use the specified value of the argument x in the call to kendallTrendTest.default. Missing (NA), undefined (NaN), and infinite (Inf, -Inf) values are allowed but will be removed.

data

specifies an optional data frame, list or environment (or object coercible by as.data.frame to a data frame) containing the variables in the model. If not found in data, the variables are taken from environment(formula), typically the environment from which kendallTrendTest is called.

subset

specifies an optional vector specifying a subset of observations to be used.

na.action

specifies a function which indicates what should happen when the data contain NAs. The default is na.pass.

numeric vector of "predictor" values. The length of x must equal the length of y. Missing (NA), undefined (NaN), and infinite (Inf, -Inf) values are allowed but will be removed. The default value of x is the vector of numbers $1, 2, \dots, n$ where $n$ is the number of elements in y.

alternative

character string indicating the kind of alternative hypothesis. The possible values are "two.sided" (tau not equal to 0; the default), "less" (tau less than 0), and "greater" (tau greater than 0).

correct

logical scalar indicating whether to use the correction for continuity in computing the $z$ -statistic that is based on the test statistic $S$ . The default value is TRUE.

ci.slope

logical scalar indicating whether to compute a confidence interval for the slope. The default value is TRUE.

conf.level

numeric scalar between 0 and 1 indicating the confidence level associated with the confidence interval for the slope. The default value is 0.95.

warn

logical scalar indicating whether to print a warning message when y does not contain at least two non-missing values, or when x does not contain at least two unique non-missing values. The default value is TRUE.

data.name

character string indicating the name of the data used for the trend test. The default value is deparse(substitute(y)).

data.name.x

character string indicating the name of the data used for the predictor variable x. If x is not supplied this argument is ignored. When x is supplied, the default value is deparse(substitute(x)).

parent.of.data

character string indicating the source of the data used for the trend test.

subset.expression

character string indicating the expression used to subset the data.

…

additional arguments affecting the test for trend.

Value

A list of class "htest" containing the results of the hypothesis test. See the help file for htest.object for details. In addition, the following components are part of the list returned by kendallTrendTest:

The value of the Kendall S-statistic.

var.S

The variance of the Kendall S-statistic.

slopes

A numeric vector of all possible two-point slope estimates. This component is used by the function kendallSeasonalTrendTest.

Details

kendallTrendTest performs Kendall's nonparametric test for a monotonic trend, which is a special case of the test for independence based on Kendall's tau statistic (see cor.test). The slope is estimated using the method of Theil (1950) and Sen (1968). When ci.slope=TRUE, the confidence interval for the slope is computed using Gilbert's (1987) Modification of the Theil/Sen Method.

Kendall's test for a monotonic trend is a special case of the test for independence based on Kendall's tau statistic. The first section below explains the general case of testing for independence. The second section explains the special case of testing for monotonic trend. The last section explains how a simple linear regression model is a special case of a monotonic trend and how the slope may be estimated.

The General Case of Testing for Independence

Definition of Kendall's Tau Let $X$ and $Y$ denote two continuous random variables with some joint (bivariate) distribution. Let $(X_{1}, Y_{1}), (X_{2}, Y_{2}), \dots, (X_{n}, Y_{n})$ denote a set of $n$ bivariate observations from this distribution, and assume these bivariate observations are mutually independent. Kendall (1938, 1975) proposed a test for the hypothesis that the $X$ and $Y$ random variables are independent based on estimating the following quantity: $τ = {2 P r [(X_{2} - X_{1}) (Y_{2} - Y_{1}) > 0]} - 1 (1)$ The quantity in Equation (1) is called Kendall's tau, although this term is more often applied to the estimate of $τ$ (see Equation (2) below). If $X$ and $Y$ are independent, then $τ = 0$ . Furthermore, for most distributions of interest, if $τ = 0$ then the random variables $X$ and $Y$ are independent. (It can be shown that there exist some distributions for which $τ = 0$ and the random variables $X$ and $Y$ are not independent; see Hollander and Wolfe (1999, p.364)).

Note that Kendall's tau is similar to a correlation coefficient in that $- 1 \leq τ \leq 1$ . If $X$ and $Y$ always vary in the same direction, that is if $X_{1} < X_{2}$ always implies $Y_{1} < Y_{2}$ , then $τ = 1$ . If $X$ and $Y$ always vary in the opposite direction, that is if $X_{1} < X_{2}$ always implies $Y_{1} > Y_{2}$ , then $τ = - 1$ . If $τ > 0$ , this indicates $X$ and $Y$ are positively associated. If $τ < 0$ , this indicates $X$ and $Y$ are negatively associated.

Estimating Kendall's Tau The quantity in Equation (1) can be estimated by: $\hat{τ} = \frac{2 S}{n (n - 1)} (2)$ where $S = \sum_{i = 1}^{n - 1} \sum_{j = i + 1}^{n} s i g n [(X_{j} - X_{i}) (Y_{j} - Y_{i})] (3)$ and $s i g n ()$ denotes the sign function:

	$- 1$	$x < 0$
$s i g n (x) =$	$0$	$x = 0 (4)$

(Hollander and Wolfe, 1999, Chapter 8; Conover, 1980, pp.256--260; Gilbert, 1987, Chapter 16; Helsel and Hirsch, 1992, pp.212--216; Gibbons et al., 2009, Chapter 11). The quantity defined in Equation (2) is called Kendall's rank correlation coefficient or more often Kendall's tau.

Note that the quantity $S$ defined in Equation (3) is equal to the number of concordant pairs minus the number of discordant pairs. Hollander and Wolfe (1999, p.364) use the notation $K$ instead of $S$ , and Conover (1980, p.257) uses the notation $T$ .

Testing the Null Hypothesis of Independence The null hypothesis $H_{0} : τ = 0$ , can be tested using the statistic $S$ defined in Equation (3) above. Tables of the distribution of $S$ for small samples are given in Hollander and Wolfe (1999), Conover (1980, pp.458--459), Gilbert (1987, p.272), Helsel and Hirsch (1992, p.469), and Gibbons (2009, p.210). The function kendallTrendTest uses the large sample approximation to the distribution of $S$ under the null hypothesis, which is given by: $z = \frac{S - E (S)}{\sqrt{V a r (S)}} (5)$ where $E (S) = 0 (6)$ $V a r (S) = \frac{n (n - 1) (2 n + 5)}{18} (7)$ Under the null hypothesis, the quantity $z$ defined in Equation (5) is approximately distributed as a standard normal random variable.

Both Kendall (1975) and Mann (1945) show that the normal approximation is excellent even for samples as small as $n = 10$ , provided that the following continuity correction is used: $z = \frac{S - s i g n (S)}{\sqrt{V a r (S)}} (8)$ The function kendallTrendTest performs the usual one-sample z-test using the statistic computed in Equation (8) or Equation (5). The argument correct determines which equation is used to compute the z-statistic. By default, correct=TRUE so Equation (8) is used.

In the case of tied observations in either the observed $X$ 's and/or observed $Y$ 's, the formula for the variance of $S$ given in Equation (7) must be modified as follows:

$V a r (S) =$	$\frac{n (n - 1) (2 n + 5)}{18} -$

	$\frac{\sum_{i = 1}^{g} t_{i} (t_{i} - 1) (2 t_{i} + 5)}{18} -$

	$\frac{\sum_{j = 1}^{h} u_{j} (u_{j} - 1) (2 u_{j} + 5)}{18} +$

	$\frac{[\sum_{i = 1}^{g} t_{i} (t_{i} - 1) (t_{i} - 2)] [\sum_{j = 1}^{h} u_{j} (u_{j} - 1) (u_{j} - 2)]}{9 n (n - 1) (n - 2)} +$

where $g$ is the number of tied groups in the $X$ observations, $t_{i}$ is the size of the $i$ 'th tied group in the $X$ observations, $h$ is the number of tied groups in the $Y$ observations, and $u_{j}$ is the size of the $j$ 'th tied group in the $Y$ observations. In the case of no ties in either the $X$ or $Y$ observations, Equation (9) reduces to Equation (7).

The Special Case of Testing for Monotonic Trend Often in environmental sampling, observations are taken periodically over time (Hirsch et al., 1982; van Belle and Hughes, 1984; Hirsch and Slack, 1984). In this case, the random variables $Y_{1}, Y_{2}, \dots, Y_{n}$ can be thought of as representing the observations, and the variables $X_{1}, X_{2}, \dots, X_{n}$ are no longer random but represent the time at which the $i$ 'th observation was taken. If the observations are equally spaced over time, then it is useful to make the simplification $X_{i} = i$ for $i = 1, 2, \dots, n$ . This is in fact the default value of the argument x for the function kendallTrendTest.

In the case where the $X$ 's represent time and are all distinct, the test for independence between $X$ and $Y$ is equivalent to testing for a monotonic trend in $Y$ , and the test statistic $S$ simplifies to: $S = \sum_{i = 1}^{n - 1} \sum_{j = i + 1}^{n} s i g n (Y_{j} - Y_{i}) (10)$ Also, the formula for the variance of $S$ in the presence of ties (under the null hypothesis $H_{0} : τ = 0$ ) simplifies to: $V a r (S) = \frac{n (n - 1) (2 n + 5)}{18} - \frac{\sum_{j = 1}^{h} u_{j} (u_{j} - 1) (2 u_{j} + 5)}{18} (11)$ A form of the test statistic $S$ in Equation (10) was introduced by Mann (1945).

The Special Case of a Simple Linear Model: Estimating the Slope Consider the simple linear regression model $Y_{i} = β_{0} + β_{1} X_{i} + ϵ_{i} (12)$ where $β_{0}$ denotes the intercept, $β_{1}$ denotes the slope, $i = 1, 2, \dots, n$ , and the $ϵ$ 's are assumed to be independent and identically distributed random variables from the same distribution. This is a special case of dependence between the $X$ 's and the $Y$ 's, and the null hypothesis of a zero slope can be tested using Kendall's test statistic $S$ (Equation (3) or (10) above) and the associated z-statistic (Equation (5) or (8) above) (Hollander and Wolfe, 1999, pp.415--420).

Theil (1950) proposed the following nonparametric estimator of the slope: ${\hat{β}}_{1} = M e d i a n (\frac{Y_{j} - Y_{i}}{X_{j} - X_{i}}); i < j (13)$ Note that the computation of the estimated slope involves computing $N = (\binom{n}{2}) = \frac{n (n - 1)}{2} (14)$ “two-point” estimated slopes (assuming no tied $X$ values), and taking the median of these N values.

Sen (1968) generalized this estimator to the case where there are possibly tied observations in the $X$ 's. In this case, Sen simply ignores the two-point estimated slopes where the $X$ 's are tied and computes the median based on the remaining $N^{'}$ two-point estimated slopes. That is, Sen's estimator is given by: ${\hat{β}}_{1} = M e d i a n (\frac{Y_{j} - Y_{i}}{X_{j} - X_{i}}); i < j, X_{i} \neq X_{j} (15)$ (Hollander and Wolfe, 1999, pp.421--422).

Conover (1980, p. 267) suggests the following estimator for the intercept: ${\hat{β}}_{0} = Y_{0.5} - {\hat{β}}_{1} X_{0.5} (16)$ where $X_{0.5}$ and $Y_{0.5}$ denote the sample medians of the $X$ 's and $Y$ 's, respectively. With these estimators of slope and intercept, the estimated regression line passes through the point $(X_{0.5}, Y_{0.5})$ .

NOTE: The function kendallTrendTest always returns estimates of slope and intercept assuming a linear model (Equation (12)), while the p-value is based on Kendall's tau, which is testing for the broader alternative of any kind of dependence between the $X$ 's and $Y$ 's.

Confidence Interval for the Slope Theil (1950) and Sen (1968) proposed methods to compute a confidence interval for the true slope, assuming the linear model of Equation (12) (see Hollander and Wolfe, 1999, pp.421-422). Gilbert (1987, p.218) illustrates a simpler method than the one given by Sen (1968) that is based on a normal approximation. Gilbert's (1987) method is an extension of the one given in Hollander and Wolfe (1999, p.424) that allows for ties and/or multiple observations per time period. This method is valid for a sample size as small as $n = 10$ unless there are several tied observations.

Let $N^{'}$ denote the number of defined two-point estimated slopes that are used in Equation (15) above (if there are no tied $X$ values then $N^{'} = N$ ), and let ${\hat{β}}_{1_{(1)}}, {\hat{β}}_{1_{(2)}}, \dots, {\hat{β}}_{1_{(N^{'})}}$ denote the $N^{'}$ ordered slopes. For Gilbert's (1987) method, a $100 (1 - α) %$ two-sided confidence interval for the true slope is given by: $[{\hat{β}}_{1_{(M 1)}}, {\hat{β}}_{1_{(M 2 + 1)}}] (17)$ where $M 1 = \frac{N^{'} - C_{α}}{2} (18)$ $M 2 = \frac{N^{'} + C_{α}}{2} (19)$ $C_{α} = z_{1 - α / 2} \sqrt{V a r (S)} (20)$ $V a r (S)$ is defined in Equations (7), (9), or (11), and $z_{p}$ denotes the $p$ 'th quantile of the standard normal distribution. One-sided confidence intervals may computed in a similar fashion.

Usually the quantities $M 1$ and $M 2$ will not be integers. Gilbert (1987, p.219) suggests interpolating between adjacent values in this case, which is what the function kendallTrendTest does.

References

Bradley, J.V. (1968). Distribution-Free Statistical Tests. Prentice-Hall, Englewood Cliffs, NJ.

Conover, W.J. (1980). Practical Nonparametric Statistics. Second Edition. John Wiley and Sons, New York, pp.256-272.

Gibbons, R.D., D.K. Bhaumik, and S. Aryal. (2009). Statistical Methods for Groundwater Monitoring, Second Edition. John Wiley & Sons, Hoboken.

Gilbert, R.O. (1987). Statistical Methods for Environmental Pollution Monitoring. Van Nostrand Reinhold, New York, NY, Chapter 16.

Helsel, D.R. and R.M. Hirsch. (1988). Discussion of Applicability of the t-test for Detecting Trends in Water Quality Variables. Water Resources Bulletin 24(1), 201-204.

Helsel, D.R., and R.M. Hirsch. (1992). Statistical Methods in Water Resources Research. Elsevier, NY.

Helsel, D.R., and R. M. Hirsch. (2002). Statistical Methods in Water Resources. Techniques of Water Resources Investigations, Book 4, chapter A3. U.S. Geological Survey. Available on-line at http://pubs.usgs.gov/twri/twri4a3/pdf/twri4a3-new.pdf.

Hirsch, R.M., J.R. Slack, and R.A. Smith. (1982). Techniques of Trend Analysis for Monthly Water Quality Data. Water Resources Research 18(1), 107-121.

Hirsch, R.M. and J.R. Slack. (1984). A Nonparametric Trend Test for Seasonal Data with Serial Dependence. Water Resources Research 20(6), 727-732.

Hirsch, R.M., R.B. Alexander, and R.A. Smith. (1991). Selection of Methods for the Detection and Estimation of Trends in Water Quality. Water Resources Research 27(5), 803-813.

Hollander, M., and D.A. Wolfe. (1999). Nonparametric Statistical Methods, Second Edition. John Wiley and Sons, New York.

Kendall, M.G. (1938). A New Measure of Rank Correlation. Biometrika 30, 81-93.

Kendall, M.G. (1975). Rank Correlation Methods. Charles Griffin, London.

Mann, H.B. (1945). Nonparametric Tests Against Trend. Econometrica 13, 245-259.

Millard, S.P., and Neerchal, N.K. (2001). Environmental Statistics with S-PLUS. CRC Press, Boca Raton, Florida.

Sen, P.K. (1968). Estimates of the Regression Coefficient Based on Kendall's Tau. Journal of the American Statistical Association 63, 1379-1389.

Theil, H. (1950). A Rank-Invariant Method of Linear and Polynomial Regression Analysis, I-III. Proc. Kon. Ned. Akad. v. Wetensch. A. 53, 386-392, 521-525, 1397-1412.

USEPA. (2009). Statistical Analysis of Groundwater Monitoring Data at RCRA Facilities, Unified Guidance. EPA 530/R-09-007, March 2009. Office of Resource Conservation and Recovery Program Implementation and Information Division. U.S. Environmental Protection Agency, Washington, D.C.

USEPA. (2010). Errata Sheet - March 2009 Unified Guidance. EPA 530/R-09-007a, August 9, 2010. Office of Resource Conservation and Recovery, Program Information and Implementation Division. U.S. Environmental Protection Agency, Washington, D.C.

van Belle, G., and J.P. Hughes. (1984). Nonparametric Tests for Trend in Water Quality. Water Resources Research 20(1), 127-136.

Examples

Run this code

# NOT RUN {
  # Reproduce Example 17-6 on page 17-33 of USEPA (2009).  This example 
  # tests for trend in sulfate concentrations (ppm) collected at various 
  # months between 1989 and 1996. 

  head(EPA.09.Ex.17.6.sulfate.df)
  #  Sample.No Year Month Sampling.Date       Date Sulfate.ppm
  #1         1   89     6          89.6 1989-06-01         480
  #2         2   89     8          89.8 1989-08-01         450
  #3         3   90     1          90.1 1990-01-01         490
  #4         4   90     3          90.3 1990-03-01         520
  #5         5   90     6          90.6 1990-06-01         485
  #6         6   90     8          90.8 1990-08-01         510


  # Plot the data
  #--------------
  dev.new()
  with(EPA.09.Ex.17.6.sulfate.df, 
    plot(Sampling.Date, Sulfate.ppm, pch = 15, ylim = c(400, 900),
    xlab = "Sampling Date", ylab = "Sulfate Conc (ppm)",
    main = "Figure 17-6. Time Series Plot of \nSulfate Concentrations (ppm)")
  )
  Sulfate.fit <- lm(Sulfate.ppm ~ Sampling.Date, 
    data = EPA.09.Ex.17.6.sulfate.df)
  abline(Sulfate.fit, lty = 2)


  # Perform the Kendall test for trend
  #-----------------------------------
  kendallTrendTest(Sulfate.ppm ~ Sampling.Date, 
    data = EPA.09.Ex.17.6.sulfate.df)

  #Results of Hypothesis Test
  #--------------------------
  #
  #Null Hypothesis:                 tau = 0
  #
  #Alternative Hypothesis:          True tau is not equal to 0
  #
  #Test Name:                       Kendall's Test for Trend
  #                                 (with continuity correction)
  #
  #Estimated Parameter(s):          tau       =     0.7667984
  #                                 slope     =    26.6666667
  #                                 intercept = -1909.3333333
  #
  #Estimation Method:               slope:      Theil/Sen Estimator
  #                                 intercept:  Conover's Estimator
  #
  #Data:                            y = Sulfate.ppm  
  #                                 x = Sampling.Date
  #
  #Data Source:                     EPA.09.Ex.17.6.sulfate.df
  #
  #Sample Size:                     23
  #
  #Test Statistic:                  z = 5.107322
  #
  #P-value:                         3.267574e-07
  #
  #Confidence Interval for:         slope
  #
  #Confidence Interval Method:      Gilbert's Modification
  #                                 of Theil/Sen Method
  #
  #Confidence Interval Type:        two-sided
  #
  #Confidence Level:                95%
  #
  #Confidence Interval:             LCL = 20.00000
  #                                 UCL = 35.71182


  # Clean up
  #---------
  rm(Sulfate.fit)
  graphics.off()
# }

Run the code above in your browser using DataLab

State of Data and AI Literacy Report 2025