Data sets for download / own use
-06 January 2023
+07 January 2023
Source:vignettes/datasets.Rmd
datasets.Rmd
AMR 1.8.2.9086
+AMR 1.8.2.9088
(this beta version will eventually become v2.0! We’re happy to reach a new major milestone soon!)
This is a new major release of the AMR package, with great new additions but also some breaking changes for current users. These are all listed below.
@@ -145,19 +145,19 @@rsi_confidence_interval()
and mean_amr_distance()
, and add_custom_microorganisms()
to add custom microorganisms to this packageNew
+New
Interpretation of MIC and disk diffusion values
+Interpretation of MIC and disk diffusion values
The clinical breakpoints and intrinsic resistance of EUCAST 2022 and CLSI 2022 have been added for as.rsi()
. EUCAST 2022 (v12.0) is now the new default guideline for all MIC and disks diffusion interpretations, and for eucast_rules()
to apply EUCAST Expert Rules. The default guideline (EUCAST) can now be changed with the new AMR_guideline
option, such as: options(AMR_guideline = "CLSI 2020")
.
Interpretation guidelines older than 10 years were removed, the oldest now included guidelines of EUCAST and CLSI are from 2013.
Supported languages
+Supported languages
We added support for the following languages: Chinese, Greek, Japanese, Polish, Turkish and Ukrainian. All antibiotic names are now available in these languages, and the AMR package will automatically determine a supported language based on the user system language.
We are very grateful for the valuable input by our colleagues from other countries. The AMR
package is now available in 16 languages and according to download stats used in almost all countries in the world!
Microbiological taxonomy
+Microbiological taxonomy
The microorganisms
data set no longer relies on the Catalogue of Life, but on the List of Prokaryotic names with Standing in Nomenclature (LPSN) and is supplemented with the ‘backbone taxonomy’ from the Global Biodiversity Information Facility (GBIF). The structure of this data set has changed to include separate LPSN and GBIF identifiers. Almost all previous MO codes were retained. It contains over 1,400 taxonomic names from 2022.
We previously relied on our own experience to categorise species into pathogenic groups, but we were very happy to encounter the very recent work of Bartlett et al. (2022, DOI 10.1099/mic.0.001269) who extensively studied medical-scientific literature to categorise all bacterial species into groups. See mo_matching_score()
on how their work was incorporated into the prevalence
column of the microorganisms
data set. Using their results, the as.mo()
and all mo_*()
functions are now much better capable of converting user input to valid taxonomic records.
The new function add_custom_microorganisms()
allows users to add custom microorganisms to the AMR
package.
microorganisms.old
data set was removed, and all previously accepted names are now included in the microorganisms
data set. A new column status
contains "accepted"
for currently accepted names and "synonym"
for taxonomic synonyms; currently invalid names. All previously accepted names now have a microorganisms ID and - if available - an LPSN, GBIF and SNOMED CT identifier.Antibiotic agents and selectors
+Antibiotic agents and selectors
The new function add_custom_antimicrobials()
allows users to add custom antimicrobial codes and names to the AMR
package.
The antibiotics
data set was greatly updated:
- The following 20 antibiotics have been added (also includes the new J01RA ATC group): azithromycin/fluconazole/secnidazole (AFC), cefepime/amikacin (CFA), cefixime/ornidazole (CEO), ceftriaxone/beta-lactamase inhibitor (CEB), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), furazidin (FUR), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), lascufloxacin (LSC), levofloxacin/ornidazole (LEO), nemonoxacin (NEM), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin/ornidazole (OOR), oteseconazole (OTE), rifampicin/ethambutol/isoniazid (REI), sarecycline (SRC), tetracycline/oleandomycin (TOL), and thioacetazone (TAT) @@ -193,14 +193,14 @@
Also, we added support for using antibiotic selectors in scoped dplyr
verbs (with or without using vars()
), such as in: ... %>% summarise_at(aminoglycosides(), resistance)
, please see resistance()
for examples.
Antiviral agents
+Antiviral agents
We now added extensive support for antiviral agents! For the first time, the AMR
package has extensive support for antiviral drugs and to work with their names, codes and other data in any way.
- The
antivirals
data set has been extended with 18 new drugs (also from the new J05AJ ATC group) and now also contains antiviral identifiers and LOINC codes - A new data type
av
(antivirals) has been added, which is functionally similar toab
for antibiotics - Functions
as.av()
,av_name()
,av_atc()
,av_synonyms()
,av_from_text()
have all been added as siblings to theirab_*()
equivalents
Other new functions
+Other new functions
- Function
rsi_confidence_interval()
to add confidence intervals in AMR calculation. This is now also included inrsi_df()
andproportion_df()
. - Function
mean_amr_distance()
to calculate the mean AMR distance. The mean AMR distance is a normalised numeric value to compare AMR test results and can help to identify similar isolates, without comparing antibiograms by hand. - Function
rsi_interpretation_history()
to view the history of previous runs ofas.rsi()
. This returns a ‘logbook’ with the selected guideline, reference table and specific interpretation of each row in a data set on whichas.rsi()
was run.
@@ -209,7 +209,7 @@
Changes
+Changes
- Argument
combine_IR
has been removed from this package (affecting functionscount_df()
,proportion_df()
, andrsi_df()
and some plotting functions), since it was replaced withcombine_SI
three years ago - Using
units
inab_ddd(..., units = "...")
had been deprecated for some time and is now not supported anymore. Useab_ddd_units()
instead. - Support for
data.frame
-enhancing R packages, more specifically:data.table::data.table
,janitor::tabyl
,tibble::tibble
, andtsibble::tsibble
. AMR package functions that have a data set as output (such asrsi_df()
andbug_drug_combinations()
), will now return the same data type as the input.
@@ -248,7 +248,7 @@
- Cleaning columns with
as.rsi()
,as.mic()
, oras.disk()
will now show the column name in the warning for invalid results
Other
+Other
- New website to make use of the new Bootstrap 5 and pkgdown 2.0. The website now contains results for all examples and will be automatically regenerated with every change to our repository, using GitHub Actions
- Added Peter Dutey-Magni, Dmytro Mykhailenko, Anton Mymrikov, and Jonas Salm as contributors, to thank them for their valuable input
- All R and Rmd files in this project are now styled using the
styler
package
diff --git a/pkgdown.yml b/pkgdown.yml
index 643d92b8..3684de7c 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -11,7 +11,7 @@ articles:
datasets: datasets.html
resistance_predict: resistance_predict.html
welcome_to_AMR: welcome_to_AMR.html
-last_built: 2023-01-06T18:25Z
+last_built: 2023-01-07T00:58Z
urls:
reference: https://msberends.github.io/AMR/reference
article: https://msberends.github.io/AMR/articles
diff --git a/reference/AMR-deprecated.html b/reference/AMR-deprecated.html
index dc77fd3e..d92b324c 100644
--- a/reference/AMR-deprecated.html
+++ b/reference/AMR-deprecated.html
@@ -10,7 +10,7 @@
AMR (for R)
- 1.8.2.9086
+ 1.8.2.9088