1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106
|
\name{correlationTest}
\alias{correlationTest}
\alias{pearsonTest}
\alias{kendallTest}
\alias{spearmanTest}
\concept{Pearson's product moment correlation test}
\concept{Kendall's tau correlation test}
\concept{Spearman's rho correlation test}
\concept{Pearson's correlation}
\concept{Kendall's correlation}
\concept{Spearman's correlation}
\title{Correlation tests}
\description{
Tests if two series are correlated.
}
\usage{
correlationTest(x, y, method = c("pearson", "kendall", "spearman"),
title = NULL, description = NULL)
pearsonTest(x, y, title = NULL, description = NULL)
kendallTest(x, y, title = NULL, description = NULL)
spearmanTest(x, y, title = NULL, description = NULL)
}
\arguments{
\item{x,y}{
numeric vectors of data values.
}
\item{method}{
a character string naming which test should be applied.
}
\item{title}{
an optional title string, if not specified the input's data
name is deparsed.
}
\item{description}{
optional description string, or a vector of character strings.
}
}
\details{
These functions test for association/correlation between paired
samples based on the Pearson's product moment correlation coefficient
(a.k.a. sample correlation), Kendall's tau, and Spearman's rho
coefficients.
\code{pearsonTest}, \code{kendallTest}, and \code{spearmanTest} are
wrappers of base R's \code{\link[stats]{cor.test}} with simplified
interface. They provide 'exact' and approximate p-values for all
three alternatives (two-sided, less, and greater), as well as 95\%
confidence intervals. This is particularly convenient in interactive
use.
Instead of calling the individual functions, one can use
\code{correlationTest} and specify the required test with argument
\code{method}.
}
\value{
an object from class \code{\link{fHTEST}}
}
\references{
Conover, W. J. (1971);
\emph{Practical nonparametric statistics},
New York: John Wiley & Sons.
Lehmann E.L. (1986);
\emph{Testing Statistical Hypotheses},
John Wiley and Sons, New York.
}
\seealso{
\code{\link{locationTest}},
\code{\link{scaleTest}},
\code{\link{varianceTest}}
}
\examples{
\dontshow{
set.seed(1234)
}
x <- rnorm(50)
y <- rnorm(50)
correlationTest(x, y, "pearson")
correlationTest(x, y, "kendall")
spearmanTest(x, y)
}
\keyword{htest}
|