File: test-correlationTest.Rd

package info (click to toggle)
fbasics 4052.98-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 3,020 kB
  • sloc: ansic: 738; makefile: 14
file content (106 lines) | stat: -rw-r--r-- 2,372 bytes parent folder | download | duplicates (2)
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}