acc.1test: Accuracy of a Single Binary Diagnostic Test

View source: R/DTComPair.R

acc.1testR Documentation

Accuracy of a Single Binary Diagnostic Test

Description

Sensitivity and specificity, (positive and negative) predictive values and (positive and negative) diagnostic likelihood ratios of a single binary diagnostic test.

Usage

acc.1test(tab, alpha, testname, ...)

Arguments

tab

An object of class tab.1test.

alpha

Significance level alpha for 100(1-alpha)%-confidence intervals, the default is 0.05.

testname

A character variable containing the name of the diagnostic test.

...

Additional arguments (usually not required).

Details

The calculation of accuracy measures and their variances follows standard methodology, e.g. described in Pepe (2003) or Zhou et al. (2011). Confidence intervals for diagnostic likelihood ratios are computed according to Simel et al. (1991).

Value

A list of class acc.1test:

tab

A contingency table (matrix) of test results; the same tab that is supplied as an argument.

Diseased Non-diseased Total
Test pos. ... ... ...
Test neg. ... ... ...
Total ... ... ...
sensitivity

A numeric vector containing the estimated sensitivity (est), its standard error (se), lower confidence limit (lcl) and upper confidence limit (ucl).

specificity

A numeric vector containing the estimated specificity (est), its standard error (se), lower confidence limit (lcl) and upper confidence limit (ucl).

ppv

A numeric vector containing the estimated positive predictive value (est), its standard error (se), lower confidence limit (lcl) and upper confidence limit (ucl).

npv

A numeric vector containing the estimated negative predictive value (est), its standard error (se), lower confidence limit (lcl) and upper confidence limit (ucl).

pdlr

A numeric vector containing the estimated positive diagnostic likelihood ratio (est), the standard error of the logarithm of the positive diagnostic likelihood ratio (se.ln), the lower confidence limit (lcl) and the upper confidence limit (ucl).

ndlr

A numeric vector containing the estimated negative diagnostic likelihood ratio (est), the standard error of the logarithm of the negative diagnostic likelihood ratio (se.ln), the lower confidence limit (lcl) and the upper confidence limit (ucl).

alpha

The significance level alpha used to compute 100(1-alpha)%-confidence intervals, the default is 0.05.

testname

A character variable containing the name of the diagnostic test.

References

Pepe, M. (2003). The statistical evaluation of medical tests for classifcation and prediction. Oxford Statistical Science Series. Oxford University Press, 1st edition.

Simel, D.L., Samsa, G.P., Matchar, D.B. (1991). Likelihood ratios with confidence: sample size estimation for diagnostic test studies. J Clin Epidemiol, 44(8):763-70.

Zhou, X., Obuchowski, N., and McClish, D. (2011). Statistical Methods in Diagnostic Medicine. Wiley Series in Probability and Statistics. John Wiley & Sons, Hoboken, New Jersey, 2nd edition.

See Also

tab.1test, print.acc.1test, acc.paired.

Examples

data(Paired1) # Hypothetical study data 
a1 <- tab.1test(d=d, y=y1, data=Paired1)
a2 <- acc.1test(a1)
print(a2)

DTComPair documentation built on Aug. 20, 2023, 5:06 p.m.