How to determine multi-drug resistance (MDR)

With the function mdro(), you can determine multi-drug resistant organisms (MDRO). It currently support these guidelines:

“Intrinsic Resistance and Exceptional Phenotypes Tables”, by EUCAST (European Committee on Antimicrobial Susceptibility Testing)
“Companion handbook to the WHO guidelines for the programmatic management of drug-resistant tuberculosis”, by WHO (World Health Organization)
“WIP-Richtlijn Bijzonder Resistente Micro-organismen (BRMO)”, by RIVM (Rijksinstituut voor de Volksgezondheid, the Netherlands National Institute for Public Health and the Environment)

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          S            I            S
# 2          S         S            S          R            R            R
# 3          S         S            S          S            R            R
# 4          S         S            S          R            S            R
# 5          S         R            R          R            R            R
# 6          S         S            R          S            S            I
#   kanamycin
# 1         S
# 2         R
# 3         S
# 4         S
# 5         S
# 6         S

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/
# NOTE: Reliability might be improved if these antimicrobial results would be available too: CAP (capreomycin), RIB (rifabutin), RFP (rifapentine)

We also created a package dedicated to data cleaning and checking, called the clean package. It gets automatically installed with the AMR package, so we only have to load it:

library(clean)

It contains the freq() function, to create a frequency table:

freq(my_TB_data$mdr)

Frequency table

Class: factor > ordered (numeric)
Length: 5,000 (of which NA: 0 = 0.00%)
Levels: 5: Negative < Mono-resistance < Poly-resistance < Multidrug resistance…
Unique: 5

	Item	Count	Percent	Cum. Count	Cum. Percent
1	Mono-resistance	3271	65.4%	3271	65.4%
2	Negative	643	12.9%	3914	78.3%
3	Multidrug resistance	582	11.6%	4496	89.9%
4	Poly-resistance	287	5.7%	4783	95.7%
5	Extensive drug resistance	217	4.3%	5000	100.0%

Matthijs S. Berends

07 August 2019