Skip to contents

Options for the AMR package

Source: R/aa_options.R
AMR-options.Rd

This is an overview of all the package-specific options() you can set in the AMR package.

Options

  • AMR_custom_ab
    Allows to use custom antimicrobial drugs with this package. This is explained in add_custom_antimicrobials().

  • AMR_custom_mo
    Allows to use custom microorganisms with this package. This is explained in add_custom_microorganisms().

  • AMR_eucastrules
    Used for setting the default types of rules for eucast_rules() function, must be one or more of: "breakpoints", "expert", "other", "custom", "all", and defaults to c("breakpoints", "expert").

  • AMR_guideline
    Used for setting the default guideline for interpreting MIC values and disk diffusion diameters with as.sir(). Can be only the guideline name (e.g., "CLSI") or the name with a year (e.g. "CLSI 2019"). The default to the latest implemented EUCAST guideline, currently "EUCAST 2023". Supported guideline are currently EUCAST (2011-2023) and CLSI (2011-2023).

  • AMR_ignore_pattern
    A regular expression to ignore (i.e., make NA) any match given in as.mo() and all mo_* functions.

  • AMR_include_PKPD
    A logical to use in as.sir(), to indicate that PK/PD clinical breakpoints must be applied as a last resort - the default is TRUE.

  • AMR_ecoff
    A logical use in as.sir(), to indicate that ECOFF (Epidemiological Cut-Off) values must be used - the default is FALSE.

  • AMR_include_screening
    A logical to use in as.sir(), to indicate that clinical breakpoints for screening are allowed - the default is FALSE.

  • AMR_keep_synonyms
    A logical to use in as.mo() and all mo_* functions, to indicate if old, previously valid taxonomic names must be preserved and not be corrected to currently accepted names. The default is FALSE.

  • AMR_cleaning_regex
    A regular expression (case-insensitive) to use in as.mo() and all mo_* functions, to clean the user input. The default is the outcome of mo_cleaning_regex(), which removes texts between brackets and texts such as "species" and "serovar".

  • AMR_locale
    A language to use for the AMR package, can be one of these supported language names or ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (it), Japanese (ja), Norwegian (no), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), or Ukrainian (uk). The default is the current system language (if supported).

  • AMR_mo_source
    A file location for a manual code list to be used in as.mo() and all mo_* functions. This is explained in set_mo_source().

Saving Settings Between Sessions

Settings in R are not saved globally and are thus lost when R is exited. You can save your options to your own .Rprofile file, which is a user-specific file. You can edit it using:

  utils::file.edit("~/.Rprofile")

In this file, you can set options such as:

 options(AMR_locale = "pt")
 options(AMR_include_PKPD = TRUE)

to add Portuguese language support of antibiotics, and allow PK/PD rules when interpreting MIC values with as.sir().

Share Options Within Team

For a more global approach, e.g. within a data team, save an options file to a remote file location, such as a shared network drive. This would work in this way:

  1. Save a plain text file to e.g. "X:/team_folder/R_options.R" and fill it with preferred settings.

  2. For each user, open the .Rprofile file using utils::file.edit("~/.Rprofile") and put in there:

      source("X:/team_folder/R_options.R")

  3. Reload R/RStudio and check the settings with getOption(), e.g. getOption("AMR_locale") if you have set that value.

Now the team settings are configured in only one place, and can be maintained there.