AMR (R package)
| AMR | |
|---|---|
| Original author | Matthijs S. Berends |
| Developers | Berends MS, Luz CF, Friedrich AW, et al. (2022) |
| Release | 22 February 2018 |
| Stable release | v3.0.1
/ 20 September 2025 |
| Written in | R, Python |
| Operating system | Cross-platform |
| Available in | Available in numerous languages |
| Type | Antimicrobial resistance data analysis |
| License | GPL-2 |
| Website | amr-for-r |
AMR is a free and open-source package for the R programming language, designed to simplify the analysis of antimicrobial resistance (AMR) data.
It has aimed to provide a standard for clean and reproducible AMR data analysis, enabling surveillance and treatment evaluation in both clinical and research settings. Since its first public release on CRAN in early 2018, the package has been downloaded from over 175 countries, as measured by CRAN download logs.[1] It has been adopted in clinical, veterinary, and environmental microbiology settings worldwide.[1][2][3][4][5][6][7]
Studies employing the package have included national paediatric bloodstream infection surveillance,[3] population-wide AMR burden analysis,[4] companion animal MRSA surveillance across veterinary practices,[5] environmental resistance gene screening in fresh produce,[6] and a perspective on clinical AMR surveillance tools.[7]
Initial development
The package was initially developed at the University of Groningen and the University Medical Center Groningen (UMCG), in the Netherlands.[8][1]
The work was published as a peer-reviewed paper in the Journal of Statistical Software and formed the basis of two PhD theses at the University of Groningen.[8][9][10] According to CRAN, the package has no external dependencies and is compatible with R versions from R-3.0 (April 2013) onwards.[2]
Background
Antimicrobial resistance is recognised by the World Health Organization as one of the leading public health threats globally. Laboratories routinely test microorganisms for resistance against antimicrobial agents, and the resulting data must be reported and analysed at various levels, from local hospitals to international surveillance networks. Despite the existence of international standards for testing and reporting, there was, prior to the AMR package, a lack of standardised open-source tools to process and analyse these data in a reproducible manner. Data from laboratory information systems often require substantial cleaning and validation before analysis, and meaningful interpretation depends on up-to-date reference data, such as microbial taxonomy and clinical breakpoint guidelines.[8]
The AMR package was developed to bridge this gap, providing an integrated toolbox that incorporates relevant international guidelines and reference data directly into the analysis workflow.[8]
Functionality
The package offers tools for several core tasks in AMR data analysis.[8][2]
It includes a built-in taxonomic database of microbial species, drawing on sources such as the List of Prokaryotic names with Standing in Nomenclature (LPSN), the Global Biodiversity Information Facility (GBIF), and MycoBank, allowing users to look up and standardise microorganism names and properties.[8]
A comprehensive data set of antimicrobial and antiviral agents is included, linked to international coding systems such as the ATC classification, EARS-Net, PubChem, LOINC, and SNOMED CT.[2]
Clinical breakpoint guidelines from the Clinical and Laboratory Standards Institute (CLSI) and the European Committee on Antimicrobial Susceptibility Testing (EUCAST) are integrated, covering multiple years of published guidelines and including veterinary breakpoints and epidemiological cut-off values. These enable the interpretation of raw laboratory measurements, such as minimum inhibitory concentration values and disk diffusion diameters, into standardised susceptibility categories.[8]
Additional functions support the determination of first isolates per patient, the generation of antibiograms (including WISCA), the identification of multi-drug resistant organisms, and the calculation and visualisation of resistance proportions. The package can import data in any format, including exports from the WHO's WHONET software.[8][1]
All reference data sets are freely available for download in multiple formats, including Microsoft Excel, Apache Parquet, SPSS, Stata, and plain text, making them accessible to users outside the R ecosystem as well.[2]
Custom data types
AMR introduces several new data types (called S3 classes) to R, including mo (microorganism codes), ab (antimicrobial drug codes), sir (susceptibility interpretation results), mic (minimum inhibitory concentrations), and disk (disk diffusion diameters). These classes support validation, intelligent coercion, and integration with common R workflows.[8]
Python wrapper
A Python wrapper is also available, which runs the AMR R package natively in Python. The Python package follows the same version numbering and is built automatically alongside the R package.[1]
Licensing
The AMR package is licensed under the GNU General Public License v2.0 (GPL-2).[2]
See also
- R (programming language)
- Antimicrobial resistance
- European Committee on Antimicrobial Susceptibility Testing
- Clinical and Laboratory Standards Institute
References
- ^ a b c d e "AMR – Antimicrobial Resistance Data Analysis". Retrieved 24 March 2026.
- ^ a b c d e f "CRAN – Package AMR". Retrieved 24 March 2026.
- ^ a b Williams, Anita; Coombs, Geoffrey W.; Bell, Jan M.; et al. (2024). "Antimicrobial Resistance in Enterobacterales, Acinetobacter spp. and Pseudomonas aeruginosa Isolates From Bloodstream Infections in Australian Children, 2013–2021". Journal of the Pediatric Infectious Diseases Society. 13 (12): 617–625. doi:10.1093/jpids/piae111. PMID 39460715.
- ^ a b Brown, Kevin A.; Fridman, Daniel J.; Garber, Gary E.; et al. (2025). "The Burden of Antimicrobial Resistant Bacteremia in Ontario: A Population-Wide Analysis of Attributable Mortality From 110 Pathogen-Antibiotic Combinations". Clinical Infectious Diseases. 81 (4): 728–737. doi:10.1093/cid/ciaf213. PMC 12596364. PMID 40356393.
- ^ a b Feuer, Leonie; Frenzer, Stefanie Katharina; Merle, Roswitha; et al. (2024). "Prevalence of MRSA in canine and feline clinical samples from one-third of veterinary practices in Germany from 2019–2021". Journal of Antimicrobial Chemotherapy. 79 (9): 2273–2280. doi:10.1093/jac/dkae225. PMID 39007221.
- ^ a b Kläui, Anita; Bütikofer, Ueli; Naskova, Javorka; Wagner, Elvira; Marti, Elisabet (2024). "Fresh produce as a reservoir of antimicrobial resistance genes: A case study of Switzerland". Science of the Total Environment. 907 167671. doi:10.1016/j.scitotenv.2023.167671. PMID 37813266.
- ^ a b Holt, Kathryn E.; Carey, Megan E.; Chandler, Clare; et al. (2025). "Tools and challenges in the use of routine clinical data for antimicrobial resistance surveillance". npj Antimicrobials and Resistance. 3 (1): 37. doi:10.1038/s44259-025-00105-3. PMC 12064641. PMID 40346194.
- ^ a b c d e f g h i Berends, Matthijs S.; Luz, Christian F.; Friedrich, Alexander W.; Sinha, Bhanu N. M.; Albers, Casper J.; Glasner, Corinna (2022). "AMR: An R Package for Working with Antimicrobial Resistance Data". Journal of Statistical Software. 104 (3): 1–31. doi:10.18637/jss.v104.i03. hdl:11370/b42e702e-a117-4da1-b266-84a765a83e7a.
- ^ Berends, Matthijs S. (2021). A New Instrument for Microbial Epidemiology (PhD). University of Groningen. doi:10.33612/diss.177417131.
- ^ Luz, Christian F. (2021). Data Science for Infection Management & Antimicrobial Stewardship (PhD). University of Groningen. doi:10.33612/diss.192486375.