Data sets for download / own use
-29 March 2025
+31 March 2025
Source:vignettes/datasets.Rmd
datasets.Rmd
AMR 2.1.1.9231
+AMR 2.1.1.9232
(this beta version will eventually become v3.0. We’re happy to reach a new major milestone soon, which will be all about the new One Health support! Install this beta using the instructions here.)
A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)
+A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)
This package now supports not only tools for AMR data analysis in clinical settings, but also for veterinary and environmental microbiology. This was made possible through a collaboration with the University of Prince Edward Island’s Atlantic Veterinary College, Canada. To celebrate this great improvement of the package, we also updated the package logo to reflect this change.
Breaking
+Breaking
- Dataset
antibiotics
has been renamed toantimicrobials
as the data set contains more than just antibiotics. Usingantibiotics
will still work, but now returns a warning. - Removed all functions and references that used the deprecated
rsi
class, which were all replaced with theirsir
equivalents over two years ago. - Function
resistance_predict()
is now deprecated and will be removed in a future version. Use thetidymodels
framework instead, for which we wrote a basic introduction.
New
+New
-
One Health implementation
- Function
as.sir()
now has extensive support for veterinary breakpoints from CLSI. Usebreakpoint_type = "animal"
and set thehost
argument to a variable that contains animal species names.
@@ -116,7 +116,7 @@
- Function
Changed
+Changed
- SIR interpretation
- It is now possible to use column names for argument
ab
,mo
, anduti
:as.sir(..., ab = "column1", mo = "column2", uti = "column3")
. This greatly improves the flexibility for users. - Users can now set their own criteria (using regular expressions) as to what should be considered S, I, R, SDD, and NI. @@ -160,6 +160,9 @@
- Comparisons of MIC values are now more strict. For example,
>32
is higher than (and never equal to)32
. Thus,as.mic(">32") == as.mic(32)
now returnsFALSE
, andas.mic(">32") > as.mic(32)
now returnsTRUE
. - Sorting of MIC values (using
sort()
) was fixed in the same manner;<0.001
now gets sorted before0.001
, and>0.001
gets sorted after0.001
. - Intermediate log2 levels used for MIC plotting are now more common values instead of following a strict dilution range +
-
+
is.mic()
now returns a vector ofTRUE
/FALSE
if the input is adata.frame
, just likeas.sir()
+
- It is now possible to use column names for argument
-
eucast_rules()
now has an argumentoverwrite
(default:FALSE
) to indicate whether non-NA
values should be overwritten
@@ -192,7 +195,7 @@
- Added console colours support of
sir
class for Positron
Other
+Other
- Added Dr. Larisse Bolton and Aislinn Cook as contributors for their fantastic implementation of WISCA in a mathematically solid way
- Added Matthew Saab, Dr. Jordan Stull, and Prof. Javier Sanchez as contributors for their tremendous input on veterinary breakpoints and interpretations
- Added Prof. Kat Holt, Dr. Jane Hawkey, and Dr. Natacha Couto as contributors for their many suggestions, ideas and bugfixes @@ -201,7 +204,7 @@
- Stopped support for SAS (
.xpt
) files, since their file structure and extremely inefficient and requires more disk space than GitHub allows in a single commit.
Older Versions
+Older Versions
This changelog only contains changes from AMR v3.0 (March 2025) and later.
- For prior v2 versions, please see our v2 archive.
- For prior v1 versions, please see our v1 archive. diff --git a/pkgdown.yml b/pkgdown.yml index 78ae4a18c..bd4f8aa8e 100644 --- a/pkgdown.yml +++ b/pkgdown.yml @@ -11,7 +11,7 @@ articles: PCA: PCA.html welcome_to_AMR: welcome_to_AMR.html WHONET: WHONET.html -last_built: 2025-03-29T17:08Z +last_built: 2025-03-31T08:57Z 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 a58ad0b51..bd810dd1f 100644 --- a/reference/AMR-deprecated.html +++ b/reference/AMR-deprecated.html @@ -7,7 +7,7 @@ AMR (for R) - 2.1.1.9231 + 2.1.1.9232
- text -
text to analyse
+Text to analyse
- type -
type of property to search for, either
"drug"
,"dose"
or"administration"
, see Examples
+Type of property to search for, either
"drug"
,"dose"
or"administration"
, see Examples- collapse -
a character to pass on to
paste(, collapse = ...)
to only return one character per element oftext
, see Examples
+A character to pass on to
paste(, collapse = ...)
to only return one character per element oftext
, see Examples- translate_ab -
if
type = "drug"
: a column name of the antimicrobials data set to translate the antibiotic abbreviations to, usingab_property()
. The default isFALSE
. UsingTRUE
is equal to using "name".
+If
type = "drug"
: a column name of the antimicrobials data set to translate the antibiotic abbreviations to, usingab_property()
. The default isFALSE
. UsingTRUE
is equal to using "name".- thorough_search -
a logical to indicate whether the input must be extensively searched for misspelling and other faulty input values. Setting this to
TRUE
will take considerably more time than when usingFALSE
. At default, it will turnTRUE
when all input elements contain a maximum of three words.
+A logical to indicate whether the input must be extensively searched for misspelling and other faulty input values. Setting this to
TRUE
will take considerably more time than when usingFALSE
. At default, it will turnTRUE
when all input elements contain a maximum of three words.- info -
a logical to indicate whether a progress bar should be printed - the default is
TRUE
only in interactive mode
+A logical to indicate whether a progress bar should be printed - the default is
TRUE
only in interactive mode- ... -
arguments passed on to
as.ab()
+Arguments passed on to
as.ab()
- x -
any (vector of) text that can be coerced to a valid antibiotic drug code with
as.ab()
+Any (vector of) text that can be coerced to a valid antibiotic drug code with
as.ab()
- language -
language of the returned text - the default is the current system language (see
get_AMR_locale()
) and can also be set with the package optionAMR_locale
. Uselanguage = NULL
orlanguage = ""
to prevent translation.
+Language of the returned text - the default is the current system language (see
get_AMR_locale()
) and can also be set with the package optionAMR_locale
. Uselanguage = NULL
orlanguage = ""
to prevent translation.- tolower -
a logical to indicate whether the first character of every output should be transformed to a lower case character. This will lead to e.g. "polymyxin B" and not "polymyxin b".
+A logical to indicate whether the first character of every output should be transformed to a lower case character. This will lead to e.g. "polymyxin B" and not "polymyxin b".
- ... -
in case of
set_ab_names()
anddata
is a data.frame: columns to select (supports tidy selection such ascolumn1:column4
), otherwise other arguments passed on toas.ab()
+In case of
set_ab_names()
anddata
is a data.frame: columns to select (supports tidy selection such ascolumn1:column4
), otherwise other arguments passed on toas.ab()
- only_first -
a logical to indicate whether only the first ATC code must be returned, with giving preference to J0-codes (i.e., the antimicrobial drug group)
+A logical to indicate whether only the first ATC code must be returned, with giving preference to J0-codes (i.e., the antimicrobial drug group)
- administration -
way of administration, either
"oral"
or"iv"
+Way of administration, either
"oral"
or"iv"
- open -
browse the URL using
utils::browseURL()
+Browse the URL using
utils::browseURL()
- property -
one of the column names of one of the antimicrobials data set:
vector_or(colnames(antimicrobials), sort = FALSE)
.
+One of the column names of one of the antimicrobials data set:
vector_or(colnames(antimicrobials), sort = FALSE)
.- data -
a data.frame of which the columns need to be renamed, or a character vector of column names
+A data.frame of which the columns need to be renamed, or a character vector of column names
- snake_case -
a logical to indicate whether the names should be in so-called snake case: in lower case and all spaces/slashes replaced with an underscore (
_
)
+A logical to indicate whether the names should be in so-called snake case: in lower case and all spaces/slashes replaced with an underscore (
_
)
- x -
a data.frame resembling the antimicrobials data set, at least containing columns "ab" and "name"
+A data.frame resembling the antimicrobials data set, at least containing columns "ab" and "name"
- x -
a data.frame resembling the microorganisms data set, at least containing column "genus" (case-insensitive)
+A data.frame resembling the microorganisms data set, at least containing column "genus" (case-insensitive)
- x -
date(s), character (vectors) will be coerced with
as.POSIXlt()
+Date(s), character (vectors) will be coerced with
as.POSIXlt()
- reference -
reference date(s) (default is today), character (vectors) will be coerced with
as.POSIXlt()
+Reference date(s) (default is today), character (vectors) will be coerced with
as.POSIXlt()
- exact -
a logical to indicate whether age calculation should be exact, i.e. with decimals. It divides the number of days of year-to-date (YTD) of
x
by the number of days in the year ofreference
(either 365 or 366).
+A logical to indicate whether age calculation should be exact, i.e. with decimals. It divides the number of days of year-to-date (YTD) of
x
by the number of days in the year ofreference
(either 365 or 366).- na.rm -
a logical to indicate whether missing values should be removed
+A logical to indicate whether missing values should be removed
- ... -
arguments passed on to
as.POSIXlt()
, such asorigin
+Arguments passed on to
as.POSIXlt()
, such asorigin