nNPVPPV {bdpv}R Documentation

Asymptotic experimental design for inference on negative and positive predictive values in case-control studies.

Description

For internal use. Functions to compute sample size (to reach a pre-specified power) and optimal allocation of true positives and true negatives in case-control designs for binary diagnostic tests (Mercaldo et al. 2007).

Usage

nNPV(propP, se, sp, prev, NPV0,
 conf.level = 0.95, power = 0.8)

nPPV(propP, se, sp, prev, PPV0,
 conf.level = 0.95, power = 0.8)

AOppvnpv(se, sp)

Arguments

se

a numeric value, specifying the expected sensitivity

sp

a numeric value, specifying the expected specificity

propP

a vector of numeric values of proportions of truely positives in the trial (n1/(n1+n0))

prev

a numeric value, the prevalence

NPV0

a numeric value, the negative predictive value to be rejected under H0: NPV>=NPV0

PPV0

a numeric value, the positive predictive value to be rejected under H0: PPV>=PPV0

conf.level

a single numeric values, the nominal confidence level (1-alpha)

power

a single numeric value, the power that is to be obtained

Details

The functions implement the methods described in section 3.2 of Steinberg et al.(2009), nPPV gives the solution to Eq.(3.6) and NA if necesarry conditions mentioned before are not fulfilled, nNPV gives the solution to Eq.(3.8) and NA if necesarry conditions mentioned before are not fulfilled, AOppvnpv gives the optimal proportion of true poistives as are solutions to Eq.(3.4) and Eq. (3.6) for PPV and NPV, respectively.

Value

For nNPV and nPPV: a list with first element

n

the (vector of) sample size (s), or NA if necessary conditions are not met

and further elements giving the input arguments

Author(s)

Frank Schaarschmidt

References

Steinberg DM, Fine J, Chappell R (2009). Sample size for positive and negative predictive value in diagnostic research using case-control designs. Biostatistics 10,1, 94-105.

See Also

For a combination of PPV and NPV experimental design see nPV and plotnPV; to validate small sample results of these asymptotic formulas, see simPVmat

Examples


 nPPV(propP=c(0.2,0.4,0.6,0.8), se=0.9, sp=0.9,
 prev=0.1, PPV0=0.4, conf.level=0.95, power=0.8)

 nNPV(propP=c(0.2,0.4,0.6,0.8), se=0.9, sp=0.9,
 prev=0.1, NPV0=0.95, conf.level=0.95, power=0.8)

 AOppvnpv(se=0.9, sp=0.9)

[Package bdpv version 1.3 Index]