View source: R/calcWINS_formula.R
calcWINS.formula | R Documentation |
Win statistics calculation using formula syntax
## S3 method for class 'formula'
calcWINS(x, data, ...)
x |
an object of class formula. |
data |
a data frame. |
... |
additional parameters. |
a list containing win statistics and their confidence intervals. It contains the following named data frames:
summary a data frame containing number of wins, losses, and ties of the active treatment group and the overall number of comparisons.
WP a data frame containing the win probability and its confidence interval.
NetBenefit a data frame containing the net benefit and its confidence interval. This is just a 2x-1
transformation of WP and its CI.
WO a data frame containing the win odds and its confidence interval.
WR1 a data frame containing the win ratio and its confidence interval, using the transformed standard error of the gamma
statistic.
WR2 a data frame containing the win ratio and its confidence interval, using the standard error calculated using Pties
.
gamma a data frame containing Goodman Kruskal's gamma
and its confidence interval.
SE a data frame containing standard errors used to calculated the Confidence intervals for win statistics.
The theory of win statistics is covered in the following papers.
For the win proportion CI calculation see
Gasparyan SB et al. (2021) "Adjusted win ratio with stratification: calculation methods and interpretation." Statistical Methods in Medical Research 30.2: 580-611. doi:10.1177/0962280220942558.
The win odds CI is calculated using the formula in
Gasparyan SB et al. (2021) "Power and sample size calculation for the win odds test: application to an ordinal endpoint in COVID-19 trials." Journal of Biopharmaceutical Statistics 31.6: 765-787. doi:10.1080/10543406.2021.1968893.
The win ratio the first CI uses the standard error derived from the standard error of the gamma
statistic presented in
Gasparyan SB, Kowalewski EK, Buenconsejo J, Koch GG. (2023) “Hierarchical Composite Endpoints in COVID-19: The DARE-19 Trial.” In Case Studies in Innovative Clinical Trials, Chapter 7, 95–148. Chapman; Hall/CRC. doi:10.1201/9781003288640-7.
The win ratio the second CI uses the standard error presented in
Yu RX, Ganju J. (2022) "Sample size formula for a win ratio endpoint." Statistics in Medicine 41.6: 950-63. doi:10.1002/sim.9297.
The Goodman Kruskal's gamma
and its CI match those in DescTools::GoodmanKruskalGamma()
and are based on
Agresti A. (2002) Categorical Data Analysis. John Wiley & Sons, pp. 57-59. doi:10.1002/0471249688.
Brown MB, Benedetti JK. (1977) "Sampling Behavior of Tests for Correlation in Two-Way Contingency Tables." Journal of the American Statistical Association 72, 309-315. doi:10.1080/01621459.1977.10480995.
Goodman LA, Kruskal WH. (1954) "Measures of association for cross classifications." Journal of the American Statistical Association 49, 732-764. doi:10.1080/01621459.1954.10501231.
Goodman LA, Kruskal WH. (1963) "Measures of association for cross classifications III: Approximate sampling theory." Journal of the American Statistical Association 58, 310-364. doi:10.1080/01621459.1963.10500850.
calcWINS()
, calcWINS.hce()
, calcWINS.data.frame()
.
# Example 1
calcWINS(x = GROUP ~ TRTP, data = COVID19b)
# Example 2
calcWINS(x = GROUP ~ TRTP, data = COVID19, ref = "Placebo", alpha = 0.01, WOnull = 1.2)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.