DiagTest3Grp.Test: Statistical test on the summary measure (VUS or Youden)...
In DiagTest3Grp: Diagnostic test summary measures for three ordinal groups

Description Usage Arguments Details Value Warning Note Author(s) References See Also Examples

Statistical test to compare the summary measure (VUS or Youden) estimates between two markers or multiple markers assuming that the marker follows normal distribution in each diagnosis group, for both independent samples and paired samples.

1 2	DiagTest3Grp.Test (dat,paired=FALSE, type=c("VUS","Youden"),p=0,q=0,mu=0, conf.level=0.95, alternative=c("two.sided","less","greater"))

`dat`	For unpaired data (data measured on different independent sets of samples), dat is a list of K (=number of markers) components, each corresponding to a marker. Each component of the list should be a data frame of number of observation by two columns:(1) group (note:must be at the 1st column) with the three levels of D^-, D^0 and D^+ (corresponding to increasing disease severity respectively); (2)numeric marker measurements at the 2nd column. for paired data, dat should be a data frame with observations at row and group/markers at column (group must be at the 1st column) with the three levels D^-, D^0 and D^+(corresponding to increasing disease severity respectively), followed by markers at the 2nd to the last column.
`paired`	A logic value TRUE/FALSE, indicating whether all markers are measured on the same set (paired=TRUE) or not (paired=FALSE).
`type`	A character value. type=“VUS” or “Youden”, indicates which summary measure (VUS or Youden) will be used to indicate the discriminative ability of the three-group diagnostic tests. Allows unique argument matching,i.e., can use unique abbreviations such as “V” or “Y”.
`p`	A numeric value. To test on partial VUS satisfying specificity >=p and sensitivity >=q, set p, q to desired value. default=0 for full VUS.
`q`	A numeric value.To test on partial VUS satisfying specificity >=p and sensitivity >=q, set p, q to desired value. default=0 for full VUS.
`mu`	A numeric value. The hypothesized true difference between two markers. Default mu=0 but can be changed to a nonzero value.
`conf.level`	a numerica value. The confidence interval. default=95%. The confidence interval on point estimate of abs diff between two markers's summary measures will be returned. For >=3 markers, this will be NA.
`alternative`	A character value. Now is fixed as "two-sided".

Let θ_j indicate the summary measure (either VUS or Youden) on a marker j. When testing Q markers (Q≥3) markers, the omnibus test similar to one-way ANOVA is performed with the hypothesis H_0: θ_1=θ_2=\cdots=θ_Q against the alternative H_1: at least a pair of markers have unequivalent summary measures. The resulting statistic is a Chi-square statistic with Q-1 degree of freedom. When testing 2 markers, the normal test is performed to test the hypothesis H_0: θ_1-θ_2=θ_0 against H_1:θ_1-θ_2\neq 0 for alternative=\dQuote{two.sided}, H_1:θ_1-θ_2<0 for alternative=\dQuote{less} and H_1:θ_1-θ_2> 0 for alternative=\dQuote{greater} The z-statistic is formed (difference in summary measures divided by the standard error on the difference) for normal test.

An object of the classic S3 class htest (slightly modified) with the list of components.

`statistic`	A numeric value. In situations of testing >=3 markers, this is a Chi-Square statistic; in testing 2 markers, this is a Z-statistic.
`p.value`	A numeric value. The p-value testing the hypothesis (see details) from Chi-square test (for >=3 markers) or normal test (2 markers).
`parameter`	A numeric value. For the Chi-square test on >=3 markers, it's the degree of freedom. In the normal test on 2 markers, it's mean 0 and sd=1.
`estimate`	A numeric vector. The summary measures estimated on each marker.
`conf.int`	A numeric vector of length 2. The confidence interval on the difference in the summary measures of two marker(marker1 at the 1st column of dat input-marker2 at the 2nd column at dat input). For testing >=3 markers, NA.
`method`	A character value. “Chi-square test” for >=3 markers or “Normal-test” for 2 markers.
`type`	A character value. Either VUS or Youden, which type of summary measure is in use.
`null.value`	A numeric value. The inputted value for mu which is now fixed as 0 for >=3 marker comparison but can be changed to any numeric value for two marker comparison.
`alternative`	A character value which is always “two.sided” for >=3 marker comparison but can be “two.sided”, “less” or “greater”.
`data.name`	Usually prints Test of the name of the inputted data frame on the type of a summary measure.
`Sigma`	A numeric matrix. The covariance matrix on the summary measures estimated on markers.

The bootstrapping to obtain the variance on the nonparametric VUS estimate may take a while.

Bug reports, malfunctioning, or suggestions for further improvements or contributions can be sent to Jingqin Luo <rosy@wubios.wustl.edu>.

Jingqin Luo

Xiong, C. and van Belle, G. and Miller, J.P. and Morris, J.C. (2006) Measuring and Estimating Diagnostic Accuracy When There Are Three Ordinal Diagnostic Groups. Statistics In Medicine 25 7 1251–1273.

Ferri, C. and Hernandez-Orallo, J. and Salido, M.A. (2003) Volume under the ROC Surface for Multi-class Problems LECTURE NOTES IN COMPUTER SCIENCE 108–120.

Xiong, C and Van Belle, G. and Miller, J.P. and Yan, Y. and Gao, F., and Yu, K, and Morris, J. (2007) A Parametric Comparison of Diagnostic Accuracy with Three Ordinal Diagnostic Groups. Biometrical Journal 5, 682-693.

Luo, J and Xiong, C. (2012) Youden Index and Associated Optimal Cut-points for Three Ordinal Groups.Communications in Statistics–simulation and computation (in press).

Jingqin Luo, Chengjie Xiong (2012). DiagTest3Grp: An R Package for Analyzing Diagnostic Tests with Three Ordinal Groups.Journal of Statistical Software, 51(3), 1-24.URL http://www.jstatsoft.org/v51/i03/.

VUS Youden3Grp

 data(AL)
 AL <- data.frame(group=AL$group,-AL[,-1])

 #group <- AL$group
 #table(group)

 ##omnibus test on all 14 marker
 DiagTest3Grp.Test(dat=AL,paired=TRUE,type="VUS",p=0,q=0,conf.level=0.95)
 DiagTest3Grp.Test(dat=AL,paired=TRUE,type="Youden",p=0,q=0,conf.level=0.95)

 ##normal test on 2 of the markers
 new.AL <- subset(AL,select=c(group,ktemp,zbentd))
 DiagTest3Grp.Test(dat=new.AL,paired=TRUE,type="VUS",p=0,q=0,conf.level=0.95)
 DiagTest3Grp.Test(dat=new.AL,paired=TRUE,type="Youden",p=0,q=0,conf.level=0.95)