| p.vec.func {binGroup} | R Documentation |
Generate a vector of probabilities for informative group testing algorithms.
Description
Generate a vector of individual risk probabilities using an overall probability of disease (i.e., the expected value of order statistics from a beta distribution) for use with informative group testing algorithms.
Usage
p.vec.func(p, alpha, grp.sz)
Arguments
p |
overall probability of disease that will be used to generate a vector of individual risk probabilities. |
alpha |
a shape parameter for the beta distribution that specifies the degree of heterogeneity for the generated probability vector. |
grp.sz |
the number of total individuals for which to generate risk probabilities. |
Details
This function uses Michael Black's beta.dist
function to generate a vector of individual risk probabilities,
ordered from least to greatest. Depending on the specified
probability, alpha level, and overall group size, simulation
may be necessary in order to generate the vector of individual
probabilities. For this reason, the user should set a seed in
order to reproduce results. The p.vec.func function
augments the beta.dist function by checking whether
simulation is needed before attempting to generate the vector
of individual risk probabilities. See Black et al. (2015)
for additional details on Michael Black's beta.dist
function.
Value
A vector of individual risk probabilities.
Author(s)
Brianna D. Hitt
References
Black, M., Bilder, C., Tebbs, J. (2015). “Optimal retesting configurations for hierarchical group testing.” Journal of the Royal Statistical Society. Series C: Applied Statistics, 64(4), 693–710. ISSN 14679876, doi: 10.1111/rssc.12097.
See Also
Informative.array.prob for arranging a vector
of individual risk probabilities in a matrix for informative
array testing without master pooling and beta.dist
for the function on which p.vec.func is based on.
http://chrisbilder.com/grouptesting
Other Individual risk probability functions: Informative.array.prob,
beta.dist
Examples
# This example takes less than 1 second to run.
# Estimated running time was calculated using a
# computer with 16 GB of RAM and one core of an
# Intel i7-6500U processor.
set.seed(8791)
p.vec.func(p=0.03, alpha=0.5, grp.sz=100)
# This example takes less than 1 second to run.
# Estimated running time was calculated using a
# computer with 16 GB of RAM and one core of an
# Intel i7-6500U processor.
set.seed(52613)
p.vec.func(p=0.005, alpha=2, grp.sz=40)