tab.1test: Tabulate Single Binary Diagnostic Test vs. Gold-Standard

Description Usage Arguments Value Note See Also Examples

View source: R/DTComPair.R

Description

Produces a contingency table of results from a single binary diagnostic test vs. the gold-standard results.

Usage

1
tab.1test(d, y, data = NULL, testname, ...)

Arguments

d

A numeric vector specifying the gold-standard results (1 = presence of disease, 0 = absence of disease).

y

A numeric vector specifying the results of the diagnostic test (1 = positive, 0 = negative).

data

An optional data frame, list or environment containing the required variables d and y.

testname

An optional character variable specifying the name of the diagnostic test, e.g. c("Test A"). If not supplied, the variable name is used as the testname.

...

Additional arguments (usually not required).

Value

Returns a list of class tab.1test:

tab.1test

A contingency table (matrix) of test results.

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

The name of the diagnostic test.

Note

Objects of class tab.1test are required as arguments for acc.1test, a function to compute the accuracy of a binary diagnostic test.

See Also

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

Examples

1
2
3
4
5
data(Paired1) # Hypothetical study data 
a <- tab.1test(d=d, y=y1, data=Paired1)
str(a)
a$tab.1test
a

Example output

Loading required package: gee
Loading required package: PropCIs
List of 2
 $ tab.1test: num [1:3, 1:3] 397 54 451 84 177 261 481 231 712
  ..- attr(*, "dimnames")=List of 2
  .. ..$ : chr [1:3] "Test pos." "Test neg." "Total"
  .. ..$ : chr [1:3] "Diseased" "Non-diseased" "Total"
 $ testname : chr "y1"
 - attr(*, "class")= chr "tab.1test"
          Diseased Non-diseased Total
Test pos.      397           84   481
Test neg.       54          177   231
Total          451          261   712
Binary diagnostic test 'y1'

          Diseased Non-diseased Total
Test pos.      397           84   481
Test neg.       54          177   231
Total          451          261   712

DTComPair documentation built on May 29, 2017, 8:40 p.m.