| Type: | Package | 
| Title: | Tests for the Equality of Coefficients of Variation from Multiple Groups | 
| Version: | 0.2.0 | 
| Maintainer: | Ben Marwick <benmarwick@gmail.com> | 
| Description: | Contains functions for testing for significant differences between multiple coefficients of variation. Includes Feltz and Miller's (1996) <doi:10.1002/(SICI)1097-0258(19960330)15:6%3C647::AID-SIM184%3E3.0.CO;2-P> asymptotic test and Krishnamoorthy and Lee's (2014) <doi:10.1007/s00180-013-0445-2> modified signed-likelihood ratio test. See the vignette for more, including full details of citations. | 
| License: | MIT + file LICENSE | 
| Encoding: | UTF-8 | 
| LazyData: | true | 
| RoxygenNote: | 6.1.1 | 
| Suggests: | knitr, ggplot2, rmarkdown, testthat, dplyr, tidyr, ggbeeswarm, covr | 
| VignetteBuilder: | knitr | 
| URL: | https://github.com/benmarwick/cvequality | 
| BugReports: | https://github.com/benmarwick/cvequality/issues | 
| Date: | 2019-01-05 | 
| NeedsCompilation: | no | 
| Packaged: | 2019-01-07 07:30:25 UTC; rstudio-user | 
| Author: | Ben Marwick [aut, cre], Kalimuthu Krishnamoorthy [aut] | 
| Repository: | CRAN | 
| Date/Publication: | 2019-01-07 15:10:02 UTC | 
LRT_STAT, required by mlrt_test
Description
LRT_STAT, required by mlrt_test
Usage
LRT_STAT(n, x, s, seed)
Arguments
n | 
 ... as above  | 
x | 
 ...  | 
s | 
 ...  | 
seed | 
 optional, an integer that is the starting point used in the generation of a sequence of random numbers. Include a seed if you want reproducible output.  | 
Value
xx
Asymptotic test for the equality of coefficients of variation from k populations, using measurement data
Description
Test for k samples (k sample populations with unequal sized) from Feltz CJ, Miller GE (1996) An asymptotic test for the equality of coefficients of variation from k population. Stat Med 15:647–658
Usage
asymptotic_test(x, y, seed)
Arguments
x | 
 a numeric vector containing individual measurement values  | 
y | 
 a vector of any type containing a grouping variable  | 
seed | 
 optional, an integer that is the starting point used in the generation of a sequence of random numbers. Include a seed if you want reproducible output.  | 
Value
a list with the test statistic and p-value
Examples
 y <- unlist(lapply(letters[1:5], function(i) rep(i, 20)))
 x <- rnorm(100)
 asymptotic_test(x, y)
Asymptotic test for the equality of coefficients of variation from k populations, using summary statistics when raw measurement data are not available.
Description
Test for k samples (k sample populations with unequal sized) from Feltz CJ, Miller GE (1996) An asymptotic test for the equality of coefficients of variation from k population. Stat Med 15:647–658
Usage
asymptotic_test2(k, n, s, x, seed)
Arguments
k | 
 a numeric vector the number of groups  | 
n | 
 a numeric vector the numer of measurements in each group  | 
s | 
 a numeric vector the standard deviation of each group  | 
x | 
 a numeric vector the mean of each group  | 
seed | 
 optional, an integer that is the starting point used in the generation of a sequence of random numbers. Include a seed if you want reproducible output.  | 
Value
a list with the test statistic and p-value
Examples
# Summary stats from Feltz and Miller 1996
miller <- data.frame(test = c('ELISA', 'WEHI', '`Viral inhibition`'),
                    Mean = c(6.8, 8.5, 6.0),
                    CV =   c(0.090, 0.462, 0.340),
                    N =    c(5, 5, 5))
# compute SD from mean and cv
miller$SD <- with(miller, CV * Mean)
 asymptotic_test2(k = nrow(miller), n = miller$N, s = miller$SD, x = miller$Mean)
Modified signed-likelihood ratio test (SLRT) for equality of CVs, using measurement data
Description
Modified signed-likelihood ratio test (SLRT) for equality of CVs, using measurement data
Usage
mslr_test(nr = 1000, x, y, seed)
Arguments
nr | 
 numeric vector length one, number of simulation runs, default is 1e3  | 
x | 
 a numeric vector containing individual measurement values  | 
y | 
 a vector of any type containing a grouping variable  | 
seed | 
 optional, an integer that is the starting point used in the generation of a sequence of random numbers. Include a seed if you want reproducible output.  | 
Value
a list with the test statistic and p-value
References
http://link.springer.com/article/10.1007/s00180-013-0445-2 Krishnamoorthy, K. & Lee, M. Comput Stat (2014) 29: 215. doi:10.1007/s00180-013-0445-2
Examples
 x <- rnorm(100)
 y <- unlist(lapply(letters[1:5], function(i) rep(i, 20)))
 mslr_test(nr = 1e3, x, y)
# Modified signed-likelihood ratio test (SLRT) for equality of CVs, using summary statistics when raw measurement data are not available.
Description
# Modified signed-likelihood ratio test (SLRT) for equality of CVs, using summary statistics when raw measurement data are not available.
Usage
mslr_test2(nr, n, x, s, seed)
Arguments
nr | 
 numeric vector lenght one, number of simulation runs  | 
n | 
 a numeric vector, the number of observations in each group  | 
x | 
 a numeric vector, the mean of each group  | 
s | 
 a numeric vector, the standard deviation of each group  | 
seed | 
 optional, an integer that is the starting point used in the generation of a sequence of random numbers. Include a seed if you want reproducible output.  | 
Value
a list with the test statistic and p-value
References
http://link.springer.com/article/10.1007/s00180-013-0445-2
Examples
# Summary stats from Feltz and Miller 1996
miller <- data.frame(test = c('ELISA', 'WEHI', '`Viral inhibition`'),
                    Mean = c(6.8, 8.5, 6.0),
                    CV =   c(0.090, 0.462, 0.340),
                    N =    c(5, 5, 5))
# compute SD from mean and cv
miller$SD <- with(miller, CV * Mean)
 mslr_test2(nr = 1e3, n = miller$N, s = miller$SD, x = miller$Mean)