MDR.Rmd
With the function mdro()
, you can determine multi-drug resistant organisms (MDRO). It currently support these guidelines:
As an example, I will make a data set to determine multi-drug resistant TB:
# a helper function to get a random vector with values S, I and R
# with the probabilities 50%-10%-40%
sample_rsi <- function() {
sample(c("S", "I", "R"),
size = 5000,
prob = c(0.5, 0.1, 0.4),
replace = TRUE)
}
my_TB_data <- data.frame(rifampicin = sample_rsi(),
isoniazid = sample_rsi(),
gatifloxacin = sample_rsi(),
ethambutol = sample_rsi(),
pyrazinamide = sample_rsi(),
moxifloxacin = sample_rsi(),
kanamycin = sample_rsi())
Because all column names are automatically verified for valid drug names or codes, this would have worked exactly the same:
my_TB_data <- data.frame(RIF = sample_rsi(),
INH = sample_rsi(),
GAT = sample_rsi(),
ETH = sample_rsi(),
PZA = sample_rsi(),
MFX = sample_rsi(),
KAN = sample_rsi())
The data set looks like this now:
head(my_TB_data)
# rifampicin isoniazid gatifloxacin ethambutol pyrazinamide moxifloxacin
# 1 R R S I S S
# 2 S R I R S R
# 3 S S S S R R
# 4 R S R S S S
# 5 I R R S R R
# 6 S S S S S S
# kanamycin
# 1 S
# 2 R
# 3 S
# 4 R
# 5 R
# 6 R
We can now add the interpretation of MDR-TB to our data set:
my_TB_data$mdr <- mdr_tb(my_TB_data)
# NOTE: No column found as input for `col_mo`, assuming all records contain Mycobacterium tuberculosis.
# Determining multidrug-resistant organisms (MDRO), according to:
# Guideline: Companion handbook to the WHO guidelines for the programmatic management of drug-resistant tuberculosis
# Version: WHO/HTM/TB/2014.11
# Author: WHO (World Health Organization)
# Source: https://www.who.int/tb/publications/pmdt_companionhandbook/en/
# Warning: Reliability might be improved if these antimicrobial results
# would be available too: `CAP` (capreomycin), `RIB` (rifabutin), `RFP`
# (rifapentine)
And review the result with a frequency table:
Frequency table of mdr
from my_TB_data
(5,000 x 8)
Class: factor
> ordered
(numeric
)
Length: 5,000 (of which NA: 0 = 0.00%)
Levels: 5: Negative
< Mono-resistance
< Poly-resistance
< Multidrug res...
Unique: 5
Item | Count | Percent | Cum. Count | Cum. Percent | |
---|---|---|---|---|---|
1 | Mono-resistance | 3,288 | 65.8% | 3,288 | 65.8% |
2 | Negative | 686 | 13.7% | 3,974 | 79.5% |
3 | Multidrug resistance | 560 | 11.2% | 4,534 | 90.7% |
4 | Poly-resistance | 269 | 5.4% | 4,803 | 96.1% |
5 | Extensive drug resistance | 197 | 3.9% | 5,000 | 100.0% |