mp_atr: Average Tests Required (ATR) needed by MiniPooling (MP)

In whitneysu/QuantitativePooledTesting: Pooled Testing Strategies with Quantitative Assays

Description

This function calculates the ART needed by MP for a range of pool sizes (from 2 to a pool size specified).

Usage

mp_atr(v, N = length(v), max_K = 5, cutoff = 1000, quietly = TRUE)

Arguments

v	Numeric vector of the observations for calculating ecdf. For quantitative pooling strategies, only CDF on the support of v < cutoff is needed; so v can be the fraction of observations less than the cutoff and use N to pass the number of all observations.
N	The number (vector length) of the observations. By default, N = length(v).
max_K	Maximum pool size that is considered.
cutoff	Cutoff value of quantitative assay that defines test positivity. By default, cutoff = max(v) which calculates the CDF for the entire support of v.
quietly	Logical value; whether print the results to screen or not.

Value

The function returns a matrix of two columns: The pool size from 2:max_K and the Average Tests Required by MP given that pool size (MP_ATR)

References

Liu T, Hogan JW, Daniels, MJ, Coetzer M, Xu Y, Bove G, et al. Improved HIV-1 Viral Load Monitoring Capacity Using Pooled Testing with Marker-Assisted Deconvolution. Journal of AIDS. 2017;75(5): 580-587.

Examples

mp_atr(c(200, 1500, 1900, 800, 950), max_K = 9, cutoff = 2000, quietly = TRUE)
mp_atr(c(200, 1500, 1900, 800, 950), max_K = 6, cutoff = 1000, quietly = TRUE)

whitneysu/QuantitativePooledTesting documentation built on Feb. 2, 2021, 12:46 p.m.