P281424/AMR
1
0
Fork 0
mirror of https://github.com/msberends/AMR.git synced 2026-02-23 22:19:08 +01:00
Code Releases Activity

Built site for AMR@3.0.1.9021: 12cf144

Browse Source
This commit is contained in:
github-actions
2026-02-12 19:45:10 +00:00
parent c149bb1f65
commit f0ec851466
94 changed files with 333 additions and 167 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
reference/AMR-options.html
View File

@@ -1,5 +1,7 @@
<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>Options for the AMR package — AMR-options • AMR (for R)</title><!-- favicons --><link rel="icon" type="image/png" sizes="96x96" href="../favicon-96x96.png"><link rel="icon" type="”image/svg+xml”" href="../favicon.svg"><link rel="apple-touch-icon" sizes="180x180" href="../apple-touch-icon.png"><link rel="icon" sizes="any" href="../favicon.ico"><link rel="manifest" href="../site.webmanifest"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/Lato-0.4.10/font.css" rel="stylesheet"><link href="../deps/Fira_Code-0.4.10/font.css" rel="stylesheet"><link href="../deps/font-awesome-6.5.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.5.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><link href="../extra.css" rel="stylesheet"><script src="../extra.js"></script><meta property="og:title" content="Options for the AMR package — AMR-options"><meta name="description" content="This is an overview of all the package-specific options() you can set in the AMR package."><meta property="og:description" content="This is an overview of all the package-specific options() you can set in the AMR package."><meta property="og:image" content="https://amr-for-r.org/logo.svg"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css" integrity="sha384-nB0miv6/jRmo5UMMR1wu3Gz6NLsoTkbqJghGIsx//Rlm+ZU03BU6SQNC66uf4l5+" crossorigin="anonymous"><script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.js" integrity="sha384-7zkQWkzuo3B5mTepMUcHkMB5jZaolc2xDwL6VFqjFALcbeS9Ggm/Yr2r3Dy4lfFg" crossorigin="anonymous"></script><script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/auto-render.min.js" integrity="sha384-43gviWU0YVjaDtb/GhzOouOXtZMP/7XUzwPTstBeZFe/+rCMvRwr4yROQP43s0Xk" crossorigin="anonymous" onload="renderMathInElement(document.body);"></script></head><body>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>Options for the AMR package — AMR-options • AMR (for R)</title><!-- favicons --><link rel="icon" type="image/png" sizes="96x96" href="../favicon-96x96.png"><link rel="icon" type="”image/svg+xml”" href="../favicon.svg"><link rel="apple-touch-icon" sizes="180x180" href="../apple-touch-icon.png"><link rel="icon" sizes="any" href="../favicon.ico"><link rel="manifest" href="../site.webmanifest"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/Lato-0.4.10/font.css" rel="stylesheet"><link href="../deps/Fira_Code-0.4.10/font.css" rel="stylesheet"><link href="../deps/font-awesome-6.5.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.5.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><link href="../extra.css" rel="stylesheet"><script src="../extra.js"></script><meta property="og:title" content="Options for the AMR package — AMR-options"><meta name="description" content='This is an overview of all the package-specific options you can set in the AMR package. Set them using the options() function, e.g.:
options(AMR_guideline = "CLSI")'><meta property="og:description" content='This is an overview of all the package-specific options you can set in the AMR package. Set them using the options() function, e.g.:
options(AMR_guideline = "CLSI")'><meta property="og:image" content="https://amr-for-r.org/logo.svg"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css" integrity="sha384-nB0miv6/jRmo5UMMR1wu3Gz6NLsoTkbqJghGIsx//Rlm+ZU03BU6SQNC66uf4l5+" crossorigin="anonymous"><script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.js" integrity="sha384-7zkQWkzuo3B5mTepMUcHkMB5jZaolc2xDwL6VFqjFALcbeS9Ggm/Yr2r3Dy4lfFg" crossorigin="anonymous"></script><script defer src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/auto-render.min.js" integrity="sha384-43gviWU0YVjaDtb/GhzOouOXtZMP/7XUzwPTstBeZFe/+rCMvRwr4yROQP43s0Xk" crossorigin="anonymous" onload="renderMathInElement(document.body);"></script></head><body>
<a href="#main" class="visually-hidden-focusable">Skip to contents</a>
@@ -7,7 +9,7 @@
<a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
<small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1.9020</small>
<small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1.9021</small>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -50,12 +52,13 @@
</div>
<div class="ref-description section level2">
<p>This is an overview of all the package-specific <code><a href="https://rdrr.io/r/base/options.html" class="external-link">options()</a></code> you can set in the <code>AMR</code> package.</p>
<p>This is an overview of all the package-specific options you can set in the <code>AMR</code> package. Set them using the <code><a href="https://rdrr.io/r/base/options.html" class="external-link">options()</a></code> function, e.g.:</p>
<p><code>options(AMR_guideline = "CLSI")</code></p>
</div>
<div class="section level2">
<h2 id="options">Options<a class="anchor" aria-label="anchor" href="#options"></a></h2>
<h2 id="options-alphabetical-order-">Options (alphabetical order)<a class="anchor" aria-label="anchor" href="#options-alphabetical-order-"></a></h2>
<ul><li><p><code>AMR_antibiogram_formatting_type</code> <br> A <a href="https://rdrr.io/r/base/numeric.html" class="external-link">numeric</a> (1-22) to use in <code><a href="antibiogram.html">antibiogram()</a></code>, to indicate which formatting type to use.</p></li>
@@ -65,6 +68,11 @@
<li><p><code>AMR_custom_ab</code> <br> A file location to an RDS file, to use custom antimicrobial drugs with this package. This is explained in <code><a href="add_custom_antimicrobials.html">add_custom_antimicrobials()</a></code>.</p></li>
<li><p><code>AMR_custom_mo</code> <br> A file location to an RDS file, to use custom microorganisms with this package. This is explained in <code><a href="add_custom_microorganisms.html">add_custom_microorganisms()</a></code>.</p></li>
<li><p><code>AMR_eucastrules</code> <br> A <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a> to set the default types of rules for <code><a href="interpretive_rules.html">eucast_rules()</a></code> function, must be one or more of: <code>"breakpoints"</code>, <code>"expert"</code>, <code>"other"</code>, <code>"custom"</code>, <code>"all"</code>, and defaults to <code>c("breakpoints", "expert")</code>.</p></li>
<li><p><code>AMR_guideline</code> <br> A <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a> to set the default guideline used throughout the <code>AMR</code> package wherever a <code>guideline</code> argument is available. This option is used as the default in e.g. <code><a href="as.sir.html">as.sir()</a></code>, <code><a href="proportion.html">resistance()</a></code>, <code><a href="proportion.html">susceptibility()</a></code>, <code><a href="interpretive_rules.html">interpretive_rules()</a></code> and many plotting functions. <strong>While unset</strong>, the AMR package uses the latest implemented EUCAST guideline (currently EUCAST 2025).</p><ul><li><p>For <code><a href="as.sir.html">as.sir()</a></code>, this determines which clinical breakpoint guideline is used to interpret MIC values and disk diffusion diameters. It can be either the guideline name (e.g., <code>"CLSI"</code> or <code>"EUCAST"</code>) or the name including a year (e.g., <code>"CLSI 2019"</code>). Supported guidelines are EUCAST 2011 to 2025, and CLSI 2011 to 2025.</p></li>
<li><p>For <code><a href="proportion.html">resistance()</a></code> and <code><a href="proportion.html">susceptibility()</a></code>, this setting determines how the <code>"I"</code> (Intermediate / Increased exposure) category is handled in calculations. Under CLSI, <code>"I"</code> is considered <em>resistant</em> in susceptibility calculations; under EUCAST, <code>"I"</code> is considered <em>susceptible</em> in susceptibility calculations. Explicitly setting this option ensures reproducible AMR proportion estimates.</p></li>
<li><p>For <code><a href="interpretive_rules.html">interpretive_rules()</a></code>, this determines which guideline-specific interpretive (expert) rules are applied to antimicrobial test results, either EUCAST or CLSI.</p></li>
<li><p>For many plotting functions (e.g., for MIC or disk diffusion values), supplying <code>mo</code> and <code>ab</code> enables automatic SIR-based interpretative colouring. These colours are derived from <code><a href="as.sir.html">as.sir()</a></code> in the background and therefore depend on the active <code>guideline</code> setting, which again uses EUCAST 2025 if not set explicitly.</p></li>
</ul></li>
<li><p><code>AMR_guideline</code> <br> A <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a> to set the default guideline for interpreting MIC values and disk diffusion diameters with <code><a href="as.sir.html">as.sir()</a></code>. Can be only the guideline name (e.g., <code>"CLSI"</code>) or the name with a year (e.g. <code>"CLSI 2019"</code>). The default to the latest implemented EUCAST guideline, currently <code>"EUCAST 2025"</code>. Supported guideline are currently EUCAST (2011-2025) and CLSI (2011-2025).</p></li>
<li><p><code>AMR_ignore_pattern</code> <br> A <a href="https://rdrr.io/r/base/regex.html" class="external-link">regular expression</a> to ignore (i.e., make <code>NA</code>) any match given in <code><a href="as.mo.html">as.mo()</a></code> and all <code><a href="mo_property.html">mo_*</a></code> functions.</p></li>
<li><p><code>AMR_include_PKPD</code> <br> A <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to use in <code><a href="as.sir.html">as.sir()</a></code>, to indicate that PK/PD clinical breakpoints must be applied as a last resort - the default is <code>TRUE</code>.</p></li>
@@ -87,7 +95,7 @@
<h3 id="share-options-within-team">Share Options Within Team<a class="anchor" aria-label="anchor" href="#share-options-within-team"></a></h3>
<p>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, and have each user read in this file automatically at start-up. This would work in this way:</p><ol><li><p>Save a plain text file to e.g. "X:/team_folder/R_options.R" and fill it with preferred settings.</p></li>
<p>For a more collaborative approach, e.g. within a (data) team, save an options file to a remote file location, such as a shared network drive, and have each user read in this file automatically at start-up. This would work in this way:</p><ol><li><p>Save a plain text file to e.g. "X:/team_folder/R_options.R" and fill it with preferred settings.</p></li>
<li><p>For each user, open the <code>.Rprofile</code> file using <code>utils::file.edit("~/.Rprofile")</code> and put in there:</p>
<p></p><div class="sourceCode r"><pre><code><span> <span class="kw"><a href="https://rdrr.io/r/base/source.html" class="external-link">source</a></span><span class="op">(</span><span class="st">"X:/team_folder/R_options.R"</span><span class="op">)</span></span></code></pre><p></p></div></li>
<li><p>Reload R/RStudio and check the settings with <code><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption()</a></code>, e.g. <code>getOption("AMR_locale")</code> if you have set that value.</p></li>