| computePValueRiskGroups {FFD} | R Documentation |
FUNCTION to compute the probability of finding no testpositives in a sample of a certain size for a population stratified into risk groups.
Description
For a population that is stratified into risk groups the function computes the
probability of finding no testpositives in a sample of given size using an
imperfect diagnostic test. For each of the risk groups the population size
nPopulationVec, the sample size nSampleVec and the relative
infection risk nRelRiskVec must be specified. The discussed probability
corresponds to the alpha-error (=error of the first kind) of the overall test
with null hypothesis: prevalence = design prevalence.
Usage
computePValueRiskGroups(nPopulationVec, nSampleVec,
nRelRiskVec, nDiseased, sensitivity,
specificity = 1)
Arguments
nPopulationVec |
Integer vector. Population sizes of the risk groups. |
nSampleVec |
Integer vector. Sample sizes of the risk groups. |
nRelRiskVec |
Numeric vector. (Relative) infection risks of the risk groups. |
nDiseased |
Integer. Number of diseased elements in the population according to the design prevalence. |
sensitivity |
Numeric between 0 and 1. Sensitivity (= probability of a testpositive result, given the tested individual is diseased) of the test (e.g., diagnostic test or herd test). |
specificity |
Numeric between 0 and 1. Specificity (= probability of a testnegative result, given the tested individual is not diseased) of the test (e.g., diagnostic test or herd test). The default value is 1. |
Value
The return value is a numeric between 0 and 1. It is the probability of finding no testpositives (not diseased!) in the sample.
Author(s)
Ian Kopacka <ian.kopacka@ages.at>
References
A.R. Cameron and F.C. Baldock, "A new probablility formula to substantiate freedom from disease", Prev. Vet. Med. 34 (1998), pp. 1-17.
P.A.J.Martin, A.R. Cameron, M. Greiner, "Demonstrating freedom from disease using multiple complex data sources. : A new methodology based on scenario trees", Prev. Vet. Med. 79 (2007), pp. 71 - 97.
See Also
Calls computePValue
Examples
nPopulationVec <- c(500,700)
nSampleVec <- c(300,200)
nRelRiskVec <- c(1,1)
nDiseased <- round(sum(nPopulationVec)*0.01)
sensitivity <- 0.9
specificity <- 1
alphaError <- computePValue(sum(nPopulationVec), sum(nSampleVec),
nDiseased, sensitivity, specificity)