From e9c6e5e2e96f8bc187f3e1be6f7ea8c814a73dc5 Mon Sep 17 00:00:00 2001
From: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 26 Apr 2025 14:42:58 +0000
Subject: [PATCH] Built site for AMR@2.1.1.9255: d166aa2

---
 404.html                                 |   2 +-
 LICENSE-text.html                        |   2 +-
 articles/AMR.html                        |   8 +-
 articles/AMR_for_Python.html             |   2 +-
 articles/AMR_with_tidymodels.html        |   2 +-
 articles/EUCAST.html                     |   2 +-
 articles/MDR.html                        |   2 +-
 articles/PCA.html                        |   2 +-
 articles/WHONET.html                     |   2 +-
 articles/datasets.html                   |  10 +-
 articles/index.html                      |   2 +-
 articles/welcome_to_AMR.html             |   2 +-
 authors.html                             |   2 +-
 index.html                               |   4 +-
 news/index.html                          |  16 +-
 pkgdown.yml                              |   2 +-
 reference/AMR-deprecated.html            |   2 +-
 reference/AMR-options.html               |   2 +-
 reference/AMR.html                       |   2 +-
 reference/WHOCC.html                     |   2 +-
 reference/WHONET.html                    |   2 +-
 reference/ab_from_text.html              |   2 +-
 reference/ab_property.html               |   2 +-
 reference/add_custom_antimicrobials.html |   4 +-
 reference/add_custom_microorganisms.html |   2 +-
 reference/age.html                       |   2 +-
 reference/age_groups.html                |   2 +-
 reference/antibiogram.html               |   2 +-
 reference/antimicrobial_selectors.html   |   2 +-
 reference/antimicrobials.html            |   2 +-
 reference/as.ab.html                     |   4 +-
 reference/as.av.html                     |   2 +-
 reference/as.disk.html                   |  27 +-
 reference/as.mic-2.png                   | Bin 0 -> 34759 bytes
 reference/as.mic-3.png                   | Bin 0 -> 52488 bytes
 reference/as.mic-4.png                   | Bin 0 -> 50804 bytes
 reference/as.mic.html                    |  24 +-
 reference/as.mo.html                     |   2 +-
 reference/as.sir.html                    | 348 ++++++-----------------
 reference/atc_online.html                |   2 +-
 reference/av_from_text.html              |   2 +-
 reference/av_property.html               |   2 +-
 reference/availability.html              |   2 +-
 reference/bug_drug_combinations.html     |   2 +-
 reference/clinical_breakpoints.html      |   2 +-
 reference/count.html                     |   2 +-
 reference/custom_eucast_rules.html       |   2 +-
 reference/dosage.html                    |   2 +-
 reference/eucast_rules.html              |   2 +-
 reference/example_isolates.html          |   2 +-
 reference/example_isolates_unclean.html  |   2 +-
 reference/export_ncbi_biosample.html     |   2 +-
 reference/first_isolate.html             |   2 +-
 reference/g.test.html                    |   2 +-
 reference/get_episode.html               |   2 +-
 reference/ggplot_pca.html                |   2 +-
 reference/ggplot_sir.html                |   2 +-
 reference/guess_ab_col.html              |   2 +-
 reference/index.html                     |   2 +-
 reference/intrinsic_resistant.html       |   2 +-
 reference/italicise_taxonomy.html        |   2 +-
 reference/join.html                      |   2 +-
 reference/key_antimicrobials.html        |   2 +-
 reference/kurtosis.html                  |   2 +-
 reference/like.html                      |   2 +-
 reference/mdro.html                      |   2 +-
 reference/mean_amr_distance.html         |   2 +-
 reference/microorganisms.codes.html      |   2 +-
 reference/microorganisms.groups.html     |   2 +-
 reference/microorganisms.html            |   2 +-
 reference/mo_matching_score.html         |   2 +-
 reference/mo_property.html               |   2 +-
 reference/mo_source.html                 |   2 +-
 reference/pca.html                       |   2 +-
 reference/plot-10.png                    | Bin 72304 -> 62433 bytes
 reference/plot-11.png                    | Bin 94847 -> 19275 bytes
 reference/plot-12.png                    | Bin 90342 -> 72304 bytes
 reference/plot-13.png                    | Bin 26557 -> 94847 bytes
 reference/plot-14.png                    | Bin 26524 -> 90342 bytes
 reference/plot-15.png                    | Bin 27742 -> 26557 bytes
 reference/plot-16.png                    | Bin 0 -> 40375 bytes
 reference/plot-17.png                    | Bin 0 -> 26524 bytes
 reference/plot-18.png                    | Bin 0 -> 40357 bytes
 reference/plot-19.png                    | Bin 0 -> 39510 bytes
 reference/plot-2.png                     | Bin 24961 -> 59121 bytes
 reference/plot-20.png                    | Bin 0 -> 27742 bytes
 reference/plot-3.png                     | Bin 27928 -> 54904 bytes
 reference/plot-4.png                     | Bin 30774 -> 24961 bytes
 reference/plot-5.png                     | Bin 27160 -> 27928 bytes
 reference/plot-6.png                     | Bin 33179 -> 30774 bytes
 reference/plot-7.png                     | Bin 80570 -> 27160 bytes
 reference/plot-8.png                     | Bin 62433 -> 33179 bytes
 reference/plot-9.png                     | Bin 19275 -> 80570 bytes
 reference/plot.html                      |  47 ++-
 reference/proportion.html                |   2 +-
 reference/random.html                    |   2 +-
 reference/resistance_predict.html        |   2 +-
 reference/skewness.html                  |   2 +-
 reference/top_n_microorganisms.html      |   2 +-
 reference/translate.html                 |   2 +-
 search.json                              |   2 +-
 101 files changed, 199 insertions(+), 431 deletions(-)
 create mode 100644 reference/as.mic-2.png
 create mode 100644 reference/as.mic-3.png
 create mode 100644 reference/as.mic-4.png
 create mode 100644 reference/plot-16.png
 create mode 100644 reference/plot-17.png
 create mode 100644 reference/plot-18.png
 create mode 100644 reference/plot-19.png
 create mode 100644 reference/plot-20.png

diff --git a/404.html b/404.html
index c35767cbc..9c4740478 100644
--- a/404.html
+++ b/404.html
@@ -32,7 +32,7 @@
 
     <a class="navbar-brand me-2" href="https://amr-for-r.org/index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/LICENSE-text.html b/LICENSE-text.html
index 736205375..88d5f859b 100644
--- a/LICENSE-text.html
+++ b/LICENSE-text.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/AMR.html b/articles/AMR.html
index 6270ebd6d..732ca22d4 100644
--- a/articles/AMR.html
+++ b/articles/AMR.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -1308,12 +1308,6 @@ values for <em>Klebsiella pneumoniae</em> and ciprofloxacin:</p>
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/base/Random.html" class="external-link">set.seed</a></span><span class="op">(</span><span class="fl">123</span><span class="op">)</span></span>
 <span><span class="va">mic_values</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/random.html">random_mic</a></span><span class="op">(</span><span class="fl">100</span><span class="op">)</span></span>
 <span><span class="va">sir_values</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/as.sir.html">as.sir</a></span><span class="op">(</span><span class="va">mic_values</span>, mo <span class="op">=</span> <span class="st">"K. pneumoniae"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span>, guideline <span class="op">=</span> <span class="st">"EUCAST 2024"</span><span class="op">)</span></span>
-<span><span class="co">#&gt; </span></span>
-<span><span class="co">#&gt; <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span></span>
-<span><span class="co"><span style="color: #00BB00;">#&gt;   all the details of the breakpoint interpretations.</span></span></span>
-<span><span class="co">#&gt; </span></span>
-<span><span class="co">#&gt; <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2024</span><span style="color: #0000BB;">...</span><span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span></span>
-<span><span class="co">#&gt; <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Klebsiella pneumoniae</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span></span>
 <span></span>
 <span><span class="va">my_data</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://tibble.tidyverse.org/reference/tibble.html" class="external-link">tibble</a></span><span class="op">(</span>MIC <span class="op">=</span> <span class="va">mic_values</span>, SIR <span class="op">=</span> <span class="va">sir_values</span><span class="op">)</span></span>
 <span><span class="va">my_data</span></span>
diff --git a/articles/AMR_for_Python.html b/articles/AMR_for_Python.html
index 9017c5ae7..605915f50 100644
--- a/articles/AMR_for_Python.html
+++ b/articles/AMR_for_Python.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/AMR_with_tidymodels.html b/articles/AMR_with_tidymodels.html
index fd703a5b1..935c3ac58 100644
--- a/articles/AMR_with_tidymodels.html
+++ b/articles/AMR_with_tidymodels.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/EUCAST.html b/articles/EUCAST.html
index 23c9926ce..ded798274 100644
--- a/articles/EUCAST.html
+++ b/articles/EUCAST.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/MDR.html b/articles/MDR.html
index 65882cd08..2dcb639d4 100644
--- a/articles/MDR.html
+++ b/articles/MDR.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/PCA.html b/articles/PCA.html
index 42984956a..e087d425a 100644
--- a/articles/PCA.html
+++ b/articles/PCA.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/WHONET.html b/articles/WHONET.html
index d2630370c..f2a59e314 100644
--- a/articles/WHONET.html
+++ b/articles/WHONET.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/datasets.html b/articles/datasets.html
index 23c19ccaa..902edfa5b 100644
--- a/articles/datasets.html
+++ b/articles/datasets.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -425,13 +425,13 @@ column names:<br><em>ab</em>, <em>cid</em>, <em>name</em>, <em>group</em>, <em>a
 <em>iv_ddd</em>, <em>iv_units</em>, and <em>loinc</em>.</p>
 <p>This data set is in R available as <code>antimicrobials</code>, after
 you load the <code>AMR</code> package.</p>
-<p>It was last updated on 20 April 2025 10:55:31 UTC. Find more info
+<p>It was last updated on 26 April 2025 14:23:14 UTC. Find more info
 about the contents, (scientific) source, and structure of this <a href="https://amr-for-r.org/reference/antimicrobials.html">data set
 here</a>.</p>
 <p><strong>Direct download links:</strong></p>
 <ul>
 <li>Download as <a href="https://github.com/msberends/AMR/raw/main/data-raw/datasets/antimicrobials.rds" class="external-link">original
-R Data Structure (RDS) file</a> (44 kB)<br>
+R Data Structure (RDS) file</a> (43 kB)<br>
 </li>
 <li>Download as <a href="https://github.com/msberends/AMR/raw/main/data-raw/datasets/antimicrobials.txt" class="external-link">tab-separated
 text file</a> (0.1 MB)<br>
@@ -498,7 +498,7 @@ as comma separated values.</p>
 <td align="center">Aminoglycoside antibacterials</td>
 <td align="center">Other aminoglycosides</td>
 <td align="center">ak, ami, amik, …</td>
-<td align="center">amicacin, amikacillin, amikacina, …</td>
+<td align="center">amikacillin, amikacina, amikacine, …</td>
 <td align="center"></td>
 <td align="center"></td>
 <td align="center">1.0</td>
@@ -547,7 +547,7 @@ inhibitors</td>
 <td align="center">Beta-lactam antibacterials, penicillins</td>
 <td align="center">Penicillins with extended spectrum</td>
 <td align="center">am, amp, ampi</td>
-<td align="center">acillin, adobacillin, alpen, …</td>
+<td align="center">adobacillin, alpen, amblosin, …</td>
 <td align="center">2.0</td>
 <td align="center">g</td>
 <td align="center">6.0</td>
diff --git a/articles/index.html b/articles/index.html
index 1c4b9620c..51d2c3958 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/articles/welcome_to_AMR.html b/articles/welcome_to_AMR.html
index 6a315ea9e..1b1bab716 100644
--- a/articles/welcome_to_AMR.html
+++ b/articles/welcome_to_AMR.html
@@ -31,7 +31,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/authors.html b/authors.html
index 400356a31..98e9ecfab 100644
--- a/authors.html
+++ b/authors.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/index.html b/index.html
index 8966d76d4..cb3d5713d 100644
--- a/index.html
+++ b/index.html
@@ -34,7 +34,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -502,7 +502,7 @@
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/utils/install.packages.html" class="external-link">install.packages</a></span><span class="op">(</span><span class="st">"AMR"</span>, repos <span class="op">=</span> <span class="st">"beta.amr-for-r.org"</span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># if this does not work, try to install directly from GitHub using the 'remotes' package:</span></span>
-<span><span class="fu">remotes</span><span class="fu">::</span><span class="fu">install_github</span><span class="op">(</span><span class="st">"msberends/AMR"</span><span class="op">)</span></span></code></pre></div>
+<span><span class="fu">remotes</span><span class="fu">::</span><span class="fu"><a href="https://remotes.r-lib.org/reference/install_github.html" class="external-link">install_github</a></span><span class="op">(</span><span class="st">"msberends/AMR"</span><span class="op">)</span></span></code></pre></div>
 </div>
 </div>
 <div class="section level3">
diff --git a/news/index.html b/news/index.html
index 9e45dd15d..0d32fbe56 100644
--- a/news/index.html
+++ b/news/index.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -49,20 +49,20 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="2.1.1.9253" id="amr-2119253">AMR 2.1.1.9253<a class="anchor" aria-label="anchor" href="#amr-2119253"></a></h2>
+<h2 class="pkg-version" data-toc-text="2.1.1.9255" id="amr-2119255">AMR 2.1.1.9255<a class="anchor" aria-label="anchor" href="#amr-2119255"></a></h2>
 <p><em>(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 <a href="https://amr-for-r.org/#get-this-package">the instructions here</a>.)</em></p>
 <div class="section level5">
-<h5 id="a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9253">A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)<a class="anchor" aria-label="anchor" href="#a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9253"></a></h5>
+<h5 id="a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9255">A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)<a class="anchor" aria-label="anchor" href="#a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9255"></a></h5>
 <p>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 <a href="https://www.upei.ca/avc" class="external-link">University of Prince Edward Island’s Atlantic Veterinary College</a>, Canada. To celebrate this great improvement of the package, we also updated the package logo to reflect this change.</p>
 </div>
 <div class="section level3">
-<h3 id="breaking-2-1-1-9253">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9253"></a></h3>
+<h3 id="breaking-2-1-1-9255">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9255"></a></h3>
 <ul><li>Dataset <code>antibiotics</code> has been renamed to <code>antimicrobials</code> as the data set contains more than just antibiotics. Using <code>antibiotics</code> will still work, but now returns a warning.</li>
 <li>Removed all functions and references that used the deprecated <code>rsi</code> class, which were all replaced with their <code>sir</code> equivalents over two years ago.</li>
 <li>Functions <code><a href="../reference/resistance_predict.html">resistance_predict()</a></code> and <code><a href="../reference/resistance_predict.html">sir_predict()</a></code> is now deprecated and will be removed in a future version. Use the <code>tidymodels</code> framework instead, for which we <a href="https://amr-for-r.org/articles/AMR_with_tidymodels.html">wrote a basic introduction</a>.</li>
 </ul></div>
 <div class="section level3">
-<h3 id="new-2-1-1-9253">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9253"></a></h3>
+<h3 id="new-2-1-1-9255">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9255"></a></h3>
 <ul><li>
 <strong>One Health implementation</strong>
 <ul><li>Function <code><a href="../reference/as.sir.html">as.sir()</a></code> now has extensive support for veterinary breakpoints from CLSI. Use <code>breakpoint_type = "animal"</code> and set the <code>host</code> argument to a variable that contains animal species names.</li>
@@ -117,7 +117,7 @@
 </ul></li>
 </ul></div>
 <div class="section level3">
-<h3 id="changed-2-1-1-9253">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9253"></a></h3>
+<h3 id="changed-2-1-1-9255">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9255"></a></h3>
 <ul><li>SIR interpretation
 <ul><li>Support for parallel computing using the <code>parallel</code> package (part of base R). Use <code>as.sir(your_data, parallel = TRUE)</code> to run SIR interpretation using multiple cores.</li>
 <li>It is now possible to use column names for arguments <code>guideline</code>, <code>ab</code>, <code>mo</code>, and <code>uti</code>: <code>as.sir(..., ab = "column1", mo = "column2", uti = "column3")</code>. This greatly improves the flexibility for users.</li>
@@ -199,7 +199,7 @@
 <li>Added console colours support of <code>sir</code> class for Positron</li>
 </ul></div>
 <div class="section level3">
-<h3 id="other-2-1-1-9253">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9253"></a></h3>
+<h3 id="other-2-1-1-9255">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9255"></a></h3>
 <ul><li>New website domain: <a href="https://amr-for-r.org" class="uri">https://amr-for-r.org</a>! The old domain (<a href="http://amr-for-r.org" class="external-link uri">http://amr-for-r.org</a>) will remain to work.</li>
 <li>Added Dr. Larisse Bolton and Aislinn Cook as contributors for their fantastic implementation of WISCA in a mathematically solid way</li>
 <li>Added Matthew Saab, Dr. Jordan Stull, and Prof. Javier Sanchez as contributors for their tremendous input on veterinary breakpoints and interpretations</li>
@@ -209,7 +209,7 @@
 <li>Stopped support for SAS (<code>.xpt</code>) files, since their file structure and extremely inefficient and requires more disk space than GitHub allows in a single commit.</li>
 </ul></div>
 <div class="section level3">
-<h3 id="older-versions-2-1-1-9253">Older Versions<a class="anchor" aria-label="anchor" href="#older-versions-2-1-1-9253"></a></h3>
+<h3 id="older-versions-2-1-1-9255">Older Versions<a class="anchor" aria-label="anchor" href="#older-versions-2-1-1-9255"></a></h3>
 <p>This changelog only contains changes from AMR v3.0 (March 2025) and later.</p>
 <ul><li>For prior v2 versions, please see <a href="https://github.com/msberends/AMR/blob/v2.1.1/NEWS.md" class="external-link">our v2 archive</a>.</li>
 <li>For prior v1 versions, please see <a href="https://github.com/msberends/AMR/blob/v1.8.2/NEWS.md" class="external-link">our v1 archive</a>.</li>
diff --git a/pkgdown.yml b/pkgdown.yml
index 8f100e68e..bae7837d0 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-04-26T13:52Z
+last_built: 2025-04-26T14:39Z
 urls:
   reference: https://amr-for-r.org/reference
   article: https://amr-for-r.org/articles
diff --git a/reference/AMR-deprecated.html b/reference/AMR-deprecated.html
index b4aabf35a..38fd82a50 100644
--- a/reference/AMR-deprecated.html
+++ b/reference/AMR-deprecated.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/AMR-options.html b/reference/AMR-options.html
index db7326648..c517cf123 100644
--- a/reference/AMR-options.html
+++ b/reference/AMR-options.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/AMR.html b/reference/AMR.html
index f60632b1b..b225951b2 100644
--- a/reference/AMR.html
+++ b/reference/AMR.html
@@ -21,7 +21,7 @@ The AMR package is available in English, Chinese, Czech, Danish, Dutch, Finnish,
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/WHOCC.html b/reference/WHOCC.html
index b1115cbd0..26d140a5c 100644
--- a/reference/WHOCC.html
+++ b/reference/WHOCC.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/WHONET.html b/reference/WHONET.html
index 7547d7fc6..47e8b25c1 100644
--- a/reference/WHONET.html
+++ b/reference/WHONET.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/ab_from_text.html b/reference/ab_from_text.html
index 710e41f3c..a7b281793 100644
--- a/reference/ab_from_text.html
+++ b/reference/ab_from_text.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/ab_property.html b/reference/ab_property.html
index 4c3291562..0866c53a8 100644
--- a/reference/ab_property.html
+++ b/reference/ab_property.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/add_custom_antimicrobials.html b/reference/add_custom_antimicrobials.html
index cec8bc019..09daa43dd 100644
--- a/reference/add_custom_antimicrobials.html
+++ b/reference/add_custom_antimicrobials.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -98,7 +98,7 @@
 <span class="r-in"><span><span class="co"># returns a wildly guessed result:</span></span></span>
 <span class="r-in"><span><span class="fu"><a href="as.ab.html">as.ab</a></span><span class="op">(</span><span class="st">"testab"</span><span class="op">)</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'ab'</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] CTE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] THA</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># now add a custom entry - it will be considered by as.ab() and</span></span></span>
 <span class="r-in"><span><span class="co"># all ab_*() functions</span></span></span>
diff --git a/reference/add_custom_microorganisms.html b/reference/add_custom_microorganisms.html
index 0c65b10ee..0fe998233 100644
--- a/reference/add_custom_microorganisms.html
+++ b/reference/add_custom_microorganisms.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/age.html b/reference/age.html
index 10e789d81..4f2c342c7 100644
--- a/reference/age.html
+++ b/reference/age.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/age_groups.html b/reference/age_groups.html
index b9703a1d2..cdbdffdde 100644
--- a/reference/age_groups.html
+++ b/reference/age_groups.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/antibiogram.html b/reference/antibiogram.html
index e01db053b..f8ca46d62 100644
--- a/reference/antibiogram.html
+++ b/reference/antibiogram.html
@@ -9,7 +9,7 @@ Adhering to previously described approaches (see Source) and especially the Baye
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/antimicrobial_selectors.html b/reference/antimicrobial_selectors.html
index 61f864db3..683a2b1fd 100644
--- a/reference/antimicrobial_selectors.html
+++ b/reference/antimicrobial_selectors.html
@@ -17,7 +17,7 @@ my_data_with_all_these_columns %&amp;gt;%
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/antimicrobials.html b/reference/antimicrobials.html
index ef4a14d00..90b28720f 100644
--- a/reference/antimicrobials.html
+++ b/reference/antimicrobials.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/as.ab.html b/reference/as.ab.html
index 3ad45dde8..51ee3f058 100644
--- a/reference/as.ab.html
+++ b/reference/as.ab.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -163,7 +163,7 @@
 <span class="r-out co"><span class="r-pr">#&gt;</span> [1] ERY</span>
 <span class="r-in"><span><span class="fu">as.ab</span><span class="op">(</span><span class="st">"Romycin"</span><span class="op">)</span> <span class="co"># trade name</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'ab'</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] ERY</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] AST</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># spelling from different languages and dyslexia are no problem</span></span></span>
 <span class="r-in"><span><span class="fu"><a href="ab_property.html">ab_atc</a></span><span class="op">(</span><span class="st">"ceftriaxon"</span><span class="op">)</span></span></span>
diff --git a/reference/as.av.html b/reference/as.av.html
index 821129577..f086341c5 100644
--- a/reference/as.av.html
+++ b/reference/as.av.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/as.disk.html b/reference/as.disk.html
index b7ac26845..fe7712095 100644
--- a/reference/as.disk.html
+++ b/reference/as.disk.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -128,36 +128,11 @@
 <span class="r-in"><span>  ab <span class="op">=</span> <span class="st">"ampicillin"</span>, <span class="co"># and `ab` with as.ab()</span></span></span>
 <span class="r-in"><span>  guideline <span class="op">=</span> <span class="st">"EUCAST"</span></span></span>
 <span class="r-in"><span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Returning previously coerced values for various antimicrobials. Run</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  </span><span style="color: #0000BB; background-color: #EEEEEE;">ab_reset_session()</span><span style="color: #0000BB;"> to reset this. This note will be shown once per</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  session.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">ampicillin</span><span style="color: #0000BB;">' (AMP), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> [1] R</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># interpret whole data set, pretend to be all from urinary tract infections:</span></span></span>
 <span class="r-in"><span><span class="fu"><a href="as.sir.html">as.sir</a></span><span class="op">(</span><span class="va">df</span>, uti <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">AMP</span><span style="color: #0000BB;">' (ampicillin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">CIP</span><span style="color: #0000BB;">' (ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">GEN</span><span style="color: #0000BB;">' (gentamicin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">TOB</span><span style="color: #0000BB;">' (tobramycin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism AMP  CIP GEN TOB</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli   S &lt;NA&gt;   S   S</span>
 </code></pre></div>
diff --git a/reference/as.mic-2.png b/reference/as.mic-2.png
new file mode 100644
index 0000000000000000000000000000000000000000..c7957bd01f42e7d84f080a2caef2983e14260fbc
GIT binary patch
literal 34759
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

literal 0
HcmV?d00001

diff --git a/reference/as.mic-3.png b/reference/as.mic-3.png
new file mode 100644
index 0000000000000000000000000000000000000000..cdd8a30c628989b234006ad6e2091c79da624d44
GIT binary patch
literal 52488
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%0A5R-Ko4R#
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

literal 0
HcmV?d00001

diff --git a/reference/as.mic-4.png b/reference/as.mic-4.png
new file mode 100644
index 0000000000000000000000000000000000000000..675168e806c1990aa57c85af3deb82c6fc1e6ab2
GIT binary patch
literal 50804
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

literal 0
HcmV?d00001

diff --git a/reference/as.mic.html b/reference/as.mic.html
index 352856095..add1352b6 100644
--- a/reference/as.mic.html
+++ b/reference/as.mic.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -183,39 +183,31 @@
 <span class="r-in"><span>  ab <span class="op">=</span> <span class="st">"AMX"</span>,</span></span>
 <span class="r-in"><span>  guideline <span class="op">=</span> <span class="st">"EUCAST"</span></span></span>
 <span class="r-in"><span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">AMX</span><span style="color: #0000BB;">' (amoxicillin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 5 of item 2 does not match with column 5 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] R</span>
 <span class="r-in"><span><span class="fu"><a href="as.sir.html">as.sir</a></span><span class="op">(</span></span></span>
 <span class="r-in"><span>  x <span class="op">=</span> <span class="fu">as.mic</span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="fl">0.01</span>, <span class="fl">2</span>, <span class="fl">4</span>, <span class="fl">8</span><span class="op">)</span><span class="op">)</span>,</span></span>
 <span class="r-in"><span>  mo <span class="op">=</span> <span class="fu"><a href="as.mo.html">as.mo</a></span><span class="op">(</span><span class="st">"Streptococcus pneumoniae"</span><span class="op">)</span>,</span></span>
 <span class="r-in"><span>  ab <span class="op">=</span> <span class="st">"AMX"</span>,</span></span>
 <span class="r-in"><span>  guideline <span class="op">=</span> <span class="st">"EUCAST"</span></span></span>
 <span class="r-in"><span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">AMX</span><span style="color: #0000BB;">' (amoxicillin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 5 of item 2 does not match with column 5 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] S R R R</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># plot MIC values, see ?plot</span></span></span>
 <span class="r-in"><span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">mic_data</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="as.mic-1.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="as.mic-2.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="as.mic-3.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span>, language <span class="op">=</span> <span class="st">"nl"</span><span class="op">)</span> <span class="co"># Dutch</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="as.mic-4.png" alt="" width="700" height="433"></span>
 </code></pre></div>
     </div>
   </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
diff --git a/reference/as.mo.html b/reference/as.mo.html
index b7e6c72b9..de25e2780 100644
--- a/reference/as.mo.html
+++ b/reference/as.mo.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/as.sir.html b/reference/as.sir.html
index a6cdc866a..75d0c3e7b 100644
--- a/reference/as.sir.html
+++ b/reference/as.sir.html
@@ -9,7 +9,7 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -68,7 +68,7 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span></span>
 <span><span class="co"># Default S3 method</span></span>
 <span><span class="fu">as.sir</span><span class="op">(</span><span class="va">x</span>, S <span class="op">=</span> <span class="st">"^(S|U)+$"</span>, I <span class="op">=</span> <span class="st">"^(I)+$"</span>, R <span class="op">=</span> <span class="st">"^(R)+$"</span>,</span>
-<span>  NI <span class="op">=</span> <span class="st">"^(N|NI|V)+$"</span>, SDD <span class="op">=</span> <span class="st">"^(SDD|D|H)+$"</span>, info <span class="op">=</span> <span class="cn">TRUE</span>, <span class="va">...</span><span class="op">)</span></span>
+<span>  NI <span class="op">=</span> <span class="st">"^(N|NI|V)+$"</span>, SDD <span class="op">=</span> <span class="st">"^(SDD|D|H)+$"</span>, info <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/interactive.html" class="external-link">interactive</a></span><span class="op">(</span><span class="op">)</span>, <span class="va">...</span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># S3 method for class 'mic'</span></span>
 <span><span class="fu">as.sir</span><span class="op">(</span><span class="va">x</span>, mo <span class="op">=</span> <span class="cn">NULL</span>, ab <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/deparse.html" class="external-link">deparse</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/substitute.html" class="external-link">substitute</a></span><span class="op">(</span><span class="va">x</span><span class="op">)</span><span class="op">)</span>,</span>
@@ -80,7 +80,8 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span>  <span class="cn">FALSE</span><span class="op">)</span>, include_screening <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_include_screening"</span>, <span class="cn">FALSE</span><span class="op">)</span>,</span>
 <span>  include_PKPD <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_include_PKPD"</span>, <span class="cn">TRUE</span><span class="op">)</span>,</span>
 <span>  breakpoint_type <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_breakpoint_type"</span>, <span class="st">"human"</span><span class="op">)</span>, host <span class="op">=</span> <span class="cn">NULL</span>,</span>
-<span>  verbose <span class="op">=</span> <span class="cn">FALSE</span>, info <span class="op">=</span> <span class="cn">TRUE</span>, conserve_capped_values <span class="op">=</span> <span class="cn">NULL</span>, <span class="va">...</span><span class="op">)</span></span>
+<span>  verbose <span class="op">=</span> <span class="cn">FALSE</span>, info <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/interactive.html" class="external-link">interactive</a></span><span class="op">(</span><span class="op">)</span>, conserve_capped_values <span class="op">=</span> <span class="cn">NULL</span>,</span>
+<span>  <span class="va">...</span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># S3 method for class 'disk'</span></span>
 <span><span class="fu">as.sir</span><span class="op">(</span><span class="va">x</span>, mo <span class="op">=</span> <span class="cn">NULL</span>, ab <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/deparse.html" class="external-link">deparse</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/substitute.html" class="external-link">substitute</a></span><span class="op">(</span><span class="va">x</span><span class="op">)</span><span class="op">)</span>,</span>
@@ -91,7 +92,7 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span>  <span class="cn">FALSE</span><span class="op">)</span>, include_screening <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_include_screening"</span>, <span class="cn">FALSE</span><span class="op">)</span>,</span>
 <span>  include_PKPD <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_include_PKPD"</span>, <span class="cn">TRUE</span><span class="op">)</span>,</span>
 <span>  breakpoint_type <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_breakpoint_type"</span>, <span class="st">"human"</span><span class="op">)</span>, host <span class="op">=</span> <span class="cn">NULL</span>,</span>
-<span>  verbose <span class="op">=</span> <span class="cn">FALSE</span>, info <span class="op">=</span> <span class="cn">TRUE</span>, <span class="va">...</span><span class="op">)</span></span>
+<span>  verbose <span class="op">=</span> <span class="cn">FALSE</span>, info <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/interactive.html" class="external-link">interactive</a></span><span class="op">(</span><span class="op">)</span>, <span class="va">...</span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># S3 method for class 'data.frame'</span></span>
 <span><span class="fu">as.sir</span><span class="op">(</span><span class="va">x</span>, <span class="va">...</span>, col_mo <span class="op">=</span> <span class="cn">NULL</span>,</span>
@@ -103,8 +104,8 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span>  <span class="cn">FALSE</span><span class="op">)</span>, include_screening <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_include_screening"</span>, <span class="cn">FALSE</span><span class="op">)</span>,</span>
 <span>  include_PKPD <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_include_PKPD"</span>, <span class="cn">TRUE</span><span class="op">)</span>,</span>
 <span>  breakpoint_type <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption</a></span><span class="op">(</span><span class="st">"AMR_breakpoint_type"</span>, <span class="st">"human"</span><span class="op">)</span>, host <span class="op">=</span> <span class="cn">NULL</span>,</span>
-<span>  verbose <span class="op">=</span> <span class="cn">FALSE</span>, info <span class="op">=</span> <span class="cn">TRUE</span>, parallel <span class="op">=</span> <span class="cn">FALSE</span>, max_cores <span class="op">=</span> <span class="op">-</span><span class="fl">1</span>,</span>
-<span>  conserve_capped_values <span class="op">=</span> <span class="cn">NULL</span><span class="op">)</span></span>
+<span>  verbose <span class="op">=</span> <span class="cn">FALSE</span>, info <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/interactive.html" class="external-link">interactive</a></span><span class="op">(</span><span class="op">)</span>, parallel <span class="op">=</span> <span class="cn">FALSE</span>,</span>
+<span>  max_cores <span class="op">=</span> <span class="op">-</span><span class="fl">1</span>, conserve_capped_values <span class="op">=</span> <span class="cn">NULL</span><span class="op">)</span></span>
 <span></span>
 <span><span class="fu">sir_interpretation_history</span><span class="op">(</span>clean <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span></span></code></pre></div>
     </div>
@@ -138,7 +139,7 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 
 
 <dt id="arg-info">info<a class="anchor" aria-label="anchor" href="#arg-info"></a></dt>
-<dd><p>A <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to print information about the process.</p></dd>
+<dd><p>A <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to print information about the process, defaults to <code>TRUE</code> only in <a href="https://rdrr.io/r/base/interactive.html" class="external-link">interactive sessions</a>.</p></dd>
 
 
 <dt id="arg-mo">mo<a class="anchor" aria-label="anchor" href="#arg-mo"></a></dt>
@@ -287,13 +288,7 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <p>When using veterinary breakpoints (i.e., setting <code>breakpoint_type = "animal"</code>), a column with animal species must be available or set manually using the <code>host</code> argument. The column must contain names like "dogs", "cats", "cattle", "swine", "horses", "poultry", or "aquatic". Other animal names like "goats", "rabbits", or "monkeys" are also recognised but may not be available in all guidelines. Matching is case-insensitive and accepts Latin-based synonyms (e.g., "bovine" for cattle and "canine" for dogs).</p>
 <p>Regarding choice of veterinary guidelines, these might be the best options to set before analysis:</p>
 <p></p><div class="sourceCode"><pre><code><span id="cb1-1"><a href="#cb1-1" tabindex="-1"></a>  <span class="fu">options</span>(<span class="at">AMR_guideline =</span> <span class="st">"CLSI"</span>)</span>
-<span id="cb1-2"><a href="#cb1-2" tabindex="-1"></a>  <span class="fu">options</span>(<span class="at">AMR_breakpoint_type =</span> <span class="st">"animal"</span>)</span></code></pre><p></p></div><div class="section">
-<h4 id="todo-when-applying-veterinary-breakpoints-by-setting-host-or-by-setting-breakpoint-type-animal-the-clsi-vet-guideline-will-be-applied-to-cope-with-missing-animal-species-specific-breakpoints-">TODO #187 When applying veterinary breakpoints (by setting <code>host</code> or by setting <code>breakpoint_type = "animal"</code>), the <a href="https://clsi.org/standards/products/veterinary-medicine/documents/vet09/" class="external-link">CLSI VET09 guideline</a> will be applied to cope with missing animal species-specific breakpoints.<a class="anchor" aria-label="anchor" href="#todo-when-applying-veterinary-breakpoints-by-setting-host-or-by-setting-breakpoint-type-animal-the-clsi-vet-guideline-will-be-applied-to-cope-with-missing-animal-species-specific-breakpoints-"></a></h4>
-
-
-</div>
-
-
+<span id="cb1-2"><a href="#cb1-2" tabindex="-1"></a>  <span class="fu">options</span>(<span class="at">AMR_breakpoint_type =</span> <span class="st">"animal"</span>)</span></code></pre><p></p></div>
 </div>
 
 <div class="section">
@@ -484,7 +479,51 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-in"><span>  guideline <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">"EUCAST 2021"</span>, <span class="st">"EUCAST 2022"</span>, <span class="st">"EUCAST 2023"</span>, <span class="st">"EUCAST 2024"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">)</span></span></span>
 <span class="r-in"><span></span></span>
+<span class="r-in"><span><span class="co"># most basic application:</span></span></span>
+<span class="r-in"><span><span class="fu">as.sir</span><span class="op">(</span><span class="va">df_wide</span><span class="op">)</span></span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism amoxicillin cipro tobra genta ERY</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli           S     I     S     S   R</span>
+<span class="r-in"><span></span></span>
+<span class="r-in"><span><span class="co"># return a 'logbook' about the results:</span></span></span>
+<span class="r-in"><span><span class="fu">sir_interpretation_history</span><span class="op">(</span><span class="op">)</span></span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 14 × 18</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>    datetime            index method ab_given    mo_given  host_given input_given</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;dttm&gt;</span>              <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>     <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> 2025-04-26 <span style="color: #949494;">14:39:45</span>     1 DISK   ampicillin  Strep pn… human      18         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 2</span> 2025-04-26 <span style="color: #949494;">14:39:45</span>     1 DISK   AMP         Escheric… human      20         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> <span style="color: #BB0000;">NA</span>                     <span style="color: #BB0000;">NA</span> <span style="color: #BB0000;">NA</span>     <span style="color: #BB0000;">NA</span>          <span style="color: #BB0000;">NA</span>        <span style="color: #BB0000;">NA</span>         <span style="color: #BB0000;">NA</span>         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> 2025-04-26 <span style="color: #949494;">14:39:46</span>     1 DISK   GEN         Escheric… human      18         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> 2025-04-26 <span style="color: #949494;">14:39:46</span>     1 DISK   TOB         Escheric… human      16         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     1 MIC    AMX         B_STRPT_… human      2          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     1 MIC    AMX         B_STRPT_… human      0.01       </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     2 MIC    AMX         B_STRPT_… human      2          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     3 MIC    AMX         B_STRPT_… human      4          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     4 MIC    AMX         B_STRPT_… human      8          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">11</span> 2025-04-26 <span style="color: #949494;">14:39:53</span>     1 MIC    amoxicillin Escheric… human      8          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">12</span> 2025-04-26 <span style="color: #949494;">14:39:53</span>     1 MIC    cipro       Escheric… human      0.256      </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">13</span> 2025-04-26 <span style="color: #949494;">14:39:53</span>     1 DISK   tobra       Escheric… human      16         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">14</span> 2025-04-26 <span style="color: #949494;">14:39:54</span>     1 DISK   genta       Escheric… human      18         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 11 more variables: ab &lt;ab&gt;, mo &lt;mo&gt;, host &lt;chr&gt;, input &lt;chr&gt;,</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   outcome &lt;sir&gt;, notes &lt;chr&gt;, guideline &lt;chr&gt;, ref_table &lt;chr&gt;, uti &lt;lgl&gt;,</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   breakpoint_S_R &lt;chr&gt;, site &lt;chr&gt;</span></span>
+<span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># \donttest{</span></span></span>
+<span class="r-in"><span><span class="co"># using parallel computing, which is available in base R:</span></span></span>
+<span class="r-in"><span><span class="fu">as.sir</span><span class="op">(</span><span class="va">df_wide</span>, parallel <span class="op">=</span> <span class="cn">TRUE</span>, info <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Returning previously coerced values for various antimicrobials. Run</span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  </span><span style="color: #0000BB; background-color: #EEEEEE;">ab_reset_session()</span><span style="color: #0000BB;"> to reset this. This note will be shown once per</span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  session.</span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">Running SIR interpretation in parallel mode on five columns, using 3 out of</span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">4 cores...</span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;"> Done.</span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> to retrieve a logbook with all the</span></span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  details of the breakpoint interpretations.</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism amoxicillin cipro tobra genta ERY</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli           S     I     S     S   R</span>
+<span class="r-in"><span></span></span>
+<span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co">## Using dplyr -------------------------------------------------</span></span></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># approaches that all work without additional arguments:</span></span></span>
@@ -589,239 +628,46 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-in"><span>  <span class="va">df_wide</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://dplyr.tidyverse.org/reference/mutate_all.html" class="external-link">mutate_at</a></span><span class="op">(</span><span class="fu"><a href="https://dplyr.tidyverse.org/reference/vars.html" class="external-link">vars</a></span><span class="op">(</span><span class="va">cipro</span><span class="op">:</span><span class="va">genta</span><span class="op">)</span>, <span class="va">as.sir</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, uti <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for amoxicillin (AMX) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Intravenous'. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for amoxicillin (AMX) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Intravenous'. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin) based on</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">column '</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for tobramycin (TOB) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming an unspecified body site. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin) based on</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">column '</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for gentamicin (GEN) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming an unspecified body site. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for amoxicillin (AMX) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Intravenous'. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for amoxicillin (AMX) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Intravenous'. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin) based on</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">column '</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for tobramycin (TOB) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming an unspecified body site. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for amoxicillin (AMX) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Intravenous'. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin) based on</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">column '</span><span style="color: #0000BB; font-weight: bold;">microorganism</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for tobramycin (TOB) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming an unspecified body site. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX), '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin),</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), and '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">bacteria</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2021</span><span style="color: #0000BB;">, </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2022</span><span style="color: #0000BB;">, </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2023</span><span style="color: #0000BB;">, and </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2024</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • There were multiple notes. Print or View </span><span style="color: #080808; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #080808;"> to examine them, or use </span><span style="color: #080808; background-color: #EEEEEE;">as.sir(..., verbose = TRUE)</span><span style="color: #080808;"> next time to directly print them here.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX), '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin),</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), and '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">bacteria</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There was 1 warning in `mutate()`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> In argument: `across(...)`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> Caused by warning:</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> Some MICs were converted to the nearest higher log2 level, following the</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> CLSI interpretation guideline.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There was 1 warning in `mutate()`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> In argument: `cipro = (function (x, ...) ...`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> Caused by warning:</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> Some MICs were converted to the nearest higher log2 level, following the</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> CLSI interpretation guideline.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There was 1 warning in `mutate()`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> In argument: `across(...)`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> Caused by warning:</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> Some MICs were converted to the nearest higher log2 level, following the</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> CLSI interpretation guideline.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Assuming </span><span style="color: #0000BB; background-color: #EEEEEE;">breakpoint_type = "animal"</span><span style="color: #0000BB;">, since </span><span style="color: #0000BB; background-color: #EEEEEE;">host</span><span style="color: #0000BB;"> is set.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX), '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin),</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), and '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">bacteria</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There was 1 warning in `mutate()`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> In argument: `mics = (function (x, ...) ...`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> Caused by warning:</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> Some MICs were converted to the nearest higher log2 level, following the</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> CLSI interpretation guideline.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Assuming </span><span style="color: #0000BB; background-color: #EEEEEE;">breakpoint_type = "animal"</span><span style="color: #0000BB;">, since </span><span style="color: #0000BB; background-color: #EEEEEE;">host</span><span style="color: #0000BB;"> is set.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX), '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin),</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), and '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin) based on column</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">'</span><span style="color: #0000BB; font-weight: bold;">bacteria</span><span style="color: #0000BB;">', </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There was 1 warning in `mutate()`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> In argument: `across(...)`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> Caused by warning:</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> Some MICs were converted to the nearest higher log2 level, following the</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> CLSI interpretation guideline.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Assuming </span><span style="color: #0000BB; background-color: #EEEEEE;">breakpoint_type = "animal"</span><span style="color: #0000BB;">, since </span><span style="color: #0000BB; background-color: #EEEEEE;">host</span><span style="color: #0000BB;"> is set.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">antibiotic</span><span style="color: #0000BB;">' (ASP, acetylspiramycin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFAFAF;"> WARNING </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • No MIC breakpoints available for acetylspiramycin (ASP).</span></span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">antibiotic</span><span style="color: #0000BB;">' (ASP, acetylspiramycin),</span></span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFAFAF;"> WARNING </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • No DISK breakpoints available for acetylspiramycin (ASP).</span></span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">antibiotic</span><span style="color: #0000BB;">' (ASP, acetylspiramycin),</span></span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFAFAF;"> WARNING </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • No DISK breakpoints available for acetylspiramycin (ASP).</span></span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There were 2 warnings in `mutate()`.</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> The first warning was:</span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There was 1 warning in `mutate()`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> In argument: `cipro = (function (x, ...) ...`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> Caused by warning:</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> The following animal host(s) could not be coerced: "animal_species"</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> Run `dplyr::last_dplyr_warnings()` to see the 1 remaining warning.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Assuming </span><span style="color: #0000BB; background-color: #EEEEEE;">breakpoint_type = "animal"</span><span style="color: #0000BB;">, since </span><span style="color: #0000BB; background-color: #EEEEEE;">host</span><span style="color: #0000BB;"> is set.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin), </span><span style="color: #0000BB; font-weight: bold;">CLSI 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There were 2 warnings in `mutate()`.</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> The first warning was:</span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> Some MICs were converted to the nearest higher log2 level, following the</span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> CLSI interpretation guideline.</span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>There was 1 warning in `mutate()`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> In argument: `across(...)`.</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> Caused by warning:</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> The following animal host(s) could not be coerced: "animal_species"</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #00BBBB;">ℹ</span> Run `dplyr::last_dplyr_warnings()` to see the 1 remaining warning.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Returning previously coerced values for "E. coli". Run</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  </span><span style="color: #0000BB; background-color: #EEEEEE;">mo_reset_session()</span><span style="color: #0000BB;"> to reset this. This note will be shown once per</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  session for this input.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">nitrofuratoin</span><span style="color: #0000BB;">' (NIT,</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">nitrofurantoin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Assuming value "urine" in column '</span><span style="color: #0000BB; font-weight: bold;">specimen</span><span style="color: #0000BB;">' reflects a urinary tract</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  infection.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">  Use </span><span style="color: #0000BB; background-color: #EEEEEE;">as.sir(uti = FALSE)</span><span style="color: #0000BB;"> to prevent this.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">nitrofuratoin</span><span style="color: #0000BB;">' (NIT,</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">nitrofurantoin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span style="color: #BBBB00;">!</span> Some MICs were converted to the nearest higher log2 level, following the</span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> CLSI interpretation guideline.</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism amoxicillin cipro tobra genta ERY</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli           8  &lt;NA&gt;     S     S   R</span>
 <span class="r-in"><span></span></span>
@@ -829,52 +675,33 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-in"><span><span class="co">## Using base R ------------------------------------------------</span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">as.sir</span><span class="op">(</span><span class="va">df_wide</span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">ℹ Running SIR interpretation in sequential mode. Consider setting </span><span style="color: #BB0000; background-color: #EEEEEE;">parallel</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000; background-color: #EEEEEE;">  = TRUE</span><span style="color: #BB0000;"> to speed up processing on multiple cores.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: column '</span><span style="color: #0000BB; font-weight: bold;">amoxicillin</span><span style="color: #0000BB;">' (AMX), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for amoxicillin (AMX) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Intravenous'. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: column '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">tobra</span><span style="color: #0000BB;">' (TOB, tobramycin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for tobramycin (TOB) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming an unspecified body site. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: column '</span><span style="color: #0000BB; font-weight: bold;">genta</span><span style="color: #0000BB;">' (GEN, gentamicin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB; font-weight: bold;">2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Breakpoints for UTI </span><span style="color: #080808; font-weight: bold;">and</span><span style="color: #080808;"> non-UTI available for gentamicin (GEN) in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming an unspecified body site. Use argument </span><span style="color: #080808; background-color: #EEEEEE;">uti</span><span style="color: #080808;"> to set which isolates are from urine. See </span><span style="color: #080808; background-color: #EEEEEE;">?as.sir</span><span style="color: #080808;">.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Assigning class 'sir' to already clean column '</span><span style="color: #0000BB; font-weight: bold;">ERY</span><span style="color: #0000BB;">' (erythromycin)...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism amoxicillin cipro tobra genta ERY</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli           S     I     S     S   R</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># return a 'logbook' about the results:</span></span></span>
 <span class="r-in"><span><span class="fu">sir_interpretation_history</span><span class="op">(</span><span class="op">)</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 54 × 18</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>    datetime            index method ab_given    mo_given  host_given input_given</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;dttm&gt;</span>              <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>     <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> 2025-04-26 <span style="color: #949494;">13:53:13</span>     1 MIC    amoxicillin Escheric… human      8          </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 2</span> 2025-04-26 <span style="color: #949494;">13:53:14</span>     1 MIC    cipro       Escheric… human      0.256      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> 2025-04-26 <span style="color: #949494;">13:53:14</span>     1 MIC    amoxicillin Escheric… human      8          </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> 2025-04-26 <span style="color: #949494;">13:53:14</span>     1 MIC    cipro       Escheric… human      0.256      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> 2025-04-26 <span style="color: #949494;">13:53:14</span>     1 DISK   tobra       Escheric… human      16         </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> 2025-04-26 <span style="color: #949494;">13:53:15</span>     1 DISK   genta       Escheric… human      18         </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> 2025-04-26 <span style="color: #949494;">13:53:15</span>     1 MIC    amoxicillin Escheric… human      8          </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> 2025-04-26 <span style="color: #949494;">13:53:15</span>     1 MIC    cipro       Escheric… human      0.256      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> 2025-04-26 <span style="color: #949494;">13:53:15</span>     1 MIC    amoxicillin Escheric… human      8          </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> 2025-04-26 <span style="color: #949494;">13:53:16</span>     1 MIC    cipro       Escheric… human      0.256      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 44 more rows</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 114 × 18</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>    datetime            index method ab_given   mo_given   host_given input_given</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;dttm&gt;</span>              <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> 2025-04-26 <span style="color: #949494;">14:39:45</span>     1 DISK   ampicillin Strep pneu human      18         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 2</span> 2025-04-26 <span style="color: #949494;">14:39:45</span>     1 DISK   AMP        Escherich… human      20         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> <span style="color: #BB0000;">NA</span>                     <span style="color: #BB0000;">NA</span> <span style="color: #BB0000;">NA</span>     <span style="color: #BB0000;">NA</span>         <span style="color: #BB0000;">NA</span>         <span style="color: #BB0000;">NA</span>         <span style="color: #BB0000;">NA</span>         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> 2025-04-26 <span style="color: #949494;">14:39:46</span>     1 DISK   GEN        Escherich… human      18         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> 2025-04-26 <span style="color: #949494;">14:39:46</span>     1 DISK   TOB        Escherich… human      16         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     1 MIC    AMX        B_STRPT_P… human      2          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     1 MIC    AMX        B_STRPT_P… human      0.01       </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     2 MIC    AMX        B_STRPT_P… human      2          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     3 MIC    AMX        B_STRPT_P… human      4          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> 2025-04-26 <span style="color: #949494;">14:39:47</span>     4 MIC    AMX        B_STRPT_P… human      8          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 104 more rows</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 11 more variables: ab &lt;ab&gt;, mo &lt;mo&gt;, host &lt;chr&gt;, input &lt;chr&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   outcome &lt;sir&gt;, notes &lt;chr&gt;, guideline &lt;chr&gt;, ref_table &lt;chr&gt;, uti &lt;lgl&gt;,</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   breakpoint_S_R &lt;chr&gt;, site &lt;lgl&gt;</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   breakpoint_S_R &lt;chr&gt;, site &lt;chr&gt;</span></span>
+<span class="r-in"><span></span></span>
+<span class="r-in"><span><span class="co"># using parallel computing, which is available in base R</span></span></span>
+<span class="r-in"><span><span class="fu">as.sir</span><span class="op">(</span><span class="va">df_wide</span>, parallel <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism amoxicillin cipro tobra genta ERY</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli           S     I     S     S   R</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># for single values</span></span></span>
 <span class="r-in"><span><span class="fu">as.sir</span><span class="op">(</span></span></span>
@@ -883,12 +710,8 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-in"><span>  ab <span class="op">=</span> <span class="st">"AMP"</span>,</span></span>
 <span class="r-in"><span>  guideline <span class="op">=</span> <span class="st">"EUCAST"</span></span></span>
 <span class="r-in"><span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">AMP</span><span style="color: #0000BB;">' (ampicillin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 5 of item 2 does not match with column 5 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] R</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">as.sir</span><span class="op">(</span></span></span>
 <span class="r-in"><span>  x <span class="op">=</span> <span class="fu"><a href="as.disk.html">as.disk</a></span><span class="op">(</span><span class="fl">18</span><span class="op">)</span>,</span></span>
@@ -896,12 +719,6 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-in"><span>  ab <span class="op">=</span> <span class="st">"ampicillin"</span>, <span class="co"># and `ab` with as.ab()</span></span></span>
 <span class="r-in"><span>  guideline <span class="op">=</span> <span class="st">"EUCAST"</span></span></span>
 <span class="r-in"><span><span class="op">)</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting disk diffusion zones: '</span><span style="color: #0000BB; font-weight: bold;">ampicillin</span><span style="color: #0000BB;">' (AMP), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #5FD7AF;"> OK </span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> [1] R</span>
 <span class="r-in"><span></span></span>
@@ -943,9 +760,6 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-in"><span>  <span class="co"># example_isolates %&gt;%</span></span></span>
 <span class="r-in"><span>  <span class="co">#   mutate(across(where(is_sir_eligible), as.sir))</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000;">ℹ Running SIR interpretation in sequential mode. Consider setting </span><span style="color: #BB0000; background-color: #EEEEEE;">parallel</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #BB0000; background-color: #EEEEEE;">  = TRUE</span><span style="color: #BB0000;"> to speed up processing on multiple cores.</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 2,000 × 46</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX  </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;date&gt;</span>     <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;mo&gt;</span>         <span style="color: #949494; font-style: italic;">&lt;sir&gt;</span> <span style="color: #949494; font-style: italic;">&lt;sir&gt;</span> <span style="color: #949494; font-style: italic;">&lt;sir&gt;</span> <span style="color: #949494; font-style: italic;">&lt;sir&gt;</span></span>
diff --git a/reference/atc_online.html b/reference/atc_online.html
index 7aa8c8da5..caafb37c6 100644
--- a/reference/atc_online.html
+++ b/reference/atc_online.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/av_from_text.html b/reference/av_from_text.html
index e7228e2e1..55cae5d5d 100644
--- a/reference/av_from_text.html
+++ b/reference/av_from_text.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/av_property.html b/reference/av_property.html
index b23857e9f..21ede0450 100644
--- a/reference/av_property.html
+++ b/reference/av_property.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/availability.html b/reference/availability.html
index f68bb773b..5f6d303fb 100644
--- a/reference/availability.html
+++ b/reference/availability.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/bug_drug_combinations.html b/reference/bug_drug_combinations.html
index ff9aee740..44c33b465 100644
--- a/reference/bug_drug_combinations.html
+++ b/reference/bug_drug_combinations.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/clinical_breakpoints.html b/reference/clinical_breakpoints.html
index 40bb633dd..85274cef0 100644
--- a/reference/clinical_breakpoints.html
+++ b/reference/clinical_breakpoints.html
@@ -21,7 +21,7 @@ Use as.sir() to transform MICs or disks measurements to SIR values."><meta prope
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/count.html b/reference/count.html
index b0b51741c..4650587cd 100644
--- a/reference/count.html
+++ b/reference/count.html
@@ -9,7 +9,7 @@ count_resistant() should be used to count resistant isolates, count_susceptible(
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/custom_eucast_rules.html b/reference/custom_eucast_rules.html
index a6577eaee..47adbde9c 100644
--- a/reference/custom_eucast_rules.html
+++ b/reference/custom_eucast_rules.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/dosage.html b/reference/dosage.html
index 18e7205b4..5ec169b8a 100644
--- a/reference/dosage.html
+++ b/reference/dosage.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/eucast_rules.html b/reference/eucast_rules.html
index 002b6a3af..b4e60cfe4 100644
--- a/reference/eucast_rules.html
+++ b/reference/eucast_rules.html
@@ -9,7 +9,7 @@ To improve the interpretation of the antibiogram before EUCAST rules are applied
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/example_isolates.html b/reference/example_isolates.html
index 61561b239..d5cb526ea 100644
--- a/reference/example_isolates.html
+++ b/reference/example_isolates.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/example_isolates_unclean.html b/reference/example_isolates_unclean.html
index 8aea89478..bf5b752f8 100644
--- a/reference/example_isolates_unclean.html
+++ b/reference/example_isolates_unclean.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/export_ncbi_biosample.html b/reference/export_ncbi_biosample.html
index 29b492c2f..7c67cfbce 100644
--- a/reference/export_ncbi_biosample.html
+++ b/reference/export_ncbi_biosample.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/first_isolate.html b/reference/first_isolate.html
index 95965941a..e2e67b5d6 100644
--- a/reference/first_isolate.html
+++ b/reference/first_isolate.html
@@ -9,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/g.test.html b/reference/g.test.html
index 5d7a53eec..c5c4aab45 100644
--- a/reference/g.test.html
+++ b/reference/g.test.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/get_episode.html b/reference/get_episode.html
index 0adf03f8e..a082fdbc2 100644
--- a/reference/get_episode.html
+++ b/reference/get_episode.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/ggplot_pca.html b/reference/ggplot_pca.html
index 4d1f72f94..b6dcae44e 100644
--- a/reference/ggplot_pca.html
+++ b/reference/ggplot_pca.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/ggplot_sir.html b/reference/ggplot_sir.html
index eb9a65b54..720ded60c 100644
--- a/reference/ggplot_sir.html
+++ b/reference/ggplot_sir.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/guess_ab_col.html b/reference/guess_ab_col.html
index 8c87828c4..8200adf56 100644
--- a/reference/guess_ab_col.html
+++ b/reference/guess_ab_col.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/index.html b/reference/index.html
index dd4257071..5d263100a 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/intrinsic_resistant.html b/reference/intrinsic_resistant.html
index 5a8467444..edb9809f0 100644
--- a/reference/intrinsic_resistant.html
+++ b/reference/intrinsic_resistant.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/italicise_taxonomy.html b/reference/italicise_taxonomy.html
index d4f6aa59a..bf22b4241 100644
--- a/reference/italicise_taxonomy.html
+++ b/reference/italicise_taxonomy.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/join.html b/reference/join.html
index 51aebe167..7c67512b1 100644
--- a/reference/join.html
+++ b/reference/join.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/key_antimicrobials.html b/reference/key_antimicrobials.html
index ef807996b..5231c5f74 100644
--- a/reference/key_antimicrobials.html
+++ b/reference/key_antimicrobials.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/kurtosis.html b/reference/kurtosis.html
index 2123fa326..bdcd25268 100644
--- a/reference/kurtosis.html
+++ b/reference/kurtosis.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/like.html b/reference/like.html
index 806374638..eeef8a96b 100644
--- a/reference/like.html
+++ b/reference/like.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/mdro.html b/reference/mdro.html
index a44e4a856..30b608647 100644
--- a/reference/mdro.html
+++ b/reference/mdro.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/mean_amr_distance.html b/reference/mean_amr_distance.html
index 51c8ae705..b12fb2621 100644
--- a/reference/mean_amr_distance.html
+++ b/reference/mean_amr_distance.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/microorganisms.codes.html b/reference/microorganisms.codes.html
index 099dd917d..9d157eda4 100644
--- a/reference/microorganisms.codes.html
+++ b/reference/microorganisms.codes.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/microorganisms.groups.html b/reference/microorganisms.groups.html
index a458a6609..7b7ae0d96 100644
--- a/reference/microorganisms.groups.html
+++ b/reference/microorganisms.groups.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/microorganisms.html b/reference/microorganisms.html
index f696eb240..4d424ce5d 100644
--- a/reference/microorganisms.html
+++ b/reference/microorganisms.html
@@ -9,7 +9,7 @@ This data set is carefully crafted, yet made 100% reproducible from public and a
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/mo_matching_score.html b/reference/mo_matching_score.html
index cb9dd848b..e7ecc6801 100644
--- a/reference/mo_matching_score.html
+++ b/reference/mo_matching_score.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/mo_property.html b/reference/mo_property.html
index 0d786498c..48b7d317d 100644
--- a/reference/mo_property.html
+++ b/reference/mo_property.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/mo_source.html b/reference/mo_source.html
index f7f0b8a42..4440700ab 100644
--- a/reference/mo_source.html
+++ b/reference/mo_source.html
@@ -9,7 +9,7 @@ This is the fastest way to have your organisation (or analysis) specific codes p
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/pca.html b/reference/pca.html
index 741da4060..5fd93af53 100644
--- a/reference/pca.html
+++ b/reference/pca.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/plot-10.png b/reference/plot-10.png
index b47e1b208cec7783eeb17672933807868060cee7..5d8578536e38c7a86a9b1c4cf92f7d1a351724fb 100644
GIT binary patch
literal 62433
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

literal 72304
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
GzWi@wA<HlT

diff --git a/reference/plot-11.png b/reference/plot-11.png
index d2070ec20e1295e2c425f3d5d50fd07d85342ada..8251241adcd1249d50abb1ce7f87d3da78eaac65 100644
GIT binary patch
literal 19275
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
Z^!+t=CrKKsg4RF&l-V~0f4g++e*hdCLm2=7

literal 94847
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

diff --git a/reference/plot-12.png b/reference/plot-12.png
index 9bf911bf836c92e71de05a283bddb9b46a5af782..b47e1b208cec7783eeb17672933807868060cee7 100644
GIT binary patch
literal 72304
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
GzWi@wA<HlT

literal 90342
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%0DlRdb_XD?{pi=FxqzL*rShfB
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
Nl~<7~eqs{%KLDVc2!a3r

diff --git a/reference/plot-13.png b/reference/plot-13.png
index 72f8665c3bd1c42a7bd3da32467877a098032cbf..d2070ec20e1295e2c425f3d5d50fd07d85342ada 100644
GIT binary patch
literal 94847
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

literal 26557
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

diff --git a/reference/plot-14.png b/reference/plot-14.png
index fb72ef631bac21ec929f70094bd595edf1a682c4..9bf911bf836c92e71de05a283bddb9b46a5af782 100644
GIT binary patch
literal 90342
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%0DlRdb_XD?{pi=FxqzL*rShfB
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
Nl~<7~eqs{%KLDVc2!a3r

literal 26524
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
Y7f}CT5Vl6Q^b5duq2JaYIQi3m0#^86ng9R*

diff --git a/reference/plot-15.png b/reference/plot-15.png
index d0cc8ea45deb84a386fd4d7e9481aa8e2e4ccb4b..72f8665c3bd1c42a7bd3da32467877a098032cbf 100644
GIT binary patch
literal 26557
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

literal 27742
zcmeFZ2UJtp+c%m~N5)aGp(qNBdH_MBNCyEG5e|W%fPi!X>4NkULJ&t$s+`cPBE5H{
z!zeJJO7973q(d;22qAD!g7g0W?|tug*S%|f-}>&l>t!t`nRCwG`#H~k>hF1WUfo5h
zvi{EbI|6}V1=VhABM`rOBM|#7eme+X8IO6p0)HH|K&sw`KjFVk<ytKKap;NK12+VM
zD~R#$mxyoQA0ZHbAi&!<b-j}oC(%h(9vJ>@Eox^|6XM!Ur?i0J-?IVryOALW(k`Y&
z{=pgcF>LsynDuLb)64BU<>NXSXUpvoeY-CIm|ExW?Z4mpbpM9vfr}xBe-Syx9us2B
z@-#Bue@AApNN!SRM)y87C%15(N?VsJ+8o?8>8`5LI{KjsyRLAEN#TG0=YI_cn);~G
zz&ZKz9HG}P`<WpEzCHYwy&r)H5UaX|&t;pDPqy@CTz>S>ci<N$1;wH#>X=_F)dM*g
zU(7YYm3@pap#n!A>_-H&$TA--_G4Ve*{eV^z~&&(gQN@qwN>53RMG}O)S{5VLQPkb
zg>^c{)P@YSRTi!%0TEi)1`T)3Ameya-O!eJh_}+JCa>&uyb<nvw3Q}A=99gIx4}7P
z$E^ke&M3+iaENd7CWJ*%yuiW-x38lCA3JEKGF(B&ufSQ;6@;95H?^T!4wo>#BMS|-
z?N33|RMK;S<%)5r?ox|_WOpXCeJi+Vw*gG)-CF$)dLm0LAyu6Tk>Sku(v2~sanN5X
z&^yTPwG#5H=Pt|?M8`m$4xnUx`pNm;uaYS^(hJ3*dIdbv*O;~dN_ol%+pZVch2_)?
zDT8c@Rny&I;rxlOO2BAM+Zh`Lar~gk&{ZBAejkn0VcYgM%OOSSJG6?|vg5qf#TR3g
zX4hG%52?Z4QkiN8Hoi=rS|zJT-Vj17pWeX4fs`F!eC=4z=BZVY!g%rf-?^puHp_&E
z<?}2E844d0j_lajoxzGQc0p(iUAFS^p2(}vXi%~K<+_L(l{CP6%1s1SD%XOVG%fVF
z>rkJJo9O?V<eXVGBcZ{+`S-rYgGc#f(}Nr&>|Rq_Zk>4L;Z_Nv+q|+Yj~ybUtKIgj
zA=sef<fAV}j@#{E=S2O*4iVx3C6tTV@B`bxs`&&m*|lCoud_C-qwe9h5bG9M1*Rn6
z&SGK<uUHN5wM?DGI^#vjLiN)7T^_k7>S8l~*!mX@S6^vqo5GIR_!VWpx+(yf+eof>
zcss=|NId#PRlyx1bo9}=Y41{qKG^V__k>LLMuTj(8=7@!_cM(n2gn-Gg3fNoOBb~j
zwy!pJpQuU*QH%P;ZUo{C2RUB`YY6dYs^y}xMxNK|KxP`04R)T8<(5S4fmY*un+$Ym
zHtv}Y@Y%OQCwMDfYjIVMXRdFz1}Ms%rQLzD_#Z@nvD~DkXP+Iz4?~XQHjanIW@%|4
zOBPK*O7e|^SyWnjlV3j=zIcsVb*0-ZlEg2$x~yJOyCw^If;4o=MLe6pyoNrnT51eQ
z(&USMU*<3QvZ1LNE;YNb76m+7ZX0!-87-K*dZ7{>9MQmI+}kLn5}0KlG#(3GmsPoF
zE!R@m(r@3|1NdmSROEWDbaTg+7fL3lSue}ihNgnwn{xHbTeY&(zD($g`ws_?c-j^W
z+I9QP)jc(Tl)JE7So9u+JLqEubS+O^<>3KK^~b0KW9-Ba!|TVWx9E>lggn;&)aUa_
zw;+_9atqg_q^+5<rRQ>g50hL?AT-nXO};F8v5<@XV-8}Nk}r`aDCUMyUP#p~+0lSR
z(&Zjd%p9iak6Myy4v@nHJlDFY^$D`#py{WF-FXhJJf_FTjqIlf25&25TcAXEcFjU>
z5;^eZC+dnEMH~DVbx!IG?yqOdJJTq(o}so?g4Hy>-xz8u*GwY_i)|!MakcjJi7qo-
zQb4Qj(nUX2Xz6tIhUO`Up7d-tqemXWxAn7pBGOld>*3{*f`zMZ6J+)8ca9cVcfUI2
z=6_dgXFK?NnV!&;g5;yuRFyuzKq?RCOFOY#?iIZXw;!Rw-?4+{8b<oYmVEfPr`!@y
zD-Bu5P&%J?(0ZA~ER6?oMoiNCmjKY!u4OZV&*u-7Ti;f}p^P8iKe*?Xh{{G;KeGM!
zV|lA<t(QOKphg}?r%gXnYIxwXqblj9XzH?)CF$n5_{3>JH#S<P%DNzZ#N-FhDNK-i
ze67K=8j*vKF098Vt~CU&Vn;qtNaYkhqY)Dh@q?7rga&^H4UvKAgTtKDJ$>&dcVP}R
zUE3JbB|GNHaf6f`pr`PGS5d-dJ@A!aD8BoK?Q5Rr$`CJP_P{M{|CMQt;m)}=^URu}
z51H)p(F@_Z)f_{0MSMr*8{!7n*a*?|y6Rs>qy|ft#GDs91Y1ppzgA@8wzY##TsBj4
z^?}B5*Q2VbsQU$D@c`Di#Is-Cd-qKTdd`N0EQ;L|g-g@YWr!v~R(}1c$-Gq_!wwe-
zoKSL*3(d(@NMJuIIzL^R&`?8RTOF*g3X{Zm=_Qe=#6S<TpgH!6rwieN_vOzfUdyIg
z9CJcNcAn2j<&~{ZBi~;&_1aRop<RF2d&oW5%x_x)KL{$uTs*!x0o0~neyrW#r8kgY
zp&9FNRprC>1I{dXiwqElOcCbL^#qb^&W@U^bR$GcTHA2n^zR&4TX!o+9b6m4_-#i9
zuOhz@1IO9C=^4Ie?tL91M_zn>cWQ<hy)pc-4N$!wDxYP&GzXZe-}~#Wj=<}TTw#3D
z0KaKaMt@JA47>qN`-Gyg1N#vY-w5nSP2?`)?F8(nHoj&9JxN~6I|<)cl}ZWtWl4<3
zBaZ1jB>T}1m`e>i7Dv7`ocXgRdE~>|B%n0+#6JSidR$><Dn{+k*?shJTqnx&jI@!*
z9M+Y`ft6-sXAH}_`7Z!N<UAfhRp}$Wl}5p&)^oUR4``vbQ^Aw4uxli~@sis@wmg$O
z%{?u03g)PpR>=qF3#umj>g+TL95_cl{H{(fHPsNCqTOp&L6a8P+5P%Kl1@gIdIe7w
z_uCOKy(>f}0S*pZdc32J5fyjV%Sbycu!!-sb_=9%6X$+Ww(&ZHMYfE@4`4g}7T9@D
z$aRg!bvHgK^8MRz^26Kkf>+MN!Lmk!ojJJ$zB(;GA_hN7p|<KpAZwmdJ!zYfp-i{X
zbJ~kvmIkO_2e47Qhfb~5D13C(?5fLU;SyeRFkU}aRy5S<^H9?-nY%Pbs4F$&`2@`4
zm!r*x5kmT2nOisS=E*1JjeB_8YZ9@jb=6v>n60sD<h{Y+&s}r7H#Hm}KXaGQ5`{#X
z1vH5xb#QeTft2WAS+W*JATrs0OE`Z{K0UL@j+iI2o915VQY)u2`po}oODZqyAwn-O
zMP}PHIN7~kanUw4cvae6#_LX(Tw^k+lfCw&jgnx!1JnpcP8CpIaa$PMcdN~$ujT5Q
zRk7UT#d``U24l4#T*BdkzCXwzAaz$S39H_+Syq!@^){2dd1|Igi?S)aAT?JSyxK1S
zeJb;)(g%F>AS|+UcweD-K9dLpLR3mI(sS;a7M~9YDd;RZCDKQJ=mtkzXp|h}$?<n-
z*=jTr&mvl4x@ZRNyqr*)wasANf;NDw)S@{w2&zzMv+S>GC_ntUuT|ZB)*!-Haa&m%
zI7>!4Q`eN%iwSz5)csCk+!sYcrljWr(3n7~6drzDbNfTl+7ExULaw?5@L}@-=NkPe
zy!D^rMsK%TgpX_2yE)0>e`PiPI>wIA6GSRB!~Q;g_%_8M?hxVTBnK{ON)u8-Ih(!9
z<$AwbKz6C8d~Z%@$UIqh1)3PM@iPP0iL4%n2u%ME3)LNsR|gRRm0<#qZld6pbe39r
zO7%+zKXJU9&UNp{#$ABy1^lk`{EZjs;~23y#qkeuXvmoG)t3x@7p*i+jwkhOooO^k
zgz9P{zMCOkjpsYGbk7E*W_<JC-QNW9!{TyRMnr|Hi^t<EbrmSm{QfD+$+E*gfiw)A
zk0dq!`mt)jQJoSFXlYTBf9-7KYiVoFv#%CDRSzr5B0tzL`KZ$@oyu}hF^Lo};6K{i
zwFU57|G>96XLx6ieK2WFjv-|T?3fy4XKXW+BtWd#l@S0-%zEkgMWKm9-#Y;<^~g6P
zvMOEpQv!<ZewM-7hd6jQ%|Ives$p!!kiT~D$EBMBp3{noEp3I)T9NtH*IL@DiZn}%
zocp#@*~#cwc1gLTC|7fcuI*RPgNi&~b3x_e{J1~^pAwfv=!ZHHzCjjkfR?*PJ64Xy
z)&0>@PpJV^c}JC6x;GXeKUw@tA4(|P!m=HXX(RM`H`m!~4XTioX8;^<yC+~)M&9_x
zz{>T1^VhVZ5he%UzZ`G(qyXHhDl9sQK!DKPJ%&+$J<nfi|3vn%-u(C9|F<}B$H9K!
z7tzxx$)qYsL%Mj#6Wmazya1%7i@BMEN_MMX>tAshyGvvyZW?c*-?0UhJW+?7`5yE(
z8Mg7tUc|Gq=KsogxanAdR>?E3$?W}%X9HY@Z)@IXPIBkQe@XK8L?J+|0#=CP=Q#ik
z7!|>f0aU(fMSK`26(K6j7-{}0a>~RooDs61-DhjB;Ky-E3Ii`0w*q*PuU<6Q{()~P
zc-Nf+b|Ys<PSABJ`~wh$Ea_n8lmWkt$5~~1==x~db!s?t&w+$wQa{KYKaBl?_{vqj
zE<pHDbB~3Yb$-&UIzXNWj>fba$60mNiH!rYSrXRDPyx&F#bbN&dqX+O_DuadIFPp|
zMv_L@4-rd)p!2Du>7fNlknNnhJA<kwh__kZw=H%oEB$iYC;U5*aNid*(R7iyNNeB$
z@~lGDKtp!Nh;!5!ixdw7SwV=R0B==ivNo+-*pe(zL3LJSXIwT<Qd<cpC}(VB3R_B7
zg<Ey7lrXoTBNU#+M9;ox_L`^Q5_y#V>=0AY&Tw2&<!ZX-cB6741C7k7SB7dGri%nC
zumiex8S^!HLsMLZWY0MwKi<oJYj~sNG~=@9=O|kP!|<iPM&}%Q!OeqAN`)|<D{KUC
zP9bvVM(oZz<P!4qX*TB50)RIQ+4-FDLObB>SkXwFs$pDiIs?xwVs^gQLra4aWS5!V
z=2W2M<z#-9anoQ3@SbaV3+Klx3G$M4Ot})0KT)^#<uN$K&yXT)l!fZb`cEn9NH{?5
zE4hZ(g}OkgFqxQ5sjTWh7q!kAGT$;r;SiyBL=yiQ3<qJOhr#6wt`if#Jhg|dCJ*SO
zaZQ|bhRLSOqx^VT0jPq0ewbg@>cDrlzqZ)PcK;!p(hBp4m`FHAdPSrB+KDlQkdU9S
zrwJoJM_fHo_u+dmkSbKaV+tJwe6SGKA$dHC6eiFveLjw~1Qy0sb-xnuL};;IGhhrr
z{65a-BeCRqnBV=(Dx|&Z+_^A*1<xT~W%Yr~DmZfCZW@!MGv}Pu<;7@k6I`&yoYX(r
z=;W*G&gzje+^TzENYls<?fH{cWu8~VXd!HL9Z*;(OtxfHH0aKr`f#QlBu{Y}+7k`M
zm&3Jb6<k|3P+ivA)@;iGrv8O09U?Rv>DW6Lo|V?ICqEFI9@D1%{j2H$28kL6;G49E
zIrW*Yx}`M(4OteQA2K$&4~PH8xEuG|iMnTAJ~<fMZ`mZDjE$-*ts2o|R1ukrjJxI+
z;ry5opRvJ@a~yxzIRq-+_oY)$IYfIQcF8KOdyC65=D!2&+E!3CU|_}+vKj_z0iTD#
zV>McKVWV**tZx2#x;8B^b3b!HYe)M%mf|CD<b4V(w6FK~gLWT??^MCa%q;pr4t=mC
zh=DR9Ld6deKEId4UjVzcN-<sUr2*M@nY-;kk$pwuxP~p`5yYB>CM3;YeHs4@<c6~?
zNJ+hP^|!B_nd_i6lz-0S55_a1%Zsr1v*4137`_UDINhQ=#Qf44bwGsir72E3?WyTf
zg0=sJ;>@R#%zLxFIRf0FL!|HD-!?EsBkqRhN?!;ZQ3LqkgF|DAEy9HVk@cIo;J}>Y
z{{rFq$N2HW0SNpjnhD43j4%Hp1)5^==#0+)7$*ClItjxJi=O6AB&pa<bL^v4?yPk%
z2?)3#BaYYj&}Q>ulert_Cq|o*B8o9qme48Id=K+rlR72aJvB$Xu*C#()h*oNVoFq~
zyvN=D%`f%;g1z=IUTH3LK8d8sc>f+ddUfX03dWWoX1|beof3Y2)^X0v|L2S3f-P4v
zxMRcMz<L58qT%{@zXS7CMQ<<YEKZrg0V(5A^9i57IT>G?;{MBawkr?Cr2Mzn`~Qd6
z^I&W;qN(o!tQrJ}RBxAQy&4YtKZk$!fBm?{(UpX8>3{s64kL~djkcl!S2zt8v~&iJ
zE6U=x4h}KQOu(ZKHbS$!ES?MO)^y!{Y55>K9;lKkAKK4az%)Z0rY9xu=TP4QsamdP
zkT~u<yO|e*hBv>Q2>Y;p4s5`|_&8aEGSd5k`8>mj_If))jVM<eXcc!p(t3WJ>F7IN
z9w0yAf=E0w$!Hg-h`*X2p9+jxj@)F*^QX~P_M-xc0?FfIco1~DvK}4Lfvc0i>nVr1
z%M4|CNBpDgH>8tK)RkpwUw2<xbVsc@X;5OpjkD_MA1>@!xX`eg1J0x2pg;d$t#4!O
zmkW=_*@XH&zn*$d(1f!cfgSG6vfdZBlsz>lYQf|=k#HGCZ1RSsp3mC`e&8Emlj)Y`
z#fP^8*=(;f#+jIALf4h>K{(@NE9GF{e*N-px;j)4R7b!;eu6C`I?Gy=LH3H`EZ@+F
z9uCW`fa=C^+O6}r4X2%@gMI~Ii6Fiox9u5BUOgqiZM&%kgI2~#Bn5DTr`H#Z%ufYf
zO$Ppg1C9XRA|gz=B~-_YFPKZ3<$_&xM_WH`B5K}Dx09RWs7w7x`|0FJ0`!>2E=(z_
z?LCLR%9#8XQEAFS6S@Lp&+!Vv$kK(^!$`>Na+hr7j2FX>hJLhQ@C&*wud+`)FxF*d
zY%PU-fwy`5qp#NGu+6*BV{PDG#MNZ1L##|n<VN_I+3bbo7MTY2VW<5KL%<yW1$mqW
z%MX;YvGWjz;a6wa48yY)r%OgoT^+xGPsDA%f4lxdGti5|l~R4Es1{0!vzlRlm7l|2
zk)9f35wyksqMSgim^Mqf+98%SF^|5CZx7ytbMO&Ps*#C>Y5rWf*K(>n{0<3NHA*vV
z<4SFUZ|^K(N<E+~z{hNwpksFai*K1V_JJslG^<G9ftMGx(&YEHSvM4M&xxE$b~MTu
zX_i6vn8jPsc#8?{V@e@K%byw@<~Vz@4J@S&ZHt`U?jb(R@J^AQa=5B5(ms*ys8sPL
z(UAP2oGbuOXa0&)H_*!%TtQWOrDGbEqSC_Gv<;lw`s9+iUr64c$EpPFD5%rXS4Cg=
zCnb6cyv*fl0V5H_5xJcl_nlDz{~;%h?;f=m@TxkCu9*ef9nadr%<Cz1g-{wJ?1q6q
zLN(ycKdcMM_csuU6@Lzm7nFCWoU)WE-!da!2uB)X$R@Xs)EnYF^HZ0udFJ(vxalnF
z?$q{GquS61Ppo?j63yg8&FlH2TT>^R)?tka_{G~4dS=9Oq7JwCDn3zd@!L(E4~9i>
zWYx$<_mKBC8<fMk&3pAreS4`b#P5FA2(@AwMam!G_p*uLVEbd)Wi`LNky}61w%&E_
z^#bQhh7y`jF^Ig<hk7#k{^L+0iel?fpzk?LtadNhuRg<rOZ(WY0qy5Ft6a2`#@>Oe
z4ZR9)Lc}<(PN;>gFNYnR!{ChdINfxVOHz_NU%liDzr-1w*B%ViW_h0>Ub2gA_WttQ
zu)NX|xg+7%R>p#&5-|A-3U>UtsK?1h(Ijb{@$0k$f0=;78m{WWHI*NX$!-M|4Wn<#
zUVYWmON-$nS{@H-LH#UxgTB{Ud8KBwWiIZ|JZM6Xb9`xGFhr;HQJ{}l+i}*9x*Lgh
z{1NgdWC)1h`Rof)_%k*e2WE`nMFZaArjm`bGLo}>m4i)6q_Y&?dfDf8a7)w^6f<0Q
zc~xB91y!_NJiW;B$gfA8lWRrrl^LrMNEaSr6sZ|7)4Heru;xn*{c>!ucX817)suCT
zC;n{I;Y5E7eCKF1e~56>p>X|sC%qxuqCWk-m-VoB*S=|nX*?2rfJ~CRv~+t=9-2rX
zK)z;R<jDCon7GUYpP9@be`6rW<c<AhrrHVE+mI$)I&1&pu;!$1NFL*EjXhaM&Dg^9
z$Yo3He0&}xD>Z+jR9wLGOT)uI7kKdxGd8&c7)i^KkGjE=5n7L@erUjZIXD-eIGaHK
zdrKrsEe@5Trna0)LdGYaK@T1qN?Z>GZ1}2`R7y7z!SId=(rl2?f?tKZ)8jFDj8bA+
z>ympg%jNE&Ir@z*4|IvcoPzPdhaawi)GyqvWPQ%vm|t6E3Ny8%>b&itqmP#9l;z`v
zUN`IrsvO4{gxt_iRV(B9kOETha6J3s?e>%6cwjebtMpeMfv|c3qh-a%zV)VEd^dSC
zOLgY9Q!Bf7WtNf~%G!C#h)z$3HG^y3e@p&*GU{aA%!a5xvG2#Xn5krPK<8vw{Yb*c
z!zRwVeM$YN&ocPhardO;rFcJmpjxqIf6{66#JJ(=vi6Y+aI3&xFTm&LJ+HT)5EiQV
zM~%fB>N;GCfQYjzzV!x?7bBAZXH81KHZjo%yQ3L=+w_6#S@frUh4Kr%+O^~RhYXTn
z{I+;)Yw(g`k@3*iw<@jhf(X$k_A98uOV_H>Z;2ENca3737S_LT6;$inEQ>Vh#SAHw
zS}Z$;P2o;InS2nE(<~3is{C0$2ofIWdv9paWn`9$+Tt%6YOyjfs?(23jvm+-x9)s6
zPF(!sdd;Z95@&Xs&9c+y0^|~l;53n7Xt{LJ;s>0kd{oI77wQM~!sK467~JdSp7yPc
z9+Q?l#$-b13Dz4r%bFB&!A36o(Ia_fa`-a!B4@4@Uyn>Esn>qjr&8$XJ;F`n`<B#_
z0wwao*P7MGDEX55$5D1?%Jrkh^doHRG03Hbb9=VnO_Xh%V`I!lTUQT?{;XTkm=pc=
z^-!Lx@z~M3d1H~jMh=|<Tw8jvg&5t`;S{oRMn%fNqs45bL};0-?DKelCET{YC}vt{
z`WFm?Wy%+t<wx~0f5dG%{x$y>(4!%5S91}sC@_zU!95h=>GMr?OeHlB)y)iq(r!3(
zc8yZ{j}~1vLDLiqC-IRP6{e$)@(+-W`C*R$DMO3Umj!Ve@@Wp>0Bu`9TGq>S*GF=@
zls9wh(~0UO@_u}HR)t0+yl%j8Xe!xH3q?_z=Bt|z7dhfnzuE99!OJ(+MV@zbfRmQP
z&dbj5j!Or=W0zLPlB0OahpzI$2AcqNQ$J<~uZn}q8kEDzhRzN3$km-U!_tiYjt|9H
zNJ-PxC3tsq@{?RU3}i(O^>(26`JNphQ&#@$ob)mBsFSWA+~@3D|DeaYYy34qk$d+`
zf&*5(OX104-B3bA`p!d>6LoI)d9Cuodw545zFg??(zaVBU^?Ob40t*!fd4gTCzV(_
z9Mj$C_)_eeAtM}chd6j;ui~$Q+?uZX!3pmgaU06`I~4>yyWzp58S)zioZs~p<q0Xi
zY9YLH=4g-}cghAaqNm_2f3y6sJCw!egMk{66cKP4Rq}P?EijxuQbJD@P!~ReuHP&~
zey_Lv@(UyRD7LKys`=ec)~uSv7HC8!#e*f{J;H=<Hv>6p5>fJ-e%&uEABt`uX^mkb
zTrNWJh}SuQemY$#Z-#%gey~a``D7hP>0YZuhT-ABtlsC*7*=Un?u&sf!A8f=*%>UW
zZG=65`As&I{Bf82(?g;8$Q8wk0qWad+WzkQ10L}pazmIv4U;*YP+>W?yM*3+X~`JS
zS>R}!OoX8(X%)<0rW4xsJY#o-MDg6IR<wI8&7Zb?AT7X03lho5rnUb-8!hzk@NV7=
zc4b9QcEQ~d^MAmUj%e!~B3x2m+B_OESMKJeC;Q+#lC@<YZgBwM50(4vh0`Ml%jI!Q
zV)+$V2!ATbN#HZyvB5EHz*WinR7M{0`Pagdnx``GTnI!=SmuekbLvZ{qTf}Pd*oo;
zluMY`g$`@-dN-QblO>9r-MZ@dW5;48*$->v&H>|La=)2B@a<%@tsvf%!Nbk2R7A{K
z5)zS1tDM2V^7W<&aJQ~OFkUExG(%B_|5-eGN+EARQPR!ptlrYpq!OMS+p4y5tHR6L
zslXxNVFKzq^;60_HW-2ls7_E{A;goO6>Nlqa2JDF%Sbfne+e&{;l|JJ^X9FA`H4xf
zc{uhbHxI!~ZTizNp4113XMEl8DH2hq%+|S?X<?6ATh<k5eaD!=Ic968o<M^q)q1%n
z;=|`BN4~xn#3Nzqo1p#yHn`zpf;*DrtUluzFFl>zsX6U`9UlTY+KaNq-9D!Sv@{Mq
z{-X&|cS&6UUP}nPa?X@I1Nw`!pgu_R`WQhKtF7BYcpGgXu*mtx){$0jFkDl-@tDk;
zb(?<bPXzCodMW)f9&OY%&+g%qr86*k-@$8p`#z*ET{kVxY09VzA!3prE~fd(;CH$H
z@;H;!sNt%gkQ2SV&0g!hTmQ5o=3VN?ZZGp6+?>o5s;O^k4>S4nnvbWHi8nMIlf0ky
z*$2!#E#t+fayCdFH^IfThab&?u*AS9^x!AMVPMk=>c2F~L{skC3B=gS{DE(SCK5?;
z$J>~BPO+6_#WU)k?7W<8C`wSqDpAeV6o#tm{cl0<aNG8Fom+rDFe;8O0ok0BiMf*0
zzX3Dn%P6MM$c>2O=>qoircqW^2_^FUo9YgW&%hMjd9*QvG{T63QosX+0PnM5>jDi$
z|71jW4U$QP?5}F`p#0f~-R=<5&}|u6`Z&iq52#8{CMmqdo1YcfgK%usbR@malC84z
zXa%6ux~PpCR8=u15BQkmI9ozE^`ZzP#{ecJxXhdb<f7QI;WaUGjW%s~dL0AHUOxFH
z^Ddt;%n;Xoo|ZhT+*d2iM2pA`+B6r;9{eZz8J506p$d3t(e_ID{nagN^`#)%9{Okg
zmt^!5-7^Psn`f0xph6^hxaximMkn<<b6$-)SQ~7j$5KH`9QU+iEU7WpbeCSYldQgk
zH8I!&Kyi66WgO5%zdbpM^a2p+p6FvO(*tC$wd^1AbV#mM!q3cvq4jbw50zb*8=?`4
zIyCa!8^FH>3&F^yNnZRWD8*ZS9UlgBdKpLBED(DX#P4HEs2+|T<B(+MXOeO%CCP%i
ztP#<66t}2fGL+EQOfpFQf^Kvgc*?ln^xh%&_J@2Pz{e0W)4ZqSr4u9u=R%gyJDtVZ
z`a+8W79=AKLLgQp?x($lE8R*};lr6DPirwy4saA0{lv-8eniv7BNv;Eq;MDC);??+
zhV=u^7CaM#dl_F4O|OsmvWVb5{|z`J_cUT=<0o=`gTp5Ma#b(MW$QnxB{!F*Op-~X
z;D#pUBQU-pLpIqT9MmE!fFA|*B#MWy>aLEE!#M+{;M#s-19$ii69@4mBlxB2|MgO?
zEaYXdA=c{gGY2N~?!J8$WZhNh=0Ap?B=h>*giIhu!LV^&d_T19GdF=nmFg@oi8cS5
z4O!dy*HN6K$vj+w=RLzFn5<;|n^>vD<-NCIwX<g-FQ_kh0Y2$Lvbzvzf5AqqB?~z}
z2haj36rf0p;vnFuAiZACTsZFQSh?5NWtk#IPGfIMOvz~QVv}igd7=UFWUcO>g`IM4
z@AIKE@=QF_{FRUB(rwaqa%RN9TEXS@WTmMys^0<uj;e6EtV}lxuN@b|N{y(9lY4q#
zV6lu`7oMbq4@h!NcW+E8{f$t~&OPWd>Tpf^Rjn9)uYMDs2*BAnqktpv&#*$I{N{U@
z8kLL&{>}xX`}1h`Cb4jJMn$J{@)yj*N{v6AaipZaIM#UDAGIzQ_b>@oyZL65T|Ike
z=_2w%#)e4G!Z=)-X?SbU+I0`Cd|W|Rb9D^<(|J@G4A*jXTY!<iAXZ)`c5IHf7i>n`
z<<wK_8dlYp8r9|Fs|E3@NQ{}&<ro(?zZ{Huu<Maz7}++-7;a+~y2#iI^9Me9W8e0p
zQii3YNn_f(&%lNR(sF0P75PTL59zadX`j&<JCn8f6*_i{-!y-fu~L^{47;JMCsp2E
z0Senzq+Ty_=EL`bJ6;eM3^OYD65^`(sxue_6EZfEO<D;s=uh;!%ov79R^Y=2^%JUV
z1zJ!9o3Lxy7iKG;Q46(qb&oDQR;MjUhc7ZAX1GODu%1_(|0c|>>Wm#H`P?jZOY+<`
z&zwEXGT;S6Rm_xldOcK^0vxMXD~%H@g4p5iiu`{sEx`<-ZT1-!o&7T5vN|bDrvaNN
z&D}A@A*R^Of>qZJJWG&gYbO_te{T?WsDC4|!MZ=#>r<31gV=x<p|IY%x@tpn+--`V
zGInRRY0&fMOl8yv&UihQTyUk<C;i@$Zlcutp=gjWVvlWX_F!mcfSANQywBRSnD%>}
zTVI&&8+JS4_xQZCpt^>&n&r<Hp+jW;P28HPeOkApHa6lQlc<14k1re|6lIy{J=EJ=
z&&a`=kLf~>an~_~y4{8VgEQeKxctZ7U4xTB3<?pN<8c?Cj+0z`5=Ob&rxssZwH*wP
z$oi2|bk6Aq<G!fRod;>3!`W*wO0lGl_=%wWbq7JbBDjGpao8XL!~E4^@93P9#7}Y&
z66MTNnh^RhxZ=5GOK%0Ps5=Zr+p3Mpd&Mur0jcUUTjgH7K4_>ci1RpO@?xv2K=ZgA
z$J})J$-2bT+}*cp{#Y{npgI&PFS-8cFbv!0!w?N6M(s6|WvrtO?xOnD)-KV*R!*8<
z!a$T3Wf@3C-5Yu{@w4=K?-{c~dgkQhiMl-8bpuYfhmhoItK*)UfR)_0i<RMkkFhvw
zJhumelnsnmj(GvHQYwE{ExrZX_^YeeeKnyEFHUg%q%i%Uvxuh_B?@l9oe3(vzqw}q
z*Mq)rkqRyFUie#_Dz5GdUa8WQCzh1<%U;DuNL-b#TFh;sWy4J)&54(@L4TfD-(e^p
z-D*nE4N%U!&3qY&bo>cc>}yggZn1wVp`-b~h<cNZ9V|RLIKTI6Tj2nYn(HHo<yv*E
zTjI*yF-dP}kF&Ma9vU|PQ9adwon%$)m_8tTUBzx+O|1~V!*J=8fc=tQygGV#o&M|y
zvnXq@1^df}_XGaQfLGr6*H^vf2-^1K*QDiy%{=ub9?4V88m(vw{M7P&d*Y{03Aou>
zlPxMpNlw_Q!0Z*oHQr}(mwGznOcsO-4gQxBtLD;_f;667H8!5%UCj9$*N47XKR&$l
zpJbmAhpNdpqrIV3PD8H~+pq^Pi6?~>Y*5b`Gk4Hn8l`m&N2&zIVazn9a9v;-=fMm&
z;cAiz99Q5-n&6HA-U*I4DV+z0nL(9#N~XF*(x9P(=E8bEWQ-%F07Q^t9<gwqc=tME
zHxVa`V0Z2U>UqdCO5sD!)i8%4c;VnV-tme~)P!wXdYdq7KGQX(S05m6uoisiTf+m+
zw%%RzbN_^XF!2mwNA?eE!&MQu&Ksds5<=bB(?5jy%OU=Fu=HPEE-h1#x%j1@f+w1p
zklQRz+yPN)ltA_hqbj>(Vxfd}5nxm?M%4OV!c1Wiz60)oURi(*;B)V&<x!CGT#xn*
zY?ye$NPpnUplvKbg^RrM=uWIj<u$xX!KyTGJg459(5N6L`8Sjqi$q(nEQc2ia{xZZ
zPzC63DmK##kew^2>Xf7x7JC7}X?Uj<MV1aM4T7d{FBJDQreZ*`@a<ms6Z0H?*T(zy
zyH1d%LU(P(fMWT--%*7V`JRPDGc>F^+O$|WonX*r{=inSxz;O(zOrxFVDiR!#x+F8
z9auhDGd6-1ryrZx6DRKOy+_9_Mz9+@Cf~I%ZY)m5XKXxzvm?fUVj&4Qb~DVuXz;8O
zjO|m0e~wstIKzHaClPejf|k@VM`O0yH$;+&QC76(ApD79#TKgHf7HT<;e0_J=T|&P
z5X0XGH}cNZUc);B)tT<gB;cq7JJSjvFpPAh-0NF6P>mrhgzR89mal76<~DHbRP}s(
z`t0vF`_kTI|NZ9UA)7<JA1}KEa0HzTn?A@=$GH~h{jT@+Nll6BSGV0P2`}64o9V8-
z(pNjed5BN&_Q1KQmnYON9{BZC)Xi|!@R=n4-I2kZK^4~8T(A2c9vH=*vQ$$ObU_6c
zJ-j?$XjWu+1s@*XrkMEow6$gB*?(NQ{Q+lfUZ)5oC9B1fI-9+kE~GWxa0QRk(fk>;
z9ZS$y;lpd;>aM{Nr@zvmUtO|)l3)q?Hl$xZ#^58O`1i*s*BcPJ^_G3yUcH{P?BTw)
zA0R|VP3@(XZjVkJGPNeY1ySnaI=<J_);)CgW0>M0+EksBdEeF*y?eWdIor^i%sVTE
zT9kzX%GI3II<!AjThWe<u~Jq3{wco-*rZB`2U1_<-1%-gdc%w{;>P}P5N$QR5M=A+
z+q>*y`7&g%?V<zY4xA0$vEsw`hfsc1E~mNQ^S|>mo9$#sUE8T|Sgy3ms^HS&j2Zw8
z>cCP(Yf7v0c<DJFOo{v{CZZe+OJx$}#oFssa+z51Q#_{`az*C&Hu=J~3cft_Q+V9o
z!uqdt`WwrU-sJ|B&5(be#6R<LqxDPABH?!I_|M0WJS6I_&Ivzm8@65j7%s&UdR0yj
zC$6JF%+i!U#-J(ALo;lO{t%MpAY!k<CovX>GnN}bLKKM{+_ocw_d2(y5djw-Yq;9Q
zM6{b|xMHBg+Ps*?$w#~TrG6!nLsFOaV#?^TC{lg3+li{-jRv4rlUF-a<!5(9-vB!+
zvXbBD9&`y;CypNy_Nc7f;EE)X056I2OkaXf9=U{%85*)fLi>%3s_2~@dy~GoaE^0+
zCZ>F**JO62N^(+_vZq@6G&OsR%ij7kUICGv1M@^urP^(;T>xSENjH!hm{zB+jA1_g
zNfl;g#OZIT4%u4F0b7iXXaTT;f{pxlzB8W*HG!W2;PC%B92ii-04<Hux6M0D3A!v1
z9iUJ(I9xbHW#Qed1>|wYDI_JsZ#Pl)m$?%>{2=|zc<gW2i`PBK2e+7$aTY7!E%u+w
z>u2fjTs3kcC(fQ_tlPwC_4}{$GQ9X*RB6N02GbbQM>v;#Bf_{B=Kz~<a^GF0e3TMO
z^4p!0DPvpqAEg+#^6$c=$#c##6QqEI1Oo}C-UkT0X2yw#xO=A`7-3FB6H55w;0EZ5
zgsw1(Z^P_gnZ)SDyYPBPXiydbr9@IQ=;^G`U~_NgHIQid4I8FX1(ALLWR&aOSPTp=
zs6Y`YiHnRy&7BrwN&Puc#bjmQYH(YsV)GgPrG8M@{xQ8yp}xqdIyu@tikvSeKIoGq
zwRD3qB%l%vRLgeYB9n=+Qt6!0HF2bbPS3v5)TKH9oeZ;X%0jsUoL!kFk}%-%?8t7Q
zSgX9#UKd4iyAV(<v2=ix1)U!m8y0Ea%(WoCYvq~NJ)*wigetAbUX2Hg<mMMsNOfu5
zOQ7dD)#8&sol#z=Wgkj$M+aJOY4AVP{UI3Re9kSj|Jvnd8nR`FoZ<DwQ#m)X8|i^<
z=)KIZ`couJ3*Y*i8bo0g@ZAYZg;&}moG-^baMQl0cxll6$mF6LW&R88WZP+GkSBT)
z)=+N!D3OJcVdv%1$10l_SX-_+wC4y2pTA2bhfqEw9%cHCIEEi4>qKF%S@0yDdue%k
zGV3x?=FM`K%I4qG%1mLhW?&=ZA(X9@isk$y=Z&!!7V(nbE>GXoF<P{Lj8EpUVCus(
zBN)O8wbMKn$D;|$@Y;4TeL5-BH>4l8#(G8{f8A>>i#r9cxLbLdN9lHLEc-VtDfSL~
zPj~2@T&3&V>iUD_M1!ctK}TjN-&9wF&TSbut<!a~)~3YSp`^&&>idsw!0RkFPNzg+
zY4v=$g6j=48iz*@w@%$xPwU(tT8W;2Fm_gSA%PPv9zjHhXex@L1%}Vw^HPT3oRspV
z1TNNQzcsKP?LWAvRCgKcpY)V50+C02aggS#1EnG<BfwELSfhwqrK<O4{sP(_Z5o$h
zQ%P9KGi~;(lmV^uqw20o8JDpS%bzfZ){MuIl5>=Jn^PZc)|IY#X+t<8Bb|3e{9Wv<
zj0cL_C#46YSd}`HaWzIdyq-tNqX`und;4nr_cXu)RND+K-?Dd@T!6ME1}(g=OnPRh
zucXNKiZg}>NM`3mY!)G1hlhqnXS5(cY5aQ0>#_W?IC}!ggVphHfg%S(ajulTCh<Uy
zS`|{q%ACo7SGq3>Yu#SbWbCaCg}Bbxol%UnzbOjVRajz_$5THtXlwE_R9inZY^Fgm
z0u>`kxj<EBLib8AK-Qv!>ZZQnYOT=?Noc%;*M}xztc;*MoSy`~$m+e;Aa??35_Ga%
z_qcgwxrV$dT{Y&UMfrFkTt5G+PJP=%idByow@tz56*$LCNu5vGG|Y8)U(Pk~$;A^X
zIaRbsYvNoYM9urqt*yOSFB+^%0h<N~Mbb9#2Dc0PGj$t3(db`fMe#YH;%ib805{aX
z{vITCe41fCrU%P(u=gkhIgqo*`DjuNCuUh=-PG+aRB4vPqh9~#xV+(dPo59kJA+ig
zS9NiuF3aoPhHkeG60cD0XAQ`UeO}22$PFs=EEui*^f^L%H@44AL!fognh4BTZ&p;x
z;4g5kcdL;deC%=~1Us)WkO6a3R@{`yn7`YNR4Ow1Jy&KAakigWAL8qbEJf$up6?HC
z(>i;s|5+dR{aSKB%@r5z<Nd!d))j~CymIhPCC4{8_~07nN+oPz&a@m38&~SU&WdPJ
zegL#|bwx$K!M2<2a?}*{^t`r7xFKL!B*814-W$ZRk*(uI>~Iv(WAv9JI`eEY6NEp*
zkrZ;>)J11(A$l=daI;cE(8EqXS1UF4^m--lW(7dKyfq;{h~6mjSo5KB)9b4$c0;OH
z)rkEeUma(A{V}<A7f!>Q#1-q2qqx-=N7{zB>Z-4AZjK}onoqedbpK*wovL2K)MOlK
zOwX)HotAQjueo+DBCtibKVToLuicoExtSJK;LMQCrbxWLrclk`+~Eg1A#0TY?38zv
zA%)UyCBw$p`PdZ~J8bzQJ9%_kuQZY&?{69v`cdImGZSK~66;I1>%a73wkG08#Ne8q
zIc*!0F)}iB{1H}mYT>3rcv;ke9oN=c;hvMh2HXm*UpsLfea3-QFC)5f<Tr5l;fXp>
zQgywLen4Wjt{i(gVo8S_mqxJRJ2q_ZaXV)BF9pRVGuO6sdPiAO?DSicEdi|0I?Z{(
zp2<qlk(2%YyIyV)azX4Kg?YU*9l={gbER0a#crg@h6p=NYqoUvjm7Q-$uAFHt@iKC
zVvBk|BBe6wn}*v$+IV8-73K$X?(mvL&)0A6Ph|7F14qsZ`Li>{LzeIOytTSW%K~v%
zhSTXEDpXT_Yfr5^abgYfh8+4E*qrA|ccX-~CUzdCHgpTlD-?~2@-v$<&5N&%))>6&
zu8`akB4Ry_nwA1AcAFKp-q%;`>dSMRsnPoLii(bRs5|1Pdb=_-Rp_faVY>d#F=oW>
zC66%G`YpI+!z7iISfEJIy{>2<Nd1&HId`e`fV+$8n3C}`MW=hHHN_&~&g5OU`*NZk
z*jH;bt<TCKzB3Z%rav+plaJ`}85Pay6dCWId8r61Wp!ybIzrf^{ZE&whOMwE3~KDv
z^vz55`t$EEhT9BhoAG&zbS87$AXm_DeQ+uA)C6Gcc>{A7H79EySd}D2N@T2lulwY<
z)nr9((s`^~EPbJDn?tQi4%xn|?O*V(SD(qC?~to#1GQ!lSAlO;hPwAMZX+PS3xq2V
zP+Frtb=JY8cet!(u@T*?DoZ4r=xDkW$B{nMwepTTU;XmlENtshpqCxZG`FR7L*1i5
z3eL$piuxs4Kl=KP^(#x1a1GzksLz*ZMnCD@xxhucqX~!bS;3V?cU~Tzy%p#s<8kM@
z$WS&;XxDkJ@}OlBz)<^u9Vr-V8ANAsfg4<RcV7c$om0nis`zAGZkX}d4$_TdF-W%`
zp55qLiHjSP`?s9b<6kaHtJ#A#fz<gm6uVO=<*6Y{f#{I<wI4obt>vAbe_tzu4v=fg
zRdJ1F9Xrv0H@4PxJYMGD9iUl0DZ{KiB*%26=IpfGRZVnBS>!CA7E@`eo&%|BG=(ok
z1CCW_xGYKjI5mvB{^pJnRb*^iFPAiXEBE7<zFC6)sr3j=c^~7#ezzW7@@^qmDv7tz
z2@_skZ+KtmI@Ldv@L29--81OVZx-%tVeF5_>);KWu=ld8;h)rprZAqp8?ix-hu7}%
zT_UI2|FvK`-hE-7TMmzldn1yCVf7^6%W?{=+E&^4khw2Ol*u8&&L2xu4A0+F70wW;
z+D<D{)D~@)tI|t*pg!a=-mN7$Xl_UsVzu|R@7;MX)WZ@r{`|q{`Fiwe45r>X@me$5
z;h<T+W$>2BnX8@g683>!yXC25{<Uldn@$E-uD<`l6{->+>ga0}(ydP0UY>l{UBo9_
zU9qmSqrK&-^9w2t4xweL+rR(Q3xK%c<&2~$5Zn4u=^Lx<X<e0o2v`v?R-^l>^J>nW
zQU8K$YV;9Qsp4gPkWSY^tvKwM`K^6i*Nz&|P3~T=)Ec{lA*R}gk9&aJIL{MXS0%gi
zV(B5P?~APyDfMeAlJh+G2C#F#iFN1RJ5hHy=Z=jCT{$fl-pUB!G0()EU(P&*+u%?r
z+P1&{b4>Kfu|}`w7|jqypx@+r*sf9EP=iu3fL!J_C?8EBJPYodC#R+Dbm$#(?n4DG
ztCgC4|8dSJ0xR#O7({uufe!bccowX<Q^Vwyf7n(K$2zY!4UNj%c|5n9R0uSqt$H`|
zFO2_XeCC_wakFzJlXY8gOenm*`(Z>=)~t_1@6%B@G|2l<qr2aG$6<jMk(prQt{+y}
zbEVx`-PI(uMjlsp8Q)mdfVG5ny<W;77j(izQIHO_{bqy;4Gk-GB@c%SoGfii=iHRd
z=TfQe-sce7LjV;=1eK)mOO|q|_-6@&zs@|&zXJ|%_j|KDj5h+C_IcZHPHn7{()_;v
zPJ?3;^BSpi_1Tn>t(|8%C+a<*T9EQS&6xjzujW0)KL*oml?r|G`#N;OT<P{uSxB37
zI_JYg_f)+nM$kF!u&L`8-|>2PJRf8`^Ol~ToMJy8mU&$kPm~@Zs$ai2I6Dh$=B+h4
zOP~I>5L^R0)s$b_svYh%Jd8s;G(Gc5-d{<R^6AA^%{6>cRr~JP-Bg$#8U&}D=|Xz-
z5S0u{ay5zeb2tgKztcd=sH3Ku%4cpW2z20lzkPYEG~c^}E>PS!`*{RU`Ew1Ux@ZXv
zJ@RpND=<v;?GJVzGSPqMAOAO;#KxIBsjYO!L}<vv(<Ag8BY@r4_6Mw>?V@rH<hj<y
zbUN7c74mbrL4PLSz_W2_{V=FFAh?Sf>sJsOHH|`dwfR;J4I2er-+)YV?yxBVgB}w}
zB>qbqEsipEm(64=E+c+uorZtT05Lskngi(~L+;QY=6;;Jj1t<azC`CJGK8}q6?%x?
zlRD=tYWBc6Lyzv+QfD`pZT_$)+q}+Kwq(oiU_$Z-#oI4Bc+kgx-)eYcD?k6m4<Vt(
zFfwuaG~Q~dC9A<i{So4{?&_HEx|b2ek)E(){x*9x8-Rn0)BP!&X@#}v3A>(R_)D|_
zG%~NdqI$KBtaUjY8+#$b%-5o~r_6pJcB;T8=@20=q=81il-7SMH}Z1`+?FrHhk(r-
zGmMe8@qs*4b4mA;3-oWT;khtFqlyC+Sv%c!6$<DZ^>k>_aS-E`YsY>Xx-JAaZt#RY
z+3riROYL~$ec})Sg#`P%AAhRf{Bi2M+rR-bCfKv+LG$;An&K=X9*(GWo-sLG>e13Q
zv!;7WfpE3FSno)g=zS4vq97jaG=J52g9iGe|F(n=_^fL4+G=s#rLw?v8Ted~h~49i
z9)6z>uiMD(XsFSSYsLpOO%lw}z&tzczu@VN`ij~9uCi&VBcs@q@crqLU7pW3$7y`N
z3`nzoST@ir?(wIngXeJ9c?Yvci!u^w9;)W%oajbU(#knx&b4Ni&kSO=jxE7u<3eCK
zi<1tYww%d|f2s_+I*tub-`hXW*<3qu>rO38YH^@txLhDLu|O)eU}~gz`m74b)uTqq
z&EHn)09_k(-+2?0KJPjlffoj&FYlnB{o1^bQ)MTgoOyN$@_TpR-w@J5iJeCL&J3B~
z9O_X=>(1`zgg>9IR~mFfn<SjuWOaae7=ViTX?iL^d>m~i)^)>nf&iM12sU2C7YelQ
z%S%yV9BVK@rbLsX``H3tZQjha<0QN$fh8kjhAvMQ7AgUo^2)(w5hzJ~>5n)qW@?<z
zOYLkw{meq@D&VtN{_KrQt&OLDO4squfuB&A`JJCX&(V3AS#=u<p5c>yG<Fl=Hb(*)
zuQ4WKQf+?K`!;kmD<R~Rc^?}R?i?kmyMB+deAs=4Aw*4vPg2#E_w{?tmhU&;VMZ^-
zr?)ksB9#1Z=7pF`c>YYT1FOvBIiO;y4dhNCVNvqO%!TQ85DWiiZ~6X*KS${;s#BKi
zSbpiuAgBAX2EM}m15*4vFClLKp`4N81{|b65~@6?L8!{)LaZ{w*?<a?d;u$BI#7Vw
zoR6^n=ln<L&o2Eq*hj!a5eV^rew*aZ<2X-5=bx8w+p!X>N1wJ;HY^YAp>~KPPn@8Z
z7gbcPHO9Uo%vrAm#>&C$&I5;}KMm{Xgngmk`3EDsX_E;jxMSse$KxK@L^2PV1f2cn
zoWi@G$3Xs{Q1qX-1M$Cnk}=UGMBE{MURi~%ZRM%gL&KPJvrK?!I^lqb$8`m~<+<h6
zrWZ6O)2lBvBe_ICSYsB>%`V&rQxZwRd!SW7H6MHnHtrcOwtP{_bOz6wCdz)EllZSY
z(0;xyujdv-<A;wKDuPZRT-?dSEhbnPGY1M@YObw;kKj#$Z1bh$OrS`O();QT^SD#K
zVW#bwMlJs8?27f(4Iov63Lg)gxQed^yVWJznWd8evGEkEl8SXohe~pbUSb)pP6|(h
zCVESDf3*ztn&{T>VEYHZ47hoa*ISx@)No)^1G>uP;i=_ndT(X}s13U`a%c}A3wRNi
z_HZjD$|^!{lLn^52!1viiy@^0!<7w0h;-=WD`wHppaSsDBB!VM-N~IhQ!^S#8f>BR
zhhN<T!}!!zP{en^l;`{BcQE(-y;t8d-V#xEJJ4%uStrUFhJmKj{H*@{a^<OS$@}M*
z{~gl_JwRSF(T*BEnqB*P!_9Nt`>#DnsO5zni>OU_ce3i7seTk(+W4Tj1iN47e@a=2
zaBu2@!~PAT5<Yfok!bU>fw6diWH&o&UdR6#cS${7_m#>(Rd#KgcCy&NiG=Q*4=mP$
z4=obWoQn%rKvURNIy|E@P!5E+TA)|u_BZy3dNlO>;Fe1dlO~N%i8vvtx_Y-X8^%Kj
zhu6JP11=75Gk(7Fo1(Cs<=RxKPt3hSoOHL&Jzn?Ee#Cj)S?Nwu%~If4Rzit0A!hR$
zz}u#0MqAVEwM5w-5-R#`NR#Q=5r{jN81@IonEs_>vfgcESYUBcOvDp{dH+|1ok%dV
z)b;7iJNN{|o0R8pKwyQ2q&20Zsw=!8d2Iz2CGl@?%}4LoOE9<Efm*$hwn)tb`(Tj%
zIS>K5-h#~3C;<T6g?K;LYW7!97>tfu`1T1tT25I5j3D@offls=7;51Zb3{=J02;54
zIuvq8CPFSHfi$8!LshkuYc(tr!#{+Nsm?2I#_RS_O&MaZ0`&m0B6w;0H7_Jo#ph!Q
zMF6sbS9WQz4cn@@K6nn-0@O->B5tHLK7ctj!o<{?g1Mqe3FW&|a~12z_lmVzwMR1u
z{N04!TrA<YnY+VVfOL8I>NErNsg`&~j>uSo0NU`Z8!@e`KjA10CdZ&{#;^h0LpQLn
zMQpNPsT<ImScjX~YO_}>b$5@Lr3%_rt^E+#|Hb=m9$`cGRile+&da#~#)M~K^dXKk
zt$V42MK<gHZbF<V8(gbL`;TFZ70aIPFn*-MPF|`5=L+M&H=)`r^~$Tj=q3Dq#_^I=
z>g-H?!G@V*g+MZ4tm<lg)+wV@(!5?hN4Te8MLyCMvmi4Q@m<EDw+-4h&7G5HLq&fy
zt5Jnvs*E<W^(K8SR&vWkeNiMcAqKWbt<$sRyFVPieD!0zg~Vf6|6S+Ekwrjt$8Yp}
zB#oRf<2l-hbqQrzpS2V?wEb;D_U1%7KYPh_-_W*r8?9~%Kz5QGGmhR^g~M{oGW{`Z
z_Kxy?I>Q9_yW5XpLmXk4?>KF=b~bDLV(H<Qos%_-O4%dWzh8<Cc=(U?-#B8J?yUoJ
z2;dRn#v0@{J}X3dOctt3Mh`P!h!@ejGVg7|w!YQNETdtKlcg>Wd0Onp6kMr%z=*xd
z94_F)?Dz*w>jN9uE^o=cS4|!_qG2nL=gn-F(DdIevMrHgE)9)$=uCKl-nBvaQsOke
zz!~8y6-^y7g|i>S0VPbR3#@a$!rnX1gxW><XqDVj>?@$U!rl7_+jzXL$4<fj@xh2}
zlbo-?GASl-fIL+%im#qaoq!><x1ZnJbSd{YoQ@rG)IqI&?-FZ)K|Oca@CA%|+!_Pl
z=jo3O*8uW{7=^r!om!4Ixf<{7!kkPQ0}aZ`sn)w~Mj<lGjG!CF;~HW~b2)c1gwxg4
zc~W4Qp!+|k`}BM*SM%KGKbF<doS`(f-nOj1h8IQ&Y_N{M7iSV*gp`lp*ch^eLpCLR
zmX2o56CH+fTpGMyP4{~<I6PCch<;GhvzOmrN^V{eM$(d`hqH<B8_Ct5j5vpzxI4h*
zUVl*bk{3$2$cmBSyZgeeR9~IiXty9V>*$O##}ZGUK{{NNV}wVdwcT)skEd(yy~^QC
zEVQyTrx5lRJ;b*$T2Qv;wP4A6i5lvC6}qKS#AJe1#Fy{r%&l`@696NepVXlH?^jI9
z-X!r^ICM!R!#{xmw#8;t|2c23wbJmWr-Tswt;f!!M|kVUH|xJ(x3v|?;OP3>a-3Zj
zd=P&9#B*%2;DfQQ5L&ss(qP*UoK;mh$7g0*4#=a+8%3`qzVqryD=Hdx)Zz1X)+Dc*
zx@z3p{q@~*S@A7i@7VvNz3U8Xa@*43>aiT<U_nI@&|@eT2q*#RHcF^MKm;U2;eddE
zfB`WOuyT|V`9c$<9Dz_YfV4;riW(!*n}!mFPy^%;gqTn=JDhuG?wud=%slgRCO`7<
z<m1`d``h2zYrXG!*NTa6mcB=pjSAD{#V@c_ixEuXoyyB4_J=$#=>Du!ctOv41MQ0h
z>_V2_Bc4Kj+Lf=vaFGGSDBrx@&k}i@&nM}ZJMdHN;wqM}rWmqF>=+b=RYc9}8GizJ
z=OckBplweO)jqfw(|+q(mOW|!S4hU6MD}QICz=P@LduF^Xh=KuX2WRr&n&q=Rzy~M
zs~CU8$6Dg`SSQ}=-emj8Ewjn&ulA@xmKly)r_C^c>L{LB)ZL@&(l>(^61|zhozwJ{
z-Js-O%&DiHS33!)*pW$*)YnjHTnS@B^wr>54?P~fw2Mf4x$uM9B|ll4yF9U)c}Sk0
z{ftN}{zBgW8vhpnchfx+>-(<5$#6&QZ1`K#-F~h6Y(T=|dHVLc?l~H|<zcVjy|=V!
z-oAHuD{;I=THwmD#4)wuf?GN}iNZUGnoVOTA0$>AI{d1GvPSXlUSU}{yNNU%f=ca`
zJcuYHf?FCQJ*vCqg+@&?37kvSsU*OzAlQ920)nSYm$;-Z)bkgy{ek2}cp>i6g$kXZ
zd+wP`AG}jCare;q?@Mpx{Zhs@5d@p)Ru>F6a&t}p%*>n$^Y#%xqgy!|-fl5ceb?N<
z7}!~H>id+do7^8Q**aI30Pn8nGD<27ulUp7SYT?vj4bJ)8y=Du(TxQShZZ$Z9J>~G
zz307r6@Kt3+Xiy=c^J&obZ3mG1WaAQAH_pZc<<p$QUx>}#@QHdiNf&3zeC+weS>p4
zcV6}FuMPE$sIR22o({>&=pH&m_LiaUe8l?=*}or?2-<OhdcEw8XiZq-HM}QN;i2fN
z5b<;|+IaAJw0`SDZ$x&lul<xHMc3=b7i#s%MbZQPkV!vdqv+m(fP~79#I6&^l)`Sd
zgzS;_GjX*9r>x8!K)!sck}Nd*nU-k3WC?A|&$tJ8($&JT^Qt>T+GK`hLQ!RvJ+lcB
zQ}uZc<IDj8$y-^P-q5^_KKuRcvn;Qk0>tb7#c4P#ogIjpO_*XHTRDq8$Vi48k=Tf`
zWsJaFC>p^s0MH!}1Ks1-!2-0!2TTOtBFHpZc~s~(zV(YphZ5o?RX}xvGAK1%Yh>J;
zGf;G1#(~wl2Z@7)m#+Gq*MGP^U@~u#U^G2F_u~pAOPY2m7cEK8V7jma-~dqo2S};b
zfL^mHZ;^?~`qmq9^V;*lnL>WTlG}9fbX(pNW4hs&DQ^5$%(BHDD#h^*NNnGR<0U&p
z%`sJc?<3$L%{Bt_x~SKy7#0MTLzhxKOrdnUmKb4K#U7pKzG&wBlwrj0Asdy$9E*$x
zs+6nYjQOsCJ8$UZ472d=sG1#hejI3jGTV^^Y%GPetlqO}$PcAvgLGaJ6q2vY^lGDB
zsWn^5!1F07j%7VtYASZNja%vLK4O}iAtTB=3^dg04pwnKz&Ta=I6`QbQ7`zH$VV^F
zhxu_hRCJuoMp&u~SSU>Wvk1i-ydc=swe{X~2KzpRchpYts|0MU7X+W+a+4N3j9GCP
zdu52kmP8RwFtnj%kD70vDB~3kpf>bbsIsL-vUjxs<9-*=_Ft3}10oZuPR|GHv1TD$
zAv0tfI~%T$6|xN-<N$31s1b(6sT+$i2dwd5!9$LdS<u^xyRfm&Ow=rL<^U|J2b4*`
zu$loDyu3Bwh*zpsV+7}eYIXGp@!WI51OPIQ4MnDhfYH8-y?g8!rwbgMc#-}LSo)+G
zWXiMzLv`+Jz;_W&d%~{l0^0smL$E<n9hXwrl3?Dc7JbTLz7S>YN(1;L>dBw&K%aL)
zwC!Zo0*?RBNT|eWL8DvAp!D0Scn#QDvp?<Vpt#8pR00ciH5hI0-)O>KNa~TEYR?>q
zst#TegIX*h<B5j`!&^K)czI^5A%5`3e*?(=Z(ySsQXklY(ozO-nh@v{mQONlpkvk=
zYHL$Z0tI|^AO<!A9XbI_tg#scEj8!hd*Ff~$km;=hJK=oGc(yW_J@L_2Z1!^h5hDX
zCy)T1*YRWC7LU>R;>1R-$1%_r4v4{LdvaQdP&jR&GJPE>{20S@IBad7Q&Xv)f~y0v
z(9=vHN^}Vtx2@hnp#$YXk$p~R^I|}jS@+20za$#!Cw}?JV^7PXRmobhI25L@qwS#N
z`;#c~ZUb4(HiZQR+MZpbMm9V>RLC!1=*9LqQEkWM@r<AU(llVB5M+a?#muAAoLOTx
zQN^1E^1DqS#Q=j{{U8QY8|Cd2X|-<}{HHs(uR!^+D8bVtT%lcf>z}q*kI;`+O-;5B
z=FU2wcKhwlg7VP`uZwi0u<K0`*2f9r!7h?^ljR!s|2PMERehAQ;`QwMj<bgV?-@yA
zr(9_7QwN5Rec-mg*ex<eyL$}|HGY2jbaZ~qf8WcjIFy>IP&Y4OLOc{~!aEr9^H%mm
zSOooe9082J*;t{UG~I!X6<=-Kdfd3lV}A;}T#guVl%a!aNc5SjbP?yT>ptM~onxmH
zPy`*uiXPKYk&#c|v$nIayb;p08D4r;rN0&4mUiQ-cqABT*drK(hkCqvJG%&~^@6C3
z=rsc5#Rc-!)cCl<G0-*-%7F$DjCyoS-x3KZ41;h$G7|pB0&dCv*EJ!-+CcyR_CLD=
z*=2x<fyu;xR7V#39-L?$bPhDi@web9pc<aAEl>>*kjh@muug>qbB5vcijSsBf<8bD
zs@r_*V_C<57C8%4o-t^q67=rg@ZVrjqVKQZEbE1hK7)Sz!gD{X)6}e%kUu2Q@jqcR
z6H92gsu<F=c9NNdkFz%T-mBensD{VvY;SSfB;Q7NQn>1dbFk+iq0`8G84A&kG>8b$
z9;Iq8$f^)C-zPpQ>Y?Rpz%+cMf%$$)Z$ewSR##9gl0HOShltV(znBLJ-{!0XN8i)5
zMN>wxb=hw<-(c<0fSe<{r}nYRAJtIfb=0B~K)h2LqMxUdwQozl1gz1#E>DHKYn@7z
z10d<JGp|BzSNVm;z=ioXS;?^iGR>u7>j1&{LQZ6xD3#?5)Vjb6Q%08h^LPBz2m>d8
zFP$Yl%2%ouRs2l?upD0(j0F~`+0+XMz$~K;&~ZmD9;*V)4)hsKb}h0S8mF)c$f!w~
z@4{LTX>KfE=1$QqkDLO;et$>dZbz5tmmu*z4Y#o<qbFWj587Q}ox$zSKvnJOZ@nRs
z6~041lm-=Gm0m@=BDrSVbKFjaiU3QbxkMBLu#TzmyoJ#A5P#?{d8ZPvEm=FOmg^><
zTLU+t-tp~KOcV;Zp451dJ*O(`c<NsM8%US|>c9lDC|f4>1(WwmH}3!YF#OwcOCXO5
zXXuqJ2aFz4+6&gxjdM;GeY-`Se6UX45x7)x&Mb%fJmywkuKDWUV2wp(kJ-Ws(e;SV
z8%+|aN5Q@6vgI#?9%Q^T9!wz`X-0Lt5W7UnmMaiqH;ZdT0n5fFIa%_2-|-`#ddw$Y
zk(dC?DwY7q<C}9UQu(_!0Xf+jM@1c)!_ZUqJ9I3t_F48%P9UN^-6gpZTMS5LtnPz|
z6@wQAG$g}+WQ!zL(?q;kTyx$cTshZyGBgV=i;nBI;&76IaDsQcw~8H%YB=%IOag}0
zx|GC5Q+V<yjOIH)#atX|ZR2gP#!-Q+Q2YK(iLoa@2-&6ak;C0?oZjy)jVS#H$Y*ty
zVG^5wBB;--&0gpU(fpEt4zr|d%TFMxx#nJ^^9InAATBZs!WC_=(L=ZF4GDvSNl%}$
zF<qN?Mv2Ez&1qPbcc`dUWst|tu6ZNa|G)l=JK)Leh4+)ffqVa6${g|iNVXpbu^nA@
zD!8-HACq}>;yvgd`TT8-I5zwgyMXey);r8^nS4OH|7&tgG*F~g`pKA{m%KPLhb){7
z&iG#G%e%QJKf;JbyS+Lkv*7i+r`1x}#pfk?Fm-J)qg0dm*n?Za>ITHZZFHR3o!gb}
zXPNx@H|vQUudBG!#d-Cak#(@6Vo6{30#l7xe{I+nO#jcU<>=k80(Tmm2J$EfhAm1y
z2{ff59O^N}d%YtAPv7W63_u3YV1t(HBpQ#1!;ACu`A0lGs4mZ8D3#41Nv)BHQMy1M
z`544zR2No&InpOogQ19Aa`Gt$ixvw|*q`8z%3qR!WQ%Lb6+}=ggr7TfS39ffn?w9l
z7VlmlaCeQ5hzli<l#{efHV(Bo)k!x1eM%ruD29hPP@P^+-MhP6YmcuOqCn?}9LmT*
z0vnGqOko4j#S@>~b=LK*^R_4;sohoB8jLUU#W<Vsez#|=mQ-G80JX~~Yb)e1{;`#}
zQRw)d75Nl40=m>c#V>;gSOyXIMf6sO09FOwGchlf?|kgf-V6OD)cA;NQ<C>C3irNx
zW-@phIEP#M*`^siyc70JL{FtYq9=l?%1A0K9vSHr>BirZ3h|{vcrQhxEsTjiY+hTF
zId?RWmYjS+nAXu<50D+m7+v<J%^}7IBJguRP9uermJ`s%=OC2b!W92T0L6kgbj;@1
z4gV5OXIrv_-^Uq5ZG}Q&A}2QZ?DH%P{d3wV;~sj$Tg|IO!!@WT$wJ5xSKPE0**3q^
zfXQ{LsC6mIUCnmSOkRz-kCO)pavRBs`JdJmqcVI$32~qI09ox3TUzHxkAwE>+I@rv
z&=esI9k=L)DvNBHFT_h}MQ~&H(alR<n`cEQ4K<GtR9!pY`kJ8mhG6cW^7#2H55l;^
zb4`!vk>w^vqq5((pyM_@Ctdt;Kc1i@Ce3;Z>Q2)Im!XzI$P70ud}7#FXx-_7o>H_-
zt~$MWD8?=>m(#PVM$zJ%1<h}x8~8TrB+?ZUvt5`3icOZ4(#<_C<G1>D$(Iyg-dWeR
zyqEdd=ibdhLw~CvzQj11FF)PupT}=i3DgXfR7(0fgG1Q-`ntdS-)ER{T;e(=WyO)4
zQ8%F_d8#n{ZbL-`g3*Px3NC$o#5?F_vNED%vV&FgtTn|q)8_c4JJi^3<Ir@+qu^jD
zpPWXxT-a*&=CT*i8=H^4u)w*>w+CA9p&V#{3+Cg0w4#D;K!YxG6bqb{LfR3*>Tue)
zpb4%_HeZj6&vltN87&9OBRp8gB4>3;);5!YzYNCHRC~hPEci|2UY+olIhc~|f8dG-
zf$7xra19GhBGp{W>q#Jq!+PYt5|-6Ke)2VAtgT&P&y2q{()fb}#T}7bBc(7nRc`sQ
zM<<KG$I?QMR)?BA%qjGJ9J{Koi9--Ml@*M>STa{!5t1s~X0sH>+qq#nayhC&mzC|7
zF+1<1<nV0x!83pA;RCxLt)%>NGQ=A+f8T`);n?y&59mx@w<p%5m+K!K;0$bh=NSJK
zW0~|-#&|qz=<#ZfgMv%<V8RgU!~J7f4I>Y3WUZ^1|Iy!xFCs3W44t}HV&oUn%wPGN
zBW)%+=N4t==b(-qbzML9>gHaZ512IExB%gtR_hE3+(o5)Y)Qz``p^e)ISldKoiCVX
z;KMGJ<XJU%YDRE@Lunk4(L6)l|841^L<FwkbmWI9A>!zieBW=P+#PjNvt4~>p#DcS
zH0`gS1Hi``SHed>yf)f*y^f&UHqTf$MJp*-;;ftUH$&DGyLHyi|3K_(A8#-ol%u%c
z@HzfX_-gnjeX-!g%zCaS;Q@hqwM*6Mi?`_6s*CQTBwlLKhuVqv`g}62ZUf`y&N{}|
z|1`HtH%~DG9xt`L?DvfyvIbASOIM^sF<ggS!1BADi-O<eybZf-8`=JGrtRa`+@|aw
z{;I+WtrBn7(Xd%d<P;^#&v=D!Xm?6oQ2|S}y6Z{lmvV~?>(MKrrXgQg9&d28;fsh#
zTd%auL*6S}RTaPa7daWB{I69CF40GthVBkBk%8Q;vZkcI1A8Oygtph~7x#54xt&OB
z;7eewCKm&BU{P?LJQW(vran}9bi8|dNkqOiGT1g_9L7&u(V|#CHB$Kq(qedD+adik
z`nCBPD%FP_Itw;C!Uf)0EBIVFZm3<HvwW_lhnzw7EVX=DFgtqZS-4r8u>M%C^Tez+
z3AC`lp=QmJN}ZVvj@>lY&+$k#u+>b}o@Y*|B+UUPv#PR6?-8XgIn=julKSdvHoi24
z%*{9*7(2f&_DUr<Pr_SLlUNEcb&Wwo<_1{l;hr;>Q9NSdP&Plv3F4BSu@h7~${oW`
z>0Hc)1&z(P;Q@!l(5(fvoxw*;Uq|48JgHc=RHSAsNJj#>l5GP&s>ZQ*dfw;}?>4gk
zhOUZ3SqZCKHse;yYdtG4wW+5mA)h&&hz_j@`RTk#yw~~tBXt{^oLl(3lWr$GNBJ9J
zma)K}wYRk8uV{<{#n4Z^ZFYnByfhLoi!Qxq<Yn;hHMJWYQDyqCk57zrk4%)O*V_%I
zFU7VecNB-YHVxd(`^N&ex+l+$qE^D!H4YpHq)dAYN3Vf(5_?qA*)qB#Ng-HXbLKSZ
z<M!aev4)v3dE>D5f)7o;i(%JoSN&VG@>phi2SfadbP}Yjk<lEXeWWa+qH4utB9d~H
zd$%n=f->cw{(f6m?retQ^U-}T7V%*NC3|6~#H`N54J<@2&R&T*A<&T;9}P$Y5IBsR
zz)<wBA{#tf!Z@wYaWL|3i3o-B{I75qpYH<pvt`P@1-<%L3k%AHCTXJIiq3WR+UIO-
z-hQuK{dgG)M|e=BB(QzH{Hohc+V80nj(cn`A6c;EtW}J!F6`?Jq<O+%_rt<YtcP{;
zpUaKb9O}aK`;@CO5LO3TkKfj?iJ7R&R{`}5BZOQPqtH`>3*Ia#6pxP-iXt~mv-EmY
z-sPHOU0rk9T2qrvHW3cq9iIyydc4y1%$D$=)jz^DMHq7=zW)_B!`jO2?&Yj#GH|2y
z$?;1_ao9O=#T80N*MD=fOp+<&3>nup*G#kQr;TVPkw9za#>{D@x-5m}t{N3nsmx0q
z;N%G;yecqK(c#S-59Y_pur3=b#5frq50q)j9N+m!*l!p2ku$1lJSf|>Qhk_6OFe?B
zj3lo1Dhh7e@~7n&gs!#s?fHx=5U_am=vloh`0-72+1|W&bMoyutv)~Y-a6GW9^dWq
z)i<JOJ?jrSq7>fnKg<=&P;YBGIXfCym#ig7(}>3_z<RfW!keg0P*O34Nd>Gr6O*#|
zXi*9kWOg@jAt;c;5yC~P^BNEzL`rH6q8m`TouX#)82^%4nQ2iq!p4I4W<&haeYl%X
zl6L;Sp9FOkMz`wK9C%X$$FiCPeRcr}d8(*YRmMZ_NH)+;2miRnnNtjqF<d^TB=C4%
z=UB9~G*Llv=b%?e!=OIW``)ToPpQ#aM^GmGtYx$idSI&bg;GETGVzI{=$5dhgjla%
zhCG(}*7<>#?q1G}4jgD6xv470_Z4T0+l_TPLBF2e)@n>zwL9yi3D!Wh*)(6(uivG=
z+Lif9xM?U)hW2!Je8^8P$5f#yK2u-4XMZD(xb)hdF@_m0wda<j)QY~09~HjUo?yxu
zoSQB|eDn=l&s8xxD{H5?i-T#-qXeI>P%`;bE07zz!xY_zWt6s^?E*H8u^^3MPQ-$|
zks)}4B@ZB*O>0&LH${X$Q_0FaviZ0*V38m-V!$=O5yRCAP-w7iNWuEYD{UZQC*+w7
z_L0+?!d{vTDggCvB;iy&&=5Mst=<BS7-D?7@$Y{op0F?x>}4kS_&jzb51BQK%s`Gi
za<9gF0<ei2KEi!lm-ICw#4h;8rGJ>?MLV_K-$i-O84(waEP2%z!iaEsv1WlpNM73b
z++OgD3~c77HdB0L8e1FM|Cmh!38w*QYB|7qA%P=$G9|3b0cL|>93tuKGP3g1lHI+E
z&h_6%VKRIq3XDEnZ+o{0rz?tp-0~Xw^wx8>-?dJkJEy04%6Qvj=#cZNbDC$&_S`#g
zXS>9`UN?A?&aR8)Rd>g~OqSicO7M;>!4#!W)p2tUUl`ObKUI?6+Eh|$q)pu6)q@r(
zdpH}MRp@b@SHID71Jj_j5bpctO~2=Kv+=^`K;#Og9<<~4E#=8sSEmr`EQmFK6?#Zg
z;sHATLAvo*m-B1pjcZDS(!&x6@NmEy$?MnXMp*iefBgsX#s3>GUqgwkR1DOJj|GZf
PAbvBpK39AOd*|N(uFPD=

diff --git a/reference/plot-16.png b/reference/plot-16.png
new file mode 100644
index 0000000000000000000000000000000000000000..ea73fd846798753fbe69f679ac9a147fe0d95957
GIT binary patch
literal 40375
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
I>zopr0CVS=5dZ)H

literal 0
HcmV?d00001

diff --git a/reference/plot-17.png b/reference/plot-17.png
new file mode 100644
index 0000000000000000000000000000000000000000..fb72ef631bac21ec929f70094bd595edf1a682c4
GIT binary patch
literal 26524
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
Y7f}CT5Vl6Q^b5duq2JaYIQi3m0#^86ng9R*

literal 0
HcmV?d00001

diff --git a/reference/plot-18.png b/reference/plot-18.png
new file mode 100644
index 0000000000000000000000000000000000000000..d79f12c826aa468e8db729feaa79001234197bdc
GIT binary patch
literal 40357
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
QeFUlWboFyt=akR{0C8b=aR2}S

literal 0
HcmV?d00001

diff --git a/reference/plot-19.png b/reference/plot-19.png
new file mode 100644
index 0000000000000000000000000000000000000000..51580a9bfb4e8928a28dbe8e86115a48b7f00147
GIT binary patch
literal 39510
zcmeFZcTkgC`!<SV**0+7P^nU-Ye4D6f)IKKDM2NOktUr`f@LcT(n2#-l>pK^NXJGC
zMH2`RN>m^*1PBs}Bm~aNe&6%W@64Q;Z|3}Y=6gnp2|mwS_qy-vzOHL6d|_#Bc;w*O
zgFHMuN1#U6t$BF%hVk(5-uY`Ecx58}%`*71?~aM#b?_Bjo7Y;R!IuLMjBW<<@Ce6n
zKXxU~{r2GD5#xbgzhWDfy)cCgJ7KWh{d)+0RqUwwob8npN!OmgjywPO-In$#{vf;M
zQzwE?dgxgB|K{NjGWa4$OtG^hI)}Cq5B+U$JznguL(hdCoqQoCDGi5o=#@;IiCN0c
zr~b8!(izfDF%1oN2z9UsjxK68-u>^0{?DiX69Etbqp5Oqi3<z{3xzW6y8@b{<~%(=
zZSUvdsdqwEsBl9BH?p+OIf0*R!J2s7q*+d^)YjhK;pKVgq^LZ4=Kqc%_8E`zf4}!G
z`fK^WDb^Vh`#)Yj4L<^Y<WF0EV9qY^jhNM*uw6X*J||L#o$>n6D9K>-Fo_kJf(=G*
z%hR-=Oew{>ZF1^t_<CwkS$)McIwa#nRr*d7wh295l`gtoty8@l%`$1W#Q%*xYs7NG
z*P?ULb>mV4Z_qc4G)=8-pe9lrL%ciMIC9og4f;e<_+A^SZ-IUZt(&fDgU6vS|8X>I
z-Xpn|7L<u~hxZv2V?(8M&e3cNHXNnoojn8!6;xBkyK|%#z1kQ`#c5b+bcsjbVk9PT
z)(2WEl|~io7*FjD%!Kg$J8|tJ$p<w5u?ah3^gy^xO40mI6CM8e#fvaE>$FdFMXzvP
zFOkMzJEM7l+I|X}@}+m?Ff{mhe|~ujR(VE2jkVT_?SfWF<T&;2dD*)1Cs`cX`pI2a
zxe~`d-P~(C9z~EEh!8;>^gz9SKuVB<&iwQ?k#mYDtF(BGdry?&gkyN_)cr8_af|V2
z=(zAfTdHM;S82jhidLvj4<D48D%-=%qy=gUl862s>@BU!H;VUrA3Gp6YZ5-$y+XF$
zdi}Lq2|-S=wJ0p`6{oYF)VEU5eaB3h$;SlU&spH3WS5>OLKN@S`iOc>y_oecF#Rew
z!s92mYs55t3eL1S&k!RAi_llR(s7!3#$rDD(n<8x?Mgl-`@r%usdBVN$4{tKC%s`X
z?9rNl3qI<UjO*n=nrXBiFLyu>7hOCz4~cv}BsSYy*T345fJ7hECeEDt&beOL5_5gD
z7DoBa^ng<Qstl(kk4J_p9by0IRHs9WZlEtqV>*sulmsUWBcPXGXV7Z0Oi>5trbz5#
zLy8-WL?!x>-mT6b1u-V1D$@+!>aBfYpU|gdw-d$dbvm=+12qXALLe!Vj1KXGVR)aO
zTiHATUG#Wdf`pVm2u-$CI9|qre3;8qCdd@H>7<cn7Wen=={Qy&XWEgrnBp=N<zJX5
zOS8>Dh#JjH7bo=3EDOU~^Fb>OSQeC`XcvmxgG~A6if^I~#pau4OkE#I(SYf=7Un6^
zKB!iz5L+Ow2S4|v1chbSeR9#=F~#3c45E8DWvr(UUrpu+r^>2v=0wD%3=8$B-UmEx
zVaC;qyiCr3@&s4?n4HhVPp^1WdR>^4Nwbsm^LcEs>8&s29^*LldisHfAeN`He_o7s
z#KV;60bU=xI&>R|X)*-QrFZJg7>|9iXT1mVWR7e9zW<Gcm-34*^Ux?jUK`ZgrsCQR
ze(5NI_)fVHeL7%CXB39`eg&fsK)NQ1U}&FeOm9urJ=A>f;lsZg+PY<uGJ-a<Ohj5)
z7X~wIY3L=#4ApL9P3sq-CMyZJm5k5Otie;Q?lWcb<EL83HH%bSySM<r(-|_TC{}ac
z4A(K{v3VOh)T3i`@q@$^*##fAH!P#44jWhBDPiV_f5V4(7S>NDOZf?eVSmrZt@0}&
zjv*JOD{-zw;dG?J6m4uy7L_z=0@>BZjq!?&!}N!#Fhx&7`4dCf<i6E;DkM6swdFeW
zhC^ax6X(2mfm)}Qw7E#ik>$HH*@HL!8&EBtMq)&UvD`}20>d?3IGsi%n(1J8Qf!)y
zH5wC`2bV==YD6kObW)nIh`D5nLWZh|D<zuXfpWg^)W<l(K!m=2urGMkC}WVPGIhL0
zP+2e7<8id_hi32fG$EfiCb@$_n4Oy$n+$XJ-1+7*2?g5G#30(?<u1YRO5;3!4WJ$}
z{CRl3^F{#xeMq{Kj-#eXa>S4KypkilWg1}&H;y-@7t0st;OZ<SeU^>brPwn{goAKa
zrfHX<Ql9dL5i<!#)k9(tKbLR1HigRnF6pk3Jbr%bgNGAY9l`0zph=AMs-cNUtgAR9
zD%Bh#*YdkAef5ngxwg6l&ic7_Hd{W$*MD>CY|PNXxoQ3-30iN0B%-vt4$f{iw=+AN
zkv0&h>A<ZRaCsY=XN1O?G}_mtNUg0n`f4SvzBrs7^2U&*r{2#XJ|2}%imd6@Tn~k&
zP?Nh5`jVBLqv!*Fg||)O+h?j>QT5A?4D25K(6SLjYW!3dcQ7k6>m&ujV~vb?oKAGh
zm;Q)sT;!qSE)Ka^4!rpe@&>*L@?qy7r~Potnw?;JP+Rv3Vf^vNy!r&%^w6|-E&-!7
z1JY_g%5E<xk1xzvy)mn@-B1b1sB_1?5#KK)I_Kq~&#0fzwN6C9rnEk<kQ(F?5qiy$
zxeLMBqo|$~n&23HuB&|SZOt$pRvYBe>WlsqJ}|K2`IM_De7Ot$xDvrUev?ewf1tPR
zWR;=?W&f)@$tYRc6^#DuBZwZ~FoA)4@YVh1Q-7kJpa(O%!iO8I>*qQT@$lS_yN@v(
zm=f8WK)nF1JYQ`!mGWbRq=E@fi!fz|d$-`{n4|z<2ffiV%SS5<e4B?GY9eA<pJ2v+
z68l)j1`YKuuo5nmh%fHrNHi>+_VGip37RA~?f?5=>)kklhU-M1IuFltYiHlXU~wdA
zo|q2_+hT}VQ_=Um>Q}8dUJYGF_KULLy-y*E5L%mEpQn}I%Fl||fJMt)jxhB~(P!!4
z(~|eV-!2s1Pr}mrIQ843XnU>5_AIP9k=)&ajdGdRi**qv)PGtp6dPP^OL4Ss7^0DE
zK{4y6y11=^npVfi({^Lh;pOnh2dU6z2mD)gL}L7Aba{6x@39`-IT3=rWKw&>GKpWN
zx30`&Ztf({22TDVDr`56-^}3#I%%**aHx^U%Fb4x$<8%=fji=Tln8_M)0F|3rIGG{
zT&$K(p_@Fy0z<4q#-@%$CaR9(huxiop{`&w6@xVIbWlLxs(Nx?N#%YEp;LEAtG@&9
zF<sRv%BYYh7(BLVmebgAT)NzoIq}dGeIWe(TxEet=I%sQ->6I!1G4i(1c|Gc3Lp=<
z>fjgWl9gay^YHy6#y4s_)L^K2+@6uihQQbW!C9Yqbmah~JS?ZM937gw@c=5|ceHk&
z2(5LWi)n%O`y+SO{SsAosL6UoSBO{=(!9tT#OWb_-FJ|h6ZxWZx;!>IF+;6RY_ru@
zAx|bni&2)-QB>j$U-s>P(4suWkFdYDYf_R7bqc5ER*?F5&Y2z)O-bjF8QF|8w*AHO
zd!U+b_^3YDq()P`7hj%Q(rU9wrvD1xN5;>Ki^7SBD4oKBiQO4PiK&62jcf47zk5sK
zsX@&+ZjL<Rva)xIN-2mB>A%FT3A^aJEi8}Mir~&jBQi}(_1S;Vr9*ao6x7D+Wb2D~
zWqHmCrB=9`nZR#Vh+_=D<0M_P+sm552i-|c=-hN#;;3%OB77g2<=z!|DjBqf=ke(E
zf3c<j!dp2P>nzrukE6o6T~?N|Hg9DN2^wdf^=zW8zQ9qDkSq6Eb{Ma*x#)JZY)fw+
zQ6q=`Uq;oy%P)^#`;d=LNFKH?w8KoXE{HMzFrEfPr*59lm`hwWN?D+bBrd)ia8)%b
ztTb&5I^^+K{m992YB2mU*$}s<=PlLZZjy#x?n+N!iL!F9E;<j;gL^0vv}D<F+swZ~
z%jPlU%CGAQxVQrfmHO5_Qc-FBo3{4`oE-omE$}C1Eh(MlGkFkkJgO=9o0tbRdobvK
zwF<3=->G(T8>hUG=xO6mniSlg_{rgQ9zT8Q=jjQrZ5npBn!%lXq*EFVNSDJ-a#qmy
zAFA1SsA0B(QfwEibHDjF=-5<j^w_N8%J=$~MI3X1t<voi5j4K#eNyF6NOUERqtz$>
zKPZa60HDve46US&3mt4StxP_EHD^{QB*Ix*<*U^%T@IOO8sK@G291uP(uWNxr)7Rd
zLpbHlYbMSUpXFP69mR_Cx>vQ}&E7o?MaNzhnc|BMC^0lKAI6SdG8^~#AcR(xe6dMR
z4|?0$lJ}riC!0W109Y!vZx;+ylSJ4x%J0=Vf69a$EeP}7treNik)-W`@=E$Z&qddp
z8A<nyn&Gog;4^x(pDhw&?o0P))Ma29Kl>fTYhCp`v<+#=_r}e-ypbDMw4s#hZEq*V
z6lLW``QMKYMW+qBQVcV~mXd?gYeZeLWmVphD*Y*0;)taF4V#ktOpTlu+>CfTOV#9(
z#q?xIqGf0UY|3MI_#&JY>@CI&W9);Pz;~k<#w<&Gv*hU7i~5B&`0mE&Bm}0VrGI7+
zP;tpX50R|g%0G!~eu?dA<4dO?QSKs=Dvk~U7!Ie@)beh%DbKxze%)TX<)Hes#%oeJ
z(#Jo0D>8p=XrXhHSKE*AA1gGujPrfFt$2JmNYHVCf$p2DG>E9_!tG&CN^1Q@8iIJ-
zj)r;~YhJZ>z?@n?B-JLZ@>ia)W52;ndMLcFvlwlTMtpISL=<BkBy}oQ`LxrE1Dh}Z
z7qR|@t^e((dMmMiMOP=EM0S^le@-S+2$b?eVSU(t#2WVoMn|}7_U|=j{x=tI{=Z&s
zD?lBoLh%{s%O)f-ni(_$N*a-xf<x`l`{2592!T{pkVlXS=ecE;wr3MAXL0kDw1kEA
z)9l2E1+TbE(Mpq^b3fh*mFwlUc&vn)W~Ng;BM3Peq@HO#Lrqf?4|Y*c_WpR`!g#AY
z)EL6Xm#cK<l>@Usyu7B5|Lo7WuXD28#x_^f{MPop{Z5Eey$iK#K)eOD^skTBQx3`f
z=A2?@X5WHk_AOM#NTnH(Bx{wY(Lv_6u%E>;2rPD}%*RQb#s^h|)Gb{*5iJ^-b89*!
zxTt=MkGSJA*FMBa<>XA!A?yOf3YD6acZ#Flz1eQcxJb|8A#);#S%^rElw#V61ZK09
zHOiFKU54PTNgWLezxumz6PG=w6xu*_&wQC48@;tS%GT)1hwoOp4P6X)wO={VW2G_l
zf6g{S-P9z6-Exze7>v=ie~~A_>#~CM-o5E~Yd~wvT|{rqwoWUbazwUT|K20hqZ-rA
zdJPnQ=?j$;^y)n;Hm^DZE}uVk&!2D=FPE`;4!Ym-))eQMQHPj$yG?Lo{Z;~TXK|K0
zpD4Y;zCB-9Sbxm;-8}h;YY#&W$H?__nTi;um$Db>p9T1l&UJBzas&Vp|97S)rEQW?
z@&r;zasQF~xman48dBM~8H(@Bo`rBSjWkDD5pI~pBiGwBsnX6p;_TCvqm0Bh0=>!w
zZYli-zTcQQd!8S*BDv_tY12G{W7f9O22Ffs>!Yp5x7p<z`+xSU8T=kf=0E1*DTlYS
zm@{b}X0;3(v!f4`?Oef}nwvvEGroVfT<d(Xk+h|*HU5s*cGBbq!Nn_A1xTa}eUv1@
zX*~#Y3-zX6aWBN<R&xI~Mq=Ysz!hk%<f1g~IOdjVuBpk=3nE#xck5{SQm_f089+9i
zYE{!It#MsvN{v*f$Mw5MQ@bD-(ZR~(&28Y$J+v5*w8L%1>fWS08#1ZxmnhMCoV((S
z8Mo5%J2aj1B@NR3=c$Y5=W8+;ZKb~88#QpxiD~#an_8=?fb(r*r*><H$ale8AW8Vq
z$7(ri!?%e6?dh~TVhYDUui~#Kr)Tc}j8XeL?<P)D@dz$}U|HylslwK}QZ&qyi49Nr
z2%e4vQB!8~;;B{w+QnBBi+`+^R>SC4^=jMifo!AI>C}Ip`g?t2eeAIVq`dGG#C4MA
zp`_FD?uVkGxJd=&<e+5JQVC@@d7Vd3Nw0I)+Rqg==_{=@PJ2>S1*R7SXLn{*1;%S@
zef(+`I85`i>6f~~JCu*$`mjMnn+#{hhH>~Pt0fOh5y8>nZ84Hje=FD4e^!p&W4G^p
zzX~b5<7Oda$}yx-SfICV(2Ux=>sEs4&eZ7n05iT@GKLQYc&u&S842voFfM`mYxq9V
zy3Swo&5=?)eheendkmUCJGF5;h;;*9k<x@9i!;>`b$UIkMJ?j@H)ka4100vEhyjc3
z$1L!S{U)^e<RZu3vW*j7o48rjIWGo|dPkSPuTBXghR7A?CACTru9leZM*1ky!ZA?-
zIv2j3;oF4Hz9MD>rS;Ert#@kAz@7Z0&>7YCBt=M~u|*2<uvS(=)imeuF9P(gzIa4u
z5d>rZLt;)u^}aam7<4C{CUU2?KOZmPHSwr|<;1A<5IH9-MmvL<*~mAg*AyO@4OD|h
zr)g|EOO~gs)?t^Fm^)_4ADZW(z-EfECz-`+58fZzFiZ^g^op37E6AxI9Q9~cdzXa7
zZu??5Glr0fdvv)#bLFa)8rwnz<X*x24U4kt2~W!{3-=<7FoIv@gh3%dDe6L=98RX`
zP1FD@`njPdn?16Gz8&#9Wo>C#)L+=358vU6S4PW<B4hV75vrGRuE+&@SjZ1p(svTq
z*j~pQi{h<|EmVS|<|N1I9p0`CY)ywsQzfB#%GbI#RG$*QiNv6q<)xyO1Ea!QhqlJ<
z!%>I(Y-Yo`(m+<-D7o95^YRXT{oX6i^XWOr73HEw(Dn@E77-f6I&zV=pnI4(t7GY8
zgnw}nr$chzt`d*hK?Z+I>I;`TZg~jja-m!ETV}(J30);EIrH3(j8M_L8C_64*}L0e
z-K%$+`1@;NOS=@I&0^*-m}SW0^WPF(8JM3C>7EGZQ(D+FZ+d1Z=9OdL+d02jf1_dk
zP#Zv`LXc?R_>>{0Fn*lgrZ0V3NM}cok69mhGx~DlsJwEU_R6h}$;VT_C0pXJK>3mV
zZi>evAN;J3|D9l<%D%WcI@6y)S31j$E?$Eepqt2AI8Cp$3t&8{wX+qeSbe2zHU8`E
z6-aOfCra3hU#h`PubQH9DW2Ydn?8uK9}W?tn?XH$*)in1v3tIgWH2(a5w5COYlkj&
z0?Tp2xL$W)crA^vlG3(~Bd(d(u(eXyBt}RCh>CGLFNA}MC}<hH?b;jiO$?*^^%F#I
z7MP%72A@2XO8O#|WMCIAC>;Ma|HkOhJKxyJuhB|WLCUYyJX~E!oX?S<oJ(!Sg-^ZT
z)R$2poP8u(i@L(jQ7=-Q(!|`!?`FYmdt+bj)>D{g>YO-mbaAGtT?MX$pSX$ptEVpa
zm$=H9nWOY+3f#yR)zw=!+fxf0fV1ATYD=4mcdtfa>|NKz4B0((e-4^7cS|XE%Ue^-
zlbV|98w-j|ak*8dCIr(7w`8B+2hYE+W>;>(q;FYC)+%1X1YEGik6c9fR^x5^>ejvA
z^i+@86{Zc!S}{jo^vxJ!I!oGy7KyrP#8nB`6^-#sU5i4KSeCtR9DE=2;7vllv%5j1
zngUG+Q*$a}+hB+~Y^|I%A*iezqQNNZ**u$iV5#F)fk}asSIxv}+u3YaIi`;7P~VUe
zTEuQv=*5vc5kBs%i;2NcFEL)JGv_orvns-kV<Yu)&aB;hBhDV6)8a?-Db6yrZY-Qo
zE!;z*Gong-Gq}%v=p7BVi|$#5tT3HvW*eA=hL>ls#fk>rQYPeIXcveJ@0zxq@1vF>
zVm{xD$z!P!MjcQUJ2g>lDLvbRtL^J8Q@*3##gvxHwaptC=6JhrPsW*`-$5ABe*Bv@
zajFieAZs|eHB!W{Oa13wUU|5PNt_+FM_(aIsBnTd+N;6ifbB70zEMI(xFidfIfmda
zH12Ac+}(;Aov=@S?IeRawD^U%W3DJWbD(d}nH=B3LnjVA&nf==MXT`8T;vnHU9!7K
z1i{{rV%1w^sy_kcmG?2iFcKFd4HDezQ9JkUE_hkQtTJ#qVvN}bUfTl!<ZZ_YgSp=*
zjs16)>I&UvFATIdMc6ErzpZSfG=24GvuG+)3)d|Yy;9TG21C9m(oYVAV7kq1#=E}7
z&Jqx}O0^A~wvIf<-1VE$jtT1Z?a--8az3P;<!UkZNTkxi`;3X<Lp9em+o17SpG)`n
zr77#5QsD_BrB=A-D9-ugrYrMK5>AD@t??%ivSGzI?HIY0Pyb{<iIFpe_e**`TYu^^
z`ZrG{jd$>#kX1Pu;9LGG4migiWD8eJ&ucdnonY$bw%N8FnDT<26UNpeur>dNO(<%(
z)o%7~c#zhc#cbx~t%=$5*Lk$gu)gnoI6S6y62($A{p<=!ywyc2>oLn8oylwL*_0k$
z(tGg2l>FL!!Tta*-1j{G10y`z5<Aqm0dMyCb)F`L)a#;1V|(&_rtTC9D+Cg1ooG>8
zi_)0a_sR^25jsBXF~%c^+Hr!1lc(mmcwlW>(Jbq#xk1OfjwcYcYrd5ue6)$1j27vt
z3eDK9qzgt%6QVc~ORsX%()_AV+Ir56YO3QSY;?~8;rN{Hg%Jh1j;5tgsGX%Wf%A|M
zo==U?qA*>&E1hA-s_l|FDZgemioM;FO+(LwoGp4(ejmO&0pGyM4L?$qzOc^lY^#Jm
zK=rbPpoY;e%>lBFTbT9}8+g5R@3*-rY%IP@+Wdfx>%ZtCa>>U5s@9V_krG8AR5nA_
zjBPO6PeqrTwAn(Yv#mx!Q+YTS0fiKejRpPh`yq3G_G2{RW!FeY>|wj@S>Dk41u}M)
z-gg~async{mPV#`I5xeX?p<v+|7SF$<#!6Bp2*(r^-z)ewsuQ=)P^VI0ob|`yA<-Z
zB%kWCtx>;J6$Nh-UAUNN<8?{)*w?UeiN*UE;wALXl~jDw^chIh#G>@^1;sR^_K;$d
zH0IQ4clhoA!BsZ#+GtA|ZmFBOsg5%z9?KZ=I&mQNOM_DlGoYm3%;4!-NgZsxVeHYX
zshQayiW-er&2w)QFL2tSl)qW}*`xL`t0Buj-7z1^*HhT>+dLTJy}TaI-SHPuut_DV
z*dxichH3Z2-rJBTe^ir@tKWR0J3I$EG~~*o0`<(30~S8#Du-C+?&{lKZ=U;N??!RS
zk|x|~znUCXWk(s~h%*-BFYEXE&4_xSOkYVeI`22FZF}`o*S9eRK3^ub9oKm*UhESp
zJim?nxh`>4{KJ(-`ex9u%@qR?T*9KC3;J$fWa!EB+xm%d@W)LNy{W}_FzxRf`@BCL
zh6+c{jwD86b`jPy4y12Gm&oi6N5*>oci#o#VD%M$J^K1esW@kSTf=<1<_lQ%f(p~?
z&GXzkDG28{WL1Ph+A8x4YNjwf8-ftM!h|GR^RL|)o+@Xz9n^KvQd5rQU$?Zba=BXV
z*Kog*e%(`ZBcX3~%Aa;?&ne|iBo>zkV|?Z7r`-+9%<Y<qf;wMGyaB!go`TYZ5=3kN
zfTfK_qeyI<Rh{#-ve=YSc++08<VJc(h-f7e@+di+SlSu>#n+^jHB~NUC%)^^RZRP)
zBrR?aB{U$h|DnE@2dikynsOKMO#F(`gg%|afL6?$r*n8SXuAw{k5uzE3yZ8Zj&3(>
zFh9QAT=dx1GT&a<Y=5z-Eige(2eh+w>!x&-rmeK2qeXJmEj<{={ut8CLvT^mck1KV
z!YL;cciqN~p~x6j*aYJ<-?9{|r^=ZJ7bm<0#iFX6dAd-I*!<ji3Fft!S(ie252q$*
z@7g8jbA*_=dWb7yOmB~C`c)Cm!M?go9aFpz=EL<I)T<iK>9t0OQ1uYCzhH{PDXyW~
zA!22@;@yfF*0Ssd&@uj79d>e~(e;brG6Xg$eLlofoa`*QsEBxL8nyb)R82DtLVm+J
z-hWN}ZRPk@q#w`Nm7`q1iafa%>NeW6#XP$>CUS)pEy8?X|GCQfME%QJR0QkpP}4E3
z*Mi_+z<<sHWF)LDy(RBQ`ldx3s<($kO+oJ-Et>LB!ZS}Gbb|6tNO@%&LG`fpPpCRn
z>(9n#2YXuPlHj{v6=PFS<Raga#LZ_O&HDEw2=f$4O#8ZdI?bI~@(#K9!8v<(pzq2_
zq~uPA5>qv$$zML@%weg_wn1NG?`VrSr%KKr)T;Y0^UYdn+>vc~L`2(4!0Y}_RV0Kr
z4($Hi*mH6`q^0s}XiATt+{73z-0jCji*~GgS%<*qNMA<Yn9nK+r6xs;$l61-csdnc
zokMk@jE$9d8@m@4<mblnz2BCkrtcIv6B5%ybLQ@r_jlS@Z`pU!?lubPI#J&9S#G6|
z)8B4~(DPKp2yPW8Xx3uF^k>nu5(|~6sI-MOH=kB6Dy47vgch!}U7_r+42QU?A4$^~
zO-x1JpWBvX&PcOjwDvji>T`3y&H!IaByY$El8ay+s}onyL)MNJ!j2l#?z#4{b>;!{
zhL=vFMg>z5vW{-}OOSjU6N(kGDBU*1t(xB?yvHe5C+T^)gSU8`&UbuoA1A*eq_oUs
z!%Eg*w+F6%(S5o1Ag=CoI8^$AXGUDsTS~RFjI_#wY~f|rl_kaK1zl#glT;yzS{D_#
z<%ZmUe_`{~y$O4@@o89P>!e4Us0?8~{DtX-kG?trsb~I}8vBY>+BSUC^=!j$K?{RN
zCSoUFn<R5)>f%9?Q*7uuDN(KyuF%hdJw8M4I^3gemz^z6(l(+Zo7WnJ7cHO_pYHB2
zsTn`0Xi?}lcw8z<hOjb3M;vud6JJ|OR$>O(!pV^tUBTTpLTTNK2*>I5zS6<Lps36W
zdMUheCji+tlP)bds)TBoFl%0MRb+nd4}_2lT6%}`B+_zq0~bXPpsd5&^?1C&k&@l|
z^V{NqZ-_VXZLvE!B!lErIxo&DQo9xC@(`o$!!fkqk=|{g=@Fvs>tc#|=U0qs+)$$t
zEv9-;8MxIcmIY=zEHvZH1I6^I<`0TvMDr!iAWHnW_r22LC#PsD)%`~zJf)^Bd<)0&
zL%QjY#ZHEhOTLw>F4{luJuF>YxwfsGh~%rA&S7cPjUw%j(No2vl)EO>U{At5xG8&w
ztR79jpeRN&H+Wp+%kj{JdI(Y-8HP=!e)2RZozd~xw00xWM(tSf;R|Y`;d);Km7-xa
z)BNaSt;w;qP8W@hwfUl4&B1W89Mg4v<ne&-xlo_%Ij!Cd)kzjxr}7NpyqL-bswJi~
z%uh<-XwI!R@_A~7rf<!3(Y*;)H=}uK*bXbT3NL6>9$9><bN;4HA`;@7S4d~c0kP)d
z!uUKv9)BP5yLQSKlE$cyb)jM<I$IjomQ=&e19FKDs_Qqibu8Tb`3Ea1`n~~VS8p*<
z+prrO-Oq~D@2C3RP~7ms80Ieu(h?x$hZYd#iZTnUIzolxzE<!(OIKp+F5g!OWZthN
zBhKu<Ntk4PT6ou^3mpwltkNZm6<ZBc_d-4tREhJ##+q;D#lW4M#-F$hrywpmovPO@
zx-~s+MW_Ti`QtP>9-ct`auM-U*rw9m+GBt)cAHdeg*+oc2>3K;Vrd<SdGrpp>WI?p
zZ(O+``Lu37Zq+38bwBbBwd0YgXsMnPPULJF#nPZ50xQmz7GwTJw?bFM-2|dxs|Yze
zr|6Z-5h@feBQxlr>;^Jq_Z#-?v3fhy;aslzdw0fqq`4aY-(pdyD%2_JnfZ7HlU}-$
zt|9P=)Zq0n%zC_w^A;~u+Ou&ZxnC?UB(B_wj}F$Aa5>zkBkQWXS-p7FQLQsx0~-&H
z;Sw$n7<WLW$DGJ4Z83t*=TET<DNE*us<2KLQ9hjLP~b5fuTS{(2;bb7En|qQgT;y5
zdsorF@gv3xG0}B%$TQZBICJ294Z~ip-dAeH1NHnMZtLEi4HKAKGUOz&A+eQxGn5yz
zt<C<mLC)I?As4T2I>}PMTd5c{kKD`q9B%WYXn|cUuiT&;Z7>~mlnul?K(zTaH>HZu
zW8-AZ^eC!vVlh*3B+~7iN+$`%;w0+Dd#snbhDtK`#AUUV&mrqifo*^NW8poM@1D-I
zE`4oCtnE6qFCo3DDb#8DY!iP~dXIs>W%A!CQ!vkF?Ar0~W*%(=9=@p`15m>i<^5lx
z94U9tX9`RDheu(11{$2b2IxO$FNMH2P4|XL(LSmp56DB*ZKP)n%Vi{~+v@pl)lo-b
zdHUOa!H$ei{`k*){i{uDo4QI9e_O)cT7tWeMjc;Tk6jEMg86x$dFe4kC58t5tJHb5
zSC(J(^UJN1dyPW`3;uM^2F0ja!v(d%Oarw}`7SWhaz&V9SCrVTtKsn>Ms5z$NlWzu
zBeCT8C#jJ-^@hWq5gH0ZFNEL4>&8S#R+&d=O*(lR0u9m_+~3@m5a%!|;R9#Q1Wy$1
zLcl_KV}k#=v#p#GAxtps6(!hi%Cb@Oed(l-9oybbXuR!z)J4-aZhg)C?SDmki)(E`
zCIfl^t6{!9Cwr{5Le!J%m`k2JPmmiBQEW6WtnAx>qpJPp&`Qa-zAHhd{#HnDIsk(!
z61;3zuPet&sr(sKfs`*_g-BFdSk8X)l0ofm?X6I|rzlfK=5IeqKjD>Y$Ktg2rXc>-
zG@-orMvv=xI^r7q?zM_^`^gXvR$Zr@PVGG`cgba<!KoMi&;g=YTana+822vNgi-FU
zm>S$z9{eZ7Si#Yq{OgM@AIza}?Ykr<s>z_RetZ=21QWJbnAH>Xsk+Z;{VXP{Ie(RH
zpZejQwz`fc@Om$TL8Q-OWBMhA;>v@4YgSlErg1aB=45K7$2JdYQ*d4D(&!Amp42I0
z%oUehE9{P8OIoJ$Yw_IcjTcGhAc}>TosgMQfqX4T?#<T6zYsYj6H;2;twVXi7w{$G
zOM_zq(OFu*+UTyHPx^tv1oQ!tlpH3!Z~G#JE}5?P)wtFmc}5^<b6VXQZv(O5@os2v
zFEGV*06dGkqm21$IlQfP{zC5_`-&<`X*yy=%PRR)8x6LxgjPZy*xET?D{A7gK7&|M
z>TWu?EbY9`A*SWP`<zz!&x&gG%M{q>-DR=*hSuB~DnqfKH$tU1>hl)Y4=xv?8M`qu
zkxLnyx#g*d*UJT_Ikez~ly4J#q2d;fV1316&`poPfi`jkgiL^OqIUBn`7-*3^)Opj
zqTp==mo(gOjPhtN>Ymk<;CYzSmHT#0iF;0kyJ0$vvgpz7S{Nw@XFh2wC8nW&!*~w>
zkLPu|7<YFcTt8!lxAy$|-Tyy7J@~sPcwZIsK+Go}$@-pP-T%xoDNug*BmJ8dD%Co;
zA@IJ<{d2|c6)OLp@ZouwEnf>WvijfdPCZ;a@&DMgG9cyz6L0RH)#L{UVM+}XMFc2R
zs$T8AZ*N)O^7w_+m$A1lsFyob!l+*g$Gs}sDk_{CmyVa(mzQKEXxrM^?Ugpq9{bVB
z%dcHz5O=C^q}ayuevW2v;bp(+t#$C~a`uF8OL?H3ogHA9q}-DN0&b@d?<<;$WDZQB
zG3l}qOHI`J54RqWQe|yO1?XwTp{B8PQ)WwLh^mK&$0m5k>B8x3dn>Etv<R$enuDZF
z8WUwWvEjSsTi3#9Z*d>W)iG4{o%}PswYB9rPb_CU(uw8WYl{;bt66^SO%tp&I{kCu
z8{fhBoMI*3qgNgZOcYeOw!qGEM-e>gDjb+2AXBds&131TvpJg*0S2aKxXK{!6b$BQ
zWf)qN78mz|j|0y>{qU)91GD`T1Sa#u#zJQe-hq6j89eXXveZm(bATb|d;%%`XI5tt
z^+MiNfIzvrx`uLCYY{^j70<7)F1q_7h-KqX+`AK|Mj5OI&-IJY5T||2<EypijoQ>Z
z&X55{JLzwah&*^nE5*35B3dQNHKz~hHnH9&3R|myqqgo%G%UU<t!SPnR<^U|cP{&o
zhNVv&94Rg-x&J<7krbs1Ch$RRDu@t2)e<Tyn3dkFp%zlud{}?aE|_=5)i+5|DQ@!7
zZ^{=pc^{JQ_rJRMNs5*mv4m8?1U=c$4;w8s%i3G(Ii&kz!mq<8X`a=cAl$+j_sokL
zQtsHoH{bsBtRMpxPIJwR-rhvc&COjaEiH{Hb8T6F$$c5G$Dvu+l$4gzUka-EmN~@9
z@QmGr&$BY<^Zl_743Y3(Z>Z%iO*QJL58LO0J8Yz<rXDUWD-*K5c~b-aCHABzcL5v@
zi)jC;b`2T#F!Oerzsu8;yXE4^qm@@|Q#6=%9cRze$<XGmQ`ybhLgx%6S6u}qrRi*M
zR>#(y@(?U=;8J74>5D)AxmkNxC(D}!#$EH{&+i$(BrIorf{|kZLR9_n<HyWjNT&wx
zrr_o8AL#q|MYaYh16gFj%id!@kVxbY_-MV#A4-;=Nc!r73TE=*Ms2^uiQQs>A*qai
z!q%1=$*76%Ah|TIqCq}{5j-+n8&t!?CmMX@hcu|!cGT>^LAl0YOSMrEE#s!W-(PZ1
zfoL@~PKSGC6y>3s4b9BVwlFjI2!#Vf;9hKpy?ggU$&OS0-NG_Z{1*YYtx8*>&i&zc
zI|*l03h%5hjLVccH~QYdr7Jc{r)<Ae8B|vj;-g;joeWz8i?hBFHeqRNdm{6qdzV)6
z>`9&~W=ToOL6?ZddL0uJ6G67CJq(sRsLNhJ=O<{+7r_Z#rJ-by=S1|0zxLc$YMMoR
z6wf9$pW&%_qI5PX*!)S^)2nYfe|^i3(+XJ#Lq6GeMC8D}Cqt)Bp41rw%YZYCKO5W$
za^*34_3JhMdj5S+2&a@`lMd*Lwsn&K`oq)Qs?ECW;~V5eH582+US0mguh)cRQbK2`
zREu)Aj_ui~^>NQ(#l}he2x9x!6=nN!C%cVT?g<)$#%$C48}ZU>403c2zQE*=JE0&`
zkEf>~a7bsPhCA6ILXpJ=CsW=3XYg@p(_h)%BE}{rhuYaoE$xr=UsGC{gU-o)Atz3p
z_$Ok0VH2h<#Ao{I!kY*P!T~%Z^vB1i;5-G|L<y;###5hiou0QwA06!-8j6-aeb}50
z*4#zZ{m9d+j{t1waUp`k%-ivvQw2|-tla=liSW0w`gUz|b8|@5i@4y&VQ+{+K-Ejr
zdc5AY?h6E^c+e&6$J71w2m*xyAgTDsS=F%j@8AD<OwEgK4{qMq;#7CfinEJ%Up5}3
zaK||N$Df(RoqU46{_mCSzD`w|W+AHLHi)N7*le<4?$}#{xQP`ev#7y)JfPJk6J8Pg
zw!n$Fg<Z1=x%$TP)@)C5G&hmrs}VDE4#qng#}w06&RR4iSU^TQUci_#EiTT|iB_tW
zjDM~#Np!tDQ%eR@3G~sNpZYhNpPn6QQ5g3z!cLc$l^r&=Ru>vHS!2I%7#ZkIO%94m
zWNQczZWhjrc#OZx+6CuR3`-7tV|o57NCWu{MQ5TGi>c_`pz2lw2gk@w(uL|C{P>9Q
z>)@=LT)K2AcImXP5a0ffKOU^^Or+8PWCnkKc}7L)`F7dcw{Mqzeu-mGht0%C<%Q1|
z4^f8lqAgbQb=O}D__c4|rE=?eG%X`Tt+t4>f>SQPJD9y$1b|y)b8Xbk?X1q}D{=tE
zT-e}mf>6A_;li83_=DE4L3UonNFQF&sU^fGA5PHS{xcI{Vhu{OBQ|Oka>h`||8vH_
zC|w!Np(njKE;DGNIyGEuvr)Grq7g6~T3n&$1X&xZ0GM76YEG1kQ9^pC$UG_lN<DL2
z<mxxWjk0&|?vbi)f2x<si(Dc7LV$+w2-X(PL4J6=m-nrnvb?;P7I;WQ48S~S^foh(
zfm;5spZcfQ>+J;N@+%y-c3fLR+E8orBOOz}GBPqo6=h}5sKa}b9$ky!i~7tEyHMG>
z($}8h642WVhQV2U)>>9pwg?(<$PyTc#yw)$&HNk@Lvt#~7<F#OfcBFXWtbp@4B)n>
zcZdm>7|DooiA{Mg6rLrkm8Is#w*(sIXqjX6+aep%xogj~=TisMUj%+mzmE(~S)57v
zwdMyI-Re~sP49I-AwS6D?az?7JCy5s4jLRfWndP5{R`>i?X;-1_>w+Uh>KtTU``$4
z+a0Ji?h~uHxz$B4YW=C4oZMOImLo5QTVjL)dNkP#@R+UNBMxp+I;Rgy3&YD5g9B?k
zJ~KAn=LKF&+v=LJ^R2Z~<LyyEA+HQhA*nez=^&|E%yTqPhEDo-yE#<2Ank*L*OJ^&
zn{#!EdfQ>2LD;41?|r-TL^57TBLJx`q+1U<YONHF=<Fvf$QNT#?^aMy5FHO&e`l4?
z2fA+8-r)J+@c>#u#&kW%&OmO@@}7MEyKcW|<bxnWp;@#esI5l;<ut#^`YE^n`H74d
zR8z_U-Syqd%F3Ixw6trvND8Jy_5ScZGZ5TQwS$`U)L)w^1EM^`(rWP}i^P|D=jR-T
zd<TA3e*OY-qNY(Y_}ACl)p<VZ%bmQV#`u*vTwDs&!P>eeOY-E26W)la=HRqEZKL85
zJqg2vNE0--4pKmap1E~3QG2B)865<s-*!T4am+nYxb@bD$GbpZdUHtW{rB8UUc~I1
zuC6+>wL`jE9iBtEeosIB=)A_S6Ep(yIFy;?pqHRQd3CPTp>hdUWS$dCuk1igK06|4
zUI}{b3P=Lj@SAHf;{ZoHdKjAACkM`tlr|z(W_uk#D)K8TD~qx|AGdHB$3j!=oEy9m
zx(~j0Ui4+F=WGetbac<ft4*sHS>@mG0@>dy4^}3F@bSlTu^y<k`f8>W$hra;ajOs@
z)V?EUgH~cs%7+6|>EIGN6+DwqXz(L%Gr84twXqJPYlwG+)kZ}gYuh%XWa?q&?#`Sp
z_(-2Dsi;s&#lGcR9PyuhPKE_%UbeCuA38`>9&T52Eo~ptdvgsI=G3;M3vCgZWH)}V
zkPLo58(FUvl|@jw4bl(LE_M?rF{UKVZHF~_6QJ;`$Ui?~^0a*?-z$M^^7wdVj%2A;
z<aA>zk_&R7pPSF<-~Ic$!QeoyPJ}X4^T$8Ow=agT{$hlXqc-|(T{x{ICwCCg%Fr3W
z@3wz~KZ*SLggv_-orU%d4TW;*13)T$02O~PRT8v8F9)+sRT`7aA@@J|@Bs9*s{(G3
zzgGZpyKj2o^d#%Ue$nh^->GIFkw;!28|S~o2_%YY2Hiv4zJ1&5%9SgBRtXkvDhNEb
z0~`x;Lm{y?26;x?JUoBza2U}W=~&P~yMte+Utj3h*%p)neW&C$0)hBAkUU!MJZg$Q
ztLE!6e|e}^CT}bHTjKtSN^a}_=hvondGs@W(d}#CDdV8lGA;6S+v2Z@(EIcBb{;^R
ze|HJ$#pgCeZmxtgKr2NM>--aSS-%#D<<1U!!8{n#ZE6EqYK&?y@-}5?zG0#+*$-w@
zA4J1{1l$T<C25wcz4^@9uWc<0pq#w`=);NXKc63oJEhp%Xjf|A?u-EUDG#I$wuO9t
z{<r+WLx;S$AA_JPr7<Z3ExLdmR=9Pb7yz3?mRoYetaS=$>Po?M;?#RkzSUfERRY>a
zlCwxk8xdMxwrNH$T2OFpu3OFrLrsy?0i?v;uVt|T{i-h7Yr1taItPDuMhNPO92ohX
z{L^ixFkm3BC!m(2lm0G@YF}pgrP68brxzOgbHdLyMP%wk&rrthT_;t&N(LPgYyryQ
z(>t!yr^ahNExgI?909cL&70$YI2&ZW;DxbjwT<}^dUg2PybiG=dgmNK{oj!RGNZw@
zc@XqGfH@|@upBhbQ@dcZE<iP*(y?Hn8EJ!ax&Rr30T$6i=7$mK6R&xFCK}2YCYzYu
zKOU%GaPN9K<zAE*&?l>s?Hg;ZwOBWTK5_8rd>O1wbB&7G#e>Fzh%CxN0m*Z~<jq}g
zT$YuUg;J77-j~k+UXaWA<+Ca;#J95)E;quGIeqvU7gjQ)Kt4eYKNmKw5uG;<#e90i
z%~W#$5^`^gbXIyK*hbcX5SReo&n_ouGC;qeN*34E)lC2Zqi^<lm54;Gev6VU22zil
z1Eib0dlAU)Wk7(}`Ss{Y*!C!P``MO6$>J#XdWQ(=&kto|yxz{{&=XFDOs;JrLNft(
zv0I2a<Qh74Y3bIDUKkw<xC|F5q%CqMq3BFCzjioCi;2}sPL`HOMK0YRwk@g~S2x7p
zgarmi9<$1-+*CO?-6RG5@$Q4!BC#o6Gt`!&(}4IYyLUH<xo{4Fb9=ky3lv}}Nbbu&
zM0fsl&v9E(oPmMCPHmB$z5V5EjX+8sYn7%l_cl&xey08~o8dA%fa)_UA<v)&i-hZa
z_a)t2-5;CX^5dBxg)2#%jg5^HxE(j<5%2!?OZUFMHs}_O-Xd`myr_8++z%YV<+7jb
zyu9d#WumGde^f=iIhwTUOoo}HD~uc9SAKb%5D?JXc5(r;;@h+P5?JHP*4FIy=RBQ7
z<<5<#jI9A;rJQxuvJWCZJbCiu0XOPc;$FYW_tgax+RAOKcxUu<&5p8?QhOB^3(v~Z
z(OVk=%tw!&<^Vf$Ido|<U(JWK%B9YzLwu%rx=~e<M?`hE;>UskfvHQwf^v;oO5c%4
zP``5x{0?F;P$1h2<F#4!eq@xH=6oMq!LjNVKXm?EevFssOPTBkA4@>n&>gWeLhn0#
z`U2U9bUQ|PeNl_inm>ojD5{jrj<HSPF6Wi~!l_^Vjn|!IMrtT(<#{zK(c4=M#D>9O
zlZc-$WVRoCI-=&yL|z^QhmJ>Gg!8TsQ@plKp9lJaru9Johf!$5oV?jJQX!i`ZSH49
zV3jZDc(+A#o$)Nwoq4HJXp#wYa&lT`(JLEKE4?!On*bFP%YhsRpp@@$82A%4W9^>{
zCPxQQI3v0Lv4C{|$?HK$tuTl5I_g3h)0I10%%KRNd1oF2EfIRB_U=Hg&uGQe+DunG
z9o-iY&7u`aql^E#_QrC`^1Q7KS62h+-w6BgE8%BOv(r20#tJWiLyz>u6eY@dd9XnE
z+ZtITkxiA|hx0pdhYlS&&UbqC*Eje2)XABA(5(}K|H)$&fhT8?>JYWB3k#)p610~7
z_{`=2n0iM8O=Rq%o?ge#Sow-E%Eex@tjm{Dv3CbDH4^*XWfc?@Qm{ap2(Sjc<Ny<~
zm4vn|)ZnBWkw8BDXyKm)ipj@6iwIIs5p4@3$rvO2SaRP*vu=OH<a>V)@lBI|mn8jJ
zoot4%9-`Ji0bAQjng1jC_Oct(^YLht6e26IlqFzucwRMxu_#t47RArUDh>r?)AiDw
z&(BYS_=HoQ@az5w1o>iw_63~YJ)1HVJhjmH61$?aM2#d_(eLtL3=YAD4}SUbB}<RJ
zP+O!1Y@dFRInzHu*;}x|KmXoYV3M(Z1}I4s5aTOZpb37N=~bu&6go~4%#iVv+hCgd
zXN7n|gko~G3s+XGI}FEKrPjI{6`kt-+y?8@0yIV$qVG`hi74JN&~x05nT1j?o=T!B
zcV9}<k_|;@VZgOfHoC-*0y~;R+RQnSsI?P-4q3ckY?v^Xq^(c*>0L*&))(2$gnQ%h
zXD^Wypuk_sz4F>Enp6Kma<K-d)KMr=*$WsfcndfI58`i?xphp3?!4MzlXuR(H{(Vo
z3M!|dF!?J~=Y{e5tHPQ0vvVGW!iFUt1Ab0=9^Ia#mw6I2g~}#P-4{PIcQ*PcX}<`y
z17miVoXv!r7Z^5c90DQd`1SffoQ27_lYC7fmBJ3q^HV4ei!%x6ni>_*g?pPTbFMj*
z-r%Y11PFRz<NXk$MYx8GNg$=mt%1%z3s?dT*k!smYv8>)q5x%|f~?f`n{LeqH)t`7
zHnU1B_MUmj%jc*Bm6DRG;9T*@blB#3-2lj>PJ0U0EUR&zYGx<fQF86}93W<^U=?EE
zOs=T=f?k~pC2xjruf{32-&24BXQD$=<!1=j+gMB{F#y@PjdJ?*r#u=+NfkY1W#zj2
zBPB~*LiGtykWMzEL(dUi0o*D6Z2SV~AM#Q(U?%Bw`ZTF{4tgI0EzHOoz|&<ch&3sc
z9OVGTZ*4MN^RA#4>qmt&^GpY0L{Yy;$Cg2ZWhg)wN%et3w(`f(I)(K=&UTrVcqkr0
z*eGd*kbp=m%y1?F+s%W&XsFg-;Xf_ntyBOfYvEGIXn+@U^XEAQ=nqSyk*vmd;mlJb
zwwZFJg(dTiLk&nD*&Ux<BR?a$xxaex@Ba&s)p*|a_MOKeI=L@{Mq1FrbqInP`o!UV
z!V-f`6<GwU8)%NmMxgHEyI_@v{o<W*PQb@N=?R=V<(q_M0Arxh?F4<K)ZrWyG@n49
z-xq*=V*pTK1Xy8{-0WgsqXY^j0|xiH;k>LY5({8_4CtaulMJts5<4otu;y@ZotN5v
z;h?V&DDb9k8tP3zJO{JW(RF|<r%Pt7(|~uRee|z?aD9Cwk;vr_o<NHf1WC{uw-Lkd
ztbT#@4zodbC5lEb&-SKl0J-Qr1|}g2IQVM5O=g@@^SxwA9{>)G2aZcG%%~25t{qYX
z-)A)*!Dy4mCy&B&LZ^{rs5PLG88kvsV?vI|!Kb@7Kt5P@&^LeOCz=BSEjr(YY6nZ+
z%$;+dBn{|<?8X1o17+o`bgnHflU#@D8+`t^#3?AARPVI`q?2dE0qcK&rPQ`D9now<
z@)nBww;71`lGiFHE=7yu$_J=%S^Ax}%3NPlDulB+Us?&fW6=Rzoyx>=H|juEC=A3k
zTCj}HRXsbUmF;I?*4B_REOz!AoS9S+9tybQ2MayU>ILZh*Edhxqw)W*tClUOdhcuX
zwP%Mle$HjM`JUnY>IMeOyl7zm#crT|7{`DiwvSKf&&2a`Va*`Nb5Jg3=@%Wk10?~k
zxG@(*Xu|{#ax;3Z^AWE_<|QwCcXkFjHa4~u&;Zrul|K21B`{5gg21d}y<B|=oLI88
zi%aV`qtpYJF1tp!5cy}h0KE$C!SxZ0Hd(VE!hp#Er);$hPFSZAJZJ12T!ULA2QVts
zF#z;a8bF8q1e|Lmu|f;@Amg*cHWtF~fhxR~ot~1wqJs2_a6nH3OYZ}4+&lfzL3pT4
z+idy<7)i_9=$&n4BRp3L!~DOTYy;ioM5<|2IB+ELxYAr$7CO_NxD%nt%zVj}D;rBw
z>|m%S;MrZ|kO`lh#TgxthBpAj3zWm!np?<gU@4o~i;d(z+$`Y(W|`&r6Jgt%RA&JJ
z0kSo4y}5aJ65zCX^Or2qULk@D?9=Cz`!|_cM2m46K;<uhHLS*R8A{~Vd;gi{F$7pR
zLKhIlEkU5-6Uy)XuX@J*8SN-`Van7@k|Ntb6RO?2$@9}QpphE3ymSMCa<mOdmX^@@
z;o{c!@52HCrcdAW%n81WK+ybL#ex{qQGx#czbQ*oEiLOm7NnBHH;RjLNo~N8`{-5C
zbhl$?i>f!!*Vl)l|MUkGEV$4VgRihDGIx&#veq808nQ5^mXn@BZ`N@2ki;<j^{9jd
zC$3{5B5Fv?0l7`J$kAMDM15W-NAKJQNf@}0M7|7){{YB!hQRs`=%e=|d(Op}R`2ld
z+5JOb%#u*!fiv(TmNjW;F3J{VuS9dlU>K&zMN`1>&1-l3xITZHyu&FAAg1R3mbg*&
z!1y>YBS(gZ_XsGtg!uxT$K@AErRecItRB*3zjSI1^Cxrtj8)(sw+`I<3PAKvFBh$g
zxeKMmwNFyVXk4EPNT=>b-zn0qxxO^dMNq^CjzCU&^`*)#R=ociTM8QZr1*3zmou9T
z>FsPCGEdAdwBEVyHCFY5_Z!l&`p%b|fK~-h6>@W4L?`?uixIsOku;&rwG%mDS7f+9
zXs$kDV<|dUFM9hncQ;}{4VVm%uNML*WiE7)v{vc6tNz22{d(KL*W=H?g6N+EedYlF
z{rjV2LlNYx3IpUVbYx^?;_z-eM@PqX5J^{HSLFGyRD*G~qao4~<L;ToUaziG16zo{
zZT{nia`SotUw}ITLQA8huK#n~JnScz9!o>HTNUnX!fJ%BR<A8r2EGX8Wc6`@r(Vxu
zW5ZF7?1%0Mluscin*SVWu_-h~gnrm7FnQ8XgKH@RENYMX_|E~iZu3&J;6Tm68F+g)
zC))zGl4Xn;3>oJY>OZh&cg3jU^TboFJx!pgh0Y&Qo4il~cFp`QBk*uLF5?E8p9BnF
z2780C^AWT}4t4BM8_-L>*<7PZ$+bDsu>-})17<0gDxT(xX*{F;05n-fB&aMZ=XYXs
zWHZpuhnP&JJac8`DsVLZR0FdR;30c~4H6>aie{rMW@{JEOFD2b4WMAVB__dKiUT&`
zsy2Xr7hDB}y=LntCWYV%@9m9_9oNgZKmH>K#OoRZ5KqM+9IlirP5?b}A^_Hg0a`GN
z%Lj5)fUZUOat^S{qZ4%2#{?ETT7qa0g8b3*(5FwIUIHSgiP|vX%cg^|F#T`e{xJj?
z31~GlBiw!_&ozYerhLU~Z#sa<)`f$;9<?KamlxVkDLO?80LTRnK=cx^d}2R$f953c
z_5WC+AAk5x1f%7?Qc3B@sMK&t{3Y+Ps$ty_E>`NLE4hXj+f*qC0&>vw{u%V2yc&uO
zP#^?g{Cx$2)lUOZenve3%stedyHk`2@#wR&(Ej~d3pSD6>z=%{l36-)oWW8{^V+_i
z?p0b&HG$Op=A2f9wP^v67KKG~)=YrcSGFI_cI9@8w3$8E$J)31(E|V#(f5HHFbSMA
z-Bx%n`nLH8*W!?o0or+qUap~(hfgD4_h?zzWu)h{EKUdh7z!P^wzh|7>>^;KzG@ZR
z?JFp>w+b$*H5IinwbKliVF}=eRwc0X4kY5^NghC}M<kxTG`|jdfTDt;V%x>h&15X_
zz!O~FKe)Z)?AtW=f0g&<QB7X|-e@c;wF=Z)MMOZ$R8&MjjEvD*2g;;OVa9<$hJXSg
zKnTIoN?Q;VP-Iq7h6D&R5;9;>FpMgMDI`G&1Og#I41t7@_et#UtaI;O?^@@*>#X;j
z_ul-Wi#*S>v-kc^pYQjx_p>|6n*!X<=pwDt*n5GBm&)yPZbJkSKU5STb|sR3*m?8S
z{2oKu%U`OEfx1_h?i^rokRy39IO3`oA3!Sz9=%OCKXE344AcxJ`z?7^zF7eC!5+sL
z(12+hanBlWhS`l_UWA5?ZTX<<5@<zD0Ph~^v)oSdzr$6KG0B(1b^&fY5O66rae&=A
z`pW2yp9cXQ3XMxjN}2{>VsTHv=A^%;r)Lu2injr9|7IIdyr4b+mZ=#LmVWBV(6IDt
zkPRQ;jpkqfxhFblj~akH_UJn<0M*{R*1B_VwKF&T3w7Q;;Z`nyD&L-0b82EZY=!ez
zQ+Uv;;)|+EZ!PdQfla$?Ai;mc1k5a$UIr8<s$~IUw8w~?7;=igcOGDO7Gnn;z>?Md
zp#TQ;E3!teLZb4@i|DJ)vB|DiIv*U(u^##==KZA0i4nE-es)<wM5t~^t`8g74jbSv
zE6f3GGX#(X9dO}~{stV^vonXjWdO(^cNJia{bgX`IZz%<@~z>o16ZkfZ8Ak=`$-@(
zPu=5q`kDxEB%;t00GV|hW&}uUZ{We!pT^D^){20h^-~VLwERY<D>q+#S>*uQDHGj)
z^=HWI4#2<Cem|;1|Iq;0-S*8d811=m+rbaDRv=mnCCjk~u2&!4@Z3eWuNQtn-dh@3
zM%mJS_ti1`g>Rw))V@G^?>uwn?E^d?Jiqfp`_4(}SR4Pe=KvmHYqFyqW9z@Y^!0DL
z^;^F_RIq#ZmfYN98P9$_^vz%2XlMSKlKd=L`A3BxO?F>A8~A!R_~6eP`?nrc`&L!+
zOn}mkt>1n7-A_O5dz-Mz&cs-i-*i+);dvZRn^=-W<hVhpC^~s_I_5=gq%VpN0-XSD
zG3r?+aNa02{3?7wb#hbPb$RFLA)5_fA#be%yxH=+VL;+Tj%Tp<(PeKJQ-9kjh2=l>
zvAkSVq(I$r>i&(ENbV@iTb159p-~6_Lr4K`x(XqO$lt=0o&&6Ek$v%eD?#=@NL%;I
zmf-ycTLAtSSlx1I#}|2C_~pwwmJ`lj$yP&wk{^8c<wZ{adzyfG$0#(uu&B4dk9%<|
zYp@X&tA@4m9$qclvs6Pgq)M<CT{CMI;rCm$DmO6+b^=l;Z=y}MCmeL)TzgwHsVyN8
zK5oKhMkj~|sBCOWCFA}>qU`dS)k)u@-WW&~W7HwF4GPV5<f*WRI0EYYO1%8}@4l~j
zs0ww;k59A}RB<$^bq+QvU2f&}Je2|)bdVrj4~vNWJjwyjFpOpG)h_OcWAjc?je4z;
z&Stw2q)is(_+}g<>KgO&dZruhaX)&oce$iG0#Xtyvz6q!Z<qR+PQB^=Zp7O0=s(O>
z-Hj^yi{lp!unTgl+Hbyvw_zO>wDHVsIDz6YB;T}s>M-yn{YFqC<w%%s>>jwhC5KDx
zmT1f1PH(7Z*eW01aU@J`jN1B>MPx)@`hZVhbz5J$^!CFhSx1u}>;ZmQJ-8EBsqBBP
zh&#wvah0pX=x<vId|@z`>G;uxio~>OUccAoDs?V0LlLl|sk8Vmvl>QwrarngqC)cu
z@rG!PL2ae}PAzfg!J?L%u=!hCXqY`1Z?hdSTK@D9+df`RO#xy`_N(n8y-8nnUKI&T
zY5oT6ca!^>v!3b^94UCofu+D@It)sGWO!h>pXuIGmDDsI{|9>!<L6c6ESYXceHl*R
zHr_bCUNo(DnCFX8bPIMzR7H4ej0M=GreXM4J_eo7&<g!gww)0ae(Nj7n^CtSQ{uf>
zD6AIj@m?m=ga`>u_TtBe3Q90H_R-%SK)MJJX%RAuNX9v|_e5EhCoHs^4eWo(u(EnV
zL5qX<)>N)4UA}zFzaTkxIxbeA!X=-X2u(x_-f>D5hVolVF`BWQKJl=3QSGeX%woPT
zGU5G2h|83Ruk6KUXTI`##BQJ-Rm2G34qq|o3e<wOhKSn@#Zl!hGSfue?y6B&kXzP;
zpV}>LR4SV7yLf&9+OjdUU*8ee#rCDH&c*e-(vusmI_+9ogzOq9`Qh&WyCE*TvP73F
z`#AlmBD=x$D@M~&-m3rivVMTBo^Vh3$Mp9S!sZE~ydz-~s6XURFnL*~5Ajs%@+q<V
z2(F&dAHFVo1{9EXw`r+AZyBaamCr%#^4EZdTboX`8CJ<P^lHa$;K_?YokD*Pxdyf0
z)dp0~X&_yTP@yMlBKcm|`QaH}5A{a*6kTD+GAj9i?CbXJhX7^3Y1Ixhw)~^3L1}Uw
z_}}bc{uA7s%txjF-OTY*;@@pIP#6M%_IH1zT4N2<A_A1S6*gX6?-*@RPfQfN?L4@y
z)5hPoaaJ$+_P0y*2g&}D(RMSQ%`Iy{o@;3wq$>UOR~ycPXXn9NYIo_ol~iW<#At_w
zN5U@%DCfanRiOcWnyRMeQHQsL(wix5IRE`m_JP_%>2;hMe?;O%4YSvo7W1@e=;AEX
zh}2vrrGvC@&2!#%G)MAgX+_Pme#5T?swk2*c;c1^JasFf-Q?>y&kU(KQR(9XM~ynI
zKve*FG>wop&eErj>mSG8YejPX(U@`@DLpMhVe-C4JjZ}84kXvlo*I6A(SPYfjcCan
zxUzq@s;AsN{CA5W{|N&AUuj~V_JCSPeFVr#rsh=;zzE^a0u*(?Jrf&oJK5YDTkcwd
zt-;mQ#6lyhH3_F+@*8i|!rm)||1ePHmz2zwx(K`nmp@V=?!kt6(H?@@Ic_Fa-wnzB
zpet+i!~yrEntLUj_Ky+NqZnRZ2D%)ljL1#6F8KS7NZ#57dmtQixl3U)%fXnE%3?oM
zlxRZB%^zwVFIv;WT7t)Fu7$z7I9yY+VrD>_{LOJ!_sE<;>9~})@qlyO;VUMyX3>vW
zZt+x9kY~;u*4dz25`EtVAnytXh9t$Zek40M06&wNuLh|eH|NJevmX-NgoO;LeRdkg
zuqilb@dI9VTf3eP;1a~W>5yB=Q(B%YYbeD^Gvp>JB5I%Pa;-r)U_S-zA*NGd%C|P|
z>Sp3BFIA7Vws_vYn7X)wIsoof|EeXQ!Hi1wlHXqmMA=9voE1ZOG2X&jd!%6HXTd%b
zEvzCn1tM>WTkh}gHr!q#A5%d_GGf!_3O&-orV<}cS)R(ZvUyji&}SVfs5YdzU>mU2
z3PYlG&Y#p)g(2C@eHjuj0^KhDgVSV}ffi?VF<m6D9EL<SdCN#BbG)7ldwFJc<qk*I
zm-aID4`F=a-MnQi#xz)y`68h&W}|IT%;dC-=Zj6Or5Dg<t|{_6Ps^}@FZKN3@_Xt<
z>`owDWkS2mJnxBnL)kI?+o;i)$j6LgHxwQ}*4XbxW#Vjw^5^h@X?NFY-q!V^Ghzk7
zU~mSnQWNUyZ(S*B;4E=oC|0hgI2>olJ!klJnO>+s5m*K~nayJaz$2(7&;grEMMVy)
zA5pY+$(JY^07TLCpW#x@Z=4xwuEo-}E<ZnF4WK?xIFI#IPa}f`WqL=yMBJ@}owul;
zV^65Umki~88x;Ot)-BKp_x}<&_`hO_@_zmYa4k*w_NLhVR{ztN0|&$8E-d`V)C0pw
zs3w%=J$WOyZvJc3&Z+ocg-fk5@`-Fe-0-VB=>0!YbmcjEN^alWXO8&5jM5#k1FuEp
z^3JQJmd`{VIWs_5xJN7(bpbx!HM>NbRErlpQ}?{Vc8~On*%N-C+$}RCT9QO67hyT3
zX%SnmYLD78&v>-vx@T&<oXJxdQ5gM0(^vB9S%F7#7<LZ^@XK3g?@&vQ<Nw??I-)Z~
z3V467)?mX+a4s$4`WDS0R<H)hJ;ZMd?*SEsZ9C;DiT`XefE+FqU4w7h3FboQK~0+D
z0egAzfC-GwX5cLNYc~>R4fK!UbIq19e4|hvDI;XX^si*qeY`b{wiD^RzV&3)d11XC
zX=xSFEFPb4cJ0!g41^u@hkpPwaN17hf$xdE^o$<Ts47#!$S36OYzN&{j>`=DZo3Wa
zclOS>k#ZHM$aAOLY}=6?X9S>A1Q{esnx5y?%AyKd%3{;%B6-hfphu@UjkFk1wkBD2
zVJ}bI66=qoKcijUV=+zB`q0Nimz-}gMnF+(g)$Vi-6WtL847oVe@Zr!i|FN!b3P~M
zJ1rt%=$A-G!F>)(ub`Yc%i^SSem5PkCR>Cg$R&O?@9sBo<W~GhOyad{$SX7y?rA1Q
zJj!(|sqni@fBEM~8b;9-x@$-ddfLlQxVDRb%Ud4AYV@3Dqa6OGW59vizT{1Z)uOiX
z?rp9g;x`|Q-{9og6n`t%p`KH&?MPAYT8~`@w?NHEDb5J+o7bPnkss*P?@s}2XgY<m
z%kVvAY7<JS8{1iHee2&}O$+X%JvwL^8I;J^?P?xK&(y4t>t3?MwTfh6is{si+=Ixj
z-nC7;3_3h0@k_hMXqUI}7JjEL*0M$mf;){OrN7X*)X2Vr$iXx66bKal4gc#nGMrMU
z;>Nb`DhH2c3k|8NnAHAW<n+JYVkhkJt;}?fEXd%!WQ~$IAE_5Hd-AI$QEOS|5KmO>
zzwf6n3VzdaKH8x<BF<01;=B%x6d<V4Se0Eva*y0zX6)MDcF-S_l$1d8<3`luzl>t9
zM^7?hxMmy5M>bo@N;iN(Wd?^@Cn*icv!2mLKtNg}0kq#OKHrZuW6Q%_xL2wnUM^>l
zdyw^30=R}jZ+i#q%>X_Zg5CofZ#p$_{0mY|-t868-u6QDKCg@C>#8lk=SE{zS{1QW
zLOU{Xb9EU46)Q(=KH|)BdUe?n$~Ot}mPZ@izgtR*_SabIPni5B6tGI>(bIB#eRa@_
zwNEM69qo(q&we+0UiNY*5J>seFYZg4@yYC1ckkd(&G59lWnJXqFYm@wzOK84cgKBv
z5r%GW3!di6AE@;?x+6}7_54dj0oB@{+eUz@xXNcMInaysPrDx5{*{<3HJ$HpE_X-N
zIASxbe&hR@mc+^%I#v8sff0#K!r=$M8BkqXL?pt0X?lTwF8XktCLhXh!QqyhYpon^
zwbex6cQZD4kt^Iyu*@OMtr0j6(!%6<f=A?CuUE)i&PcGPzZbDWG{WJ8GS6rQr)N}b
z0@jfv_+0R~r77W@prYV((gnc`r-_>BhE!bGE$hSnr+^-p6swWT6K*v{KN-Ivbf9*W
zO_6Qh5^_INKQ4CV|27reZza@raOaZ(Dz?kIm3;d^XxiP>zI3$J$Hl5K*xt>LdNUJc
zlzpmTAaS?PzADtDzNbd^A4K1Ve@M2L3tsyqU`*n?W&Q1#)+<&4K^r`<F<UXXGcvUP
z2N6DxU4u(%PLT9QXR1B7l=bVXOnZ!q)p%+ZGZ${><}C|=`#+ja`CDD8X7{C&5pOi)
zGo=3aW#kg6E}=6fF+6)G*0>H8M0la#e{0dkbc(OyJpXInvIIIf^iAQ=iO8=Hnw?P^
z&a9^P0hs+j8wo%2?Ti*}21)lX-g)*bkXXZ$9{%2;s?G>%xsSeeNlNnr5=6b>Q8W7I
zpU$0n3``URPy_KKr%!=O|Jufl9wq}R3!vzXLN%TRfPkp)^=s;J=a%a^V+tdL!FGX1
zIvS%XZ=*&}oI$>!7ENxTjC4FD4QIS*6LoV#K*@dcEY1{+bai?~58W64=9&5yi)WOP
zr!;i+pX$9$4*L{~TV^jjCO`ct6<xh~QSh8Yh9VY@3h&c<H=V=^j8r#tRI)j*hIGTi
zhER}Hj)*l|Vk^!?#M`)_o>D^ls1{|E&<nWCdmp#Bfgy?Bz<Nv17^7%J-=Z~lv;l$4
zb`$pOh~s&~EU(XB(`bYJAw><h0L!c3Z~Ey?>p!7ElV$W57T0>Nr8WVJMfcHr@<&m9
zO<Y==@VOpYb!XhQWyhKb<|9KGd8{sNG0<Uww2EKljz!zUgT7)oTzl&l=v0$|C6Prf
z97Rm#E)R6oCO%;}CNWk3MhQv~(ks9iOba%|8gJE1r^xD<SAlEXIoQ|1U{5Y;c_jaB
zT;iuI%+bzF#QeGzz7~r5^v)meMC4bCr;!mG;55VnomS0UT0Gyf1ypqo+}2ZsA4x-p
zyoXi&sj@j?gy<_j?h~Wl{@ulijn|})RGdeQdf2B4fAslWDOrl2J>_u@uwArqHGImu
zKG;>OrlyKP3-DZvvPyW8G@OmD+$7?C;b|PM!`~BQsK2Do5^UjK*`Uu)Q35}rH-`B*
zenYh0C=W5|Zve+F6g;FUPRzd6qkR`1B*yS+Y)+yQ-LtuSi+$G8fBM&2fRTXdMK_1l
z&jhsKl^$}xbbu4$(0slEA1L^1RqCBo)8zZ5L|b(ZaF%x*K6Owtd#!BBM16Wk3kRx`
zh_-R!XL{FoH!ybjKHQ~o&Iiu&U^K#wS$K3v78={jz(e0K3Y1)fwZ&6<M<b<W6u&oM
z{QT$GLl=+7Z?tk~1^*Na!lTYrPtuLw!Ag-Av$0^C2K>gi{cTSu7{(yhsrTuZqTO$R
zcj;N--i$ij#H?EMpts?@;pLo)x#a=y4)_4h=CW_yeMh-lfIGCeofc!993y2G3`*_&
z#}Qr#^*b7uS+z)GeY#c-y=cTI1ou_ScIp99BX~Ah_>x0*b@KkW{trG4JYX_u4HV)m
zZnx*lZURmG_H=d9x+)<|+(D1Vq`K-ukwG&>K1ElEw`N+|P<@9lzjtg9kN_Ae%+D~Y
zT7(j@_^NSBQ(ir14|OM|p=^Lyk#Gk7=HDVDAa|$7Y7pXhU3xTQL}#Kp!NvVcb>?8!
zVdxTLwnW7wvL~wxS3EbhL+)y7!+~eY2hzy|Afo0ie@GTS%Ujmo&XGsEt1kPGOwz4Q
z87-{QK+~zxM+XatAew^Wzq?9|3nIWMb^M@CuzyszxOZ*#&OZU`d%)L0PMg}qQtA-B
z={z!P)Hk@3EpNBIUTN=Azn=$J*)D?^AGEQuiW{Q)Nrrptz)JsyZ8DRE-nj?Gm*M>}
zi3!=(@l0pb(}dYx0#x~5x75avCmxD!3YzEEG5|P()$~I>w|GkVhLLKN$Iqq)|NDN@
zsnFEs2Ah$9`MYd4ry9qqRd+Phx<%A}1|=6q_yJ%ZdX`^s*ySx;>Y^SNDW4vXJ59Ud
zg1KJry1s<}6L;}%$3tP<qed^~xla2?Eg<Vy>dyRd=2FI+W_egRaXfAG*~dRPyQzGv
z*l=>{3z+{pZ0}M;<)XVJMv(2$9N@vBhy62<yC--ueNn`)-O9Bl*Vd^$7;+8iH2WV=
zmJ`2~km|<tux?1`b?A-v6O>bfXO@=b{X6yhVFiW@R;#kur3k=8FQ^pLOn<A%e|npv
z>^;3sEATnNEy1K=b5|dJTr6=5Hrs(lRIl8SKY!xJi=%P83D)%xC!Df>)WWZv-yK$|
z#DwW;`Q=+D08jw&p+{4qkr=3BB)huVKt5fh=7(Deh$1yISw!VjQ!~z5$VYzF)4ffR
zC&oItSt`!TXDs<#ZC0{Sl(&qovT^qHux_<T`lC$V#M(H3Xo_7?7X_<%><E7%9*+US
zdHddB`NUq$bFWwAE$V$-q+z|?ohpjG>DLoB#N{nmOs+ew+J?+=^n9M`<`nk$-Dbp~
zcxrnE@N;RWSOeWR>aYo(f&m~K0eN_~Th7;W7C3vU5==?8Cd4}Sr|e{a#(=ofpzC!W
zh5GK&Ym@ni{Vz2^pksd<xvKca?Acjs3P7Byomi!~$i|igf5ADblRFbCafX-AEk}Bq
zNK>(3H-F99DN}!^>doil7H6u<T{A=L5x{{I>GWodrPcCn4OH785LPC9QH*ues#0Xt
z$E4h?K=z}_%)v#}8+L?YP4j<CapE2Acm>I0keetRCc@Qn=H1SYmt_=o=+{hRA`^Vs
z8U*rqIo1C%x{EGJm*p4YSgv2pPEh-Ie1<+}%Apx{x=d8eA=+g?2nlv@UqNd0qI}Y?
zp7X@++_G@9Ubh46UhYPo2zbE@*K+bI{YRsIJMS|mc*cQZ_h3^`?nsi0`t;9f6Z_Fl
zf|@z*YtHSR3tt+F*;n_g@Jvlr65_psTx#i*gnyFX(?9=zCiVW;K*pPAx1X-is&01d
z!g>Bv`xa?W`ZE1|VI>*c<P=pqwD!E*pxZBb%Ie%zpC-mYn?s?ztSNtw^Dx;YU1iDW
zi?P+nhS~$FT9d7Y3STIb3*GzV*cPNMBM`>iP@CTlw9<RmqEUh`7uxmofD%;?*4u2X
z>|-GHsCUxkwgw5!aw2wZ_z@r$ntIS1p>LVcJyYStZ{AQ9ub4ey3wVyy)$)-s!cLY}
zw#GJY7Mc>bfZFfMI2Rn&&rbrOqOqGd1Vrk#v~bS15=X(>oiIl9WCAGM5$%HNkmc`e
zcO%bELL_!Gsh?PNaRk~@RpSfPia{qLzhbPnkwldoGl!%d#9%=sC%0hZdNcAiP`BcN
zJ-0N%lf8sBixV%uiU1AcTrireleC!LE9%m&d_F`nZL_j`G)%-K?kaaJip7>%&d*1h
zw~&Ujr4lrR*6)kV#AG-Cyk5Ir?J|0g7i6=^f+%{(Q7scf+^sR9w_l09G7yfk3_alj
zTmWR~PoNtgJn4(WUB`feu$VhiJTf31Cu^?6s}Oh;NoFoAqv%+K)DS%u2%P|Oct8|=
zql$1C7n4+H(O^NgofLo6^FDpBuAL;4Q}XWbmX3FJVcN_*Dc*u!&L9<Rh&e2mVB%In
zT0^<0Ne>$b@t|Wwxf~VjJt<i3x!N&1;#7HqfJ-TNM*{UwRVXuWK%R=-`u3~Wf@_fi
zBsGKzfp)n?Vw;cG%N^!b6u=T1mEcG(L?8831LO+y(w4T54)PE57X(wiu?_ns<dCa2
zV@KQw?r8pRUkFjffd5nJi2uYISt!8tUH!h;m-yrw<J(aiA_OL{!PbsRZV4=@ALaZ;
zwVxO9=KFi?35O;F%`<QrYA<J2an>>~wst^sj3r#{n?deb`Uxly#V1uJ+-?d?_9DAm
zSL1KVn>qt$mn22CB)$V10-Dt}^Q)8aBU{3GMoWgD2M9S|$mJq{Gm|;WGG!Wx*pV^1
z)^_q>>`TbkcVGC(j}H3p&td;33gmxE#t${02e%)#3<^r*{w=S%gZA}*15ghw92HCt
z21QN9_*Xfe{_OzNeZ*c4aAhvf*AfCnRf(24`v%#IZp4@PM$xNn0(k%e*nI@diX;-G
z9Ax@Q;syDMjxzg94*X89pShcg1*!wC)>V`v44Ny%+1JK;^@fZ!mj|>*XYZdzGsiY}
zmimqdXfeoP-*NnWB)8!-PT!z8<XwOnZb0shZ(Rn=uw8FSVmejs4%NEaFQ6iz<SPK$
z3U6vlxZZ?dC>`&RVD-)HXE*u=#ieqj0Rk1|12uipwV(|&0IB^2RiRGVJL@Hvn@UB0
z&efeyh!woN6IN^t5Ng0@GzJI=2wByw=drX<59?hr9N@&zpgJ{;-WPgOEipj(Kfzv5
zO}(fngE9X!zIyP}20+-jc7ey9eXOJ^0ktd-*SE+k0;B>JADx|y5CR?%_*@-~I*eOy
z3kV{h^4JSu^=z(sd1lEKVqAN%>~gZw8Gs(qDp1oxf6eArYx)wSMQf@UY2kqUfUFa`
z#|p{9f%Hfuz;o9C5c;ZUZJSbqioASPyG2H{qD-fdxXBF-YKtpdWl&kxXzdl*g>$A;
zsnxZeO;oUJi8o4K;%L86Cu5Ml%5{aD)ZqD?FEVlyRu&UE8DF|`7U+r?1JSA&RxR)e
zm(PFuKSA-vf77KO|J%&w$8g*t9VqBbgnr?s<($0`tFPq4@4YiG)9LmyZNRxPfFu#7
z@no2rU-e0{0g^AJxazV8pmEXvqEGkA=u<%S4n6<MR{y6K`+v#`od5S?sD!0OBsaTW
zbiWAo##&S1R3$2D+p65os-gj2wB-dJE%<};o=Q|U5o%NY-6AU)P;L<tAye7*n_tI`
z3?rbpDo5{`4WwhFv{jTSFr}*3*UKx$Z#4;Ffp&sas(RbpEg^^VVNP<V(2Gb)@U@Zq
zw==)~-L&$FV{4jeR9WmsFSTf<us^=!<jhH~4YCKSir)ta7Vl|#OFAbk<$2GrwQN~U
zndtYtE~A_Ee+kL%Y}b)hs`v4Q0vl-^XYb(pK#}=o1C`4jlw0VDeE>oe|0!esRNaxv
zb)5{3E_Dpx6apW9q0Y2rIPhYBx_@K0mr?7Va;My`*C;nq;bS%b`fe}aR4RJB_yNaU
zws3$lDE3yq9Ogh+*`q4NJNX0kq?rgI>4oL*$CwHXQ6x;QHdnx@*JyK(VT2jId`>3L
zuH0$!M6cF-n&7R8Ra)SC2!9;+{}?u_Bu(;^#?0kzUkpNx*C7IN&o6GSF<VfyPV{cy
z<rhUqEqI2~TUUhZDv<|Y76|56u(4IM1g*GnNDS+vI-1+z2E{GRzsrTh`ti`BXjwD(
zj~{wStIrkI)*?xm4q#*6WW;cZ^@u<D8NX(I==Xvdv&N|p4<(CB6sDx3SyO<Q_iWK)
zY-DcUh!nsl+&wP-^jCk|QsyQBjg|mglnMmFy#9w0t44k|_EcZkP4+bO7=GLEW5Bt`
zx_8-kd3*bAHxYYxDPb$3D>OamsLA{hC7(#m{%YGp4IeHCJ@2=E-HH&is7J+T(Xab0
zbK;?k6ZD6ch=IByIQz2yIhB`_`3}MZUW?@SU09Sqqbay27XibdOLyicN_{e-u{7VM
zF)VwuAKy4J@=hN^g!;G5*Jk>^tR&_7I{P;DwzA!Y8@=a8dVvN*T5(UE+}nf`wKr%2
zRbQ)tq~QW1!9!IGo5#^uMef?CPP8fF&uP-#<5jT>^rrbg999qDNupj8cCj~Vr2lA5
zRZXG)#rc6K|8oHOKh}a2)&U!T8nL1w*&W%ShNHP+Zsa+S#jx2ls;ZDnN2UQSjJp((
zXZ1YP)zOtbpCk@~in%o#sv`8td@rYTaGB}OZ2HS9^;0d!(cvr3;f1jEEo0B<HIglo
zpk<04#Qs><1L|D#LZG!M3jY3ZFQghjR+!+4J6`dq?c~%FCqs4#UnW`rE;U(Pb0k(l
zOG4How?<$Wt-Ab%OXt0kZeE7}0_U3x>itm76lqvbT@xkjrm4h-P)Zr$OykdMi{`O+
ze1=%a&8S_HhL!yj`>hOxPVEs4R@nQXDBB*Vu$GhYO0cqR9^maxJt(E3cdX!NeXI|m
zt-OP<N>UAFV7TB7Ll5_K`uMXp&unJjsqCHtLPqkIjkxScFEIukHtm0_1<K2-6lABw
zeBqBAEb1vG?1}xoNl)<ehlgJR>;3W$SYk{6je+R<Tz)g{^E-})U2$8jXplqXGW8>%
z*^nOdr+7EGyI@TZU1K``kxH8xksC6oLDQ2PAw4qjaAMUp({ujIDRdQku>K)Y*V4}I
zh()*?g+$$v=LpF_BAHfCq>%6`nEvpnZR@mCV>sbmJt!BT5^<vPIZ6NTF|yNN|3e?C
zKN6v7NOv3Fv4$WY-eLRooijiE@$J_RU#Gl2v_0?o{j+KcznuB4(eTH6%~yMBzu$e}
z+n+tY{^_9CmF*#C&s_fD?e}>HZfft|diKHBdRxD~w7)O-&>$BQOU0lfBixEG7UgAP
zt1zmlpNJ?S3ghR8DqB`t!sLb0|4{G#%Wv{HqMo)0s;bn^ny{h>^~}vEbG8vK63ISW
z(r9gs)}@uF2IA#(9izul%$g>(Qj)c;qut6o9fV!f^(=`k=|1a*ZNKfxBOR$Rs)b#a
zwx&a2=s<E<4{R6nS-<HhI``ML=*7c$?7-#+tj9X~<*#SN*%QseHk9pg`>3QWux>mw
zi)Zg4J#4USu1%pMA?PC%fBpFLS!u!6$r*69lA8XW_%O>0z9rdd@7@@5om!8V<g<<w
z@lKb_aiqKz3nZc&E-LY|%!=q0n?p`h$hxi91Z`8<J|;JazMLN}KpwKD_k8|%&UVrK
z?0S5DmwDrZ6))taEU`|jTh`I+L_LZ)n_x{z%}zv!I%ZvI#$GLj`1$CY8Y`URHyV}A
z;U6SOK88)T1si+i79O}-ZLLF@dE6zmzsyuQSrIupRUT}UAJM2$s?+NG%daPD7}#v9
z!#xr$AK%yd29&qwZ*Yi5C>=rbN$h@m{z&^Boy`0vi@@n4Hf8;)0j&ciHJ=8l@vUFO
zx+;32qpsjjm+|!~_#FmX?YUG!2|t&6nOA2zJl1sl`sc?xI1~0OuZA<qP`)MSTI|#a
z2cSY^kY&1KlSV1Lr?Sl|byyd-c;v!-mWw`}1je27D{9m#g?CqO86G!LTGBM<zmF;9
z?x&mRzADr?MV|QkcFc=3u*5}u$P<#3G@LT~PKS~pUB)VLh`g-=qFzrydhFg3_%9b|
z8CRgj{?CtRgk-5)DzGIzU{&nPtaRWf_LFg#slP&zMcd;FI&ZcpFF7VCOITasH9ern
z?ETf=j&!PdqhmZ=)!3`N&|+?p81K8nc`n&s?c%6ZJFJ<*Qm`#9SaHkQlkKBV=^B)5
z6ZgBRM{+9eodPCQ<RDzh@!WT@Jh3TUoAS}Xe+OosX&+TOrt)GBtc(3lhlyF0{FEiu
zZ;kjRadnl0^lR>9zm{DM)`>sYtthc9v&vKqTuRh>kagNOtGX+?Z8uyquUbK0i$^7r
zp}e}*)m`}1Mx;me+z&RC>o^!prf6>x9{^GSm-z%QX0w6}*iK|piVMkRvk)dQoJWok
ziun??-tWY3bW~m8hGI~psxd|}&S?%a75#x~9y8v&lB;Kqg`&xe=dvd(C{tM*Noid`
z;^^lMJzTzc#AZGR+9DTMb_Anf!~o|wp84KldI;3^q3Z)Mez==DVy@!eafdyn+Vz6I
z&&t}}i%u(Jn1zn=#kuSDNM)+lALRS2+TDTk(kn@{7`o4a)ZqCMwx9L01yf8^$tBz2
z*p<(iiCpKbHa9cd#0z;{O|UEDe_eqJ3{wCBimOVl;kw*Tge8i!_Cp?;+^YRWf#Bfq
zU8zVCJ|vb{<muQbzUVzTpKA>XoD8AEZ)<o73h}3G6JuTce8Ucu((_&Pvx#6{C&41m
z8tuuJSwsx#70J&{`ogmh{5IrzOk$H$_IZ((|3ftAdz8=fkb$QNSF!cYzhm7|ppU7h
zryoV`GH5XJ9#K>`YY24u<tL^Ql0BS&-|z6rv>&fu3VU7ABYJdJwaZn-ng0BRg=*mV
zTA>Gbq(st`p+K<Z@8@=IVLXpdEWZ4(%}N(MVK`1uu0H2T^c`GVC?h1a=^2mr0am*}
zj0dx+l<@T)JbNf6T!T@S{Ao9Jm7nd?P?6C))`H>cbrC#a=*nr*F|38B1^MhcxvCjm
zF-_{FUBq&)&9mu8rZY&kE9*IVQ5`<ntly~vDvwEFc29x1XluUFm|@KO^tcAoY!p`6
ze?Cvo1~~Sivq)#aaV5_k*_b%I41Zsyw>)-frI*9@?-@QALT`#!uD;<&KWWouj*IxN
zlwRnf-^VCGMEez0K{x;Y%eZ~#{57PrH2*w2U<)aa#Y57-c2Nbp1BJTl0C9srP%CvC
z5Pz@0e_{s2{%vCUe0;O~aNwdljNE*-h=*xLCw|g2%msduJD&00qLaYAVWCS=LekK=
zESlj^>!rchY_y)a!F0zm-;4Kt#j|VVd_n$e_KX@KB8%nb3lFkwf-6^t{a-o=Mny9E
z;sy9=qpJN1gj!8U+bEw%ab(tp_$zV!*O`}EX_3wmyKV<%%?IBC51-4LFbFgjdkd3<
zISa+7QB~tMt!LL2p)^Ezs}X;-gStAOn$rqvLiwdwK*%s=AZea=+Tl|JP3FJS<JG$w
z!PE2DOuLm9BGWgIr5`jqQvdj*4cKnw8Dmw=;I;>1u<%@_Q{Hr9NS1;@!)w1h)*S;d
z)>Gf%lM9(F4a>s8M~Yqy4L8AkqdB&p8oc=&Kp9}>f|I<yHbdZrl^ffV5957Y*iKkH
zj~YeipR`NQaEf=KALOsOXQeg|G2;tP**Mj#ihY{<FOM$Tj2*yXFXZ^frs}MRZtuFC
za(J4NMH${4e>=Qi!y?*AwKOEL(~~Xu`ycZP$(*}lfEcae)%!wh9t%#F=-nGA&cR6{
z$|kNQw!wW;5Lx@FVM`ea2QRJ6Rx!@Ja?I~!ho~KtrXk6+5+EuCcSC<Sa>xr@&)K!z
zc;sxs$S|Bz88-Mj7|fzJl^J^p3-R}aGw=ayTd)7HdHHsaqrSei^KEp^OY8U{OupHL
z5!<NP*rW!!{R$-q{?wh?xNLqTQ11eoxihP<_|>lRdpZ~O*B|cs?wv)1IG87zfIY85
z4nyu<%={6V<hD4h-AyI=aidG;+FDO!zYZ>hJ6xcpUr_}-hiArI)h@ET)bEj0!EX<s
zO2G+%<oqH<<zZMd;=_J3jY%$~fARSU-_$nI&ks0NwHrBjUQMG!HMoi2`J5g$54bo~
z!|Px=pF^^}-neKESLgN37ef(w<f<?r7R2K5SEb=@ylAf~#O|O!-vhocqq<ZRcPZ+Y
zrEf9T^AmseWSWCC<(h<lq?5Bv?X%R$Bw^o(KDJ)}WEGh-#XF*0Z~tA%?O`)DnCS)I
zp_W}i=4Ds3?w@iA>a;5B>p$N9eA!$t<xUC`@I4U<gzV1QUY!AlsL<{+JtT&WIBVi`
zU=USzEaA9yTvxt(ht6_5%x!gt0hkcFQY;-drpH}(27%N%ZGS%NDmdPD3RgX!<05oW
zFQMOu3LOrV!uu;}aglyP0={P>&^J0XxoPmtHl(&U^V`T_XJVQOEWOx+i-`Z_*QA(k
zs4qC{;3HO}jux)FsDxUOXFPBI`41gt-z>0o-2kjufo=)CE$Z7P+MG!zAMU(}U2zCL
z;N!(@STI#;E;wm3RdvH;JT`s2CQ_|2-d^3H!OdyHofp)7titVNNaCq10yt&M-D|@k
z$t~ECH)m}bepHk#uo6f+yOaIUZG97(3VB@b&Ut0P9zAOi<}=)|7o2THkSq?Ir;R)X
zz(V%iRD<^lCqT5Hd$%xQTsT7qB32Q(>INXDNBEalOR}o}q+$y6E_AtzeIBsNfB@yN
zQjFP{k_D*7+sYcnS+_`LDFK{MInP;ZetFs0*y9CH$$S6+>Z*N~+zWYBQR2dl4(*8L
zY+bAkv1kJgb^@yQZzv=F;Gjmm;Akzj(S5dYIX(`z(c)4w*iqF1;#u`SJ=XwVdNFsX
z!{qTPn}LC0VHr61bNi|twq7-;DQG$NwlV-MtnCtG?fmGS=8gU40>^w3nD>Z~px-cK
z1jtOGs_FRgQCua*XBu~C6^OE;AVu={lMO@6O0NC;uJidL1)EctSO)EyC2Tyqx*^xE
zWX81F&xeb+kg_sD8U8tDug&)ZGELJ}g8^uvGx5qyy!}Asc)asPSR-tF4LH-{DofIt
z<15(0h%Y`T$Zy0(?Wyqm<YHv>j<qqm=@-lTUgG;(P5)ECwuA2tM7+ha<2AhA6ei^8
z0dDFrPBZWkph8iA3XQC86XV@b(7^SPn9%F_`-!dN?Bhz^xbY&dFn+?I^bECs&@#N-
zP+TvtTFbV7R57CUSINkejcV*lNpVGansFH5o>BuEx%=T7{PT~6#`G7V^Kgyk!AG8-
zqIscYtjSADp<`y>;XriRi>cWUgn_5!t}yH7j@WUNutZ1PD)HGz8-YOFyr;40N8h4z
z0IqD=T>`itHcG>*sW71s=rCZznWlD|^~&aE?KSU!4%fM%j6$B00#7)kGd#Kc6s7J+
zr=K$)6AE^kW`ZRJL1BpzgI6qJ=BK^Mnrkcen-FOWc9mRvcHO_C8-n<|d8Yc_T6zPA
za+7A9f3cSh+uao-#1O$T6T?+O_nfTTExA*-4G&(--FI7Aa+b>Iu!snAhrMRM4V41N
zAPKzkdTiQh)8;bZ?!D~ECL}OMp1So^7TjE65c=ccdm30q*kTujg#$3ZT5y(+D;4o6
zU0|3Na{Y6CXo+6hm{v(OW%x)Rrl6}}a~^x@_}eHIdyRaSw%TXmg8c|nGKP1bvISJ0
zGCacYEx#G*H~!baX>4J7vqowBo5bRMaC;-nc;fiM@d9`CWl!N2#`(f?sm~`4hVI>N
zL`xqi$0lT`xvbs~w@!T&|L5J~15e>^D}nFvGt{(~%GJ(}bk}Ua!}nne@^#Uk(*U}H
zhVXy&H5w%=`v=YeMyFD}x*l->XWpXk9jr$P<`f^lkQ*sdH~2HL=y}O-lse4f2XDw*
z(uoG$ezG4`@IHqXqwiGRjneHApDp9ArPpKRGaKB?4!qLkiYDGRr3eR}_Jth#!KS1y
zl*rh(yOityYBS-HaON%mvePj&;PlG*-`&P`2Hk831M&`F_F6Pb;JyDS0lv}}fU$<S
zh|uAUKsUhg`Ih(XT*YGXnr1hAdjj(J!%AN8xjMnRtx4M{w8OTGg)BliYLFQ0tx=Ng
z+5Z%&AAg}+F|VV+>=dGRcq_`366QS{3C-vR&efC(_HhVjyYWbg1tg2Ls<!K!i66Zo
zyCU`0|J*mu{YiCMEpTu4`{o-bd5;Iq(Yj)Sy6;_Fe8ig7Q4GALF@C8vY?U%5Y7+J3
zw2c`}omqcY%y+|6ylBQ2+S7}l%gcKmtxu;!-*D=NZydI@$*pF;(+&=AIqF+@PV7wj
zj*jEgZAsviR}YD{n|9s!`|$Kfg0k!UxT5MPNBa51VME;F4;KKBf)FqWj`0F3ey&@u
zEYrH6*Jk{S^tSM>K#Npe)8VxsCIHEdI0D!jdm}Hq`gs4-)aUWxj0Y=+Z+lW3zPkJ7
z`sfs1n^PTZa}P-{=rNzoiBT=7!NK@LvFZ4~)_-V1*=P3j<6dA>H<C;#P!}7W<E7`V
z+1QiqwAl3iZWjC9Q490>*ciAn-2|{H>&4}AuBJN{pHx(x;7E5%95(n@N7osI<NxGh
z`MUKSm&t3MT;|6sw6+dr0jaXc6GlElx#MYpKLhKW^);Z(f)6xH)D5)0&-Kh@zdJFa
z6Caf&exb7$d%fIa7cw14`h~Vp(~qNq%L&Tha^8wh)83MkqvdJ*D9!ONsG%k!#N)Uq
zKj#hx=QKFB&7+G=fbp$Tm37u54Zs6ldtq<b4F(M{MxpO!aDnUmr(QJnJ3MO$1$z^$
z0RV+~Uo6zDd@*baNE?AaJ#RGDn49fv?3EU5^`TwJlDbJYJ^)~O2hno+Xo2vTl^X{B
z8kWY>eM@P!n};dp29(YhJ2_K76lJq=a(?EM4E%L1ewao-W)`f#>mdUi^vgVIs{uGa
z9tg?qPIl|v^ztl%Aw}!On8uwu)tf(3#LmOzmWC7!XB&{OQJ{PGHrq{OihsG!fE0C@
z7?39k$s#-Cy^6`))&Er6ndH1#se>+I8D%9N3fwmz0l%HK$C>m?Qc#wb1F)dAF9-Jv
zS$EnR4W2oNisHOyQ9FQ0MHe9X7A)$Dyx9I<UJLqf-GOF{`>elowESZ(dW5K4GS95J
z6eT<yICHy3!&NZVr_p>42_PTHv^jG4dRu)=hW!dXXS9$oNdmQxk2cH#v|d|(s>%M^
z@y)f^tN~qfeag;ks~;$Jdxptm;pm7n8j*c(S8<w(;Y*{m<_E7@8;zg$68g>9pF>;y
zvj!7rMqU9IAH4&R5@b4Yvti9jR)0J?N6;zQV*?by9)z4~ho6ruacZJ3`(D*fd0f&m
zNjf&JVEV@!>$^F5U9GW~shQCh;i<6;4pFw<e8K$A#h!Zn+3oDl3aS&TAdj7!UEhN|
zwsq;o!?Mt}QEA(R+pa!N)oHyQDMqM{J<weh<jlusZ8#?C0nASFLzjU`qM(@!d*1uO
z`Uu6qwz!yu9kVD9w%Iy9h6W?lOyd;udnbz&P2-?l#XA0fu`z$rf^YdrXMYvTR<hYw
zXigH{QdY!SRyHGk^&g+qSiDSAo76bb-t&C%!K-LN3edeHz`;mWHubX^pmq!&z8`dT
z%=aM+t>20Os%u#r3-?zPorf<-*8Z>%>aUY@q}r7Etc~cbNWrQkAPaJ-)z&%NXYR?a
z2>aC;ju7Frf|M2f;&F^}UGwXy7C_3GXKRzss@GA~U+>V-H@iuWb?r7L>QbNy+$220
z3ZZ`6Dpept2MXF;8u<5?{FrCOsE+ILY#s8$`eE)gk*sy9tmZbi@F9z90A3Yezzsl(
zSoe2uLZWJPDfhBAe#$~T?_Ju6!1ZP7#>2BN2Co$CSY(ars0M!9p@mC=EOg#2)hy4v
z8KzAs$|9VcUQ^L&J*is;loeGw)m9Uk#uU3OpZhC`Xgx|#6jx0;)tg}B$f+cvarRN0
ze?+B`f{x)Oqz0svVL(~lvmmRR9~*sc8W)E4;EEsS0KqnYVvSQ6UbNe4VfoLTJLy-N
z2WlsBSq|D9tNYaoZc>!JmL{Z3@_9VbJ!Q%qLNT^nKzpR1#F=3DyCkM#-A2!0xQ5NM
z;wz4CC-pomtx3fuqeH_E!^IZQs=1l-+*<UY8bQBomwTjMtA)2>aAwgH6+vlDX>5m%
zRz$7TD3Coe3lJ&Utjw;V^~T)-K@;4@@mZ1*F~NT9yuax_dJ=O7)y66GrEGCe?baZ*
zNn%K|vd%)|zQ_UvLV<y)A>u&XJXX=J-yzTNbWK05y!U%+>@_V%&G(xm9j(WcaioVP
zrH!Y6QlC0kNUckB>JEQ*P2hw0+5T>8NcY0nZ4}`cg^w*M*O;_!IO{FAF}{V-_PjTS
zX`dIrPNZ$xa6vo+%SL!ici6KK4I`}&Y;IR<MEAmy9-I;Ua}lgKGy60V!|yc?R7Lf9
z#E4NylQ<<wbjk|Q-}bD>fyrP4|Fb+Enyj(O2msbS+7=g@B*P^+y6UH#w;#-~kCN(?
zRFAJqcEhPDx{|KnZ5Q)c@BE0VpG66tZe@_iaCjCleI{Jnda&+s!7hq0{id`96UDr=
zGO7c1RGS^Y6jhWXI0JD8_^wO7NQ{ZY$eZv6NzwInfsTrU+QvaM^_aqYIWM+y?hsSU
zc6}eIV}3f&^Dn%;)R+s3l-~6&Fz`n~jCD2D)e2Ps%f6fi4#00=m}1CiGfLmx&oBP;
z4mbhY?A6#LJ*Z|+yV+{yvbL*D99n+vBZgeQOaD2noGm_TuzdQucM-fzHRJT%Qv+SL
zL(;>ydj2&fO+aO>w|+t9j80r^P+lUHjY|zIH;5Ea<Q~Pq`K!#QKuWKmTk?zAu?b2@
z>uP&9_im20j<+H-_Q1wzl1Lof!1u~SA+re8N6=!8Zu^Anre+#bv&YUPVfC{PNBt^F
zJ23A~(SqH|CQR};C|P(vREn^t&%ak7KuW5YBkLErCr0eleCYO`*RPhp`rPKu^?mpe
z$GoRw)IZF=T`q`dfiP7A)($Z@!+pJ`UTSnVqHG*L-Ei}r8ouqvGP|KRj<aq!B1I{6
z%P4)jtHWCu<!)jrLm3?z1_&5@oznszzi&cQv};CNlK{_bQCVPH3@(!}tGXFMsbomG
z2${VFa|5$7pz(ohyFHE;fkqzV(Vp~|`T0`C?~DUmj6zQIfq0vt(krIzU1K512<_>K
zIq9Z$9&B~$mBGA2WZA9=o`&<{Ubh1BiL!o_+OGX7>fcXnCT6NnA`{(KKLh%;x<2YE
z!JEH(vhf2>t>;}*wO=Re!N2RXzPp$ll}c_gZ%4XPhX<4mTvQ$<9-YeFeY)icdfqrt
z%l)A>DwQl$e0N;K#fgh0qHJnAn0gwMur`UsBWU@qtmYSfNa2(1(@d9#C9!|r6}rQ%
zP7G=cID&t`Dta-CgSt%Zt+NHc=IHLa+e!#U3@wb3{HwZoCl6W8g|QVeE5Y0)Ve>#&
znKDi!plqL3jqmfgyBa3w73qQBDS%>YBj0O)K#wn5yDYD$amFr1rRu0$@<gsY&r!cb
zP0<jHbaz!_^8f&2a@n|h1j9ADXCST)MT$pADvooJ&fA}fO%;XVV(?gkz2t1C9{B8m
z7xSwCx6<ut;bDF(<?K7Y%l4qI_^|GH<1}eL%hX_i?yuXb7kEP83lv<W#uT*UWo8{w
zA`TlT9SOWQ78W!+HD(azh&G)Lf_3=0qz2tmPBIR3XP*{4nbYXZfvt?UR*f@kz9qgL
zIfrr(t^6kL=jYd@b4R8#VV5;Qqj!LJ$XumPG>>mi<iHQ+n(%KAL9<)bo3}@D>zB_r
z@9Ok5D_f|zlgkYoJT>PJ8?x`y!$(Lz?U+}eUJ4bPDhXRFevdVBjLOy-xRmz_51HP6
zT?NxkI7(@7iMVXmUxeY}UQA4eKYB&?|HZRQ$k9Rc&*tGqs+*;)*CbLu7&FFxOb=HS
zh_W6ksU(?xB=HGB$8Lz>s0P1m(AAOgxga1U^Z;9DHcs}OIQYOMIx6cGJ@DjW7!}Ld
zq-s!UF=t{P-5DGQXIU8pK4Mc0QtBgnukKq$WheefnK!ioLm(7!0_~#idc!V%BSfKM
z*~Hg|wu?nG3QSx6=uis40U4zwS`Ve<I0RLjTvo{#Sh=?gG)mnC?1;d!%4{=mNt?L_
zoV9745gyDxr#^_)=NuHj=s?Llm5^ClwiqJh<RPTs6dN$Aw?1Otq!9x1cM5+w(C59_
z@z4Nlf{f2fE$=;HZ3euOadUG?2Ldk3uyfx2o3u>G2O_GAo)*j6JdpB-PQ3m0l+My2
zV*>Y`v$uvXti@a#sh?)0HLs4P$K6ecElrpa=<b}~2C6!(KmfHLS*M1IKj=tLo!5X2
ziiMW85hW&PVsCdJ>N6X&m|qfk`YC2@T#OV)gb42jP}Z#K=2vMkhf)NIyqqAE<o)vb
zpeT5^1wq*RByu3Mmif?jF}J?)Tvp)&meGgAxuz)-59Lqbdj7p{5K)IxJiD0L)pn<L
zMGHg4dz5H-!#@mkC1^~0_tw$jmsS4oe_7!Opc_+Qk#5yrgIT~zy!ElXL}C|Ft@p^r
z)lM8_J$uhEBvSIK)!M-HOt4#510~@xtcCdkyt+xxW?k&evDOPLTd>*)&T?99j(i+s
zYKyaPHJ`LhfIxnvc$*~M7vgRE?eeTQ?&^?FUGtY#jVHZ+T#wA&_(i}M>xG9MNVCww
z*{-M%xuT$$bcA!0WbSvtS0ML7nR1VD9aday8UB(*AfLJQ7rusa6*l5xn(&AT06x?6
z>io}^)K%<YxbH`zK}xj#u6400Qd*p|+<IM=i<q7Uu4NrGe?Gy`L4WuO+4bTW`b31@
z+(+BRcQlgTROEFk!mYb~k(K~qLMYy*iT4rcEa9q1AkDHmk}XxFXt~jX%X?WGGh@W&
zEE8H%zMx*e=`DY`h`Q<!R22qp4QoQZ`Wx5{1Dp$C1gZ^ReO}cQN7Hd~^wby1cGlak
zoKs8mP5iDvZPy<f4_Fg9ubMUwO)zrcNhJ?ir7lB|NL8J6E@PFEgL_3jrW>mWovz7d
zx!V>$X7w1D8mIPsFS+c-90>eu&p1BL>lSBkxI~I8bV}?zIZx1uKx$Sdxiy|gY%`*0
z>92cbmFu=TbT9Oi=F28dED?4MzmxRX$40kcogdviT@GlhPCT;4x`OZ^YEKK#Dc+i{
z-=~-rrqz43Z}OaTv9zT3YU^EV1BDkjr<Kp4<Pt|DxLQ5%0eh+q!?o=97>THR!15z<
zcbaUf@0FvE(?)?$;HH76xO=HLqI;+Q)@eEDf+iPVGu_U6_oQfZYL2?vb9V@F*=?rq
za9}77+nwpX{UgI|>{{60i*{-i5r7x%vbA)3#JY2?TUb&$f*9R=UROA@!$6^6N)#KP
zrRoM@-nfJ+?Qfb=Z)~t8f$2|+^^C^~Sbc7-(GBqX!aB=FD(kjL8KzOdqU||266U;p
zCDvq)k8*a~ynU{_QIc?zvxKREW*D^1hIImmjI_nOtyU_Dwt#kB+YZR<5)$y~qReZg
zLRM9dC!(aNuFvWDuDE;rNgcA~4R8J}x9;>o{j#xRlmY$tOIc{O6(PBQQqQMpGrAGA
zBe|Kz`@nXNs1i2q4pe@g*d#@nHVf8sUY<1XH!ANH5#qX=YaFA3vLHN3A}&Ymg=Az1
zI1G*#xi(7CHNbW7)j!WeogYER!lS-5^c-4`^Xv}OH)zNgX8dS(TN*09cg}7L=!P2b
zwyZ}KL{{SA>6t4=wx0T*k<LL%n<Y8ZYU4|P`4I=~@=yS@mtOL`$hWnP$YJ43n0G2Y
zeX{HII0EP4Jt&9nt20ysg-2SBD}U=CfV3({Jxa;4Im|hz%I0+7yXj}?T0e$0NNP|P
zfw0l8vfj@dj<`&oy=T^^$2!vSpDYV(8AbIcJ2bL4g1T3>L(6(IBwac1=e&Zb<4IBM
z&;xB2x~q}1lEj28vMt!|TB2^C(!7@airB!IOTOFh;OR9zt7G&w@lnud#1;0`&IBpI
zcsm*nwJa9D15OEYCKbt-^46XJhIJZ1AqPw+U?v{LAGhpWlrMxilf}BGw#!Ge0mvmA
zpyjV;KdrgT*W1_XtOlJ(6PnACNDGscvrCFbFO2}b1cAJ*4h1f){H2o$<gq=oY6i>e
zF})1=V!%he7rO6F^nM~XYr90mw&X?e&&r?p|Jy&wlnwOIxWn<`7|?=j?6&6}f3ErI
H>aYI;v{ln7

literal 0
HcmV?d00001

diff --git a/reference/plot-2.png b/reference/plot-2.png
index 1611fd3e5de59fd7a8e44ac4c8e3586020636377..98e3360c37a2b655d7f9c380ff3035944aa74fef 100644
GIT binary patch
literal 59121
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%0A!1px`}L
zrq1c#KXxH>SP-yZ9CoXlP|vEVs;))W=Z>vAS?uHWuR&aNMT%loO2%J#1p_?Svln##
zz8C(J{PNKM_p-<hg0KD*@)-Z`*Z)7i`@^~RCF{+>JLUiUX^$T}p-NFX^WXmgr|aDE

literal 24961
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
D=YN7!

diff --git a/reference/plot-20.png b/reference/plot-20.png
new file mode 100644
index 0000000000000000000000000000000000000000..d0cc8ea45deb84a386fd4d7e9481aa8e2e4ccb4b
GIT binary patch
literal 27742
zcmeFZ2UJtp+c%m~N5)aGp(qNBdH_MBNCyEG5e|W%fPi!X>4NkULJ&t$s+`cPBE5H{
z!zeJJO7973q(d;22qAD!g7g0W?|tug*S%|f-}>&l>t!t`nRCwG`#H~k>hF1WUfo5h
zvi{EbI|6}V1=VhABM`rOBM|#7eme+X8IO6p0)HH|K&sw`KjFVk<ytKKap;NK12+VM
zD~R#$mxyoQA0ZHbAi&!<b-j}oC(%h(9vJ>@Eox^|6XM!Ur?i0J-?IVryOALW(k`Y&
z{=pgcF>LsynDuLb)64BU<>NXSXUpvoeY-CIm|ExW?Z4mpbpM9vfr}xBe-Syx9us2B
z@-#Bue@AApNN!SRM)y87C%15(N?VsJ+8o?8>8`5LI{KjsyRLAEN#TG0=YI_cn);~G
zz&ZKz9HG}P`<WpEzCHYwy&r)H5UaX|&t;pDPqy@CTz>S>ci<N$1;wH#>X=_F)dM*g
zU(7YYm3@pap#n!A>_-H&$TA--_G4Ve*{eV^z~&&(gQN@qwN>53RMG}O)S{5VLQPkb
zg>^c{)P@YSRTi!%0TEi)1`T)3Ameya-O!eJh_}+JCa>&uyb<nvw3Q}A=99gIx4}7P
z$E^ke&M3+iaENd7CWJ*%yuiW-x38lCA3JEKGF(B&ufSQ;6@;95H?^T!4wo>#BMS|-
z?N33|RMK;S<%)5r?ox|_WOpXCeJi+Vw*gG)-CF$)dLm0LAyu6Tk>Sku(v2~sanN5X
z&^yTPwG#5H=Pt|?M8`m$4xnUx`pNm;uaYS^(hJ3*dIdbv*O;~dN_ol%+pZVch2_)?
zDT8c@Rny&I;rxlOO2BAM+Zh`Lar~gk&{ZBAejkn0VcYgM%OOSSJG6?|vg5qf#TR3g
zX4hG%52?Z4QkiN8Hoi=rS|zJT-Vj17pWeX4fs`F!eC=4z=BZVY!g%rf-?^puHp_&E
z<?}2E844d0j_lajoxzGQc0p(iUAFS^p2(}vXi%~K<+_L(l{CP6%1s1SD%XOVG%fVF
z>rkJJo9O?V<eXVGBcZ{+`S-rYgGc#f(}Nr&>|Rq_Zk>4L;Z_Nv+q|+Yj~ybUtKIgj
zA=sef<fAV}j@#{E=S2O*4iVx3C6tTV@B`bxs`&&m*|lCoud_C-qwe9h5bG9M1*Rn6
z&SGK<uUHN5wM?DGI^#vjLiN)7T^_k7>S8l~*!mX@S6^vqo5GIR_!VWpx+(yf+eof>
zcss=|NId#PRlyx1bo9}=Y41{qKG^V__k>LLMuTj(8=7@!_cM(n2gn-Gg3fNoOBb~j
zwy!pJpQuU*QH%P;ZUo{C2RUB`YY6dYs^y}xMxNK|KxP`04R)T8<(5S4fmY*un+$Ym
zHtv}Y@Y%OQCwMDfYjIVMXRdFz1}Ms%rQLzD_#Z@nvD~DkXP+Iz4?~XQHjanIW@%|4
zOBPK*O7e|^SyWnjlV3j=zIcsVb*0-ZlEg2$x~yJOyCw^If;4o=MLe6pyoNrnT51eQ
z(&USMU*<3QvZ1LNE;YNb76m+7ZX0!-87-K*dZ7{>9MQmI+}kLn5}0KlG#(3GmsPoF
zE!R@m(r@3|1NdmSROEWDbaTg+7fL3lSue}ihNgnwn{xHbTeY&(zD($g`ws_?c-j^W
z+I9QP)jc(Tl)JE7So9u+JLqEubS+O^<>3KK^~b0KW9-Ba!|TVWx9E>lggn;&)aUa_
zw;+_9atqg_q^+5<rRQ>g50hL?AT-nXO};F8v5<@XV-8}Nk}r`aDCUMyUP#p~+0lSR
z(&Zjd%p9iak6Myy4v@nHJlDFY^$D`#py{WF-FXhJJf_FTjqIlf25&25TcAXEcFjU>
z5;^eZC+dnEMH~DVbx!IG?yqOdJJTq(o}so?g4Hy>-xz8u*GwY_i)|!MakcjJi7qo-
zQb4Qj(nUX2Xz6tIhUO`Up7d-tqemXWxAn7pBGOld>*3{*f`zMZ6J+)8ca9cVcfUI2
z=6_dgXFK?NnV!&;g5;yuRFyuzKq?RCOFOY#?iIZXw;!Rw-?4+{8b<oYmVEfPr`!@y
zD-Bu5P&%J?(0ZA~ER6?oMoiNCmjKY!u4OZV&*u-7Ti;f}p^P8iKe*?Xh{{G;KeGM!
zV|lA<t(QOKphg}?r%gXnYIxwXqblj9XzH?)CF$n5_{3>JH#S<P%DNzZ#N-FhDNK-i
ze67K=8j*vKF098Vt~CU&Vn;qtNaYkhqY)Dh@q?7rga&^H4UvKAgTtKDJ$>&dcVP}R
zUE3JbB|GNHaf6f`pr`PGS5d-dJ@A!aD8BoK?Q5Rr$`CJP_P{M{|CMQt;m)}=^URu}
z51H)p(F@_Z)f_{0MSMr*8{!7n*a*?|y6Rs>qy|ft#GDs91Y1ppzgA@8wzY##TsBj4
z^?}B5*Q2VbsQU$D@c`Di#Is-Cd-qKTdd`N0EQ;L|g-g@YWr!v~R(}1c$-Gq_!wwe-
zoKSL*3(d(@NMJuIIzL^R&`?8RTOF*g3X{Zm=_Qe=#6S<TpgH!6rwieN_vOzfUdyIg
z9CJcNcAn2j<&~{ZBi~;&_1aRop<RF2d&oW5%x_x)KL{$uTs*!x0o0~neyrW#r8kgY
zp&9FNRprC>1I{dXiwqElOcCbL^#qb^&W@U^bR$GcTHA2n^zR&4TX!o+9b6m4_-#i9
zuOhz@1IO9C=^4Ie?tL91M_zn>cWQ<hy)pc-4N$!wDxYP&GzXZe-}~#Wj=<}TTw#3D
z0KaKaMt@JA47>qN`-Gyg1N#vY-w5nSP2?`)?F8(nHoj&9JxN~6I|<)cl}ZWtWl4<3
zBaZ1jB>T}1m`e>i7Dv7`ocXgRdE~>|B%n0+#6JSidR$><Dn{+k*?shJTqnx&jI@!*
z9M+Y`ft6-sXAH}_`7Z!N<UAfhRp}$Wl}5p&)^oUR4``vbQ^Aw4uxli~@sis@wmg$O
z%{?u03g)PpR>=qF3#umj>g+TL95_cl{H{(fHPsNCqTOp&L6a8P+5P%Kl1@gIdIe7w
z_uCOKy(>f}0S*pZdc32J5fyjV%Sbycu!!-sb_=9%6X$+Ww(&ZHMYfE@4`4g}7T9@D
z$aRg!bvHgK^8MRz^26Kkf>+MN!Lmk!ojJJ$zB(;GA_hN7p|<KpAZwmdJ!zYfp-i{X
zbJ~kvmIkO_2e47Qhfb~5D13C(?5fLU;SyeRFkU}aRy5S<^H9?-nY%Pbs4F$&`2@`4
zm!r*x5kmT2nOisS=E*1JjeB_8YZ9@jb=6v>n60sD<h{Y+&s}r7H#Hm}KXaGQ5`{#X
z1vH5xb#QeTft2WAS+W*JATrs0OE`Z{K0UL@j+iI2o915VQY)u2`po}oODZqyAwn-O
zMP}PHIN7~kanUw4cvae6#_LX(Tw^k+lfCw&jgnx!1JnpcP8CpIaa$PMcdN~$ujT5Q
zRk7UT#d``U24l4#T*BdkzCXwzAaz$S39H_+Syq!@^){2dd1|Igi?S)aAT?JSyxK1S
zeJb;)(g%F>AS|+UcweD-K9dLpLR3mI(sS;a7M~9YDd;RZCDKQJ=mtkzXp|h}$?<n-
z*=jTr&mvl4x@ZRNyqr*)wasANf;NDw)S@{w2&zzMv+S>GC_ntUuT|ZB)*!-Haa&m%
zI7>!4Q`eN%iwSz5)csCk+!sYcrljWr(3n7~6drzDbNfTl+7ExULaw?5@L}@-=NkPe
zy!D^rMsK%TgpX_2yE)0>e`PiPI>wIA6GSRB!~Q;g_%_8M?hxVTBnK{ON)u8-Ih(!9
z<$AwbKz6C8d~Z%@$UIqh1)3PM@iPP0iL4%n2u%ME3)LNsR|gRRm0<#qZld6pbe39r
zO7%+zKXJU9&UNp{#$ABy1^lk`{EZjs;~23y#qkeuXvmoG)t3x@7p*i+jwkhOooO^k
zgz9P{zMCOkjpsYGbk7E*W_<JC-QNW9!{TyRMnr|Hi^t<EbrmSm{QfD+$+E*gfiw)A
zk0dq!`mt)jQJoSFXlYTBf9-7KYiVoFv#%CDRSzr5B0tzL`KZ$@oyu}hF^Lo};6K{i
zwFU57|G>96XLx6ieK2WFjv-|T?3fy4XKXW+BtWd#l@S0-%zEkgMWKm9-#Y;<^~g6P
zvMOEpQv!<ZewM-7hd6jQ%|Ives$p!!kiT~D$EBMBp3{noEp3I)T9NtH*IL@DiZn}%
zocp#@*~#cwc1gLTC|7fcuI*RPgNi&~b3x_e{J1~^pAwfv=!ZHHzCjjkfR?*PJ64Xy
z)&0>@PpJV^c}JC6x;GXeKUw@tA4(|P!m=HXX(RM`H`m!~4XTioX8;^<yC+~)M&9_x
zz{>T1^VhVZ5he%UzZ`G(qyXHhDl9sQK!DKPJ%&+$J<nfi|3vn%-u(C9|F<}B$H9K!
z7tzxx$)qYsL%Mj#6Wmazya1%7i@BMEN_MMX>tAshyGvvyZW?c*-?0UhJW+?7`5yE(
z8Mg7tUc|Gq=KsogxanAdR>?E3$?W}%X9HY@Z)@IXPIBkQe@XK8L?J+|0#=CP=Q#ik
z7!|>f0aU(fMSK`26(K6j7-{}0a>~RooDs61-DhjB;Ky-E3Ii`0w*q*PuU<6Q{()~P
zc-Nf+b|Ys<PSABJ`~wh$Ea_n8lmWkt$5~~1==x~db!s?t&w+$wQa{KYKaBl?_{vqj
zE<pHDbB~3Yb$-&UIzXNWj>fba$60mNiH!rYSrXRDPyx&F#bbN&dqX+O_DuadIFPp|
zMv_L@4-rd)p!2Du>7fNlknNnhJA<kwh__kZw=H%oEB$iYC;U5*aNid*(R7iyNNeB$
z@~lGDKtp!Nh;!5!ixdw7SwV=R0B==ivNo+-*pe(zL3LJSXIwT<Qd<cpC}(VB3R_B7
zg<Ey7lrXoTBNU#+M9;ox_L`^Q5_y#V>=0AY&Tw2&<!ZX-cB6741C7k7SB7dGri%nC
zumiex8S^!HLsMLZWY0MwKi<oJYj~sNG~=@9=O|kP!|<iPM&}%Q!OeqAN`)|<D{KUC
zP9bvVM(oZz<P!4qX*TB50)RIQ+4-FDLObB>SkXwFs$pDiIs?xwVs^gQLra4aWS5!V
z=2W2M<z#-9anoQ3@SbaV3+Klx3G$M4Ot})0KT)^#<uN$K&yXT)l!fZb`cEn9NH{?5
zE4hZ(g}OkgFqxQ5sjTWh7q!kAGT$;r;SiyBL=yiQ3<qJOhr#6wt`if#Jhg|dCJ*SO
zaZQ|bhRLSOqx^VT0jPq0ewbg@>cDrlzqZ)PcK;!p(hBp4m`FHAdPSrB+KDlQkdU9S
zrwJoJM_fHo_u+dmkSbKaV+tJwe6SGKA$dHC6eiFveLjw~1Qy0sb-xnuL};;IGhhrr
z{65a-BeCRqnBV=(Dx|&Z+_^A*1<xT~W%Yr~DmZfCZW@!MGv}Pu<;7@k6I`&yoYX(r
z=;W*G&gzje+^TzENYls<?fH{cWu8~VXd!HL9Z*;(OtxfHH0aKr`f#QlBu{Y}+7k`M
zm&3Jb6<k|3P+ivA)@;iGrv8O09U?Rv>DW6Lo|V?ICqEFI9@D1%{j2H$28kL6;G49E
zIrW*Yx}`M(4OteQA2K$&4~PH8xEuG|iMnTAJ~<fMZ`mZDjE$-*ts2o|R1ukrjJxI+
z;ry5opRvJ@a~yxzIRq-+_oY)$IYfIQcF8KOdyC65=D!2&+E!3CU|_}+vKj_z0iTD#
zV>McKVWV**tZx2#x;8B^b3b!HYe)M%mf|CD<b4V(w6FK~gLWT??^MCa%q;pr4t=mC
zh=DR9Ld6deKEId4UjVzcN-<sUr2*M@nY-;kk$pwuxP~p`5yYB>CM3;YeHs4@<c6~?
zNJ+hP^|!B_nd_i6lz-0S55_a1%Zsr1v*4137`_UDINhQ=#Qf44bwGsir72E3?WyTf
zg0=sJ;>@R#%zLxFIRf0FL!|HD-!?EsBkqRhN?!;ZQ3LqkgF|DAEy9HVk@cIo;J}>Y
z{{rFq$N2HW0SNpjnhD43j4%Hp1)5^==#0+)7$*ClItjxJi=O6AB&pa<bL^v4?yPk%
z2?)3#BaYYj&}Q>ulert_Cq|o*B8o9qme48Id=K+rlR72aJvB$Xu*C#()h*oNVoFq~
zyvN=D%`f%;g1z=IUTH3LK8d8sc>f+ddUfX03dWWoX1|beof3Y2)^X0v|L2S3f-P4v
zxMRcMz<L58qT%{@zXS7CMQ<<YEKZrg0V(5A^9i57IT>G?;{MBawkr?Cr2Mzn`~Qd6
z^I&W;qN(o!tQrJ}RBxAQy&4YtKZk$!fBm?{(UpX8>3{s64kL~djkcl!S2zt8v~&iJ
zE6U=x4h}KQOu(ZKHbS$!ES?MO)^y!{Y55>K9;lKkAKK4az%)Z0rY9xu=TP4QsamdP
zkT~u<yO|e*hBv>Q2>Y;p4s5`|_&8aEGSd5k`8>mj_If))jVM<eXcc!p(t3WJ>F7IN
z9w0yAf=E0w$!Hg-h`*X2p9+jxj@)F*^QX~P_M-xc0?FfIco1~DvK}4Lfvc0i>nVr1
z%M4|CNBpDgH>8tK)RkpwUw2<xbVsc@X;5OpjkD_MA1>@!xX`eg1J0x2pg;d$t#4!O
zmkW=_*@XH&zn*$d(1f!cfgSG6vfdZBlsz>lYQf|=k#HGCZ1RSsp3mC`e&8Emlj)Y`
z#fP^8*=(;f#+jIALf4h>K{(@NE9GF{e*N-px;j)4R7b!;eu6C`I?Gy=LH3H`EZ@+F
z9uCW`fa=C^+O6}r4X2%@gMI~Ii6Fiox9u5BUOgqiZM&%kgI2~#Bn5DTr`H#Z%ufYf
zO$Ppg1C9XRA|gz=B~-_YFPKZ3<$_&xM_WH`B5K}Dx09RWs7w7x`|0FJ0`!>2E=(z_
z?LCLR%9#8XQEAFS6S@Lp&+!Vv$kK(^!$`>Na+hr7j2FX>hJLhQ@C&*wud+`)FxF*d
zY%PU-fwy`5qp#NGu+6*BV{PDG#MNZ1L##|n<VN_I+3bbo7MTY2VW<5KL%<yW1$mqW
z%MX;YvGWjz;a6wa48yY)r%OgoT^+xGPsDA%f4lxdGti5|l~R4Es1{0!vzlRlm7l|2
zk)9f35wyksqMSgim^Mqf+98%SF^|5CZx7ytbMO&Ps*#C>Y5rWf*K(>n{0<3NHA*vV
z<4SFUZ|^K(N<E+~z{hNwpksFai*K1V_JJslG^<G9ftMGx(&YEHSvM4M&xxE$b~MTu
zX_i6vn8jPsc#8?{V@e@K%byw@<~Vz@4J@S&ZHt`U?jb(R@J^AQa=5B5(ms*ys8sPL
z(UAP2oGbuOXa0&)H_*!%TtQWOrDGbEqSC_Gv<;lw`s9+iUr64c$EpPFD5%rXS4Cg=
zCnb6cyv*fl0V5H_5xJcl_nlDz{~;%h?;f=m@TxkCu9*ef9nadr%<Cz1g-{wJ?1q6q
zLN(ycKdcMM_csuU6@Lzm7nFCWoU)WE-!da!2uB)X$R@Xs)EnYF^HZ0udFJ(vxalnF
z?$q{GquS61Ppo?j63yg8&FlH2TT>^R)?tka_{G~4dS=9Oq7JwCDn3zd@!L(E4~9i>
zWYx$<_mKBC8<fMk&3pAreS4`b#P5FA2(@AwMam!G_p*uLVEbd)Wi`LNky}61w%&E_
z^#bQhh7y`jF^Ig<hk7#k{^L+0iel?fpzk?LtadNhuRg<rOZ(WY0qy5Ft6a2`#@>Oe
z4ZR9)Lc}<(PN;>gFNYnR!{ChdINfxVOHz_NU%liDzr-1w*B%ViW_h0>Ub2gA_WttQ
zu)NX|xg+7%R>p#&5-|A-3U>UtsK?1h(Ijb{@$0k$f0=;78m{WWHI*NX$!-M|4Wn<#
zUVYWmON-$nS{@H-LH#UxgTB{Ud8KBwWiIZ|JZM6Xb9`xGFhr;HQJ{}l+i}*9x*Lgh
z{1NgdWC)1h`Rof)_%k*e2WE`nMFZaArjm`bGLo}>m4i)6q_Y&?dfDf8a7)w^6f<0Q
zc~xB91y!_NJiW;B$gfA8lWRrrl^LrMNEaSr6sZ|7)4Heru;xn*{c>!ucX817)suCT
zC;n{I;Y5E7eCKF1e~56>p>X|sC%qxuqCWk-m-VoB*S=|nX*?2rfJ~CRv~+t=9-2rX
zK)z;R<jDCon7GUYpP9@be`6rW<c<AhrrHVE+mI$)I&1&pu;!$1NFL*EjXhaM&Dg^9
z$Yo3He0&}xD>Z+jR9wLGOT)uI7kKdxGd8&c7)i^KkGjE=5n7L@erUjZIXD-eIGaHK
zdrKrsEe@5Trna0)LdGYaK@T1qN?Z>GZ1}2`R7y7z!SId=(rl2?f?tKZ)8jFDj8bA+
z>ympg%jNE&Ir@z*4|IvcoPzPdhaawi)GyqvWPQ%vm|t6E3Ny8%>b&itqmP#9l;z`v
zUN`IrsvO4{gxt_iRV(B9kOETha6J3s?e>%6cwjebtMpeMfv|c3qh-a%zV)VEd^dSC
zOLgY9Q!Bf7WtNf~%G!C#h)z$3HG^y3e@p&*GU{aA%!a5xvG2#Xn5krPK<8vw{Yb*c
z!zRwVeM$YN&ocPhardO;rFcJmpjxqIf6{66#JJ(=vi6Y+aI3&xFTm&LJ+HT)5EiQV
zM~%fB>N;GCfQYjzzV!x?7bBAZXH81KHZjo%yQ3L=+w_6#S@frUh4Kr%+O^~RhYXTn
z{I+;)Yw(g`k@3*iw<@jhf(X$k_A98uOV_H>Z;2ENca3737S_LT6;$inEQ>Vh#SAHw
zS}Z$;P2o;InS2nE(<~3is{C0$2ofIWdv9paWn`9$+Tt%6YOyjfs?(23jvm+-x9)s6
zPF(!sdd;Z95@&Xs&9c+y0^|~l;53n7Xt{LJ;s>0kd{oI77wQM~!sK467~JdSp7yPc
z9+Q?l#$-b13Dz4r%bFB&!A36o(Ia_fa`-a!B4@4@Uyn>Esn>qjr&8$XJ;F`n`<B#_
z0wwao*P7MGDEX55$5D1?%Jrkh^doHRG03Hbb9=VnO_Xh%V`I!lTUQT?{;XTkm=pc=
z^-!Lx@z~M3d1H~jMh=|<Tw8jvg&5t`;S{oRMn%fNqs45bL};0-?DKelCET{YC}vt{
z`WFm?Wy%+t<wx~0f5dG%{x$y>(4!%5S91}sC@_zU!95h=>GMr?OeHlB)y)iq(r!3(
zc8yZ{j}~1vLDLiqC-IRP6{e$)@(+-W`C*R$DMO3Umj!Ve@@Wp>0Bu`9TGq>S*GF=@
zls9wh(~0UO@_u}HR)t0+yl%j8Xe!xH3q?_z=Bt|z7dhfnzuE99!OJ(+MV@zbfRmQP
z&dbj5j!Or=W0zLPlB0OahpzI$2AcqNQ$J<~uZn}q8kEDzhRzN3$km-U!_tiYjt|9H
zNJ-PxC3tsq@{?RU3}i(O^>(26`JNphQ&#@$ob)mBsFSWA+~@3D|DeaYYy34qk$d+`
zf&*5(OX104-B3bA`p!d>6LoI)d9Cuodw545zFg??(zaVBU^?Ob40t*!fd4gTCzV(_
z9Mj$C_)_eeAtM}chd6j;ui~$Q+?uZX!3pmgaU06`I~4>yyWzp58S)zioZs~p<q0Xi
zY9YLH=4g-}cghAaqNm_2f3y6sJCw!egMk{66cKP4Rq}P?EijxuQbJD@P!~ReuHP&~
zey_Lv@(UyRD7LKys`=ec)~uSv7HC8!#e*f{J;H=<Hv>6p5>fJ-e%&uEABt`uX^mkb
zTrNWJh}SuQemY$#Z-#%gey~a``D7hP>0YZuhT-ABtlsC*7*=Un?u&sf!A8f=*%>UW
zZG=65`As&I{Bf82(?g;8$Q8wk0qWad+WzkQ10L}pazmIv4U;*YP+>W?yM*3+X~`JS
zS>R}!OoX8(X%)<0rW4xsJY#o-MDg6IR<wI8&7Zb?AT7X03lho5rnUb-8!hzk@NV7=
zc4b9QcEQ~d^MAmUj%e!~B3x2m+B_OESMKJeC;Q+#lC@<YZgBwM50(4vh0`Ml%jI!Q
zV)+$V2!ATbN#HZyvB5EHz*WinR7M{0`Pagdnx``GTnI!=SmuekbLvZ{qTf}Pd*oo;
zluMY`g$`@-dN-QblO>9r-MZ@dW5;48*$->v&H>|La=)2B@a<%@tsvf%!Nbk2R7A{K
z5)zS1tDM2V^7W<&aJQ~OFkUExG(%B_|5-eGN+EARQPR!ptlrYpq!OMS+p4y5tHR6L
zslXxNVFKzq^;60_HW-2ls7_E{A;goO6>Nlqa2JDF%Sbfne+e&{;l|JJ^X9FA`H4xf
zc{uhbHxI!~ZTizNp4113XMEl8DH2hq%+|S?X<?6ATh<k5eaD!=Ic968o<M^q)q1%n
z;=|`BN4~xn#3Nzqo1p#yHn`zpf;*DrtUluzFFl>zsX6U`9UlTY+KaNq-9D!Sv@{Mq
z{-X&|cS&6UUP}nPa?X@I1Nw`!pgu_R`WQhKtF7BYcpGgXu*mtx){$0jFkDl-@tDk;
zb(?<bPXzCodMW)f9&OY%&+g%qr86*k-@$8p`#z*ET{kVxY09VzA!3prE~fd(;CH$H
z@;H;!sNt%gkQ2SV&0g!hTmQ5o=3VN?ZZGp6+?>o5s;O^k4>S4nnvbWHi8nMIlf0ky
z*$2!#E#t+fayCdFH^IfThab&?u*AS9^x!AMVPMk=>c2F~L{skC3B=gS{DE(SCK5?;
z$J>~BPO+6_#WU)k?7W<8C`wSqDpAeV6o#tm{cl0<aNG8Fom+rDFe;8O0ok0BiMf*0
zzX3Dn%P6MM$c>2O=>qoircqW^2_^FUo9YgW&%hMjd9*QvG{T63QosX+0PnM5>jDi$
z|71jW4U$QP?5}F`p#0f~-R=<5&}|u6`Z&iq52#8{CMmqdo1YcfgK%usbR@malC84z
zXa%6ux~PpCR8=u15BQkmI9ozE^`ZzP#{ecJxXhdb<f7QI;WaUGjW%s~dL0AHUOxFH
z^Ddt;%n;Xoo|ZhT+*d2iM2pA`+B6r;9{eZz8J506p$d3t(e_ID{nagN^`#)%9{Okg
zmt^!5-7^Psn`f0xph6^hxaximMkn<<b6$-)SQ~7j$5KH`9QU+iEU7WpbeCSYldQgk
zH8I!&Kyi66WgO5%zdbpM^a2p+p6FvO(*tC$wd^1AbV#mM!q3cvq4jbw50zb*8=?`4
zIyCa!8^FH>3&F^yNnZRWD8*ZS9UlgBdKpLBED(DX#P4HEs2+|T<B(+MXOeO%CCP%i
ztP#<66t}2fGL+EQOfpFQf^Kvgc*?ln^xh%&_J@2Pz{e0W)4ZqSr4u9u=R%gyJDtVZ
z`a+8W79=AKLLgQp?x($lE8R*};lr6DPirwy4saA0{lv-8eniv7BNv;Eq;MDC);??+
zhV=u^7CaM#dl_F4O|OsmvWVb5{|z`J_cUT=<0o=`gTp5Ma#b(MW$QnxB{!F*Op-~X
z;D#pUBQU-pLpIqT9MmE!fFA|*B#MWy>aLEE!#M+{;M#s-19$ii69@4mBlxB2|MgO?
zEaYXdA=c{gGY2N~?!J8$WZhNh=0Ap?B=h>*giIhu!LV^&d_T19GdF=nmFg@oi8cS5
z4O!dy*HN6K$vj+w=RLzFn5<;|n^>vD<-NCIwX<g-FQ_kh0Y2$Lvbzvzf5AqqB?~z}
z2haj36rf0p;vnFuAiZACTsZFQSh?5NWtk#IPGfIMOvz~QVv}igd7=UFWUcO>g`IM4
z@AIKE@=QF_{FRUB(rwaqa%RN9TEXS@WTmMys^0<uj;e6EtV}lxuN@b|N{y(9lY4q#
zV6lu`7oMbq4@h!NcW+E8{f$t~&OPWd>Tpf^Rjn9)uYMDs2*BAnqktpv&#*$I{N{U@
z8kLL&{>}xX`}1h`Cb4jJMn$J{@)yj*N{v6AaipZaIM#UDAGIzQ_b>@oyZL65T|Ike
z=_2w%#)e4G!Z=)-X?SbU+I0`Cd|W|Rb9D^<(|J@G4A*jXTY!<iAXZ)`c5IHf7i>n`
z<<wK_8dlYp8r9|Fs|E3@NQ{}&<ro(?zZ{Huu<Maz7}++-7;a+~y2#iI^9Me9W8e0p
zQii3YNn_f(&%lNR(sF0P75PTL59zadX`j&<JCn8f6*_i{-!y-fu~L^{47;JMCsp2E
z0Senzq+Ty_=EL`bJ6;eM3^OYD65^`(sxue_6EZfEO<D;s=uh;!%ov79R^Y=2^%JUV
z1zJ!9o3Lxy7iKG;Q46(qb&oDQR;MjUhc7ZAX1GODu%1_(|0c|>>Wm#H`P?jZOY+<`
z&zwEXGT;S6Rm_xldOcK^0vxMXD~%H@g4p5iiu`{sEx`<-ZT1-!o&7T5vN|bDrvaNN
z&D}A@A*R^Of>qZJJWG&gYbO_te{T?WsDC4|!MZ=#>r<31gV=x<p|IY%x@tpn+--`V
zGInRRY0&fMOl8yv&UihQTyUk<C;i@$Zlcutp=gjWVvlWX_F!mcfSANQywBRSnD%>}
zTVI&&8+JS4_xQZCpt^>&n&r<Hp+jW;P28HPeOkApHa6lQlc<14k1re|6lIy{J=EJ=
z&&a`=kLf~>an~_~y4{8VgEQeKxctZ7U4xTB3<?pN<8c?Cj+0z`5=Ob&rxssZwH*wP
z$oi2|bk6Aq<G!fRod;>3!`W*wO0lGl_=%wWbq7JbBDjGpao8XL!~E4^@93P9#7}Y&
z66MTNnh^RhxZ=5GOK%0Ps5=Zr+p3Mpd&Mur0jcUUTjgH7K4_>ci1RpO@?xv2K=ZgA
z$J})J$-2bT+}*cp{#Y{npgI&PFS-8cFbv!0!w?N6M(s6|WvrtO?xOnD)-KV*R!*8<
z!a$T3Wf@3C-5Yu{@w4=K?-{c~dgkQhiMl-8bpuYfhmhoItK*)UfR)_0i<RMkkFhvw
zJhumelnsnmj(GvHQYwE{ExrZX_^YeeeKnyEFHUg%q%i%Uvxuh_B?@l9oe3(vzqw}q
z*Mq)rkqRyFUie#_Dz5GdUa8WQCzh1<%U;DuNL-b#TFh;sWy4J)&54(@L4TfD-(e^p
z-D*nE4N%U!&3qY&bo>cc>}yggZn1wVp`-b~h<cNZ9V|RLIKTI6Tj2nYn(HHo<yv*E
zTjI*yF-dP}kF&Ma9vU|PQ9adwon%$)m_8tTUBzx+O|1~V!*J=8fc=tQygGV#o&M|y
zvnXq@1^df}_XGaQfLGr6*H^vf2-^1K*QDiy%{=ub9?4V88m(vw{M7P&d*Y{03Aou>
zlPxMpNlw_Q!0Z*oHQr}(mwGznOcsO-4gQxBtLD;_f;667H8!5%UCj9$*N47XKR&$l
zpJbmAhpNdpqrIV3PD8H~+pq^Pi6?~>Y*5b`Gk4Hn8l`m&N2&zIVazn9a9v;-=fMm&
z;cAiz99Q5-n&6HA-U*I4DV+z0nL(9#N~XF*(x9P(=E8bEWQ-%F07Q^t9<gwqc=tME
zHxVa`V0Z2U>UqdCO5sD!)i8%4c;VnV-tme~)P!wXdYdq7KGQX(S05m6uoisiTf+m+
zw%%RzbN_^XF!2mwNA?eE!&MQu&Ksds5<=bB(?5jy%OU=Fu=HPEE-h1#x%j1@f+w1p
zklQRz+yPN)ltA_hqbj>(Vxfd}5nxm?M%4OV!c1Wiz60)oURi(*;B)V&<x!CGT#xn*
zY?ye$NPpnUplvKbg^RrM=uWIj<u$xX!KyTGJg459(5N6L`8Sjqi$q(nEQc2ia{xZZ
zPzC63DmK##kew^2>Xf7x7JC7}X?Uj<MV1aM4T7d{FBJDQreZ*`@a<ms6Z0H?*T(zy
zyH1d%LU(P(fMWT--%*7V`JRPDGc>F^+O$|WonX*r{=inSxz;O(zOrxFVDiR!#x+F8
z9auhDGd6-1ryrZx6DRKOy+_9_Mz9+@Cf~I%ZY)m5XKXxzvm?fUVj&4Qb~DVuXz;8O
zjO|m0e~wstIKzHaClPejf|k@VM`O0yH$;+&QC76(ApD79#TKgHf7HT<;e0_J=T|&P
z5X0XGH}cNZUc);B)tT<gB;cq7JJSjvFpPAh-0NF6P>mrhgzR89mal76<~DHbRP}s(
z`t0vF`_kTI|NZ9UA)7<JA1}KEa0HzTn?A@=$GH~h{jT@+Nll6BSGV0P2`}64o9V8-
z(pNjed5BN&_Q1KQmnYON9{BZC)Xi|!@R=n4-I2kZK^4~8T(A2c9vH=*vQ$$ObU_6c
zJ-j?$XjWu+1s@*XrkMEow6$gB*?(NQ{Q+lfUZ)5oC9B1fI-9+kE~GWxa0QRk(fk>;
z9ZS$y;lpd;>aM{Nr@zvmUtO|)l3)q?Hl$xZ#^58O`1i*s*BcPJ^_G3yUcH{P?BTw)
zA0R|VP3@(XZjVkJGPNeY1ySnaI=<J_);)CgW0>M0+EksBdEeF*y?eWdIor^i%sVTE
zT9kzX%GI3II<!AjThWe<u~Jq3{wco-*rZB`2U1_<-1%-gdc%w{;>P}P5N$QR5M=A+
z+q>*y`7&g%?V<zY4xA0$vEsw`hfsc1E~mNQ^S|>mo9$#sUE8T|Sgy3ms^HS&j2Zw8
z>cCP(Yf7v0c<DJFOo{v{CZZe+OJx$}#oFssa+z51Q#_{`az*C&Hu=J~3cft_Q+V9o
z!uqdt`WwrU-sJ|B&5(be#6R<LqxDPABH?!I_|M0WJS6I_&Ivzm8@65j7%s&UdR0yj
zC$6JF%+i!U#-J(ALo;lO{t%MpAY!k<CovX>GnN}bLKKM{+_ocw_d2(y5djw-Yq;9Q
zM6{b|xMHBg+Ps*?$w#~TrG6!nLsFOaV#?^TC{lg3+li{-jRv4rlUF-a<!5(9-vB!+
zvXbBD9&`y;CypNy_Nc7f;EE)X056I2OkaXf9=U{%85*)fLi>%3s_2~@dy~GoaE^0+
zCZ>F**JO62N^(+_vZq@6G&OsR%ij7kUICGv1M@^urP^(;T>xSENjH!hm{zB+jA1_g
zNfl;g#OZIT4%u4F0b7iXXaTT;f{pxlzB8W*HG!W2;PC%B92ii-04<Hux6M0D3A!v1
z9iUJ(I9xbHW#Qed1>|wYDI_JsZ#Pl)m$?%>{2=|zc<gW2i`PBK2e+7$aTY7!E%u+w
z>u2fjTs3kcC(fQ_tlPwC_4}{$GQ9X*RB6N02GbbQM>v;#Bf_{B=Kz~<a^GF0e3TMO
z^4p!0DPvpqAEg+#^6$c=$#c##6QqEI1Oo}C-UkT0X2yw#xO=A`7-3FB6H55w;0EZ5
zgsw1(Z^P_gnZ)SDyYPBPXiydbr9@IQ=;^G`U~_NgHIQid4I8FX1(ALLWR&aOSPTp=
zs6Y`YiHnRy&7BrwN&Puc#bjmQYH(YsV)GgPrG8M@{xQ8yp}xqdIyu@tikvSeKIoGq
zwRD3qB%l%vRLgeYB9n=+Qt6!0HF2bbPS3v5)TKH9oeZ;X%0jsUoL!kFk}%-%?8t7Q
zSgX9#UKd4iyAV(<v2=ix1)U!m8y0Ea%(WoCYvq~NJ)*wigetAbUX2Hg<mMMsNOfu5
zOQ7dD)#8&sol#z=Wgkj$M+aJOY4AVP{UI3Re9kSj|Jvnd8nR`FoZ<DwQ#m)X8|i^<
z=)KIZ`couJ3*Y*i8bo0g@ZAYZg;&}moG-^baMQl0cxll6$mF6LW&R88WZP+GkSBT)
z)=+N!D3OJcVdv%1$10l_SX-_+wC4y2pTA2bhfqEw9%cHCIEEi4>qKF%S@0yDdue%k
zGV3x?=FM`K%I4qG%1mLhW?&=ZA(X9@isk$y=Z&!!7V(nbE>GXoF<P{Lj8EpUVCus(
zBN)O8wbMKn$D;|$@Y;4TeL5-BH>4l8#(G8{f8A>>i#r9cxLbLdN9lHLEc-VtDfSL~
zPj~2@T&3&V>iUD_M1!ctK}TjN-&9wF&TSbut<!a~)~3YSp`^&&>idsw!0RkFPNzg+
zY4v=$g6j=48iz*@w@%$xPwU(tT8W;2Fm_gSA%PPv9zjHhXex@L1%}Vw^HPT3oRspV
z1TNNQzcsKP?LWAvRCgKcpY)V50+C02aggS#1EnG<BfwELSfhwqrK<O4{sP(_Z5o$h
zQ%P9KGi~;(lmV^uqw20o8JDpS%bzfZ){MuIl5>=Jn^PZc)|IY#X+t<8Bb|3e{9Wv<
zj0cL_C#46YSd}`HaWzIdyq-tNqX`und;4nr_cXu)RND+K-?Dd@T!6ME1}(g=OnPRh
zucXNKiZg}>NM`3mY!)G1hlhqnXS5(cY5aQ0>#_W?IC}!ggVphHfg%S(ajulTCh<Uy
zS`|{q%ACo7SGq3>Yu#SbWbCaCg}Bbxol%UnzbOjVRajz_$5THtXlwE_R9inZY^Fgm
z0u>`kxj<EBLib8AK-Qv!>ZZQnYOT=?Noc%;*M}xztc;*MoSy`~$m+e;Aa??35_Ga%
z_qcgwxrV$dT{Y&UMfrFkTt5G+PJP=%idByow@tz56*$LCNu5vGG|Y8)U(Pk~$;A^X
zIaRbsYvNoYM9urqt*yOSFB+^%0h<N~Mbb9#2Dc0PGj$t3(db`fMe#YH;%ib805{aX
z{vITCe41fCrU%P(u=gkhIgqo*`DjuNCuUh=-PG+aRB4vPqh9~#xV+(dPo59kJA+ig
zS9NiuF3aoPhHkeG60cD0XAQ`UeO}22$PFs=EEui*^f^L%H@44AL!fognh4BTZ&p;x
z;4g5kcdL;deC%=~1Us)WkO6a3R@{`yn7`YNR4Ow1Jy&KAakigWAL8qbEJf$up6?HC
z(>i;s|5+dR{aSKB%@r5z<Nd!d))j~CymIhPCC4{8_~07nN+oPz&a@m38&~SU&WdPJ
zegL#|bwx$K!M2<2a?}*{^t`r7xFKL!B*814-W$ZRk*(uI>~Iv(WAv9JI`eEY6NEp*
zkrZ;>)J11(A$l=daI;cE(8EqXS1UF4^m--lW(7dKyfq;{h~6mjSo5KB)9b4$c0;OH
z)rkEeUma(A{V}<A7f!>Q#1-q2qqx-=N7{zB>Z-4AZjK}onoqedbpK*wovL2K)MOlK
zOwX)HotAQjueo+DBCtibKVToLuicoExtSJK;LMQCrbxWLrclk`+~Eg1A#0TY?38zv
zA%)UyCBw$p`PdZ~J8bzQJ9%_kuQZY&?{69v`cdImGZSK~66;I1>%a73wkG08#Ne8q
zIc*!0F)}iB{1H}mYT>3rcv;ke9oN=c;hvMh2HXm*UpsLfea3-QFC)5f<Tr5l;fXp>
zQgywLen4Wjt{i(gVo8S_mqxJRJ2q_ZaXV)BF9pRVGuO6sdPiAO?DSicEdi|0I?Z{(
zp2<qlk(2%YyIyV)azX4Kg?YU*9l={gbER0a#crg@h6p=NYqoUvjm7Q-$uAFHt@iKC
zVvBk|BBe6wn}*v$+IV8-73K$X?(mvL&)0A6Ph|7F14qsZ`Li>{LzeIOytTSW%K~v%
zhSTXEDpXT_Yfr5^abgYfh8+4E*qrA|ccX-~CUzdCHgpTlD-?~2@-v$<&5N&%))>6&
zu8`akB4Ry_nwA1AcAFKp-q%;`>dSMRsnPoLii(bRs5|1Pdb=_-Rp_faVY>d#F=oW>
zC66%G`YpI+!z7iISfEJIy{>2<Nd1&HId`e`fV+$8n3C}`MW=hHHN_&~&g5OU`*NZk
z*jH;bt<TCKzB3Z%rav+plaJ`}85Pay6dCWId8r61Wp!ybIzrf^{ZE&whOMwE3~KDv
z^vz55`t$EEhT9BhoAG&zbS87$AXm_DeQ+uA)C6Gcc>{A7H79EySd}D2N@T2lulwY<
z)nr9((s`^~EPbJDn?tQi4%xn|?O*V(SD(qC?~to#1GQ!lSAlO;hPwAMZX+PS3xq2V
zP+Frtb=JY8cet!(u@T*?DoZ4r=xDkW$B{nMwepTTU;XmlENtshpqCxZG`FR7L*1i5
z3eL$piuxs4Kl=KP^(#x1a1GzksLz*ZMnCD@xxhucqX~!bS;3V?cU~Tzy%p#s<8kM@
z$WS&;XxDkJ@}OlBz)<^u9Vr-V8ANAsfg4<RcV7c$om0nis`zAGZkX}d4$_TdF-W%`
zp55qLiHjSP`?s9b<6kaHtJ#A#fz<gm6uVO=<*6Y{f#{I<wI4obt>vAbe_tzu4v=fg
zRdJ1F9Xrv0H@4PxJYMGD9iUl0DZ{KiB*%26=IpfGRZVnBS>!CA7E@`eo&%|BG=(ok
z1CCW_xGYKjI5mvB{^pJnRb*^iFPAiXEBE7<zFC6)sr3j=c^~7#ezzW7@@^qmDv7tz
z2@_skZ+KtmI@Ldv@L29--81OVZx-%tVeF5_>);KWu=ld8;h)rprZAqp8?ix-hu7}%
zT_UI2|FvK`-hE-7TMmzldn1yCVf7^6%W?{=+E&^4khw2Ol*u8&&L2xu4A0+F70wW;
z+D<D{)D~@)tI|t*pg!a=-mN7$Xl_UsVzu|R@7;MX)WZ@r{`|q{`Fiwe45r>X@me$5
z;h<T+W$>2BnX8@g683>!yXC25{<Uldn@$E-uD<`l6{->+>ga0}(ydP0UY>l{UBo9_
zU9qmSqrK&-^9w2t4xweL+rR(Q3xK%c<&2~$5Zn4u=^Lx<X<e0o2v`v?R-^l>^J>nW
zQU8K$YV;9Qsp4gPkWSY^tvKwM`K^6i*Nz&|P3~T=)Ec{lA*R}gk9&aJIL{MXS0%gi
zV(B5P?~APyDfMeAlJh+G2C#F#iFN1RJ5hHy=Z=jCT{$fl-pUB!G0()EU(P&*+u%?r
z+P1&{b4>Kfu|}`w7|jqypx@+r*sf9EP=iu3fL!J_C?8EBJPYodC#R+Dbm$#(?n4DG
ztCgC4|8dSJ0xR#O7({uufe!bccowX<Q^Vwyf7n(K$2zY!4UNj%c|5n9R0uSqt$H`|
zFO2_XeCC_wakFzJlXY8gOenm*`(Z>=)~t_1@6%B@G|2l<qr2aG$6<jMk(prQt{+y}
zbEVx`-PI(uMjlsp8Q)mdfVG5ny<W;77j(izQIHO_{bqy;4Gk-GB@c%SoGfii=iHRd
z=TfQe-sce7LjV;=1eK)mOO|q|_-6@&zs@|&zXJ|%_j|KDj5h+C_IcZHPHn7{()_;v
zPJ?3;^BSpi_1Tn>t(|8%C+a<*T9EQS&6xjzujW0)KL*oml?r|G`#N;OT<P{uSxB37
zI_JYg_f)+nM$kF!u&L`8-|>2PJRf8`^Ol~ToMJy8mU&$kPm~@Zs$ai2I6Dh$=B+h4
zOP~I>5L^R0)s$b_svYh%Jd8s;G(Gc5-d{<R^6AA^%{6>cRr~JP-Bg$#8U&}D=|Xz-
z5S0u{ay5zeb2tgKztcd=sH3Ku%4cpW2z20lzkPYEG~c^}E>PS!`*{RU`Ew1Ux@ZXv
zJ@RpND=<v;?GJVzGSPqMAOAO;#KxIBsjYO!L}<vv(<Ag8BY@r4_6Mw>?V@rH<hj<y
zbUN7c74mbrL4PLSz_W2_{V=FFAh?Sf>sJsOHH|`dwfR;J4I2er-+)YV?yxBVgB}w}
zB>qbqEsipEm(64=E+c+uorZtT05Lskngi(~L+;QY=6;;Jj1t<azC`CJGK8}q6?%x?
zlRD=tYWBc6Lyzv+QfD`pZT_$)+q}+Kwq(oiU_$Z-#oI4Bc+kgx-)eYcD?k6m4<Vt(
zFfwuaG~Q~dC9A<i{So4{?&_HEx|b2ek)E(){x*9x8-Rn0)BP!&X@#}v3A>(R_)D|_
zG%~NdqI$KBtaUjY8+#$b%-5o~r_6pJcB;T8=@20=q=81il-7SMH}Z1`+?FrHhk(r-
zGmMe8@qs*4b4mA;3-oWT;khtFqlyC+Sv%c!6$<DZ^>k>_aS-E`YsY>Xx-JAaZt#RY
z+3riROYL~$ec})Sg#`P%AAhRf{Bi2M+rR-bCfKv+LG$;An&K=X9*(GWo-sLG>e13Q
zv!;7WfpE3FSno)g=zS4vq97jaG=J52g9iGe|F(n=_^fL4+G=s#rLw?v8Ted~h~49i
z9)6z>uiMD(XsFSSYsLpOO%lw}z&tzczu@VN`ij~9uCi&VBcs@q@crqLU7pW3$7y`N
z3`nzoST@ir?(wIngXeJ9c?Yvci!u^w9;)W%oajbU(#knx&b4Ni&kSO=jxE7u<3eCK
zi<1tYww%d|f2s_+I*tub-`hXW*<3qu>rO38YH^@txLhDLu|O)eU}~gz`m74b)uTqq
z&EHn)09_k(-+2?0KJPjlffoj&FYlnB{o1^bQ)MTgoOyN$@_TpR-w@J5iJeCL&J3B~
z9O_X=>(1`zgg>9IR~mFfn<SjuWOaae7=ViTX?iL^d>m~i)^)>nf&iM12sU2C7YelQ
z%S%yV9BVK@rbLsX``H3tZQjha<0QN$fh8kjhAvMQ7AgUo^2)(w5hzJ~>5n)qW@?<z
zOYLkw{meq@D&VtN{_KrQt&OLDO4squfuB&A`JJCX&(V3AS#=u<p5c>yG<Fl=Hb(*)
zuQ4WKQf+?K`!;kmD<R~Rc^?}R?i?kmyMB+deAs=4Aw*4vPg2#E_w{?tmhU&;VMZ^-
zr?)ksB9#1Z=7pF`c>YYT1FOvBIiO;y4dhNCVNvqO%!TQ85DWiiZ~6X*KS${;s#BKi
zSbpiuAgBAX2EM}m15*4vFClLKp`4N81{|b65~@6?L8!{)LaZ{w*?<a?d;u$BI#7Vw
zoR6^n=ln<L&o2Eq*hj!a5eV^rew*aZ<2X-5=bx8w+p!X>N1wJ;HY^YAp>~KPPn@8Z
z7gbcPHO9Uo%vrAm#>&C$&I5;}KMm{Xgngmk`3EDsX_E;jxMSse$KxK@L^2PV1f2cn
zoWi@G$3Xs{Q1qX-1M$Cnk}=UGMBE{MURi~%ZRM%gL&KPJvrK?!I^lqb$8`m~<+<h6
zrWZ6O)2lBvBe_ICSYsB>%`V&rQxZwRd!SW7H6MHnHtrcOwtP{_bOz6wCdz)EllZSY
z(0;xyujdv-<A;wKDuPZRT-?dSEhbnPGY1M@YObw;kKj#$Z1bh$OrS`O();QT^SD#K
zVW#bwMlJs8?27f(4Iov63Lg)gxQed^yVWJznWd8evGEkEl8SXohe~pbUSb)pP6|(h
zCVESDf3*ztn&{T>VEYHZ47hoa*ISx@)No)^1G>uP;i=_ndT(X}s13U`a%c}A3wRNi
z_HZjD$|^!{lLn^52!1viiy@^0!<7w0h;-=WD`wHppaSsDBB!VM-N~IhQ!^S#8f>BR
zhhN<T!}!!zP{en^l;`{BcQE(-y;t8d-V#xEJJ4%uStrUFhJmKj{H*@{a^<OS$@}M*
z{~gl_JwRSF(T*BEnqB*P!_9Nt`>#DnsO5zni>OU_ce3i7seTk(+W4Tj1iN47e@a=2
zaBu2@!~PAT5<Yfok!bU>fw6diWH&o&UdR6#cS${7_m#>(Rd#KgcCy&NiG=Q*4=mP$
z4=obWoQn%rKvURNIy|E@P!5E+TA)|u_BZy3dNlO>;Fe1dlO~N%i8vvtx_Y-X8^%Kj
zhu6JP11=75Gk(7Fo1(Cs<=RxKPt3hSoOHL&Jzn?Ee#Cj)S?Nwu%~If4Rzit0A!hR$
zz}u#0MqAVEwM5w-5-R#`NR#Q=5r{jN81@IonEs_>vfgcESYUBcOvDp{dH+|1ok%dV
z)b;7iJNN{|o0R8pKwyQ2q&20Zsw=!8d2Iz2CGl@?%}4LoOE9<Efm*$hwn)tb`(Tj%
zIS>K5-h#~3C;<T6g?K;LYW7!97>tfu`1T1tT25I5j3D@offls=7;51Zb3{=J02;54
zIuvq8CPFSHfi$8!LshkuYc(tr!#{+Nsm?2I#_RS_O&MaZ0`&m0B6w;0H7_Jo#ph!Q
zMF6sbS9WQz4cn@@K6nn-0@O->B5tHLK7ctj!o<{?g1Mqe3FW&|a~12z_lmVzwMR1u
z{N04!TrA<YnY+VVfOL8I>NErNsg`&~j>uSo0NU`Z8!@e`KjA10CdZ&{#;^h0LpQLn
zMQpNPsT<ImScjX~YO_}>b$5@Lr3%_rt^E+#|Hb=m9$`cGRile+&da#~#)M~K^dXKk
zt$V42MK<gHZbF<V8(gbL`;TFZ70aIPFn*-MPF|`5=L+M&H=)`r^~$Tj=q3Dq#_^I=
z>g-H?!G@V*g+MZ4tm<lg)+wV@(!5?hN4Te8MLyCMvmi4Q@m<EDw+-4h&7G5HLq&fy
zt5Jnvs*E<W^(K8SR&vWkeNiMcAqKWbt<$sRyFVPieD!0zg~Vf6|6S+Ekwrjt$8Yp}
zB#oRf<2l-hbqQrzpS2V?wEb;D_U1%7KYPh_-_W*r8?9~%Kz5QGGmhR^g~M{oGW{`Z
z_Kxy?I>Q9_yW5XpLmXk4?>KF=b~bDLV(H<Qos%_-O4%dWzh8<Cc=(U?-#B8J?yUoJ
z2;dRn#v0@{J}X3dOctt3Mh`P!h!@ejGVg7|w!YQNETdtKlcg>Wd0Onp6kMr%z=*xd
z94_F)?Dz*w>jN9uE^o=cS4|!_qG2nL=gn-F(DdIevMrHgE)9)$=uCKl-nBvaQsOke
zz!~8y6-^y7g|i>S0VPbR3#@a$!rnX1gxW><XqDVj>?@$U!rl7_+jzXL$4<fj@xh2}
zlbo-?GASl-fIL+%im#qaoq!><x1ZnJbSd{YoQ@rG)IqI&?-FZ)K|Oca@CA%|+!_Pl
z=jo3O*8uW{7=^r!om!4Ixf<{7!kkPQ0}aZ`sn)w~Mj<lGjG!CF;~HW~b2)c1gwxg4
zc~W4Qp!+|k`}BM*SM%KGKbF<doS`(f-nOj1h8IQ&Y_N{M7iSV*gp`lp*ch^eLpCLR
zmX2o56CH+fTpGMyP4{~<I6PCch<;GhvzOmrN^V{eM$(d`hqH<B8_Ct5j5vpzxI4h*
zUVl*bk{3$2$cmBSyZgeeR9~IiXty9V>*$O##}ZGUK{{NNV}wVdwcT)skEd(yy~^QC
zEVQyTrx5lRJ;b*$T2Qv;wP4A6i5lvC6}qKS#AJe1#Fy{r%&l`@696NepVXlH?^jI9
z-X!r^ICM!R!#{xmw#8;t|2c23wbJmWr-Tswt;f!!M|kVUH|xJ(x3v|?;OP3>a-3Zj
zd=P&9#B*%2;DfQQ5L&ss(qP*UoK;mh$7g0*4#=a+8%3`qzVqryD=Hdx)Zz1X)+Dc*
zx@z3p{q@~*S@A7i@7VvNz3U8Xa@*43>aiT<U_nI@&|@eT2q*#RHcF^MKm;U2;eddE
zfB`WOuyT|V`9c$<9Dz_YfV4;riW(!*n}!mFPy^%;gqTn=JDhuG?wud=%slgRCO`7<
z<m1`d``h2zYrXG!*NTa6mcB=pjSAD{#V@c_ixEuXoyyB4_J=$#=>Du!ctOv41MQ0h
z>_V2_Bc4Kj+Lf=vaFGGSDBrx@&k}i@&nM}ZJMdHN;wqM}rWmqF>=+b=RYc9}8GizJ
z=OckBplweO)jqfw(|+q(mOW|!S4hU6MD}QICz=P@LduF^Xh=KuX2WRr&n&q=Rzy~M
zs~CU8$6Dg`SSQ}=-emj8Ewjn&ulA@xmKly)r_C^c>L{LB)ZL@&(l>(^61|zhozwJ{
z-Js-O%&DiHS33!)*pW$*)YnjHTnS@B^wr>54?P~fw2Mf4x$uM9B|ll4yF9U)c}Sk0
z{ftN}{zBgW8vhpnchfx+>-(<5$#6&QZ1`K#-F~h6Y(T=|dHVLc?l~H|<zcVjy|=V!
z-oAHuD{;I=THwmD#4)wuf?GN}iNZUGnoVOTA0$>AI{d1GvPSXlUSU}{yNNU%f=ca`
zJcuYHf?FCQJ*vCqg+@&?37kvSsU*OzAlQ920)nSYm$;-Z)bkgy{ek2}cp>i6g$kXZ
zd+wP`AG}jCare;q?@Mpx{Zhs@5d@p)Ru>F6a&t}p%*>n$^Y#%xqgy!|-fl5ceb?N<
z7}!~H>id+do7^8Q**aI30Pn8nGD<27ulUp7SYT?vj4bJ)8y=Du(TxQShZZ$Z9J>~G
zz307r6@Kt3+Xiy=c^J&obZ3mG1WaAQAH_pZc<<p$QUx>}#@QHdiNf&3zeC+weS>p4
zcV6}FuMPE$sIR22o({>&=pH&m_LiaUe8l?=*}or?2-<OhdcEw8XiZq-HM}QN;i2fN
z5b<;|+IaAJw0`SDZ$x&lul<xHMc3=b7i#s%MbZQPkV!vdqv+m(fP~79#I6&^l)`Sd
zgzS;_GjX*9r>x8!K)!sck}Nd*nU-k3WC?A|&$tJ8($&JT^Qt>T+GK`hLQ!RvJ+lcB
zQ}uZc<IDj8$y-^P-q5^_KKuRcvn;Qk0>tb7#c4P#ogIjpO_*XHTRDq8$Vi48k=Tf`
zWsJaFC>p^s0MH!}1Ks1-!2-0!2TTOtBFHpZc~s~(zV(YphZ5o?RX}xvGAK1%Yh>J;
zGf;G1#(~wl2Z@7)m#+Gq*MGP^U@~u#U^G2F_u~pAOPY2m7cEK8V7jma-~dqo2S};b
zfL^mHZ;^?~`qmq9^V;*lnL>WTlG}9fbX(pNW4hs&DQ^5$%(BHDD#h^*NNnGR<0U&p
z%`sJc?<3$L%{Bt_x~SKy7#0MTLzhxKOrdnUmKb4K#U7pKzG&wBlwrj0Asdy$9E*$x
zs+6nYjQOsCJ8$UZ472d=sG1#hejI3jGTV^^Y%GPetlqO}$PcAvgLGaJ6q2vY^lGDB
zsWn^5!1F07j%7VtYASZNja%vLK4O}iAtTB=3^dg04pwnKz&Ta=I6`QbQ7`zH$VV^F
zhxu_hRCJuoMp&u~SSU>Wvk1i-ydc=swe{X~2KzpRchpYts|0MU7X+W+a+4N3j9GCP
zdu52kmP8RwFtnj%kD70vDB~3kpf>bbsIsL-vUjxs<9-*=_Ft3}10oZuPR|GHv1TD$
zAv0tfI~%T$6|xN-<N$31s1b(6sT+$i2dwd5!9$LdS<u^xyRfm&Ow=rL<^U|J2b4*`
zu$loDyu3Bwh*zpsV+7}eYIXGp@!WI51OPIQ4MnDhfYH8-y?g8!rwbgMc#-}LSo)+G
zWXiMzLv`+Jz;_W&d%~{l0^0smL$E<n9hXwrl3?Dc7JbTLz7S>YN(1;L>dBw&K%aL)
zwC!Zo0*?RBNT|eWL8DvAp!D0Scn#QDvp?<Vpt#8pR00ciH5hI0-)O>KNa~TEYR?>q
zst#TegIX*h<B5j`!&^K)czI^5A%5`3e*?(=Z(ySsQXklY(ozO-nh@v{mQONlpkvk=
zYHL$Z0tI|^AO<!A9XbI_tg#scEj8!hd*Ff~$km;=hJK=oGc(yW_J@L_2Z1!^h5hDX
zCy)T1*YRWC7LU>R;>1R-$1%_r4v4{LdvaQdP&jR&GJPE>{20S@IBad7Q&Xv)f~y0v
z(9=vHN^}Vtx2@hnp#$YXk$p~R^I|}jS@+20za$#!Cw}?JV^7PXRmobhI25L@qwS#N
z`;#c~ZUb4(HiZQR+MZpbMm9V>RLC!1=*9LqQEkWM@r<AU(llVB5M+a?#muAAoLOTx
zQN^1E^1DqS#Q=j{{U8QY8|Cd2X|-<}{HHs(uR!^+D8bVtT%lcf>z}q*kI;`+O-;5B
z=FU2wcKhwlg7VP`uZwi0u<K0`*2f9r!7h?^ljR!s|2PMERehAQ;`QwMj<bgV?-@yA
zr(9_7QwN5Rec-mg*ex<eyL$}|HGY2jbaZ~qf8WcjIFy>IP&Y4OLOc{~!aEr9^H%mm
zSOooe9082J*;t{UG~I!X6<=-Kdfd3lV}A;}T#guVl%a!aNc5SjbP?yT>ptM~onxmH
zPy`*uiXPKYk&#c|v$nIayb;p08D4r;rN0&4mUiQ-cqABT*drK(hkCqvJG%&~^@6C3
z=rsc5#Rc-!)cCl<G0-*-%7F$DjCyoS-x3KZ41;h$G7|pB0&dCv*EJ!-+CcyR_CLD=
z*=2x<fyu;xR7V#39-L?$bPhDi@web9pc<aAEl>>*kjh@muug>qbB5vcijSsBf<8bD
zs@r_*V_C<57C8%4o-t^q67=rg@ZVrjqVKQZEbE1hK7)Sz!gD{X)6}e%kUu2Q@jqcR
z6H92gsu<F=c9NNdkFz%T-mBensD{VvY;SSfB;Q7NQn>1dbFk+iq0`8G84A&kG>8b$
z9;Iq8$f^)C-zPpQ>Y?Rpz%+cMf%$$)Z$ewSR##9gl0HOShltV(znBLJ-{!0XN8i)5
zMN>wxb=hw<-(c<0fSe<{r}nYRAJtIfb=0B~K)h2LqMxUdwQozl1gz1#E>DHKYn@7z
z10d<JGp|BzSNVm;z=ioXS;?^iGR>u7>j1&{LQZ6xD3#?5)Vjb6Q%08h^LPBz2m>d8
zFP$Yl%2%ouRs2l?upD0(j0F~`+0+XMz$~K;&~ZmD9;*V)4)hsKb}h0S8mF)c$f!w~
z@4{LTX>KfE=1$QqkDLO;et$>dZbz5tmmu*z4Y#o<qbFWj587Q}ox$zSKvnJOZ@nRs
z6~041lm-=Gm0m@=BDrSVbKFjaiU3QbxkMBLu#TzmyoJ#A5P#?{d8ZPvEm=FOmg^><
zTLU+t-tp~KOcV;Zp451dJ*O(`c<NsM8%US|>c9lDC|f4>1(WwmH}3!YF#OwcOCXO5
zXXuqJ2aFz4+6&gxjdM;GeY-`Se6UX45x7)x&Mb%fJmywkuKDWUV2wp(kJ-Ws(e;SV
z8%+|aN5Q@6vgI#?9%Q^T9!wz`X-0Lt5W7UnmMaiqH;ZdT0n5fFIa%_2-|-`#ddw$Y
zk(dC?DwY7q<C}9UQu(_!0Xf+jM@1c)!_ZUqJ9I3t_F48%P9UN^-6gpZTMS5LtnPz|
z6@wQAG$g}+WQ!zL(?q;kTyx$cTshZyGBgV=i;nBI;&76IaDsQcw~8H%YB=%IOag}0
zx|GC5Q+V<yjOIH)#atX|ZR2gP#!-Q+Q2YK(iLoa@2-&6ak;C0?oZjy)jVS#H$Y*ty
zVG^5wBB;--&0gpU(fpEt4zr|d%TFMxx#nJ^^9InAATBZs!WC_=(L=ZF4GDvSNl%}$
zF<qN?Mv2Ez&1qPbcc`dUWst|tu6ZNa|G)l=JK)Leh4+)ffqVa6${g|iNVXpbu^nA@
zD!8-HACq}>;yvgd`TT8-I5zwgyMXey);r8^nS4OH|7&tgG*F~g`pKA{m%KPLhb){7
z&iG#G%e%QJKf;JbyS+Lkv*7i+r`1x}#pfk?Fm-J)qg0dm*n?Za>ITHZZFHR3o!gb}
zXPNx@H|vQUudBG!#d-Cak#(@6Vo6{30#l7xe{I+nO#jcU<>=k80(Tmm2J$EfhAm1y
z2{ff59O^N}d%YtAPv7W63_u3YV1t(HBpQ#1!;ACu`A0lGs4mZ8D3#41Nv)BHQMy1M
z`544zR2No&InpOogQ19Aa`Gt$ixvw|*q`8z%3qR!WQ%Lb6+}=ggr7TfS39ffn?w9l
z7VlmlaCeQ5hzli<l#{efHV(Bo)k!x1eM%ruD29hPP@P^+-MhP6YmcuOqCn?}9LmT*
z0vnGqOko4j#S@>~b=LK*^R_4;sohoB8jLUU#W<Vsez#|=mQ-G80JX~~Yb)e1{;`#}
zQRw)d75Nl40=m>c#V>;gSOyXIMf6sO09FOwGchlf?|kgf-V6OD)cA;NQ<C>C3irNx
zW-@phIEP#M*`^siyc70JL{FtYq9=l?%1A0K9vSHr>BirZ3h|{vcrQhxEsTjiY+hTF
zId?RWmYjS+nAXu<50D+m7+v<J%^}7IBJguRP9uermJ`s%=OC2b!W92T0L6kgbj;@1
z4gV5OXIrv_-^Uq5ZG}Q&A}2QZ?DH%P{d3wV;~sj$Tg|IO!!@WT$wJ5xSKPE0**3q^
zfXQ{LsC6mIUCnmSOkRz-kCO)pavRBs`JdJmqcVI$32~qI09ox3TUzHxkAwE>+I@rv
z&=esI9k=L)DvNBHFT_h}MQ~&H(alR<n`cEQ4K<GtR9!pY`kJ8mhG6cW^7#2H55l;^
zb4`!vk>w^vqq5((pyM_@Ctdt;Kc1i@Ce3;Z>Q2)Im!XzI$P70ud}7#FXx-_7o>H_-
zt~$MWD8?=>m(#PVM$zJ%1<h}x8~8TrB+?ZUvt5`3icOZ4(#<_C<G1>D$(Iyg-dWeR
zyqEdd=ibdhLw~CvzQj11FF)PupT}=i3DgXfR7(0fgG1Q-`ntdS-)ER{T;e(=WyO)4
zQ8%F_d8#n{ZbL-`g3*Px3NC$o#5?F_vNED%vV&FgtTn|q)8_c4JJi^3<Ir@+qu^jD
zpPWXxT-a*&=CT*i8=H^4u)w*>w+CA9p&V#{3+Cg0w4#D;K!YxG6bqb{LfR3*>Tue)
zpb4%_HeZj6&vltN87&9OBRp8gB4>3;);5!YzYNCHRC~hPEci|2UY+olIhc~|f8dG-
zf$7xra19GhBGp{W>q#Jq!+PYt5|-6Ke)2VAtgT&P&y2q{()fb}#T}7bBc(7nRc`sQ
zM<<KG$I?QMR)?BA%qjGJ9J{Koi9--Ml@*M>STa{!5t1s~X0sH>+qq#nayhC&mzC|7
zF+1<1<nV0x!83pA;RCxLt)%>NGQ=A+f8T`);n?y&59mx@w<p%5m+K!K;0$bh=NSJK
zW0~|-#&|qz=<#ZfgMv%<V8RgU!~J7f4I>Y3WUZ^1|Iy!xFCs3W44t}HV&oUn%wPGN
zBW)%+=N4t==b(-qbzML9>gHaZ512IExB%gtR_hE3+(o5)Y)Qz``p^e)ISldKoiCVX
z;KMGJ<XJU%YDRE@Lunk4(L6)l|841^L<FwkbmWI9A>!zieBW=P+#PjNvt4~>p#DcS
zH0`gS1Hi``SHed>yf)f*y^f&UHqTf$MJp*-;;ftUH$&DGyLHyi|3K_(A8#-ol%u%c
z@HzfX_-gnjeX-!g%zCaS;Q@hqwM*6Mi?`_6s*CQTBwlLKhuVqv`g}62ZUf`y&N{}|
z|1`HtH%~DG9xt`L?DvfyvIbASOIM^sF<ggS!1BADi-O<eybZf-8`=JGrtRa`+@|aw
z{;I+WtrBn7(Xd%d<P;^#&v=D!Xm?6oQ2|S}y6Z{lmvV~?>(MKrrXgQg9&d28;fsh#
zTd%auL*6S}RTaPa7daWB{I69CF40GthVBkBk%8Q;vZkcI1A8Oygtph~7x#54xt&OB
z;7eewCKm&BU{P?LJQW(vran}9bi8|dNkqOiGT1g_9L7&u(V|#CHB$Kq(qedD+adik
z`nCBPD%FP_Itw;C!Uf)0EBIVFZm3<HvwW_lhnzw7EVX=DFgtqZS-4r8u>M%C^Tez+
z3AC`lp=QmJN}ZVvj@>lY&+$k#u+>b}o@Y*|B+UUPv#PR6?-8XgIn=julKSdvHoi24
z%*{9*7(2f&_DUr<Pr_SLlUNEcb&Wwo<_1{l;hr;>Q9NSdP&Plv3F4BSu@h7~${oW`
z>0Hc)1&z(P;Q@!l(5(fvoxw*;Uq|48JgHc=RHSAsNJj#>l5GP&s>ZQ*dfw;}?>4gk
zhOUZ3SqZCKHse;yYdtG4wW+5mA)h&&hz_j@`RTk#yw~~tBXt{^oLl(3lWr$GNBJ9J
zma)K}wYRk8uV{<{#n4Z^ZFYnByfhLoi!Qxq<Yn;hHMJWYQDyqCk57zrk4%)O*V_%I
zFU7VecNB-YHVxd(`^N&ex+l+$qE^D!H4YpHq)dAYN3Vf(5_?qA*)qB#Ng-HXbLKSZ
z<M!aev4)v3dE>D5f)7o;i(%JoSN&VG@>phi2SfadbP}Yjk<lEXeWWa+qH4utB9d~H
zd$%n=f->cw{(f6m?retQ^U-}T7V%*NC3|6~#H`N54J<@2&R&T*A<&T;9}P$Y5IBsR
zz)<wBA{#tf!Z@wYaWL|3i3o-B{I75qpYH<pvt`P@1-<%L3k%AHCTXJIiq3WR+UIO-
z-hQuK{dgG)M|e=BB(QzH{Hohc+V80nj(cn`A6c;EtW}J!F6`?Jq<O+%_rt<YtcP{;
zpUaKb9O}aK`;@CO5LO3TkKfj?iJ7R&R{`}5BZOQPqtH`>3*Ia#6pxP-iXt~mv-EmY
z-sPHOU0rk9T2qrvHW3cq9iIyydc4y1%$D$=)jz^DMHq7=zW)_B!`jO2?&Yj#GH|2y
z$?;1_ao9O=#T80N*MD=fOp+<&3>nup*G#kQr;TVPkw9za#>{D@x-5m}t{N3nsmx0q
z;N%G;yecqK(c#S-59Y_pur3=b#5frq50q)j9N+m!*l!p2ku$1lJSf|>Qhk_6OFe?B
zj3lo1Dhh7e@~7n&gs!#s?fHx=5U_am=vloh`0-72+1|W&bMoyutv)~Y-a6GW9^dWq
z)i<JOJ?jrSq7>fnKg<=&P;YBGIXfCym#ig7(}>3_z<RfW!keg0P*O34Nd>Gr6O*#|
zXi*9kWOg@jAt;c;5yC~P^BNEzL`rH6q8m`TouX#)82^%4nQ2iq!p4I4W<&haeYl%X
zl6L;Sp9FOkMz`wK9C%X$$FiCPeRcr}d8(*YRmMZ_NH)+;2miRnnNtjqF<d^TB=C4%
z=UB9~G*Llv=b%?e!=OIW``)ToPpQ#aM^GmGtYx$idSI&bg;GETGVzI{=$5dhgjla%
zhCG(}*7<>#?q1G}4jgD6xv470_Z4T0+l_TPLBF2e)@n>zwL9yi3D!Wh*)(6(uivG=
z+Lif9xM?U)hW2!Je8^8P$5f#yK2u-4XMZD(xb)hdF@_m0wda<j)QY~09~HjUo?yxu
zoSQB|eDn=l&s8xxD{H5?i-T#-qXeI>P%`;bE07zz!xY_zWt6s^?E*H8u^^3MPQ-$|
zks)}4B@ZB*O>0&LH${X$Q_0FaviZ0*V38m-V!$=O5yRCAP-w7iNWuEYD{UZQC*+w7
z_L0+?!d{vTDggCvB;iy&&=5Mst=<BS7-D?7@$Y{op0F?x>}4kS_&jzb51BQK%s`Gi
za<9gF0<ei2KEi!lm-ICw#4h;8rGJ>?MLV_K-$i-O84(waEP2%z!iaEsv1WlpNM73b
z++OgD3~c77HdB0L8e1FM|Cmh!38w*QYB|7qA%P=$G9|3b0cL|>93tuKGP3g1lHI+E
z&h_6%VKRIq3XDEnZ+o{0rz?tp-0~Xw^wx8>-?dJkJEy04%6Qvj=#cZNbDC$&_S`#g
zXS>9`UN?A?&aR8)Rd>g~OqSicO7M;>!4#!W)p2tUUl`ObKUI?6+Eh|$q)pu6)q@r(
zdpH}MRp@b@SHID71Jj_j5bpctO~2=Kv+=^`K;#Og9<<~4E#=8sSEmr`EQmFK6?#Zg
z;sHATLAvo*m-B1pjcZDS(!&x6@NmEy$?MnXMp*iefBgsX#s3>GUqgwkR1DOJj|GZf
PAbvBpK39AOd*|N(uFPD=

literal 0
HcmV?d00001

diff --git a/reference/plot-3.png b/reference/plot-3.png
index 17e45a61252267f965ebef123f2adf35cbcda259..e2f78ab13ab57109b0f715668463e76cd35d42a6 100644
GIT binary patch
literal 54904
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

literal 27928
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
MUHx3vIVCg!0PJfH;s5{u

diff --git a/reference/plot-4.png b/reference/plot-4.png
index 26d26629e62832bf8ed7ee21be58977e035ec7d0..1611fd3e5de59fd7a8e44ac4c8e3586020636377 100644
GIT binary patch
literal 24961
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
D=YN7!

literal 30774
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

diff --git a/reference/plot-5.png b/reference/plot-5.png
index 8dec4586d25e254c5b7d69e5663b45871c57da56..17e45a61252267f965ebef123f2adf35cbcda259 100644
GIT binary patch
literal 27928
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
MUHx3vIVCg!0PJfH;s5{u

literal 27160
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
L`njxgN@xNAG6O^o

diff --git a/reference/plot-6.png b/reference/plot-6.png
index ed646966bc5c2e2a445843385614c4c049d9c0e7..26d26629e62832bf8ed7ee21be58977e035ec7d0 100644
GIT binary patch
literal 30774
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

literal 33179
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
C0ob?z

diff --git a/reference/plot-7.png b/reference/plot-7.png
index cece3581aeb9c1ef4b7ce2c6690c103ee4b927a5..8dec4586d25e254c5b7d69e5663b45871c57da56 100644
GIT binary patch
literal 27160
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
L`njxgN@xNAG6O^o

literal 80570
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

diff --git a/reference/plot-8.png b/reference/plot-8.png
index 5d8578536e38c7a86a9b1c4cf92f7d1a351724fb..ed646966bc5c2e2a445843385614c4c049d9c0e7 100644
GIT binary patch
literal 33179
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
C0ob?z

literal 62433
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

diff --git a/reference/plot-9.png b/reference/plot-9.png
index 8251241adcd1249d50abb1ce7f87d3da78eaac65..cece3581aeb9c1ef4b7ce2c6690c103ee4b927a5 100644
GIT binary patch
literal 80570
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

literal 19275
zcmeHv2~?Bkx^5JeS_QY;wx~?CMzA8FA|NtEH&qNESP_s}%cP77G6o3hF0?AJ4FV#g
zQba^RnZpz;Eyx%UAxue7hA<^zOb7|&z8|)`XRUkBy64=r&b@b^Rn}_bO8)%$|L=Rh
z_kEt{eZK$4b7n?TpYHw?gTYAQ&wO(pgV`92!AN}f$tHMbAo1}Gylnc;#OND%g+GB|
z6%k%GUpr&tkHN@CqyN^$jn2AaFkfQu-<-S<oH|V>zUW>IZ=9vQcdX$1xn{nUN{#9v
zxu#ujfAB==$lK%Bu&%DZ+<#%$+p{umrTw<zMndO9Z`<qn{!zU?Hc4d@trxL1#b#BC
z_}nWp{|Hn&YuK{exiZl8mZ)NV^XSht?!>?Nyc)b4%q8=e#|#wk@$vKeT=fi(0#>Rr
zQz+1S)aItKcC8OIyo+Sk{#7^rN%h)4PHp}VzLuKv*4vKO-INe~kfA&*j9ARmxi)kn
zV!?=b)Fer*?at>abIv%P^WOGF9`9*Rj&fBXyZQcJqoOOFPhMPn^;Jufy1AX5T?=dN
zS8cO9y|hx|YkqijMJq)hV&O8V;T-?Hwdjj%HmiKPhQJ?d*X6bj4Go1fexYjnpe;o^
zCo3z<6~-9;@-G<77|gxd8?y91x{JX`-xe`*J486ZOmA;*Pc;ZXF66OWhU0MQe2RF5
zwUOc680)&Sytr%U&NtrW^u&Ovp6slwy+S^hTEl0gaKl)-A&t6>`!TZGWiHa_{F&Xx
z+}DJeq1Sq%nR-0QJYp_hK+X`7Zv+HncV2N>UYM|{xOUlxvckJu$OxZ))p+F4p?|ox
zB%)uLn4UJx>U<*-%=<IL`PupTs=7g()|(QNwnrq<xjQ_vCAekY10<{`t)LAKQx7fZ
z^BU_kQanp~VOP$n9@cPgZ+&i=N5Y!pRu&$99I*z&zPbS~t@&*A@UQVj-~D=rra3S$
zkP@$Ku7oeBoP2)S$$vOTTM3^YGM0Rpx(@x&z36$q+WrsONsh)uB9Y{>DiR2I<&-q<
zfwIvlCvj+HRh9qBBF%kqvOA>3j^W3cery;`!p@Jinb_G4ykt4OymXQ@B4A}G&dZ_m
z)dlaD4JHr>@u@%NJ1xIWn(Hv!CM7>LHPymn4-|(Bc`qEQv?#N(l-cKfSw?Y6f|K{;
z&8)4hNk362I0*@ftDc^+i-Tu4WLA3ElpS+7uUB34v-*g2#HjV@)QyaXyJH$Us4GK5
zmo`aCDu<lHTsZ9AUt*dPI3_b)9gUd@O%*DjVRkFlX;NA5Soof^C$O_v)xPoX$Ez%V
zeqSFw57*<`_DEAO>a;p)AK2%r6Ef!#INf{SJnX}ciHV7(MVeEFtWU+|E4+8P7I;!@
zZ0vR_(dVJOoSZ4#@H5uwIXX8&TfD*)>rcNbuVH&TFUxE(t@X#btgD-PufHL(v+`Ut
zM(wOCPBWeG{a}nX;~~F>8=kD`X|+4%^l@EX|Ec_PX$P`!!koBlS?pdv(RW5K_2$i+
zj~m@__Hlu0p>;{`LCrS{MiC=MQ3~P@>Z>1K7KX5NnaR`$Ua=rUEXYVb9&n&5$K0IM
zny#;lpZj@>`n}-Q9m-}{ogD$xhLO(pn32cP3cF{mx&8h9Q9RMc$%luXPrJ1}N*HM+
zZgUJ7O~5;D$5=wBx{kFb<4H+Q5jx@F;qld9VV;k3IA-qd?j((Y^XV&6E}5}pe^zX0
znb(lMtX=%b9hHKeJWV>CZWt#N3ZvI^`-qp+YnML!AROT^DLA}en<j0mzIH$Pe(S@-
z!?zmQ$r7cSDQ9tw82b``rpDSNiDn2<{J%W3ZRYIh=<K|ovGilcnYr7t1uHN83sZH2
zn1ee0V_SdihG>z}ts?L_*rv1E^rK@sD8M3T&uPslHT9Qz#$)4ft4l8%Ga{BJuuV@+
z-E|D8FFKudzdO%b84qhGkTLk<4&}LDc9>)FKDC0ee@6V<n?ZuPQSx+A%bcQkRuScg
zXdXpBVDdt(XjGkLk+FP%G!o7wFhhzxdtTsSoyMCRB<I_eKZO{@`@xF$>M!{^$2_C`
z!>@NWh^wN+*0r@%Vw+_X=9~zZJsPXa**SaqG==9$L77B~FfGemI<4j1e{}lQ_giGf
zh84w29ZIA54+%BW3VO%J{4qQ7va+1Vl{^cp=kBDuSa+?nva&LYv*)^K>AJR!#L$y~
zprD+*Je8*8lox3=JEfjEGpa+f(p43M;}yMPUPAH;g9~mMO>#;{K^a0NFyiwHYnN{o
zM@!2ao12>lat4#@qqn(tJ~?GW_H*?ik0xIBeWKMvrWp=>AG*O2bJ}ER<E4@fj?a9X
zB^f3Obz2r8``=5f+fsLBbM-mq#r3`u`oU}W`Si%mwE~g3|6k<w8L!C^lUjPYKB~!a
zJ*K|5$hE~q9d0FZd&RAPtvmTw8Sy`_^S?H()*^au3gk%?$kmFkHzXT`FLw;@(r|O>
zKT7)!bM1P2__m4h@iT;~K?#c=GnTYp0_;KIAB?-T`R$dXQ3~c62J|F<j9NdLyGO&V
z^-OVJ>Mz}x9c?)c+AkqfnDhRMsS|ED{YODT!Hu9GWxQjAV02+|@$B3k%(Ev|Rk{ui
z4tNqIo@@$*NV48g?FgVicJT#MxE|%{{l-HZ|9t&(9R7@h|4ZxOd3cdbhlf$DT$Arg
zk8d`xg`yU<7A7E7r<ui?ni>Rd3mmHaM&8^%Xj`&h#p=bIxzU!co}Qk$kHE@`{L^~h
z;=a~K1KumdkMIDbuf3*m=~dc6j1YGK+|lU+#qQ?3>Av_zMWSAcwy&9ykx|PSTILwr
z2~z))_Y*l8?dkf2B0!q7F!n3w#-i)P4O^w9$I1qLTK2~2k<`Q9ZxIYoRtBmk&iXd{
zQ}vT16@oK=XKaB@8yLflaje&pimg<!i0c09ozDve%Z&<zgTM`J%DilP3Y{__ksaL~
z)0%<9@##TM0C0=^S?zMiu4V4~jrgI{NGgUM0)$NEu5!3fJFnQ!lmfwxGg!Vta-mlS
zu;epz{N1ebZ2=EkzIINNK)0}SThcc};k-WgV!)hX<A#dH?(Qtl+S>ARZDsRxQ<8l^
zw`G0pSc9yuDM@d>Rl_;`x37&#_&PZ`tpZU0N_+5{;TP(TVc%*X+(l|l(N_2N_O7pW
zdwpvop2W%^Mznss$l=E@Ux%!S^V-Dt+S=N|>y7d<`u+>!omkutuj(fzCyhx9e7^go
zOJBnGv(jaoa&RjXKth?jc)hxe+1TnS2X5t%cpK*7C&e(@)BEZkT;s4BU~Eh?48s3v
zEpcKWn~i&evNV)|hbXh>-x#7-1^JfwGSdfqDf-3k)Y@^fMUL6Nrj6p;K^)2H*RNlf
zl$OSX`d|?;FQyvkPQOA>oXy&TiEonG@GzLoW*06ONn>PMoc{9jJBz@(QSklIEX9>8
zU#QtXOi;0|E$Ay&Or&yhbU$*MuBT^ZyMAYe1e-dXs2(>0Y_l0f8O$P0lfd&}$~XpJ
z{)Lu$?D|(t$<GM91A{<dT!tHBfTvhT=?DJ$x%E%w<@{Uom_ys4*8MU*KEAV`GnHWN
zh$j-o*uqaD546)0-vjtnSVn{euK6A!EGvcL<w9(eq`}P1`B*7wX(fEDA}-x&IorvY
zB<glrv1BYf)!v66YfnqThRpsdV>GB7Bwk&?lROK^ZsTOcqS|~T<~PPE>IKhe0%0Cz
zFHCgB*KBzB*Y=f!{@1Th;s`)%isi97^C`bF3@>?nO^L39zYwvfRtifVM@!Z5KjPeQ
z58G55E{xLWa_Cj@SZ(@^u0II7O0Z(s%<JuOh;Ov8%bDpM4#$gLxmZ0Mb9!%{bzwUT
zCl+`Ol&J<mh~&j)z!;h9&3;1~8B6h1_$TKkZscBT=QI%>*M!hs*u(=1QqBlFVpr}X
z-#<J(^!j#R$yE!p41=^^@5;CX#aB&Ui`*-vMb<O1-P3)=un_q!Fjsw*0aGE?%WC!&
zhlrv^;$YElsUfB4rZ&Eyic=XjrjddF_vu99Z^wHarPl1-<-1>Un?maJKGSDXvRbBq
zCw4X@s@f?LHXquDL=wOdct6q7?EeHRKp2qrR^I&XurH(fTdE_8FtY|JOgFAqN9**&
zw|~C=IS&6n#Q{6M22IGrt+HBP52yEG4&73<D}#V<zP9ndS;V3{J>ApUdAQF6gW(z-
zI@v!k;I!CFRlpod5FETQyMdwo(x%w$>~G}Z7Sy8~fq`bcBN&WQ40n%=`B1ooZrIYy
z@3aMk(AL&ujd-j&MdW9eu7_kh%tJj3HsQ_Z*7k=dZEo_VyslllR+NOnFyb!VI-1gE
zt<Ni##F)AoY;n*7X#@@Y{}yCEAH7*lp-{SWHlV{V?Nr@X4Q!?5>DiRI6)q9pN4h;`
zNDkfy8H~(l5d6C>tw$ZWq1Nf4levIk%9i8S#E*w_whF=G@wnCfh%=GG1T9YOfTQMz
zajV0EUz82*L-K-S*DmW}5ge=S%SZ*5G>T-qVwWZow(0e4$$3fQjAXJtAus~!zXnq@
zrfs*<_%X@pz%}4e(Wn;Ex$PQMy?AZ}ze@1N$bgir;jV-?5cW~W`aKKVN@<QM#N`~K
zpM@5>_{eW}C)E)OK=e5t#0(E|44udp0noC8jGKrRjA>JnOFe0B0N%(`1yyrIF`qbG
z^V!-LO`0nt8O1P>#eSpBdW-KY1gm^X27yCX24rCj$c9rZ<k&+kCNK8b%_kIw?E^5j
zqx9g~my47R&ZJK@s}#1P!DRaqb#W_QIQ<0?MJ%Ma_Z7L4MRP61A@gq9u4`jb5xIF=
zH9#>ZVLxq-!LQZc^2Nd6ZYdhN%&T2bM|)p63*vEtcza-*f+~uz>PN?~&<~y1yyFWb
zEYCNYM;x(s3~^<w^2*((dh+ok&?ntm5><8lM$VwglEX#l5qa*!MC>j(xmK>IojY>Z
zN%Y|x)g9<OnfI<sRo}jSyRX#Kx~IS)rA3{hSI&$eI0nD}9^0f^K1h<+4IDu&jC#N-
z5Sq&Px82<dQ2JDymVTCrYM*BjS6RbkQ*^ROQh(#{Pk{8ASq6M^*g}?K8_45P>0F5F
zXq@PMwRnX~y|r<RT5zmoo|TmT>ZCR0xI)WX5bn<(y~)?-hL|f5re9g>^EGhu8e}1-
zs@S9ZIY79TC++^6DFEGem8aK!%H(8=1eYRep={M(1@(C)Z05FNtNH4PdF-S;g-@W+
zp1ZCEsJ$Nq9Vma3g8?)LGP`WxEuF6a6hwR{all=xHBNqQ;%dlHIB4vk1K5V!qSIp{
z-jrBnoEu#G{2^K&YwwzF{TGq={uG@4YXzr&mGMQwSlz`19&ZeFuU6-AVh!eUPdQ?}
zs8vF92y*bLS?sA^%=fK%=D)D8;6f{KK$!#e4?kD2a)HhO^q@QiYn<go-UF#>qd0}O
z<;5u~Vf9xTr`F%vSO;y2u(H}da)&Db)BlI~ajw^p_tD)pl{c<31nog%s=gs6(0Yl7
zoCg9L4y8js@e1Fa&!Gz%0eg!k3s)yY<{M+>TN+|yHI5y7IN(#I3i-|iI5&^W%ph=U
zv;no-D+CYS^ct*q^*i~s3f#tk3Orh`xOy$|pbg57PocjEY(idM9{s$*-2FH#ULj=U
z{?@HqQ?<pt&T+0lGa-Yvz-@N*^(6y+5X`e!koBR-XNNim5|Yv-zjr;GH!)~)#W-Ox
zp5#`X45h7R@*>CvS#buBur}pB^pN8JWpA>6pKLIduE>w(*8_`eYl>Hn$67lCbibU}
zW&}HvMv~prcm2+1DqJMEj2dVnZhi&)weWc0c*kRGQ+3Gv>FRX@kWWciDo!l=gG8mg
za5w|)OAbZ6ifxLLl5N+G_?=1X$bJufDh=ofmX(!#ON|+E5-&Ox6UD2S<7yxXP!-kv
za1dkqKymf%`AcCa^IFEq#x!6HHeoLL2^9Qh)yQ?aF#Kq|k-9S3oi}fRTeM)+jG+!;
zJG1h=Ju9m35ALk5uO9*;LbN^)l{b^bgS)POfl)FJ3gQFkd726x#VrwI8!#2`)=r+Q
zx*J;W#tAk-zk31DUFZp?i_u&~2+N6tURr5+#zen6ze~Oy$YsYc#7xZ9-x`JXN33VG
zQrh%p>Ldis*0rR4CW#}4ipw28P<pfoylHIH7WL{w9|UHp$L^1qzSAds&bb0T%qhz1
zR0zL{2|Y~Ux=M|4ij*NejOhkIbcdgUFnpt%0}~V-LD-79bl{N((@?Eyx(KM)UvKig
z2I;SyjX>i_g;u!Z%w!(~m=fMGZ1&gf{3iV>ZH^|*USo`W|DZ$V!mY+_3VKVASkSfW
zq0zMaOd`L2+<9f|Mh2(`f<6h%(~?}C&6R^U%S8(7Sq*gPyY5NR@(yiNac9BO05Kbj
zhxMjC?HR~rq+!VuPg5H7*81az6pSSq5Phf~w#Lfq`azGH1^hI$ts*6reEd6TSK~?0
z!%hnl{qp0EkPkm9ld#&%u=zhirjDS+F#xPX=2TA2<p7S7`8<ef3&<6^wCQ1UO~Ao5
zS5{W=?Ou0Z!gwP=?5>P@JGA2Mes9soxPfFoed=C=c$F(2lTchbLDI19alAsM1NtAC
z%qukD3Vg$cWr2Kmz0}wuqt@DpTb%_sT;|1DeB?ox@#%ee8Gvowp)#+&BWr^L9X@ES
z;@bx=xIAa;O2)qq`b(sCK`u|<Wv$&;<Kk1Kg;crW`nBs$riLj&xWN>-ODh_rp1S*m
z>u7TVwD#;ySAP{;^1Ba$_bDT{?(=F)^>))zicWOXhff_J2G`!kR9`<^%H88kzEwW0
z@Uh-oq}6Rfh5y`xKVSbFj>C+YO%G4C3`molp}Jm+Jh|>y`VUWj`So2`k5yZV?QEZ>
zrb-a~tO+~8%`^M-F1!A&F%t`$k`0R1C7N$LS_jXY9_;#(ru^dKzTuOnPMoj9>~eDx
z4{7e*t8s|m{=IHv2u1uefuqAB#JNW>2{`^BbKU;^>pn8zlbb&_k3Tj3Ewaw7cSIu`
zdF!tq)t%2CM1F)YnHxUF;>LZyDd&Hl0`p%w7SDb2w`BSU1O$|-t-~zr?KK7KQWuB0
z%ELr5S_zK}cFgcD+4<H4<OAhj`NSjh@#8&GQc|UA5|~W4FzJco>wLGB-I#c53lx2M
zyO$E!n@m7OjmN537qmjP^t9iOIl*2iqwcvaxve1B0S@o!?Y%hlSIi0At+t<hnKb4j
zZB0$VfCMH~lly&T``I287??jJ1#{xhRfG8>gDmC;0K=sR0Jx%6ZonKr6d_tdLFXG<
z@Mos@f15QgFl}YdT>$Tr@l(@e5~Pmu5W#4YhR3^Sa-rjo1$B}J{{TOeZPFTeTUfuI
z@oDQLO%<orxumYa!9iXxmnasBKy{)z1kn?a*K&eZ=p?1GCX|FqSR8$D6?mDBSTqlZ
zr^bbi>=kszMLft5jVP0sC-aKwfdj5c*#b+Khl3JI9vxdg32wQ;N(*|LoBOq-{Ec&F
z27-|VE)$o1{_FZEsg_eR4iDgpkag3h<jS}CCTqe6V`M|M>y@ilo8*HA?_&kMjRs|m
zxu~cpIUq}Tl9PCumQuPVwq^3S&m_Kw22_)0VND_y*-9Dj{dv$<!!|+k)V6a#7jc3+
zqU7m%vB(8aavAV0KMPzYni>MO#z$Dh5VR|6P?rXX*VMJXnfLX@Al6u2{2Ft?95hHs
zwwaj=f59Bcj=qr=S-v&@vX|!%1NYZSY{KHL3LVp)K7DF-dk9OOYgU;b&x#AInEol=
ztXYSZ+7;umF7x;%sofVK!|vY?jzr^$Jr2r4s)o+a&ZM85C=qD}?(`GoWOB&ub?WRD
zK2aR>&mVhC#LT#T3CA*PJ-1m;=~c^L_3-cz24xt?rhixh?_?VoZU^5NfhATK())`{
z<IKd#$;tkR)2QWJrXGd4<h;ydr>K_oe$~{!WlPTs8;jvPnEiL)jVG$bS5{6PK6fy`
zc>RUH)!9XX4hpUkAP#03UAvnB=m%w4b0a`RqYup`Ifmx8etOe(3gW=7t}1kK5)8sm
z8a`il?lXx^Td!;hb|SD#U)YvD|M-@qwAYqkYiQ?!`HxodRi-_CbFg;Uk6*L5${#<9
zFAARhU`CO$13NCsMF>qcFO*0yn3{MPSi`8TSF4V2zn5_wpV3*<bf<xUrR1xjBQk^j
zI+OVL!hz9;&arsXVCYo-l&TZh=fH=Vu@5f|tgFpd79H3jMDYeKy6g)FT>DF|A`IR?
zRvI#qopc23r7vuXmAGKaJL1**a<?_Ijbp0&5^Ukm!{M9G)>Iu0;L+@BeY#9RyS-o2
zz6mCUSk50-@;s*p<+R1h&N~5X^Xj|r!5P@$3Ip&41j=|UsC>^qz61APb+QY5ZG$dS
zpI(7j%MYg4TE57l^@5k#uU<;qrTM|v$mlqqL=o-FIvvw|Ia)rkGs`Fk+&w+})|BU(
zNR?p1A?umH&4Mc~(wO|)|Lzp(TF*SX{oe$ep+t3pWt@E;LcaOkyLS(uXRU<aEi1bs
zFVW!&cF(I*d(NIc8~O>x0YFMGk2^NzroSOH`Me4I<=@2w7gwO>z^Z_yj5pI|m!yJ~
zTC?Dj$R`zou@nuT!3t~>DA@j@*+vLM%$*Na%oU%ArFumrd_$aKhJ^I7ObFPN_^)@P
z5ctnP97~U@SFh#<Y{&S10g^%!^lam?;L@W0uzjxw0IXB5F1@~m+y?j~pmmAZ%vJ9g
zmGznXk;DXsQzd*L#OBsrM}AuS`QMSYY3JHyocs5&_;ODrCet0IL>u?C1X!`)KoGQt
zwxm3IgnAUFDO#$~BxpvdaVr>EQDiX)+_V~Azh_NVczH<)(%!#=G!T!3_U!YyAC?dF
z;pAmC+)R-ReehbnR2sv9e`|}{n#p#mkYa$K=D=`<pw+zy?nyKxi92IxXlNs3d!@{{
zl|P;hfR-^?yegb0Q^VC1;q!rfXVG-Xy$t<gg-rg0v9E)5?uBNp0k8P9Acjt~oZp#1
z@YqWeJWH2-gFJdupKGQEW#f8`%?qTS<LkCy@vu$7X%r0SE%09z0~S%@=%7Ef?dR{e
z4CvQF>Nx0FeQX;}bd5A3WQrqD-=SPpJ;7LKWuXi5#Y2#c^o3js@l>g0CGmI<6e!5e
zQU>neGM6{V$<4i*HI-O(Hn@18W2t{xyZi0ix18(4?o=0%eO^wt#DamtM80nc?0`V7
zoNanDCt&Cb?XSJwIMJ1}689*tn^<L0KXxI1wpwN7l~t&p_qns{9lvaAYa_#f8qiAf
zf*l6z#L|)ym+9VDXv@KxzWAcJz4^`ky%tVR8DnE(qQydD8!{t+TV9%SlL2lMRBgr{
zc@{K92-()W@^^GP?u4rMl`#6wVP(vV!n~Tr`3!NGw87F4)|2o7wi?W(Fhxq>&Y?QT
z=_evJELt&QDRe5JTx^xKDbjCq@J&6~ZGlv)_G82M78!NbGe2)h)(!GO1;Ip(j9n4(
zeeJBQt&>jP-sB3_9V(}a%XnXAl6~G_bvBMQ*P>2EMr(auZ`O<c$|~Z4d1xn9_3W!l
z`8leA7IQe_3k%<!I6}SWhR}inUQa+$f^qiNork_eQ;h5<pjf#>nv;*pqq8a9&o28P
zPOndij+A)=?(qj$WQi_j6oJ)b4<4LRRV7;_n_n>_gr)2pQsfiT3W`;vnUY4JjB{sn
z#GoA`3-xh?QU*M{x?y5bqmIn270xYmndiKEbr>ND1L1T$BvSWZe%PMIA%ILH5KxKf
z$g+g=q8>ZnG_VvY8_8Y&20Tzzi|M!^&fs7;pB}Q%X*3V_><%JO2vf*NLWYZ0$n@Rs
z4SLdAuA|l&Owk-<5Vbt3{AQmjcH$0my~DcGFAb{#(BiqbOXDe9**IhA7v=t%2|3+B
zuK}Ho1VIHVscP(Uxdgc_<4syeYXiTZ?ON)yOz{^Dc6i$JmkMl450ujb?Lg>DN5PJ|
zoMy+~|9u*&y6j+tHT8A?e-Y%XF&GFcGHpRI{u)_y%Kw&ZH7ZAgW|~a$q04^@qzBMI
z-eO)<54Noh3o%&CHFpK!4SiHaE>zJ`e_a0jv~QYTh~F0nFa9GjF;Uv^180Hh(S43n
z;fNQrz4W+~Wz7?DP5rqlZtbbbXmpdomW5Pn6e4l@yf=p%<>Fz7P+)NNfeF>oo=vBe
zhrV~@fYYaaknCR!1DXwhW=hppY9nO2u8EYmn5$Q=ym|I*7Mdb=0FAEU9n<Zr+FG>p
zQ(>mQslp;MSqIs$R+k!aWrQ%!AQ^=yLaiv3Ox47~b=v#4X`(J^zkcnt_dlb_LXA0%
zt8afQYg)0hwM7MW1T6kn_@a>cF;|##)EV^$2a)@`XWz=#mO%m-B#Kv(k6r(+$`x|N
z8<;A;$=sZ=is9I)g@;GAwF|9@c`<E`mYfLfr@D>nL!ZaQ6gpfM9gXlYRc)Y3)im@B
z3juD8LSxk{=mi=bX#S3k#GAJpfqpOTWTL}5IaLcS*Tl^`luGPaG2*yp%ckr4(=Y4i
zhHh^g`%yXl4LyjN2C94|omVSp^K}C+onYD>SH*~tQqhOG$vy4Mz60~YdF~?0EfEJE
zO;4)IFW@y|k+j$&J1hedZ>~j-+vL04G+wkZ!9=I@WasAK$4LaZ6A~76keTo2dP4FO
z)f^tdRg7e;PGlUYte+%6G^1t<5$aw~Rlld<^HQ;&-s;k@0Jc3m+`jkpNQ={|U(`0m
zbnq;@K$=9}D}QbcKXB&*5ll-vA^~8S8e^`qnMJTfUF#y(UG?#4hm5QdF!?TU3Ifl8
zJRGZg<hx&fNQLFKOUKWptoOUSFYL)jD65Nw^RVMa9nG>&<-}97!rBy=2p$YaYCw<8
zt|KmIpx)2dNo+%#S>B)xKk!ivdne~*y)=2gUDv-|hvkCk#B77Cib3M&bh*m&>jyJ)
z`g)i8EgQ^-Sy2n`X8oZG=|H~oe~VXk?Z`ZN)yu2(_BMlu;CFO=`x730q;YMiE^z7r
zL80UkEQ!-`3TcqubO3MWHmAN#kfWW?eK1eO;Sh__xc=dnX(&G-0|Sgi7k2jyDypcE
z8gA1s=~}T8iXydBJQjMOCMe?r0pCf*$|UfZoSt({OBPqf>@zw82g-4^qpH45u+gUo
zV%IG%zswk%fJM;LNB9!f@KvR=j~?)A`8D3oEZKxEyXSpXk3aDUsydx%6udl<6OZKv
zH|id@H-O6yTkgs*E8;1Wb5i|`4FpZ*V=$?XsMQ2j>Y0gfZ8s8DfO`BzlX*R>Ewil}
zRIH8AA`_<fr-A}CpjmcauTGu5xAVS*xxS{I581UU!0N@t`}laJeR#E+g|}b?6dCT`
zz5D!ug!51nU~d)+g*TYh;;|^-A$vo9S^ojpniPV-%R3q^=fZ((5TBs#1h<0$vl<Fu
z$k0v6<N1s7++d@ISoxIva>jA^>BYrGorMm=d8Cgw_4_t4pDmiz&;=O#rU+e&eCKug
zZ4C{yf+G>Tak^dcja0M)PzMa18o@I|Wwel)*OII?HUCAB>qRo_btMm4WGKwM8%wGx
z{q1FU@1E-}jL^i-l@^Ap#>B*+46+I>6%~-hplQ*%$@9gSV4d%2`b2(V4bK*>Qm9SJ
z_-N}p1$l2*2hw&QkS89Pprqxx*g3G{pjLPxDuLjccNLtY&zG{|_j;oY)<&0p*1egn
zI{NNo;wvcKTsxa{YwGy&c$Pm<i?TLcDOgG%A5-3dsq#^mIZod_Ex>AZAqVGu4d)A6
z_DC0an{syx)s3dKtNh1WC+3dBuBl*BssGIYt)O?6sMS#dmGAF6%+3JojHc=gMM{vW
zSEYzXh%rkuU))pBKi<@zaWLPpCNyjDLEa-_e$T7O^rtGrp4K~Y0~!&v1<G+5iYwzr
zx?$Ce2P!sh`J#kSJve{KK{@Tlc}rYH5WfNvN`VfHVlkkpHDgCVtv1ocduX7e<K^pc
z+GO?LpX|>mM;i=uAWb0j%z`0rGr}!*qCI*O1LeN83)$+fFq-{C%k&9KLeII0B@3t_
zrkdrJu|YLcuob~bF}$RU^<cm*Q~U5Ki3Pv>7=rV>F&h@Ow|^sS4OOS=&6@&VyRV!c
z{M9^*N|mXd`92JodpnfYp7+bQH%S?jP~+|M?mqfT(lF!@U$kq|H1*hFl*18Y0$t#+
zVYD=RLBhrJ#M|X4PiI@oE(+v{0iVxiPv_77tt|sb>0;mDX|y2<3=7o(A#jLcGF!@{
z^nyR7`}h|fT{i*{%yK6*P-%-Jv;HaGWfL>AJ$bc`KxzZyk_ZYfJeOwPyA~Gj={{C~
z>N{kUxDjwgo08<f2Z}m(HJ!hWTX}ilQKu#NEOmv?BxX$o0v<bWm_2O1Z>3zLd(g^g
zjGD35EJpK=putfstulfGY8~fHC8E*VKJzzqTIlCzn6(bF(y$_ny3BN4bJ7BvQSlvZ
zNn(AttKJUK<NjT>%Kgwq^N)_91PFotPg~U_a42$i-ldiWFf*o)j(!c7KtzTXEFPlC
zVBzt$QJ6>vuJRL5IZQ}pvJ|gYmBMP03tKk1V6gR>25{N&8+{0@qrEKM&n+FE=gM^t
z`j*CSTsS%!TbOn@qRd?s=3uUXo0^<F9#&oK{{qDpeMOd#<snA{4QCpR${|3=;(ww`
z(X@WDV(t6vl+M3JuVO11XzqiZT->V9AB@j7Ng7je5;SiTI%+Qak~J?JU%l{_sB6*Y
zUDJvDKai`kTMDOQVBK}3d;;|@udt8`IySOd-|1m`<mLN8ff#vUVb+9<Ux-jcNH}mq
z@&}k5l1XRD;#jZow)&38hV$R6hwVY@F&)fQNbuqh`kO<rm6;|V*|$T<^v%o5_5I!V
zt5??rINK_V#cz{pAE3>m4z@XaVR-GiN}Bn$%rAZJ=x(+CJ#vD=yj?|J)FnZscGr>(
zC*);;2k~WL!}V~;;QpX@m96miCE1ezZ@Xlb_WZW83WWR~*sloo#Dj>b&F7kjqwS*z
z+!eh}DYeWJC)ybXHDve+xnuoSc~ChG$_M>SCa0$S86hlJIBk2Poe$b#^b@3DP}IQx
zA7(SK!O>mXaeNfvS}Yn16~^f)Y7(iP_(j+9O>c`qL5Q=EJ3YXK4zbUT0Z7Vyz%~5e
zeQV@8SaDqdIVufNlW`-Q2frGeUKEqJi#pOqF}oA60@!3r%Vq^VEhfJL^4P`mFFJd@
zyw`(MZVO=Pk;lElA7|%d?qw7bG-5JF(<M{R2gOYRNAY|AJ#bwxOe6tl(}u0lHzGvC
zioQ4KwrNS{KBKeq;Ud=drn|72tf&GK{lZF+q2>i=d#;C=J~#mGF+esD`nEhKQ4EB(
zf_>T(&u6Ni^hLPS2R<<-`OwdX(?fEPr^w_62=n7v))q!Wpo88)H1?H<YVeSZfN?^F
z;FRxwp=@=es2e6f8H==+s-x7)Q&OKtfMswDtRx4kVy)0>8VIwTT84U(fb9!mrO~RM
zL>r4i8t6jL1$djY*c{0b{ZdR?34HqdtxpyBitJndh=8vHSQTZE!_hJY!t%(%OlKb`
zk>McKReOODm3;K-`Bm6I?|W^<BVBRE?LrKr5(p4d!l*E71FL1ni@p~6x@&sfxn5Je
zYS-o+kc}%d3+U`y*bUjnsC;VbjAp3zXE!5dLdiYa2h$v4G(jn`526RG!F4r<eva%I
zN)+#-726ReP+pV9KyIbfvrBv^gW6~4ed0aQawII0XptO;^~43Yfw>Ms%Q1)9D~2Fw
zhBo=!TNCwC{haLVeTY1PzM4F;xa~>)CTY2cL_rb}PfCTA6f*uey1yXGGtJj?Zlnnj
z&VhMzozVx_rat$KG}!p@k}h&Y)_JtO9#XI?L{OSShI>Z17ITFYG*DIrD_I0qyylAQ
z!!X^jfjD%kgpnqKc^eoXbcFQd{ygB{06us3O8<kvVLAfc`RRu!A!OD`YtdX1rFFJZ
zF=LBbMdq~a0sR8B83nm&rc1ia1T)dNR4h{QY5|Ta<7;`Pg{5tK`tKXJ#~C{*fA+0r
zs3(XNyWCUnW08Wbz3iEAcKb}A)$fTr!7C5w{^BtP2qZ`=9;j_a9LuMAwgHkyw#i~b
z-tHRNJ9To^9W892v-ma9UA{f!U2pG0geU>CMHIbe-`lNuAVWCFI_|IvbYdSqiSwmH
z{)%G2yKl)Wya6!kq^1V;U!BqygJ<Mim0;FZA4GOCXj!^+njJW&q~p5LP7Nf1pyZ`i
zIsQbNrVpz5!0O8TZNy{fu?|QqzpGwb(X|pjpTeBJ(U+T({s<{K2#V9}0ue%vmJhth
zokctu7<w{LLM8L`K`m}Kh-LHX{OX*p@PHtS?D?2KuvvktX!>Gy;}aF_nZChh{cT!L
zfw_S+_j%iGho<WeAlf5EZFzY)4CEVcZT^_F?({zpL59a2w8O+6fl@DBZrvp4Orvc+
zWs%RQL}d;58M56Xk4>4n7R?f{vyW85Jsg1P*b7DZ1q+QxGy=1WNrYI)WPt=C3LVfN
zzNc~I^3Q))>%JK4vEZ|R{W|ppKgjuQ1JLOZ&BhVYlNfrc)(3&Ttj*HeApvo<SB(lS
z834qPQw$)fZ}^m5G2rsC%-hn<;HG&y5o3t(a9^=IB8{%h>!rHFLZ~$0S3!>ma03z9
z208~QxgrQ=Bp+}gVs$<vsDfJDeq05$G!&q<f}lNGDv|3Xj-YM}>?P3|&%AwHboE<^
zFL#`<Pwx6J+Yx=8UmA`pr<Ys-4As2dNUoE^8G_5oNe}giJ@(-T5WMsS;3{RJZB<Be
z9$@gw;F%Q)2oLs;eVAN>KS=g3XM}nxgfDa=u2sdYC79{W{xV%X-!5OE0c^}30LGeZ
z0ruBDpig^{ZY;%jcyNLY|4E@fM--~zLg+zTR-&Ay#|7v%@4`*0@b!A%l|Jyd2W9a$
zbPZ19Z1&UZQ_IM4i&VC421}Q~Q^gMmmdN(VfJ|l)!|0#9r_uff5@!-JGOfvhi#dqZ
z0yU~|MAT^Cz@#zpV1lurr@S@+X%}l`9=7d!6}M^i!F~G!yKn{hCIvf`f0`Th)&A0B
zd5>vA5T8=SOL5{iz^MFyW>|#_VTVkMYm!4E@>GEW7SvtNlnn=})DE7sIS`Kyt@Xtv
z$G-_`v>tX}+=Zi6B4MEGtoG=WyK4O|);XO4?Iz=uXIJ|6brNrWnAqh+lh7;$Mac~)
zB=R>sUp?yvN;BfEWqH1s(0I<h!Ul7#Y~Vb{K<*8)+<)#^%3QI@6Y=_Au|pf*LRC+N
z=O5U>V>qgGpIg@>zc_62VS)O=z457Jq;}rN6C^Y=G$2l%vHUJ4)$YW5uV$*+kE>fg
zi;t8!Lt3*b0~R>~EcCf|F=St+c$JT)Q|?;bI?DmI6ZbD1sojn1dw@vxAPhDn+Hent
zPfwiE`qe$@8}Y_FEoXZov7VI86i8-ym2E(6fe2d$q+m{2G%b0EHbl02-}(59Nzk!C
zs`F<L{_`UE|Dhv9D+}d*<VyfhisDtufDiF`8So9#M`2a^Xjp!NIdT8N$BqoN9T${n
zPQ-Ae@MD{P!pG0SA`h!!wWjH6qssayCB+})I~MH8yK0>Mc1-PaOr(MtGPb1H!0aJ0
zZ4jUizQ?g!7v%V|Q6Py3w5Orf4qisc4`yY9el4~MTQDcKx!r-?2feM(lt7QEKp+i&
zBy?f?g=0;nw*W0+G;#PN@O+B*(3DC;ewh<eM~@zL0c8eHg6&~cL|)^ua3s}lu^XO#
zfzmXR6EyR-V<OY3pGkqE%h1~X`l)tME3r*9NX+QzD#p+eWWY?bR)t(J{S`Dp!^<Dp
za-KZ~6>KeWu+j<r3bMzpT|y8R5!9%Jb(nJ-)((1wbV0O%v5Uuqriib!&d5J@TWx^-
zSxYt0E_&Assj!<v;X-oQZ3)-hx%RXLkMSUi&;hA2*e1ZpYg-};K5WEfdfLB+0n{w=
z>MN29?7fU9!Ey9tZC}TaZB-y6U0?9vH15bBbWTE5RaNKx-*-U&vk(am=mLPd%oS&>
z90Z}6iohTs&1^E6+>^Z?({UU5k1{tERD8H&ns!_h?}u_MkSu(US=UTg#_G|vJr_vM
zd}b2^^B*<_o`T4>X{cpu(koUlqKr$1suoeh3gh@^v@FdI$72CR`=;c;&Gw+sjBL9C
zA{!E;kee7}OE*9sxrK#J+z`M^O~8xp!=`|3NP$9o4ngDW&ioF82|Z$Q6rP;p2Au&C
zafL=~gJ+qLuwap79~wMMLP8h}J|3FK=(#Pa*M8o7-5UbNcjVLG3{-x<Z8G}*-7K<9
Z^!+t=CrKKsg4RF&l-V~0f4g++e*hdCLm2=7

diff --git a/reference/plot.html b/reference/plot.html
index b716ff919..156bbf0a3 100644
--- a/reference/plot.html
+++ b/reference/plot.html
@@ -9,7 +9,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
@@ -308,7 +308,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>  <span class="co"># when providing the microorganism and antibiotic, colours will show interpretations:</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">some_mic_values</span>, mo <span class="op">=</span> <span class="st">"Escherichia coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="plot-2.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># support for 20 languages, various guidelines, and many options</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">some_disk_values</span>,</span></span>
@@ -317,7 +317,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>    title <span class="op">=</span> <span class="st">"Disk diffusion from the North"</span></span></span>
 <span class="r-in"><span>  <span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="plot-3.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># Plotting using scale_x_mic() -----------------------------------------</span></span></span>
@@ -333,31 +333,31 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"without scale_x_mic()"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-2.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-4.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_mic</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"with scale_x_mic()"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-3.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-5.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_mic</span><span class="op">(</span>keep_operators <span class="op">=</span> <span class="st">"all"</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"with scale_x_mic() keeping all operators"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-4.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-6.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_mic</span><span class="op">(</span>mic_range <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="fl">1</span>, <span class="fl">16</span><span class="op">)</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"with scale_x_mic() using a manual 'within' range"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-5.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-7.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_mic</span><span class="op">(</span>mic_range <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="fl">0.032</span>, <span class="fl">256</span><span class="op">)</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"with scale_x_mic() using a manual 'outside' range"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-6.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-8.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># Plotting using scale_y_mic() -----------------------------------------</span></span></span>
@@ -375,7 +375,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_violin.html" class="external-link">geom_violin</a></span><span class="op">(</span>linetype <span class="op">=</span> <span class="fl">2</span>, colour <span class="op">=</span> <span class="st">"grey"</span>, fill <span class="op">=</span> <span class="cn">NA</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_y_mic</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-7.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-9.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/ggplot.html" class="external-link">ggplot</a></span><span class="op">(</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://rdrr.io/r/base/data.frame.html" class="external-link">data.frame</a></span><span class="op">(</span></span></span>
@@ -388,7 +388,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_violin.html" class="external-link">geom_violin</a></span><span class="op">(</span>linetype <span class="op">=</span> <span class="fl">2</span>, colour <span class="op">=</span> <span class="st">"grey"</span>, fill <span class="op">=</span> <span class="cn">NA</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_y_mic</span><span class="op">(</span>mic_range <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="cn">NA</span>, <span class="fl">0.25</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-8.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-10.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># Plotting using scale_x_sir() -----------------------------------------</span></span></span>
@@ -403,7 +403,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/geom_bar.html" class="external-link">geom_col</a></span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_sir</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-9.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-11.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># Plotting using scale_y_mic() and scale_colour_sir() ------------------</span></span></span>
@@ -425,21 +425,14 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span></span></span>
 <span class="r-in"><span>  <span class="va">plain</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">ℹ Run </span><span style="color: #00BB00; background-color: #EEEEEE;">sir_interpretation_history()</span><span style="color: #00BB00;"> afterwards to retrieve a logbook with</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #00BB00;">  all the details of the breakpoint interpretations.</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">Interpreting MIC values: '</span><span style="color: #0000BB; font-weight: bold;">cipro</span><span style="color: #0000BB;">' (CIP, ciprofloxacin), </span><span style="color: #0000BB; font-weight: bold;">EUCAST 2025</span><span style="color: #0000BB;">...</span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808; background-color: #FFFF87;"> NOTE </span></span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #080808;">  • Multiple breakpoints available for </span><span style="color: #080808; font-weight: bold;">ciprofloxacin (CIP)</span><span style="color: #080808;"> in </span><span style="color: #080808; font-style: italic;">Escherichia coli</span><span style="color: #080808;"> - assuming body site 'Non-meningitis'.</span></span>
-<span class="r-plt img"><img src="plot-10.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-12.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># and now with our MIC and SIR scale functions:</span></span></span>
 <span class="r-in"><span>  <span class="va">plain</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_y_mic</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_colour_sir</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-11.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-13.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">plain</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_y_mic</span><span class="op">(</span>mic_range <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="fl">0.005</span>, <span class="fl">32</span><span class="op">)</span>, name <span class="op">=</span> <span class="st">"Our MICs!"</span><span class="op">)</span> <span class="op">+</span></span></span>
@@ -448,26 +441,26 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>      name <span class="op">=</span> <span class="st">"Support in 20 languages"</span></span></span>
 <span class="r-in"><span>    <span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-12.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-14.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="co"># }</span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># Plotting using base R's plot() ---------------------------------------</span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_mic_values</span><span class="op">)</span></span></span>
-<span class="r-plt img"><img src="plot-13.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-15.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="co"># when providing the microorganism and antibiotic, colours will show interpretations:</span></span></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_mic_values</span>, mo <span class="op">=</span> <span class="st">"S. aureus"</span>, ab <span class="op">=</span> <span class="st">"ampicillin"</span><span class="op">)</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="plot-16.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_disk_values</span><span class="op">)</span></span></span>
-<span class="r-plt img"><img src="plot-14.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-17.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_disk_values</span>, mo <span class="op">=</span> <span class="st">"Escherichia coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="plot-18.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_disk_values</span>, mo <span class="op">=</span> <span class="st">"Escherichia coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span>, language <span class="op">=</span> <span class="st">"nl"</span><span class="op">)</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in rbindlist(l, use.names, fill, idcol, ignore.attr):</span> Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE</span>
+<span class="r-plt img"><img src="plot-19.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_sir_values</span><span class="op">)</span></span></span>
-<span class="r-plt img"><img src="plot-15.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-20.png" alt="" width="700" height="433"></span>
 </code></pre></div>
     </div>
   </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
diff --git a/reference/proportion.html b/reference/proportion.html
index 5e3c9a6e0..ef3e8fceb 100644
--- a/reference/proportion.html
+++ b/reference/proportion.html
@@ -9,7 +9,7 @@ resistance() should be used to calculate resistance, susceptibility() should be
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/random.html b/reference/random.html
index 933aecc06..045183c7b 100644
--- a/reference/random.html
+++ b/reference/random.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/resistance_predict.html b/reference/resistance_predict.html
index 25acf2e5d..4555cd333 100644
--- a/reference/resistance_predict.html
+++ b/reference/resistance_predict.html
@@ -9,7 +9,7 @@ NOTE: These functions are deprecated and will be removed in a future version. Us
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/skewness.html b/reference/skewness.html
index 1fb744f71..b5c2b0469 100644
--- a/reference/skewness.html
+++ b/reference/skewness.html
@@ -9,7 +9,7 @@ When negative ('left-skewed'): the left tail is longer; the mass of the distribu
 
     <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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/top_n_microorganisms.html b/reference/top_n_microorganisms.html
index 003f0e86f..748a8d14a 100644
--- a/reference/top_n_microorganisms.html
+++ b/reference/top_n_microorganisms.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/reference/translate.html b/reference/translate.html
index e64da9ed4..bd8d58050 100644
--- a/reference/translate.html
+++ b/reference/translate.html
@@ -7,7 +7,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="">2.1.1.9253</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9255</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">
diff --git a/search.json b/search.json
index 06aff0ec0..7eebd92af 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://amr-for-r.org/articles/AMR.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to conduct AMR data analysis","text":"Conducting AMR data analysis unfortunately requires -depth knowledge different scientific fields, makes hard right. least, requires: Good questions (always start !) reliable data thorough understanding (clinical) epidemiology, understand clinical epidemiological relevance possible bias results thorough understanding (clinical) microbiology/infectious diseases, understand microorganisms causal infections implications pharmaceutical treatment, well understanding intrinsic acquired microbial resistance Experience data analysis microbiological tests results, understand determination limitations MIC values interpretations SIR values Availability biological taxonomy microorganisms probably normalisation factors pharmaceuticals, defined daily doses (DDD) Available (inter-)national guidelines, profound methods apply course, instantly provide knowledge experience. AMR package, aimed providing (1) tools simplify antimicrobial resistance data cleaning, transformation analysis, (2) methods easily incorporate international guidelines (3) scientifically reliable reference data, including requirements mentioned . AMR package enables standardised reproducible AMR data analysis, application evidence-based rules, determination first isolates, translation various codes microorganisms antimicrobial agents, determination (multi-drug) resistant microorganisms, calculation antimicrobial resistance, prevalence future trends.","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to conduct AMR data analysis","text":"tutorial, create fake demonstration data work . can skip Cleaning data already data ready. start analysis, try make structure data generally look like :","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"needed-r-packages","dir":"Articles","previous_headings":"Preparation","what":"Needed R packages","title":"How to conduct AMR data analysis","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2 RStudio. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. also use cleaner package, can used cleaning data creating frequency tables. AMR package contains data set example_isolates_unclean, might look data users extracted laboratory systems: AMR data analysis, like microorganism column contain valid, --date taxonomy, antibiotic columns cleaned SIR values well.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"dplyr\", \"ggplot2\", \"AMR\")) example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows  # we will use 'our_data' as the data set name for this tutorial our_data <- example_isolates_unclean"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"taxonomy-of-microorganisms","dir":"Articles","previous_headings":"Preparation","what":"Taxonomy of microorganisms","title":"How to conduct AMR data analysis","text":".mo(), users can transform arbitrary microorganism names codes current taxonomy. AMR package contains --date taxonomic data. specific, currently included data retrieved 24 Jun 2024. codes AMR packages come .mo() short, still human readable. importantly, .mo() supports kinds input: first character codes denote taxonomic kingdom, Bacteria (B), Fungi (F), Protozoa (P). AMR package also contain functions directly retrieve taxonomic properties, name, genus, species, family, order, even Gram-stain. start mo_ use .mo() internally, still arbitrary user input can used: Now can thus clean data: Apparently, uncertainty translation taxonomic codes. Let’s check : ’s good.","code":"as.mo(\"Klebsiella pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"K. pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLEPNE\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLPN\") #> Class 'mo' #> [1] B_KLBSL_PNMN mo_family(\"K. pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"K. pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"K. pneumoniae\") #> [1] \"pneumoniae\"  mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\"  mo_ref(\"K. pneumoniae\") #> [1] \"Trevisan, 1887\"  mo_snomed(\"K. pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\" our_data$bacteria <- as.mo(our_data$bacteria, info = TRUE) #> ℹ Retrieved values from the microorganisms.codes data set for \"ESCCOL\", #>   \"KLEPNE\", \"STAAUR\", and \"STRPNE\". #> ℹ Microorganism translation was uncertain for four microorganisms. Run #>   mo_uncertainties() to review these uncertainties, or use #>   add_custom_microorganisms() to add custom entries. mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See ?mo_matching_score. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #> -------------------------------------------------------------------------------- #> \"K. pneumoniae\" -> Klebsiella pneumoniae (B_KLBSL_PNMN, 0.786) #> Also matched: Klebsiella pneumoniae complex (0.707), Klebsiella #>               pneumoniae ozaenae (0.707), Klebsiella pneumoniae pneumoniae (0.688), #>               Klebsiella pneumoniae rhinoscleromatis (0.658), Klebsiella pasteurii #>               (0.500), Klebsiella planticola (0.500), Kingella potus (0.400), #>               Kluyveromyces pseudotropicale (0.386), Kluyveromyces pseudotropicalis #>               (0.363), and Kosakonia pseudosacchari (0.361) #> -------------------------------------------------------------------------------- #> \"S. aureus\" -> Staphylococcus aureus (B_STPHY_AURS, 0.690) #> Also matched: Staphylococcus aureus aureus (0.643), Staphylococcus #>               argenteus (0.625), Staphylococcus aureus anaerobius (0.625), #>               Staphylococcus auricularis (0.615), Salmonella Aurelianis (0.595), #>               Salmonella Aarhus (0.588), Salmonella Amounderness (0.587), #>               Staphylococcus argensis (0.587), Streptococcus australis (0.587), and #>               Salmonella choleraesuis arizonae (0.562) #> -------------------------------------------------------------------------------- #> \"S. pneumoniae\" -> Streptococcus pneumoniae (B_STRPT_PNMN, 0.750) #> Also matched: Streptococcus pseudopneumoniae (0.700), Streptococcus #>               phocae salmonis (0.552), Serratia proteamaculans quinovora (0.545), #>               Streptococcus pseudoporcinus (0.536), Staphylococcus piscifermentans #>               (0.533), Staphylococcus pseudintermedius (0.532), Serratia #>               proteamaculans proteamaculans (0.526), Streptococcus gallolyticus #>               pasteurianus (0.526), Salmonella Portanigra (0.524), and Streptococcus #>               periodonticum (0.519) #>  #> Only the first 10 other matches of each record are shown. Run #> print(mo_uncertainties(), n = ...) to view more entries, or save #> mo_uncertainties() to an object."},{"path":"https://amr-for-r.org/articles/AMR.html","id":"antibiotic-results","dir":"Articles","previous_headings":"Preparation","what":"Antibiotic results","title":"How to conduct AMR data analysis","text":"column antibiotic test results must also cleaned. AMR package comes three new data types work test results: mic minimal inhibitory concentrations (MIC), disk disk diffusion diameters, sir SIR data interpreted already. package can also determine SIR values based MIC disk diffusion values, read .sir() page. now, just clean SIR columns data using dplyr: basically cleaning, time start data inclusion.","code":"# method 1, be explicit about the columns: our_data <- our_data %>%   mutate_at(vars(AMX:GEN), as.sir)  # method 2, let the AMR package determine the eligible columns our_data <- our_data %>%   mutate_if(is_sir_eligible, as.sir)  # result: our_data #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   #>  7 J8         A        2016-06-14 B_ESCHR_COLI   R     S     S     S   #>  8 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   #>  9 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   #> 10 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"first-isolates","dir":"Articles","previous_headings":"Preparation","what":"First isolates","title":"How to conduct AMR data analysis","text":"need know isolates can actually use analysis without repetition bias. conduct analysis antimicrobial resistance, must include first isolate every patient per episode (Hindler et al., Clin Infect Dis. 2007). , easily get overestimate underestimate resistance antibiotic. Imagine patient admitted MRSA found 5 different blood cultures following weeks (yes, countries like Netherlands blood drawing policies). resistance percentage oxacillin isolates overestimated, included MRSA . clearly selection bias. Clinical Laboratory Standards Institute (CLSI) appoints follows: (…) preparing cumulative antibiogram guide clinical decisions empirical antimicrobial therapy initial infections, first isolate given species per patient, per analysis period (eg, one year) included, irrespective body site, antimicrobial susceptibility profile, phenotypical characteristics (eg, biotype). first isolate easily identified, cumulative antimicrobial susceptibility test data prepared using first isolate generally comparable cumulative antimicrobial susceptibility test data calculated methods, providing duplicate isolates excluded. M39-A4 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 4th Edition. CLSI, 2014. Chapter 6.4 AMR package includes methodology first_isolate() function able apply four different methods defined Hindler et al. 2007: phenotype-based, episode-based, patient-based, isolate-based. right method depends goals analysis, default phenotype-based method case method properly correct duplicate isolates. Read methods first_isolate() page. outcome function can easily added data: 91% suitable resistance analysis! can now filter filter() function, also dplyr package: future use, two syntaxes can shortened: end 2 724 isolates analysis. Now data looks like: Time analysis.","code":"our_data <- our_data %>%   mutate(first = first_isolate(info = TRUE)) #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'bacteria' as input for col_mo. #> ℹ Using column 'date' as input for col_date. #> ℹ Using column 'patient_id' as input for col_patient_id. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> => Found 2,724 'phenotype-based' first isolates (90.8% of total where a #>    microbial ID was available) our_data_1st <- our_data %>%   filter(first == TRUE) our_data_1st <- our_data %>%   filter_first_isolate() our_data_1st #> # A tibble: 2,724 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   TRUE  #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   TRUE  #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   TRUE  #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   TRUE  #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   TRUE  #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   TRUE  #>  7 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   TRUE  #>  8 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   TRUE  #>  9 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   TRUE  #> 10 P4         A        2011-06-21 B_ESCHR_COLI   S     S     S     S   TRUE  #> # ℹ 2,714 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"analysing-the-data","dir":"Articles","previous_headings":"","what":"Analysing the data","title":"How to conduct AMR data analysis","text":"base R summary() function gives good first impression, comes support new mo sir classes now data set:","code":"summary(our_data_1st) #>   patient_id          hospital              date            #>  Length:2724        Length:2724        Min.   :2011-01-01   #>  Class :character   Class :character   1st Qu.:2013-04-07   #>  Mode  :character   Mode  :character   Median :2015-06-03   #>                                        Mean   :2015-06-09   #>                                        3rd Qu.:2017-08-11   #>                                        Max.   :2019-12-27   #>    bacteria               AMX                    AMC                 #>  Class :mo             Class:sir              Class:sir              #>  <NA>  :0              %S   :41.6% (n=1133)   %S   :52.6% (n=1432)   #>  Unique:4              %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)      #>  #1    :B_ESCHR_COLI   %I   :16.4% (n=446)    %I   :12.2% (n=333)    #>  #2    :B_STPHY_AURS   %R   :42.0% (n=1145)   %R   :35.2% (n=959)    #>  #3    :B_STRPT_PNMN   %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)      #>     CIP                    GEN                  first         #>  Class:sir              Class:sir              Mode:logical   #>  %S   :52.5% (n=1431)   %S   :61.0% (n=1661)   TRUE:2724      #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)                     #>  %I   : 6.5% (n=176)    %I   : 3.0% (n=82)                    #>  %R   :41.0% (n=1117)   %R   :36.0% (n=981)                   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)  glimpse(our_data_1st) #> Rows: 2,724 #> Columns: 9 #> $ patient_id <chr> \"J3\", \"R7\", \"P3\", \"P10\", \"B7\", \"W3\", \"M3\", \"J3\", \"G6\", \"P4\"… #> $ hospital   <chr> \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\",… #> $ date       <date> 2012-11-21, 2018-04-03, 2014-09-19, 2015-12-10, 2015-03-02… #> $ bacteria   <mo> \"B_ESCHR_COLI\", \"B_KLBSL_PNMN\", \"B_ESCHR_COLI\", \"B_ESCHR_COL… #> $ AMX        <sir> R, R, R, S, S, R, R, S, S, S, S, R, S, S, R, R, R, R, S, R,… #> $ AMC        <sir> I, I, S, I, S, S, S, S, S, S, S, S, S, S, S, S, S, R, S, S,… #> $ CIP        <sir> S, S, S, S, S, R, S, S, S, S, S, S, S, S, S, S, S, S, S, S,… #> $ GEN        <sir> S, S, S, S, S, S, S, S, S, S, S, R, S, S, S, S, S, S, S, S,… #> $ first      <lgl> TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE,…  # number of unique values per column: sapply(our_data_1st, n_distinct) #> patient_id   hospital       date   bacteria        AMX        AMC        CIP  #>        260          3       1854          4          3          3          3  #>        GEN      first  #>          3          1"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"availability-of-species","dir":"Articles","previous_headings":"Analysing the data","what":"Availability of species","title":"How to conduct AMR data analysis","text":"just get idea species distributed, create frequency table count() based name microorganisms:","code":"our_data %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1518 #> 2 Staphylococcus aureus      730 #> 3 Streptococcus pneumoniae   426 #> 4 Klebsiella pneumoniae      326  our_data_1st %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1321 #> 2 Staphylococcus aureus      682 #> 3 Streptococcus pneumoniae   402 #> 4 Klebsiella pneumoniae      319"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"select-and-filter-with-antibiotic-selectors","dir":"Articles","previous_headings":"Analysing the data","what":"Select and filter with antibiotic selectors","title":"How to conduct AMR data analysis","text":"Using -called antibiotic class selectors, can select filter columns based antibiotic class antibiotic results :","code":"our_data_1st %>%   select(date, aminoglycosides()) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 2,724 × 2 #>    date       GEN   #>    <date>     <sir> #>  1 2012-11-21   S   #>  2 2018-04-03   S   #>  3 2014-09-19   S   #>  4 2015-12-10   S   #>  5 2015-03-02   S   #>  6 2018-03-31   S   #>  7 2015-10-25   S   #>  8 2019-06-19   S   #>  9 2015-04-27   S   #> 10 2011-06-21   S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, betalactams()) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 2,724 × 3 #>    bacteria     AMX   AMC   #>    <mo>         <sir> <sir> #>  1 B_ESCHR_COLI   R     I   #>  2 B_KLBSL_PNMN   R     I   #>  3 B_ESCHR_COLI   R     S   #>  4 B_ESCHR_COLI   S     I   #>  5 B_ESCHR_COLI   S     S   #>  6 B_STPHY_AURS   R     S   #>  7 B_ESCHR_COLI   R     S   #>  8 B_ESCHR_COLI   S     S   #>  9 B_STPHY_AURS   S     S   #> 10 B_ESCHR_COLI   S     S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, where(is.sir)) #> # A tibble: 2,724 × 5 #>    bacteria     AMX   AMC   CIP   GEN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   R     I     S     S   #>  2 B_KLBSL_PNMN   R     I     S     S   #>  3 B_ESCHR_COLI   R     S     S     S   #>  4 B_ESCHR_COLI   S     I     S     S   #>  5 B_ESCHR_COLI   S     S     S     S   #>  6 B_STPHY_AURS   R     S     R     S   #>  7 B_ESCHR_COLI   R     S     S     S   #>  8 B_ESCHR_COLI   S     S     S     S   #>  9 B_STPHY_AURS   S     S     S     S   #> 10 B_ESCHR_COLI   S     S     S     S   #> # ℹ 2,714 more rows  # filtering using AB selectors is also possible: our_data_1st %>%   filter(any(aminoglycosides() == \"R\")) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 981 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J5         A        2017-12-25 B_STRPT_PNMN   R     S     S     R   TRUE  #>  2 X1         A        2017-07-04 B_STPHY_AURS   R     S     S     R   TRUE  #>  3 B3         A        2016-07-24 B_ESCHR_COLI   S     S     S     R   TRUE  #>  4 V7         A        2012-04-03 B_ESCHR_COLI   S     S     S     R   TRUE  #>  5 C9         A        2017-03-23 B_ESCHR_COLI   S     S     S     R   TRUE  #>  6 R1         A        2018-06-10 B_STPHY_AURS   S     S     S     R   TRUE  #>  7 S2         A        2013-07-19 B_STRPT_PNMN   S     S     S     R   TRUE  #>  8 P5         A        2019-03-09 B_STPHY_AURS   S     S     S     R   TRUE  #>  9 Q8         A        2019-08-10 B_STPHY_AURS   S     S     S     R   TRUE  #> 10 K5         A        2013-03-15 B_STRPT_PNMN   S     S     S     R   TRUE  #> # ℹ 971 more rows  our_data_1st %>%   filter(all(betalactams() == \"R\")) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows  # even works in base R (since R 3.0): our_data_1st[all(betalactams() == \"R\"), ] #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"generate-antibiograms","dir":"Articles","previous_headings":"Analysing the data","what":"Generate antibiograms","title":"How to conduct AMR data analysis","text":"Since AMR v2.0 (March 2023), easy create different types antibiograms, support 20 different languages. four antibiogram types, proposed Klinker et al. (2021, DOI 10.1177/20499361211011373), supported new antibiogram() function: Traditional Antibiogram (TA) e.g, susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Combination Antibiogram (CA) e.g, sdditional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Syndromic Antibiogram (SA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Weighted-Incidence Syndromic Combination Antibiogram (WISCA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure section, show use antibiogram() function create antibiogram types. starters, included example_isolates data set looks like:","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"traditional-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Traditional Antibiogram","title":"How to conduct AMR data analysis","text":"create traditional antibiogram, simply state antibiotics used. antibiotics argument antibiogram() function supports (combination) previously mentioned antibiotic class selectors: Notice antibiogram() function automatically prints right format using Quarto R Markdown (page), even applies italics taxonomic names (using italicise_taxonomy() internally). also uses language OS either English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. next example, force language Spanish using language argument:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             mo_transform = \"gramstain\",             antibiotics = aminoglycosides(),             ab_transform = \"name\",             language = \"es\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"combined-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Combined Antibiogram","title":"How to conduct AMR data analysis","text":"create combined antibiogram, use antibiotic codes names plus + character like :","code":"combined_ab <- antibiogram(example_isolates,                            antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),                            ab_transform = NULL) combined_ab"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"syndromic-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Syndromic Antibiogram","title":"How to conduct AMR data analysis","text":"create syndromic antibiogram, syndromic_group argument must used. can column data, e.g. ifelse() calculations based certain columns:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems()),             syndromic_group = \"ward\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"weighted-incidence-syndromic-combination-antibiogram-wisca","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Weighted-Incidence Syndromic Combination Antibiogram (WISCA)","title":"How to conduct AMR data analysis","text":"create Weighted-Incidence Syndromic Combination Antibiogram (WISCA), simply set wisca = TRUE antibiogram() function, use dedicated wisca() function. Unlike traditional antibiograms, WISCA provides syndrome-based susceptibility estimates, weighted pathogen incidence antimicrobial susceptibility patterns. WISCA uses Bayesian decision model integrate data multiple pathogens, improving empirical therapy guidance, especially low-incidence infections. pathogen-agnostic, meaning results syndrome-based rather stratified microorganism. reliable results, ensure data includes first isolates (use first_isolate()) consider filtering top n species (use top_n_microorganisms()), WISCA outcomes meaningful based robust incidence estimates. patient- syndrome-specific WISCA, run function grouped tibble, .e., using group_by() first:","code":"example_isolates %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),         minimum = 10) # Recommended threshold: ≥30 example_isolates %>%   top_n_microorganisms(n = 10) %>%   group_by(age_group = age_groups(age, c(25, 50, 75)),            gender) %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-antibiograms","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Plotting antibiograms","title":"How to conduct AMR data analysis","text":"Antibiograms can plotted using autoplot() ggplot2 packages, since AMR package provides extension function:  calculate antimicrobial resistance sensible way, also correcting results, use resistance() susceptibility() functions.","code":"autoplot(combined_ab)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"resistance-percentages","dir":"Articles","previous_headings":"Analysing the data","what":"Resistance percentages","title":"How to conduct AMR data analysis","text":"functions resistance() susceptibility() can used calculate antimicrobial resistance susceptibility. specific analyses, functions proportion_S(), proportion_SI(), proportion_I(), proportion_IR() proportion_R() can used determine proportion specific antimicrobial outcome. functions contain minimum argument, denoting minimum required number test results returning value. functions otherwise return NA. default minimum = 30, following CLSI M39-A4 guideline applying microbial epidemiology. per EUCAST guideline 2019, calculate resistance proportion R (proportion_R(), equal resistance()) susceptibility proportion S (proportion_SI(), equal susceptibility()). functions can used : can used conjunction group_by() summarise(), dplyr package:","code":"our_data_1st %>% resistance(AMX) #> [1] 0.4203377 our_data_1st %>%   group_by(hospital) %>%   summarise(amoxicillin = resistance(AMX)) #> # A tibble: 3 × 2 #>   hospital amoxicillin #>   <chr>          <dbl> #> 1 A              0.340 #> 2 B              0.551 #> 3 C              0.370"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"interpreting-mic-and-disk-diffusion-values","dir":"Articles","previous_headings":"Analysing the data","what":"Interpreting MIC and Disk Diffusion Values","title":"How to conduct AMR data analysis","text":"Minimal inhibitory concentration (MIC) values disk diffusion diameters can interpreted clinical breakpoints (SIR) using .sir(). ’s example randomly generated MIC values Klebsiella pneumoniae ciprofloxacin: allows direct interpretation according EUCAST CLSI breakpoints, facilitating automated AMR data processing.","code":"set.seed(123) mic_values <- random_mic(100) sir_values <- as.sir(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\") #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin), EUCAST 2024... NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Klebsiella pneumoniae - assuming body site 'Non-meningitis'.  my_data <- tibble(MIC = mic_values, SIR = sir_values) my_data #> # A tibble: 100 × 2 #>          MIC SIR   #>        <mic> <sir> #>  1    16.000   R   #>  2     0.005   S   #>  3     1.000   R   #>  4 >=256.000   R   #>  5     2.000   R   #>  6     0.025   S   #>  7    16.000   R   #>  8     0.025   S   #>  9     0.500   I   #> 10     0.005   S   #> # ℹ 90 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-mic-and-sir-interpretations","dir":"Articles","previous_headings":"Analysing the data","what":"Plotting MIC and SIR Interpretations","title":"How to conduct AMR data analysis","text":"can visualise MIC distributions SIR interpretations using ggplot2, using new scale_y_mic() y-axis scale_colour_sir() colour-code SIR categories.  plot provides intuitive way assess susceptibility patterns across different groups incorporating clinical breakpoints. straightforward less manual approach, ggplot2’s function autoplot() extended package directly plot MIC disk diffusion values:   Author: Dr. Matthijs Berends, 23rd Feb 2025","code":"# add a group my_data$group <- rep(c(\"A\", \"B\", \"C\", \"D\"), each = 25)   ggplot(my_data,        aes(x = group, y = MIC, colour = SIR)) +   geom_jitter(width = 0.2, size = 2) +   geom_boxplot(fill = NA, colour = \"grey40\") +   scale_y_mic() +   scale_colour_sir() +   labs(title = \"MIC Distribution and SIR Interpretation\",        x = \"Sample Groups\",        y = \"MIC (mg/L)\") autoplot(mic_values) # by providing `mo` and `ab`, colours will indicate the SIR interpretation: autoplot(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\")"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"AMR for Python","text":"AMR package R powerful tool antimicrobial resistance (AMR) analysis. provides extensive features handling microbial antimicrobial data. However, work primarily Python, now intuitive option available: AMR Python package. Python package wrapper around AMR R package. uses rpy2 package internally. Despite need R installed, Python users can now easily work AMR data directly Python code.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"prerequisites","dir":"Articles","previous_headings":"","what":"Prerequisites","title":"AMR for Python","text":"package tested virtual environment (venv). can set environment running: can activate environment, venv ready work .","code":"# linux and macOS: python -m venv /path/to/new/virtual/environment  # Windows: python -m venv C:\\path\\to\\new\\virtual\\environment"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"install-amr","dir":"Articles","previous_headings":"","what":"Install AMR","title":"AMR for Python","text":"Since Python package available official Python Package Index, can just run: Make sure R installed. need install AMR R package, installed automatically. Linux: macOS (using Homebrew): Windows, visit CRAN download page download install R.","code":"pip install AMR # Ubuntu / Debian sudo apt install r-base # Fedora: sudo dnf install R # CentOS/RHEL sudo yum install R brew install r"},{"path":[]},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"cleaning-taxonomy","dir":"Articles","previous_headings":"Examples of Usage","what":"Cleaning Taxonomy","title":"AMR for Python","text":"’s example demonstrates clean microorganism drug names using AMR Python package:","code":"import pandas as pd import AMR  # Sample data data = {     \"MOs\": ['E. coli', 'ESCCOL', 'esco', 'Esche coli'],     \"Drug\": ['Cipro', 'CIP', 'J01MA02', 'Ciproxin'] } df = pd.DataFrame(data)  # Use AMR functions to clean microorganism and drug names df['MO_clean'] = AMR.mo_name(df['MOs']) df['Drug_clean'] = AMR.ab_name(df['Drug'])  # Display the results print(df)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"explanation","dir":"Articles","previous_headings":"Examples of Usage > Cleaning Taxonomy","what":"Explanation","title":"AMR for Python","text":"mo_name: function standardises microorganism names. , different variations Escherichia coli (“E. coli”, “ESCCOL”, “esco”, “Esche coli”) converted correct, standardised form, “Escherichia coli”. ab_name: Similarly, function standardises antimicrobial names. different representations ciprofloxacin (e.g., “Cipro”, “CIP”, “J01MA02”, “Ciproxin”) converted standard name, “Ciprofloxacin”.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"calculating-amr","dir":"Articles","previous_headings":"Examples of Usage","what":"Calculating AMR","title":"AMR for Python","text":"","code":"import AMR import pandas as pd  df = AMR.example_isolates result = AMR.resistance(df[\"AMX\"]) print(result) [0.59555556]"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"generating-antibiograms","dir":"Articles","previous_headings":"Examples of Usage","what":"Generating Antibiograms","title":"AMR for Python","text":"One core functions AMR package generating antibiogram, table summarises antimicrobial susceptibility bacterial isolates. ’s can generate antibiogram Python: example, generate antibiogram selecting various antibiotics.","code":"result2a = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]]) print(result2a) result2b = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]], mo_transform = \"gramstain\") print(result2b)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"taxonomic-data-sets-now-in-python","dir":"Articles","previous_headings":"Examples of Usage","what":"Taxonomic Data Sets Now in Python!","title":"AMR for Python","text":"Python user, might like important data sets AMR R package, microorganisms, antimicrobials, clinical_breakpoints, example_isolates, now available regular Python data frames:","code":"AMR.microorganisms AMR.antimicrobials"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"conclusion","dir":"Articles","previous_headings":"","what":"Conclusion","title":"AMR for Python","text":"AMR Python package, Python users can now effortlessly call R functions AMR R package. eliminates need complex rpy2 configurations provides clean, easy--use interface antimicrobial resistance analysis. examples provided demonstrate can applied typical workflows, standardising microorganism antimicrobial names calculating resistance. just running import AMR, users can seamlessly integrate robust features R AMR package Python workflows. Whether ’re cleaning data analysing resistance patterns, AMR Python package makes easy work AMR data Python.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-1-using-antimicrobial-selectors","dir":"Articles","previous_headings":"","what":"Example 1: Using Antimicrobial Selectors","title":"AMR with tidymodels","text":"leveraging power tidymodels AMR package, ’ll build reproducible machine learning workflow predict Gramstain microorganism two important antibiotic classes: aminoglycosides beta-lactams.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Objective","title":"AMR with tidymodels","text":"goal build predictive model using tidymodels framework determine Gramstain microorganism based microbial data. : Preprocess data using selector functions aminoglycosides() betalactams(). Define logistic regression model prediction. Use structured tidymodels workflow preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Data Preparation","title":"AMR with tidymodels","text":"begin loading required libraries preparing example_isolates dataset AMR package. Prepare data: Explanation: aminoglycosides() betalactams() dynamically select columns antimicrobials classes. drop_na() ensures model receives complete cases training.","code":"# Load required libraries library(AMR)          # For AMR data analysis library(tidymodels)   # For machine learning workflows, and data manipulation (dplyr, tidyr, ...) # Your data could look like this: example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # Select relevant columns for prediction data <- example_isolates %>%   # select AB results dynamically   select(mo, aminoglycosides(), betalactams()) %>%   # replace NAs with NI (not-interpretable)    mutate(across(where(is.sir),                  ~replace_na(.x, \"NI\")),           # make factors of SIR columns           across(where(is.sir),                  as.integer),           # get Gramstain of microorganisms           mo = as.factor(mo_gramstain(mo))) %>%   # drop NAs - the ones without a Gramstain (fungi, etc.)   drop_na() #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For betalactams() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define tidymodels workflow, consists three steps: preprocessing, model specification, fitting.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"create recipe preprocess data modelling. recipe includes least one preprocessing operation, like step_corr(), necessary parameters can estimated training set using prep(): Explanation: recipe(mo ~ ., data = data) take mo column outcome columns predictors. step_corr() removes predictors (.e., antibiotic columns) higher correlation 90%. Notice recipe contains just antimicrobial selector functions - need define columns specifically. preparation (retrieved prep()) can see columns variables ‘AMX’ ‘CTX’ removed correlate much existing, variables.","code":"# Define the recipe for data preprocessing resistance_recipe <- recipe(mo ~ ., data = data) %>%   step_corr(c(aminoglycosides(), betalactams()), threshold = 0.9) resistance_recipe #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Operations #> • Correlation filter on: c(aminoglycosides(), betalactams()) prep(resistance_recipe) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For betalactams() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem) #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Training information #> Training data contained 1968 data points and no incomplete rows. #>  #> ── Operations #> • Correlation filter on: AMX CTX | Trained"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"define logistic regression model since resistance prediction binary classification task. Explanation: logistic_reg() sets logistic regression model. set_engine(\"glm\") specifies use R’s built-GLM engine.","code":"# Specify a logistic regression model logistic_model <- logistic_reg() %>%   set_engine(\"glm\") # Use the Generalised Linear Model engine logistic_model #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"bundle recipe model together workflow, organises entire modelling process.","code":"# Combine the recipe and model into a workflow resistance_workflow <- workflow() %>%   add_recipe(resistance_recipe) %>% # Add the preprocessing recipe   add_model(logistic_model) # Add the logistic regression model resistance_workflow #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: logistic_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 1 Recipe Step #>  #> • step_corr() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"train model, split data training testing sets. , fit workflow training set evaluate performance. Explanation: initial_split() splits data training testing sets. fit() trains workflow training set. Notice fit(), antimicrobial selector functions internally called . training, functions called since stored recipe. Next, evaluate model testing data. Explanation: predict() generates predictions testing set. metrics() computes evaluation metrics like accuracy kappa. appears can predict Gram stain 99.5% accuracy based AMR results aminoglycosides beta-lactam antibiotics. ROC curve looks like :","code":"# Split data into training and testing sets set.seed(123) # For reproducibility data_split <- initial_split(data, prop = 0.8) # 80% training, 20% testing training_data <- training(data_split) # Training set testing_data <- testing(data_split)   # Testing set  # Fit the workflow to the training data fitted_workflow <- resistance_workflow %>%   fit(training_data) # Train the model # Make predictions on the testing set predictions <- fitted_workflow %>%   predict(testing_data)                # Generate predictions probabilities <- fitted_workflow %>%   predict(testing_data, type = \"prob\") # Generate probabilities  predictions <- predictions %>%   bind_cols(probabilities) %>%   bind_cols(testing_data) # Combine with true labels  predictions #> # A tibble: 394 × 24 #>    .pred_class   `.pred_Gram-negative` `.pred_Gram-positive` mo        GEN   TOB #>    <fct>                         <dbl>                 <dbl> <fct>   <int> <int> #>  1 Gram-positive              1.07e- 1              8.93e- 1 Gram-p…     5     5 #>  2 Gram-positive              3.17e- 8              1.00e+ 0 Gram-p…     5     1 #>  3 Gram-negative              9.99e- 1              1.42e- 3 Gram-n…     5     5 #>  4 Gram-positive              2.22e-16              1   e+ 0 Gram-p…     5     5 #>  5 Gram-negative              9.46e- 1              5.42e- 2 Gram-n…     5     5 #>  6 Gram-positive              1.07e- 1              8.93e- 1 Gram-p…     5     5 #>  7 Gram-positive              2.22e-16              1   e+ 0 Gram-p…     1     5 #>  8 Gram-positive              2.22e-16              1   e+ 0 Gram-p…     4     4 #>  9 Gram-negative              1   e+ 0              2.22e-16 Gram-n…     1     1 #> 10 Gram-positive              6.05e-11              1.00e+ 0 Gram-p…     4     4 #> # ℹ 384 more rows #> # ℹ 18 more variables: AMK <int>, KAN <int>, PEN <int>, OXA <int>, FLC <int>, #> #   AMX <int>, AMC <int>, AMP <int>, TZP <int>, CZO <int>, FEP <int>, #> #   CXM <int>, FOX <int>, CTX <int>, CAZ <int>, CRO <int>, IPM <int>, MEM <int>  # Evaluate model performance metrics <- predictions %>%   metrics(truth = mo, estimate = .pred_class) # Calculate performance metrics  metrics #> # A tibble: 2 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989   # To assess some other model properties, you can make our own `metrics()` function our_metrics <- metric_set(accuracy, kap, ppv, npv) # add Positive Predictive Value and Negative Predictive Value metrics2 <- predictions %>%   our_metrics(truth = mo, estimate = .pred_class) # run again on our `our_metrics()` function  metrics2 #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989 #> 3 ppv      binary         0.987 #> 4 npv      binary         1 predictions %>%   roc_curve(mo, `.pred_Gram-negative`) %>%   autoplot()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Conclusion","title":"AMR with tidymodels","text":"post, demonstrated build machine learning pipeline tidymodels framework AMR package. combining selector functions like aminoglycosides() betalactams() tidymodels, efficiently prepared data, trained model, evaluated performance. workflow extensible antimicrobial classes resistance patterns, empowering users analyse AMR data systematically reproducibly.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-2-predicting-amr-over-time","dir":"Articles","previous_headings":"","what":"Example 2: Predicting AMR Over Time","title":"AMR with tidymodels","text":"second example, aim predict antimicrobial resistance (AMR) trends time using tidymodels. model resistance three antibiotics (amoxicillin AMX, amoxicillin-clavulanic acid AMC, ciprofloxacin CIP), based historical data grouped year hospital ward.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Objective","title":"AMR with tidymodels","text":"goal : Prepare dataset aggregating resistance data time. Define regression model predict AMR trends. Use tidymodels preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Data Preparation","title":"AMR with tidymodels","text":"start transforming example_isolates dataset structured time-series format. Explanation: mo_name(mo): Converts microbial codes proper species names. resistance(): Converts AMR results numeric values (proportion resistant isolates). group_by(year, ward, species): Aggregates resistance rates year ward.","code":"# Load required libraries library(AMR) library(tidymodels)  # Transform dataset data_time <- example_isolates %>%   top_n_microorganisms(n = 10) %>% # Filter on the top #10 species   mutate(year = as.integer(format(date, \"%Y\")),  # Extract year from date          gramstain = mo_gramstain(mo)) %>% # Get taxonomic names   group_by(year, gramstain) %>%   summarise(across(c(AMX, AMC, CIP),                     function(x) resistance(x, minimum = 0),                    .names = \"res_{.col}\"),              .groups = \"drop\") %>%    filter(!is.na(res_AMX) & !is.na(res_AMC) & !is.na(res_CIP)) # Drop missing values #> ℹ Using column 'mo' as input for col_mo.  data_time #> # A tibble: 32 × 5 #>     year gramstain     res_AMX res_AMC res_CIP #>    <int> <chr>           <dbl>   <dbl>   <dbl> #>  1  2002 Gram-negative   1      0.105   0.0606 #>  2  2002 Gram-positive   0.838  0.182   0.162  #>  3  2003 Gram-negative   1      0.0714  0      #>  4  2003 Gram-positive   0.714  0.244   0.154  #>  5  2004 Gram-negative   0.464  0.0938  0      #>  6  2004 Gram-positive   0.849  0.299   0.244  #>  7  2005 Gram-negative   0.412  0.132   0.0588 #>  8  2005 Gram-positive   0.882  0.382   0.154  #>  9  2006 Gram-negative   0.379  0       0.1    #> 10  2006 Gram-positive   0.778  0.333   0.353  #> # ℹ 22 more rows"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define modelling workflow, consists preprocessing step, model specification, fitting process.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"Explanation: step_dummy(): Encodes categorical variables (ward, species) numerical indicators. step_normalize(): Normalises year variable. step_nzv(): Removes near-zero variance predictors.","code":"# Define the recipe resistance_recipe_time <- recipe(res_AMX ~ year + gramstain, data = data_time) %>%   step_dummy(gramstain, one_hot = TRUE) %>%  # Convert categorical to numerical   step_normalize(year) %>%  # Normalise year for better model performance   step_nzv(all_predictors())  # Remove near-zero variance predictors  resistance_recipe_time #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:   1 #> predictor: 2 #>  #> ── Operations #> • Dummy variables from: gramstain #> • Centering and scaling for: year #> • Sparse, unbalanced variable filter on: all_predictors()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"use linear regression model predict resistance trends. Explanation: linear_reg(): Defines linear regression model. set_engine(\"lm\"): Uses R’s built-linear regression engine.","code":"# Define the linear regression model lm_model <- linear_reg() %>%   set_engine(\"lm\") # Use linear regression  lm_model #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"combine preprocessing recipe model workflow.","code":"# Create workflow resistance_workflow_time <- workflow() %>%   add_recipe(resistance_recipe_time) %>%   add_model(lm_model)  resistance_workflow_time #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: linear_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 3 Recipe Steps #>  #> • step_dummy() #> • step_normalize() #> • step_nzv() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"split data training testing sets, fit model, evaluate performance. Explanation: initial_split(): Splits data training testing sets. fit(): Trains workflow. predict(): Generates resistance predictions. metrics(): Evaluates model performance.","code":"# Split the data set.seed(123) data_split_time <- initial_split(data_time, prop = 0.8) train_time <- training(data_split_time) test_time <- testing(data_split_time)  # Train the model fitted_workflow_time <- resistance_workflow_time %>%   fit(train_time)  # Make predictions predictions_time <- fitted_workflow_time %>%   predict(test_time) %>%   bind_cols(test_time)   # Evaluate model metrics_time <- predictions_time %>%   metrics(truth = res_AMX, estimate = .pred)  metrics_time #> # A tibble: 3 × 3 #>   .metric .estimator .estimate #>   <chr>   <chr>          <dbl> #> 1 rmse    standard      0.0774 #> 2 rsq     standard      0.711  #> 3 mae     standard      0.0704"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"visualising-predictions","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Visualising Predictions","title":"AMR with tidymodels","text":"plot resistance trends time amoxicillin.  Additionally, can visualise resistance trends ggplot2 directly add linear models :","code":"library(ggplot2)  # Plot actual vs predicted resistance over time ggplot(predictions_time, aes(x = year)) +   geom_point(aes(y = res_AMX, color = \"Actual\")) +   geom_line(aes(y = .pred, color = \"Predicted\")) +   labs(title = \"Predicted vs Actual AMX Resistance Over Time\",        x = \"Year\",        y = \"Resistance Proportion\") +   theme_minimal() ggplot(data_time, aes(x = year, y = res_AMX, color = gramstain)) +   geom_line() +   labs(title = \"AMX Resistance Trends\",        x = \"Year\",        y = \"Resistance Proportion\") +   # add a linear model directly in ggplot2:   geom_smooth(method = \"lm\",               formula = y ~ x,               alpha = 0.25) +   theme_minimal()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Conclusion","title":"AMR with tidymodels","text":"example, demonstrated analyze AMR trends time using tidymodels. aggregating resistance rates year hospital ward, built predictive model track changes resistance amoxicillin (AMX), amoxicillin-clavulanic acid (AMC), ciprofloxacin (CIP). method can extended antibiotics resistance patterns, providing valuable insights AMR dynamics healthcare settings.","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to apply EUCAST rules","text":"EUCAST rules? European Committee Antimicrobial Susceptibility Testing (EUCAST) states website: EUCAST expert rules (see ) tabulated collection expert knowledge interpretive rules, expected resistant phenotypes expected susceptible phenotypes applied antimicrobial susceptibility testing order reduce testing, reduce errors make appropriate recommendations reporting particular resistances. Europe, lot medical microbiological laboratories already apply rules (Brown et al., 2015). package features latest insights expected resistant phenotypes (v1.2, 2023).","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to apply EUCAST rules","text":"rules can used discard improbable bug-drug combinations data. example, Klebsiella produces beta-lactamase prevents ampicillin (amoxicillin) working . words, practically every strain Klebsiella resistant ampicillin. Sometimes, laboratory data can still contain strains Klebsiella susceptible ampicillin. antibiogram available identification available, antibiogram re-interpreted based identification. eucast_rules() function resolves , applying latest ‘EUCAST Expected Resistant Phenotypes’ guideline: convenient function mo_is_intrinsic_resistant() uses guideline, allows check one specific microorganisms antimicrobials: EUCAST rules can used correction, can also used filling known resistance susceptibility based results antimicrobials drugs. process called interpretive reading, basically form imputation:","code":"oops <- tibble::tibble(   mo = c(     \"Klebsiella pneumoniae\",     \"Escherichia coli\"   ),   ampicillin = as.sir(\"S\") ) oops #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   S        #> 2 Escherichia coli        S    eucast_rules(oops, info = FALSE, overwrite = TRUE) #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   R        #> 2 Escherichia coli        S mo_is_intrinsic_resistant(   c(\"Klebsiella pneumoniae\", \"Escherichia coli\"),   \"ampicillin\" ) #> [1]  TRUE FALSE  mo_is_intrinsic_resistant(   \"Klebsiella pneumoniae\",   c(\"ampicillin\", \"kanamycin\") ) #> [1]  TRUE FALSE data <- tibble::tibble(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylenicillin   FOX = \"S\"  # Cefoxitin ) data eucast_rules(data, overwrite = TRUE)"},{"path":"https://amr-for-r.org/articles/MDR.html","id":"type-of-input","dir":"Articles","previous_headings":"","what":"Type of input","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function takes data set input, regular data.frame. tries automatically determine right columns info isolates, name species columns results antimicrobial agents. See help page info set right settings data command ?mdro. WHONET data (data), settings automatically set correctly.","code":""},{"path":"https://amr-for-r.org/articles/MDR.html","id":"guidelines","dir":"Articles","previous_headings":"","what":"Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function support multiple guidelines. can select guideline guideline parameter. Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. “Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.” Clinical Microbiology Infection (2012) (link) guideline = \"EUCAST3.2\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.2 “Intrinsic Resistance Unusual Phenotypes” (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 “Intrinsic Resistance Exceptional Phenotypes Tables” (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization “Companion handbook guidelines programmatic management drug-resistant tuberculosis” (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7. DOI: 10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Rijksinstituut voor Volksgezondheid en Milieu “WIP-richtlijn BRMO (Bijzonder Resistente Micro-Organismen) (ZKH)” (link) Please suggest (country-specific) guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://amr-for-r.org/articles/MDR.html","id":"custom-guidelines","dir":"Articles","previous_headings":"Guidelines","what":"Custom Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"can also use custom guideline. Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() dplyr package, recognise input method set rules. Rules must set using R considers ‘formula notation’: row/isolate matches first rule, value first ~ (case ‘Elderly Type ’) set MDRO value. Otherwise, second rule tried . maximum number rules unlimited. can print rules set console overview. Colours help reading console supports colours. outcome function can used guideline argument mdro() function: rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) custom #> A set of custom MDRO rules: #>   1. If CIP is  R  and age is higher than 60 then: Elderly Type A #>   2. If ERY is  R  and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B x <- mdro(example_isolates, guideline = custom) table(x) #> x #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732"},{"path":"https://amr-for-r.org/articles/MDR.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function always returns ordered factor predefined guidelines. example, output default guideline Magiorakos et al. returns factor levels ‘Negative’, ‘MDR’, ‘XDR’ ‘PDR’ order. next example uses example_isolates data set. data set included package contains full antibiograms 2,000 microbial isolates. reflects reality can used practise AMR data analysis. test MDR/XDR/PDR guideline data set, get: Frequency table Class: factor > ordered (numeric) Length: 2,000 Levels: 4: Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant … Available: 1,745 (87.25%, NA: 255 = 12.75%) Unique: 2 another example, create data set determine multi-drug resistant TB: column names automatically verified valid drug names codes, worked exactly way: data set now looks like : can now add interpretation MDR-TB data set. can use: shortcut mdr_tb(): Create frequency table results: Frequency table Class: factor > ordered (numeric) Length: 5,000 Levels: 5: Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant <… Available: 5,000 (100%, NA: 0 = 0%) Unique: 5","code":"library(dplyr) # to support pipes: %>% library(cleaner) # to create frequency tables example_isolates %>%   mdro() %>%   freq() # show frequency table of the result #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) # random_sir() is a helper function to generate # a random vector with values S, I and R my_TB_data <- data.frame(   rifampicin = random_sir(5000),   isoniazid = random_sir(5000),   gatifloxacin = random_sir(5000),   ethambutol = random_sir(5000),   pyrazinamide = random_sir(5000),   moxifloxacin = random_sir(5000),   kanamycin = random_sir(5000) ) my_TB_data <- data.frame(   RIF = random_sir(5000),   INH = random_sir(5000),   GAT = random_sir(5000),   ETH = random_sir(5000),   PZA = random_sir(5000),   MFX = random_sir(5000),   KAN = random_sir(5000) ) head(my_TB_data) #>   rifampicin isoniazid gatifloxacin ethambutol pyrazinamide moxifloxacin #> 1          I         R            S          S            S            S #> 2          S         S            I          R            R            S #> 3          R         I            I          I            R            I #> 4          I         S            S          S            S            S #> 5          I         I            I          S            I            S #> 6          R         S            R          S            I            I #>   kanamycin #> 1         R #> 2         I #> 3         S #> 4         I #> 5         I #> 6         I mdro(my_TB_data, guideline = \"TB\") my_TB_data$mdr <- mdr_tb(my_TB_data) #> ℹ No column found as input for col_mo, assuming all rows contain #>   Mycobacterium tuberculosis. freq(my_TB_data$mdr)"},{"path":[]},{"path":"https://amr-for-r.org/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"How to conduct principal component analysis (PCA) for AMR","text":"PCA, need transform AMR data first. example_isolates data set package looks like: Now transform data set resistance percentages per taxonomic order genus:","code":"library(AMR) library(dplyr) glimpse(example_isolates) #> Rows: 2,000 #> Columns: 46 #> $ date    <date> 2002-01-02, 2002-01-03, 2002-01-07, 2002-01-07, 2002-01-13, 2… #> $ patient <chr> \"A77334\", \"A77334\", \"067927\", \"067927\", \"067927\", \"067927\", \"4… #> $ age     <dbl> 65, 65, 45, 45, 45, 45, 78, 78, 45, 79, 67, 67, 71, 71, 75, 50… #> $ gender  <chr> \"F\", \"F\", \"F\", \"F\", \"F\", \"F\", \"M\", \"M\", \"F\", \"F\", \"M\", \"M\", \"M… #> $ ward    <chr> \"Clinical\", \"Clinical\", \"ICU\", \"ICU\", \"ICU\", \"ICU\", \"Clinical\"… #> $ mo      <mo> \"B_ESCHR_COLI\", \"B_ESCHR_COLI\", \"B_STPHY_EPDR\", \"B_STPHY_EPDR\",… #> $ PEN     <sir> R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, S,… #> $ OXA     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ FLC     <sir> NA, NA, R, R, R, R, S, S, R, S, S, S, NA, NA, NA, NA, NA, R, R… #> $ AMX     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ AMC     <sir> I, I, NA, NA, NA, NA, S, S, NA, NA, S, S, I, I, R, I, I, NA, N… #> $ AMP     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ TZP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CZO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ FEP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CXM     <sir> I, I, R, R, R, R, S, S, R, S, S, S, S, S, NA, S, S, R, R, S, S… #> $ FOX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ CTX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ CAZ     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, S, S, R, R, … #> $ CRO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ GEN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TOB     <sir> NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, S, S, NA, NA, NA… #> $ AMK     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ KAN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TMP     <sir> R, R, S, S, R, R, R, R, S, S, NA, NA, S, S, S, S, S, R, R, R, … #> $ SXT     <sir> R, R, S, S, NA, NA, NA, NA, S, S, NA, NA, S, S, S, S, S, NA, N… #> $ NIT     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R,… #> $ FOS     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ LNZ     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ CIP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, NA, S, S… #> $ MFX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ VAN     <sir> R, R, S, S, S, S, S, S, S, S, NA, NA, R, R, R, R, R, S, S, S, … #> $ TEC     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ TCY     <sir> R, R, S, S, S, S, S, S, S, I, S, S, NA, NA, I, R, R, S, I, R, … #> $ TGC     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ DOX     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ ERY     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ CLI     <sir> R, R, NA, NA, NA, R, NA, NA, NA, NA, NA, NA, R, R, R, R, R, NA… #> $ AZM     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ IPM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ MEM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ MTR     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CHL     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ COL     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, R, R, R, R, … #> $ MUP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ RIF     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… resistance_data <- example_isolates %>%   group_by(     order = mo_order(mo), # group on anything, like order     genus = mo_genus(mo)   ) %>% #  and genus as we do here   summarise_if(is.sir, resistance) %>% # then get resistance of all drugs   select(     order, genus, AMC, CXM, CTX,     CAZ, GEN, TOB, TMP, SXT   ) # and select only relevant columns  head(resistance_data) #> # A tibble: 6 × 10 #> # Groups:   order [5] #>   order             genus          AMC   CXM   CTX   CAZ   GEN   TOB   TMP   SXT #>   <chr>             <chr>        <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 (unknown order)   (unknown ge…    NA    NA    NA    NA    NA    NA    NA    NA #> 2 Actinomycetales   Schaalia        NA    NA    NA    NA    NA    NA    NA    NA #> 3 Bacteroidales     Bacteroides     NA    NA    NA    NA    NA    NA    NA    NA #> 4 Campylobacterales Campylobact…    NA    NA    NA    NA    NA    NA    NA    NA #> 5 Caryophanales     Gemella         NA    NA    NA    NA    NA    NA    NA    NA #> 6 Caryophanales     Listeria        NA    NA    NA    NA    NA    NA    NA    NA"},{"path":"https://amr-for-r.org/articles/PCA.html","id":"perform-principal-component-analysis","dir":"Articles","previous_headings":"","what":"Perform principal component analysis","title":"How to conduct principal component analysis (PCA) for AMR","text":"new pca() function automatically filter rows contain numeric values selected variables, now need : result can reviewed good old summary() function: Good news. first two components explain total 93.3% variance (see PC1 PC2 values Proportion Variance. can create -called biplot base R biplot() function, see antimicrobial resistance per drug explain difference per microorganism.","code":"pca_result <- pca(resistance_data) #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. summary(pca_result) #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\" #> Importance of components: #>                           PC1    PC2    PC3     PC4     PC5     PC6       PC7 #> Standard deviation     2.1539 1.6807 0.6138 0.33879 0.20808 0.03140 1.232e-16 #> Proportion of Variance 0.5799 0.3531 0.0471 0.01435 0.00541 0.00012 0.000e+00 #> Cumulative Proportion  0.5799 0.9330 0.9801 0.99446 0.99988 1.00000 1.000e+00 #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\""},{"path":"https://amr-for-r.org/articles/PCA.html","id":"plotting-the-results","dir":"Articles","previous_headings":"","what":"Plotting the results","title":"How to conduct principal component analysis (PCA) for AMR","text":"can’t see explanation points. Perhaps works better new ggplot_pca() function, automatically adds right labels even groups:  can also print ellipse per group, edit appearance:","code":"biplot(pca_result) ggplot_pca(pca_result) ggplot_pca(pca_result, ellipse = TRUE) +   ggplot2::labs(title = \"An AMR/PCA biplot!\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"import-of-data","dir":"Articles","previous_headings":"","what":"Import of data","title":"How to work with WHONET data","text":"tutorial assumes already imported WHONET data e.g. readxl package. RStudio, can done using menu button ‘Import Dataset’ tab ‘Environment’. Choose option ‘Excel’ select exported file. Make sure date fields imported correctly. example syntax look like : package comes example data set WHONET. use analysis.","code":"library(readxl) data <- read_excel(path = \"path/to/your/file.xlsx\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to work with WHONET data","text":"First, load relevant packages yet . use tidyverse analyses. . don’t know yet, suggest read website: https://www.tidyverse.org/. transform variables simplify automate analysis: Microorganisms transformed microorganism codes (called mo) using Catalogue Life reference data set, contains ~70,000 microorganisms taxonomic kingdoms Bacteria, Fungi Protozoa. tranformation .mo(). function also recognises almost WHONET abbreviations microorganisms. Antimicrobial results interpretations clean valid. words, contain values \"S\", \"\" \"R\". exactly .sir() function . errors warnings, values transformed succesfully. also created package dedicated data cleaning checking, called cleaner package. freq() function can used create frequency tables. let’s check data, couple frequency tables: Frequency table Class: character Length: 500 Available: 500 (100%, NA: 0 = 0%) Unique: 38 Shortest: 11 Longest: 40 (omitted 28 entries, n = 57 [11.4%]) Frequency table Class: factor > ordered > sir (numeric) Length: 500 Levels: 5: S < SDD < < R < NI Available: 481 (96.2%, NA: 19 = 3.8%) Unique: 3 Drug: Amoxicillin/clavulanic acid (AMC, J01CR02) Drug group: Beta-lactams/penicillins %SI: 78.59%","code":"library(dplyr) # part of tidyverse library(ggplot2) # part of tidyverse library(AMR) # this package library(cleaner) # to create frequency tables # transform variables data <- WHONET %>%   # get microbial ID based on given organism   mutate(mo = as.mo(Organism)) %>%   # transform everything from \"AMP_ND10\" to \"CIP_EE\" to the new `sir` class   mutate_at(vars(AMP_ND10:CIP_EE), as.sir) # our newly created `mo` variable, put in the mo_name() function data %>% freq(mo_name(mo), nmax = 10) # our transformed antibiotic columns # amoxicillin/clavulanic acid (J01CR02) as an example data %>% freq(AMC_ND2)"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"a-first-glimpse-at-results","dir":"Articles","previous_headings":"","what":"A first glimpse at results","title":"How to work with WHONET data","text":"easy ggplot already give lot information, using included ggplot_sir() function:","code":"data %>%   group_by(Country) %>%   select(Country, AMP_ND2, AMC_ED20, CAZ_ED10, CIP_ED5) %>%   ggplot_sir(translate_ab = \"ab\", facet = \"Country\", datalabels = FALSE)"},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Data sets for download / own use","text":"data set 78 679 rows 26 columns, containing following column names:mo, fullname, status, kingdom, phylum, class, order, family, genus, species, subspecies, rank, ref, oxygen_tolerance, source, lpsn, lpsn_parent, lpsn_renamed_to, mycobank, mycobank_parent, mycobank_renamed_to, gbif, gbif_parent, gbif_renamed_to, prevalence, snomed. data set R available microorganisms, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (1.8 MB) Download tab-separated text file (17.7 MB) Download Microsoft Excel workbook (8.7 MB) Download Apache Feather file (8.3 MB) Download Apache Parquet file (3.8 MB) Download IBM SPSS Statistics data file (28.4 MB) Download Stata DTA file (89.5 MB) NOTE: exported files SPSS Stata contain first 50 SNOMED codes per record, file size otherwise exceed 100 MB; file size limit GitHub. file structures compression techniques inefficient. Advice? Use R instead. ’s free much better many ways. tab-separated text file Microsoft Excel workbook contain SNOMED codes comma separated values. Example content Included (sub)species per taxonomic kingdom: First 6 rows filtering genus Escherichia:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antimicrobials-antibiotic-and-antifungal-drugs","dir":"Articles","previous_headings":"","what":"antimicrobials: Antibiotic and Antifungal Drugs","title":"Data sets for download / own use","text":"data set 497 rows 14 columns, containing following column names:ab, cid, name, group, atc, atc_group1, atc_group2, abbreviations, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antimicrobials, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (44 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (75 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (0.3 MB) Download Stata DTA file (10 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain ATC codes, common abbreviations, trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"clinical_breakpoints-interpretation-from-mic-values-disk-diameters-to-sir","dir":"Articles","previous_headings":"","what":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","title":"Data sets for download / own use","text":"data set 40 217 rows 14 columns, containing following column names:guideline, type, host, method, site, mo, rank_index, ab, ref_tbl, disk_dose, breakpoint_S, breakpoint_R, uti, is_SDD. data set R available clinical_breakpoints, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (88 kB) Download tab-separated text file (3.7 MB) Download Microsoft Excel workbook (2.4 MB) Download Apache Feather file (1.8 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (6.6 MB) Download Stata DTA file (11.1 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-groups-species-groups-and-microbiological-complexes","dir":"Articles","previous_headings":"","what":"microorganisms.groups: Species Groups and Microbiological Complexes","title":"Data sets for download / own use","text":"data set 534 rows 4 columns, containing following column names:mo_group, mo, mo_group_name, mo_name. data set R available microorganisms.groups, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (50 kB) Download Microsoft Excel workbook (20 kB) Download Apache Feather file (19 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (65 kB) Download Stata DTA file (83 kB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"intrinsic_resistant-intrinsic-bacterial-resistance","dir":"Articles","previous_headings":"","what":"intrinsic_resistant: Intrinsic Bacterial Resistance","title":"Data sets for download / own use","text":"data set 271 905 rows 2 columns, containing following column names:mo ab. data set R available intrinsic_resistant, load AMR package. last updated 28 March 2025 10:17:49 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (0.1 MB) Download tab-separated text file (10.1 MB) Download Microsoft Excel workbook (2.9 MB) Download Apache Feather file (2.3 MB) Download Apache Parquet file (0.3 MB) Download IBM SPSS Statistics data file (14.8 MB) Download Stata DTA file (22.6 MB) Example content Example rows filtering Enterobacter cloacae:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"dosage-dosage-guidelines-from-eucast","dir":"Articles","previous_headings":"","what":"dosage: Dosage Guidelines from EUCAST","title":"Data sets for download / own use","text":"data set 759 rows 9 columns, containing following column names:ab, name, type, dose, dose_times, administration, notes, original_txt, eucast_version. data set R available dosage, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (4 kB) Download tab-separated text file (66 kB) Download Microsoft Excel workbook (37 kB) Download Apache Feather file (28 kB) Download Apache Parquet file (9 kB) Download IBM SPSS Statistics data file (97 kB) Download Stata DTA file (0.2 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates: Example Data for Practice","title":"Data sets for download / own use","text":"data set 2 000 rows 46 columns, containing following column names:date, patient, age, gender, ward, mo, PEN, OXA, FLC, AMX, AMC, AMP, TZP, CZO, FEP, CXM, FOX, CTX, CAZ, CRO, GEN, TOB, AMK, KAN, TMP, SXT, NIT, FOS, LNZ, CIP, MFX, VAN, TEC, TCY, TGC, DOX, ERY, CLI, AZM, IPM, MEM, MTR, CHL, COL, MUP, RIF. data set R available example_isolates, load AMR package. last updated 15 June 2024 13:33:49 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates_unclean-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates_unclean: Example Data for Practice","title":"Data sets for download / own use","text":"data set 3 000 rows 8 columns, containing following column names:patient_id, hospital, date, bacteria, AMX, AMC, CIP, GEN. data set R available example_isolates_unclean, load AMR package. last updated 27 August 2022 18:49:37 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-codes-common-laboratory-codes","dir":"Articles","previous_headings":"","what":"microorganisms.codes: Common Laboratory Codes","title":"Data sets for download / own use","text":"data set 5 063 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 20 April 2025 13:27:36 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (23 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (84 kB) Download Apache Feather file (87 kB) Download Apache Parquet file (59 kB) Download IBM SPSS Statistics data file (0.1 MB) Download Stata DTA file (0.1 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antivirals-antiviral-drugs","dir":"Articles","previous_headings":"","what":"antivirals: Antiviral Drugs","title":"Data sets for download / own use","text":"data set 120 rows 11 columns, containing following column names:av, name, atc, cid, atc_group, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antivirals, load AMR package. last updated 20 October 2023 12:51:48 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (17 kB) Download Microsoft Excel workbook (16 kB) Download Apache Feather file (16 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (32 kB) Download Stata DTA file (78 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Matthijs S. Berends. Author, maintainer. Dennis Souverein. Author, contributor. Erwin E. . Hassing. Author, contributor. Aislinn Cook. Contributor. Andrew P. Norgan. Contributor. Anita Williams. Contributor. Annick Lenglet. Contributor. Anthony Underwood. Contributor. Anton Mymrikov. Contributor. Bart C. Meijer. Contributor. Christian F. Luz. Contributor. Dmytro Mykhailenko. Contributor. Eric H. L. C. M. Hazenberg. Contributor. Gwen Knight. Contributor. Jane Hawkey. Contributor. Jason Stull. Contributor. Javier Sanchez. Contributor. Jonas Salm. Contributor. Judith M. Fonville. Contributor. Kathryn Holt. Contributor. Larisse Bolton. Contributor. Matthew Saab. Contributor. Natacha Couto. Contributor. Peter Dutey-Magni. Contributor. Rogier P. Schade. Contributor. Sofia Ny. Contributor. Alex W. Friedrich. Thesis advisor. Bhanu N. M. Sinha. Thesis advisor. Casper J. Albers. Thesis advisor. Corinna Glasner. Thesis advisor.","code":""},{"path":"https://amr-for-r.org/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). “AMR: R Package Working Antimicrobial Resistance Data.” Journal Statistical Software, 104(3), 1–31. doi:10.18637/jss.v104.i03.","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/index.html","id":"the-amr-package-for-r-","dir":"","previous_headings":"","what":"Antimicrobial Resistance Data Analysis","title":"Antimicrobial Resistance Data Analysis","text":"Provides --one solution antimicrobial resistance (AMR) data analysis One Health approach Peer-reviewed, used 175 countries, available 20 languages Generates antibiograms - traditional, combined, syndromic, even WISCA Provides full microbiological taxonomy ~79 000 distinct species extensive info ~620 antimicrobial drugs Applies CLSI 2011-2025 EUCAST 2011-2025 clinical veterinary breakpoints, ECOFFs, MIC disk zone interpretation Corrects duplicate isolates, calculates predicts AMR per antimicrobial class Integrates WHONET, ATC, EARS-Net, PubChem, LOINC, SNOMED CT, NCBI 100% free costs dependencies, highly suitable places limited resources Now available Python ! Click read . https://amr--r.org https://doi.org/10.18637/jss.v104.i03","code":""},{"path":"https://amr-for-r.org/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Antimicrobial Resistance Data Analysis","text":"AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. team many different researchers around globe make successful durable project! work published Journal Statistical Software (Volume 104(3); DOI 10.18637/jss.v104.i03) formed basis two PhD theses (DOI 10.33612/diss.177417131 DOI 10.33612/diss.192486375). installing package, R knows ~79 000 distinct microbial species (updated June 2024) ~620 antimicrobial antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI 2011-2025 EUCAST 2011-2025 included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen University Medical Center Groningen.","code":""},{"path":"https://amr-for-r.org/index.html","id":"used-in-over-175-countries-available-in-20-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, available in 20 languages","title":"Antimicrobial Resistance Data Analysis","text":"Since first public release early 2018, R package used almost countries world. Click map enlarge see country names. help contributors corners world, AMR package available  English,  Czech,  Chinese,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Italian,  Japanese,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swedish,  Turkish,  Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"filtering-and-selecting-data","dir":"","previous_headings":"Practical examples","what":"Filtering and selecting data","title":"Antimicrobial Resistance Data Analysis","text":"One powerful functions package, aside calculating plotting AMR, selecting filtering based antimicrobial columns. can done using -called antimicrobial selectors, work base R, dplyr data.table. defined row filter Gram-negative bacteria intrinsic resistance cefotaxime (mo_is_gram_negative() mo_is_intrinsic_resistant()) column selection two antibiotic groups (aminoglycosides() carbapenems()), reference data microorganisms antimicrobials AMR package make sure get meant.","code":"# AMR works great with dplyr, but it's not required or neccesary library(AMR) library(dplyr, warn.conflicts = FALSE)  example_isolates %>%   mutate(bacteria = mo_fullname()) %>%   # filtering functions for microorganisms:   filter(mo_is_gram_negative(),          mo_is_intrinsic_resistant(ab = \"cefotax\")) %>%   # antimicrobial selectors:   select(bacteria,          aminoglycosides(),          carbapenems()) #> ℹ Using column 'mo' as input for mo_fullname() #> ℹ Using column 'mo' as input for mo_is_gram_negative() #> ℹ Using column 'mo' as input for mo_is_intrinsic_resistant() #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). This note will be shown once per session. #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 35 × 7 #>    bacteria                     GEN   TOB   AMK   KAN   IPM   MEM   #>    <chr>                        <sir> <sir> <sir> <sir> <sir> <sir> #>  1 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  2 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  3 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  4 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  5 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  6 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  7 Stenotrophomonas maltophilia R     R     R     R     R     R     #>  8 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  9 Pseudomonas aeruginosa       S     S     S     R     NA    S     #> 10 Pseudomonas aeruginosa       S     S     S     R     S     S     #> # ℹ 25 more rows"},{"path":"https://amr-for-r.org/index.html","id":"generating-antibiograms","dir":"","previous_headings":"Practical examples","what":"Generating antibiograms","title":"Antimicrobial Resistance Data Analysis","text":"AMR package supports generating traditional, combined, syndromic, even weighted-incidence syndromic combination antibiograms (WISCA). used inside R Markdown Quarto, table printed right output format automatically (markdown, LaTeX, HTML, etc.). combination antibiograms, clear combined antimicrobials yield higher empiric coverage: Like many functions package, antibiogram() comes support 20 languages often detected automatically based system language:","code":"antibiogram(example_isolates,             antimicrobials = c(aminoglycosides(), carbapenems())) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ 502 combinations had less than minimum = 30 results and were ignored antibiogram(example_isolates,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") #> ℹ 3 combinations had less than minimum = 30 results and were ignored antibiogram(example_isolates,             antimicrobials = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian #> ℹ 3 combinations had less than minimum = 30 results and were ignored"},{"path":"https://amr-for-r.org/index.html","id":"interpreting-and-plotting-mic-and-sir-values","dir":"","previous_headings":"Practical examples","what":"Interpreting and plotting MIC and SIR values","title":"Antimicrobial Resistance Data Analysis","text":"AMR package allows interpretation MIC disk diffusion values based CLSI EUCAST. Moreover, ggplot2 package extended new scale functions, allow plotting log2-distributed MIC values SIR values.","code":"library(ggplot2) library(AMR)  # generate some random values some_mic_values <- random_mic(size = 100) some_groups <- sample(LETTERS[1:5], 20, replace = TRUE) interpretation <- as.sir(some_mic_values,                          guideline = \"EUCAST 2024\",                          mo = \"E. coli\", # or any code or name resembling a known species                          ab = \"Cipro\")   # or any code or name resembling an antibiotic  # create the plot ggplot(data.frame(mic = some_mic_values,                   group = some_groups,                   sir = interpretation),        aes(x = group, y = mic, colour = sir)) +   theme_minimal() +   geom_boxplot(fill = NA, colour = \"grey\") +   geom_jitter(width = 0.25) +      # NEW scale function: plot MIC values to x, y, colour or fill   scale_y_mic() +      # NEW scale function: write out S/I/R in any of the 20 supported languages   #                     and set colourblind-friendly colours   scale_colour_sir()"},{"path":"https://amr-for-r.org/index.html","id":"calculating-resistance-per-group","dir":"","previous_headings":"Practical examples","what":"Calculating resistance per group","title":"Antimicrobial Resistance Data Analysis","text":"manual approach, can use resistance susceptibility() function: use antimicrobial selectors select series antibiotic columns:","code":"example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance() for gentamicin and tobramycin   # and get their 95% confidence intervals using sir_confidence_interval():   summarise(across(c(GEN, TOB),                    list(total_R = resistance,                         conf_int = function(x) sir_confidence_interval(x, collapse = \"-\")))) #> # A tibble: 3 × 5 #>   ward       GEN_total_R GEN_conf_int TOB_total_R TOB_conf_int #>   <chr>            <dbl> <chr>              <dbl> <chr>        #> 1 Clinical     0.2289362 0.205-0.254    0.3147503 0.284-0.347  #> 2 ICU          0.2902655 0.253-0.33     0.4004739 0.353-0.449  #> 3 Outpatient   0.2       0.131-0.285    0.3676471 0.254-0.493 library(AMR) library(dplyr)  out <- example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance(), over all aminoglycosides and polymyxins:   summarise(across(c(aminoglycosides(), polymyxins()),             resistance)) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For polymyxins() using column 'COL' (colistin) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `across(c(aminoglycosides(), polymyxins()), resistance)`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = \"Outpatient\" (minimum = 30). out #> # A tibble: 3 × 6 #>   ward             GEN       TOB       AMK   KAN       COL #>   <chr>          <dbl>     <dbl>     <dbl> <dbl>     <dbl> #> 1 Clinical   0.2289362 0.3147503 0.6258993     1 0.7802956 #> 2 ICU        0.2902655 0.4004739 0.6624473     1 0.8574144 #> 3 Outpatient 0.2       0.3676471 0.6052632    NA 0.8888889 # transform the antibiotic columns to names: out %>% set_ab_names() #> # A tibble: 3 × 6 #>   ward       gentamicin tobramycin  amikacin kanamycin  colistin #>   <chr>           <dbl>      <dbl>     <dbl>     <dbl>     <dbl> #> 1 Clinical    0.2289362  0.3147503 0.6258993         1 0.7802956 #> 2 ICU         0.2902655  0.4004739 0.6624473         1 0.8574144 #> 3 Outpatient  0.2        0.3676471 0.6052632        NA 0.8888889 # transform the antibiotic column to ATC codes: out %>% set_ab_names(property = \"atc\") #> # A tibble: 3 × 6 #>   ward         J01GB03   J01GB01   J01GB06 J01GB04   J01XB01 #>   <chr>          <dbl>     <dbl>     <dbl>   <dbl>     <dbl> #> 1 Clinical   0.2289362 0.3147503 0.6258993       1 0.7802956 #> 2 ICU        0.2902655 0.4004739 0.6624473       1 0.8574144 #> 3 Outpatient 0.2       0.3676471 0.6052632      NA 0.8888889"},{"path":"https://amr-for-r.org/index.html","id":"what-else-can-you-do-with-this-package","dir":"","previous_headings":"","what":"What else can you do with this package?","title":"Antimicrobial Resistance Data Analysis","text":"package intended comprehensive toolbox integrated AMR data analysis. package can used : Reference taxonomy microorganisms, since package contains microbial (sub)species List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF) (manual) Interpreting raw MIC disk diffusion values, based CLSI EUCAST guideline (manual) Retrieving antimicrobial drug names, doses forms administration clinical health care records (manual) Determining first isolates used AMR data analysis (manual) Calculating antimicrobial resistance (tutorial) Determining multi-drug resistance (MDR) / multi-drug resistant organisms (MDRO) (tutorial) Calculating (empirical) susceptibility mono therapy combination therapies (tutorial) Apply AMR function predictive modelling (tutorial) Getting properties microorganism (like Gram stain, species, genus family) (manual) Getting properties antimicrobial (like name, code EARS-Net/ATC/LOINC/PubChem, defined daily dose trade name) (manual) Plotting antimicrobial resistance (tutorial) Applying EUCAST expert rules (manual) Getting SNOMED codes microorganism, getting properties microorganism based SNOMED code (manual) Getting LOINC codes antibiotic, getting properties antibiotic based LOINC code (manual) Machine reading EUCAST CLSI guidelines 2011-2021 translate MIC values disk diffusion diameters SIR (link) Principal component analysis AMR (tutorial)","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"latest-official-version","dir":"","previous_headings":"Get this package","what":"Latest official version","title":"Antimicrobial Resistance Data Analysis","text":"package available official R network (CRAN). Install package R CRAN using command: downloaded installed automatically. RStudio, click menu Tools > Install Packages… type “AMR” press Install. Note: functions website may available latest release. use functions data sets mentioned website, install latest beta version.","code":"install.packages(\"AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"latest-beta-version","dir":"","previous_headings":"Get this package","what":"Latest beta version","title":"Antimicrobial Resistance Data Analysis","text":"Please read Developer Guideline . install latest unpublished beta version:","code":"install.packages(\"AMR\", repos = \"beta.amr-for-r.org\")  # if this does not work, try to install directly from GitHub using the 'remotes' package: remotes::install_github(\"msberends/AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"get-started","dir":"","previous_headings":"","what":"Get started","title":"Antimicrobial Resistance Data Analysis","text":"find conduct AMR data analysis, please continue reading get started click link ‘’ menu.","code":""},{"path":"https://amr-for-r.org/index.html","id":"partners","dir":"","previous_headings":"","what":"Partners","title":"Antimicrobial Resistance Data Analysis","text":"initial development package part , related , made possible following non-profit organisations initiatives:","code":""},{"path":"https://amr-for-r.org/index.html","id":"copyright","dir":"","previous_headings":"","what":"Copyright","title":"Antimicrobial Resistance Data Analysis","text":"R package free, open-source software licensed GNU General Public License v2.0 (GPL-2). nutshell, means package: May used commercial purposes May used private purposes May used patent purposes May modified, although: Modifications must released license distributing package Changes made code must documented May distributed, although: Source code must made available package distributed copy license copyright notice must included package. Comes LIMITATION liability Comes warranty","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"objects -called 'Deprecated'. removed future version package. Using give warning name alternative object replaced (one).","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"","code":"ab_class(...)  ab_selector(...)"},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"object class tbl_df (inherits tbl, data.frame) 497 rows 14 columns.","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":null,"dir":"Reference","previous_headings":"","what":"Options for the AMR package — AMR-options","title":"Options for the AMR package — AMR-options","text":"overview package-specific options() can set AMR package.","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Options for the AMR package — AMR-options","text":"AMR_antibiogram_formatting_type  numeric (1-22) use antibiogram(), indicate formatting type use. AMR_breakpoint_type  character use .sir(), indicate breakpoint type use. must either \"ECOFF\", \"animal\", \"human\". AMR_capped_mic_handling  character use .sir(), indicate capped MIC values (<, <=, >, >=) interpreted. Must one \"standard\", \"strict\", \"relaxed\", \"inverse\" - default \"standard\". AMR_cleaning_regex  regular expression (case-insensitive) use .mo() mo_* functions, clean user input. default outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". AMR_custom_ab  file location RDS file, use custom antimicrobial drugs package. explained add_custom_antimicrobials(). AMR_custom_mo  file location RDS file, use custom microorganisms package. explained add_custom_microorganisms(). AMR_eucastrules  character set default types rules eucast_rules() function, must one : \"breakpoints\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expert\"). AMR_guideline  character set default guideline interpreting MIC values disk diffusion diameters .sir(). Can guideline name (e.g., \"CLSI\") name year (e.g. \"CLSI 2019\"). default latest implemented EUCAST guideline, currently \"EUCAST 2025\". Supported guideline currently EUCAST (2011-2025) CLSI (2011-2025). AMR_ignore_pattern  regular expression ignore (.e., make NA) match given .mo() mo_* functions. AMR_include_PKPD  logical use .sir(), indicate PK/PD clinical breakpoints must applied last resort - default TRUE. AMR_substitute_missing_r_breakpoint  logical use .sir(), indicate missing R breakpoints must substituted \"R\" - default FALSE. AMR_include_screening  logical use .sir(), indicate clinical breakpoints screening allowed - default FALSE. AMR_keep_synonyms  logical use .mo() mo_* functions, indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE. AMR_locale  character set language AMR package, can one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). default current system language (supported, English otherwise). AMR_mo_source  file location manual code list used .mo() mo_* functions. explained set_mo_source().","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"saving-settings-between-sessions","dir":"Reference","previous_headings":"","what":"Saving Settings Between Sessions","title":"Options for the AMR package — AMR-options","text":"Settings R saved globally thus lost R exited. can save options .Rprofile file, user-specific file. can edit using:   file, can set options ...   ...add Portuguese language support antimicrobials, allow PK/PD rules interpreting MIC values .sir().","code":"utils::file.edit(\"~/.Rprofile\") options(AMR_locale = \"pt\")  options(AMR_include_PKPD = TRUE)"},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"share-options-within-team","dir":"Reference","previous_headings":"","what":"Share Options Within Team","title":"Options for the AMR package — AMR-options","text":"global approach, e.g. within (data) team, save options file remote file location, shared network drive, user read file automatically start-. work way: Save plain text file e.g. \"X:/team_folder/R_options.R\" fill preferred settings. user, open .Rprofile file using utils::file.edit(\"~/.Rprofile\") put :   Reload R/RStudio check settings getOption(), e.g. getOption(\"AMR_locale\") set value. Now team settings configured one place, can maintained .","code":"source(\"X:/team_folder/R_options.R\")"},{"path":"https://amr-for-r.org/reference/AMR.html","id":null,"dir":"Reference","previous_headings":"","what":"The AMR Package — AMR","title":"The AMR Package — AMR","text":"Welcome AMR package. AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. Many different researchers around globe continually helping us make successful durable project! work published Journal Statistical Software (Volume 104(3); doi:10.18637/jss.v104.i03 ) formed basis two PhD theses (doi:10.33612/diss.177417131  doi:10.33612/diss.192486375 ). installing package, R knows ~79 000 microorganisms (updated June 2024) ~620 antibiotic, antimycotic antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI EUCAST included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences public University Groningen, collaboration non-profit organisations Certe Medical Diagnostics Advice Foundation University Medical Center Groningen. AMR package available English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":"https://amr-for-r.org/reference/AMR.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"The AMR Package — AMR","text":"cite AMR publications use: Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). \"AMR: R Package Working Antimicrobial Resistance Data.\" Journal Statistical Software, 104(3), 1-31. doi:10.18637/jss.v104.i03 BibTeX entry LaTeX users :","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/reference/AMR.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"The AMR Package — AMR","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/AMR.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"The AMR Package — AMR","text":"Maintainer: Matthijs S. Berends m.s.berends@umcg.nl (ORCID) Authors: Dennis Souverein (ORCID) [contributor] Erwin E. . Hassing [contributor] contributors: Aislinn Cook (ORCID) [contributor] Andrew P. Norgan (ORCID) [contributor] Anita Williams (ORCID) [contributor] Annick Lenglet (ORCID) [contributor] Anthony Underwood (ORCID) [contributor] Anton Mymrikov [contributor] Bart C. Meijer [contributor] Christian F. Luz (ORCID) [contributor] Dmytro Mykhailenko [contributor] Eric H. L. C. M. Hazenberg [contributor] Gwen Knight (ORCID) [contributor] Jane Hawkey (ORCID) [contributor] Jason Stull (ORCID) [contributor] Javier Sanchez (ORCID) [contributor] Jonas Salm [contributor] Judith M. Fonville [contributor] Kathryn Holt (ORCID) [contributor] Larisse Bolton (ORCID) [contributor] Matthew Saab [contributor] Natacha Couto (ORCID) [contributor] Peter Dutey-Magni (ORCID) [contributor] Rogier P. Schade [contributor] Sofia Ny (ORCID) [contributor] Alex W. Friedrich (ORCID) [thesis advisor] Bhanu N. M. Sinha (ORCID) [thesis advisor] Casper J. Albers (ORCID) [thesis advisor] Corinna Glasner (ORCID) [thesis advisor]","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":null,"dir":"Reference","previous_headings":"","what":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"antimicrobial drugs official names, ATC codes, ATC groups defined daily dose (DDD) included package, using Collaborating Centre Drug Statistics Methodology.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"","code":"as.ab(\"meropenem\") #> Class 'ab' #> [1] MEM ab_name(\"J01DH02\") #> [1] \"Meropenem\"  ab_tradenames(\"flucloxacillin\") #>  [1] \"bactopen\"             \"cloxacap\"             \"cloxacillinhydrate\"   #>  [4] \"cloxypen\"             \"floxacillin\"          \"floxacillinanhydrous\" #>  [7] \"floxapen\"             \"floxapensalt\"         \"fluclomix\"            #> [10] \"flucloxacilina\"       \"flucloxacilline\"      \"flucloxacillinum\"     #> [13] \"flucloxin\"            \"fluorochloroxacillin\" \"galfloxin\"            #> [16] \"latocillin\"           \"orbeninhydrate\"       \"rimaflox\"             #> [19] \"staphobristol\"        \"zoxin\""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 500 Isolates - WHONET Example — WHONET","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"example data set exact structure export file WHONET. files can used package, example data set shows. antimicrobial results example_isolates data set. patient names created using online surname generators place practice purposes.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET"},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"tibble 500 observations 53 variables: Identification number ID sample Specimen number ID specimen Organism Name microorganism. analysis, transform valid microbial class, using .mo(). Country Country origin Laboratory Name laboratory Last name Fictitious last name patient First name Fictitious initial patient Sex Fictitious gender patient Age Fictitious age patient Age category Age group, can also looked using age_groups() Date admissionDate hospital admission Specimen dateDate specimen received laboratory Specimen type Specimen type group Specimen type (Numeric) Translation \"Specimen type\" Reason Reason request Differential Diagnosis Isolate number ID isolate Organism type Type microorganism, can also looked using mo_type() Serotype Serotype microorganism Beta-lactamase Microorganism produces beta-lactamase? ESBL Microorganism produces extended spectrum beta-lactamase? Carbapenemase Microorganism produces carbapenemase? MRSA screening test Microorganism possible MRSA? Inducible clindamycin resistance Clindamycin can induced? Comment comments Date data entryDate data entered WHONET AMP_ND10:CIP_EE 28 different antimicrobials. can lookup abbreviations antimicrobials data set, use e.g. ab_name(\"AMP\") get official name immediately. analysis, transform valid antimicrobial class, using .sir().","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET #> # A tibble: 500 × 53 #>    `Identification number` `Specimen number` Organism Country         Laboratory #>    <chr>                               <int> <chr>    <chr>           <chr>      #>  1 fe41d7bafa                           1748 SPN      Belgium         National … #>  2 91f175ec37                           1767 eco      The Netherlands National … #>  3 cc4015056e                           1343 eco      The Netherlands National … #>  4 e864b692f5                           1894 MAP      Denmark         National … #>  5 3d051fe345                           1739 PVU      Belgium         National … #>  6 c80762a08d                           1846 103      The Netherlands National … #>  7 8022d3727c                           1628 103      Denmark         National … #>  8 f3dc5f553d                           1493 eco      The Netherlands National … #>  9 15add38f6c                           1847 eco      France          National … #> 10 fd41248def                           1458 eco      Germany         National … #> # ℹ 490 more rows #> # ℹ 48 more variables: `Last name` <chr>, `First name` <chr>, Sex <chr>, #> #   Age <dbl>, `Age category` <chr>, `Date of admission` <date>, #> #   `Specimen date` <date>, `Specimen type` <chr>, #> #   `Specimen type (Numeric)` <dbl>, Reason <chr>, `Isolate number` <int>, #> #   `Organism type` <chr>, Serotype <chr>, `Beta-lactamase` <lgl>, ESBL <lgl>, #> #   Carbapenemase <lgl>, `MRSA screening test` <lgl>, …"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Use function e.g. clinical texts health care records. returns list antimicrobial drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"ab_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_ab = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_ab type = \"drug\": column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"function also internally used .ab(), although searches first drug name throw note drug names returned. Note: .ab() function may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"default, function search antimicrobial drug names. text elements searched official names, ATC codes brand names. uses .ab() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(abx = ab_from_text(clinical_text)) returned AB codes can transformed official names, groups, etc. ab_* functions ab_name() ab_group(), using translate_ab argument. using collapse, function return character:df %>% mutate(abx = ab_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"# mind the bad spelling of amoxicillin in this line, # straight from a true health care record: ab_from_text(\"28/03/2020 regular amoxicilliin 500mg po tid\") #> [[1]] #> Class 'ab' #> [1] AMX #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") #> [[1]] #> Class 'ab' #> [1] AMX CIP #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"dose\") #> [[1]] #> [1] 500 400 #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"admin\") #> [[1]] #> [1] \"oral\" \"iv\"   #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", collapse = \", \") #> [1] \"AMX, CIP\" # \\donttest{ # if you want to know which antibiotic groups were administered, do e.g.: abx <- ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") ab_group(abx[[1]]) #> [1] \"Beta-lactams/penicillins\" \"Fluoroquinolones\"          if (require(\"dplyr\")) {   tibble(clinical_text = c(     \"given 400mg cipro and 500 mg amox\",     \"started on doxy iv today\"   )) %>%     mutate(       abx_codes = ab_from_text(clinical_text),       abx_doses = ab_from_text(clinical_text, type = \"doses\"),       abx_admin = ab_from_text(clinical_text, type = \"admin\"),       abx_coll = ab_from_text(clinical_text, collapse = \"|\"),       abx_coll_names = ab_from_text(clinical_text,         collapse = \"|\",         translate_ab = \"name\"       ),       abx_coll_doses = ab_from_text(clinical_text,         type = \"doses\",         collapse = \"|\"       ),       abx_coll_admin = ab_from_text(clinical_text,         type = \"admin\",         collapse = \"|\"       )     ) } #> Loading required package: dplyr #>  #> Attaching package: ‘dplyr’ #> The following objects are masked from ‘package:stats’: #>  #>     filter, lag #> The following objects are masked from ‘package:base’: #>  #>     intersect, setdiff, setequal, union #> # A tibble: 2 × 8 #>   clinical_text            abx_codes abx_doses abx_admin abx_coll abx_coll_names #>   <chr>                    <list>    <list>    <list>    <chr>    <chr>          #> 1 given 400mg cipro and 5… <ab [2]>  <dbl [2]> <chr [1]> CIP|AMX  Ciprofloxacin… #> 2 started on doxy iv today <ab [1]>  <dbl [1]> <chr [1]> DOX      Doxycycline    #> # ℹ 2 more variables: abx_coll_doses <chr>, abx_coll_admin <chr> # }"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antibiotic — ab_property","title":"Get Properties of an Antibiotic — ab_property","text":"Use functions return specific property antibiotic antimicrobials data set. input values evaluated internally .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"ab_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  ab_cid(x, ...)  ab_synonyms(x, ...)  ab_tradenames(x, ...)  ab_group(x, language = get_AMR_locale(), ...)  ab_atc(x, only_first = FALSE, ...)  ab_atc_group1(x, language = get_AMR_locale(), ...)  ab_atc_group2(x, language = get_AMR_locale(), ...)  ab_loinc(x, ...)  ab_ddd(x, administration = \"oral\", ...)  ab_ddd_units(x, administration = \"oral\", ...)  ab_info(x, language = get_AMR_locale(), ...)  ab_url(x, open = FALSE, ...)  ab_property(x, property = \"name\", language = get_AMR_locale(), ...)  set_ab_names(data, ..., property = \"name\", language = get_AMR_locale(),   snake_case = NULL)"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antibiotic — ab_property","text":"x (vector ) text can coerced valid antibiotic drug code .ab(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. lead e.g. \"polymyxin B\" \"polymyxin b\". ... case set_ab_names() data data.frame: columns select (supports tidy selection column1:column4), otherwise arguments passed .ab(). only_first logical indicate whether first ATC code must returned, giving preference J0-codes (.e., antimicrobial drug group). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antimicrobials data set: vector_or(colnames(antimicrobials), sort = FALSE). data data.frame columns need renamed, character vector column names. snake_case logical indicate whether names -called snake case: lower case spaces/slashes replaced underscore (_).","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antibiotic — ab_property","text":"integer case ab_cid() named list case ab_info() multiple ab_atc()/ab_synonyms()/ab_tradenames() double case ab_ddd() data.frame case set_ab_names() character cases","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antibiotic — ab_property","text":"output translated possible. function ab_url() return direct URL official website. warning returned required ATC code available. function set_ab_names() special column renaming function data.frames. renames columns names resemble antimicrobial drugs. always makes sure new column names unique. property = \"atc\" set, preference given ATC codes J-group.","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antibiotic — ab_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antibiotic — ab_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"# all properties: ab_name(\"AMX\") #> [1] \"Amoxicillin\" ab_atc(\"AMX\") #> [1] \"J01CA04\" ab_cid(\"AMX\") #> [1] 33613 ab_synonyms(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_tradenames(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_group(\"AMX\") #> [1] \"Beta-lactams/penicillins\" ab_atc_group1(\"AMX\") #> [1] \"Beta-lactam antibacterials, penicillins\" ab_atc_group2(\"AMX\") #> [1] \"Penicillins with extended spectrum\" ab_url(\"AMX\") #>                                                             Amoxicillin  #> \"https://atcddd.fhi.no/atc_ddd_index//?code=J01CA04&showdescription=no\"   # smart lowercase transformation ab_name(x = c(\"AMC\", \"PLB\")) #> [1] \"Amoxicillin/clavulanic acid\" \"Polymyxin B\"                 ab_name(x = c(\"AMC\", \"PLB\"), tolower = TRUE) #> [1] \"amoxicillin/clavulanic acid\" \"polymyxin B\"                  # defined daily doses (DDD) ab_ddd(\"AMX\", \"oral\") #> [1] 1.5 ab_ddd_units(\"AMX\", \"oral\") #> [1] \"g\" ab_ddd(\"AMX\", \"iv\") #> [1] 3 ab_ddd_units(\"AMX\", \"iv\") #> [1] \"g\"  ab_info(\"AMX\") # all properties as a list #> $ab #> [1] \"AMX\" #>  #> $cid #> [1] 33613 #>  #> $name #> [1] \"Amoxicillin\" #>  #> $group #> [1] \"Beta-lactams/penicillins\" #>  #> $atc #> [1] \"J01CA04\" #>  #> $atc_group1 #> [1] \"Beta-lactam antibacterials, penicillins\" #>  #> $atc_group2 #> [1] \"Penicillins with extended spectrum\" #>  #> $tradenames #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           #>  #> $loinc #>  [1] \"101498-4\" \"15-8\"     \"16-6\"     \"16365-9\"  \"17-4\"     \"18-2\"     #>  [7] \"18861-5\"  \"18862-3\"  \"19-0\"     \"20-8\"     \"21-6\"     \"22-4\"     #> [13] \"25274-2\"  \"25310-4\"  \"3344-9\"   \"55614-2\"  \"55615-9\"  \"55616-7\"  #> [19] \"6976-5\"   \"6977-3\"   \"80133-2\"  #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 1.5 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 3 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all ab_* functions use as.ab() internally, so you can go from 'any' to 'any': ab_atc(\"AMP\") #> [1] \"J01CA01\" \"S01AA19\" ab_group(\"J01CA01\") #> [1] \"Beta-lactams/penicillins\" ab_loinc(\"ampicillin\") #>  [1] \"101477-8\" \"101478-6\" \"18864-9\"  \"18865-6\"  \"20374-5\"  \"21066-6\"  #>  [7] \"23618-2\"  \"27-3\"     \"28-1\"     \"29-9\"     \"30-7\"     \"31-5\"     #> [13] \"32-3\"     \"33-1\"     \"3355-5\"   \"33562-0\"  \"33919-2\"  \"34-9\"     #> [19] \"43883-8\"  \"43884-6\"  \"6979-9\"   \"6980-7\"   \"87604-5\"  ab_name(\"21066-6\") #> [1] \"Ampicillin\" ab_name(6249) #> [1] \"Ampicillin\" ab_name(\"J01CA01\") #> [1] \"Ampicillin\"  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  # use set_ab_names() for renaming columns colnames(example_isolates) #>  [1] \"date\"    \"patient\" \"age\"     \"gender\"  \"ward\"    \"mo\"      \"PEN\"     #>  [8] \"OXA\"     \"FLC\"     \"AMX\"     \"AMC\"     \"AMP\"     \"TZP\"     \"CZO\"     #> [15] \"FEP\"     \"CXM\"     \"FOX\"     \"CTX\"     \"CAZ\"     \"CRO\"     \"GEN\"     #> [22] \"TOB\"     \"AMK\"     \"KAN\"     \"TMP\"     \"SXT\"     \"NIT\"     \"FOS\"     #> [29] \"LNZ\"     \"CIP\"     \"MFX\"     \"VAN\"     \"TEC\"     \"TCY\"     \"TGC\"     #> [36] \"DOX\"     \"ERY\"     \"CLI\"     \"AZM\"     \"IPM\"     \"MEM\"     \"MTR\"     #> [43] \"CHL\"     \"COL\"     \"MUP\"     \"RIF\"     colnames(set_ab_names(example_isolates)) #>  [1] \"date\"                          \"patient\"                       #>  [3] \"age\"                           \"gender\"                        #>  [5] \"ward\"                          \"mo\"                            #>  [7] \"benzylpenicillin\"              \"oxacillin\"                     #>  [9] \"flucloxacillin\"                \"amoxicillin\"                   #> [11] \"amoxicillin_clavulanic_acid\"   \"ampicillin\"                    #> [13] \"piperacillin_tazobactam\"       \"cefazolin\"                     #> [15] \"cefepime\"                      \"cefuroxime\"                    #> [17] \"cefoxitin\"                     \"cefotaxime\"                    #> [19] \"ceftazidime\"                   \"ceftriaxone\"                   #> [21] \"gentamicin\"                    \"tobramycin\"                    #> [23] \"amikacin\"                      \"kanamycin\"                     #> [25] \"trimethoprim\"                  \"trimethoprim_sulfamethoxazole\" #> [27] \"nitrofurantoin\"                \"fosfomycin\"                    #> [29] \"linezolid\"                     \"ciprofloxacin\"                 #> [31] \"moxifloxacin\"                  \"vancomycin\"                    #> [33] \"teicoplanin\"                   \"tetracycline\"                  #> [35] \"tigecycline\"                   \"doxycycline\"                   #> [37] \"erythromycin\"                  \"clindamycin\"                   #> [39] \"azithromycin\"                  \"imipenem\"                      #> [41] \"meropenem\"                     \"metronidazole\"                 #> [43] \"chloramphenicol\"               \"colistin\"                      #> [45] \"mupirocin\"                     \"rifampicin\"                    colnames(set_ab_names(example_isolates, NIT:VAN)) #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     set_ab_names()    # this does the same:   example_isolates %>%     rename_with(set_ab_names)    # set_ab_names() works with any AB property:   example_isolates %>%     set_ab_names(property = \"atc\")    example_isolates %>%     set_ab_names(where(is.sir)) %>%     colnames()    example_isolates %>%     set_ab_names(NIT:VAN) %>%     colnames() } #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # }"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Antimicrobials — add_custom_antimicrobials","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"add_custom_antimicrobials() can add custom antimicrobial drug names codes.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"add_custom_antimicrobials(x)  clear_custom_antimicrobials()"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"x data.frame resembling antimicrobials data set, least containing columns \"ab\" \"name\".","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"Important: Due R works, add_custom_antimicrobials() function run every R session - added antimicrobials stored sessions thus lost R exited. two ways circumvent automate process adding antimicrobials: Method 1: Using package option AMR_custom_ab, preferred method. use method: Create data set structure antimicrobials data set (containing least columns \"ab\" \"name\") save saveRDS() location choice, e.g. \"~/my_custom_ab.rds\", remote location. Set file location package option AMR_custom_ab: options(AMR_custom_ab = \"~/my_custom_ab.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_antimicrobials() function. Method 2: Loading antimicrobial additions directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_antimicrobials() clear previously added antimicrobials.","code":"# Add custom antimicrobial codes: options(AMR_custom_ab = \"~/my_custom_ab.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_antimicrobials(    data.frame(ab = \"TESTAB\",               name = \"Test Antibiotic\",               group = \"Test Group\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"# \\donttest{ # returns a wildly guessed result: as.ab(\"testab\") #> Class 'ab' #> [1] CTE  # now add a custom entry - it will be considered by as.ab() and # all ab_*() functions add_custom_antimicrobials(   data.frame(     ab = \"TESTAB\",     name = \"Test Antibiotic\",     # you can add any property present in the     # 'antimicrobials' data set, such as 'group':     group = \"Test Group\"   ) ) #> ℹ Added one record to the internal antimicrobials data set.  # \"testab\" is now a new antibiotic: as.ab(\"testab\") #> Class 'ab' #> [1] TESTAB ab_name(\"testab\") #> [1] \"Test Antibiotic\" ab_group(\"testab\") #> [1] \"Test Group\"  ab_info(\"testab\") #> $ab #> [1] \"TESTAB\" #>  #> $cid #> [1] NA #>  #> $name #> [1] \"Test Antibiotic\" #>  #> $group #> [1] \"Test Group\" #>  #> $atc #> [1] NA #>  #> $atc_group1 #> [1] NA #>  #> $atc_group2 #> [1] NA #>  #> $tradenames #> [1] NA #>  #> $loinc #> [1] NA #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] NA #>  #> $ddd$oral$units #> [1] NA #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] NA #>  #> $ddd$iv$units #> [1] NA #>  #>  #>    # Add Co-fluampicil, which is one of the many J01CR50 codes, see # https://atcddd.fhi.no/ddd/list_of_ddds_combined_products/ add_custom_antimicrobials(   data.frame(     ab = \"COFLU\",     name = \"Co-fluampicil\",     atc = \"J01CR50\",     group = \"Beta-lactams/penicillins\"   ) ) #> ℹ Added one record to the internal antimicrobials data set. ab_atc(\"Co-fluampicil\") #> [1] \"J01CR50\" ab_name(\"J01CR50\") #> [1] \"Co-fluampicil\"  # even antimicrobial selectors work # see ?amr_selector x <- data.frame(   random_column = \"some value\",   coflu = as.sir(\"S\"),   ampicillin = as.sir(\"R\") ) x #>   random_column coflu ampicillin #> 1    some value     S          R x[, betalactams()] #> ℹ For betalactams() using columns 'coflu' (co-fluampicil) and #>   'ampicillin' #>   coflu ampicillin #> 1     S          R # }"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Microorganisms — add_custom_microorganisms","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"add_custom_microorganisms() can add custom microorganisms, non-taxonomic outcome laboratory analysis.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"add_custom_microorganisms(x)  clear_custom_microorganisms()"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"x data.frame resembling microorganisms data set, least containing column \"genus\" (case-insensitive).","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"function fill missing taxonomy , specific taxonomic columns missing, see Examples. Important: Due R works, add_custom_microorganisms() function run every R session - added microorganisms stored sessions thus lost R exited. two ways circumvent automate process adding microorganisms: Method 1: Using package option AMR_custom_mo, preferred method. use method: Create data set structure microorganisms data set (containing least column \"genus\") save saveRDS() location choice, e.g. \"~/my_custom_mo.rds\", remote location. Set file location package option AMR_custom_mo: options(AMR_custom_mo = \"~/my_custom_mo.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_microorganisms() function. Method 2: Loading microorganism directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_microorganisms() clear previously added microorganisms.","code":"# Add custom microorganism codes: options(AMR_custom_mo = \"~/my_custom_mo.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_microorganisms(    data.frame(genus = \"Enterobacter\",               species = \"asburiae/cloacae\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"# \\donttest{ # a combination of species is not formal taxonomy, so # this will result in \"Enterobacter cloacae cloacae\", # since it resembles the input best: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae\"  # now add a custom entry - it will be considered by as.mo() and # all mo_*() functions add_custom_microorganisms(   data.frame(     genus = \"Enterobacter\",     species = \"asburiae/cloacae\"   ) ) #> ℹ Added Enterobacter asburiae/cloacae to the internal microorganisms data #>   set.  # E. asburiae/cloacae is now a new microorganism: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # its code: as.mo(\"Enterobacter asburiae/cloacae\") #> Class 'mo' #> [1] CUSTOM1_ENTRB_ASB/  # all internal algorithms will work as well: mo_name(\"Ent asburia cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # and even the taxonomy was added based on the genus! mo_family(\"E. asburiae/cloacae\") #> [1] \"Enterobacteriaceae\" mo_gramstain(\"Enterobacter asburiae/cloacae\") #> [1] \"Gram-negative\"  mo_info(\"Enterobacter asburiae/cloacae\") #> $mo #> [1] \"CUSTOM1_ENTRB_ASB/\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Enterobacter\" #>  #> $species #> [1] \"asburiae/cloacae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] NA #>  #> $url #> [1] \"\" #>  #> $ref #> [1] \"Self-added, 2025\" #>  #> $snomed #> [1] NA #>  #> $lpsn #> [1] NA #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] NA #>  #> $group_members #> character(0) #>    # the function tries to be forgiving: add_custom_microorganisms(   data.frame(     GENUS = \"BACTEROIDES / PARABACTEROIDES SLASHLINE\",     SPECIES = \"SPECIES\"   ) ) #> ℹ Added Bacteroides/Parabacteroides to the internal microorganisms data #>   set. mo_name(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"Bacteroides/Parabacteroides\" mo_rank(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"genus\"  # taxonomy still works, even though a slashline genus was given as input: mo_family(\"Bacteroides/Parabacteroides\") #> [1] \"Bacteroidaceae\"   # for groups and complexes, set them as species or subspecies: add_custom_microorganisms(   data.frame(     genus = \"Citrobacter\",     species = c(\"freundii\", \"braakii complex\"),     subspecies = c(\"complex\", \"\")   ) ) #> ℹ Added Citrobacter braakii complex and Citrobacter freundii complex to the #>   internal microorganisms data set. mo_name(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Citrobacter freundii complex\" \"Citrobacter braakii complex\"  mo_species(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"freundii complex\" \"braakii complex\"  mo_gramstain(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Gram-negative\" \"Gram-negative\" # }"},{"path":"https://amr-for-r.org/reference/age.html","id":null,"dir":"Reference","previous_headings":"","what":"Age in Years of Individuals — age","title":"Age in Years of Individuals — age","text":"Calculates age years based reference date, system date default.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Age in Years of Individuals — age","text":"","code":"age(x, reference = Sys.Date(), exact = FALSE, na.rm = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/age.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Age in Years of Individuals — age","text":"x Date(s), character (vectors) coerced .POSIXlt(). reference Reference date(s) (default today), character (vectors) coerced .POSIXlt(). exact logical indicate whether age calculation exact, .e. decimals. divides number days year--date (YTD) x number days year reference (either 365 366). na.rm logical indicate whether missing values removed. ... Arguments passed .POSIXlt(), origin.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Age in Years of Individuals — age","text":"integer (decimals) exact = FALSE, double (decimals) otherwise","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Age in Years of Individuals — age","text":"Ages 0 returned NA warning. Ages 120 give warning. function vectorises x reference, meaning either can length 1 argument larger length.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Age in Years of Individuals — age","text":"","code":"# 10 random pre-Y2K birth dates df <- data.frame(birth_date = as.Date(\"2000-01-01\") - runif(10) * 25000)  # add ages df$age <- age(df$birth_date)  # add exact ages df$age_exact <- age(df$birth_date, exact = TRUE)  # add age at millenium switch df$age_at_y2k <- age(df$birth_date, \"2000-01-01\")  df #>    birth_date age age_exact age_at_y2k #> 1  1999-06-30  25  25.82192          0 #> 2  1968-01-29  57  57.23836         31 #> 3  1965-12-05  59  59.38904         34 #> 4  1980-03-01  45  45.15342         19 #> 5  1949-11-01  75  75.48219         50 #> 6  1947-02-14  78  78.19452         52 #> 7  1940-02-19  85  85.18082         59 #> 8  1988-01-10  37  37.29041         11 #> 9  1997-08-27  27  27.66301          2 #> 10 1978-01-26  47  47.24658         21"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Split Ages into Age Groups — age_groups","title":"Split Ages into Age Groups — age_groups","text":"Split ages age groups defined split argument. allows easier demographic (antimicrobial resistance) analysis.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split Ages into Age Groups — age_groups","text":"","code":"age_groups(x, split_at = c(12, 25, 55, 75), na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split Ages into Age Groups — age_groups","text":"x Age, e.g. calculated age(). split_at Values split x - default age groups 0-11, 12-24, 25-54, 55-74 75+. See Details. na.rm logical indicate whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Split Ages into Age Groups — age_groups","text":"Ordered factor","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Split Ages into Age Groups — age_groups","text":"split ages, input split_at argument can : numeric vector. value e.g. c(10, 20) split x 0-9, 10-19 20+. value 50 split x 0-49 50+. default split young children (0-11), youth (12-24), young adults (25-54), middle-aged adults (55-74) elderly (75+). character: \"children\" \"kids\", equivalent : c(0, 1, 2, 4, 6, 13, 18). split 0, 1, 2-3, 4-5, 6-12, 13-17 18+. \"elderly\" \"seniors\", equivalent : c(65, 75, 85). split 0-64, 65-74, 75-84, 85+. \"fives\", equivalent : 1:20 * 5. split 0-4, 5-9, ..., 95-99, 100+. \"tens\", equivalent : 1:10 * 10. split 0-9, 10-19, ..., 90-99, 100+.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split Ages into Age Groups — age_groups","text":"","code":"ages <- c(3, 8, 16, 54, 31, 76, 101, 43, 21)  # split into 0-49 and 50+ age_groups(ages, 50) #> [1] 0-49 0-49 0-49 50+  0-49 50+  50+  0-49 0-49 #> Levels: 0-49 < 50+  # split into 0-19, 20-49 and 50+ age_groups(ages, c(20, 50)) #> [1] 0-19  0-19  0-19  50+   20-49 50+   50+   20-49 20-49 #> Levels: 0-19 < 20-49 < 50+  # split into groups of ten years age_groups(ages, 1:10 * 10) #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+ age_groups(ages, split_at = \"tens\") #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+  # split into groups of five years age_groups(ages, 1:20 * 5) #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+ age_groups(ages, split_at = \"fives\") #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+  # split specifically for children age_groups(ages, c(1, 2, 4, 6, 13, 18)) #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+ age_groups(ages, \"children\") #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+  # \\donttest{ # resistance of ciprofloxacin per age group if (require(\"dplyr\") && require(\"ggplot2\")) {   example_isolates %>%     filter_first_isolate() %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(       x = \"age_group\",       minimum = 0,       x.title = \"Age Group\",       title = \"Ciprofloxacin resistance per age group\"     ) } #> Loading required package: ggplot2  # }"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Create detailed antibiograms options traditional, combination, syndromic, Bayesian WISCA methods. Adhering previously described approaches (see Source) especially Bayesian WISCA model (Weighted-Incidence Syndromic Combination Antibiogram) Bielicki et al., functions provide flexible output formats including plots tables, ideal integration R Markdown Quarto reports.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"antibiogram(x, antimicrobials = where(is.sir), mo_transform = \"shortname\",   ab_transform = \"name\", syndromic_group = NULL, add_total_n = FALSE,   only_all_tested = FALSE, digits = ifelse(wisca, 1, 0),   formatting_type = getOption(\"AMR_antibiogram_formatting_type\",   ifelse(wisca, 14, 18)), col_mo = NULL, language = get_AMR_locale(),   minimum = 30, combine_SI = TRUE, sep = \" + \", wisca = FALSE,   simulations = 1000, conf_interval = 0.95, interval_side = \"two-tailed\",   info = interactive(), ...)  wisca(x, antimicrobials = where(is.sir), ab_transform = \"name\",   syndromic_group = NULL, only_all_tested = FALSE, digits = 1,   formatting_type = getOption(\"AMR_antibiogram_formatting_type\", 14),   col_mo = NULL, language = get_AMR_locale(), combine_SI = TRUE,   sep = \" + \", simulations = 1000, conf_interval = 0.95,   interval_side = \"two-tailed\", info = interactive(), ...)  retrieve_wisca_parameters(wisca_model, ...)  # S3 method for class 'antibiogram' plot(x, ...)  # S3 method for class 'antibiogram' autoplot(object, ...)  # S3 method for class 'antibiogram' knit_print(x, italicise = TRUE,   na = getOption(\"knitr.kable.NA\", default = \"\"), ...)"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Bielicki JA et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data Journal Antimicrobial Chemotherapy 71(3); doi:10.1093/jac/dkv397 Bielicki JA et al. (2020). Evaluation coverage 3 antibiotic regimens neonatal sepsis hospital setting across Asian countries JAMA Netw Open. 3(2):e1921124; doi:10.1001.jamanetworkopen.2019.21124 Klinker KP et al. (2021). Antimicrobial stewardship antibiograms: importance moving beyond traditional antibiograms. Therapeutic Advances Infectious Disease, May 5;8:20499361211011373; doi:10.1177/20499361211011373 Barbieri E et al. (2021). Development Weighted-Incidence Syndromic Combination Antibiogram (WISCA) guide choice empiric antibiotic treatment urinary tract infection paediatric patients: Bayesian approach Antimicrobial Resistance & Infection Control May 1;10(1):74; doi:10.1186/s13756-021-00939-2 M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"x data.frame containing least column microorganisms columns antimicrobial results (class 'sir', see .sir()). antimicrobials vector specifying antimicrobials containing SIR values include antibiogram (see Examples). evaluated using guess_ab_col(). can : antimicrobial name code match (see guess_ab_col()) column x antimicrobial selector, aminoglycosides() carbapenems() combination , using c(), e.g.: c(aminoglycosides(), \"AMP\", \"AMC\") c(aminoglycosides(), carbapenems()) Combination therapy, indicated using \"+\", without antimicrobial selectors, e.g.: \"cipro + genta\" \"TZP+TOB\" c(\"TZP\", \"TZP+GEN\", \"TZP+TOB\") carbapenems() + \"GEN\" carbapenems() + c(\"\", \"GEN\") carbapenems() + c(\"\", aminoglycosides()) mo_transform character transform microorganism input - must \"name\", \"shortname\" (default), \"gramstain\", one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Can also NULL transform input NA consider microorganisms 'unknown'. ab_transform character transform antimicrobial input - must one column names antimicrobials data set (defaults \"name\"): \"ab\", \"cid\", \"name\", \"group\", \"atc\", \"atc_group1\", \"atc_group2\", \"abbreviations\", \"synonyms\", \"oral_ddd\", \"oral_units\", \"iv_ddd\", \"iv_units\", \"loinc\". Can also NULL transform input. syndromic_group column name x, values calculated split rows x, e.g. using ifelse() case_when(). See Examples. add_total_n (deprecated favour formatting_type) logical indicate whether n_tested available numbers per pathogen added table (default TRUE). add lowest highest number available isolates per antimicrobial (e.g, E. coli 200 isolates available ciprofloxacin 150 amoxicillin, returned number \"150-200\"). option unavailable wisca = TRUE; case, use retrieve_wisca_parameters() get parameters used WISCA. only_all_tested (combination antibiograms): logical indicate isolates must tested antimicrobials, see Details. digits Number digits use rounding antimicrobial coverage, defaults 1 WISCA 0 otherwise. formatting_type Numeric value (1–22 WISCA, 1-12 non-WISCA) indicating 'cells' antibiogram table formatted. See Details > Formatting Type list options. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). language Language translate text, defaults system language (see get_AMR_locale()). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether susceptibility determined results either S, SDD, , instead S (default TRUE). sep separating character antimicrobial columns combination antibiograms. wisca logical indicate whether Weighted-Incidence Syndromic Combination Antibiogram (WISCA) must generated (default FALSE). use Bayesian decision model estimate regimen coverage probabilities using Monte Carlo simulations. Set simulations, conf_interval, interval_side adjust. simulations (WISCA) numerical value set number Monte Carlo simulations. conf_interval numerical value set confidence interval (default 0.95). interval_side side confidence interval, either \"two-tailed\" (default), \"left\" \"right\". info logical indicate info printed - default TRUE interactive mode. ... used R Markdown Quarto: arguments passed knitr::kable() (otherwise, use). wisca_model outcome wisca() antibiogram(..., wisca = TRUE). object antibiogram() object. italicise logical indicate whether microorganism names knitr table made italic, using italicise_taxonomy(). na Character use showing NA values.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"functions return table values 0 100 susceptibility, resistance. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine one four available algorithms: isolate-based, patient-based, episode-based, phenotype-based. estimating antimicrobial coverage, especially creating WISCA, outcome might become reliable including top n species encountered data. can filter top n using top_n_microorganisms(). example, use top_n_microorganisms(your_data, n = 10) pre-processing step include top 10 species data. numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). ideal e.g. advanced plotting.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"formatting-type","dir":"Reference","previous_headings":"","what":"Formatting Type","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"formatting 'cells' table can set argument formatting_type. examples, 5 indicates antimicrobial coverage (4-6 confidence level), 15 number susceptible isolates, 300 number tested (.e., available) isolates: 5 15 300 15/300 5 (300) 5% (300) 5 (N=300) 5% (N=300) 5 (15/300) 5% (15/300) 5 (N=15/300) 5% (N=15/300) 5 (4-6) 5% (4-6%) - default WISCA 5 (4-6,300) 5% (4-6%,300) 5 (4-6,N=300) 5% (4-6%,N=300) - default non-WISCA 5 (4-6,15/300) 5% (4-6%,15/300) 5 (4-6,N=15/300) 5% (4-6%,N=15/300) default can set globally package option AMR_antibiogram_formatting_type, e.g. options(AMR_antibiogram_formatting_type = 5). note WISCA, total numbers tested susceptible isolates less useful report, since included Bayesian model apparent susceptibility confidence level. Set digits (defaults 0) alter rounding susceptibility percentages.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"antibiogram-types","dir":"Reference","previous_headings":"","what":"Antibiogram Types","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"various antibiogram types, summarised Klinker et al. (2021, doi:10.1177/20499361211011373 ), supported antibiogram(). clinical coverage estimations, use WISCA whenever possible, since provides precise coverage estimates accounting pathogen incidence antimicrobial susceptibility, shown Bielicki et al. (2020, doi:10.1001.jamanetworkopen.2019.21124 ). See section Explaining WISCA page. note WISCA pathogen-agnostic, meaning outcome stratied pathogen, rather syndrome. Traditional Antibiogram Case example: Susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Code example:   Combination Antibiogram Case example: Additional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Code example:   Syndromic Antibiogram Case example: Susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Code example:   Weighted-Incidence Syndromic Combination Antibiogram (WISCA) WISCA can applied antibiogram, see section Explaining WISCA page information. Code example:   WISCA uses sophisticated Bayesian decision model combine local pooled antimicrobial resistance data. approach evaluates local patterns can also draw multi-centre datasets improve regimen accuracy, even low-incidence infections like paediatric bloodstream infections (BSIs).","code":"antibiogram(your_data,             antimicrobials = \"TZP\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\")) antibiogram(your_data,             antimicrobials = penicillins(),             syndromic_group = \"ward\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             wisca = TRUE)  # this is equal to: wisca(your_data,       antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"grouped-tibbles","dir":"Reference","previous_headings":"","what":"Grouped tibbles","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"type antibiogram, grouped tibbles can also used calculate susceptibilities various groups. Code example:","code":"library(dplyr) your_data %>%   group_by(has_sepsis, is_neonate, sex) %>%   wisca(antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"stepped-approach-for-clinical-insight","dir":"Reference","previous_headings":"","what":"Stepped Approach for Clinical Insight","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"clinical practice, antimicrobial coverage decisions evolve microbiological data becomes available. theoretical stepped approach ensures empirical coverage can continuously assessed improve patient outcomes: Initial Empirical Therapy (Admission / Pre-Culture Data) admission, pathogen information available. Action: broad-spectrum coverage based local resistance patterns syndromic antibiograms. Using pathogen-agnostic yet incidence-weighted WISCA preferred. Code example:   Refinement Gram Stain Results blood culture becomes positive, Gram stain provides initial crucial first stratification (Gram-positive vs. Gram-negative). Action: narrow coverage based Gram stain-specific resistance patterns. Code example:   Definitive Therapy Based Species Identification cultivation pathogen, full pathogen identification allows precise targeting therapy. Action: adjust treatment pathogen-specific antibiograms, minimizing resistance risks. Code example:   structuring antibiograms around stepped approach, clinicians can make data-driven adjustments stage, ensuring optimal empirical targeted therapy reducing unnecessary broad-spectrum antimicrobial use.","code":"antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = NA) # all pathogens set to `NA`  # preferred: use WISCA wisca(your_data,       antimicrobials = selected_regimens) antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"gramstain\") # all pathogens set to Gram-pos/Gram-neg antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"shortname\") # all pathogens set to 'G. species', e.g., E. coli"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"inclusion-in-combination-antibiograms","dir":"Reference","previous_headings":"","what":"Inclusion in Combination Antibiograms","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Note combination antibiograms, important realise susceptibility can calculated two ways, can set only_all_tested argument (default FALSE). See example two antimicrobials, Drug Drug B, antibiogram() works calculate %SI:","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - --------------------------------------------------------------------"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"plotting","dir":"Reference","previous_headings":"","what":"Plotting","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"types antibiograms listed can plotted (using ggplot2::autoplot() base R's plot() barplot()). mentioned , numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). outcome antibiogram() can also used directly R Markdown / Quarto (.e., knitr) reports. case, knitr::kable() applied automatically microorganism names even printed italics default (see argument italicise). can also use functions specific 'table reporting' packages transform output antibiogram() needs, e.g. flextable::as_flextable() gt::gt().","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"explaining-wisca","dir":"Reference","previous_headings":"","what":"Explaining WISCA","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"WISCA, outlined Bielicki et al. (doi:10.1093/jac/dkv397 ), stands Weighted-Incidence Syndromic Combination Antibiogram, estimates probability adequate empirical antimicrobial regimen coverage specific infection syndromes. method leverages Bayesian decision model random effects pathogen incidence susceptibility, enabling robust estimates presence sparse data. Bayesian model assumes conjugate priors parameter estimation. example, coverage probability \\(\\theta\\) given antimicrobial regimen modelled using Beta distribution prior: $$\\theta \\sim \\text{Beta}(\\alpha_0, \\beta_0)$$ \\(\\alpha_0\\) \\(\\beta_0\\) represent prior successes failures, respectively, informed expert knowledge weakly informative priors (e.g., \\(\\alpha_0 = 1, \\beta_0 = 1\\)). likelihood function constructed based observed data, number covered cases regimen follows binomial distribution: $$y \\sim \\text{Binomial}(n, \\theta)$$ Posterior parameter estimates obtained combining prior likelihood using Bayes' theorem. posterior distribution \\(\\theta\\) also Beta distribution: $$\\theta | y \\sim \\text{Beta}(\\alpha_0 + y, \\beta_0 + n - y)$$ Pathogen incidence, representing proportion infections caused different pathogens, modelled using Dirichlet distribution, natural conjugate prior multinomial outcomes. Dirichlet distribution parameterised vector concentration parameters \\(\\alpha\\), \\(\\alpha_i\\) corresponds specific pathogen. prior typically chosen uniform (\\(\\alpha_i = 1\\)), reflecting assumption equal prior probability across pathogens. posterior distribution pathogen incidence given : $$\\text{Dirichlet}(\\alpha_1 + n_1, \\alpha_2 + n_2, \\dots, \\alpha_K + n_K)$$ \\(n_i\\) number infections caused pathogen \\(\\) observed data. practical implementation, pathogen incidences sampled posterior using normalised Gamma-distributed random variables: $$x_i \\sim \\text{Gamma}(\\alpha_i + n_i, 1)$$ $$p_i = \\frac{x_i}{\\sum_{j=1}^K x_j}$$ \\(x_i\\) represents unnormalised pathogen counts, \\(p_i\\) normalised proportion pathogen \\(\\). hierarchical modelling, pathogen-level effects (e.g., differences resistance patterns) regimen-level effects modelled using Gaussian priors log-odds. hierarchical structure ensures partial pooling estimates across groups, improving stability strata small sample sizes. model implemented using Hamiltonian Monte Carlo (HMC) sampling. Stratified results can provided based covariates age, sex, clinical complexity (e.g., prior antimicrobial treatments renal/urological comorbidities) using dplyr's group_by() pre-processing step running wisca(). Posterior odds ratios (ORs) derived quantify effect covariates coverage probabilities: $$\\text{}_{\\text{covariate}} = \\frac{\\exp(\\beta_{\\text{covariate}})}{\\exp(\\beta_0)}$$ combining empirical data prior knowledge, WISCA overcomes limitations traditional combination antibiograms, offering disease-specific, patient-stratified estimates robust uncertainty quantification. tool invaluable antimicrobial stewardship programs empirical treatment guideline refinement. Note: WISCA never gives output pathogen/species level, incidences susceptibilities already weighted species.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Implementation: Dr. Larisse Bolton Dr. Matthijs Berends","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ # Traditional antibiogram ----------------------------------------------  antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()) ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram (non-WISCA / 95% CI): 10 × 7 #>    Pathogen       Amikacin    Gentamicin Imipenem Kanamycin Meropenem Tobramycin #>    <chr>          <chr>       <chr>      <chr>    <chr>     <chr>     <chr>      #>  1 CoNS           0% (0-8%,N… 86% (82-9… 52% (37… 0% (0-8%… 52% (37-… 22% (12-3… #>  2 E. coli        100% (98-1… 98% (96-9… 100% (9… NA        100% (99… 97% (96-9… #>  3 E. faecalis    0% (0-9%,N… 0% (0-9%,… 100% (9… 0% (0-9%… NA        0% (0-9%,… #>  4 K. pneumoniae  NA          90% (79-9… 100% (9… NA        100% (93… 90% (79-9… #>  5 P. aeruginosa  NA          100% (88-… NA       0% (0-12… NA        100% (88-… #>  6 P. mirabilis   NA          94% (80-9… 94% (79… NA        NA        94% (80-9… #>  7 S. aureus      NA          99% (97-1… NA       NA        NA        98% (92-1… #>  8 S. epidermidis 0% (0-8%,N… 79% (71-8… NA       0% (0-8%… NA        51% (40-6… #>  9 S. hominis     NA          92% (84-9… NA       NA        NA        85% (74-9… #> 10 S. pneumoniae  0% (0-3%,N… 0% (0-3%,… NA       0% (0-3%… NA        0% (0-3%,… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = aminoglycosides(),   ab_transform = \"atc\",   mo_transform = \"gramstain\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 5 #>   Pathogen      J01GB01            J01GB03             J01GB04         J01GB06   #>   <chr>         <chr>              <chr>               <chr>           <chr>     #> 1 Gram-negative 96% (94-97%,N=686) 96% (95-98%,N=684)  0% (0-10%,N=35) 98% (96-… #> 2 Gram-positive 34% (31-38%,N=665) 63% (60-66%,N=1170) 0% (0-1%,N=436) 0% (0-1%… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = carbapenems(),   ab_transform = \"name\",   mo_transform = \"name\" ) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram (non-WISCA / 95% CI): 5 × 3 #>   Pathogen                                 Imipenem             Meropenem        #>   <chr>                                    <chr>                <chr>            #> 1 Coagulase-negative Staphylococcus (CoNS) 52% (37-67%,N=48)    52% (37-67%,N=4… #> 2 Enterococcus faecalis                    100% (91-100%,N=38)  NA               #> 3 Escherichia coli                         100% (99-100%,N=422) 100% (99-100%,N… #> 4 Klebsiella pneumoniae                    100% (93-100%,N=51)  100% (93-100%,N… #> 5 Proteus mirabilis                        94% (79-99%,N=32)    NA               #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Combined antibiogram -------------------------------------------------  # combined antimicrobials yield higher empiric coverage antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   mo_transform = \"gramstain\" ) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 4 #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # you can use any antimicrobial selector with `+` too: antibiogram(example_isolates,   antimicrobials = ureidopenicillins() + c(\"\", \"GEN\", \"tobra\"),   mo_transform = \"gramstain\" ) #> ℹ For ureidopenicillins() using column 'TZP' (piperacillin/tazobactam) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 4 #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # names of antimicrobials do not need to resemble columns exactly: antibiogram(example_isolates,   antimicrobials = c(\"Cipro\", \"cipro + genta\"),   mo_transform = \"gramstain\",   ab_transform = \"name\",   sep = \" & \" ) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 3 #>   Pathogen      Ciprofloxacin      `Ciprofloxacin & Gentamicin` #>   <chr>         <chr>              <chr>                        #> 1 Gram-negative 91% (88-93%,N=684) 99% (97-99%,N=694)           #> 2 Gram-positive 77% (74-80%,N=724) 93% (91-94%,N=847)           #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Syndromic antibiogram ------------------------------------------------  # the data set could contain a filter for e.g. respiratory specimens antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()),   syndromic_group = \"ward\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram (non-WISCA / 95% CI): 14 × 8 #>    `Syndromic Group` Pathogen   Amikacin Gentamicin Imipenem Kanamycin Meropenem #>    <chr>             <chr>      <chr>    <chr>      <chr>    <chr>     <chr>     #>  1 Clinical          CoNS       NA       89% (84-9… 57% (39… NA        57% (39-… #>  2 ICU               CoNS       NA       79% (68-8… NA       NA        NA        #>  3 Outpatient        CoNS       NA       84% (66-9… NA       NA        NA        #>  4 Clinical          E. coli    100% (9… 98% (96-9… 100% (9… NA        100% (99… #>  5 ICU               E. coli    100% (9… 99% (95-1… 100% (9… NA        100% (97… #>  6 Clinical          K. pneumo… NA       92% (81-9… 100% (9… NA        100% (92… #>  7 Clinical          P. mirabi… NA       100% (88-… NA       NA        NA        #>  8 Clinical          S. aureus  NA       99% (95-1… NA       NA        NA        #>  9 ICU               S. aureus  NA       100% (95-… NA       NA        NA        #> 10 Clinical          S. epider… NA       82% (72-9… NA       NA        NA        #> 11 ICU               S. epider… NA       72% (60-8… NA       NA        NA        #> 12 Clinical          S. hominis NA       96% (85-9… NA       NA        NA        #> 13 Clinical          S. pneumo… 0% (0-5… 0% (0-5%,… NA       0% (0-5%… NA        #> 14 ICU               S. pneumo… 0% (0-1… 0% (0-12%… NA       0% (0-12… NA        #> # ℹ 1 more variable: Tobramycin <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # now define a data set with only E. coli ex1 <- example_isolates[which(mo_genus() == \"Escherichia\"), ] #> ℹ Using column 'mo' as input for mo_genus()  # with a custom language, though this will be determined automatically # (i.e., this table will be in Spanish on Spanish systems) antibiogram(ex1,   antimicrobials = aminoglycosides(),   ab_transform = \"name\",   syndromic_group = ifelse(ex1$ward == \"ICU\",     \"UCI\", \"No UCI\"   ),   language = \"es\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 5 #>   `Grupo sindrómico` Patógeno Amikacina            Gentamicina       Tobramicina #>   <chr>              <chr>    <chr>                <chr>             <chr>       #> 1 No UCI             E. coli  100% (97-100%,N=119) 98% (96-99%,N=32… 98% (96-99… #> 2 UCI                E. coli  100% (93-100%,N=52)  99% (95-100%,N=1… 96% (92-99… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # WISCA antibiogram ----------------------------------------------------  # WISCA are not stratified by species, but rather on syndromes antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   syndromic_group = \"ward\",   wisca = TRUE ) #> # An Antibiogram (WISCA / 95% CI): 3 × 4 #>   `Syndromic Group` `Piperacillin/tazobactam` Piperacillin/tazobactam + Gentam…¹ #>   <chr>             <chr>                     <chr>                              #> 1 Clinical          73.8% (53.8-89.1%)        93% (80.7-99.1%)                   #> 2 ICU               57.6% (31.5-85.2%)        85.5% (64-98.1%)                   #> 3 Outpatient        58.2% (18.1-94.1%)        77.6% (41.8-99.1%)                 #> # ℹ abbreviated name: ¹​`Piperacillin/tazobactam + Gentamicin` #> # ℹ 1 more variable: `Piperacillin/tazobactam + Tobramycin` <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Print the output for R Markdown / Quarto -----------------------------  ureido <- antibiogram(example_isolates,   antimicrobials = ureidopenicillins(),   syndromic_group = \"ward\",   wisca = TRUE ) #> ℹ For ureidopenicillins() using column 'TZP' (piperacillin/tazobactam)  # in an Rmd file, you would just need to return `ureido` in a chunk, # but to be explicit here: if (requireNamespace(\"knitr\")) {   cat(knitr::knit_print(ureido)) } #>  #>  #> |Syndromic Group |Piperacillin/tazobactam | #> |:---------------|:-----------------------| #> |Clinical        |73% (53.9-89.6%)        | #> |ICU             |56.9% (30.3-84.6%)      | #> |Outpatient      |57.3% (19-94.4%)        |   # Generate plots with ggplot2 or base R --------------------------------  ab1 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\" ) ab2 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\",   syndromic_group = \"ward\" )  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab1) }  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab2) }   plot(ab1)  plot(ab2)  # }"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":null,"dir":"Reference","previous_headings":"","what":"Antimicrobial Selectors — antimicrobial_selectors","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions allow filtering rows selecting columns based antimicrobial test results specific antimicrobial class group, without need define columns antimicrobial abbreviations. can used base R, tidyverse, tidymodels, data.table. short, column name resembles antimicrobial drug, picked functions matches pharmaceutical class: \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" picked using:","code":"library(dplyr) my_data_with_all_these_columns %>%   select(cephalosporins())"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"aminoglycosides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  aminopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  antifungals(only_sir_columns = FALSE, return_all = TRUE, ...)  antimycobacterials(only_sir_columns = FALSE, return_all = TRUE, ...)  betalactams(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  betalactams_with_inhibitor(only_sir_columns = FALSE, return_all = TRUE,   ...)  carbapenems(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_1st(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_2nd(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_3rd(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_4th(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_5th(only_sir_columns = FALSE, return_all = TRUE, ...)  fluoroquinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  glycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  isoxazolylpenicillins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lincosamides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lipoglycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  macrolides(only_sir_columns = FALSE, return_all = TRUE, ...)  monobactams(only_sir_columns = FALSE, return_all = TRUE, ...)  nitrofurans(only_sir_columns = FALSE, return_all = TRUE, ...)  oxazolidinones(only_sir_columns = FALSE, return_all = TRUE, ...)  penicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  phenicols(only_sir_columns = FALSE, return_all = TRUE, ...)  polymyxins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  quinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  rifamycins(only_sir_columns = FALSE, return_all = TRUE, ...)  streptogramins(only_sir_columns = FALSE, return_all = TRUE, ...)  sulfonamides(only_sir_columns = FALSE, return_all = TRUE, ...)  tetracyclines(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  trimethoprims(only_sir_columns = FALSE, return_all = TRUE, ...)  ureidopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  amr_class(amr_class, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  amr_selector(filter, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  administrable_per_os(only_sir_columns = FALSE, return_all = TRUE, ...)  administrable_iv(only_sir_columns = FALSE, return_all = TRUE, ...)  not_intrinsic_resistant(only_sir_columns = FALSE, col_mo = NULL,   version_expected_phenotypes = 1.2, ...)"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"only_sir_columns logical indicate whether columns class sir must selected (default FALSE), see .sir(). only_treatable logical indicate whether antimicrobial drugs excluded laboratory tests (default TRUE), gentamicin-high (GEH) imipenem/EDTA (IPE). return_all logical indicate whether matched columns must returned (default TRUE). FALSE, first unique antimicrobial returned, e.g. columns \"genta\" \"gentamicin\" exist data, first hit gentamicin returned. ... Ignored, place allow future extensions. amr_class antimicrobial class part , \"carba\" \"carbapenems\". columns group, atc_group1 atc_group2 antimicrobials data set searched (case-insensitive) value. filter expression evaluated antimicrobials data set, name %like% \"trim\". col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\".","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"used inside selecting filtering, returns character vector column names, additional class \"amr_selector\". used individually, returns 'ab' vector possible antimicrobials function able select filter.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions can used data set calls selecting columns filtering rows. work base R, Tidyverse, data.table. heavily inspired Tidyverse selection helpers everything(), limited dplyr verbs. Nonetheless, convenient use dplyr functions select(), filter() summarise(), see Examples. selectors can also used tidymodels packages recipe parsnip. See info tutorial using antimicrobial selectors predictive modelling. columns data functions called searched known antimicrobial names, abbreviations, brand names, codes (ATC, EARS-Net, , etc.) according antimicrobials data set. means selector aminoglycosides() pick column names like 'gen', 'genta', 'J01GB03', 'tobra', 'Tobracin', etc. amr_class() function can used filter/select manually defined antimicrobial class. searches results antimicrobials data set within columns group, atc_group1 atc_group2. administrable_per_os() administrable_iv() functions also rely antimicrobials data set - antimicrobials matched DDD (defined daily dose) resp. oral IV treatment available antimicrobials data set. amr_selector() function can used internally filter antimicrobials data set results, see Examples. allows filtering (part ) certain name, /group name even minimum DDDs oral treatment. function yields highest flexibility, also least user-friendly, since requires hard-coded filter set. not_intrinsic_resistant() function can used select antimicrobials pose intrinsic resistance microorganisms data set. example, data set contains microorganism codes names E. coli K. pneumoniae contains column \"vancomycin\", column removed (rather, unselected) using function. currently applies 'EUCAST Expected Resistant Phenotypes' v1.2 (2023) determine intrinsic resistance, using eucast_rules() function internally. determination, function quite slow terms performance.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"full-list-of-supported-antimicrobial-classes","dir":"Reference","previous_headings":"","what":"Full list of supported (antimicrobial) classes","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"aminoglycosides() can select:  amikacin (AMK), amikacin/fosfomycin (AKF), apramycin (APR), arbekacin (ARB), astromicin (AST), bekanamycin (BEK), dibekacin (DKB), framycetin (FRM), gentamicin (GEN), gentamicin-high (GEH), habekacin (HAB), hygromycin (HYG), isepamicin (ISE), kanamycin (KAN), kanamycin-high (KAH), kanamycin/cephalexin (KAC), micronomicin (MCR), neomycin (NEO), netilmicin (NET), pentisomicin (PIM), plazomicin (PLZ), propikacin (PKA), ribostamycin (RST), sisomicin (SIS), streptoduocin (STR), streptomycin (STR1), streptomycin-high (STH), tobramycin (TOB), tobramycin-high (TOH) aminopenicillins() can select:  amoxicillin (AMX) ampicillin (AMP) antifungals() can select:  amorolfine (AMO), amphotericin B (AMB), amphotericin B-high (AMH), anidulafungin (ANI), butoconazole (), caspofungin (CAS), ciclopirox (CIX), clotrimazole (CTR), econazole (ECO), fluconazole (FLU), flucytosine (FCT), fosfluconazole (FFL), griseofulvin (GRI), hachimycin (HCH), ibrexafungerp (IBX), isavuconazole (ISV), isoconazole (ISO), itraconazole (ITR), ketoconazole (KET), manogepix (MGX), micafungin (MIF), miconazole (MCZ), nystatin (NYS), oteseconazole (OTE), pimaricin (PMR), posaconazole (POS), rezafungin (RZF), ribociclib (RBC), sulconazole (SUC), terbinafine (TRB), terconazole (TRC), voriconazole (VOR) antimycobacterials() can select:  4-aminosalicylic acid (AMA), calcium aminosalicylate (CLA), capreomycin (CAP), clofazimine (CLF), delamanid (DLM), enviomycin (ENV), ethambutol (ETH), ethambutol/isoniazid (ETI), ethionamide (ETI1), isoniazid (INH), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), morinamide (MRN), p-aminosalicylic acid (PAS), pretomanid (PMD), protionamide (PTH), pyrazinamide (PZA), rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP), simvastatin/fenofibrate (SMF), sodium aminosalicylate (SDA), streptomycin/isoniazid (STI), terizidone (TRZ), thioacetazone (TAT), thioacetazone/isoniazid (THI1), tiocarlide (TCR), viomycin (VIO) betalactams() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), biapenem (BIA), carbenicillin (CRB), carindacillin (CRN), carumonam (CAR), cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), doripenem (DOR), epicillin (EPC), ertapenem (ETP), flucloxacillin (FLC), hetacillin (HET), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), latamoxef (LTM), lenampicillin (LEN), loracarbef (LOR), mecillinam (MEC), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), panipenem (PAN), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tebipenem (TBP), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC), tigemonam (TMN) betalactams_with_inhibitor() can select:  amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin/sulbactam (SAM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefoperazone/sulbactam (CSL), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefpodoxime/clavulanic acid (CDC), ceftaroline/avibactam (CPA), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), ceftolozane/tazobactam (CZT), ceftriaxone/beta-lactamase inhibitor (CEB), imipenem/relebactam (IMR), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), mezlocillin/sulbactam (MSU), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), ticarcillin/clavulanic acid (TCC) carbapenems() can select:  biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP) cephalosporins() can select:  cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), latamoxef (LTM), loracarbef (LOR) cephalosporins_1st() can select:  cefacetrile (CAC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefroxadine (CRD), ceftezole (CTL), cephradine (CED) cephalosporins_2nd() can select:  cefaclor (CEC), cefamandole (MAN), cefmetazole (CMZ), cefonicid (CID), ceforanide (CND), cefotetan (CTT), cefotiam (CTF), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefprozil (CPR), cefuroxime (CXM), cefuroxime axetil (CXA), loracarbef (LOR) cephalosporins_3rd() can select:  cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefetamet (CAT), cefetamet pivoxil (CPI), cefixime (CFM), cefmenoxime (CMX), cefodizime (DIZ), cefoperazone (CFP), cefoperazone/sulbactam (CSL), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotiam hexetil (CHE), cefovecin (FOV), cefpimizole (CFZ), cefpiramide (CPM), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefsulodin (CFS), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), latamoxef (LTM) cephalosporins_4th() can select:  cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetecol (CCL), cefoselis (CSE), cefozopran (ZOP), cefpirome (CPO), cefquinome (CEQ) cephalosporins_5th() can select:  ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT) fluoroquinolones() can select:  besifloxacin (BES), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) glycopeptides() can select:  avoparcin (AVO), bleomycin (BLM), dalbavancin (DAL), norvancomycin (NVA), oritavancin (ORI), ramoplanin (RAM), teicoplanin (TEC), teicoplanin-macromethod (TCM), telavancin (TLV), vancomycin (VAN), vancomycin-macromethod (VAM) isoxazolylpenicillins() can select:  cloxacillin (CLO), dicloxacillin (DIC), flucloxacillin (FLC), meticillin (MET), oxacillin (OXA), oxacillin screening test (OXA-S) lincosamides() can select:  clindamycin (CLI), lincomycin (LIN), pirlimycin (PRL) lipoglycopeptides() can select:  dalbavancin (DAL), oritavancin (ORI), telavancin (TLV) macrolides() can select:  acetylmidecamycin (ACM), acetylspiramycin (ASP), azithromycin (AZM), clarithromycin (CLR), dirithromycin (DIR), erythromycin (ERY), flurithromycin (FLR1), gamithromycin (GAM), josamycin (JOS), kitasamycin (KIT), meleumycin (MEL), midecamycin (MID), miocamycin (MCM), nafithromycin (ZWK), oleandomycin (OLE), rokitamycin (ROK), roxithromycin (RXT), solithromycin (SOL), spiramycin (SPI), telithromycin (TLT), tildipirosin (TIP), tilmicosin (TIL), troleandomycin (TRL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) monobactams() can select:  aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), carumonam (CAR), tigemonam (TMN) nitrofurans() can select:  furazidin (FUR), furazolidone (FRZ), nifurtoinol (NFR), nitrofurantoin (NIT), nitrofurazone (NIZ) oxazolidinones() can select:  cadazolid (CDZ), cycloserine (CYC), linezolid (LNZ), tedizolid (TZD), thiacetazone (THA) penicillins() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), carbenicillin (CRB), carindacillin (CRN), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), epicillin (EPC), flucloxacillin (FLC), hetacillin (HET), lenampicillin (LEN), mecillinam (MEC), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC) phenicols() can select:  chloramphenicol (CHL), florfenicol (FLR), thiamphenicol (THI) polymyxins() can select:  colistin (COL), polymyxin B (PLB), polymyxin B/polysorbate 80 (POP) quinolones() can select:  besifloxacin (BES), cinoxacin (CIN), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), flumequine (FLM), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nalidixic acid (NAL), nalidixic acid screening test (NAL-S), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), oxolinic acid (OXO), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pipemidic acid (PPA), piromidic acid (PIR), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rosoxacin (ROS), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) rifamycins() can select:  rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP) streptogramins() can select:  pristinamycin (PRI) quinupristin/dalfopristin (QDA) sulfonamides() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfamoxole (SLF8), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13) tetracyclines() can select:  cetocycline (CTO), chlortetracycline (CTE), clomocycline (CLM1), demeclocycline (DEM), doxycycline (DOX), eravacycline (ERV), lymecycline (LYM), metacycline (MTC), minocycline (MNO), omadacycline (OMC), oxytetracycline (OXY), penimepicycline (PNM1), rolitetracycline (RLT), sarecycline (SRC), tetracycline (TCY), tetracycline screening test (TCY-S), tigecycline (TGC) trimethoprims() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadiazine/trimethoprim (SLT1), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfadimidine/trimethoprim (SLT2), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamerazine/trimethoprim (SLT3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfametrole/trimethoprim (SLT4), sulfamoxole (SLF8), sulfamoxole/trimethoprim (SLT5), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13), trimethoprim (TMP), trimethoprim/sulfamethoxazole (SXT) ureidopenicillins() can select:  azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # you can use the selectors separately to retrieve all possible antimicrobials: carbapenems() #> ℹ in carbapenems(): Imipenem/EDTA (IPE) and meropenem/nacubactam #>   (MNC) are not included since only_treatable = TRUE. #> ℹ This 'ab' vector was retrieved using carbapenems(), which should #>   normally be used inside a dplyr verb or data.frame call, e.g.: #>   • your_data %>% select(carbapenems()) #>   • your_data %>% select(column_a, column_b, carbapenems()) #>   • your_data %>% filter(any(carbapenems() == \"R\")) #>   • your_data[, carbapenems()] #>   • your_data[, c(\"column_a\", \"column_b\", carbapenems())] #> Class 'ab' #>  [1] BIA DOR ETP IMR IPM MEM MEV PAN RIA RIT RZM TBP   # Though they are primarily intended to use for selections and filters. # Examples sections below are split into 'dplyr', 'base R', and 'data.table':  # \\donttest{ if (FALSE) { # \\dontrun{ # dplyr -------------------------------------------------------------------  library(dplyr, warn.conflicts = FALSE)  example_isolates %>% select(carbapenems())  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates %>% select(mo, aminoglycosides())  # you can combine selectors like you are used with tidyverse # e.g., for betalactams, but not the ones with an enzyme inhibitor: example_isolates %>% select(betalactams(), -betalactams_with_inhibitor())  # select only antimicrobials with DDDs for oral treatment example_isolates %>% select(administrable_per_os())  # get AMR for all aminoglycosides e.g., per ward: example_isolates %>%   group_by(ward) %>%   summarise(across(aminoglycosides(),                    resistance))  # You can combine selectors with '&' to be more specific: example_isolates %>%   select(penicillins() & administrable_per_os())  # get AMR for only drugs that matter - no intrinsic resistance: example_isolates %>%   filter(mo_genus() %in% c(\"Escherichia\", \"Klebsiella\")) %>%   group_by(ward) %>%   summarise_at(not_intrinsic_resistant(),                resistance)  # get susceptibility for antimicrobials whose name contains \"trim\": example_isolates %>%   filter(first_isolate()) %>%   group_by(ward) %>%   summarise(across(amr_selector(name %like% \"trim\"), susceptibility))  # this will select columns 'IPM' (imipenem) and 'MEM' (meropenem): example_isolates %>%   select(carbapenems())  # this will select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB': example_isolates %>%   select(mo, aminoglycosides())  # any() and all() work in dplyr's filter() too: example_isolates %>%   filter(     any(aminoglycosides() == \"R\"),     all(cephalosporins_2nd() == \"R\")   )  # also works with c(): example_isolates %>%   filter(any(c(carbapenems(), aminoglycosides()) == \"R\"))  # not setting any/all will automatically apply all(): example_isolates %>%   filter(aminoglycosides() == \"R\")  # this will select columns 'mo' and all antimycobacterial drugs ('RIF'): example_isolates %>%   select(mo, amr_class(\"mycobact\"))  # get bug/drug combinations for only glycopeptides in Gram-positives: example_isolates %>%   filter(mo_is_gram_positive()) %>%   select(mo, glycopeptides()) %>%   bug_drug_combinations() %>%   format()  data.frame(   some_column = \"some_value\",   J01CA01 = \"S\" ) %>% # ATC code of ampicillin   select(penicillins()) # only the 'J01CA01' column will be selected  # with recent versions of dplyr, this is all equal: x <- example_isolates[carbapenems() == \"R\", ] y <- example_isolates %>% filter(carbapenems() == \"R\") z <- example_isolates %>% filter(if_all(carbapenems(), ~ .x == \"R\")) identical(x, y) && identical(y, z)  } # } # base R ------------------------------------------------------------------  # select columns 'IPM' (imipenem) and 'MEM' (meropenem) example_isolates[, carbapenems()] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 2,000 × 2 #>    IPM   MEM   #>    <sir> <sir> #>  1   NA    NA  #>  2   NA    NA  #>  3   NA    NA  #>  4   NA    NA  #>  5   NA    NA  #>  6   NA    NA  #>  7   NA    NA  #>  8   NA    NA  #>  9   NA    NA  #> 10   NA    NA  #> # ℹ 1,990 more rows  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates[, c(\"mo\", aminoglycosides())] #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 2,000 × 5 #>    mo           GEN   TOB   AMK   KAN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   NA    NA    NA    NA  #>  2 B_ESCHR_COLI   NA    NA    NA    NA  #>  3 B_STPHY_EPDR   NA    NA    NA    NA  #>  4 B_STPHY_EPDR   NA    NA    NA    NA  #>  5 B_STPHY_EPDR   NA    NA    NA    NA  #>  6 B_STPHY_EPDR   NA    NA    NA    NA  #>  7 B_STPHY_AURS   NA    S     NA    NA  #>  8 B_STPHY_AURS   NA    S     NA    NA  #>  9 B_STPHY_EPDR   NA    NA    NA    NA  #> 10 B_STPHY_EPDR   NA    NA    NA    NA  #> # ℹ 1,990 more rows  # select only antimicrobials with DDDs for oral treatment example_isolates[, administrable_per_os()] #> ℹ For administrable_per_os() using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 23 #>    OXA   FLC   AMX   AMC   AMP   CXM   KAN   TMP   NIT   FOS   LNZ   CIP   MFX   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  2   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  3   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  4   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  5   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  6   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  7   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  8   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  9   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    S     NA  #> 10   NA    S     NA    NA    NA    S     NA    S     NA    NA    NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 10 more variables: VAN <sir>, TCY <sir>, DOX <sir>, ERY <sir>, CLI <sir>, #> #   AZM <sir>, MTR <sir>, CHL <sir>, COL <sir>, RIF <sir>  # filter using any() or all() example_isolates[any(carbapenems() == \"R\"), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … subset(example_isolates, any(carbapenems() == \"R\")) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter on any or all results in the carbapenem columns (i.e., IPM, MEM): example_isolates[any(carbapenems()), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering any of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 962 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  7 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  8 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  9 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #> 10 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #> # ℹ 952 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … example_isolates[all(carbapenems()), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering all of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 756 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-04-14 F30196     73 M      Outpat… B_STRPT_GRPB    S     NA    S     S   #>  2 2003-04-08 114570     74 M      ICU     B_STRPT_PYGN    S     NA    S     S   #>  3 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  4 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  5 2003-08-14 F71508      0 F      Clinic… B_STRPT_GRPB    S     NA    S     S   #>  6 2003-10-16 650870     63 F      ICU     B_ESCHR_COLI    R     NA    NA    R   #>  7 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  9 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> 10 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> # ℹ 746 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter with multiple antimicrobial selectors using c() example_isolates[all(c(carbapenems(), aminoglycosides()) == \"R\"), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 26 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  2 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  4 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  5 2008-12-06 501361     43 F      Clinical B_STNTR_MLTP   R     NA    NA    R   #>  6 2011-05-09 207325     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2012-03-12 582258     80 M      ICU      B_STPHY_CONS   R     R     R     R   #>  8 2012-05-19 C25552     89 F      Outpati… B_STPHY_CONS   R     R     R     R   #>  9 2012-07-17 F05015     83 M      ICU      B_STPHY_CONS   R     R     R     R   #> 10 2012-07-20 404299     66 F      Clinical B_STPHY_CONS   R     R     R     R   #> # ℹ 16 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter + select in one go: get penicillins in carbapenem-resistant strains example_isolates[any(carbapenems() == \"R\"), penicillins()] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For penicillins() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> # A tibble: 55 × 7 #>    PEN   OXA   FLC   AMX   AMC   AMP   TZP   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    NA    NA    NA    NA  #>  2   NA    NA    NA    NA    NA    NA    NA  #>  3   R     NA    NA    R     R     R     R   #>  4   NA    NA    NA    NA    NA    NA    R   #>  5   NA    NA    NA    NA    NA    NA    R   #>  6   NA    NA    NA    NA    NA    NA    R   #>  7   NA    NA    NA    NA    NA    NA    R   #>  8   NA    NA    NA    NA    NA    NA    R   #>  9   R     NA    NA    NA    S     NA    S   #> 10   R     NA    NA    NA    S     NA    S   #> # ℹ 45 more rows  # You can combine selectors with '&' to be more specific. For example, # penicillins() would select benzylpenicillin ('peni G') and # administrable_per_os() would select erythromycin. Yet, when combined these # drugs are both omitted since benzylpenicillin is not administrable per os # and erythromycin is not a penicillin: example_isolates[, penicillins() & administrable_per_os()] #> ℹ For penicillins() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> ℹ For administrable_per_os() using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 5 #>    OXA   FLC   AMX   AMC   AMP   #>    <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA  #>  2   NA    NA    NA    I     NA  #>  3   NA    R     NA    NA    NA  #>  4   NA    R     NA    NA    NA  #>  5   NA    R     NA    NA    NA  #>  6   NA    R     NA    NA    NA  #>  7   NA    S     R     S     R   #>  8   NA    S     R     S     R   #>  9   NA    R     NA    NA    NA  #> 10   NA    S     NA    NA    NA  #> # ℹ 1,990 more rows  # amr_selector() applies a filter in the `antimicrobials` data set and is thus # very flexible. For instance, to select antimicrobials with an oral DDD # of at least 1 gram: example_isolates[, amr_selector(oral_ddd > 1 & oral_units == \"g\")] #> ℹ For amr_selector(oral_ddd > 1 & oral_units == \"g\") using columns 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'KAN' (kanamycin), 'FOS' #>   (fosfomycin), 'LNZ' (linezolid), 'VAN' (vancomycin), 'ERY' (erythromycin), #>   'CLI' (clindamycin), 'MTR' (metronidazole), and 'CHL' (chloramphenicol) #> # A tibble: 2,000 × 13 #>    OXA   FLC   AMX   AMC   AMP   KAN   FOS   LNZ   VAN   ERY   CLI   MTR   CHL   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  2   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  3   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  4   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  5   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  6   NA    R     NA    NA    NA    NA    NA    NA    S     R     R     NA    NA  #>  7   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  8   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  9   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #> 10   NA    S     NA    NA    NA    NA    NA    NA    S     S     NA    NA    NA  #> # ℹ 1,990 more rows   # data.table --------------------------------------------------------------  # data.table is supported as well, just use it in the same way as with # base R, but add `with = FALSE` if using a single AB selector.  if (require(\"data.table\")) {   dt <- as.data.table(example_isolates)    # this does not work, it returns column *names*   dt[, carbapenems()] } #> Loading required package: data.table #>  #> Attaching package: ‘data.table’ #> The following objects are masked from ‘package:dplyr’: #>  #>     between, first, last #> The following objects are masked from ‘package:AMR’: #>  #>     %like%, like #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: It should never be needed to print an antimicrobial selector class. Are you #> using data.table? Then add the argument with = FALSE, see our examples at #> ?amr_selector. #> Class 'amr_selector' #> [1] IPM MEM if (require(\"data.table\")) {   # so `with = FALSE` is required   dt[, carbapenems(), with = FALSE] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>         IPM   MEM #>       <sir> <sir> #>    1:  <NA>  <NA> #>    2:  <NA>  <NA> #>    3:  <NA>  <NA> #>    4:  <NA>  <NA> #>    5:  <NA>  <NA> #>   ---             #> 1996:  <NA>  <NA> #> 1997:     S     S #> 1998:     S     S #> 1999:     S     S #> 2000:     S     S  # for multiple selections or AB selectors, `with = FALSE` is not needed: if (require(\"data.table\")) {   dt[, c(\"mo\", aminoglycosides())] } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>                 mo   GEN   TOB   AMK   KAN #>               <mo> <sir> <sir> <sir> <sir> #>    1: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    2: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    3: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    4: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    5: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>   ---                                      #> 1996: B_STRPT_PNMN     R     R     R     R #> 1997: B_ESCHR_COLI     S     S     S  <NA> #> 1998: B_STPHY_CONS     S  <NA>  <NA>  <NA> #> 1999: B_ESCHR_COLI     S     S  <NA>  <NA> #> 2000: B_KLBSL_PNMN     S     S  <NA>  <NA> if (require(\"data.table\")) {   dt[, c(carbapenems(), aminoglycosides())] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>         IPM   MEM   GEN   TOB   AMK   KAN #>       <sir> <sir> <sir> <sir> <sir> <sir> #>    1:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    2:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    3:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    4:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    5:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>   ---                                     #> 1996:  <NA>  <NA>     R     R     R     R #> 1997:     S     S     S     S     S  <NA> #> 1998:     S     S     S  <NA>  <NA>  <NA> #> 1999:     S     S     S     S  <NA>  <NA> #> 2000:     S     S     S     S  <NA>  <NA>  # row filters are also supported: if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), ] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>            date patient   age gender       ward           mo   PEN   OXA   FLC #>          <Date>  <char> <num> <char>     <char>         <mo> <sir> <sir> <sir> #>   1: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   2: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   3: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   4: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   5: 2002-02-05  067927    45      F        ICU B_SERRT_MRCS     R  <NA>  <NA> #>  ---                                                                           #> 905: 2005-04-12  D71461    70      M        ICU B_ESCHR_COLI     R  <NA>  <NA> #> 906: 2009-11-12  650870    69      F Outpatient B_ESCHR_COLI     R  <NA>  <NA> #> 907: 2012-06-14  8CBCF2    41      F   Clinical B_STPHY_CONS     R     S     S #> 908: 2012-10-11  175532    78      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #> 909: 2013-11-23  A97263    77      M   Clinical B_KLBSL_PNMN     R  <NA>  <NA> #>        AMX   AMC   AMP   TZP   CZO   FEP   CXM   FOX   CTX   CAZ   CRO   GEN #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   2:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   3:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   4:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   5:     R     R     R  <NA>     R  <NA>     R     R  <NA>  <NA>  <NA>  <NA> #>  ---                                                                         #> 905:     S     S     S     S  <NA>     S     S     S     S     S     S     S #> 906:     S     S     S     S     S     S     S     S     S     S     S     S #> 907:  <NA>     S  <NA>  <NA>     S     S     S     S     S     R     S     S #> 908:     R     S     R     S  <NA>     S     R     R     S     S     S     S #> 909:     R     S     R     S  <NA>     S     S     S     S     S     S     S #>        TOB   AMK   KAN   TMP   SXT   NIT   FOS   LNZ   CIP   MFX   VAN   TEC #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   2:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   3:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   4:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   5:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>  ---                                                                         #> 905:     S     S  <NA>  <NA>     S     S  <NA>     R     S  <NA>     R     R #> 906:     S     S  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #> 907:  <NA>  <NA>  <NA>     S     S  <NA>  <NA>  <NA>     S  <NA>     S  <NA> #> 908:     S  <NA>  <NA>     R     R     R  <NA>     R     R     R     R     R #> 909:     S  <NA>  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #>        TCY   TGC   DOX   ERY   CLI   AZM   IPM   MEM   MTR   CHL   COL   MUP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   2:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   3:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   4:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   5:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>  ---                                                                         #> 905:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 906:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 907:  <NA>  <NA>  <NA>     S     S     S     S     S  <NA>  <NA>     R  <NA> #> 908:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #> 909:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #>        RIF #>      <sir> #>   1:     R #>   2:     R #>   3:     R #>   4:     R #>   5:     R #>  ---       #> 905:     R #> 906:     R #> 907:  <NA> #> 908:     R #> 909:     R if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), penicillins(), with = FALSE] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For penicillins() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #>        PEN   OXA   FLC   AMX   AMC   AMP   TZP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   2:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   3:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   4:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   5:     R  <NA>  <NA>     R     R     R  <NA> #>  ---                                           #> 905:     R  <NA>  <NA>     S     S     S     S #> 906:     R  <NA>  <NA>     S     S     S     S #> 907:     R     S     S  <NA>     S  <NA>  <NA> #> 908:     R  <NA>  <NA>     R     S     R     S #> 909:     R  <NA>  <NA>     R     S     R     S # }"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Two data sets containing antimicrobials antivirals. Use .ab() one ab_* functions retrieve values antimicrobials data set. Three identifiers included data set: antimicrobial ID (ab, primarily used package) defined WHONET/EARS-Net, ATC code (atc) defined , Compound ID (cid) found PubChem. properties data set derived one codes. Note drugs multiple ATC codes.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials  antivirals"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"object class tbl_df (inherits tbl, data.frame) 120 rows 11 columns.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antimicrobials-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antimicrobials data set: a tibble with 497 observations and 14 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"ab antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. cid Compound ID found PubChem. unique identifier. name Official name used WHONET/EARS-Net . unique identifier. group short concise group name, based WHONET WHOCC definitions atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, like J01CR02 atc_group1 Official pharmacological subgroup (3rd level ATC code) defined WHOCC, like \"Macrolides, lincosamides streptogramins\" atc_group2 Official chemical subgroup (4th level ATC code) defined WHOCC, like \"Macrolides\" abbr List abbreviations used many countries, also antimicrobial susceptibility testing (AST) synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 179 drugs oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral (intravenous) treatment, currently available 153 drugs iv_units Units iv_ddd loinc codes associated name antimicrobial drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use ab_loinc() retrieve quickly, see ab_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antivirals-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antivirals data set: a tibble with 120 observations and 11 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"av Antiviral ID used package (ACI), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. Combinations codes contain + indicate , ATA+COBI atazanavir/cobicistat. name Official name used WHONET/EARS-Net . unique identifier. atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC cid Compound ID found PubChem. unique identifier. atc_group Official pharmacological subgroup (3rd level ATC code) defined WHOCC synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral treatment iv_units Units iv_ddd loinc codes associated name antiviral drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use av_loinc() retrieve quickly, see av_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology (WHOCC): https://atcddd.fhi./atc_ddd_index/ Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Accessed https://loinc.org October 19th, 2023. European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials #> # A tibble: 497 × 14 #>    ab        cid name   group atc   atc_group1 atc_group2 abbreviations synonyms #>    <ab>    <dbl> <chr>  <chr> <lis> <chr>      <chr>      <list>        <named > #>  1 AMA      4649 4-ami… Anti… <chr> Drugs for… Aminosali… <chr [1]>     <chr>    #>  2 ACM   6450012 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  3 ASP  49787020 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  4 ALS      8954 Aldes… Othe… <chr> Drugs for… Drugs for… <chr [1]>     <chr>    #>  5 AMK     37768 Amika… Amin… <chr> Aminoglyc… Other ami… <chr [5]>     <chr>    #>  6 AKF        NA Amika… Amin… <chr> NA         NA         <chr [1]>     <chr>    #>  7 AMO     54260 Amoro… Anti… <chr> Antifunga… Other ant… <chr [1]>     <chr>    #>  8 AMX     33613 Amoxi… Beta… <chr> Beta-lact… Penicilli… <chr [3]>     <chr>    #>  9 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [5]>     <chr>    #> 10 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> # ℹ 487 more rows #> # ℹ 5 more variables: oral_ddd <dbl>, oral_units <chr>, iv_ddd <dbl>, #> #   iv_units <chr>, loinc <list> antivirals #> # A tibble: 120 × 11 #>    av       name      atc      cid atc_group synonyms oral_ddd oral_units iv_ddd #>    <av>     <chr>     <chr>  <dbl> <chr>     <list>      <dbl> <chr>       <dbl> #>  1 ABA      Abacavir  J05A… 4.41e5 Nucleosi… <chr>         0.6 g              NA #>  2 ACI      Aciclovir J05A… 1.35e8 Nucleosi… <chr>         4   g               4 #>  3 ADD      Adefovir… J05A… 6.09e4 Nucleosi… <chr>        10   mg             NA #>  4 AME      Amenamev… J05A… 1.14e7 Other an… <chr>         0.4 g              NA #>  5 AMP      Amprenav… J05A… 6.50e4 Protease… <chr>         1.2 g              NA #>  6 ASU      Asunapre… J05A… 1.61e7 Antivira… <chr>         0.2 g              NA #>  7 ATA      Atazanav… J05A… 1.48e5 Protease… <chr>         0.3 g              NA #>  8 ATA+COBI Atazanav… J05A… 8.66e7 Antivira… <chr>        NA   NA             NA #>  9 ATA+RIT  Atazanav… J05A… 2.51e7 Antivira… <chr>         0.3 g              NA #> 10 BAM      Baloxavi… J05A… 1.24e8 Other an… <chr>        40   mg             NA #> # ℹ 110 more rows #> # ℹ 2 more variables: iv_units <chr>, loinc <list>"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antibiotic ID — as.ab","title":"Transform Input to an Antibiotic ID — as.ab","text":"Use function determine antimicrobial drug code one antimicrobials. data set antimicrobials searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"as.ab(x, flag_multiple_results = TRUE, language = get_AMR_locale(),   info = interactive(), ...)  is.ab(x)  ab_reset_session()"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antibiotic ID — as.ab","text":"x character vector determine antibiotic ID. flag_multiple_results logical indicate whether note printed console probably one antibiotic drug code name can retrieved single input value. language Language coerce input values 20 supported languages - default system language supported (see get_AMR_locale()). info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antibiotic ID — as.ab","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antibiotic ID — as.ab","text":"entries antimicrobials data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .ab() can correct different forms misspelling: Wrong spelling drug names (\"tobramicin\" \"gentamycin\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"mreopenem\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use ab_* functions get properties based returned antibiotic ID, see Examples. Note: .ab() ab_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems. can add manual codes considered .ab() ab_* functions, see add_custom_antimicrobials().","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antibiotic ID — as.ab","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antibiotic ID — as.ab","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antibiotic ID — as.ab","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"# these examples all return \"ERY\", the ID of erythromycin: as.ab(\"J01FA01\") #> Class 'ab' #> [1] ERY as.ab(\"J 01 FA 01\") #> Class 'ab' #> [1] ERY as.ab(\"Erythromycin\") #> Class 'ab' #> [1] ERY as.ab(\"eryt\") #> Class 'ab' #> [1] ERY as.ab(\"ERYT\") #> Class 'ab' #> [1] ERY as.ab(\"ERY\") #> Class 'ab' #> [1] ERY as.ab(\"eritromicine\") # spelled wrong, yet works #> Class 'ab' #> [1] ERY as.ab(\"Erythrocin\") # trade name #> Class 'ab' #> [1] ERY as.ab(\"Romycin\") # trade name #> Class 'ab' #> [1] ERY  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  # use ab_* functions to get a specific properties (see ?ab_property); # they use as.ab() internally: ab_name(\"J01FA01\") #> [1] \"Erythromycin\" ab_name(\"eryt\") #> [1] \"Erythromycin\"  # \\donttest{ if (require(\"dplyr\")) {   # you can quickly rename 'sir' columns using set_ab_names() with dplyr:   example_isolates %>%     set_ab_names(where(is.sir), property = \"atc\") } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           J01CE01 J01CF04 J01CF05 #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir>   <sir>   <sir>   #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R       NA      S     #> # ℹ 1,990 more rows #> # ℹ 37 more variables: J01CA04 <sir>, J01CR02 <sir>, J01CA01 <sir>, #> #   J01CR05 <sir>, J01DB04 <sir>, J01DE01 <sir>, J01DC02 <sir>, J01DC01 <sir>, #> #   J01DD01 <sir>, J01DD02 <sir>, J01DD04 <sir>, J01GB03 <sir>, J01GB01 <sir>, #> #   J01GB06 <sir>, J01GB04 <sir>, J01EA01 <sir>, J01EE01 <sir>, J01XE01 <sir>, #> #   J01XX01 <sir>, J01XX08 <sir>, J01MA02 <sir>, J01MA14 <sir>, J01XA01 <sir>, #> #   J01XA02 <sir>, J01AA07 <sir>, J01AA12 <sir>, J01AA02 <sir>, … # }"},{"path":"https://amr-for-r.org/reference/as.av.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antiviral Drug ID — as.av","title":"Transform Input to an Antiviral Drug ID — as.av","text":"Use function determine antiviral drug code one antiviral drugs. data set antivirals searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"as.av(x, flag_multiple_results = TRUE, info = interactive(), ...)  is.av(x)"},{"path":"https://amr-for-r.org/reference/as.av.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antiviral Drug ID — as.av","text":"x character vector determine antiviral drug ID. flag_multiple_results logical indicate whether note printed console probably one antiviral drug code name can retrieved single input value. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antiviral Drug ID — as.av","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antiviral Drug ID — as.av","text":"entries antivirals data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .av() can correct different forms misspelling: Wrong spelling drug names (\"acyclovir\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"aycclovir\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use av_* functions get properties based returned antiviral drug ID, see Examples. Note: .av() av_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antiviral Drug ID — as.av","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antiviral Drug ID — as.av","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antiviral Drug ID — as.av","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"# these examples all return \"ACI\", the ID of aciclovir: as.av(\"J05AB01\") #> Class 'av' #> [1] ACI as.av(\"J 05 AB 01\") #> Class 'av' #> [1] ACI as.av(\"Aciclovir\") #> Class 'av' #> [1] ACI as.av(\"aciclo\") #> Class 'av' #> [1] ACI as.av(\"   aciclo 123\") #> Class 'av' #> [1] ACI as.av(\"ACICL\") #> Class 'av' #> [1] ACI as.av(\"ACI\") #> Class 'av' #> [1] ACI as.av(\"Virorax\") # trade name #> Class 'av' #> [1] ACI as.av(\"Zovirax\") # trade name #> Class 'av' #> [1] ACI  as.av(\"acyklofir\") # severe spelling error, yet works #> Class 'av' #> [1] ACI  # use av_* functions to get a specific properties (see ?av_property); # they use as.av() internally: av_name(\"J05AB01\") #> [1] \"Aciclovir\" av_name(\"acicl\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Disk Diffusion Diameters — as.disk","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"transforms vector new class disk, disk diffusion growth zone size (around antibiotic disk) millimetres 0 50.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"as.disk(x, na.rm = FALSE)  NA_disk_  is.disk(x)"},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"object class disk (inherits integer) length 1.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"x Vector. na.rm logical indicating whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"integer additional class disk","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"Interpret disk values SIR values .sir(). supports guidelines EUCAST CLSI. Disk diffusion growth zone sizes must 0 50 millimetres. Values higher 50 lower 100 maximised 50. others input values outside 0-50 range return NA. NA_disk_ missing value new disk class.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"# transform existing disk zones to the `disk` class (using base R) df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = 20,   CIP = 14,   GEN = 18,   TOB = 16 ) df[, 2:5] <- lapply(df[, 2:5], as.disk) str(df) #> 'data.frame':\t1 obs. of  5 variables: #>  $ microorganism: chr \"Escherichia coli\" #>  $ AMP          : 'disk' int 20 #>  $ CIP          : 'disk' int 14 #>  $ GEN          : 'disk' int 18 #>  $ TOB          : 'disk' int 16  # \\donttest{ # transforming is easier with dplyr: if (require(\"dplyr\")) {   df %>% mutate(across(AMP:TOB, as.disk)) } #>      microorganism AMP CIP GEN TOB #> 1 Escherichia coli  20  14  18  16 # }  # interpret disk values, see ?as.sir as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> ℹ Returning previously coerced values for various antimicrobials. Run #>   ab_reset_session() to reset this. This note will be shown once per #>   session. #> Interpreting disk diffusion zones: 'ampicillin' (AMP), EUCAST 2025... #>  OK  #> Class 'sir' #> [1] R  # interpret whole data set, pretend to be all from urinary tract infections: as.sir(df, uti = TRUE) #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting disk diffusion zones: column 'AMP' (ampicillin), EUCAST #> 2025... #>  OK  #> Interpreting disk diffusion zones: column 'CIP' (ciprofloxacin), EUCAST #> 2025... #>  OK  #> Interpreting disk diffusion zones: column 'GEN' (gentamicin), EUCAST #> 2025... #>  OK  #> Interpreting disk diffusion zones: column 'TOB' (tobramycin), EUCAST #> 2025... #>  OK  #>      microorganism AMP  CIP GEN TOB #> 1 Escherichia coli   S <NA>   S   S"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"transforms vectors new class mic, treats input decimal numbers, maintaining operators (\">=\") allowing valid MIC values known field (medical) microbiology.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"as.mic(x, na.rm = FALSE, keep_operators = \"all\")  is.mic(x)  NA_mic_  rescale_mic(x, mic_range, keep_operators = \"edges\", as.mic = TRUE)  mic_p50(x, na.rm = FALSE, ...)  mic_p90(x, na.rm = FALSE, ...)  # S3 method for class 'mic' droplevels(x, as.mic = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"x character numeric vector. na.rm logical indicating whether missing values removed. keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values, e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). .mic logical indicate whether mic class kept - default TRUE rescale_mic() FALSE droplevels(). setting FALSE rescale_mic(), output factor levels acknowledge mic_range. ... Arguments passed methods.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"Ordered factor additional class mic, mathematical operations acts numeric vector. Bear mind outcome mathematical operation MICs return numeric value.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"interpret MIC values SIR values, use .sir() MIC values. supports guidelines EUCAST (2011-2025) CLSI (2011-2025). class MIC values quite special data type: formally ordered factor valid MIC values factor levels (make sure valid MIC values retained), mathematical operation acts decimal numbers:   makes possible maintain operators often come MIC values, \">=\" \"<=\", even filtering using numeric values data analysis, e.g.:   -called group generic functions implemented MIC class (!, !=, <, >=, exp(), log2()). mathematical functions also implemented (quantile(), median(), fivenum()). Since sd() var() non-generic functions, extended. Use mad() alternative, use e.g. sd(.numeric(x)) x vector MIC values. Using .double() .numeric() MIC values remove operators return numeric vector. use .integer() MIC values R convention factors, return index factor levels (often useless regular users). function .mic() detects input contains class mic. input data.frame list, iterates columns/items returns logical vector. Use droplevels() drop unused levels. default, return plain factor. Use droplevels(..., .mic = TRUE) maintain mic class. rescale_mic(), existing MIC ranges can limited defined range MIC values. can useful better compare MIC distributions. ggplot2, use one scale_*_mic() functions plot MIC values. allows custom MIC ranges plot intermediate log2 levels missing MIC values. NA_mic_ missing value new mic class, analogous e.g. base R's NA_character_. Use mic_p50() mic_p90() get 50th 90th percentile MIC values. return 'normal' numeric values.","code":"x <- random_mic(10) x #> Class 'mic' #>  [1] 16     1      8      8      64     >=128  0.0625 32     32     16  is.factor(x) #> [1] TRUE  x[1] * 2 #> [1] 32  median(x) #> [1] 26 x[x > 4] #> Class 'mic' #> [1] 16    8     8     64    >=128 32    32    16  df <- data.frame(x, hospital = \"A\") subset(df, x > 4) # or with dplyr: df %>% filter(x > 4) #>        x hospital #> 1     16        A #> 5     64        A #> 6  >=128        A #> 8     32        A #> 9     32        A #> 10    16        A"},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"mic_data <- as.mic(c(\">=32\", \"1.0\", \"1\", \"1.00\", 8, \"<=0.128\", \"8\", \"16\", \"16\")) mic_data #> Class 'mic' #> [1] >=32    1       1       1       8       <=0.128 8       16      16      is.mic(mic_data) #> [1] TRUE  # this can also coerce combined MIC/SIR values: as.mic(\"<=0.002; S\") #> Class 'mic' #> [1] <=0.002  # mathematical processing treats MICs as numeric values fivenum(mic_data) #> [1]  0.128  1.000  8.000 16.000 32.000 quantile(mic_data) #>     0%    25%    50%    75%   100%  #>  0.128  1.000  8.000 16.000 32.000  all(mic_data < 512) #> [1] TRUE  # rescale MICs using rescale_mic() rescale_mic(mic_data, mic_range = c(4, 16)) #> Class 'mic' #> [1] >=16 <=4  <=4  <=4  8    <=4  8    >=16 >=16  # interpret MIC values as.sir(   x = as.mic(2),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'AMX' (amoxicillin), EUCAST 2025... #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 5 of item 2 does not match with column 5 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE as.sir(   x = as.mic(c(0.01, 2, 4, 8)),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'AMX' (amoxicillin), EUCAST 2025... #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 5 of item 2 does not match with column 5 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE  # plot MIC values, see ?plot plot(mic_data)  plot(mic_data, mo = \"E. coli\", ab = \"cipro\") #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE  if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\") } #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\", language = \"nl\") # Dutch } #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Use function get valid microorganism code (mo) based arbitrary user input. Determination done using intelligent rules complete taxonomic tree kingdoms Animalia, Archaea, Bacteria, Chromista, Protozoa, microbial species kingdom Fungi (see Source). input can almost anything: full name (like \"Staphylococcus aureus\"), abbreviated name (\"S. aureus\"), abbreviation known field (\"MRSA\"), just genus. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"as.mo(x, Becker = FALSE, Lancefield = FALSE,   minimum_matching_score = NULL,   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE),   reference_df = get_mo_source(),   ignore_pattern = getOption(\"AMR_ignore_pattern\", NULL),   cleaning_regex = getOption(\"AMR_cleaning_regex\", mo_cleaning_regex()),   only_fungi = getOption(\"AMR_only_fungi\", FALSE),   language = get_AMR_locale(), info = interactive(), ...)  is.mo(x)  mo_uncertainties()  mo_renamed()  mo_failures()  mo_reset_session()  mo_cleaning_regex()"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"x character vector data.frame one two columns. Becker logical indicate whether staphylococci categorised coagulase-negative staphylococci (\"CoNS\") coagulase-positive staphylococci (\"CoPS\") instead species, according Karsten Becker et al. (see Source). Please see Details full list staphylococcal species converted. excludes Staphylococcus aureus default, use Becker = \"\" also categorise S. aureus \"CoPS\". Lancefield logical indicate whether beta-haemolytic Streptococcus categorised Lancefield groups instead species, according Rebecca C. Lancefield (see Source). streptococci categorised first group, e.g. Streptococcus dysgalactiae group C, although officially also categorised groups G L. . Please see Details full list streptococcal species converted. excludes enterococci default (group D), use Lancefield = \"\" also categorise enterococci group D. minimum_matching_score numeric value set lower limit MO matching score. left blank, determined automatically based character length x, taxonomic kingdom human pathogenicity. keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). reference_df data.frame used extra reference translating x valid mo. See set_mo_source() get_mo_source() automate usage codes (e.g. used analysis organisation). ignore_pattern Perl-compatible regular expression (case-insensitive) matches x must return NA. can convenient exclude known non-relevant input can also set package option AMR_ignore_pattern, e.g. options(AMR_ignore_pattern = \"(reported|contaminated flora)\"). cleaning_regex Perl-compatible regular expression (case-insensitive) clean input x. Every matched part x removed. default, outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". default can set package option AMR_cleaning_regex. only_fungi logical indicate fungi must found, making sure e.g. misspellings always return records kingdom Fungi. can set globally microorganism functions package option AMR_only_fungi, .e. options(AMR_only_fungi = TRUE). language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). info logical indicate info must printed, e.g. progress bar 25 items coerced, list old taxonomic names. default TRUE interactive mode. ... arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"character vector additional class mo","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"microorganism (MO) code package (class: mo) human-readable typically looks like examples:   Values coerced considered 'unknown' return MO code UNKNOWN warning. Use mo_* functions get properties based returned code, see Examples. .mo() function uses novel scientifically validated (doi:10.18637/jss.v104.i03 ) matching score algorithm (see Matching Score Microorganisms ) match input available microbial taxonomy package. implicates e.g. \"E. coli\" (microorganism highly prevalent humans) return microbial ID Escherichia coli Entamoeba coli (microorganism less prevalent humans), although latter alphabetically come first.","code":"Code               Full name   ---------------    --------------------------------------   B_KLBSL            Klebsiella   B_KLBSL_PNMN       Klebsiella pneumoniae   B_KLBSL_PNMN_RHNS  Klebsiella pneumoniae rhinoscleromatis   |   |    |    |   |   |    |    |   |   |    |    \\---> subspecies, a 3-5 letter acronym   |   |    \\----> species, a 3-6 letter acronym   |   \\----> genus, a 4-8 letter acronym   \\----> kingdom: A (Archaea), AN (Animalia), B (Bacteria),                   C (Chromista), F (Fungi), PL (Plantae),                   P (Protozoa)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coping-with-uncertain-results","dir":"Reference","previous_headings":"","what":"Coping with Uncertain Results","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Results non-exact taxonomic input based matching score. lowest allowed score can set minimum_matching_score argument. default determined based character length input, taxonomic kingdom, human pathogenicity taxonomic outcome. values matched uncertainty, message shown suggest user inspect results mo_uncertainties(), returns data.frame specifications. increase quality matching, cleaning_regex argument used clean input. must regular expression matches parts input removed input matched available microbial taxonomy. matched Perl-compatible case-insensitive. default value cleaning_regex outcome helper function mo_cleaning_regex(). three helper functions can run using .mo() function: Use mo_uncertainties() get data.frame prints pretty format taxonomic names guessed. output contains matching score matches (see Matching Score Microorganisms ). Use mo_failures() get character vector values coerced valid value. Use mo_renamed() get data.frame values coerced based old, previously accepted taxonomic names.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"for-mycologists","dir":"Reference","previous_headings":"","what":"For Mycologists","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"matching score algorithm gives precedence bacteria fungi. analysing fungi, sure use only_fungi = TRUE, better yet, add code run every session:   make sure bacteria 'non-fungi' returned .mo(), mo_* functions.","code":"options(AMR_only_fungi = TRUE)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coagulase-negative-and-coagulase-positive-staphylococci","dir":"Reference","previous_headings":"","what":"Coagulase-negative and Coagulase-positive Staphylococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Becker = TRUE, following staphylococci converted corresponding coagulase group: Coagulase-negative: S. americanisciuri, S. argensis, S. arlettae, S. auricularis, S. borealis, S. brunensis, S. caeli, S. caledonicus, S. canis, S. capitis, S. capitis capitis, S. capitis urealyticus, S. capitis ureolyticus, S. caprae, S. carnosus, S. carnosus carnosus, S. carnosus utilis, S. casei, S. caseolyticus, S. chromogenes, S. cohnii, S. cohnii cohnii, S. cohnii urealyticum, S. cohnii urealyticus, S. condimenti, S. croceilyticus, S. debuckii, S. devriesei, S. durrellii, S. edaphicus, S. epidermidis, S. equorum, S. equorum equorum, S. equorum linens, S. felis, S. fleurettii, S. gallinarum, S. haemolyticus, S. hominis, S. hominis hominis, S. hominis novobiosepticus, S. jettensis, S. kloosii, S. lentus, S. lloydii, S. lugdunensis, S. marylandisciuri, S. massiliensis, S. microti, S. muscae, S. nepalensis, S. pasteuri, S. petrasii, S. petrasii croceilyticus, S. petrasii jettensis, S. petrasii petrasii, S. petrasii pragensis, S. pettenkoferi, S. piscifermentans, S. pragensis, S. pseudoxylosus, S. pulvereri, S. ratti, S. rostri, S. saccharolyticus, S. saprophyticus, S. saprophyticus bovis, S. saprophyticus saprophyticus, S. schleiferi, S. schleiferi schleiferi, S. sciuri, S. sciuri carnaticus, S. sciuri lentus, S. sciuri rodentium, S. sciuri sciuri, S. shinii, S. simulans, S. stepanovicii, S. succinus, S. succinus casei, S. succinus succinus, S. taiwanensis, S. urealyticus, S. ureilyticus, S. veratri, S. vitulinus, S. vitulus, S. warneri, S. xylosus Coagulase-positive: S. agnetis, S. argenteus, S. coagulans, S. cornubiensis, S. delphini, S. hyicus, S. hyicus chromogenes, S. hyicus hyicus, S. intermedius, S. lutrae, S. pseudintermedius, S. roterodami, S. schleiferi coagulans, S. schweitzeri, S. simiae, S. singaporensis based : Becker K et al. (2014). Coagulase-Negative Staphylococci. Clin Microbiol Rev. 27(4): 870-926; doi:10.1128/CMR.00109-13 Becker K et al. (2019). Implications identifying recently defined members S. aureus complex, S. argenteus S. schweitzeri: position paper members ESCMID Study Group staphylococci Staphylococcal Diseases (ESGS). Clin Microbiol Infect; doi:10.1016/j.cmi.2019.02.028 Becker K et al. (2020). Emergence coagulase-negative staphylococci. Expert Rev Anti Infect Ther. 18(4):349-366; doi:10.1080/14787210.2020.1730813 newly named staphylococcal species, S. brunensis (2024) S. shinii (2023), looked scientific reference make sure species considered correct coagulase group.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"lancefield-groups-in-streptococci","dir":"Reference","previous_headings":"","what":"Lancefield Groups in Streptococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Lancefield = TRUE, following streptococci converted corresponding Lancefield group: Streptococcus Group : S. pyogenes Streptococcus Group B: S. agalactiae Streptococcus Group C: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis, S. equi, S. equi equi, S. equi ruminatorum, S. equi zooepidemicus Streptococcus Group F: S. anginosus, S. anginosus anginosus, S. anginosus whileyi, S. constellatus, S. constellatus constellatus, S. constellatus pharyngis, S. constellatus viborgensis, S. intermedius Streptococcus Group G: S. canis, S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis Streptococcus Group H: S. sanguinis Streptococcus Group K: S. salivarius, S. salivarius salivarius, S. salivarius thermophilus Streptococcus Group L: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis based : Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"# \\donttest{ # These examples all return \"B_STPHY_AURS\", the ID of S. aureus: as.mo(c(   \"sau\", # WHONET code   \"stau\",   \"STAU\",   \"staaur\",   \"S. aureus\",   \"S aureus\",   \"Sthafilokkockus aureus\", # handles incorrect spelling   \"Staphylococcus aureus (MRSA)\",   \"MRSA\", # Methicillin Resistant S. aureus   \"VISA\", # Vancomycin Intermediate S. aureus   \"VRSA\", # Vancomycin Resistant S. aureus   115329001 # SNOMED CT code )) #> Class 'mo' #>  [1] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #>  [6] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #> [11] B_STPHY_AURS B_STPHY_AURS  # Dyslexia is no problem - these all work: as.mo(c(   \"Ureaplasma urealyticum\",   \"Ureaplasma urealyticus\",   \"Ureaplasmium urealytica\",   \"Ureaplazma urealitycium\" )) #> Class 'mo' #> [1] B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY  # input will get cleaned up with the input given in the `cleaning_regex` argument, # which defaults to `mo_cleaning_regex()`: cat(mo_cleaning_regex(), \"\\n\") #> ([^A-Za-z- \\(\\)\\[\\]{}]+|([({]|\\[).+([})]|\\])|(^| )( ?[a-z-]+[-](resistant|susceptible) ?|e?spp([^a-z]+|$)|e?ssp([^a-z]+|$)|serogr.?up[a-z]*|e?ss([^a-z]+|$)|e?sp([^a-z]+|$)|var([^a-z]+|$)|serovar[a-z]*|sube?species|biovar[a-z]*|e?species|Ig[ADEGM]|e?subsp|biotype|titer|dummy))   as.mo(\"Streptococcus group A\") #> Class 'mo' #> [1] B_STRPT_GRPA  as.mo(\"S. epidermidis\") # will remain species: B_STPHY_EPDR #> Class 'mo' #> [1] B_STPHY_EPDR as.mo(\"S. epidermidis\", Becker = TRUE) # will not remain species: B_STPHY_CONS #> Class 'mo' #> [1] B_STPHY_CONS  as.mo(\"S. pyogenes\") # will remain species: B_STRPT_PYGN #> Class 'mo' #> [1] B_STRPT_PYGN as.mo(\"S. pyogenes\", Lancefield = TRUE) # will not remain species: B_STRPT_GRPA #> Class 'mo' #> [1] B_STRPT_GRPA  # All mo_* functions use as.mo() internally too (see ?mo_property): mo_genus(\"E. coli\") #> [1] \"Escherichia\" mo_gramstain(\"ESCO\") #> [1] \"Gram-negative\" mo_is_intrinsic_resistant(\"ESCCOL\", ab = \"vanco\") #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant #>   Phenotypes' v1.2 (2023). This note will be shown once per session. #> [1] TRUE # }"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":null,"dir":"Reference","previous_headings":"","what":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Clean existing SIR values, interpret minimum inhibitory concentration (MIC) values disk diffusion diameters according EUCAST CLSI. .sir() transforms input new class sir, ordered factor containing levels S, SDD, , R, NI. Breakpoints currently implemented EUCAST 2011-2025 CLSI 2011-2025, see Details. breakpoints used interpretation available clinical_breakpoints data set.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"as.sir(x, ...)  NA_sir_  is.sir(x)  is_sir_eligible(x, threshold = 0.05)  # Default S3 method as.sir(x, S = \"^(S|U)+$\", I = \"^(I)+$\", R = \"^(R)+$\",   NI = \"^(N|NI|V)+$\", SDD = \"^(SDD|D|H)+$\", info = TRUE, ...)  # S3 method for class 'mic' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   verbose = FALSE, info = TRUE, conserve_capped_values = NULL, ...)  # S3 method for class 'disk' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   verbose = FALSE, info = TRUE, ...)  # S3 method for class 'data.frame' as.sir(x, ..., col_mo = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   verbose = FALSE, info = TRUE, parallel = FALSE, max_cores = -1,   conserve_capped_values = NULL)  sir_interpretation_history(clean = FALSE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpretations minimum inhibitory concentration (MIC) values disk diffusion diameters: CLSI M39: Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. CLSI M100: Performance Standard Antimicrobial Susceptibility Testing, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m100/. CLSI VET01: Performance Standards Antimicrobial Disk Dilution Susceptibility Tests Bacteria Isolated Animals, 2019-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/veterinary-medicine/documents/vet01/. EUCAST Breakpoint tables interpretation MICs zone diameters, 2011-2025, European Committee Antimicrobial Susceptibility Testing (EUCAST). https://www.eucast.org/clinical_breakpoints. WHONET source machine-reading clinical breakpoints (read ), 1989-2025, Collaborating Centre Surveillance Antimicrobial Resistance. https://whonet.org/.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"x Vector values (class mic: MIC values mg/L, class disk: disk diffusion radius millimetres). ... using data.frame: names columns apply .sir() (supports tidy selection column1:column4). Otherwise: arguments passed methods. threshold Maximum fraction invalid antimicrobial interpretations x, see Examples. S, , R, NI, SDD case-independent regular expression translate input result. regular expression run non-letters whitespaces removed input. info logical print information process. mo vector (column name) characters can coerced valid microorganism codes .mo(), can left empty determine automatically. ab vector (column name) characters can coerced valid antimicrobial drug code .ab(). guideline guideline name (column name) use SIR interpretation. Defaults EUCAST 2025 (latest implemented EUCAST guideline clinical_breakpoints data set), can set package option AMR_guideline. Currently supports EUCAST (2011-2025) CLSI (2011-2025), see Details. Using column name allows straightforward interpretation historical data, must analysed context , example, different years. uti (Urinary Tract Infection) vector (column name) logicals (TRUE FALSE) specify whether UTI specific interpretation guideline chosen. using .sir() data.frame, can also column containing logicals left blank, data set searched column 'specimen', rows within column containing 'urin' ('urine', 'urina') regarded isolates UTI. See Examples. capped_mic_handling character string controls MIC values cap (.e., starting <, <=, >, >=) interpreted. Supports following options: \"none\" <= >= treated -. < > treated -. \"conservative\" <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < always returns \"S\", > always returns \"R\". \"standard\" (default) <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < > treated -. \"inverse\" <= >= treated -. < always returns \"S\", > always returns \"R\". default \"standard\" setting ensures cautious handling uncertain values preserving interpretability. option can also set package option AMR_capped_mic_handling. add_intrinsic_resistance (useful using EUCAST guideline) logical indicate whether intrinsic antibiotic resistance must also considered applicable bug-drug combinations, meaning e.g. ampicillin always return \"R\" Klebsiella species. Determination based intrinsic_resistant data set, based 'EUCAST Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021). reference_data data.frame used interpretation, defaults clinical_breakpoints data set. Changing argument allows using interpretation guidelines. argument must contain data set equal structure clinical_breakpoints data set (column names column types). Please note guideline argument ignored reference_data manually set. substitute_missing_r_breakpoint logical indicate missing clinical breakpoints R (resistant) must substituted R - default FALSE. (especially CLSI) breakpoints breakpoint S, meaning outcome can \"S\" NA. Setting TRUE convert NAs \"R\" R breakpoint missing. Can also set package option AMR_substitute_missing_r_breakpoint. include_screening logical indicate clinical breakpoints screening allowed - default FALSE. Can also set package option AMR_include_screening. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". host vector (column name) characters indicate host. useful veterinary breakpoints, requires breakpoint_type = \"animal\". values can text resembling animal species, even 20 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). verbose logical indicate notes printed interpretation MIC values disk diffusion values. conserve_capped_values Deprecated, use capped_mic_handling instead. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). parallel logical indicate parallel computing must used, defaults FALSE. max_cores Maximum number cores use parallel = TRUE. Use negative value subtract number available number cores, e.g. value -2 8-core machine means 6 cores used. Defaults -1. available number cores detected using parallelly::availableCores() package installed, base R's parallel::detectCores() otherwise. clean logical indicate whether previously stored results forgotten returning 'logbook' results.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Ordered factor new class sir","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Note: clinical breakpoints package validated , imported , WHONET. public use AMR package endorsed CLSI EUCAST. See clinical_breakpoints information. NA_sir_ missing value new sir class, analogous e.g. base R's NA_character_.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"how-it-works","dir":"Reference","previous_headings":"","what":"How it Works","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":".sir() function can work four ways: cleaning raw / untransformed data. data cleaned contain valid values, namely: S susceptible, intermediate 'susceptible, increased exposure', R resistant, NI non-interpretable, SDD susceptible dose-dependent. can set using regular expression. Furthermore, .sir() try best clean intelligence. example, mixed values SIR interpretations MIC values \"<0.25; S\" coerced \"S\". Combined interpretations multiple test methods (seen laboratory records) \"S; S\" coerced \"S\", value like \"S; \" return NA warning input invalid. interpreting minimum inhibitory concentration (MIC) values according EUCAST CLSI. must clean MIC values first using .mic(), also gives columns new data class mic. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   Operators like \"<=\" stripped interpretation. using capped_mic_handling = \"conservative\", MIC value e.g. \">2\" always return \"R\", even breakpoint according chosen guideline \">=4\". prevent capped values raw laboratory data treated conservatively. default behaviour (capped_mic_handling = \"standard\") considers \">2\" lower \">=4\" might case return \"S\" \"\". Note: using CLSI guideline, MIC values must log2-based doubling dilutions. Values format, automatically rounded nearest log2 level CLSI instructs, warning thrown. interpreting disk diffusion diameters according EUCAST CLSI. must clean disk zones first using .disk(), also gives columns new data class disk. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   interpreting complete data set, automatic determination MIC values, disk diffusion diameters, microorganism names codes, antimicrobial test results. done simply running .sir(your_data). points 2, 3 4: Use sir_interpretation_history() retrieve data.frame results previous .sir() calls. also contains notes interpretation, exact input output values.","code":"your_data %>% mutate_if(is.mic, as.sir) your_data %>% mutate(across(where(is.mic), as.sir)) your_data %>% mutate_if(is.mic, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.mic, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.mic, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE) your_data %>% mutate_if(is.disk, as.sir) your_data %>% mutate(across(where(is.disk), as.sir)) your_data %>% mutate_if(is.disk, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.disk, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.disk, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"supported-guidelines","dir":"Reference","previous_headings":"","what":"Supported Guidelines","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpreting MIC values well disk diffusion diameters, currently implemented guidelines : clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. guideline argument must set e.g., \"EUCAST 2025\" \"CLSI 2025\". simply using \"EUCAST\" (default) \"CLSI\" input, latest included version guideline automatically selected. Importantly, using column name data instead, allows straightforward interpretation historical data must analysed context , example, different years. can set data set using reference_data argument. guideline argument ignored. also possible set default guideline package option AMR_guideline (e.g. .Rprofile file), :","code":"options(AMR_guideline = \"CLSI\")   options(AMR_guideline = \"CLSI 2018\")   options(AMR_guideline = \"EUCAST 2020\")   # or to reset:   options(AMR_guideline = NULL)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"working-with-veterinary-breakpoints","dir":"Reference","previous_headings":"","what":"Working with Veterinary Breakpoints","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using veterinary breakpoints (.e., setting breakpoint_type = \"animal\"), column animal species must available set manually using host argument. column must contain names like \"dogs\", \"cats\", \"cattle\", \"swine\", \"horses\", \"poultry\", \"aquatic\". animal names like \"goats\", \"rabbits\", \"monkeys\" also recognised may available guidelines. Matching case-insensitive accepts Latin-based synonyms (e.g., \"bovine\" cattle \"canine\" dogs). Regarding choice veterinary guidelines, might best options set analysis:","code":"options(AMR_guideline = \"CLSI\")   options(AMR_breakpoint_type = \"animal\")"},{"path":[]},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"after-interpretation","dir":"Reference","previous_headings":"","what":"After Interpretation","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using .sir(), can use eucast_rules() defined EUCAST (1) apply inferred susceptibility resistance based results antimicrobials (2) apply intrinsic resistance based taxonomic properties microorganism. determine isolates multi-drug resistant, sure run mdro() (applies MDR/PDR/XDR guideline 2012 default) data set contains S//R values. Read interpreting multidrug-resistant organisms .","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"function .sir() detects input contains class sir. input data.frame list, iterates columns/items returns logical vector. base R function .double() can used retrieve quantitative values sir object: \"S\" = 1, \"\"/\"SDD\" = 2, \"R\" = 3. values rendered NA . Note: use .integer(), since (R works internally) return factor level indices, aforementioned quantitative values. function is_sir_eligible() returns TRUE column contains 5% invalid antimicrobial interpretations (S //R /NI /SDD), FALSE otherwise. threshold 5% can set threshold argument. input data.frame, iterates columns returns logical vector.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … summary(example_isolates) # see all SIR results at a glance #>       date              patient               age           gender          #>  Min.   :2002-01-02   Length:2000        Min.   : 0.00   Length:2000        #>  1st Qu.:2005-07-31   Class :character   1st Qu.:63.00   Class :character   #>  Median :2009-07-31   Mode  :character   Median :74.00   Mode  :character   #>  Mean   :2009-11-20                      Mean   :70.69                      #>  3rd Qu.:2014-05-30                      3rd Qu.:82.00                      #>  Max.   :2017-12-28                      Max.   :97.00                      #>      ward                mo                  PEN                 #>  Length:2000        Class :mo             Class:sir              #>  Class :character   <NA>  :0              %S   :25.6% (n=417)    #>  Mode  :character   Unique:90             %SDD : 0.0% (n=0)      #>                     #1    :B_ESCHR_COLI   %I   : 0.7% (n=11)     #>                     #2    :B_STPHY_CONS   %R   :73.7% (n=1201)   #>                     #3    :B_STPHY_AURS   %NI  : 0.0% (n=0)      #>     OXA                   FLC                   AMX                #>  Class:sir             Class:sir             Class:sir             #>  %S   :68.8% (n=251)   %S   :70.5% (n=665)   %S   :40.2% (n=543)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)     %I   : 0.2% (n=3)     #>  %R   :31.2% (n=114)   %R   :29.5% (n=278)   %R   :59.6% (n=804)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     AMC                    AMP                   TZP                #>  Class:sir              Class:sir             Class:sir             #>  %S   :71.4% (n=1342)   %S   :40.2% (n=543)   %S   :86.1% (n=862)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 4.8% (n=91)     %I   : 0.2% (n=3)     %I   : 1.3% (n=13)    #>  %R   :23.7% (n=446)    %R   :59.6% (n=804)   %R   :12.6% (n=126)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     CZO                   FEP                   CXM                 #>  Class:sir             Class:sir             Class:sir              #>  %S   :54.9% (n=245)   %S   :85.6% (n=620)   %S   :72.5% (n=1297)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      #>  %I   : 0.4% (n=2)     %I   : 0.1% (n=1)     %I   : 1.2% (n=22)     #>  %R   :44.6% (n=199)   %R   :14.2% (n=103)   %R   :26.3% (n=470)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      #>     FOX                   CTX                   CAZ                 #>  Class:sir             Class:sir             Class:sir              #>  %S   :71.6% (n=586)   %S   :84.4% (n=796)   %S   :33.5% (n=607)    #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      #>  %I   : 1.0% (n=8)     %I   : 0.1% (n=1)     %I   : 0.0% (n=0)      #>  %R   :27.4% (n=224)   %R   :15.5% (n=146)   %R   :66.5% (n=1204)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      #>     CRO                   GEN                    TOB                #>  Class:sir             Class:sir              Class:sir             #>  %S   :84.4% (n=796)   %S   :74.0% (n=1372)   %S   :65.1% (n=879)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.1% (n=1)     %I   : 1.5% (n=27)     %I   : 0.5% (n=7)     #>  %R   :15.5% (n=146)   %R   :24.6% (n=456)    %R   :34.4% (n=465)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     AMK                   KAN                    TMP                #>  Class:sir             Class:sir              Class:sir             #>  %S   :36.3% (n=251)   %S   : 0.0% (n=0)      %S   :61.2% (n=918)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)      %I   : 0.7% (n=10)    #>  %R   :63.7% (n=441)   %R   :100.0% (n=471)   %R   :38.1% (n=571)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     SXT                    NIT                   FOS                #>  Class:sir              Class:sir             Class:sir             #>  %S   :79.1% (n=1392)   %S   :76.0% (n=565)   %S   :57.8% (n=203)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.3% (n=6)      %I   : 6.9% (n=51)    %I   : 0.0% (n=0)     #>  %R   :20.5% (n=361)    %R   :17.1% (n=127)   %R   :42.2% (n=148)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     LNZ                   CIP                    MFX                #>  Class:sir             Class:sir              Class:sir             #>  %S   :30.7% (n=314)   %S   :78.9% (n=1112)   %S   :64.5% (n=136)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 4.9% (n=69)     %I   : 1.9% (n=4)     #>  %R   :69.3% (n=709)   %R   :16.2% (n=228)    %R   :33.6% (n=71)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     VAN                    TEC                   TCY                #>  Class:sir              Class:sir             Class:sir             #>  %S   :61.7% (n=1149)   %S   :24.3% (n=237)   %S   :68.3% (n=820)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)      %I   : 0.0% (n=0)     %I   : 1.9% (n=23)    #>  %R   :38.3% (n=712)    %R   :75.7% (n=739)   %R   :29.8% (n=357)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     TGC                   DOX                   ERY                 #>  Class:sir             Class:sir             Class:sir              #>  %S   :87.3% (n=697)   %S   :71.7% (n=814)   %S   :42.3% (n=801)    #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      #>  %I   : 0.0% (n=0)     %I   : 0.6% (n=7)     %I   : 0.5% (n=9)      #>  %R   :12.7% (n=101)   %R   :27.7% (n=315)   %R   :57.2% (n=1084)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      #>     CLI                   AZM                    IPM                #>  Class:sir             Class:sir              Class:sir             #>  %S   :38.6% (n=586)   %S   :42.3% (n=801)    %S   :92.7% (n=824)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.3% (n=4)     %I   : 0.5% (n=9)      %I   : 1.1% (n=10)    #>  %R   :61.2% (n=930)   %R   :57.2% (n=1084)   %R   : 6.2% (n=55)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     MEM                   MTR                  CHL                #>  Class:sir             Class:sir            Class:sir             #>  %S   :94.1% (n=780)   %S   :85.3% (n=29)   %S   :78.6% (n=121)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)    %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)    %I   : 0.0% (n=0)     #>  %R   : 5.9% (n=49)    %R   :14.7% (n=5)    %R   :21.4% (n=33)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)    %NI  : 0.0% (n=0)     #>     COL                    MUP                   RIF                #>  Class:sir              Class:sir             Class:sir             #>  %S   :18.8% (n=309)    %S   :93.0% (n=251)   %S   :30.2% (n=303)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)      %I   : 1.1% (n=3)     %I   : 0.2% (n=2)     #>  %R   :81.2% (n=1331)   %R   : 5.9% (n=16)    %R   :69.6% (n=698)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      # For INTERPRETING disk diffusion and MIC values -----------------------  # example data sets, with combined MIC values and disk zones df_wide <- data.frame(   microorganism = \"Escherichia coli\",   amoxicillin = as.mic(8),   cipro = as.mic(0.256),   tobra = as.disk(16),   genta = as.disk(18),   ERY = \"R\" ) df_long <- data.frame(   bacteria = rep(\"Escherichia coli\", 4),   antibiotic = c(\"amoxicillin\", \"cipro\", \"tobra\", \"genta\"),   mics = as.mic(c(0.01, 1, 4, 8)),   disks = as.disk(c(6, 10, 14, 18)),   guideline = c(\"EUCAST 2021\", \"EUCAST 2022\", \"EUCAST 2023\", \"EUCAST 2024\") )  # \\donttest{ ## Using dplyr ------------------------------------------------- if (require(\"dplyr\")) {   # approaches that all work without additional arguments:   df_wide %>% mutate_if(is.mic, as.sir)   df_wide %>% mutate_if(function(x) is.mic(x) | is.disk(x), as.sir)   df_wide %>% mutate(across(where(is.mic), as.sir))   df_wide %>% mutate_at(vars(amoxicillin:tobra), as.sir)   df_wide %>% mutate(across(amoxicillin:tobra, as.sir))    # approaches that all work with additional arguments:   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       guideline = \"guideline\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     # given certain columns, e.g. from 'cipro' to 'genta'     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           guideline = \"CLSI\"         )       }     ))    # for veterinary breakpoints, add 'host':   df_long$animal_species <- c(\"cats\", \"dogs\", \"horses\", \"cattle\")   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))    # to include information about urinary tract infections (UTI)   data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     from_the_bladder = c(TRUE, FALSE)   ) %>%     as.sir(uti = \"from_the_bladder\")    data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     specimen = c(\"urine\", \"blood\")   ) %>%     as.sir() # automatically determines urine isolates    df_wide %>%     mutate_at(vars(cipro:genta), as.sir, mo = \"E. coli\", uti = TRUE) } #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'amoxicillin' (AMX) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for amoxicillin (AMX) in Escherichia coli - assuming body site 'Intravenous'. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli - assuming body site 'Non-meningitis'. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'amoxicillin' (AMX) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for amoxicillin (AMX) in Escherichia coli - assuming body site 'Intravenous'. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'tobra' (TOB, tobramycin) based on #> column 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in Escherichia coli - assuming an unspecified body site. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'genta' (GEN, gentamicin) based on #> column 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in Escherichia coli - assuming an unspecified body site. Use argument uti to set which isolates are from urine. See ?as.sir. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'amoxicillin' (AMX) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for amoxicillin (AMX) in Escherichia coli - assuming body site 'Intravenous'. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli - assuming body site 'Non-meningitis'. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'amoxicillin' (AMX) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for amoxicillin (AMX) in Escherichia coli - assuming body site 'Intravenous'. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'tobra' (TOB, tobramycin) based on #> column 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in Escherichia coli - assuming an unspecified body site. Use argument uti to set which isolates are from urine. See ?as.sir. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'amoxicillin' (AMX) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for amoxicillin (AMX) in Escherichia coli - assuming body site 'Intravenous'. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin) based on column #> 'microorganism', EUCAST 2025... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'tobra' (TOB, tobramycin) based on #> column 'microorganism', EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in Escherichia coli - assuming an unspecified body site. Use argument uti to set which isolates are from urine. See ?as.sir. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'amoxicillin' (AMX), 'cipro' (CIP, ciprofloxacin), #> 'tobra' (TOB, tobramycin), and 'genta' (GEN, gentamicin) based on column #> 'bacteria', EUCAST 2021, EUCAST 2022, EUCAST 2023, and EUCAST 2024... #>  NOTE  #>   • There were multiple notes. Print or View sir_interpretation_history() to examine them, or use as.sir(..., verbose = TRUE) next time to directly print them here. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'amoxicillin' (AMX), 'cipro' (CIP, ciprofloxacin), #> 'tobra' (TOB, tobramycin), and 'genta' (GEN, gentamicin) based on column #> 'bacteria', CLSI 2025... #>  OK  #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin), CLSI 2025... #>  OK  #> Interpreting disk diffusion zones: 'tobra' (TOB, tobramycin), CLSI 2025... #>  OK  #> Interpreting disk diffusion zones: 'genta' (GEN, gentamicin), CLSI 2025... #>  OK  #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin), CLSI 2025... #>  OK  #> Interpreting disk diffusion zones: 'tobra' (TOB, tobramycin), CLSI 2025... #>  OK  #> Interpreting disk diffusion zones: 'genta' (GEN, gentamicin), CLSI 2025... #>  OK  #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> ℹ Assuming breakpoint_type = \"animal\", since host is set. #>  #> Interpreting MIC values: 'amoxicillin' (AMX), 'cipro' (CIP, ciprofloxacin), #> 'tobra' (TOB, tobramycin), and 'genta' (GEN, gentamicin) based on column #> 'bacteria', CLSI 2025... #>  OK  #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `mics = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> ℹ Assuming breakpoint_type = \"animal\", since host is set. #>  #> Interpreting MIC values: 'amoxicillin' (AMX), 'cipro' (CIP, ciprofloxacin), #> 'tobra' (TOB, tobramycin), and 'genta' (GEN, gentamicin) based on column #> 'bacteria', CLSI 2025... #>  OK  #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> ℹ Assuming breakpoint_type = \"animal\", since host is set. #>  #>  #> Interpreting MIC values: 'antibiotic' (ASP, acetylspiramycin), CLSI 2025... #>  WARNING  #>   • No MIC breakpoints available for acetylspiramycin (ASP). #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #>  WARNING  #>   • No DISK breakpoints available for acetylspiramycin (ASP). #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #>  WARNING  #>   • No DISK breakpoints available for acetylspiramycin (ASP). #> Warning: There were 2 warnings in `mutate()`. #> The first warning was: #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! The following animal host(s) could not be coerced: \"animal_species\" #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 1 remaining warning. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> ℹ Assuming breakpoint_type = \"animal\", since host is set. #>  #>  #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin), CLSI 2025... #>  OK  #> Interpreting disk diffusion zones: 'tobra' (TOB, tobramycin), CLSI 2025... #>  OK  #> Interpreting disk diffusion zones: 'genta' (GEN, gentamicin), CLSI 2025... #>  OK  #> Warning: There were 2 warnings in `mutate()`. #> The first warning was: #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! The following animal host(s) could not be coerced: \"animal_species\" #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 1 remaining warning. #> ℹ Returning previously coerced values for \"E. coli\". Run #>   mo_reset_session() to reset this. This note will be shown once per #>   session for this input. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting disk diffusion zones: column 'nitrofuratoin' (NIT, #> nitrofurantoin), EUCAST 2025... #>  OK  #> ℹ Assuming value \"urine\" in column 'specimen' reflects a urinary tract #>   infection. #>   Use as.sir(uti = FALSE) to prevent this. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting disk diffusion zones: column 'nitrofuratoin' (NIT, #> nitrofurantoin), EUCAST 2025... #>  OK  #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin), EUCAST 2025... #>  OK  #> Interpreting disk diffusion zones: 'tobra' (TOB, tobramycin), EUCAST #> 2025... #>  OK  #> Interpreting disk diffusion zones: 'genta' (GEN, gentamicin), EUCAST #> 2025... #>  OK  #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           8  <NA>     S     S   R   ## Using base R ------------------------------------------------  as.sir(df_wide) #>  #> ℹ Running SIR interpretation in sequential mode. Consider setting parallel #>   = TRUE to speed up processing on multiple cores. #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: column 'amoxicillin' (AMX), EUCAST 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for amoxicillin (AMX) in Escherichia coli - assuming body site 'Intravenous'. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: column 'cipro' (CIP, ciprofloxacin), EUCAST #> 2025... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: column 'tobra' (TOB, tobramycin), EUCAST #> 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in Escherichia coli - assuming an unspecified body site. Use argument uti to set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: column 'genta' (GEN, gentamicin), EUCAST #> 2025... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in Escherichia coli - assuming an unspecified body site. Use argument uti to set which isolates are from urine. See ?as.sir. #> Assigning class 'sir' to already clean column 'ERY' (erythromycin)... #>  OK  #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R  # return a 'logbook' about the results: sir_interpretation_history() #> # A tibble: 54 × 18 #>    datetime            index method ab_given    mo_given  host_given input_given #>    <dttm>              <int> <chr>  <chr>       <chr>     <chr>      <chr>       #>  1 2025-04-26 13:53:13     1 MIC    amoxicillin Escheric… human      8           #>  2 2025-04-26 13:53:14     1 MIC    cipro       Escheric… human      0.256       #>  3 2025-04-26 13:53:14     1 MIC    amoxicillin Escheric… human      8           #>  4 2025-04-26 13:53:14     1 MIC    cipro       Escheric… human      0.256       #>  5 2025-04-26 13:53:14     1 DISK   tobra       Escheric… human      16          #>  6 2025-04-26 13:53:15     1 DISK   genta       Escheric… human      18          #>  7 2025-04-26 13:53:15     1 MIC    amoxicillin Escheric… human      8           #>  8 2025-04-26 13:53:15     1 MIC    cipro       Escheric… human      0.256       #>  9 2025-04-26 13:53:15     1 MIC    amoxicillin Escheric… human      8           #> 10 2025-04-26 13:53:16     1 MIC    cipro       Escheric… human      0.256       #> # ℹ 44 more rows #> # ℹ 11 more variables: ab <ab>, mo <mo>, host <chr>, input <chr>, #> #   outcome <sir>, notes <chr>, guideline <chr>, ref_table <chr>, uti <lgl>, #> #   breakpoint_S_R <chr>, site <lgl>  # for single values as.sir(   x = as.mic(2),   mo = as.mo(\"S. pneumoniae\"),   ab = \"AMP\",   guideline = \"EUCAST\" ) #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'AMP' (ampicillin), EUCAST 2025... #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 5 of item 2 does not match with column 5 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE  as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting disk diffusion zones: 'ampicillin' (AMP), EUCAST 2025... #>  OK  #> Class 'sir' #> [1] R   # For CLEANING existing SIR values -------------------------------------  as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", \"A\", \"B\", \"C\")) #> Warning: in as.sir(): 3 results in index '20' truncated (38%) that were invalid #> antimicrobial interpretations: \"A\", \"B\", and \"C\" as.sir(\"<= 0.002; S\") # will return \"S\" sir_data <- as.sir(c(rep(\"S\", 474), rep(\"I\", 36), rep(\"R\", 370))) is.sir(sir_data) #> [1] TRUE plot(sir_data) # for percentages  barplot(sir_data) # for frequencies   # as common in R, you can use as.integer() to return factor indices: as.integer(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  3  4  5 NA # but for computational use, as.double() will return 1 for S, 2 for I/SDD, and 3 for R: as.double(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  2  3 NA NA  # the dplyr way if (require(\"dplyr\")) {   example_isolates %>%     mutate_at(vars(PEN:RIF), as.sir)   # same:   example_isolates %>%     as.sir(PEN:RIF)    # fastest way to transform all columns with already valid AMR results to class `sir`:   example_isolates %>%     mutate_if(is_sir_eligible, as.sir)    # since dplyr 1.0.0, this can also be:   # example_isolates %>%   #   mutate(across(where(is_sir_eligible), as.sir)) } #>  #> ℹ Running SIR interpretation in sequential mode. Consider setting parallel #>   = TRUE to speed up processing on multiple cores. #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":null,"dir":"Reference","previous_headings":"","what":"Get ATC Properties from WHOCC Website — atc_online_property","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Gets data WHOCC website determine properties Anatomical Therapeutic Chemical (ATC) (e.g. antimicrobial), name, defined daily dose (DDD) standard unit.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"atc_online_property(atc_code, property, administration = \"O\",   url = \"https://atcddd.fhi.no/atc_ddd_index/?code=%s&showdescription=no\",   url_vet = \"https://atcddd.fhi.no/atcvet/atcvet_index/?code=%s&showdescription=no\")  atc_online_groups(atc_code, ...)  atc_online_ddd(atc_code, ...)  atc_online_ddd_units(atc_code, ...)"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"https://atcddd.fhi./atc_ddd_alterations__cumulative/ddd_alterations/abbrevations/","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"atc_code character (vector) ATC code(s) antimicrobials, coerced .ab() ab_atc() internally valid ATC code. property Property ATC code. Valid values \"ATC\", \"Name\", \"DDD\", \"U\" (\"unit\"), \"Adm.R\", \"Note\" groups. last option, hierarchical groups ATC code returned, see Examples. administration Type administration using property = \"Adm.R\", see Details. url URL website WHOCC. sign %s can used placeholder ATC codes. url_vet URL website WHOCC veterinary medicine. sign %s can used placeholder ATC_vet codes (start \"Q\"). ... Arguments pass atc_property.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Options argument administration: \"Implant\" = Implant \"Inhal\" = Inhalation \"Instill\" = Instillation \"N\" = nasal \"O\" = oral \"P\" = parenteral \"R\" = rectal \"SL\" = sublingual/buccal \"TD\" = transdermal \"V\" = vaginal Abbreviations return values using property = \"U\" (unit): \"g\" = gram \"mg\" = milligram \"mcg\" = microgram \"U\" = unit \"TU\" = thousand units \"MU\" = million units \"mmol\" = millimole \"ml\" = millilitre (e.g. eyedrops) N.B. function requires internet connection works following packages installed: curl, rvest, xml2.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"# \\donttest{ if (requireNamespace(\"curl\") && requireNamespace(\"rvest\") && requireNamespace(\"xml2\")) {   # oral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"O\")   atc_online_ddd(ab_atc(\"amox\"))    # parenteral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"P\")    atc_online_property(\"J01CA04\", property = \"groups\") # search hierarchical groups of amoxicillin } #> Loading required namespace: rvest #> [1] \"ANTIINFECTIVES FOR SYSTEMIC USE\"         #> [2] \"ANTIBACTERIALS FOR SYSTEMIC USE\"         #> [3] \"BETA-LACTAM ANTIBACTERIALS, PENICILLINS\" #> [4] \"Penicillins with extended spectrum\"      # }"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Use function e.g. clinical texts health care records. returns list antiviral drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_av = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_av type = \"drug\": column name antivirals data set translate antibiotic abbreviations , using av_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .av().","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"function also internally used .av(), although searches first drug name throw note drug names returned. Note: .av() function may use long regular expression match brand names antiviral drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"default, function search antiviral drug names. text elements searched official names, ATC codes brand names. uses .av() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(avx = av_from_text(clinical_text)) returned AV codes can transformed official names, groups, etc. av_* functions av_name() av_group(), using translate_av argument. using collapse, function return character:df %>% mutate(avx = av_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(\"28/03/2020 valaciclovir po tid\") #> [[1]] #> Class 'av' #> [1] VALA #>  av_from_text(\"28/03/2020 valaciclovir po tid\", type = \"admin\") #> [[1]] #> [1] \"oral\" #>"},{"path":"https://amr-for-r.org/reference/av_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antiviral Drug — av_property","title":"Get Properties of an Antiviral Drug — av_property","text":"Use functions return specific property antiviral drug antivirals data set. input values evaluated internally .av().","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"av_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  av_cid(x, ...)  av_synonyms(x, ...)  av_tradenames(x, ...)  av_group(x, language = get_AMR_locale(), ...)  av_atc(x, ...)  av_loinc(x, ...)  av_ddd(x, administration = \"oral\", ...)  av_ddd_units(x, administration = \"oral\", ...)  av_info(x, language = get_AMR_locale(), ...)  av_url(x, open = FALSE, ...)  av_property(x, property = \"name\", language = get_AMR_locale(), ...)"},{"path":"https://amr-for-r.org/reference/av_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antiviral Drug — av_property","text":"x (vector ) text can coerced valid antiviral drug code .av(). language Language returned text - default system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. ... arguments passed .av(). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antivirals data set: vector_or(colnames(antivirals), sort = FALSE).","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antiviral Drug — av_property","text":"integer case av_cid() named list case av_info() multiple av_atc()/av_synonyms()/av_tradenames() double case av_ddd() character cases","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antiviral Drug — av_property","text":"output translated possible. function av_url() return direct URL official website. warning returned required ATC code available.","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antiviral Drug — av_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antiviral Drug — av_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"# all properties: av_name(\"ACI\") #> [1] \"Aciclovir\" av_atc(\"ACI\") #> [1] \"J05AB01\" av_cid(\"ACI\") #> [1] 135398513 av_synonyms(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_tradenames(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_group(\"ACI\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_url(\"ACI\") #>                                                              Aciclovir  #> \"https://atcddd.fhi.no/atc_ddd_index/?code=J05AB01&showdescription=no\"   # lowercase transformation av_name(x = c(\"ACI\", \"VALA\")) #> [1] \"Aciclovir\"    \"Valaciclovir\" av_name(x = c(\"ACI\", \"VALA\"), tolower = TRUE) #> [1] \"aciclovir\"    \"valaciclovir\"  # defined daily doses (DDD) av_ddd(\"ACI\", \"oral\") #> [1] 4 av_ddd_units(\"ACI\", \"oral\") #> [1] \"g\" av_ddd(\"ACI\", \"iv\") #> [1] 4 av_ddd_units(\"ACI\", \"iv\") #> [1] \"g\"  av_info(\"ACI\") # all properties as a list #> $av #> [1] \"ACI\" #>  #> $cid #> [1] 135398513 #>  #> $name #> [1] \"Aciclovir\" #>  #> $group #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" #>  #> $atc #> [1] \"J05AB01\" #>  #> $tradenames #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            #>  #> $loinc #> [1] \"\" #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 4 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 4 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all av_* functions use as.av() internally, so you can go from 'any' to 'any': av_atc(\"ACI\") #> [1] \"J05AB01\" av_group(\"J05AB01\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_loinc(\"abacavir\") #> [1] \"29113-8\" \"30273-7\" \"30287-7\" \"30303-2\" \"78772-1\" \"78773-9\" \"79134-3\" #> [8] \"80118-3\" av_name(\"29113-8\") #> [1] \"Abacavir\" av_name(135398513) #> [1] \"Aciclovir\" av_name(\"J05AB01\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/availability.html","id":null,"dir":"Reference","previous_headings":"","what":"Check Availability of Columns — availability","title":"Check Availability of Columns — availability","text":"Easy check data availability columns data set. makes easy get idea antimicrobial combinations can used calculation e.g. susceptibility() resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check Availability of Columns — availability","text":"","code":"availability(tbl, width = NULL)"},{"path":"https://amr-for-r.org/reference/availability.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check Availability of Columns — availability","text":"tbl data.frame list. width Number characters present visual availability - default filling width console.","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check Availability of Columns — availability","text":"data.frame column names tbl row names","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check Availability of Columns — availability","text":"function returns data.frame columns \"resistant\" \"visual_resistance\". values columns calculated resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check Availability of Columns — availability","text":"","code":"availability(example_isolates) #>         count available     visual_availabilty resistant      visual_resistance #> date     2000    100.0% |####################|                                  #> patient  2000    100.0% |####################|                                  #> age      2000    100.0% |####################|                                  #> gender   2000    100.0% |####################|                                  #> ward     2000    100.0% |####################|                                  #> mo       2000    100.0% |####################|                                  #> PEN      1629     81.5% |################----|     73.7% |##############------| #> OXA       365     18.3% |###-----------------|     31.2% |######--------------| #> FLC       943     47.2% |#########-----------|     29.5% |#####---------------| #> AMX      1350     67.5% |#############-------|     59.6% |###########---------| #> AMC      1879     94.0% |##################--|     23.7% |####----------------| #> AMP      1350     67.5% |#############-------|     59.6% |###########---------| #> TZP      1001     50.0% |##########----------|     12.6% |##------------------| #> CZO       446     22.3% |####----------------|     44.6% |########------------| #> FEP       724     36.2% |#######-------------|     14.2% |##------------------| #> CXM      1789     89.5% |#################---|     26.3% |#####---------------| #> FOX       818     40.9% |########------------|     27.4% |#####---------------| #> CTX       943     47.2% |#########-----------|     15.5% |###-----------------| #> CAZ      1811     90.6% |##################--|     66.5% |#############-------| #> CRO       943     47.2% |#########-----------|     15.5% |###-----------------| #> GEN      1855     92.8% |##################--|     24.6% |####----------------| #> TOB      1351     67.6% |#############-------|     34.4% |######--------------| #> AMK       692     34.6% |######--------------|     63.7% |############--------| #> KAN       471     23.6% |####----------------|    100.0% |####################| #> TMP      1499     75.0% |###############-----|     38.1% |#######-------------| #> SXT      1759     88.0% |#################---|     20.5% |####----------------| #> NIT       743     37.2% |#######-------------|     17.1% |###-----------------| #> FOS       351     17.6% |###-----------------|     42.2% |########------------| #> LNZ      1023     51.2% |##########----------|     69.3% |#############-------| #> CIP      1409     70.5% |#############-------|     16.2% |###-----------------| #> MFX       211     10.6% |##------------------|     33.6% |######--------------| #> VAN      1861     93.1% |##################--|     38.3% |#######-------------| #> TEC       976     48.8% |#########-----------|     75.7% |###############-----| #> TCY      1200     60.0% |###########---------|     29.8% |#####---------------| #> TGC       798     39.9% |########------------|     12.7% |##------------------| #> DOX      1136     56.8% |###########---------|     27.7% |#####---------------| #> ERY      1894     94.7% |##################--|     57.2% |###########---------| #> CLI      1520     76.0% |###############-----|     61.2% |############--------| #> AZM      1894     94.7% |##################--|     57.2% |###########---------| #> IPM       889     44.5% |########------------|      6.2% |#-------------------| #> MEM       829     41.5% |########------------|      5.9% |#-------------------| #> MTR        34      1.7% |--------------------|     14.7% |##------------------| #> CHL       154      7.7% |#-------------------|     21.4% |####----------------| #> COL      1640     82.0% |################----|     81.2% |################----| #> MUP       270     13.5% |##------------------|      5.9% |#-------------------| #> RIF      1003     50.2% |##########----------|     69.6% |#############-------| # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     select_if(is.sir) %>%     availability() } #>     count available       visual_availabilty resistant        visual_resistance #> PEN   467    100.0% |######################|    100.0% |######################| #> OXA     0      0.0% |----------------------|                                    #> FLC     0      0.0% |----------------------|                                    #> AMX   392     83.9% |##################----|     50.0% |###########-----------| #> AMC   467    100.0% |######################|     13.1% |##--------------------| #> AMP   392     83.9% |##################----|     50.0% |###########-----------| #> TZP   416     89.1% |###################---|      5.5% |#---------------------| #> CZO    82     17.6% |###-------------------|      2.4% |----------------------| #> FEP   317     67.9% |##############--------|      2.8% |----------------------| #> CXM   465     99.6% |######################|      5.4% |#---------------------| #> FOX   377     80.7% |#################-----|      6.9% |#---------------------| #> CTX   459     98.3% |#####################-|      2.4% |----------------------| #> CAZ   460     98.5% |#####################-|      2.4% |----------------------| #> CRO   459     98.3% |#####################-|      2.4% |----------------------| #> GEN   460     98.5% |#####################-|      2.0% |----------------------| #> TOB   462     98.9% |#####################-|      2.6% |----------------------| #> AMK   171     36.6% |########--------------|      0.0% |----------------------| #> KAN     0      0.0% |----------------------|                                    #> TMP   396     84.8% |##################----|     39.1% |########--------------| #> SXT   465     99.6% |######################|     31.6% |######----------------| #> NIT   458     98.1% |#####################-|      2.8% |----------------------| #> FOS    61     13.1% |##--------------------|      0.0% |----------------------| #> LNZ   467    100.0% |######################|    100.0% |######################| #> CIP   456     97.6% |#####################-|     12.5% |##--------------------| #> MFX    57     12.2% |##--------------------|    100.0% |######################| #> VAN   467    100.0% |######################|    100.0% |######################| #> TEC   467    100.0% |######################|    100.0% |######################| #> TCY     3      0.6% |----------------------|     66.7% |##############--------| #> TGC    68     14.6% |###-------------------|      0.0% |----------------------| #> DOX     0      0.0% |----------------------|                                    #> ERY   467    100.0% |######################|    100.0% |######################| #> CLI   467    100.0% |######################|    100.0% |######################| #> AZM   467    100.0% |######################|    100.0% |######################| #> IPM   422     90.4% |###################---|      0.0% |----------------------| #> MEM   418     89.5% |###################---|      0.0% |----------------------| #> MTR     2      0.4% |----------------------|      0.0% |----------------------| #> CHL     0      0.0% |----------------------|                                    #> COL   240     51.4% |###########-----------|      0.0% |----------------------| #> MUP     0      0.0% |----------------------|                                    #> RIF   467    100.0% |######################|    100.0% |######################| # }"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Bug-Drug Combinations — bug_drug_combinations","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"Determine antimicrobial resistance (AMR) bug-drug combinations data set least 30 (default) isolates available per species. Use format() result prettify publishable/printable format, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"bug_drug_combinations(x, col_mo = NULL, FUN = mo_shortname,   include_n_rows = FALSE, ...)  # S3 method for class 'bug_drug_combinations' format(x, translate_ab = \"name (ab, atc)\",   language = get_AMR_locale(), minimum = 30, combine_SI = TRUE,   add_ab_group = TRUE, remove_intrinsic_resistant = FALSE,   decimal.mark = getOption(\"OutDec\"), big.mark = ifelse(decimal.mark ==   \",\", \".\", \",\"), ...)"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). FUN function call mo column transform microorganism codes - default mo_shortname(). include_n_rows logical indicate total number rows must included output. ... Arguments passed FUN. translate_ab character length 1 containing column names antimicrobials data set. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, summed, resistance based R - default TRUE. add_ab_group logical indicate group antimicrobials must included first column. remove_intrinsic_resistant logical indicate rows columns 100% resistance tested antimicrobials must removed table. decimal.mark character used indicate numeric     decimal point. big.mark character; empty used mark every     big.interval decimals (hence big)     decimal point.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function bug_drug_combinations() returns data.frame columns \"mo\", \"ab\", \"S\", \"SDD\", \"\", \"R\", \"total\".","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function format() calculates resistance per bug-drug combination returns table ready reporting/publishing. Use combine_SI = TRUE (default) test R vs. S+combine_SI = FALSE test R+vs. S. table can also directly used R Markdown / Quarto without need e.g. knitr::kable().","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ x <- bug_drug_combinations(example_isolates) head(x) #> # A tibble: 6 × 8 #>   mo                ab        S   SDD     I     R    NI total #>   <chr>             <chr> <int> <int> <int> <int> <int> <int> #> 1 (unknown species) AMC      15     0     0     0     0    15 #> 2 (unknown species) AMK       0     0     0     0     0     0 #> 3 (unknown species) AMP      15     0     0     1     0    16 #> 4 (unknown species) AMX      15     0     0     1     0    16 #> 5 (unknown species) AZM       3     0     0     3     0     6 #> 6 (unknown species) CAZ       0     0     0     0     0     0 #> Use 'format()' on this result to get a publishable/printable format. format(x, translate_ab = \"name (atc)\") #> # A tibble: 39 × 12 #>    Group     Drug  CoNS  `E. coli` `E. faecalis` `K. pneumoniae` `P. aeruginosa` #>    <chr>     <chr> <chr> <chr>     <chr>         <chr>           <chr>           #>  1 \"Aminogl… Amik… \"100… \"  0.0% … \"100.0% (39/… \"\"              \"\"              #>  2 \"\"        Gent… \" 13… \"  2.0% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  3 \"\"        Kana… \"100… \"\"        \"100.0% (39/… \"\"              \"100.0% (30/30… #>  4 \"\"        Tobr… \" 78… \"  2.6% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  5 \"Antimyc… Rifa… \"\"    \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  6 \"Beta-la… Amox… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  7 \"\"        Amox… \" 42… \" 13.1% … \"\"            \" 10.3% (6/58)\" \"100.0% (30/30… #>  8 \"\"        Ampi… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  9 \"\"        Benz… \" 77… \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> 10 \"\"        Fluc… \" 42… \"\"        \"\"            \"\"              \"\"              #> # ℹ 29 more rows #> # ℹ 5 more variables: `P. mirabilis` <chr>, `S. aureus` <chr>, #> #   `S. epidermidis` <chr>, `S. hominis` <chr>, `S. pneumoniae` <chr>  # Use FUN to change to transformation of microorganism codes bug_drug_combinations(example_isolates,   FUN = mo_gramstain ) #> # A tibble: 80 × 8 #>    mo            ab        S   SDD     I     R    NI total #>    <chr>         <chr> <int> <int> <int> <int> <int> <int> #>  1 Gram-negative AMC     463     0    89   174     0   726 #>  2 Gram-negative AMK     251     0     0     5     0   256 #>  3 Gram-negative AMP     226     0     0   405     0   631 #>  4 Gram-negative AMX     226     0     0   405     0   631 #>  5 Gram-negative AZM       1     0     2   696     0   699 #>  6 Gram-negative CAZ     607     0     0    27     0   634 #>  7 Gram-negative CHL       1     0     0    30     0    31 #>  8 Gram-negative CIP     610     0    11    63     0   684 #>  9 Gram-negative CLI      18     0     1   709     0   728 #> 10 Gram-negative COL     309     0     0    78     0   387 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format.  bug_drug_combinations(example_isolates,   FUN = function(x) {     ifelse(x == as.mo(\"Escherichia coli\"),       \"E. coli\",       \"Others\"     )   } ) #> # A tibble: 80 × 8 #>    mo      ab        S   SDD     I     R    NI total #>    <chr>   <chr> <int> <int> <int> <int> <int> <int> #>  1 E. coli AMC     332     0    74    61     0   467 #>  2 E. coli AMK     171     0     0     0     0   171 #>  3 E. coli AMP     196     0     0   196     0   392 #>  4 E. coli AMX     196     0     0   196     0   392 #>  5 E. coli AZM       0     0     0   467     0   467 #>  6 E. coli CAZ     449     0     0    11     0   460 #>  7 E. coli CHL       0     0     0     0     0     0 #>  8 E. coli CIP     398     0     1    57     0   456 #>  9 E. coli CLI       0     0     0   467     0   467 #> 10 E. coli COL     240     0     0     0     0   240 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format. # }"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Data set containing clinical breakpoints interpret MIC disk diffusion SIR values, according international guidelines. dataset contain breakpoints humans, 7 different animal groups, ECOFFs. breakpoints currently implemented: clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. Use .sir() transform MICs disks measurements SIR values.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"tibble 40 217 observations 14 variables: guideline Name guideline type Breakpoint type, either \"ECOFF\", \"animal\", \"human\" host Host infectious agent. mostly useful veterinary breakpoints either \"ECOFF\", \"aquatic\", \"cats\", \"cattle\", \"dogs\", \"horse\", \"human\", \"poultry\", \"swine\" method Testing method, either \"DISK\" \"MIC\" site Body site breakpoint must applied, e.g. \"Oral\" \"Respiratory\" mo Microbial ID, see .mo() rank_index Taxonomic rank index mo 1 (subspecies/infraspecies) 5 (unknown microorganism) ab Antimicrobial code used package, EARS-Net WHONET, see .ab() ref_tbl Info guideline rule can found disk_dose Dose used disk diffusion method breakpoint_S Lowest MIC value highest number millimetres leads \"S\" breakpoint_R Highest MIC value lowest number millimetres leads \"R\", can NA uti logical value (TRUE/FALSE) indicate whether rule applies urinary tract infection (UTI) is_SDD logical value (TRUE/FALSE) indicate whether intermediate range \"S\" \"R\" interpreted \"SDD\", instead \"\". currently applies 48 breakpoints.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"different-types-of-breakpoints","dir":"Reference","previous_headings":"","what":"Different Types of Breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Supported types breakpoints ECOFF, animal, human. ECOFF (Epidemiological cut-) values used antimicrobial susceptibility testing differentiate wild-type non-wild-type strains bacteria fungi. default \"human\", can also set package option AMR_breakpoint_type. Use .sir(..., breakpoint_type = ...) interpret raw data using specific breakpoint type, e.g. .sir(..., breakpoint_type = \"ECOFF\") use ECOFFs.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"imported-from-whonet","dir":"Reference","previous_headings":"","what":"Imported From WHONET","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Clinical breakpoints package validated imported WHONET, free desktop Windows application developed supported Collaborating Centre Surveillance Antimicrobial Resistance. can read website. developers WHONET AMR package contact sharing work. highly appreciate great development WHONET software. import reproduction script can found : https://github.com/msberends/AMR/blob/main/data-raw/_reproduction_scripts/reproduction_of_clinical_breakpoints.R.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"response-from-clsi-and-eucast","dir":"Reference","previous_headings":"","what":"Response From CLSI and EUCAST","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"CEO CLSI chairman EUCAST endorsed work public use AMR package (consequently use breakpoints) June 2023, future development distributing clinical breakpoints discussed meeting CLSI, EUCAST, , developers WHONET software, developers AMR package.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-note","dir":"Reference","previous_headings":"","what":"Download Note","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"AMR package (WHONET software well) contains rather complex internal methods apply guidelines. example, breakpoints must applied certain species groups (case package available microorganisms.groups data set). important considered implementing breakpoints use.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints #> # A tibble: 40,217 × 14 #>    guideline   type  host  method site    mo            rank_index ab   ref_tbl  #>    <chr>       <chr> <chr> <chr>  <chr>   <mo>               <dbl> <ab> <chr>    #>  1 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  2 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  3 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  4 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  5 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  6 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  7 EUCAST 2025 human human DISK   NA      B_ACNTB                3 AMK  Acineto… #>  8 EUCAST 2025 human human DISK   Uncomp… B_ACNTB                3 AMK  Acineto… #>  9 EUCAST 2025 human human MIC    NA      B_ACNTB                3 AMK  Acineto… #> 10 EUCAST 2025 human human MIC    Uncomp… B_ACNTB                3 AMK  Acineto… #> # ℹ 40,207 more rows #> # ℹ 5 more variables: disk_dose <chr>, breakpoint_S <dbl>, breakpoint_R <dbl>, #> #   uti <lgl>, is_SDD <lgl>"},{"path":"https://amr-for-r.org/reference/count.html","id":null,"dir":"Reference","previous_headings":"","what":"Count Available Isolates — count","title":"Count Available Isolates — count","text":"functions can used count resistant/susceptible microbial isolates. functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. count_resistant() used count resistant isolates, count_susceptible() used count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Count Available Isolates — count","text":"","code":"count_resistant(..., only_all_tested = FALSE)  count_susceptible(..., only_all_tested = FALSE)  count_S(..., only_all_tested = FALSE)  count_SI(..., only_all_tested = FALSE)  count_I(..., only_all_tested = FALSE)  count_IR(..., only_all_tested = FALSE)  count_R(..., only_all_tested = FALSE)  count_all(..., only_all_tested = FALSE)  n_sir(..., only_all_tested = FALSE)  count_df(data, translate_ab = \"name\", language = get_AMR_locale(),   combine_SI = TRUE)"},{"path":"https://amr-for-r.org/reference/count.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Count Available Isolates — count","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count Available Isolates — count","text":"integer","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Count Available Isolates — count","text":"functions meant count isolates. Use resistance()/susceptibility() functions calculate microbial resistance/susceptibility. function count_resistant() equal function count_R(). function count_susceptible() equal function count_SI(). function n_sir() alias count_all(). can used count available isolates, .e. input antimicrobials available result (S, R). use equal n_distinct(). function equal count_susceptible(...) + count_resistant(...). function count_df() takes variable data sir class (created .sir()) counts number S's, 's R's. also supports grouped variables. function sir_df() works exactly like count_df(), adds percentage S, R.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Count Available Isolates — count","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Count Available Isolates — count","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":[]},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Count Available Isolates — count","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info.  # base R ------------------------------------------------------------ count_resistant(example_isolates$AMX) # counts \"R\" #> [1] 804 count_susceptible(example_isolates$AMX) # counts \"S\" and \"I\" #> [1] 546 count_all(example_isolates$AMX) # counts \"S\", \"I\" and \"R\" #> [1] 1350  # be more specific count_S(example_isolates$AMX) #> [1] 543 count_SI(example_isolates$AMX) #> [1] 546 count_I(example_isolates$AMX) #> [1] 3 count_IR(example_isolates$AMX) #> [1] 807 count_R(example_isolates$AMX) #> [1] 804  # Count all available isolates count_all(example_isolates$AMX) #> [1] 1350 n_sir(example_isolates$AMX) #> [1] 1350  # n_sir() is an alias of count_all(). # Since it counts all available isolates, you can # calculate back to count e.g. susceptible isolates. # These results are the same: count_susceptible(example_isolates$AMX) #> [1] 546 susceptibility(example_isolates$AMX) * n_sir(example_isolates$AMX) #> [1] 546  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = count_R(CIP),       I = count_I(CIP),       S = count_S(CIP),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Number of available isolates for a whole antibiotic class   # (i.e., in this data set columns GEN, TOB, AMK, KAN)   example_isolates %>%     group_by(ward) %>%     summarise(across(aminoglycosides(), n_sir))    # Count co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy.   # Please mind that `susceptibility()` calculates percentages right away instead.   example_isolates %>% count_susceptible(AMC) # 1433   example_isolates %>% count_all(AMC) # 1879    example_isolates %>% count_susceptible(GEN) # 1399   example_isolates %>% count_all(GEN) # 1855    example_isolates %>% count_susceptible(AMC, GEN) # 1764   example_isolates %>% count_all(AMC, GEN) # 1936    # Get number of S+I vs. R immediately of selected columns   example_isolates %>%     select(AMX, CIP) %>%     count_df(translate = FALSE)    # It also supports grouping variables   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     count_df(translate = FALSE) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 12 × 4 #>    ward       antibiotic interpretation value #>    <chr>      <chr>      <ord>          <int> #>  1 Clinical   AMX        SI               357 #>  2 Clinical   AMX        R                487 #>  3 Clinical   CIP        SI               741 #>  4 Clinical   CIP        R                128 #>  5 ICU        AMX        SI               158 #>  6 ICU        AMX        R                270 #>  7 ICU        CIP        SI               362 #>  8 ICU        CIP        R                 85 #>  9 Outpatient AMX        SI                31 #> 10 Outpatient AMX        R                 47 #> 11 Outpatient CIP        SI                78 #> 12 Outpatient CIP        R                 15 # }"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom EUCAST Rules — custom_eucast_rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"Define custom EUCAST rules organisation specific analysis use output function eucast_rules().","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"custom_eucast_rules(...)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"... Rules formula notation, see instructions, Examples.","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"organisations adoption EUCAST rules. function can used define custom EUCAST rules used eucast_rules() function.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   two custom EUCAST rules: TZP (piperacillin/tazobactam) \"S\", aminopenicillins (ampicillin amoxicillin) must made \"S\", TZP \"R\", aminopenicillins must made \"R\". rules can also printed console, immediately clear work:   rules (part tilde, example TZP == \"S\" TZP == \"R\") must evaluable data set: able run filter data set without errors. means example column TZP must exist. create sample data set test rules set:","code":"x <- custom_eucast_rules(TZP == \"S\" ~ aminopenicillins == \"S\",                          TZP == \"R\" ~ aminopenicillins == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"S\" then set to  S : #>      amoxicillin (AMX), ampicillin (AMP) #> #>   2. If TZP is \"R\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) df <- data.frame(mo = c(\"Escherichia coli\", \"Klebsiella pneumoniae\"),                  TZP = as.sir(\"R\"),                  ampi = as.sir(\"S\"),                  cipro = as.sir(\"S\")) df #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    S     S  eucast_rules(df, rules = \"custom\", custom_rules = x, info = FALSE, overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    R     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"using-taxonomic-properties-in-rules","dir":"Reference","previous_headings":"","what":"Using taxonomic properties in rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"one exception columns used rules: column names microorganisms data set can also used, exist data set. column names : \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Thus, next example work well, despite fact df data set contain column genus:","code":"y <- custom_eucast_rules(TZP == \"S\" & genus == \"Klebsiella\" ~ aminopenicillins == \"S\",                          TZP == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\")  eucast_rules(df, rules = \"custom\", custom_rules = y, info = FALSE, overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"usage-of-multiple-antimicrobials-and-antimicrobial-group-names","dir":"Reference","previous_headings":"","what":"Usage of multiple antimicrobials and antimicrobial group names","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"can define antimicrobial groups instead single antimicrobials rule consequence, part tilde (~). examples , antimicrobial group aminopenicillins includes ampicillin amoxicillin. Rules can also applied multiple antimicrobials antimicrobial groups simultaneously. Use c() function combine multiple antimicrobials. instance, following example sets aminopenicillins ureidopenicillins \"R\" column TZP (piperacillin/tazobactam) \"R\":   35 antimicrobial groups allowed rules (case-insensitive) can used combination: aminoglycosides(amikacin, amikacin/fosfomycin, apramycin, arbekacin, astromicin, bekanamycin, dibekacin, framycetin, gentamicin, gentamicin-high, habekacin, hygromycin, isepamicin, kanamycin, kanamycin-high, kanamycin/cephalexin, micronomicin, neomycin, netilmicin, pentisomicin, plazomicin, propikacin, ribostamycin, sisomicin, streptoduocin, streptomycin, streptomycin-high, tobramycin, tobramycin-high) aminopenicillins(amoxicillin ampicillin) antifungals(amorolfine, amphotericin B, amphotericin B-high, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole) antimycobacterials(4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin) betalactams(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, biapenem, carbenicillin, carindacillin, carumonam, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, ciclacillin, clometocillin, cloxacillin, dicloxacillin, doripenem, epicillin, ertapenem, flucloxacillin, hetacillin, imipenem, imipenem/EDTA, imipenem/relebactam, latamoxef, lenampicillin, loracarbef, mecillinam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, tebipenem, temocillin, ticarcillin, ticarcillin/clavulanic acid, tigemonam) betalactams_with_inhibitor(amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin/sulbactam, aztreonam/avibactam, aztreonam/nacubactam, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefoperazone/sulbactam, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefpodoxime/clavulanic acid, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, ceftolozane/tazobactam, ceftriaxone/beta-lactamase inhibitor, imipenem/relebactam, meropenem/nacubactam, meropenem/vaborbactam, mezlocillin/sulbactam, penicillin/novobiocin, penicillin/sulbactam, piperacillin/sulbactam, piperacillin/tazobactam, ticarcillin/clavulanic acid) carbapenems(biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem) cephalosporins(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) cephalosporins_1st(cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine) cephalosporins_2nd(cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef) cephalosporins_3rd(cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefetamet, cefetamet pivoxil, cefixime, cefmenoxime, cefodizime, cefoperazone, cefoperazone/sulbactam, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotiam hexetil, cefovecin, cefpimizole, cefpiramide, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefsulodin, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, latamoxef) cephalosporins_4th(cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome) cephalosporins_5th(ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam) cephalosporins_except_caz(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) fluoroquinolones(besifloxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, pazufloxacin, pefloxacin, pefloxacin screening test, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) glycopeptides(avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod) glycopeptides_except_lipo(avoparcin, bleomycin, norvancomycin, ramoplanin, teicoplanin, teicoplanin-macromethod, vancomycin, vancomycin-macromethod) isoxazolylpenicillins(cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test) lincosamides(clindamycin, lincomycin, pirlimycin) lipoglycopeptides(dalbavancin, oritavancin, telavancin) macrolides(acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin) monobactams(aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam) nitrofurans(furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone) oxazolidinones(cadazolid, cycloserine, linezolid, tedizolid, thiacetazone) penicillins(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, carbenicillin, carindacillin, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, temocillin, ticarcillin, ticarcillin/clavulanic acid) phenicols(chloramphenicol, florfenicol, thiamphenicol) polymyxins(colistin, polymyxin B, polymyxin B/polysorbate 80) quinolones(besifloxacin, cinoxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nalidixic acid screening test, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pefloxacin screening test, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) rifamycins(rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine) streptogramins(pristinamycin quinupristin/dalfopristin) sulfonamides(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea) tetracyclines(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline) tetracyclines_except_tgc(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test) trimethoprims(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadiazine/trimethoprim, sulfadimethoxine, sulfadimidine, sulfadimidine/trimethoprim, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamerazine/trimethoprim, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfametrole/trimethoprim, sulfamoxole, sulfamoxole/trimethoprim, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea, trimethoprim, trimethoprim/sulfamethoxazole) ureidopenicillins(azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam)","code":"x <- custom_eucast_rules(TZP == \"R\" ~ c(aminopenicillins, ureidopenicillins) == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"R\" then set to \"R\": #>      amoxicillin (AMX), ampicillin (AMP), azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"x <- custom_eucast_rules(   AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",   AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\" ) x #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP)  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): eucast_rules(example_isolates,   rules = \"custom\",   custom_rules = x,   info = FALSE,   overwrite = TRUE,   verbose = TRUE ) #> # A tibble: 8 × 9 #>     row col   mo_fullname     old   new   rule  rule_group rule_name rule_source #>   <int> <chr> <chr>           <ord> <chr> <chr> <chr>      <chr>     <chr>       #> 1    33 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 2    33 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 3    34 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 4    34 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 5   531 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 6   531 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 7  1485 AMP   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 8  1485 AMX   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'…  # combine rule sets x2 <- c(   x,   custom_eucast_rules(TZP == \"R\" ~ carbapenems == \"R\") ) x2 #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   3. If TZP is  R  then set to  R : #>      biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), #>      imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), #>      meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), #>      razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP)"},{"path":"https://amr-for-r.org/reference/dosage.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"EUCAST breakpoints used package based dosages data set. can retrieved eucast_dosage().","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage"},{"path":"https://amr-for-r.org/reference/dosage.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"tibble 759 observations 9 variables: ab Antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available name Official name antimicrobial drug used WHONET/EARS-Net type Type dosage, either \"high_dosage\", \"standard_dosage\", \"uncomplicated_uti\" dose Dose, \"2 g\" \"25 mg/kg\" dose_times Number times dose must administered administration Route administration, either \"\", \"im\", \"iv\", \"oral\" notes Additional dosage notes original_txt Original text PDF file EUCAST eucast_version Version number EUCAST Clinical Breakpoints guideline dosages apply, either 15, 14, 13.1, 12, 11","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage #> # A tibble: 759 × 9 #>    ab   name            type  dose  dose_times administration notes original_txt #>    <ab> <chr>           <chr> <chr>      <int> <chr>          <chr> <chr>        #>  1 AMK  Amikacin        stan… 25-3…          1 iv             \"\"    \"25-30 mg/k… #>  2 AMX  Amoxicillin     high… 2 g            6 iv             \"\"    \"2 g x 6 iv\" #>  3 AMX  Amoxicillin     stan… 1 g            3 iv             \"\"    \"1 g x 3-4 … #>  4 AMX  Amoxicillin     high… 0.75…          3 oral           \"\"    \"0.75-1 g x… #>  5 AMX  Amoxicillin     stan… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  6 AMX  Amoxicillin     unco… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  7 AMC  Amoxicillin/cl… high… 2 g …          3 iv             \"\"    \"(2 g amoxi… #>  8 AMC  Amoxicillin/cl… stan… 1 g …          3 iv             \"\"    \"(1 g amoxi… #>  9 AMC  Amoxicillin/cl… high… 0.87…          3 oral           \"\"    \"(0.875 g a… #> 10 AMC  Amoxicillin/cl… stan… 0.5 …          3 oral           \"\"    \"(0.5 g amo… #> # ℹ 749 more rows #> # ℹ 1 more variable: eucast_version <dbl>"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply EUCAST Rules — eucast_rules","title":"Apply EUCAST Rules — eucast_rules","text":"Apply rules clinical breakpoints notes expected resistant phenotypes defined European Committee Antimicrobial Susceptibility Testing (EUCAST, https://www.eucast.org), see Source. Use eucast_dosage() get data.frame advised dosages certain bug-drug combination, based dosage data set. improve interpretation antibiogram EUCAST rules applied, non-EUCAST rules can applied default, see Details.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"eucast_rules(x, col_mo = NULL, info = interactive(),   rules = getOption(\"AMR_eucastrules\", default = c(\"breakpoints\",   \"expected_phenotypes\")), verbose = FALSE, version_breakpoints = 15,   version_expected_phenotypes = 1.2, version_expertrules = 3.3,   ampc_cephalosporin_resistance = NA, only_sir_columns = FALSE,   custom_rules = NULL, overwrite = FALSE, ...)  eucast_dosage(ab, administration = \"iv\", version_breakpoints = 15)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Apply EUCAST Rules — eucast_rules","text":"EUCAST Expert Rules. Version 2.0, 2012. Leclercq et al. EUCAST expert rules antimicrobial susceptibility testing. Clin Microbiol Infect. 2013;19(2):141-60; doi:10.1111/j.1469-0691.2011.03703.x EUCAST Expert Rules, Intrinsic Resistance Exceptional Phenotypes Tables. Version 3.1, 2016. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.2, 2020. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.3, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 9.0, 2019. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 10.0, 2020. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 11.0, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 12.0, 2022. (link)","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply EUCAST Rules — eucast_rules","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). info logical indicate whether progress printed console - default print interactive sessions. rules character vector specifies rules applied. Must one \"breakpoints\", \"expected_phenotypes\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expected_phenotypes\"). default value can set another value using package option AMR_eucastrules: options(AMR_eucastrules = \"\"). using \"custom\", sure fill argument custom_rules . Custom rules can created custom_eucast_rules(). verbose logical turn Verbose mode (default ). Verbose mode, function apply rules data, instead returns data set logbook form extensive info rows columns effected way. Using Verbose mode takes lot time. version_breakpoints version number use EUCAST Clinical Breakpoints guideline. Can \"15.0\", \"14.0\", \"13.1\", \"12.0\", \"11.0\", \"10.0\". version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\". version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\". ampc_cephalosporin_resistance (applies rules contains \"expert\" \"\") character value applied cefotaxime, ceftriaxone ceftazidime AmpC de-repressed cephalosporin-resistant mutants - default NA. Currently works version_expertrules 3.2 higher; versions 'EUCAST Expert Rules Enterobacterales' state results cefotaxime, ceftriaxone ceftazidime reported note, results suppressed (emptied) three drugs. value NA (default) argument remove results three drugs, e.g. value \"R\" make results drugs resistant. Use NULL FALSE alter results three drugs AmpC de-repressed cephalosporin-resistant mutants. Using TRUE equal using \"R\".  EUCAST Expert Rules v3.2, rule applies : Citrobacter braakii, Citrobacter freundii, Citrobacter gillenii, Citrobacter murliniae, Citrobacter rodenticum, Citrobacter sedlakii, Citrobacter werkmanii, Citrobacter youngae, Enterobacter, Hafnia alvei, Klebsiella aerogenes, Morganella morganii, Providencia, Serratia. only_sir_columns logical indicate whether antimicrobial columns must detected transformed class sir (see .sir()) beforehand (default FALSE). custom_rules Custom rules apply, created custom_eucast_rules(). overwrite logical indicating whether overwrite non-NA values (default: FALSE). FALSE, non-SIR values modified (.e., value already S, R). ensure compliance EUCAST guidelines, remain FALSE, EUCAST notes often state organism \"tested susceptibility individual agents reported resistant\". ... Column name antimicrobial, see section Antimicrobials . ab (vector ) text can coerced valid antimicrobial drug code .ab(). administration Route administration, either \"\", \"im\", \"iv\", \"oral\".","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply EUCAST Rules — eucast_rules","text":"input x, possibly edited values antimicrobials. , verbose = TRUE, data.frame original new values affected bug-drug combinations.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply EUCAST Rules — eucast_rules","text":"Note: function translate MIC values SIR values. Use .sir() . Note: ampicillin (AMP, J01CA01) available amoxicillin (AMX, J01CA04) , latter used rules dependency ampicillin. drugs interchangeable comes expression antimicrobial resistance. file containing EUCAST rules located : https://github.com/msberends/AMR/blob/main/data-raw/eucast_rules.tsv.  Note: Old taxonomic names replaced current taxonomy applicable. example, Ochrobactrum anthropi renamed Brucella anthropi 2020; original EUCAST rules v3.1 v3.2 yet contain new taxonomic name. AMR package contains full microbial taxonomy updated June 24th, 2024, see microorganisms.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"custom-rules","dir":"Reference","previous_headings":"","what":"Custom Rules","title":"Apply EUCAST Rules — eucast_rules","text":"Custom rules can created using custom_eucast_rules(), e.g.:","code":"x <- custom_eucast_rules(AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",                          AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\")  eucast_rules(example_isolates, rules = \"custom\", custom_rules = x)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"-other-rules","dir":"Reference","previous_headings":"","what":"'Other' Rules","title":"Apply EUCAST Rules — eucast_rules","text":"processing, two non-EUCAST rules drug combinations can applied improve efficacy EUCAST rules, reliability data (analysis). rules : drug enzyme inhibitor set S drug without enzyme inhibitor S drug without enzyme inhibitor set R drug enzyme inhibitor R Important examples include amoxicillin amoxicillin/clavulanic acid, trimethoprim trimethoprim/sulfamethoxazole. Needless say, rules work, drugs must available data set. Since rules officially approved EUCAST, applied default. use rules, include \"\" rules argument, use eucast_rules(..., rules = \"\"). can also set package option AMR_eucastrules, .e. run options(AMR_eucastrules = \"\").","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"antimicrobials","dir":"Reference","previous_headings":"","what":"Antimicrobials","title":"Apply EUCAST Rules — eucast_rules","text":"define antimicrobials column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antimicrobials eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), bleomycin (BLM, L01DC01), brodimoprim (BDP, J01EA02), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), carumonam (CAR, J01DF02), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefepime/amikacin (CFA, J01RA06), cefetamet (CAT, J01DD10), cefiderocol (FDC, J01DI04), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), chlortetracycline (CTE, J01AA03), ciprofloxacin (CIP, J01MA02), ciprofloxacin/metronidazole (CIM, J01RA10), ciprofloxacin/ornidazole (CIO, J01RA12), ciprofloxacin/tinidazole (CIT, J01RA11), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), clomocycline (CLM1, J01AA11), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), demeclocycline (DEM, J01AA01), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), eravacycline (ERV, J01AA13), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levofloxacin/ornidazole (LEO, J01RA05), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), lymecycline (LYM, J01AA04), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metacycline (MTC, J01AA05), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), nemonoxacin (NEM, J01MB08), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), nitroxoline (NTR, J01XX07), norfloxacin (, J01MA06), norfloxacin/metronidazole (NME, J01RA14), norfloxacin/tinidazole (NTI, J01RA13), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), ofloxacin/ornidazole (OOR, J01RA09), oleandomycin (OLE, J01FA05), omadacycline (OMC, J01AA15), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), oxytetracycline (OXY, J01AA06), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), penimepicycline (PNM1, J01AA10), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), rolitetracycline (RLT, J01AA09), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sarecycline (SRC, J01AA14), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/tetroxoprim (SLT, J01EE06), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Apply EUCAST Rules — eucast_rules","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"# \\donttest{ a <- data.frame(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylpenicillin   FOX = \"S\", # Cefoxitin   stringsAsFactors = FALSE )  head(a) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   -   -   -   -   S   S #> 2  Enterococcus faecalis   -   -   -   -   -   S   S #> 3       Escherichia coli   -   -   -   -   -   S   S #> 4  Klebsiella pneumoniae   -   -   -   -   -   S   S #> 5 Pseudomonas aeruginosa   -   -   -   -   -   S   S   # apply EUCAST rules: some results wil be changed b <- eucast_rules(a, overwrite = TRUE) #> Warning: in eucast_rules(): not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir))  head(b) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   S   R   R   S   S   S #> 2  Enterococcus faecalis   -   -   R   R   R   S   R #> 3       Escherichia coli   R   -   -   -   -   R   S #> 4  Klebsiella pneumoniae   R   R   -   -   -   R   S #> 5 Pseudomonas aeruginosa   R   R   -   -   R   R   R   # do not apply EUCAST rules, but rather get a data.frame # containing all details about the transformations: c <- eucast_rules(a, overwrite = TRUE, verbose = TRUE) #> Warning: in eucast_rules(): not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir)) head(c) #>   row col           mo_fullname old new rule          rule_group #> 1   1 AMX Staphylococcus aureus   -   S              Breakpoints #> 2   1 CXM Staphylococcus aureus   -   S              Breakpoints #> 3   1 CAZ Staphylococcus aureus   -   R      Expected phenotypes #> 4   1 COL Staphylococcus aureus   -   R      Expected phenotypes #> 5   2 CAZ Enterococcus faecalis   -   R      Expected phenotypes #> 6   2 COL Enterococcus faecalis   -   R      Expected phenotypes #>                                                         rule_name #> 1                                                  Staphylococcus #> 2                                                  Staphylococcus #> 3 Table 4: Expected resistant phenotype in gram-positive bacteria #> 4 Table 4: Expected resistant phenotype in gram-positive bacteria #> 5 Table 4: Expected resistant phenotype in gram-positive bacteria #> 6 Table 4: Expected resistant phenotype in gram-positive bacteria #>                                         rule_source #> 1   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 2   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 3 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 4 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 5 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 6 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 # }  # Dosage guidelines:  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\") #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v15.0 (2025). This note will be shown once per session. #> # A tibble: 3 × 5 #>   ab   name          standard_dosage  high_dosage  eucast_version #>   <ab> <chr>         <chr>            <chr>                 <dbl> #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA                       15 #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA                       15 #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv             15  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\", version_breakpoints = 10) #> # A tibble: 3 × 5 #>   ab   name          standard_dosage high_dosage eucast_version #>   <ab> <chr>         <chr>           <chr>                <dbl> #> 1 TOB  Tobramycin    NA              NA                      NA #> 2 GEN  Gentamicin    NA              NA                      NA #> 3 CIP  Ciprofloxacin NA              NA                      NA"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 2 000 Example Isolates — example_isolates","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"data set containing 2 000 microbial isolates full antibiograms. data set contains randomised fictitious data, reflects reality can used practise AMR data analysis. examples, please read tutorial website.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"tibble 2 000 observations 46 variables: date Date receipt laboratory patient ID patient age Age patient gender Gender patient, either \"F\" \"M\" ward Ward type patient admitted, either \"Clinical\", \"ICU\", \"Outpatient\" mo ID microorganism created .mo(), see also microorganisms data set PEN:RIF 40 different antimicrobials class sir (see .sir()); column names occur antimicrobials data set can translated set_ab_names() ab_name()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Unclean Data — example_isolates_unclean","title":"Data Set with Unclean Data — example_isolates_unclean","text":"data set containing 3 000 microbial isolates cleaned consequently ready AMR data analysis. data set can used practice.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Unclean Data — example_isolates_unclean","text":"tibble 3 000 observations 8 variables: patient_id ID patient date date receipt laboratory hospital ID hospital, C bacteria info microorganism can transformed .mo(), see also microorganisms AMX:GEN 4 different antimicrobials transformed .sir()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Unclean Data — example_isolates_unclean","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":null,"dir":"Reference","previous_headings":"","what":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"Export Data Set NCBI BioSample Antibiogram","code":""},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"","code":"export_ncbi_biosample(x, filename = paste0(\"biosample_\", format(Sys.time(),   \"%Y-%m-%d-%H%M%S\"), \".xlsx\"), type = \"pathogen MIC\",   columns = where(is.mic), save_as_xlsx = TRUE)"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"x data set. filename character string specifying file name. type character string specifying type data set, either \"pathogen MIC\" \"beta-lactamase MIC\", see https://www.ncbi.nlm.nih.gov/biosample/docs/.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine First Isolates — first_isolate","title":"Determine First Isolates — first_isolate","text":"Determine first isolates microorganisms every patient per episode (needed) per specimen type. functions support four methods summarised Hindler et al. 2007 (doi:10.1086/511864 ). determine patient episodes necessarily based microorganisms, use is_new_episode() also supports grouping dplyr package.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine First Isolates — first_isolate","text":"","code":"first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, col_testcode = NULL, col_specimen = NULL,   col_icu = NULL, col_keyantimicrobials = NULL, episode_days = 365,   testcodes_exclude = NULL, icu_exclude = FALSE, specimen_group = NULL,   type = \"points\", method = c(\"phenotype-based\", \"episode-based\",   \"patient-based\", \"isolate-based\"), ignore_I = TRUE, points_threshold = 2,   info = interactive(), include_unknown = FALSE,   include_untested_sir = TRUE, ...)  filter_first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, episode_days = 365, method = c(\"phenotype-based\",   \"episode-based\", \"patient-based\", \"isolate-based\"), ...)"},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine First Isolates — first_isolate","text":"Methodology functions strictly based : M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. Hindler JF Stelling J (2007). Analysis Presentation Cumulative Antibiograms: New Consensus Guideline Clinical Laboratory Standards Institute. Clinical Infectious Diseases, 44(6), 867-873. doi:10.1086/511864","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine First Isolates — first_isolate","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_date Column name result date (date received lab) - default first column date class. col_patient_id Column name unique IDs patients - default first column starts 'patient' 'patid' (case insensitive). col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). col_testcode Column name test codes. Use col_testcode = NULL exclude certain test codes (test codes screening). case testcodes_exclude ignored. col_specimen Column name specimen type group. col_icu Column name logicals (TRUE/FALSE) whether ward department Intensive Care Unit (ICU). can also logical vector length rows x. col_keyantimicrobials (useful method = \"phenotype-based\") column name key antimicrobials determine first isolates, see key_antimicrobials(). default first column starts 'key' followed 'ab' 'antibiotics' 'antimicrobials' (case insensitive). Use col_keyantimicrobials = FALSE prevent . Can also output key_antimicrobials(). episode_days Episode days genus/species combination determined 'first isolate' . default 365 days based guideline CLSI, see Source. testcodes_exclude character vector test codes excluded (case-insensitive). icu_exclude logical indicate whether ICU isolates excluded (rows value TRUE column set col_icu). specimen_group Value column set col_specimen filter . type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. method method apply, either \"phenotype-based\", \"episode-based\", \"patient-based\" \"isolate-based\" (can abbreviated), see Details. default \"phenotype-based\" antimicrobial test results present data, \"episode-based\" otherwise. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details. info logical indicate info printed - default TRUE interactive mode. include_unknown logical indicate whether 'unknown' microorganisms included , .e. microbial code \"UNKNOWN\", defaults FALSE. WHONET users, means records organism code \"con\" (contamination) excluded default. Isolates microbial ID NA always excluded first isolate. include_untested_sir logical indicate whether also rows without antibiotic results still eligible becoming first isolate. Use include_untested_sir = FALSE always return FALSE rows. checks data set columns class sir consequently requires transforming columns antibiotic results using .sir() first. ... Arguments passed first_isolate() using filter_first_isolate(), otherwise arguments passed key_antimicrobials() (universal, gram_negative, gram_positive).","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine First Isolates — first_isolate","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine First Isolates — first_isolate","text":"methodology implemented functions strictly based recommendations outlined CLSI Guideline M39 research overview Hindler et al. (2007, doi:10.1086/511864 ). conduct epidemiological analyses antimicrobial resistance data, -called first isolates included prevent overestimation underestimation antimicrobial resistance. Different methods can used , see . functions context-aware. means x argument can left blank used inside data.frame call, see Examples. first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names. isolates microbial ID NA excluded first isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"different-methods","dir":"Reference","previous_headings":"","what":"Different methods","title":"Determine First Isolates — first_isolate","text":"According previously-mentioned sources, different methods (algorithms) select first isolates increasing reliability: isolate-based, patient-based, episode-based phenotype-based. methods select combination taxonomic genus species (subspecies). mentioned methods covered first_isolate() function:","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"isolate-based","dir":"Reference","previous_headings":"","what":"Isolate-based","title":"Determine First Isolates — first_isolate","text":"method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"patient-based","dir":"Reference","previous_headings":"","what":"Patient-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient , set episode_days Inf. method makes sure duplicate isolates selected patient. method preferred e.g. identify first MRSA finding patient determine incidence. Conversely, large longitudinal data set, mean isolates excluded found years initial isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"episode-based","dir":"Reference","previous_headings":"","what":"Episode-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, 14, 30, 60 365. Short episodes common analysing specific hospital ward data ICU cases, long episodes common analysing regional national data. common method correct duplicate isolates. Patients categorised episodes based ID dates (e.g., date specimen receipt laboratory result). common method, take account antimicrobial test results. means e.g. methicillin-resistant Staphylococcus aureus (MRSA) isolate differentiated wildtype Staphylococcus aureus isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"phenotype-based","dir":"Reference","previous_headings":"","what":"Phenotype-based","title":"Determine First Isolates — first_isolate","text":"reliable method, since also weighs antibiogram (antimicrobial test results) yielding -called 'first weighted isolates'. two different methods weigh antibiogram: Using type = \"points\" argument points_threshold (default) method weighs antimicrobial drugs available data set. difference S R (vice versa) counts 0.5 points, difference S R (vice versa) counts 1 point. sum points exceeds points_threshold, defaults 2, isolate selected first weighted isolate. antimicrobials internally selected using all_antimicrobials() function. output function need passed first_isolate() function. Using type = \"keyantimicrobials\" argument ignore_I method weighs specific antimicrobial drugs, called key antimicrobials. difference S R (vice versa) key antimicrobials select isolate first weighted isolate. ignore_I = FALSE, also differences S R (vice versa) lead . Key antimicrobials internally selected using key_antimicrobials() function, can also added manually variable data set col_keyantimicrobials argument. Another option pass output key_antimicrobials() function directly col_keyantimicrobials argument. default method phenotype-based (using type = \"points\") episode-based (using episode_days = 365). makes sure every genus-species combination selected per patient per year, taking account antimicrobial test results. antimicrobial test results available data set, episode-based method applied default.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine First Isolates — first_isolate","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  example_isolates[first_isolate(info = TRUE), ] #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'date' as input for col_date. #> ℹ Using column 'patient' as input for col_patient_id. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # \\donttest{ # get all first Gram-negatives example_isolates[which(first_isolate(info = FALSE) & mo_is_gram_negative()), ] #> ℹ Using column 'mo' as input for mo_is_gram_negative() #> # A tibble: 441 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  7 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #>  8 2002-03-16 4FC193     69 M      Clinical B_PSDMN_AERG   R     NA    NA    R   #>  9 2002-04-01 496896     46 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> 10 2002-04-23 EE2510     69 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> # ℹ 431 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   # filter on first isolates using dplyr:   example_isolates %>%     filter(first_isolate(info = TRUE)) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # short-hand version:   example_isolates %>%     filter_first_isolate(info = FALSE) } #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # flag the first isolates per group:   example_isolates %>%     group_by(ward) %>%     mutate(first = first_isolate(info = TRUE)) %>%     select(ward, date, patient, mo, first) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #>  #> Group: ward = \"Clinical\" #> ℹ Excluding 9 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 865 'phenotype-based' first isolates (70.1% of total where a #>    microbial ID was available) #>  #> Group: ward = \"ICU\" #> ℹ Excluding 6 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 452 'phenotype-based' first isolates (70.0% of total where a #>    microbial ID was available) #>  #> Group: ward = \"Outpatient\" #> ℹ Excluding 1 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 99 'phenotype-based' first isolates (82.5% of total where a #>    microbial ID was available) #> # A tibble: 2,000 × 5 #> # Groups:   ward [3] #>    ward     date       patient mo           first #>    <chr>    <date>     <chr>   <mo>         <lgl> #>  1 Clinical 2002-01-02 A77334  B_ESCHR_COLI TRUE  #>  2 Clinical 2002-01-03 A77334  B_ESCHR_COLI FALSE #>  3 ICU      2002-01-07 067927  B_STPHY_EPDR TRUE  #>  4 ICU      2002-01-07 067927  B_STPHY_EPDR FALSE #>  5 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  6 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  7 Clinical 2002-01-14 462729  B_STPHY_AURS TRUE  #>  8 Clinical 2002-01-14 462729  B_STPHY_AURS FALSE #>  9 ICU      2002-01-16 067927  B_STPHY_EPDR TRUE  #> 10 ICU      2002-01-17 858515  B_STPHY_EPDR TRUE  #> # ℹ 1,990 more rows # }"},{"path":"https://amr-for-r.org/reference/g.test.html","id":null,"dir":"Reference","previous_headings":"","what":"G-test for Count Data — g.test","title":"G-test for Count Data — g.test","text":"g.test() performs chi-squared contingency table tests goodness--fit tests, just like chisq.test() reliable (1). G-test can used see whether number observations category fits theoretical expectation (called G-test goodness--fit), see whether proportions one variable different different values variable (called G-test independence).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"G-test for Count Data — g.test","text":"","code":"g.test(x, y = NULL, p = rep(1/length(x), length(x)), rescale.p = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"G-test for Count Data — g.test","text":"code function identical chisq.test(), except : calculation statistic changed \\(2 * sum(x * log(x / E))\\) Yates' continuity correction removed apply G-test possibility simulate p values simulate.p.value removed","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"G-test for Count Data — g.test","text":"x numeric vector matrix. x y can also     factors. y numeric vector; ignored x matrix.      x factor, y factor length. p vector probabilities length x.     error given entry p negative. rescale.p logical scalar; TRUE p rescaled     (necessary) sum 1.  rescale.p FALSE,     p sum 1, error given.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"G-test for Count Data — g.test","text":"list class \"htest\" containing following   components: statistic value chi-squared test statistic. parameter degrees freedom approximate     chi-squared distribution test statistic, NA     p-value computed Monte Carlo simulation. p.value p-value test. method character string indicating type test     performed, whether Monte Carlo simulation continuity     correction used. data.name character string giving name(s) data. observed observed counts. expected expected counts null hypothesis. residuals Pearson residuals,     (observed - expected) / sqrt(expected). stdres standardized residuals,     (observed - expected) / sqrt(V), V     residual cell variance (Agresti, 2007, section 2.4.5     case x matrix, n * p * (1 - p) otherwise).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"G-test for Count Data — g.test","text":"x matrix one row column, x vector y given, goodness--fit test performed (x treated one-dimensional contingency table). entries x must non-negative integers. case, hypothesis tested whether population probabilities equal p, equal p given. x matrix least two rows columns, taken two-dimensional contingency table: entries x must non-negative integers.  Otherwise, x y must vectors factors length; cases missing values removed, objects coerced factors, contingency table computed .  Pearson's chi-squared test performed null hypothesis joint distribution cell counts 2-dimensional contingency table product row column marginals. p-value computed asymptotic chi-squared distribution test statistic. contingency table case simulation done random sampling set contingency tables given marginals, works marginals strictly positive. Note usual sampling situation assumed chi-squared test (G-test) rather Fisher's exact test. goodness--fit case simulation done random sampling discrete distribution specified p, sample size n = sum(x). simulation done R may slow.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-goodness-of-fit-likelihood-ratio-test-","dir":"Reference","previous_headings":"","what":"G-test Of Goodness-of-Fit (Likelihood Ratio Test)","title":"G-test for Count Data — g.test","text":"Use G-test goodness--fit one nominal variable two values (male female, red, pink white flowers). compare observed counts numbers observations category expected counts, calculate using kind theoretical expectation (1:1 sex ratio 1:2:1 ratio genetic cross). expected number observations category small, G-test may give inaccurate results, use exact test instead (fisher.test()). G-test goodness--fit alternative chi-square test goodness--fit (chisq.test()); tests advantages disadvantages, results two tests usually similar.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-independence","dir":"Reference","previous_headings":"","what":"G-test of Independence","title":"G-test for Count Data — g.test","text":"Use G-test independence two nominal variables, two possible values. want know whether proportions one variable different among values variable. also possible G-test independence two nominal variables. example, Jackson et al. (2013) also data children 3, analysis old vs. young, thigh vs. arm, reaction vs. reaction, analyzed together. Fisher's exact test (fisher.test()) exact test, G-test still approximation. 2x2 table, Fisher's Exact test may slower still run seconds, even sum observations multiple millions. G-test independence alternative chi-square test independence (chisq.test()), give approximately results.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"how-the-test-works","dir":"Reference","previous_headings":"","what":"How the Test Works","title":"G-test for Count Data — g.test","text":"Unlike exact test goodness--fit (fisher.test()), G-test directly calculate probability obtaining observed results something extreme. Instead, like almost statistical tests, G-test intermediate step; uses data calculate test statistic measures far observed data null expectation. use mathematical relationship, case chi-square distribution, estimate probability obtaining value test statistic. G-test uses log ratio two likelihoods test statistic, also called likelihood ratio test log-likelihood ratio test. formula calculate G-statistic : \\(G = 2 * sum(x * log(x / E))\\) E expected values. Since chi-square distributed, p value can calculated R :   df degrees freedom. two categories want find ones significantly different null expectation, can use method testing category vs. sum categories, Bonferroni correction. use G-tests category, course.","code":"p <- stats::pchisq(G, df, lower.tail = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"G-test for Count Data — g.test","text":"McDonald, J.H. 2014. Handbook Biological Statistics (3rd ed.). Sparky House Publishing, Baltimore, Maryland. http://www.biostathandbook.com/gtestgof.html.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"G-test for Count Data — g.test","text":"","code":"# = EXAMPLE 1 = # Shivrain et al. (2006) crossed clearfield rice (which are resistant # to the herbicide imazethapyr) with red rice (which are susceptible to # imazethapyr). They then crossed the hybrid offspring and examined the # F2 generation, where they found 772 resistant plants, 1611 moderately # resistant plants, and 737 susceptible plants. If resistance is controlled # by a single gene with two co-dominant alleles, you would expect a 1:2:1 # ratio.  x <- c(772, 1611, 737) g.test(x, p = c(1, 2, 1) / 4) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 4.1471, p-value = 0.1257 #>   # There is no significant difference from a 1:2:1 ratio. # Meaning: resistance controlled by a single gene with two co-dominant # alleles, is plausible.   # = EXAMPLE 2 = # Red crossbills (Loxia curvirostra) have the tip of the upper bill either # right or left of the lower bill, which helps them extract seeds from pine # cones. Some have hypothesized that frequency-dependent selection would # keep the number of right and left-billed birds at a 1:1 ratio. Groth (1992) # observed 1752 right-billed and 1895 left-billed crossbills.  x <- c(1752, 1895) g.test(x) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 5.6085, p-value = 0.01787 #>   # There is a significant difference from a 1:1 ratio. # Meaning: there are significantly more left-billed birds."},{"path":"https://amr-for-r.org/reference/get_episode.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Clinical or Epidemic Episodes — get_episode","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"functions determine items vector can considered (start ) new episode. can used determine clinical episodes epidemiological analysis. get_episode() function returns index number episode per group, is_new_episode() function returns TRUE every new get_episode() index. absolute relative episode determination supported.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"get_episode(x, episode_days = NULL, case_free_days = NULL, ...)  is_new_episode(x, episode_days = NULL, case_free_days = NULL, ...)"},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"x Vector dates (class Date POSIXt), sorted internally determine episodes. episode_days Episode length days specify time period new episode begins, can also less day Inf, see Details. case_free_days (inter-epidemic) interval length days new episode start, can also less day Inf, see Details. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode(): integer vector is_new_episode(): logical vector","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"Episodes can determined two ways: absolute relative. Absolute method uses episode_days define episode length days, new episode start. common use case AMR data analysis microbial epidemiology: episodes S. aureus bacteraemia ICU patients example. episode length 30 days, new S. aureus isolates ICU episode 30 days considered different (new) episode. Thus, method counts since start previous episode. Relative method uses case_free_days quantify duration case-free days (inter-epidemic interval), new episode start. common use case infectious disease epidemiology: episodes norovirus outbreaks hospital example. case-free period 14 days, new norovirus cases time considered different (new) episode. Thus, methods counts since last case previous episode. table: ** marks start new episode, 8 January 2023 7 days since start previous episode (1 January 2023).  *** marks start new episode, 21 January 2023 7 days since last case previous episode (8 January 2023). Either episode_days case_free_days must provided function.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"difference-between-get-episode-and-is-new-episode-","dir":"Reference","previous_headings":"","what":"Difference between get_episode() and is_new_episode()","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode() function returns index number episode, cases/patients/isolates first episode number 1, cases/patients/isolates second episode number 2, etc. is_new_episode() function hand, returns TRUE every new get_episode() index. specify, setting episode_days = 365 (using method 1 explained ), two functions differ:","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names allows different isolate selection methods. dplyr package required functions work, episode functions support variable grouping work conveniently inside dplyr verbs filter(), mutate() summarise().","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"# difference between absolute and relative determination of episodes: x <- data.frame(dates = as.Date(c(   \"2021-01-01\",   \"2021-01-02\",   \"2021-01-05\",   \"2021-01-08\",   \"2021-02-21\",   \"2021-02-22\",   \"2021-02-23\",   \"2021-02-24\",   \"2021-03-01\",   \"2021-03-01\" ))) x$absolute <- get_episode(x$dates, episode_days = 7) x$relative <- get_episode(x$dates, case_free_days = 7) x #>         dates absolute relative #> 1  2021-01-01        1        1 #> 2  2021-01-02        1        1 #> 3  2021-01-05        1        1 #> 4  2021-01-08        2        1 #> 5  2021-02-21        3        2 #> 6  2021-02-22        3        2 #> 7  2021-02-23        3        2 #> 8  2021-02-24        3        2 #> 9  2021-03-01        4        2 #> 10 2021-03-01        4        2   # `example_isolates` is a data set available in the AMR package. # See ?example_isolates df <- example_isolates[sample(seq_len(2000), size = 100), ]  get_episode(df$date, episode_days = 60) # indices #>   [1] 33 15 22 12 31 27 11 45 38 19  3 29  4 42 41 41 13 36 23 33 38 46 31 45 21 #>  [26] 24  9 18 10  6 11 41  1 12 38 26 11 36  1 41 32 14  7 37 22 26 16 44 14  7 #>  [51] 44  4 45  4  2 39 20 43  9 42 29 11  6 36 25 30 23  8 14  4 28 11 14 20 40 #>  [76] 23  6 11 16 29 27  9  8 15 45 31 35 44 35 46  5 39 44 24 17 12 31 32 36 34 is_new_episode(df$date, episode_days = 60) # TRUE/FALSE #>   [1]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [13]  TRUE  TRUE  TRUE FALSE  TRUE  TRUE  TRUE FALSE FALSE  TRUE FALSE FALSE #>  [25]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE FALSE FALSE  TRUE FALSE FALSE  TRUE #>  [37] FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE  TRUE FALSE FALSE  TRUE  TRUE #>  [49] FALSE FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE  TRUE FALSE FALSE #>  [61] FALSE FALSE FALSE FALSE  TRUE  TRUE FALSE  TRUE FALSE FALSE  TRUE FALSE #>  [73] FALSE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE #>  [85] FALSE FALSE  TRUE FALSE FALSE FALSE  TRUE FALSE FALSE FALSE  TRUE FALSE #>  [97] FALSE FALSE FALSE  TRUE  # filter on results from the third 60-day episode only, using base R df[which(get_episode(df$date, 60) == 3), ] #> # A tibble: 1 × 46 #>   date       patient   age gender ward      mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr>     <mo>         <sir> <sir> <sir> <sir> #> 1 2002-07-16 241328     78 M      Outpatie… B_STPHY_CONS   R     NA    S     R   #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, RIF <sir>  # the functions also work for less than a day, e.g. to include one per hour: get_episode(   c(     Sys.time(),     Sys.time() + 60 * 60   ),   episode_days = 1 / 24 ) #> [1] 1 2  # \\donttest{ if (require(\"dplyr\")) {   # is_new_episode() can also be used in dplyr verbs to determine patient   # episodes based on any (combination of) grouping variables:   df %>%     mutate(condition = sample(       x = c(\"A\", \"B\", \"C\"),       size = 100,       replace = TRUE     )) %>%     group_by(patient, condition) %>%     mutate(new_episode = is_new_episode(date, 365)) %>%     select(patient, date, condition, new_episode) %>%     arrange(patient, condition, date) } #> # A tibble: 100 × 4 #> # Groups:   patient, condition [95] #>    patient date       condition new_episode #>    <chr>   <date>     <chr>     <lgl>       #>  1 067927  2002-02-14 B         TRUE        #>  2 067927  2002-02-14 B         FALSE       #>  3 0E2483  2007-06-21 B         TRUE        #>  4 151041  2006-02-10 C         TRUE        #>  5 155435  2014-06-18 A         TRUE        #>  6 167474  2008-02-15 A         TRUE        #>  7 174209  2011-10-03 B         TRUE        #>  8 175532  2012-10-11 A         TRUE        #>  9 187841  2012-09-30 C         TRUE        #> 10 197007  2012-07-17 B         TRUE        #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward, patient) %>%     transmute(date,       patient,       new_index = get_episode(date, 60),       new_logical = is_new_episode(date, 60)     ) %>%     arrange(patient, ward, date) } #> # A tibble: 100 × 5 #> # Groups:   ward, patient [93] #>    ward       date       patient new_index new_logical #>    <chr>      <date>     <chr>       <int> <lgl>       #>  1 ICU        2002-02-14 067927          1 TRUE        #>  2 ICU        2002-02-14 067927          1 FALSE       #>  3 ICU        2007-06-21 0E2483          1 TRUE        #>  4 Clinical   2006-02-10 151041          1 TRUE        #>  5 Clinical   2014-06-18 155435          1 TRUE        #>  6 Clinical   2008-02-15 167474          1 TRUE        #>  7 Outpatient 2011-10-03 174209          1 TRUE        #>  8 Clinical   2012-10-11 175532          1 TRUE        #>  9 Clinical   2012-09-30 187841          1 TRUE        #> 10 Clinical   2012-07-17 197007          1 TRUE        #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward) %>%     summarise(       n_patients = n_distinct(patient),       n_episodes_365 = sum(is_new_episode(date, episode_days = 365)),       n_episodes_60 = sum(is_new_episode(date, episode_days = 60)),       n_episodes_30 = sum(is_new_episode(date, episode_days = 30))     ) } #> # A tibble: 3 × 5 #>   ward       n_patients n_episodes_365 n_episodes_60 n_episodes_30 #>   <chr>           <int>          <int>         <int>         <int> #> 1 Clinical           55             13            35            44 #> 2 ICU                32              9            19            25 #> 3 Outpatient          6              6             6             6  # grouping on patients and microorganisms leads to the same # results as first_isolate() when using 'episode-based': if (require(\"dplyr\")) {   x <- df %>%     filter_first_isolate(       include_unknown = TRUE,       method = \"episode-based\"     )    y <- df %>%     group_by(patient, mo) %>%     filter(is_new_episode(date, 365)) %>%     ungroup()    identical(x, y) } #> [1] TRUE  # but is_new_episode() has a lot more flexibility than first_isolate(), # since you can now group on anything that seems relevant: if (require(\"dplyr\")) {   df %>%     group_by(patient, mo, ward) %>%     mutate(flag_episode = is_new_episode(date, 365)) %>%     select(group_vars(.), flag_episode) } #> # A tibble: 100 × 4 #> # Groups:   patient, mo, ward [95] #>    patient mo           ward       flag_episode #>    <chr>   <mo>         <chr>      <lgl>        #>  1 88B975  B_STRPT      Clinical   TRUE         #>  2 904485  B_ESCHR_COLI Outpatient TRUE         #>  3 167474  B_STPHY_CONS Clinical   TRUE         #>  4 777154  B_CTRBC      Clinical   TRUE         #>  5 E58140  B_ESCHR_COLI Clinical   TRUE         #>  6 E58549  B_ESCHR_COLI Clinical   TRUE         #>  7 D65308  B_STPHY_EPDR ICU        TRUE         #>  8 871020  B_STPHY_EPDR Clinical   TRUE         #>  9 B13995  B_STPHY_AURS Clinical   TRUE         #> 10 CB6026  B_STPHY_CONS Clinical   TRUE         #> # ℹ 90 more rows # }"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":null,"dir":"Reference","previous_headings":"","what":"PCA Biplot with ggplot2 — ggplot_pca","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"Produces ggplot2 variant -called biplot PCA (principal component analysis), flexible appealing base R biplot() function.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"ggplot_pca(x, choices = 1:2, scale = 1, pc.biplot = TRUE,   labels = NULL, labels_textsize = 3, labels_text_placement = 1.5,   groups = NULL, ellipse = TRUE, ellipse_prob = 0.68,   ellipse_size = 0.5, ellipse_alpha = 0.5, points_size = 2,   points_alpha = 0.25, arrows = TRUE, arrows_colour = \"darkblue\",   arrows_size = 0.5, arrows_textsize = 3, arrows_textangled = TRUE,   arrows_alpha = 0.75, base_textsize = 10, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"ggplot_pca() function based ggbiplot() function ggbiplot package Vince Vu, found GitHub: https://github.com/vqv/ggbiplot (retrieved: 2 March 2020, latest commit: 7325e88; 12 February 2015). per GPL-2 licence demands documentation code changes, changes made based source code : Rewritten code remove dependency packages plyr, scales grid Parametrised options, like arrow ellipse settings Hardened input possibilities defining exact type user input every argument Added total amount explained variance caption plot Cleaned syntax based lintr package, fixed grammatical errors added integrity checks Updated documentation","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"x object returned pca(), prcomp() princomp(). choices length 2 vector specifying components plot. default     biplot strict sense. scale variables scaled lambda ^ scale     observations scaled lambda ^ (1-scale)     lambda singular values computed     princomp. Normally 0 <= scale <= 1, warning     issued specified scale outside range. pc.biplot true, use Gabriel (1971) refers \"principal component     biplot\", lambda = 1 observations scaled sqrt(n)     variables scaled sqrt(n).  inner products     variables approximate covariances distances observations     approximate Mahalanobis distance. labels optional vector labels observations. set, labels placed respective points. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). labels_textsize size text used labels. labels_text_placement Adjustment factor placement variable names (>=1 means away arrow head). groups optional vector groups labels, length labels. set, points labels coloured according groups. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). ellipse logical indicate whether normal data ellipse drawn group (set groups). ellipse_prob Statistical size ellipse normal probability. ellipse_size size ellipse line. ellipse_alpha alpha (transparency) ellipse line. points_size size points. points_alpha alpha (transparency) points. arrows logical indicate whether arrows drawn. arrows_colour colour arrow text. arrows_size size (thickness) arrow lines. arrows_textsize size text end arrows. arrows_textangled logical whether text end arrows angled. arrows_alpha alpha (transparency) arrows text. base_textsize text size plot elements except labels arrows. ... Arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"colours labels points can changed adding another scale layer colour, scale_colour_viridis_d() scale_colour_brewer().","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    summary(pca_result)    # old base R plotting method:   biplot(pca_result, main = \"Base R biplot\")    # new ggplot2 plotting method using this package:   if (require(\"ggplot2\")) {     ggplot_pca(pca_result) +       labs(title = \"ggplot2 biplot\")   }   if (require(\"ggplot2\")) {     # still extendible with any ggplot2 function     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"ggplot2 biplot\")   } } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (minimum = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # }"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":null,"dir":"Reference","previous_headings":"","what":"AMR Plots with ggplot2 — ggplot_sir","title":"AMR Plots with ggplot2 — ggplot_sir","text":"Use functions create bar plots AMR data analysis. functions rely ggplot2 functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"ggplot_sir(data, position = NULL, x = \"antibiotic\",   fill = \"interpretation\", facet = NULL, breaks = seq(0, 1, 0.1),   limits = NULL, translate_ab = \"name\", combine_SI = TRUE,   minimum = 30, language = get_AMR_locale(), nrow = NULL, colours = c(S   = \"#3CAEA3\", SI = \"#3CAEA3\", I = \"#F6D55C\", IR = \"#ED553B\", R = \"#ED553B\"),   datalabels = TRUE, datalabels.size = 2.5, datalabels.colour = \"grey15\",   title = NULL, subtitle = NULL, caption = NULL,   x.title = \"Antimicrobial\", y.title = \"Proportion\", ...)  geom_sir(position = NULL, x = c(\"antibiotic\", \"interpretation\"),   fill = \"interpretation\", translate_ab = \"name\", minimum = 30,   language = get_AMR_locale(), combine_SI = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"AMR Plots with ggplot2 — ggplot_sir","text":"data data.frame column(s) class sir (see .sir()). position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". x Variable show x axis, either \"antibiotic\" (default) \"interpretation\" grouping variable. fill Variable categorise using plots legend, either \"antibiotic\" (default) \"interpretation\" grouping variable. facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. nrow (using facet) number rows. colours named vactor colour used filling. default colours colour-blind friendly. datalabels Show datalabels using labels_sir_count(). datalabels.size Size datalabels. datalabels.colour Colour datalabels. title Text show title plot. subtitle Text show subtitle plot. caption Text show caption plot. x.title Text show x axis description. y.title Text show y axis description. ... arguments passed geom_sir() , case scale_sir_colours(), named values set colours. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Plots with ggplot2 — ggplot_sir","text":"default, names antimicrobials shown plots using ab_name(). can set translate_ab argument. See count_df(). geom_sir() take variable data sir class (created .sir()) using sir_df() plot bars percentage S, , R. default behaviour bars stacked different antimicrobials x axis. Additional functions include: facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() sets colours bars (green S, yellow , red R). multilingual support. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage amount isolates using ggplot2::geom_text(). ggplot_sir() wrapper around functions uses data first input. makes possible use function pipe (%>%). See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"# \\donttest{ if (require(\"ggplot2\") && require(\"dplyr\")) {   # get antimicrobial results for drugs against a UTI:   ggplot(example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)) +     geom_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # prettify the plot using some additional functions:   df <- example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)   ggplot(df) +     geom_sir() +     scale_y_percent() +     scale_sir_colours(aesthetics = \"fill\") +     labels_sir_count() +     theme_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # or better yet, simplify this using the wrapper function - a single command:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # get only proportions and no counts:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(datalabels = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # add other ggplot2 arguments as you like:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(       width = 0.5,       colour = \"black\",       size = 1,       linetype = 2,       alpha = 0.25     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # you can alter the colours with colour names:   example_isolates %>%     select(AMX) %>%     ggplot_sir(colours = c(SI = \"yellow\")) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # but you can also use the built-in colour-blind friendly colours for   # your plots, where \"S\" is green, \"I\" is yellow and \"R\" is red:   data.frame(     x = c(\"Value1\", \"Value2\", \"Value3\"),     y = c(1, 2, 3),     z = c(\"Value4\", \"Value5\", \"Value6\")   ) %>%     ggplot() +     geom_col(aes(x = x, y = y, fill = z)) +     scale_sir_colours(       aesthetics = \"fill\",       Value4 = \"S\", Value5 = \"I\", Value6 = \"R\"     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # resistance of ciprofloxacine per age group   example_isolates %>%     mutate(first_isolate = first_isolate()) %>%     filter(       first_isolate == TRUE,       mo == as.mo(\"Escherichia coli\")     ) %>%     # age_groups() is also a function in this AMR package:     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(x = \"age_group\") } #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_col()`). #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_text()`).  if (require(\"ggplot2\") && require(\"dplyr\")) {   # a shorter version which also adjusts data label colours:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(colours = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # it also supports groups (don't forget to use the group var on `x` or `facet`):   example_isolates %>%     filter(mo_is_gram_negative(), ward != \"Outpatient\") %>%     # select only UTI-specific drugs     select(ward, AMX, NIT, FOS, TMP, CIP) %>%     group_by(ward) %>%     ggplot_sir(       x = \"ward\",       facet = \"antibiotic\",       nrow = 1,       title = \"AMR of Anti-UTI Drugs Per Ward\",       x.title = \"Ward\",       datalabels = FALSE     ) } #> ℹ Using column 'mo' as input for mo_is_gram_negative()  # }"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":null,"dir":"Reference","previous_headings":"","what":"Guess Antibiotic Column — guess_ab_col","title":"Guess Antibiotic Column — guess_ab_col","text":"tries find column name data set based information antimicrobials data set. Also supports WHONET abbreviations.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"guess_ab_col(x = NULL, search_string = NULL, verbose = FALSE,   only_sir_columns = FALSE)"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Guess Antibiotic Column — guess_ab_col","text":"x data.frame. search_string text search x , checked .ab() value column x. verbose logical indicate whether additional info printed. only_sir_columns logical indicate whether antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE).","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Guess Antibiotic Column — guess_ab_col","text":"column name x, NULL result found.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Guess Antibiotic Column — guess_ab_col","text":"can look antibiotic (trade) name abbreviation search x antimicrobials data set column containing name code antibiotic.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"df <- data.frame(   amox = \"S\",   tetr = \"R\" )  guess_ab_col(df, \"amoxicillin\") #> [1] \"amox\" guess_ab_col(df, \"J01AA07\") # ATC code of tetracycline #> [1] \"tetr\"  guess_ab_col(df, \"J01AA07\", verbose = TRUE) #> Auto-guessing columns suitable for analysis #> ... #>  OK. #> ℹ Using column 'amox' as input for AMX (amoxicillin). #> ℹ Using column 'tetr' as input for TCY (tetracycline). #> ℹ Using column 'tetr' as input for J01AA07 (tetracycline). #> [1] \"tetr\"  # WHONET codes df <- data.frame(   AMP_ND10 = \"R\",   AMC_ED20 = \"S\" ) guess_ab_col(df, \"ampicillin\") #> [1] \"AMP_ND10\" guess_ab_col(df, \"J01CR02\") #> [1] \"AMC_ED20\" guess_ab_col(df, \"augmentin\") #> [1] \"AMC_ED20\""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Data set containing 'EUCAST Expected Resistant Phenotypes' bug-drug combinations microorganisms antimicrobials data sets.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant"},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"tibble 271 905 observations 2 variables: mo Microorganism ID occurs microorganisms$mo. Names can retrieved using mo_name(). ab Antimicrobial ID occurs antimicrobials$ab. Names can retrieved using ab_name().","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"data set currently based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). data set internally used : not_intrinsic_resistant() (antimicrobial selector) mo_is_intrinsic_resistant()","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant #> # A tibble: 271,905 × 2 #>    mo          ab   #>    <mo>        <ab> #>  1 B_GRAMP     ATM  #>  2 B_GRAMP     COL  #>  3 B_GRAMP     NAL  #>  4 B_GRAMP     PLB  #>  5 B_GRAMP     TEM  #>  6 B_ANAER-POS ATM  #>  7 B_ANAER-POS COL  #>  8 B_ANAER-POS NAL  #>  9 B_ANAER-POS PLB  #> 10 B_ANAER-POS TEM  #> # ℹ 271,895 more rows"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":null,"dir":"Reference","previous_headings":"","what":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"According binomial nomenclature, lowest four taxonomic levels (family, genus, species, subspecies) printed italics. function finds taxonomic names within strings makes italic.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))  italicize_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"string character (vector). type Type conversion taxonomic names, either \"markdown\", \"html\" \"ansi\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"function finds taxonomic names makes italic based microorganisms data set. taxonomic names can italicised using markdown (default) adding * taxonomic names, <> <\/> using html. using 'ansi', ANSI colours added using \\033[3m \\033[23m taxonomic names. multiple ANSI colours available, conversion occur. function also supports abbreviation genus followed species, \"E. coli\" \"K. pneumoniae ozaenae\".","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(\"An overview of Staphylococcus aureus isolates\") #> [1] \"An overview of *Staphylococcus aureus* isolates\" italicise_taxonomy(\"An overview of S. aureus isolates\") #> [1] \"An overview of *S. aureus* isolates\"  cat(italicise_taxonomy(\"An overview of S. aureus isolates\", type = \"ansi\")) #> An overview of S. aureus isolates"},{"path":"https://amr-for-r.org/reference/join.html","id":null,"dir":"Reference","previous_headings":"","what":"Join microorganisms to a Data Set — join","title":"Join microorganisms to a Data Set — join","text":"Join data set microorganisms easily existing data set character vector.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join microorganisms to a Data Set — join","text":"","code":"inner_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  left_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  right_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  full_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  semi_join_microorganisms(x, by = NULL, ...)  anti_join_microorganisms(x, by = NULL, ...)"},{"path":"https://amr-for-r.org/reference/join.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join microorganisms to a Data Set — join","text":"x Existing data set join, character vector. case character vector, resulting data.frame contain column 'x' values. variable join - left empty search column class mo (created .mo()) \"mo\" column name exists x, otherwise column name x values exist microorganisms$mo (= \"bacteria_id\"), another column microorganisms (named, like = c(\"bacteria_id\" = \"fullname\")). suffix non-joined duplicate variables x y, suffixes added output disambiguate . character vector length 2. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join microorganisms to a Data Set — join","text":"data.frame","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Join microorganisms to a Data Set — join","text":"Note: opposed join() functions dplyr, character vectors supported default existing columns get suffix \"2\" newly joined columns get suffix. dplyr package installed, join functions used. Otherwise, much slower merge() interaction() functions base R used.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Join microorganisms to a Data Set — join","text":"","code":"left_join_microorganisms(as.mo(\"K. pneumoniae\")) #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list> left_join_microorganisms(\"B_KLBSL_PNMN\") #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>  df <- data.frame(   date = seq(     from = as.Date(\"2018-01-01\"),     to = as.Date(\"2018-01-07\"),     by = 1   ),   bacteria = as.mo(c(     \"S. aureus\", \"MRSA\", \"MSSA\", \"STAAUR\",     \"E. coli\", \"E. coli\", \"E. coli\"   )),   stringsAsFactors = FALSE ) colnames(df) #> [1] \"date\"     \"bacteria\"  df_joined <- left_join_microorganisms(df, \"bacteria\") colnames(df_joined) #>  [1] \"date\"                \"bacteria\"            \"fullname\"            #>  [4] \"status\"              \"kingdom\"             \"phylum\"              #>  [7] \"class\"               \"order\"               \"family\"              #> [10] \"genus\"               \"species\"             \"subspecies\"          #> [13] \"rank\"                \"ref\"                 \"oxygen_tolerance\"    #> [16] \"source\"              \"lpsn\"                \"lpsn_parent\"         #> [19] \"lpsn_renamed_to\"     \"mycobank\"            \"mycobank_parent\"     #> [22] \"mycobank_renamed_to\" \"gbif\"                \"gbif_parent\"         #> [25] \"gbif_renamed_to\"     \"prevalence\"          \"snomed\"               # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     left_join_microorganisms() %>%     colnames() } #> Joining, by = \"mo\" #>  [1] \"date\"                \"patient\"             \"age\"                 #>  [4] \"gender\"              \"ward\"                \"mo\"                  #>  [7] \"PEN\"                 \"OXA\"                 \"FLC\"                 #> [10] \"AMX\"                 \"AMC\"                 \"AMP\"                 #> [13] \"TZP\"                 \"CZO\"                 \"FEP\"                 #> [16] \"CXM\"                 \"FOX\"                 \"CTX\"                 #> [19] \"CAZ\"                 \"CRO\"                 \"GEN\"                 #> [22] \"TOB\"                 \"AMK\"                 \"KAN\"                 #> [25] \"TMP\"                 \"SXT\"                 \"NIT\"                 #> [28] \"FOS\"                 \"LNZ\"                 \"CIP\"                 #> [31] \"MFX\"                 \"VAN\"                 \"TEC\"                 #> [34] \"TCY\"                 \"TGC\"                 \"DOX\"                 #> [37] \"ERY\"                 \"CLI\"                 \"AZM\"                 #> [40] \"IPM\"                 \"MEM\"                 \"MTR\"                 #> [43] \"CHL\"                 \"COL\"                 \"MUP\"                 #> [46] \"RIF\"                 \"fullname\"            \"status\"              #> [49] \"kingdom\"             \"phylum\"              \"class\"               #> [52] \"order\"               \"family\"              \"genus\"               #> [55] \"species\"             \"subspecies\"          \"rank\"                #> [58] \"ref\"                 \"oxygen_tolerance\"    \"source\"              #> [61] \"lpsn\"                \"lpsn_parent\"         \"lpsn_renamed_to\"     #> [64] \"mycobank\"            \"mycobank_parent\"     \"mycobank_renamed_to\" #> [67] \"gbif\"                \"gbif_parent\"         \"gbif_renamed_to\"     #> [70] \"prevalence\"          \"snomed\"              # }"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"functions can used determine first weighted isolates considering phenotype isolate selection (see first_isolate()). Using phenotype-based method determine first isolates reliable methods disregard phenotypes.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"key_antimicrobials(x = NULL, col_mo = NULL, universal = c(\"ampicillin\",   \"amoxicillin/clavulanic acid\", \"cefuroxime\", \"piperacillin/tazobactam\",   \"ciprofloxacin\", \"trimethoprim/sulfamethoxazole\"),   gram_negative = c(\"gentamicin\", \"tobramycin\", \"colistin\", \"cefotaxime\",   \"ceftazidime\", \"meropenem\"), gram_positive = c(\"vancomycin\", \"teicoplanin\",   \"tetracycline\", \"erythromycin\", \"oxacillin\", \"rifampin\"),   antifungal = c(\"anidulafungin\", \"caspofungin\", \"fluconazole\", \"miconazole\",   \"nystatin\", \"voriconazole\"), only_sir_columns = FALSE, ...)  all_antimicrobials(x = NULL, only_sir_columns = FALSE, ...)  antimicrobials_equal(y, z, type = c(\"points\", \"keyantimicrobials\"),   ignore_I = TRUE, points_threshold = 2, ...)"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank determine automatically. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). universal Names broad-spectrum antimicrobial drugs, case-insensitive. Set NULL ignore. See Details default antimicrobial drugs. gram_negative Names antibiotic drugs Gram-positives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. gram_positive Names antibiotic drugs Gram-negatives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. antifungal Names antifungal drugs fungi, case-insensitive. Set NULL ignore. See Details default antifungal drugs. only_sir_columns logical indicate whether columns must included transformed class sir (see .sir()) beforehand (default FALSE). ... Ignored, place allow future extensions. y, z character vectors compare. type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"key_antimicrobials() all_antimicrobials() functions context-aware. means x argument can left blank used inside data.frame call, see Examples. function key_antimicrobials() returns character vector 12 antimicrobial results every isolate. function all_antimicrobials() returns character vector antimicrobial drug results every isolate. vectors can compared using antimicrobials_equal(), check two isolates generally antibiogram. Missing invalid values replaced dot (\".\") key_antimicrobials() ignored antimicrobials_equal(). Please see first_isolate() function important functions enable 'phenotype-based' method determination first isolates. default antimicrobial drugs used rows (set universal) : Ampicillin Amoxicillin/clavulanic acid Cefuroxime Ciprofloxacin Piperacillin/tazobactam Trimethoprim/sulfamethoxazole default antimicrobial drugs used Gram-negative bacteria (set gram_negative) : Cefotaxime Ceftazidime Colistin Gentamicin Meropenem Tobramycin default antimicrobial drugs used Gram-positive bacteria (set gram_positive) : Erythromycin Oxacillin Rifampin Teicoplanin Tetracycline Vancomycin default antimicrobial drugs used fungi (set antifungal) : Anidulafungin Caspofungin Fluconazole Miconazole Nystatin Voriconazole","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # output of the `key_antimicrobials()` function could be like this: strainA <- \"SSSRR.S.R..S\" strainB <- \"SSSIRSSSRSSS\"  # those strings can be compared with: antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\") #> [1] TRUE # TRUE, because I is ignored (as well as missing values)  antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\", ignore_I = FALSE) #> [1] FALSE # FALSE, because I is not ignored and so the 4th [character] differs  # \\donttest{ if (require(\"dplyr\")) {   # set key antimicrobials to a new variable   my_patients <- example_isolates %>%     mutate(keyab = key_antimicrobials(antifungal = NULL)) %>% # no need to define `x`     mutate(       # now calculate first isolates       first_regular = first_isolate(col_keyantimicrobials = FALSE),       # and first WEIGHTED isolates       first_weighted = first_isolate(col_keyantimicrobials = \"keyab\")     )    # Check the difference in this data set, 'weighted' results in more isolates:   sum(my_patients$first_regular, na.rm = TRUE)   sum(my_patients$first_weighted, na.rm = TRUE) } #> [1] 1383 # }"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":null,"dir":"Reference","previous_headings":"","what":"Kurtosis of the Sample — kurtosis","title":"Kurtosis of the Sample — kurtosis","text":"Kurtosis measure \"tailedness\" probability distribution real-valued random variable. normal distribution kurtosis 3 excess kurtosis 0.","code":""},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(x, na.rm = FALSE, excess = FALSE)  # Default S3 method kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'matrix' kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'data.frame' kurtosis(x, na.rm = FALSE, excess = FALSE)"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Kurtosis of the Sample — kurtosis","text":"x vector values, matrix data.frame. na.rm logical indicate whether NA values stripped computation proceeds. excess logical indicate whether excess kurtosis returned, defined kurtosis minus 3.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(rnorm(10000)) #> [1] 3.032783 kurtosis(rnorm(10000), excess = TRUE) #> [1] 0.05102003"},{"path":"https://amr-for-r.org/reference/like.html","id":null,"dir":"Reference","previous_headings":"","what":"Vectorised Pattern Matching with Keyboard Shortcut — like","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Convenient wrapper around grepl() match pattern: x %like% pattern. always returns logical vector always case-insensitive (use x %like_case% pattern case-sensitive matching). Also, pattern can long x compare items index vectors, can length iterate cases.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"like(x, pattern, ignore.case = TRUE)  x %like% pattern  x %unlike% pattern  x %like_case% pattern  x %unlike_case% pattern"},{"path":"https://amr-for-r.org/reference/like.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Idea like function data.table package, although altered explained Details.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"x character vector matches sought, object can coerced .character() character vector. pattern character vector containing regular expressions (character string fixed = TRUE) matched given character vector. Coerced .character() character string possible. ignore.case FALSE, pattern matching case sensitive TRUE, case ignored matching.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"like() %like%/%unlike% functions: case-insensitive (use %like_case%/%unlike_case% case-sensitive matching) Support multiple patterns Check pattern valid regular expression sets fixed = TRUE , greatly improve speed (vectorised pattern) Always use compatibility Perl unless fixed = TRUE, greatly improve speed Using RStudio? %like%/%unlike% functions can also directly inserted code Addins menu can keyboard shortcut like Shift+Ctrl+L Shift+Cmd+L (see menu Tools > Modify Keyboard Shortcuts...). keep pressing shortcut, inserted text iterated %like% -> %unlike% -> %like_case% -> %unlike_case%.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"# data.table has a more limited version of %like%, so unload it: try(detach(\"package:data.table\", unload = TRUE), silent = TRUE)  a <- \"This is a test\" b <- \"TEST\" a %like% b #> [1] TRUE b %like% a #> [1] FALSE  # also supports multiple patterns a <- c(\"Test case\", \"Something different\", \"Yet another thing\") b <- c(\"case\", \"diff\", \"yet\") a %like% b #> [1] TRUE TRUE TRUE a %unlike% b #> [1] FALSE FALSE FALSE  a[1] %like% b #> [1]  TRUE FALSE FALSE a %like% b[1] #> [1]  TRUE FALSE FALSE  # \\donttest{ # get isolates whose name start with 'Entero' (case-insensitive) example_isolates[which(mo_name() %like% \"^entero\"), ] #> ℹ Using column 'mo' as input for mo_name() #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_name() %like% \"^ent\") } #> ℹ Using column 'mo' as input for mo_name() #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/mdro.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Determine isolates multidrug-resistant organisms (MDRO) according international, national, custom guidelines.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"mdro(x = NULL, guideline = \"CMI2012\", col_mo = NULL, esbl = NA,   carbapenemase = NA, mecA = NA, mecC = NA, vanA = NA, vanB = NA,   info = interactive(), pct_required_classes = 0.5, combine_SI = TRUE,   verbose = FALSE, only_sir_columns = FALSE, ...)  custom_mdro_guideline(..., as_factor = TRUE)  brmo(x = NULL, only_sir_columns = FALSE, ...)  mrgn(x = NULL, only_sir_columns = FALSE, verbose = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = FALSE, verbose = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = FALSE, verbose = FALSE, ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = FALSE,   verbose = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/mdro.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"See supported guidelines list publications used function.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank automatic determination. guideline specific guideline follow, see sections Supported international / national guidelines Using Custom Guidelines . left empty, publication Magiorakos et al. (see ) followed. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). esbl logical values, column name containing logical values, indicating presence ESBL gene (production proteins). carbapenemase logical values, column name containing logical values, indicating presence carbapenemase gene (production proteins). mecA logical values, column name containing logical values, indicating presence mecA gene (production proteins). mecC logical values, column name containing logical values, indicating presence mecC gene (production proteins). vanA logical values, column name containing logical values, indicating presence vanA gene (production proteins). vanB logical values, column name containing logical values, indicating presence vanB gene (production proteins). info logical indicate whether progress printed console - default print interactive sessions. pct_required_classes Minimal required percentage antimicrobial classes must available per isolate, rounded . example, default guideline, 17 antimicrobial classes must available S. aureus. Setting pct_required_classes argument 0.5 (default) means every S. aureus isolate least 8 different classes must available. lower number available classes return NA isolate. combine_SI logical indicate whether values S must merged one, resistance considered isolates R, . default behaviour mdro() function, follows redefinition EUCAST interpretation (increased exposure) 2019, see section 'Interpretation S, R' . using combine_SI = FALSE, resistance considered isolates R . verbose logical turn Verbose mode (default ). Verbose mode, function return MDRO results, instead returns data set logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antimicrobial columns must detected transformed class sir (see .sir()) beforehand (default FALSE). ... case custom_mdro_guideline(): set rules, see section Using Custom Guidelines . Otherwise: column name antibiotic, see section Antimicrobials . as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"CMI 2012 paper - function mdr_cmi2012() mdro(): Ordered factor levels Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant (XDR) < Pandrug-resistant (PDR) TB guideline - function mdr_tb() mdro(..., guideline = \"TB\"): Ordered factor levels Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant < Extensively drug-resistant German guideline - function mrgn() mdro(..., guideline = \"MRGN\"): Ordered factor levels Negative < 3MRGN < 4MRGN Everything else, except custom guidelines: Ordered factor levels Negative < Positive, unconfirmed < Positive. value \"Positive, unconfirmed\" means , according guideline, entirely sure isolate multi-drug resistant confirmed additional (e.g. molecular) tests","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"functions context-aware. means x argument can left blank used inside data.frame call, see Examples. pct_required_classes argument, values 1 divided 100. support fractions (0.75 3/4) percentages (75). Note: Every test involves Enterobacteriaceae family, internally performed using newly named order Enterobacterales, since Enterobacteriaceae family taxonomically reclassified Adeolu et al. 2016. , Enterobacteriaceae family Enterobacteriales () order. species old Enterobacteriaceae family still new Enterobacterales (without ) order, divided multiple families. way tests performed now mdro() function makes sure results 2016 2016 identical.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"supported-international-national-guidelines","dir":"Reference","previous_headings":"","what":"Supported International / National Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. \"Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.\" Clinical Microbiology Infection (2012) (doi:10.1111/j.1469-0691.2011.03570.x ) guideline = \"EUCAST3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.2\" European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 \"Intrinsic Resistance Exceptional Phenotypes Tables\" (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization \"Companion handbook guidelines programmatic management drug-resistant tuberculosis\" (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7; doi:10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Samenwerkingverband Richtlijnen Infectiepreventie (SRI) (2024) \"Bijzonder Resistente Micro-Organismen (BRMO)\" (link) Also: guideline = \"BRMO 2017\" former Dutch national guideline - Werkgroep Infectiepreventie (WIP), RIVM, last revision 2017: \"Bijzonder Resistente Micro-Organismen (BRMO)\" Please suggest implement guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"using-custom-guidelines","dir":"Reference","previous_headings":"","what":"Using Custom Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   row/isolate matches first rule, value first ~ (case 'Elderly Type ') set MDRO value. Otherwise, second rule tried . number rules unlimited. can print rules set console overview. Colours help reading console supports colours.   outcome function can used guideline argument mdro() function:   Rules can also combined custom rules using c():   rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(CIP == \"R\" & age > 60 ~ \"Elderly Type A\",                                 ERY == \"R\" & age > 60 ~ \"Elderly Type B\") custom #> A set of custom MDRO rules: #>   1. CIP is \"R\" and age is higher than 60 -> Elderly Type A #>   2. ERY is \"R\" and age is higher than 60 -> Elderly Type B #>   3. Otherwise -> Negative #> #> Unmatched rows will return NA. x <- mdro(example_isolates,           guideline = custom) table(x) #>       Negative Elderly Type A Elderly Type B #>           1070            198            732 x <- mdro(example_isolates,           guideline = c(custom,                         custom_mdro_guideline(ERY == \"R\" & age > 50 ~ \"Elderly Type C\"))) table(x) #>       Negative Elderly Type A Elderly Type B Elderly Type C #>            961            198            732            109"},{"path":"https://amr-for-r.org/reference/mdro.html","id":"antimicrobials","dir":"Reference","previous_headings":"","what":"Antimicrobials","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"define antimicrobials column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antimicrobials eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), bleomycin (BLM, L01DC01), brodimoprim (BDP, J01EA02), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), carumonam (CAR, J01DF02), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefepime/amikacin (CFA, J01RA06), cefetamet (CAT, J01DD10), cefiderocol (FDC, J01DI04), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), chlortetracycline (CTE, J01AA03), ciprofloxacin (CIP, J01MA02), ciprofloxacin/metronidazole (CIM, J01RA10), ciprofloxacin/ornidazole (CIO, J01RA12), ciprofloxacin/tinidazole (CIT, J01RA11), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), clomocycline (CLM1, J01AA11), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), demeclocycline (DEM, J01AA01), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), eravacycline (ERV, J01AA13), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levofloxacin/ornidazole (LEO, J01RA05), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), lymecycline (LYM, J01AA04), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metacycline (MTC, J01AA05), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), nemonoxacin (NEM, J01MB08), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), nitroxoline (NTR, J01XX07), norfloxacin (, J01MA06), norfloxacin/metronidazole (NME, J01RA14), norfloxacin/tinidazole (NTI, J01RA13), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), ofloxacin/ornidazole (OOR, J01RA09), oleandomycin (OLE, J01FA05), omadacycline (OMC, J01AA15), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), oxytetracycline (OXY, J01AA06), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), penimepicycline (PNM1, J01AA10), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), rolitetracycline (RLT, J01AA09), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sarecycline (SRC, J01AA14), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/tetroxoprim (SLT, J01EE06), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"out <- mdro(example_isolates, guideline = \"EUCAST\") str(out) #>  Ord.factor w/ 3 levels \"Negative\"<\"Positive, unconfirmed\"<..: 1 1 1 1 1 1 1 1 1 1 ... table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1994                     0                     6   out <- mdro(example_isolates,   guideline = custom_mdro_guideline(     AMX == \"R\" ~ \"Custom MDRO 1\",     VAN == \"R\" ~ \"Custom MDRO 2\"   ) ) table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>           870           804           326   # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     mdro() %>%     table()    # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     pull(MDRO) %>%     table() } #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `MDRO = mdro()`. #> Caused by warning: #> ! in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> . #>                         Negative       Multi-drug-resistant (MDR)  #>                             1617                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0  # }"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Mean AMR Distance — mean_amr_distance","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Calculates normalised mean antimicrobial resistance multiple observations, help identify similar isolates without comparing antibiograms hand.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"mean_amr_distance(x, ...)  # S3 method for class 'sir' mean_amr_distance(x, ..., combine_SI = TRUE)  # S3 method for class 'data.frame' mean_amr_distance(x, ..., combine_SI = TRUE)  amr_distance_from_row(amr_distance, row)"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"x vector class sir, mic disk, data.frame containing columns classes. ... Variables select. Supports tidyselect language (column1:column4 (.mic)), can thus also antimicrobial selectors. combine_SI logical indicate whether values S, SDD, must merged one, input consists S+vs. R (susceptible vs. resistant) - default TRUE. amr_distance outcome mean_amr_distance(). row index, row number.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"mean AMR distance effectively Z-score; normalised numeric value compare AMR test results can help identify similar isolates, without comparing antibiograms hand. MIC values (see .mic()) transformed log2() first; distance thus calculated (log2(x) - mean(log2(x))) / sd(log2(x)). SIR values (see .sir()) transformed using \"S\" = 1, \"\" = 2, \"R\" = 3. combine_SI TRUE (default), \"\" considered 1. data sets, mean AMR distance calculated per column, mean per row returned, see Examples. Use amr_distance_from_row() subtract distances distance one row, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"interpretation","dir":"Reference","previous_headings":"","what":"Interpretation","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Isolates distances less 0.01 difference considered similar. Differences lower 0.025 considered suspicious.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"sir <- random_sir(10) sir #> Class 'sir' #>  [1] S S I I I R R S I S mean_amr_distance(sir) #>  [1] -0.4743416 -0.4743416 -0.4743416 -0.4743416 -0.4743416  1.8973666 #>  [7]  1.8973666 -0.4743416 -0.4743416 -0.4743416  mic <- random_mic(10) mic #> Class 'mic' #>  [1] >=128   0.125   0.01    64      64      8       0.002   1       >=128   #> [10] <=0.001 mean_amr_distance(mic) #>  [1]  1.02853908 -0.44976893 -0.98844311  0.88070828  0.88070828  0.43721587 #>  [7] -1.33169561 -0.00627653  1.02853908 -1.47952641 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1]  1.02853908 -0.44976893 -0.98844311  0.88070828  0.88070828  0.43721587 #>  [7] -1.33169561 -0.00627653  1.02853908 -1.47952641  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 39 35 46 27 13 50 30 49 41 20 mean_amr_distance(disk) #>  [1]  0.3216338  0.0000000  0.8844928 -0.6432675 -1.7689857  1.2061266 #>  [7] -0.4020422  1.1257182  0.4824506 -1.2061266  y <- data.frame(   id = LETTERS[1:10],   amox = random_sir(10, ab = \"amox\", mo = \"Escherichia coli\"),   cipr = random_disk(10, ab = \"cipr\", mo = \"Escherichia coli\"),   gent = random_mic(10, ab = \"gent\", mo = \"Escherichia coli\"),   tobr = random_mic(10, ab = \"tobr\", mo = \"Escherichia coli\") ) y #>    id amox cipr gent tobr #> 1   A    R   23  >=4    1 #> 2   B    I   26  <=1  0.5 #> 3   C    S   20  >=4 >=16 #> 4   D    R   27  >=4  0.5 #> 5   E    S   31  >=4    2 #> 6   F    I   27  >=4 >=16 #> 7   G    I   31  <=1    8 #> 8   H    R   30  >=4    4 #> 9   I    S   27  >=4    4 #> 10  J    I   20  >=4  0.5 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.12237407 -0.92897174 -0.07982527  0.24282355  0.22020411  0.34940813 #>  [7] -0.12306945  0.80126097  0.09975463 -0.70395902 y$amr_distance <- mean_amr_distance(y, is.mic(y)) #> ℹ Calculating mean AMR distance based on columns \"gent\" and \"tobr\" y[order(y$amr_distance), ] #>    id amox cipr gent tobr amr_distance #> 2   B    I   26  <=1  0.5  -1.52288635 #> 7   G    I   31  <=1    8  -0.52427235 #> 4   D    R   27  >=4  0.5  -0.33703222 #> 10  J    I   20  >=4  0.5  -0.33703222 #> 1   A    R   23  >=4    1  -0.08737872 #> 5   E    S   31  >=4    2   0.16227477 #> 8   H    R   30  >=4    4   0.41192827 #> 9   I    S   27  >=4    4   0.41192827 #> 3   C    S   20  >=4 >=16   0.91123527 #> 6   F    I   27  >=4 >=16   0.91123527  if (require(\"dplyr\")) {   y %>%     mutate(       amr_distance = mean_amr_distance(y),       check_id_C = amr_distance_from_row(amr_distance, id == \"C\")     ) %>%     arrange(check_id_C) } #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>    id amox cipr gent tobr amr_distance check_id_C #> 1   C    S   20  >=4 >=16  -0.07982527 0.00000000 #> 2   G    I   31  <=1    8  -0.12306945 0.04324419 #> 3   I    S   27  >=4    4   0.09975463 0.17957990 #> 4   A    R   23  >=4    1   0.12237407 0.20219934 #> 5   E    S   31  >=4    2   0.22020411 0.30002938 #> 6   D    R   27  >=4  0.5   0.24282355 0.32264882 #> 7   F    I   27  >=4 >=16   0.34940813 0.42923340 #> 8   J    I   20  >=4  0.5  -0.70395902 0.62413375 #> 9   B    I   26  <=1  0.5  -0.92897174 0.84914647 #> 10  H    R   30  >=4    4   0.80126097 0.88108624 if (require(\"dplyr\")) {   # support for groups   example_isolates %>%     filter(mo_genus() == \"Enterococcus\" & mo_species() != \"\") %>%     select(mo, TCY, carbapenems()) %>%     group_by(mo) %>%     mutate(dist = mean_amr_distance(.)) %>%     arrange(mo, dist) } #> ℹ Using column 'mo' as input for mo_genus() #> ℹ Using column 'mo' as input for mo_species() #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Calculating mean AMR distance based on columns \"TCY\", \"IPM\", and \"MEM\" #> # A tibble: 63 × 5 #> # Groups:   mo [4] #>    mo           TCY   IPM   MEM     dist #>    <mo>         <sir> <sir> <sir>  <dbl> #>  1 B_ENTRC_AVIM   S     S     NA   0     #>  2 B_ENTRC_AVIM   S     S     NA   0     #>  3 B_ENTRC_CSSL   NA    S     NA  NA     #>  4 B_ENTRC_FACM   S     S     NA  -2.66  #>  5 B_ENTRC_FACM   S     R     R   -0.423 #>  6 B_ENTRC_FACM   S     R     R   -0.423 #>  7 B_ENTRC_FACM   NA    R     R    0.224 #>  8 B_ENTRC_FACM   NA    R     R    0.224 #>  9 B_ENTRC_FACM   NA    R     R    0.224 #> 10 B_ENTRC_FACM   NA    R     R    0.224 #> # ℹ 53 more rows"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"data set containing commonly used codes microorganisms, laboratory systems WHONET. Define set_mo_source(). searched using .mo() consequently mo_* functions.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"tibble 5 063 observations 2 variables: code Commonly used code microorganism. unique identifier. mo ID microorganism microorganisms data set","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 5,063 × 2 #>    code  mo                #>    <chr> <mo>              #>  1 1011  B_GRAMP           #>  2 1012  B_GRAMP           #>  3 1013  B_GRAMN           #>  4 1014  B_GRAMN           #>  5 1015  F_YEAST           #>  6 103   B_ESCHR_COLI      #>  7 104   B_SLMNL_ENTR_ENTR #>  8 1100  B_STRPT           #>  9 1101  B_STRPT_VIRI      #> 10 1102  B_STRPT_HAEM      #> # ℹ 5,053 more rows  # 'ECO' or 'eco' is the WHONET code for E. coli: microorganisms.codes[microorganisms.codes$code == \"ECO\", ] #> # A tibble: 1 × 2 #>   code  mo           #>   <chr> <mo>         #> 1 ECO   B_ESCHR_COLI  # and therefore, 'eco' will be understood as E. coli in this package: mo_info(\"eco\") #> $mo #> [1] \"B_ESCHR_COLI\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Escherichia\" #>  #> $species #> [1] \"coli\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/escherichia-coli\" #>  #> $ref #> [1] \"Castellani et al., 1919\" #>  #> $snomed #>  [1] \"1095001000112106\" \"715307006\"        \"737528008\"        \"416989002\"        #>  [5] \"116397003\"        \"414097009\"        \"414098004\"        \"414099007\"        #>  [9] \"414100004\"        \"116395006\"        \"735270003\"        \"116396007\"        #> [13] \"83285000\"         \"116394005\"        \"112283007\"        \"710886005\"        #> [17] \"710887001\"        \"710888006\"        \"710889003\"        \"414132004\"        #> [21] \"721892009\"        \"416812001\"        \"416740004\"        \"417216001\"        #> [25] \"457541006\"        \"710253004\"        \"416530004\"        \"417189006\"        #> [29] \"409800005\"        \"713925008\"        \"444771000124108\"  \"838549008\"        #>  #> $lpsn #> [1] \"776057\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"11286021\" #>  #> $group_members #> character(0) #>   # works for all AMR functions: mo_is_intrinsic_resistant(\"eco\", ab = \"vancomycin\") #> [1] TRUE"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"data set containing species groups microbiological complexes, used clinical breakpoints table.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"tibble 534 observations 4 variables: mo_group ID species group / microbiological complex mo ID microorganism belonging species group / microbiological complex mo_group_name Name species group / microbiological complex, retrieved mo_name() mo_name Name microorganism belonging species group / microbiological complex, retrieved mo_name()","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups #> # A tibble: 534 × 4 #>    mo_group       mo           mo_group_name                   mo_name           #>    <mo>           <mo>         <chr>                           <chr>             #>  1 B_ACNTB_BMNN-C B_ACNTB_BMNN Acinetobacter baumannii complex Acinetobacter ba… #>  2 B_ACNTB_BMNN-C B_ACNTB_CLCC Acinetobacter baumannii complex Acinetobacter ca… #>  3 B_ACNTB_BMNN-C B_ACNTB_LCTC Acinetobacter baumannii complex Acinetobacter di… #>  4 B_ACNTB_BMNN-C B_ACNTB_NSCM Acinetobacter baumannii complex Acinetobacter no… #>  5 B_ACNTB_BMNN-C B_ACNTB_PITT Acinetobacter baumannii complex Acinetobacter pi… #>  6 B_ACNTB_BMNN-C B_ACNTB_SFRT Acinetobacter baumannii complex Acinetobacter se… #>  7 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex    Bacteroides frag… #>  8 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex    Bacteroides ovat… #>  9 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex    Bacteroides thet… #> 10 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex    Bacteroides vulg… #> # ℹ 524 more rows  # these are all species in the Bacteroides fragilis group, as per WHONET: microorganisms.groups[microorganisms.groups$mo_group == \"B_BCTRD_FRGL-C\", ] #> # A tibble: 5 × 4 #>   mo_group       mo           mo_group_name                mo_name               #>   <mo>           <mo>         <chr>                        <chr>                 #> 1 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex Bacteroides fragilis  #> 2 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex Bacteroides ovatus    #> 3 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex Bacteroides thetaiot… #> 4 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex Bacteroides vulgatus  #> 5 B_BCTRD_FRGL-C B_PRBCT_DSTS Bacteroides fragilis complex Parabacteroides dist…"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"data set containing full microbial taxonomy (last updated: June 24th, 2024) six kingdoms. data set backbone AMR package. MO codes can looked using .mo() microorganism properties can looked using mo_* functions. data set carefully crafted, yet made 100% reproducible public authoritative taxonomic sources (using script), namely: List Prokaryotic names Standing Nomenclature (LPSN) bacteria, MycoBank fungi, Global Biodiversity Information Facility (GBIF) others taxons.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"tibble 78 679 observations 26 variables: mo ID microorganism used package. unique identifier. fullname Full name, like \"Escherichia coli\". taxonomic ranks genus, species subspecies, 'pasted' text genus, species, subspecies. taxonomic ranks higher genus, name taxon. unique identifier. status  Status taxon, either \"accepted\", \"validly published\", \"synonym\", \"unknown\" kingdom, phylum, class, order, family, genus, species, subspecies Taxonomic rank microorganism. Note fungi, phylum equal taxonomic division. Also, fungi, subkingdom subdivision left since occur bacterial taxonomy. rank Text taxonomic rank microorganism, \"species\" \"genus\" ref Author(s) year related scientific publication. contains first surname year latest authors, e.g. \"Wallis et al. 2006 emend. Smith Jones 2018\" becomes \"Smith et al., 2018\". field directly retrieved source specified column source. Moreover, accents removed comply CRAN allows ASCII characters. oxygen_tolerance  Oxygen tolerance, either \"aerobe\", \"anaerobe\", \"anaerobe/microaerophile\", \"facultative anaerobe\", \"likely facultative anaerobe\", \"microaerophile\". data retrieved BacDive (see Source). Items contain \"likely\" missing BacDive extrapolated species within genus guess oxygen tolerance. Currently 68.3% ~39 000 bacteria data set contain oxygen tolerance. source Either \"GBIF\", \"LPSN\", \"Manually added\", \"MycoBank\", \"manually added\" (see Source) lpsn Identifier ('Record number') List Prokaryotic names Standing Nomenclature (LPSN). first/highest LPSN identifier keep one identifier per row. example, Acetobacter ascendens LPSN Record number 7864 11011. first available microorganisms data set. unique identifier, though available ~33 000 records. lpsn_parent LPSN identifier parent taxon lpsn_renamed_to LPSN identifier currently valid taxon mycobank Identifier ('MycoBank #') MycoBank. unique identifier, though available ~18 000 records. mycobank_parent MycoBank identifier parent taxon mycobank_renamed_to MycoBank identifier currently valid taxon gbif Identifier ('taxonID') Global Biodiversity Information Facility (GBIF). unique identifier, though available ~49 000 records. gbif_parent GBIF identifier parent taxon gbif_renamed_to GBIF identifier currently valid taxon prevalence Prevalence microorganism based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ), see mo_matching_score() full explanation snomed Systematized Nomenclature Medicine (SNOMED) code microorganism, version July 16th, 2024 (see Source). Use mo_snomed() retrieve quickly, see mo_property().","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Taxonomic entries imported order importance: List Prokaryotic names Standing Nomenclature (LPSN): Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. MycoBank: Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. Global Biodiversity Information Facility (GBIF): GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Furthermore, sources used additional details: BacDive: Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Systematized Nomenclature Medicine - Clinical Terms (SNOMED-CT): Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). Accessed https://www.cdc.gov/phin/php/phinvads/ July 16th, 2024. Grimont et al. (2007). Antigenic Formulae Salmonella Serovars, 9th Edition. Collaborating Centre Reference Research Salmonella (WHOCC-SALM). Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Please note entries based LPSN, MycoBank, GBIF (see ). Since sources incorporate entries based (recent) publications International Journal Systematic Evolutionary Microbiology (IJSEM), can happen year publication sometimes later one might expect. example, Staphylococcus pettenkoferi described first time Diagnostic Microbiology Infectious Disease 2002 (doi:10.1016/s0732-8893(02)00399-1 ), 2007 publication IJSEM followed (doi:10.1099/ijs.0.64381-0 ). Consequently, AMR package returns 2007 mo_year(\"S. pettenkoferi\").","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"included-taxa","dir":"Reference","previous_headings":"","what":"Included Taxa","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Included taxonomic data LPSN, MycoBank, GBIF : ~39 000 (sub)species kingdoms Archaea Bacteria ~28 000 species kingdom Fungi. kingdom Fungi large taxon almost 300,000 different (sub)species, microbial (rather macroscopic, like mushrooms). , fungi fit scope package. relevant fungi covered (species Aspergillus, Candida, Cryptococcus, Histoplasma, Pneumocystis, Saccharomyces Trichophyton). ~8 100 (sub)species kingdom Protozoa ~1 600 (sub)species 39 relevant genera kingdom Animalia (Strongyloides Taenia) ~22 000 previously accepted names included (sub)species (taxonomically renamed) complete taxonomic tree included (sub)species: kingdom subspecies identifier parent taxons year first author related scientific publication","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"manual-additions","dir":"Reference","previous_headings":"","what":"Manual additions","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"convenience, entries added manually: ~1 500 entries Salmonella, city-like serovars groups H 37 species groups (beta-haemolytic Streptococcus groups K, coagulase-negative Staphylococcus (CoNS), Mycobacterium tuberculosis complex, etc.), group compositions stored microorganisms.groups data set 1 entry Blastocystis (B.  hominis), although officially exist (Noel et al. 2005, PMID 15634993) 1 entry Moraxella (M. catarrhalis), formally named Branhamella catarrhalis (Catlin, 1970) though change never accepted within field clinical microbiology 8 'undefined' entries (unknown, unknown Gram-negatives, unknown Gram-positives, unknown yeast, unknown fungus, unknown anaerobic Gram-pos/Gram-neg bacteria) syntax used transform original data cleansed R format, can found .","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms #> # A tibble: 78,679 × 26 #>    mo          fullname   status kingdom phylum class order family genus species #>    <mo>        <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #>  1 B_GRAMN     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  2 B_GRAMP     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  3 B_ANAER-NEG (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  4 B_ANAER-POS (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  5 B_ANAER     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  6 F_FUNGUS    (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  7   UNKNOWN   (unknown … unkno… (unkno… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  8 P_PROTOZOAN (unknown … unkno… Protoz… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  9 F_YEAST     (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #> 10 F_AABRN     Aabaarnia  unkno… Fungi   Ascom… Leca… Ostr… \"\"     Aaba… \"\"      #> # ℹ 78,669 more rows #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Matching Score for Microorganisms — mo_matching_score","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm used .mo() mo_* functions determine probable match taxonomic records based user input.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_matching_score(x, n)"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"x user input value(s). n full taxonomic name, exists microorganisms$fullname.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm originally developed 2018 subsequently described : Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 . Later, work Bartlett et al. bacterial pathogens infecting humans (2022, doi:10.1099/mic.0.001269 ) incorporated, optimalisations algorithm made.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_reset_session() #> ℹ Reset 17 previously matched input values.  as.mo(\"E. coli\") #> Class 'mo' #> [1] B_ESCHR_COLI mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See ?mo_matching_score. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #>  #> Only the first 10 other matches of each record are shown. Run #> print(mo_uncertainties(), n = ...) to view more entries, or save #> mo_uncertainties() to an object.  mo_matching_score(   x = \"E. coli\",   n = c(\"Escherichia coli\", \"Entamoeba coli\") ) #> [1] 0.6875000 0.3809524"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of a Microorganism — mo_property","title":"Get Properties of a Microorganism — mo_property","text":"Use functions return specific property microorganism based latest accepted taxonomy. input values evaluated internally .mo(), makes possible use microbial abbreviations, codes names input. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of a Microorganism — mo_property","text":"","code":"mo_name(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_fullname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_shortname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_subspecies(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_species(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_genus(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_family(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_order(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_class(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_phylum(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_kingdom(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_domain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_type(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_status(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_pathogenicity(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gramstain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_negative(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_positive(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_yeast(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_intrinsic_resistant(x, ab, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_oxygen_tolerance(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_anaerobic(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_snomed(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_ref(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_authors(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_year(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_lpsn(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_mycobank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gbif(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_rank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_taxonomy(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_synonyms(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_current(x, language = get_AMR_locale(), ...)  mo_group_members(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_info(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_url(x, open = FALSE, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_property(x, property = \"fullname\", language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of a Microorganism — mo_property","text":"x character (vector) can coerced valid microorganism code .mo(). Can left blank auto-guessing column containing microorganism codes used data set, see Examples. language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). ... arguments passed .mo(), 'minimum_matching_score', 'ignore_pattern', 'remove_from_input'. ab (vector ) text can coerced valid antibiotic drug code .ab(). open Browse URL using browseURL(). property One column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\", must \"shortname\".","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of a Microorganism — mo_property","text":"integer case mo_year() ordered factor case mo_pathogenicity() list case mo_taxonomy(), mo_synonyms(), mo_snomed(), mo_info() logical case mo_is_anaerobic(), mo_is_gram_negative(), mo_is_gram_positive(), mo_is_intrinsic_resistant(), mo_is_yeast() named character case mo_synonyms() mo_url() character cases","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of a Microorganism — mo_property","text":"functions , default, keep old taxonomic properties, synonyms automatically replaced current taxonomy. Take example Enterobacter aerogenes, initially named 1960 renamed Klebsiella aerogenes 2017: mo_genus(\"Enterobacter aerogenes\") return \"Klebsiella\" (note renaming) mo_genus(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Enterobacter\" (-per-session warning name outdated) mo_ref(\"Enterobacter aerogenes\") return \"Tindall et al., 2017\" (note renaming) mo_ref(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Hormaeche et al., 1960\" (-per-session warning name outdated) short name (mo_shortname()) returns first character genus full species, \"E. coli\", species subspecies. Exceptions abbreviations staphylococci (\"CoNS\", Coagulase-Negative Staphylococci) beta-haemolytic streptococci (\"GBS\", Group B Streptococci). Please bear mind e.g. E. coli mean Escherichia coli (kingdom Bacteria) well Entamoeba coli (kingdom Protozoa). Returning full name done using .mo() internally, giving priority bacteria human pathogens, .e. \"E. coli\" considered Escherichia coli. result, mo_fullname(mo_shortname(\"Entamoeba coli\")) returns \"Escherichia coli\". Since top-level taxonomy sometimes referred 'kingdom' sometimes 'domain', functions mo_kingdom() mo_domain() return exact results. Determination human pathogenicity (mo_pathogenicity()) strongly based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ). function returns factor levels Pathogenic, Potentially pathogenic, Non-pathogenic, Unknown. Determination Gram stain (mo_gramstain()) based taxonomic kingdom phylum. Originally, Cavalier-Smith defined -called subkingdoms Negibacteria Posibacteria (2002, PMID 11837318), considered phyla Posibacteria: Actinobacteria, Chloroflexi, Firmicutes, Tenericutes. phyla later renamed Actinomycetota, Chloroflexota, Bacillota, Mycoplasmatota (2021, PMID 34694987). Bacteria phyla considered Gram-positive AMR package, except members class Negativicutes (within phylum Bacillota) Gram-negative. bacteria considered Gram-negative. Species outside kingdom Bacteria return value NA. Functions mo_is_gram_negative() mo_is_gram_positive() always return TRUE FALSE (NA input NA MO code UNKNOWN), thus always return FALSE species outside taxonomic kingdom Bacteria. Determination yeasts (mo_is_yeast()) based taxonomic kingdom class. Budding yeasts yeasts reproduce asexually process called budding, new cell develops small protrusion parent cell. Taxonomically, members phylum Ascomycota, class Saccharomycetes (also called Hemiascomycetes) Pichiomycetes. True yeasts quite specifically refers yeasts underlying order Saccharomycetales (Saccharomyces cerevisiae). Thus, microorganisms member taxonomic class Saccharomycetes Pichiomycetes, function return TRUE. returns FALSE otherwise (NA input NA MO code UNKNOWN). Determination intrinsic resistance (mo_is_intrinsic_resistant()) based intrinsic_resistant data set, based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). mo_is_intrinsic_resistant() function can vectorised argument x (input microorganisms) ab (input antimicrobials). Determination bacterial oxygen tolerance (mo_oxygen_tolerance()) based BacDive, see Source. function mo_is_anaerobic() returns TRUE oxygen tolerance \"anaerobe\", indicting obligate anaerobic species genus. always returns FALSE species outside taxonomic kingdom Bacteria. function mo_url() return direct URL online database entry, also shows scientific reference concerned species. MycoBank URL used fungi wherever available , LPSN URL bacteria wherever available, GBIF link otherwise. SNOMED codes (mo_snomed()) last updated July 16th, 2024. See Source microorganisms data set info. Old taxonomic names (-called 'synonyms') can retrieved mo_synonyms() (scientific reference name), current taxonomic name can retrieved mo_current(). functions return full names. output translated possible.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Get Properties of a Microorganism — mo_property","text":"function uses .mo() internally, uses advanced algorithm translate arbitrary user input valid taxonomy using -called matching score. can read public algorithm MO matching score page.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of a Microorganism — mo_property","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of a Microorganism — mo_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of a Microorganism — mo_property","text":"","code":"# taxonomic tree -----------------------------------------------------------  mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_phylum(\"Klebsiella pneumoniae\") #> [1] \"Pseudomonadota\" mo_class(\"Klebsiella pneumoniae\") #> [1] \"Gammaproteobacteria\" mo_order(\"Klebsiella pneumoniae\") #> [1] \"Enterobacterales\" mo_family(\"Klebsiella pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"Klebsiella pneumoniae\") #> [1] \"pneumoniae\" mo_subspecies(\"Klebsiella pneumoniae\") #> [1] \"\"   # full names and short names -----------------------------------------------  mo_name(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_fullname(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_shortname(\"Klebsiella pneumoniae\") #> [1] \"K. pneumoniae\"   # other properties ---------------------------------------------------------  mo_pathogenicity(\"Klebsiella pneumoniae\") #> [1] Pathogenic #> Levels: Pathogenic < Potentially pathogenic < Non-pathogenic < Unknown mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\" mo_snomed(\"Klebsiella pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_rank(\"Klebsiella pneumoniae\") #> [1] \"species\" mo_url(\"Klebsiella pneumoniae\") #>                                Klebsiella pneumoniae  #> \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\"  mo_is_yeast(c(\"Candida\", \"Trichophyton\", \"Klebsiella\")) #> [1]  TRUE FALSE FALSE  mo_group_members(c(   \"Streptococcus group A\",   \"Streptococcus group C\",   \"Streptococcus group G\",   \"Streptococcus group L\" )) #> $`Streptococcus Group A` #> [1] \"Streptococcus pyogenes\" #>  #> $`Streptococcus Group C` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #> [4] \"Streptococcus equi\"                      #> [5] \"Streptococcus equi equi\"                 #> [6] \"Streptococcus equi ruminatorum\"          #> [7] \"Streptococcus equi zooepidemicus\"        #>  #> $`Streptococcus Group G` #> [1] \"Streptococcus canis\"                     #> [2] \"Streptococcus dysgalactiae\"              #> [3] \"Streptococcus dysgalactiae dysgalactiae\" #> [4] \"Streptococcus dysgalactiae equisimilis\"  #>  #> $`Streptococcus Group L` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #>    # scientific reference -----------------------------------------------------  mo_ref(\"Klebsiella aerogenes\") #> [1] \"Tindall et al., 2017\" mo_authors(\"Klebsiella aerogenes\") #> [1] \"Tindall et al.\" mo_year(\"Klebsiella aerogenes\") #> [1] 2017 mo_synonyms(\"Klebsiella aerogenes\") #>   Hormaeche et al., 1960     Bascomb et al., 1971  #> \"Enterobacter aerogenes\"     \"Klebsiella mobilis\"  mo_lpsn(\"Klebsiella aerogenes\") #> [1] \"777146\" mo_gbif(\"Klebsiella aerogenes\") #> [1] \"9281703\" mo_mycobank(\"Candida albicans\") #> [1] \"256187\" mo_mycobank(\"Candida krusei\") #> [1] \"337013\" mo_mycobank(\"Candida krusei\", keep_synonyms = TRUE) #> Warning: Function as.mo() returned one old taxonomic name. Use as.mo(..., #> keep_synonyms = FALSE) to clean the input to currently accepted taxonomic #> names, or set the R option AMR_keep_synonyms to FALSE. This warning #> will be shown once per session. #> [1] \"268707\"   # abbreviations known in the field -----------------------------------------  mo_genus(\"MRSA\") #> [1] \"Staphylococcus\" mo_species(\"MRSA\") #> [1] \"aureus\" mo_shortname(\"VISA\") #> [1] \"S. aureus\" mo_gramstain(\"VISA\") #> [1] \"Gram-positive\"  mo_genus(\"EHEC\") #> [1] \"Escherichia\" mo_species(\"EIEC\") #> [1] \"coli\" mo_name(\"UPEC\") #> [1] \"Escherichia coli\"   # known subspecies ---------------------------------------------------------  mo_fullname(\"K. pneu rh\") #> [1] \"Klebsiella pneumoniae rhinoscleromatis\" mo_shortname(\"K. pneu rh\") #> [1] \"K. pneumoniae\"  # \\donttest{ # Becker classification, see ?as.mo ----------------------------------------  mo_fullname(\"Staph epidermidis\") #> [1] \"Staphylococcus epidermidis\" mo_fullname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"Coagulase-negative Staphylococcus (CoNS)\" mo_shortname(\"Staph epidermidis\") #> [1] \"S. epidermidis\" mo_shortname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"CoNS\"   # Lancefield classification, see ?as.mo ------------------------------------  mo_fullname(\"Strep agalactiae\") #> [1] \"Streptococcus agalactiae\" mo_fullname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"Streptococcus Group B\" mo_shortname(\"Strep agalactiae\") #> [1] \"S. agalactiae\" mo_shortname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"GBS\"   # language support  --------------------------------------------------------  mo_gramstain(\"Klebsiella pneumoniae\", language = \"de\") # German #> [1] \"Gramnegativ\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"nl\") # Dutch #> [1] \"Gram-negatief\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"es\") # Spanish #> [1] \"Gram negativo\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"el\") # Greek #> [1] \"Αρνητικό κατά Gram\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"uk\") # Ukrainian #> [1] \"Грамнегативні\"  # mo_type is equal to mo_kingdom, but mo_kingdom will remain untranslated mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_kingdom(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, no effect #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, translated #> [1] \"细菌\"  mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"de\") #> [1] \"Streptococcus Gruppe A\" mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"uk\") #> [1] \"Streptococcus Група A\"   # other --------------------------------------------------------------------  # gram stains and intrinsic resistance can be used as a filter in dplyr verbs if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_gram_positive()) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for mo_is_gram_positive() #> ℹ Using column 'mo' as input for mo_genus() #> # A tibble: 18 × 2 #>    `mo_genus()`        n #>    <chr>           <int> #>  1 Staphylococcus    840 #>  2 Streptococcus     275 #>  3 Enterococcus       83 #>  4 Corynebacterium    17 #>  5 Micrococcus         6 #>  6 Gemella             3 #>  7 Aerococcus          2 #>  8 Cutibacterium       1 #>  9 Dermabacter         1 #> 10 Fusibacter          1 #> 11 Globicatella        1 #> 12 Granulicatella      1 #> 13 Lactobacillus       1 #> 14 Leuconostoc         1 #> 15 Listeria            1 #> 16 Paenibacillus       1 #> 17 Rothia              1 #> 18 Schaalia            1 if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_intrinsic_resistant(ab = \"vanco\")) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for mo_is_intrinsic_resistant() #> ℹ Using column 'mo' as input for mo_genus() #> # A tibble: 19 × 2 #>    `mo_genus()`         n #>    <chr>            <int> #>  1 Escherichia        467 #>  2 Klebsiella          77 #>  3 Proteus             39 #>  4 Pseudomonas         30 #>  5 Serratia            25 #>  6 Enterobacter        23 #>  7 Citrobacter         11 #>  8 Haemophilus          9 #>  9 Acinetobacter        6 #> 10 Morganella           6 #> 11 Pantoea              4 #> 12 Salmonella           3 #> 13 Neisseria            2 #> 14 Stenotrophomonas     2 #> 15 Campylobacter        1 #> 16 Enterococcus         1 #> 17 Hafnia               1 #> 18 Leuconostoc          1 #> 19 Pseudescherichia     1  # get a list with the complete taxonomy (from kingdom to subspecies) mo_taxonomy(\"Klebsiella pneumoniae\") #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>   # get a list with the taxonomy, the authors, Gram-stain, # SNOMED codes, and URL to the online database mo_info(\"Klebsiella pneumoniae\") #> $mo #> [1] \"B_KLBSL_PNMN\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\" #>  #> $ref #> [1] \"Trevisan, 1887\" #>  #> $snomed #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  #> $lpsn #> [1] \"777151\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"3221874\" #>  #> $group_members #> character(0) #>  # }"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":null,"dir":"Reference","previous_headings":"","what":"User-Defined Reference Data Set for Microorganisms — mo_source","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"functions can used predefine reference used .mo() consequently mo_* functions (mo_genus() mo_gramstain()). fastest way organisation (analysis) specific codes picked translated package, since bother setting .","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"","code":"set_mo_source(path, destination = getOption(\"AMR_mo_source\",   \"~/mo_source.rds\"))  get_mo_source(destination = getOption(\"AMR_mo_source\", \"~/mo_source.rds\"))"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"path Location reference file, can text file (comma-, tab- pipe-separated) Excel file (see Details). Can also \"\", NULL FALSE delete reference file. destination Destination compressed data file - default user's home directory.","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"reference file can text file separated commas (CSV) tabs pipes, Excel file (either 'xls' 'xlsx' format) R object file (extension '.rds'). use Excel file, need readxl package installed. set_mo_source() check file validity: must data.frame, must column named \"mo\" contains values microorganisms$mo microorganisms$fullname must reference column defined values. tests pass, set_mo_source() read file R ask export \"~/mo_source.rds\". CRAN policy disallows packages write file system, although 'exceptions may allowed interactive sessions package obtains confirmation user'. reason, function works interactive sessions user can specifically confirm allow file created. destination file can set destination argument defaults user's home directory. can also set package option AMR_mo_source, e.g. options(AMR_mo_source = \"/location/file.rds\"). created compressed data file \"mo_source.rds\" used default MO determination (function .mo() consequently mo_* functions like mo_genus() mo_gramstain()). location timestamp original file saved attribute compressed data file. function get_mo_source() return data set reading \"mo_source.rds\" readRDS(). original file changed (checking location timestamp original file), call set_mo_source() update data file automatically used interactive session. Reading Excel file (.xlsx) one row size 8-9 kB. compressed file created set_mo_source() size 0.1 kB can read get_mo_source() couple microseconds (millionths second).","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"how-to-setup","dir":"Reference","previous_headings":"","what":"How to Setup","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"Imagine data sheet Excel file. first column contains organisation specific codes, second column contains valid taxonomic names:   save \"/Users//Documents/ourcodes.xlsx\". Now set source:   now created file \"~/mo_source.rds\" contents Excel file. first column foreign values 'mo' column kept creating RDS file. now can use functions:   edit Excel file , say, adding row 4 like :   ...new usage MO function package update data file:   delete reference data file, just use \"\", NULL FALSE input set_mo_source():   original file (previous case Excel file) moved deleted, mo_source.rds file removed upon next use .mo() mo_* function.","code":"|         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 |                    |                       | set_mo_source(\"/Users/me/Documents/ourcodes.xlsx\") #> NOTE: Created mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>       \"Organisation XYZ\" and \"mo\" as.mo(\"lab_mo_ecoli\") #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_mo_kpneumoniae\") #> [1] \"Klebsiella\"  # other input values still work too as.mo(c(\"Escherichia coli\", \"E. coli\", \"lab_mo_ecoli\")) #> NOTE: Translation to one microorganism was guessed with uncertainty. #>       Use mo_uncertainties() to review it. #> Class 'mo' #> [1] B_ESCHR_COLI B_ESCHR_COLI B_ESCHR_COLI |         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 | lab_Staph_aureus   | Staphylococcus aureus | 5 |                    |                       | as.mo(\"lab_mo_ecoli\") #> NOTE: Updated mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>        \"Organisation XYZ\" and \"mo\" #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_Staph_aureus\") #> [1] \"Staphylococcus\" set_mo_source(NULL) #> Removed mo_source file '/Users/me/mo_source.rds'"},{"path":"https://amr-for-r.org/reference/pca.html","id":null,"dir":"Reference","previous_headings":"","what":"Principal Component Analysis (for AMR) — pca","title":"Principal Component Analysis (for AMR) — pca","text":"Performs principal component analysis (PCA) based data set automatic determination afterwards plotting groups labels, automatic filtering suitable (.e. non-empty numeric) variables.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"pca(x, ..., retx = TRUE, center = TRUE, scale. = TRUE, tol = NULL,   rank. = NULL)"},{"path":"https://amr-for-r.org/reference/pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Principal Component Analysis (for AMR) — pca","text":"x data.frame containing numeric columns. ... Columns x selected PCA, can unquoted since supports quasiquotation. retx logical value indicating whether rotated variables     returned. center logical value indicating whether variables     shifted zero centered. Alternately, vector     length equal number columns x can supplied.     value passed scale. scale. logical value indicating whether variables     scaled unit variance analysis takes     place.  default FALSE consistency S,     general scaling advisable.  Alternatively, vector length     equal number columns x can supplied.      value passed scale. tol value indicating magnitude components     omitted. (Components omitted     standard deviations less equal tol times     standard deviation first component.)  default null     setting, components omitted (unless rank. specified     less min(dim(x)).).  settings tol     tol = 0 tol = sqrt(.Machine$double.eps),     omit essentially constant components. rank. optionally, number specifying maximal rank, .e.,     maximal number principal components used.  Can set     alternative addition tol, useful notably     desired rank considerably smaller dimensions matrix.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Principal Component Analysis (for AMR) — pca","text":"object classes pca prcomp","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Principal Component Analysis (for AMR) — pca","text":"pca() function takes data.frame input performs actual PCA R function prcomp(). result pca() function prcomp object, additional attribute non_numeric_cols vector column names columns contain numeric values. probably groups labels, used ggplot_pca().","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    pca_result   summary(pca_result)   # old base R plotting method:   biplot(pca_result) } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (minimum = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # new ggplot2 plotting method using this package: if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) }  if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"Title here\") }  # }"},{"path":"https://amr-for-r.org/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Plotting Helpers for AMR Data Analysis — plot","title":"Plotting Helpers for AMR Data Analysis — plot","text":"Functions plot classes sir, mic disk, support base R ggplot2. Especially scale_*_mic() functions relevant wrappers plot MIC values ggplot2. allows custom MIC ranges plot intermediate log2 levels missing MIC values.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"scale_x_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_y_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_colour_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_fill_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_x_sir(colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), eucast_I = getOption(\"AMR_guideline\",   \"EUCAST\") == \"EUCAST\", ...)  scale_colour_sir(colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), eucast_I = getOption(\"AMR_guideline\",   \"EUCAST\") == \"EUCAST\", ...)  scale_fill_sir(colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), eucast_I = getOption(\"AMR_guideline\",   \"EUCAST\") == \"EUCAST\", ...)  # S3 method for class 'mic' plot(x, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   main = deparse(substitute(x)), ylab = translate_AMR(\"Frequency\", language   = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'mic' autoplot(object, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' plot(x, main = deparse(substitute(x)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Disk diffusion diameter (mm)\", language = language),   mo = NULL, ab = NULL, guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' autoplot(object, mo = NULL, ab = NULL,   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language), xlab = translate_AMR(\"Disk diffusion diameter (mm)\",   language = language), guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'sir' plot(x, ylab = translate_AMR(\"Percentage\", language =   language), xlab = translate_AMR(\"Antimicrobial Interpretation\", language =   language), main = deparse(substitute(x)), language = get_AMR_locale(),   ...)  # S3 method for class 'sir' autoplot(object, title = deparse(substitute(object)),   xlab = translate_AMR(\"Antimicrobial Interpretation\", language = language),   ylab = translate_AMR(\"Frequency\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), ...)  facet_sir(facet = c(\"interpretation\", \"antibiotic\"), nrow = NULL)  scale_y_percent(breaks = function(x) seq(0, max(x, na.rm = TRUE), 0.1),   limits = c(0, NA))  scale_sir_colours(..., aesthetics, colours_SIR = c(\"#3CAEA3\", \"#F6D55C\",   \"#ED553B\"))  theme_sir()  labels_sir_count(position = NULL, x = \"antibiotic\",   translate_ab = \"name\", minimum = 30, language = get_AMR_locale(),   combine_SI = TRUE, datalabels.size = 3, datalabels.colour = \"grey15\")"},{"path":"https://amr-for-r.org/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plotting Helpers for AMR Data Analysis — plot","text":"keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values (using rescale_mic()), e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). Note: rescales values filter - use ggplot2 limits argument separately exclude values plot. ... Arguments passed methods. colours_SIR Colours use filling bars, must vector three values (order S, R). default colours colour-blind friendly. language Language used translate 'Susceptible', 'Increased exposure'/'Intermediate' 'Resistant' - default system language (see get_AMR_locale()) can overwritten setting package option AMR_locale, e.g. options(AMR_locale = \"de\"), see translate. Use language = NULL prevent translation. eucast_I logical indicate whether '' must interpreted \"Susceptible, increased exposure\". TRUE default AMR interpretation guideline set EUCAST (default). FALSE, interpreted \"Intermediate\". x, object Values created .mic(), .disk() .sir() (random_* variants, random_mic()). mo (vector ) text can coerced valid microorganism code .mo(). ab (vector ) text can coerced valid antimicrobial drug code .ab(). guideline Interpretation guideline use - default latest included EUCAST guideline, see Details. main, title Title plot. xlab, ylab Axis title. expand logical indicate whether range x axis expanded lowest highest value. MIC values, intermediate values factors 2 starting highest MIC value. disk diameters, whole diameter range filled. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. nrow (using facet) number rows. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. aesthetics Aesthetics apply colours - default \"fill\" can also (combination ) \"alpha\", \"colour\", \"fill\", \"linetype\", \"shape\" \"size\". position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. datalabels.size Size datalabels. datalabels.colour Colour datalabels.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Plotting Helpers for AMR Data Analysis — plot","text":"autoplot() functions return ggplot model extendible ggplot2 function.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-mic-functions","dir":"Reference","previous_headings":"","what":"The scale_*_mic() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_mic(), scale_y_mic(), scale_colour_mic(), scale_fill_mic() functions allow plot mic class (MIC values) continuous, logarithmic scale. also allow rescale MIC range 'inside' 'outside' range required, retain operators MIC values (>=) desired. Missing intermediate log2 levels plotted .","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-sir-functions","dir":"Reference","previous_headings":"","what":"The scale_*_sir() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_sir(), scale_colour_sir(), scale_fill_sir() functions allow plot sir class right order (S < SDD < < R < NI). default, translate S//R values interpretative text (\"Susceptible\", \"Resistant\", etc.) 20 supported languages (use language = NULL keep S//R). Also, except scale_x_sir(), set colour-blind friendly colours colour fill aesthetics.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"additional-ggplot-functions","dir":"Reference","previous_headings":"","what":"Additional ggplot2 Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"package contains functions extend ggplot2 package, help visualising AMR data results. functions internally used ggplot_sir() . facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() allows set colours aesthetic, even shape linetype. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage number isolates, using ggplot2::geom_text(). interpretation \"\" named \"Increased exposure\" EUCAST guidelines since 2019, named \"Intermediate\" cases. interpreting MIC values well disk diffusion diameters, default guideline EUCAST 2025, unless package option AMR_guideline set. See .sir() information.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"some_mic_values <- random_mic(size = 100) some_disk_values <- random_disk(size = 100, mo = \"Escherichia coli\", ab = \"cipro\") some_sir_values <- random_sir(50, prob_SIR = c(0.55, 0.05, 0.30))  # \\donttest{ # Plotting using ggplot2's autoplot() for MIC, disk, and SIR ----------- if (require(\"ggplot2\")) {   autoplot(some_mic_values) }  if (require(\"ggplot2\")) {   # when providing the microorganism and antibiotic, colours will show interpretations:   autoplot(some_mic_values, mo = \"Escherichia coli\", ab = \"cipro\") } #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE if (require(\"ggplot2\")) {   # support for 20 languages, various guidelines, and many options   autoplot(some_disk_values,     mo = \"Escherichia coli\", ab = \"cipro\",     guideline = \"CLSI 2024\", language = \"no\",     title = \"Disk diffusion from the North\"   ) } #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE   # Plotting using scale_x_mic() ----------------------------------------- if (require(\"ggplot2\")) {   mic_plot <- ggplot(     data.frame(       mics = as.mic(c(0.25, \"<=4\", 4, 8, 32, \">=32\")),       counts = c(1, 1, 2, 2, 3, 3)     ),     aes(mics, counts)   ) +     geom_col()   mic_plot +     labs(title = \"without scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic() +     labs(title = \"with scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(keep_operators = \"all\") +     labs(title = \"with scale_x_mic() keeping all operators\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(1, 16)) +     labs(title = \"with scale_x_mic() using a manual 'within' range\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(0.032, 256)) +     labs(title = \"with scale_x_mic() using a manual 'outside' range\") }    # Plotting using scale_y_mic() ----------------------------------------- some_groups <- sample(LETTERS[1:5], 20, replace = TRUE)  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey\", fill = NA) +     scale_y_mic() }  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey\", fill = NA) +     scale_y_mic(mic_range = c(NA, 0.25)) }    # Plotting using scale_x_sir() ----------------------------------------- if (require(\"ggplot2\")) {   ggplot(     data.frame(       x = c(\"I\", \"R\", \"S\"),       y = c(45, 323, 573)     ),     aes(x, y)   ) +     geom_col() +     scale_x_sir() }    # Plotting using scale_y_mic() and scale_colour_sir() ------------------ if (require(\"ggplot2\")) {   plain <- ggplot(     data.frame(       mic = some_mic_values,       group = some_groups,       sir = as.sir(some_mic_values,         mo = \"E. coli\",         ab = \"cipro\"       )     ),     aes(x = group, y = mic, colour = sir)   ) +     theme_minimal() +     geom_boxplot(fill = NA, colour = \"grey\") +     geom_jitter(width = 0.25)    plain } #>  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. #>  #> Interpreting MIC values: 'cipro' (CIP, ciprofloxacin), EUCAST 2025... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli - assuming body site 'Non-meningitis'.  if (require(\"ggplot2\")) {   # and now with our MIC and SIR scale functions:   plain +     scale_y_mic() +     scale_colour_sir() }  if (require(\"ggplot2\")) {   plain +     scale_y_mic(mic_range = c(0.005, 32), name = \"Our MICs!\") +     scale_colour_sir(       language = \"pt\",       name = \"Support in 20 languages\"     ) }  # }  # Plotting using base R's plot() ---------------------------------------  plot(some_mic_values)  # when providing the microorganism and antibiotic, colours will show interpretations: plot(some_mic_values, mo = \"S. aureus\", ab = \"ampicillin\") #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE  plot(some_disk_values)  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\") #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\", language = \"nl\") #> Error in rbindlist(l, use.names, fill, idcol, ignore.attr): Class attribute on column 4 of item 2 does not match with column 4 of item 1. You can deactivate this safety-check by using ignore.attr=TRUE  plot(some_sir_values)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate Antimicrobial Resistance — proportion","title":"Calculate Antimicrobial Resistance — proportion","text":"functions can used calculate (co-)resistance susceptibility microbial isolates (.e. percentage S, SI, , IR R). functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. resistance() used calculate resistance, susceptibility() used calculate susceptibility.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"resistance(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  susceptibility(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  sir_confidence_interval(..., ab_result = \"R\", minimum = 30,   as_percent = FALSE, only_all_tested = FALSE, confidence_level = 0.95,   side = \"both\", collapse = FALSE)  proportion_R(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_IR(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_I(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_SI(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_S(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)  sir_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Calculate Antimicrobial Resistance — proportion","text":"M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate Antimicrobial Resistance — proportion","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. Use multiple columns calculate (lack ) co-resistance: probability one two drugs resistant susceptible result. See Examples. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. as_percent logical indicate whether output must returned hundred fold % sign (character). value 0.123456 returned \"12.3%\". only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . ab_result Antibiotic results test , must one values \"S\", \"SDD\", \"\", \"R\". confidence_level confidence level returned confidence interval. calculation, number S SI isolates, R isolates compared total number available isolates R, S, using binom.test(), .e., Clopper-Pearson method. side side confidence interval return. default \"\" length 2 vector, can also (abbreviated ) \"min\"/\"left\"/\"lower\"/\"less\" \"max\"/\"right\"/\"higher\"/\"greater\". collapse logical indicate whether output values 'collapsed', .e. merged together one value, character value use collapsing. data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate Antimicrobial Resistance — proportion","text":"double , as_percent = TRUE, character.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate Antimicrobial Resistance — proportion","text":"automated comprehensive analysis, consider using antibiogram() wisca(), streamline many aspects susceptibility reporting , importantly, also support WISCA. functions described offer hands-, manual approach greater customisation. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine data set one four available algorithms. function resistance() equal function proportion_R(). function susceptibility() equal function proportion_SI(). Since AMR v3.0, proportion_SI() proportion_I() include dose-dependent susceptibility ('SDD'). Use sir_confidence_interval() calculate confidence interval, relies binom.test(), .e., Clopper-Pearson method. function returns vector length 2 default antimicrobial resistance. Change side argument \"left\"/\"min\" \"right\"/\"max\" return single value, change ab_result argument e.g. c(\"S\", \"\") test antimicrobial susceptibility, see Examples. functions meant count isolates, calculate proportion resistance/susceptibility. Use count_*() functions count isolates. function susceptibility() essentially equal count_susceptible()/count_all(). Low counts can influence outcome - proportion_*() functions may camouflage , since return proportion (albeit dependent minimum argument). function proportion_df() takes variable data sir class (created .sir()) calculates proportions S, , R. also supports grouped variables. function sir_df() works exactly like proportion_df(), adds number isolates.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Calculate Antimicrobial Resistance — proportion","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Calculate Antimicrobial Resistance — proportion","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # base R ------------------------------------------------------------ # determines %R resistance(example_isolates$AMX) #> [1] 0.5955556 sir_confidence_interval(example_isolates$AMX) #> [1] 0.5688204 0.6218738 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975 ) #> [1] 0.5650148 0.6255670 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975,   collapse = \", \" ) #> [1] \"0.565, 0.626\"  # determines %S+I: susceptibility(example_isolates$AMX) #> [1] 0.4044444 sir_confidence_interval(example_isolates$AMX,   ab_result = c(\"S\", \"I\") ) #> [1] 0.3781262 0.4311796  # be more specific proportion_S(example_isolates$AMX) #> [1] 0.4022222 proportion_SI(example_isolates$AMX) #> [1] 0.4044444 proportion_I(example_isolates$AMX) #> [1] 0.002222222 proportion_IR(example_isolates$AMX) #> [1] 0.5977778 proportion_R(example_isolates$AMX) #> [1] 0.5955556  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       r = resistance(CIP),       n = n_sir(CIP)     ) # n_sir works like n_distinct in dplyr, see ?n_sir } #> # A tibble: 3 × 3 #>   ward           r     n #>   <chr>      <dbl> <int> #> 1 Clinical   0.147   869 #> 2 ICU        0.190   447 #> 3 Outpatient 0.161    93 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       cipro_R = resistance(CIP),       ci_min = sir_confidence_interval(CIP, side = \"min\"),       ci_max = sir_confidence_interval(CIP, side = \"max\"),     ) } #> # A tibble: 3 × 4 #>   ward       cipro_R ci_min ci_max #>   <chr>        <dbl>  <dbl>  <dbl> #> 1 Clinical     0.147 0.124   0.173 #> 2 ICU          0.190 0.155   0.230 #> 3 Outpatient   0.161 0.0932  0.252 if (require(\"dplyr\")) {   # scoped dplyr verbs with antimicrobial selectors   # (you could also use across() of course)   example_isolates %>%     group_by(ward) %>%     summarise_at(       c(aminoglycosides(), carbapenems()),       resistance     ) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `KAN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = #> \"Outpatient\" (minimum = 30). #> # A tibble: 3 × 7 #>   ward         GEN   TOB   AMK   KAN    IPM    MEM #>   <chr>      <dbl> <dbl> <dbl> <dbl>  <dbl>  <dbl> #> 1 Clinical   0.229 0.315 0.626     1 0.0498 0.0458 #> 2 ICU        0.290 0.400 0.662     1 0.0862 0.0894 #> 3 Outpatient 0.2   0.368 0.605    NA 0.0541 0.0541 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = resistance(CIP, as_percent = TRUE),       SI = susceptibility(CIP, as_percent = TRUE),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Calculate co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy:   example_isolates %>% susceptibility(AMC) # %SI = 76.3%   example_isolates %>% count_all(AMC) #   n = 1879    example_isolates %>% susceptibility(GEN) # %SI = 75.4%   example_isolates %>% count_all(GEN) #   n = 1855    example_isolates %>% susceptibility(AMC, GEN) # %SI = 94.1%   example_isolates %>% count_all(AMC, GEN) #   n = 1939     # See Details on how `only_all_tested` works. Example:   example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN),       denominator = count_all(AMC, GEN),       proportion = susceptibility(AMC, GEN)     )    example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN, only_all_tested = TRUE),       denominator = count_all(AMC, GEN, only_all_tested = TRUE),       proportion = susceptibility(AMC, GEN, only_all_tested = TRUE)     )     example_isolates %>%     group_by(ward) %>%     summarise(       cipro_p = susceptibility(CIP, as_percent = TRUE),       cipro_n = count_all(CIP),       genta_p = susceptibility(GEN, as_percent = TRUE),       genta_n = count_all(GEN),       combination_p = susceptibility(CIP, GEN, as_percent = TRUE),       combination_n = count_all(CIP, GEN)     )    # Get proportions S/I/R immediately of all sir columns   example_isolates %>%     select(AMX, CIP) %>%     proportion_df(translate = FALSE)    # It also supports grouping variables   # (use sir_df to also include the count)   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     sir_df(translate = FALSE) } #> # A tibble: 12 × 7 #>    ward       antibiotic interpretation value ci_min ci_max isolates #>    <chr>      <chr>      <ord>          <dbl>  <dbl>  <dbl>    <int> #>  1 Clinical   AMX        SI             0.423 0.389   0.457      357 #>  2 Clinical   AMX        R              0.577 0.543   0.611      487 #>  3 Clinical   CIP        SI             0.853 0.827   0.876      741 #>  4 Clinical   CIP        R              0.147 0.124   0.173      128 #>  5 ICU        AMX        SI             0.369 0.323   0.417      158 #>  6 ICU        AMX        R              0.631 0.583   0.677      270 #>  7 ICU        CIP        SI             0.810 0.770   0.845      362 #>  8 ICU        CIP        R              0.190 0.155   0.230       85 #>  9 Outpatient AMX        SI             0.397 0.288   0.515       31 #> 10 Outpatient AMX        R              0.603 0.485   0.712       47 #> 11 Outpatient CIP        SI             0.839 0.748   0.907       78 #> 12 Outpatient CIP        R              0.161 0.0932  0.252       15 # }"},{"path":"https://amr-for-r.org/reference/random.html","id":null,"dir":"Reference","previous_headings":"","what":"Random MIC Values/Disk Zones/SIR Generation — random","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"functions can used generating random MIC values disk diffusion diameters, AMR data analysis practice. providing microorganism antimicrobial drug, generated results reflect reality much possible.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(size = NULL, mo = NULL, ab = NULL, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, ...)  random_sir(size = NULL, prob_SIR = c(0.33, 0.33, 0.33), ...)"},{"path":"https://amr-for-r.org/reference/random.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"size Desired size returned vector. used data.frame call dplyr verb, get current (group) size left blank. mo character can coerced valid microorganism code .mo(). ab character can coerced valid antimicrobial drug code .ab(). ... Ignored, place allow future extensions. prob_SIR vector length 3: probabilities \"S\" (1st value), \"\" (2nd value) \"R\" (3rd value).","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"class mic random_mic() (see .mic()) class disk random_disk() (see .disk())","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"base R function sample() used generating values. Generated values based EUCAST 2025 guideline implemented clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(25) #> Class 'mic' #>  [1] <=0.005 0.25    1       0.0625  128     0.01    1       4       128     #> [10] <=0.005 0.25    0.5     0.125   0.01    0.25    2       8       16      #> [19] 0.125   0.5     >=256   >=256   >=256   0.25    16      random_disk(25) #> Class 'disk' #>  [1] 24 14 46 41  9  8 22 41 50 38 48 48 28 43 47 30 13 13 38 14 48 47 21  6 22 random_sir(25) #> Class 'sir' #>  [1] I I I I I I S R R S I S S R I R R R I S S R R I R  # \\donttest{ # make the random generation more realistic by setting a bug and/or drug: random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 0.025  4      1      0.0625 0.005  0.002  2      0.002  >=128  0.0625 #> [11] 0.125  0.5    0.002  0.01   0.001  0.002  0.01   32     64     0.005  #> [21] 0.01   1      4      1      32     random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] <=1 4   4   2   32  4   32  16  <=1 32  8   8   32  8   4   32  <=1 <=1 16  #> [20] 8   32  8   16  4   8   random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] 0.125    >=16     0.125    >=16     2        0.5      1        0.5      #>  [9] 0.125    0.5      <=0.0625 0.25     0.25     0.5      >=16     >=16     #> [17] 1        >=16     8        0.25     8        0.25     >=16     >=16     #> [25] 0.125     random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 42 36 49 13 45 50 37 33 30 14 23 15 30  9 21 47 32 17 48 47 24 23 14 27 48 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 13 16 13 16 13 11 17 12 16 14 14 15 11 16 12 13 14 12 13 12 15 12 12 13 17 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 16 20 25 24 21 22 21 16 15 18 18 25 19 26 27 26 21 21 19 25 15 22 19 24 26 # }"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":null,"dir":"Reference","previous_headings":"","what":"Predict Antimicrobial Resistance — resistance_predict","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Create prediction model predict antimicrobial resistance next years. Standard errors (SE) returned columns se_min se_max. See Examples real live example. NOTE: functions deprecated removed future version. Use AMR package combined tidymodels framework instead, written basic short introduction website.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"resistance_predict(x, col_ab, col_date = NULL, year_min = NULL,   year_max = NULL, year_every = 1, minimum = 30, model = NULL,   I_as_S = TRUE, preserve_measurements = TRUE, info = interactive(), ...)  sir_predict(x, col_ab, col_date = NULL, year_min = NULL, year_max = NULL,   year_every = 1, minimum = 30, model = NULL, I_as_S = TRUE,   preserve_measurements = TRUE, info = interactive(), ...)  # S3 method for class 'resistance_predict' plot(x, main = paste(\"Resistance Prediction of\",   x_name), ...)  ggplot_sir_predict(x, main = paste(\"Resistance Prediction of\", x_name),   ribbon = TRUE, ...)  # S3 method for class 'resistance_predict' autoplot(object,   main = paste(\"Resistance Prediction of\", x_name), ribbon = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Predict Antimicrobial Resistance — resistance_predict","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_ab Column name x containing antimicrobial interpretations (\"R\", \"\" \"S\"). col_date Column name date, used calculate years column consist years already - default first column date class. year_min Lowest year use prediction model, dafaults lowest year col_date. year_max Highest year use prediction model - default 10 years today. year_every Unit sequence lowest year found data year_max. minimum Minimal amount available isolates per year include. Years containing less observations estimated model. model statistical model choice. generalised linear regression model binomial distribution (.e. using glm(..., family = binomial), assuming period zero resistance followed period increasing resistance leading slowly resistance. See Details valid options. I_as_S logical indicate whether values \"\" treated \"S\" (otherwise treated \"R\"). default, TRUE, follows redefinition EUCAST interpretation (increased exposure) 2019, see section Interpretation S, R . preserve_measurements logical indicate whether predictions years actually available data overwritten original data. standard errors years NA. info logical indicate whether textual analysis printed name summary() statistical model. ... Arguments passed functions. main Title plot. ribbon logical indicate whether ribbon shown (default) error bars. object Model data plotted.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Predict Antimicrobial Resistance — resistance_predict","text":"data.frame extra class resistance_predict columns: year value, estimated preserve_measurements = FALSE, combination observed estimated otherwise se_min, lower bound standard error minimum 0 (standard error never go 0%) se_max upper bound standard error maximum 1 (standard error never go 100%) observations, total number available observations year, .e. \\(S + + R\\) observed, original observed resistant percentages estimated, estimated resistant percentages, calculated model Furthermore, model available attribute: attributes(x)$model, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Valid options statistical model (argument model) : \"binomial\" \"binom\" \"logit\": generalised linear regression model binomial distribution \"loglin\" \"poisson\": generalised log-linear regression model poisson distribution \"lin\" \"linear\": linear regression model","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Predict Antimicrobial Resistance — resistance_predict","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"x <- resistance_predict(example_isolates,   col_ab = \"AMX\",   year_min = 2010,   model = \"binomial\" ) #> Warning: The resistance_predict() function is deprecated and will be removed in a #> future version, see ?AMR-deprecated. Use the tidymodels framework #> instead, for which we have written a basic and short introduction on our #> website: https://amr-for-r.org/articles/AMR_with_tidymodels.html #> This warning will be shown once per session. plot(x)  # \\donttest{ if (require(\"ggplot2\")) {   ggplot_sir_predict(x) }   # using dplyr: if (require(\"dplyr\")) {   x <- example_isolates %>%     filter_first_isolate() %>%     filter(mo_genus(mo) == \"Staphylococcus\") %>%     resistance_predict(\"PEN\", model = \"binomial\")   print(plot(x))    # get the model from the object   mymodel <- attributes(x)$model   summary(mymodel) }  #> NULL #>  #> Call: #> glm(formula = df_matrix ~ year, family = binomial) #>  #> Coefficients: #>             Estimate Std. Error z value Pr(>|z|) #> (Intercept) 35.76101   72.29172   0.495    0.621 #> year        -0.01720    0.03603  -0.477    0.633 #>  #> (Dispersion parameter for binomial family taken to be 1) #>  #>     Null deviance: 5.3681  on 11  degrees of freedom #> Residual deviance: 5.1408  on 10  degrees of freedom #> AIC: 50.271 #>  #> Number of Fisher Scoring iterations: 4 #>   # create nice plots with ggplot2 yourself if (require(\"dplyr\") && require(\"ggplot2\")) {   data <- example_isolates %>%     filter(mo == as.mo(\"E. coli\")) %>%     resistance_predict(       col_ab = \"AMX\",       col_date = \"date\",       model = \"binomial\",       info = FALSE,       minimum = 15     )   head(data)   autoplot(data) }  # }"},{"path":"https://amr-for-r.org/reference/skewness.html","id":null,"dir":"Reference","previous_headings":"","what":"Skewness of the Sample — skewness","title":"Skewness of the Sample — skewness","text":"Skewness measure asymmetry probability distribution real-valued random variable mean. negative ('left-skewed'): left tail longer; mass distribution concentrated right histogram. positive ('right-skewed'): right tail longer; mass distribution concentrated left histogram. normal distribution skewness 0.","code":""},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Skewness of the Sample — skewness","text":"","code":"skewness(x, na.rm = FALSE)  # Default S3 method skewness(x, na.rm = FALSE)  # S3 method for class 'matrix' skewness(x, na.rm = FALSE)  # S3 method for class 'data.frame' skewness(x, na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/skewness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Skewness of the Sample — skewness","text":"x vector values, matrix data.frame. na.rm logical value indicating whether NA values stripped computation proceeds.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Skewness of the Sample — skewness","text":"","code":"skewness(runif(1000)) #> [1] -0.01662734"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter Top n Microorganisms — top_n_microorganisms","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function filters data set include top n microorganisms based specified property, taxonomic family genus. example, can filter data set top 3 species, species top 5 genera, top 3 species top 5 genera.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"top_n_microorganisms(x, n, property = \"species\", n_for_each = NULL,   col_mo = NULL, ...)"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"x data frame containing microbial data. n integer specifying maximum number unique values property include output. property character string indicating microorganism property use filtering. Must one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". NULL, raw values col_mo used without transformation. using \"species\" (default) \"subpecies\", genus added make sure (sub)species still belongs right genus. n_for_each optional integer specifying maximum number rows retain value selected property. NULL, rows within top n groups included. col_mo character string indicating column x contains microorganism names codes. Defaults first column class mo. Values coerced using .mo(). ... Additional arguments passed mo_property() property NULL.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function useful preprocessing data creating antibiograms analyses require focused subsets microbial data. example, can filter data set include isolates top 10 species.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"# filter to the top 3 species: top_n_microorganisms(example_isolates,   n = 3 ) #> # A tibble: 1,015 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  5 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  7 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #>  8 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   R     NA    R     NA  #>  9 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   S     NA    S     NA  #> 10 2002-02-21 A56499     64 M      Clinical B_STPHY_CONS   S     NA    S     NA  #> # ℹ 1,005 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to any species in the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\" ) #> # A tibble: 1,742 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,732 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to the top 3 species in each of the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\", n_for_each = 3 ) #> # A tibble: 1,497 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  8 2003-09-05 F35553     52 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #> 10 2003-09-28 1B0933     80 M      Clinical B_ENTRC        NA    NA    NA    NA  #> # ℹ 1,487 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/translate.html","id":null,"dir":"Reference","previous_headings":"","what":"Translate Strings from the AMR Package — translate","title":"Translate Strings from the AMR Package — translate","text":"language-dependent output AMR functions, mo_name(), mo_gramstain(), mo_type() ab_name().","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Translate Strings from the AMR Package — translate","text":"","code":"get_AMR_locale()  set_AMR_locale(language)  reset_AMR_locale()  translate_AMR(x, language = get_AMR_locale())"},{"path":"https://amr-for-r.org/reference/translate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate Strings from the AMR Package — translate","text":"language Language choose. Use one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). x Text translate.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate Strings from the AMR Package — translate","text":"currently 20 supported languages English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). languages translations available antimicrobial drugs colloquial microorganism names. permanently silence -per-session language note non-English operating system, can set package option AMR_locale .Rprofile file like :   save file. Please read adding updating language Wiki.","code":"# Open .Rprofile file utils::file.edit(\"~/.Rprofile\")  # Then add e.g. Italian support to that file using: options(AMR_locale = \"Italian\")"},{"path":"https://amr-for-r.org/reference/translate.html","id":"changing-the-default-language","dir":"Reference","previous_headings":"","what":"Changing the Default Language","title":"Translate Strings from the AMR Package — translate","text":"system language used default (returned Sys.getenv(\"LANG\") , LANG set, Sys.getlocale(\"LC_COLLATE\")), language supported. language used can overwritten two ways checked order: Setting package option AMR_locale, either using e.g. set_AMR_locale(\"German\") running e.g. options(AMR_locale = \"German\"). Note setting R option works session. Save command options(AMR_locale = \"(language)\") .Rprofile file apply every session. Run utils::file.edit(\"~/.Rprofile\") edit .Rprofile file. Setting system variable LANGUAGE LANG, e.g. adding LANGUAGE=\"de_DE.utf8\" .Renviron file home directory. Thus, package option AMR_locale set, system variables LANGUAGE LANG ignored.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Translate Strings from the AMR Package — translate","text":"","code":"# Current settings (based on system language) ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negative Staphylococcus (CoNS)\"  # setting another language set_AMR_locale(\"Dutch\") #> ℹ Using Dutch (Nederlands) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacine\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negatieve Staphylococcus (CNS)\"  # setting yet another language set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Koagulase-negative Staphylococcus (KNS)\"  # set_AMR_locale() understands endonyms, English exonyms, and ISO-639-1: set_AMR_locale(\"Deutsch\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"de\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/Clavulansäure\"  # reset to system default reset_AMR_locale() #> ℹ Using the English language (English) for the AMR package for this #>   session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/clavulanic acid\""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-2119253","dir":"Changelog","previous_headings":"","what":"AMR 2.1.1.9253","title":"AMR 2.1.1.9253","text":"(beta version eventually become v3.0. ’re happy reach new major milestone soon, new One Health support! Install beta using instructions .)","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9253","dir":"Changelog","previous_headings":"","what":"A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)","title":"AMR 2.1.1.9253","text":"package now supports tools AMR data analysis clinical settings, also veterinary environmental microbiology. made possible collaboration University Prince Edward Island’s Atlantic Veterinary College, Canada. celebrate great improvement package, also updated package logo reflect change.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"breaking-2-1-1-9253","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 2.1.1.9253","text":"Dataset antibiotics renamed antimicrobials data set contains just antibiotics. Using antibiotics still work, now returns warning. Removed functions references used deprecated rsi class, replaced sir equivalents two years ago. Functions resistance_predict() sir_predict() now deprecated removed future version. Use tidymodels framework instead, wrote basic introduction.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"new-2-1-1-9253","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 2.1.1.9253","text":"Function .sir() now extensive support veterinary breakpoints CLSI. Use breakpoint_type = \"animal\" set host argument variable contains animal species names. clinical_breakpoints data set contains breakpoints, can downloaded download page. (new) antimicrobials data set contains veterinary antibiotics, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antibiotics (start “Q”) ab_url() now supports retrieving WHOCC url ATCvet pages antibiogram() function now supports creating true Weighted-Incidence Syndromic Combination Antibiograms (WISCA), powerful Bayesian method estimating regimen coverage probabilities using pathogen incidence antimicrobial susceptibility data. WISCA offers improved precision syndrome-specific treatment, even datasets sparse data. dedicated wisca() function also available easy usage. MycoBank now integrated primary taxonomic source fungi. microorganisms data set enriched new columns (mycobank, mycobank_parent, mycobank_renamed_to) provide detailed information fungal species. remarkable addition 20,000 new fungal records New function mo_mycobank() retrieve MycoBank record number, analogous existing functions mo_lpsn() mo_gbif(). .mo() function mo_*() functions now include only_fungi argument, allowing users restrict results solely fungal species. ensures fungi prioritised bacteria microorganism identification. can also set globally new AMR_only_fungi option. Also updated kingdoms, welcoming total 2,149 new records 2023 927 2024. Breakpoint 2024 2025 CLSI EUCAST now supported, adding 10,000 new clinical breakpoints clinical_breakpoints data set usage .sir(). EUCAST 2025 now new default guideline MIC disk diffusion interpretations. Added Expected Resistant Phenotypes EUCAST (v1.2). default rules eucast_rules() now: c(\"breakpoints\", \"expected_phenotypes\"). Updated intrinsic_resistant data set, now based EUCAST Expected Resistant Phenotypes v1.2 .sir() now brings additional factor levels: “NI” non-interpretable “SDD” susceptible dose-dependent. Currently, clinical_breakpoints data set contains 24 breakpoints can return value “SDD” instead “”. EUCAST interpretive rules (using eucast_rules()) now available EUCAST 12 (2022), 13 (2023), 14 (2024), 15 (2025). EUCAST dosage tables (dosage data set) now available EUCAST 13 (2023), 14 (2024), 15 (2025). New function group scale_*_mic(), namely: scale_x_mic(), scale_y_mic(), scale_colour_mic() scale_fill_mic(). allow easy plotting MIC values. allow manual range definition plotting missing intermediate log2 levels. New function group scale_*_sir(), namely: scale_x_sir(), scale_colour_sir() scale_fill_sir(). allow plot sir class, translates system language default. also set colourblind-safe colours plots. New function rescale_mic(), allows users rescale MIC values manually set range. powerhouse behind scale_*_mic() functions, can used independently , instance, compare equality MIC distributions rescaling range first. using R heavy lifting, ‘AMR’ Python Package developed run AMR R package natively Python. Python package always version number R package, built automatically every code change. antimicrobial selectors (aminoglycosides() betalactams()) now supported tidymodels packages recipe parsnip. See info tutorial using AMR functions predictive modelling. New function top_n_microorganisms() filter data set top n taxonomic property, e.g., filter top 3 species, filter species top 5 genera, filter top 3 species top 5 genera New function mo_group_members() retrieve member microorganisms microorganism group. example, mo_group_members(\"Strep group C\") returns vector microorganisms belong group. New functions mic_p50() mic_p90() retrieve 50th 90th percentile MIC values.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-2-1-1-9253","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 2.1.1.9253","text":"Support parallel computing using parallel package (part base R). Use .sir(your_data, parallel = TRUE) run SIR interpretation using multiple cores. now possible use column names arguments guideline, ab, mo, uti: .sir(..., ab = \"column1\", mo = \"column2\", uti = \"column3\"). greatly improves flexibility users. Users can now set criteria (using regular expressions) considered S, , R, SDD, NI. get quantitative values, .double() sir object return 1 S, 2 SDD/, 3 R (NI become NA). functions using sir classes (e.g., summary()) updated reflect change contain NI SDD. Following CLSI interpretation rules, values outside log2-dilution range rounded upwards nearest log2-level interpretation. using CLSI guideline. Combined MIC values (e.g., CLSI) now supported argument conserve_capped_values .sir() replaced capped_mic_handling, allows greater flexibility handling capped MIC values (<, <=, >, >=). four available options (\"standard\", \"strict\", \"relaxed\", \"inverse\") provide full control whether values interpreted conservatively ignored. Using conserve_capped_values now deprecated returns warning. Added argument info silence console messages Argument antibiotics renamed antimicrobials. Using antibiotics still work, now returns warning. Added argument formatting_type set 22 options formatting ‘cells’. defaults 18 non-WISCA 14 WISCA, changing output antibiograms cells info. reason, add_total_n now deprecated FALSE default since denominators added cells dependent formatting_type setting ab_transform argument now defaults \"name\", displaying antibiotic column names instead codes ‘Antibiotic selectors’ now called ‘antimicrobial selectors’ since scope broader just antibiotics. documentation updated, ab_class() ab_selector() replaced amr_class() amr_selector(). old functions now deprecated removed future version. Added selectors isoxazolylpenicillins(), monobactams(), nitrofurans(), phenicols(), rifamycins(), sulfonamides() using antimicrobial selectors exclude non-treatable drugs (gentamicin-high using aminoglycosides()), function now always returns warning can included using only_treatable = FALSE Added new argument return_all selectors, defaults TRUE include match. FALSE, old behaviour, first hit unique antimicrobial returned. selectors can now run separate command retrieve vector possible antimicrobials selector can select selectors lincosamides() macrolides() overlap anymore - antibiotic now classified either Fixed selector fluoroquinolones(), now really selects second-generation quinolones (first-generation quinolones contain fluorine group) Added agents used screening, ID ending -S: benzylpenicillin screening test (PEN-S), beta-lactamase screening test (BLA-S), cefotaxime screening test (CTX-S), clindamycin inducible screening test (CLI-S), nalidixic acid screening test (NAL-S), norfloxacin screening test (-S), oxacillin screening test (OXA-S), pefloxacin screening test (PEF-S), tetracycline screening test (TCY-S). ID cefoxitin screening renamed FOX1 FOX-S, old code remains work. reason, antimicrobial selectors cephalosporins(), cephalosporins_3rd(), lincosamides(), isoxazolylpenicillins(), quinolones(), fluoroquinolones(), tetracyclines() now contain argument only_treatable = TRUE (similar antimicrobial selectors contain non-treatable drugs) Added amorolfine (AMO, D01AE16), antimycotic, now also part antifungals() selector Added cefepime/enmetazobactam (FPE), 4th gen cephalosporin Added tigemonam (TNM), monobactam Added bleomycin (BLM), glycopeptide Added efflux (EFF), allow mapping AMRFinderPlus Updated ATC codes, trade names, DDDs Added valid levels: 4096, 6 powers 0.0625, 5 powers 192 (192, 384, 576, 768, 960) Fixed bug .mic() failed translation scientifically formatted numbers Added new argument keep_operators .mic(). can \"\" (default), \"none\", \"edges\". argument also available new rescale_mic() scale_*_mic() functions. Comparisons MIC values now strict. example, >32 higher (never equal ) 32. Thus, .mic(\">32\") == .mic(32) now returns FALSE, .mic(\">32\") > .mic(32) now returns TRUE. Sorting MIC values (using sort()) fixed manner; <0.001 now gets sorted 0.001, >0.001 gets sorted 0.001. Intermediate log2 levels used MIC plotting now common values instead following strict dilution range .mic() now returns vector TRUE/FALSE input data.frame, just like .sir() eucast_rules() now argument overwrite (default: FALSE) indicate whether non-NA values overwritten Disks 0 5 mm now allowed, newly allowed range disk diffusion (.disk()) now 0 50 mm Updated italicise_taxonomy() support HTML output custom_eucast_rules() now supports multiple antibiotics antibiotic groups affected single rule mo_info() now contains extra element rank group_members (contents new mo_group_members() function) Updated ATC codes WHOCC Updated antibiotic DDDs WHOCC Fix using manual value mo_transform antibiogram() Fixed bug antibiogram() returns empty data set Fix mapping ‘high level’ antibiotics .ab() (amphotericin B-high, gentamicin-high, kanamycin-high, streptomycin-high, tobramycin-high) Improved overall algorithm .ab() better performance accuracy, including new function as_reset_session() remove earlier coercions. weight given genus species combinations cases subspecies miswritten, result correct genus species Genera World Health Organization’s () Priority Pathogen List now highest prevalence Fixed bug sir_confidence_interval() isolates available Updated prevalence calculation include genera World Health Organization’s () Priority Pathogen List Improved algorithm first_isolate() using phenotype-based method, prioritise records highest availability SIR values scale_y_percent() can now cope ranges outside 0-100% range Implemented new Dutch national MDRO guideline (SRI-richtlijn BRMO, Nov 2024) Added arguments esbl, carbapenemase, mecA, mecC, vanA, vanB denote column names logical values indicating presence genes (production proteins) Added console colours support sir class Positron","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"other-2-1-1-9253","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 2.1.1.9253","text":"New website domain: https://amr--r.org! old domain (http://amr--r.org) remain work. Added Dr. Larisse Bolton Aislinn Cook contributors fantastic implementation WISCA mathematically solid way Added Matthew Saab, Dr. Jordan Stull, Prof. Javier Sanchez contributors tremendous input veterinary breakpoints interpretations Added Prof. Kathryn Holt, Dr. Jane Hawkey, Dr. Natacha Couto contributors many suggestions, ideas bugfixes Greatly improved vctrs integration, Tidyverse package working background many Tidyverse functions. users, means functions dplyr’s bind_rows(), rowwise() c_across() now supported e.g. columns class mic. Despite , AMR package still zero-dependent package, including dplyr vctrs. Greatly updated expanded documentation Stopped support SAS (.xpt) files, since file structure extremely inefficient requires disk space GitHub allows single commit.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"older-versions-2-1-1-9253","dir":"Changelog","previous_headings":"","what":"Older Versions","title":"AMR 2.1.1.9253","text":"changelog contains changes AMR v3.0 (March 2025) later. prior v2 versions, please see v2 archive. prior v1 versions, please see v1 archive.","code":""}]
+[{"path":"https://amr-for-r.org/articles/AMR.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to conduct AMR data analysis","text":"Conducting AMR data analysis unfortunately requires -depth knowledge different scientific fields, makes hard right. least, requires: Good questions (always start !) reliable data thorough understanding (clinical) epidemiology, understand clinical epidemiological relevance possible bias results thorough understanding (clinical) microbiology/infectious diseases, understand microorganisms causal infections implications pharmaceutical treatment, well understanding intrinsic acquired microbial resistance Experience data analysis microbiological tests results, understand determination limitations MIC values interpretations SIR values Availability biological taxonomy microorganisms probably normalisation factors pharmaceuticals, defined daily doses (DDD) Available (inter-)national guidelines, profound methods apply course, instantly provide knowledge experience. AMR package, aimed providing (1) tools simplify antimicrobial resistance data cleaning, transformation analysis, (2) methods easily incorporate international guidelines (3) scientifically reliable reference data, including requirements mentioned . AMR package enables standardised reproducible AMR data analysis, application evidence-based rules, determination first isolates, translation various codes microorganisms antimicrobial agents, determination (multi-drug) resistant microorganisms, calculation antimicrobial resistance, prevalence future trends.","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to conduct AMR data analysis","text":"tutorial, create fake demonstration data work . can skip Cleaning data already data ready. start analysis, try make structure data generally look like :","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"needed-r-packages","dir":"Articles","previous_headings":"Preparation","what":"Needed R packages","title":"How to conduct AMR data analysis","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2 RStudio. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. also use cleaner package, can used cleaning data creating frequency tables. AMR package contains data set example_isolates_unclean, might look data users extracted laboratory systems: AMR data analysis, like microorganism column contain valid, --date taxonomy, antibiotic columns cleaned SIR values well.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"dplyr\", \"ggplot2\", \"AMR\")) example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows  # we will use 'our_data' as the data set name for this tutorial our_data <- example_isolates_unclean"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"taxonomy-of-microorganisms","dir":"Articles","previous_headings":"Preparation","what":"Taxonomy of microorganisms","title":"How to conduct AMR data analysis","text":".mo(), users can transform arbitrary microorganism names codes current taxonomy. AMR package contains --date taxonomic data. specific, currently included data retrieved 24 Jun 2024. codes AMR packages come .mo() short, still human readable. importantly, .mo() supports kinds input: first character codes denote taxonomic kingdom, Bacteria (B), Fungi (F), Protozoa (P). AMR package also contain functions directly retrieve taxonomic properties, name, genus, species, family, order, even Gram-stain. start mo_ use .mo() internally, still arbitrary user input can used: Now can thus clean data: Apparently, uncertainty translation taxonomic codes. Let’s check : ’s good.","code":"as.mo(\"Klebsiella pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"K. pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLEPNE\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLPN\") #> Class 'mo' #> [1] B_KLBSL_PNMN mo_family(\"K. pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"K. pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"K. pneumoniae\") #> [1] \"pneumoniae\"  mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\"  mo_ref(\"K. pneumoniae\") #> [1] \"Trevisan, 1887\"  mo_snomed(\"K. pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\" our_data$bacteria <- as.mo(our_data$bacteria, info = TRUE) #> ℹ Retrieved values from the microorganisms.codes data set for \"ESCCOL\", #>   \"KLEPNE\", \"STAAUR\", and \"STRPNE\". #> ℹ Microorganism translation was uncertain for four microorganisms. Run #>   mo_uncertainties() to review these uncertainties, or use #>   add_custom_microorganisms() to add custom entries. mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See ?mo_matching_score. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #> -------------------------------------------------------------------------------- #> \"K. pneumoniae\" -> Klebsiella pneumoniae (B_KLBSL_PNMN, 0.786) #> Also matched: Klebsiella pneumoniae complex (0.707), Klebsiella #>               pneumoniae ozaenae (0.707), Klebsiella pneumoniae pneumoniae (0.688), #>               Klebsiella pneumoniae rhinoscleromatis (0.658), Klebsiella pasteurii #>               (0.500), Klebsiella planticola (0.500), Kingella potus (0.400), #>               Kluyveromyces pseudotropicale (0.386), Kluyveromyces pseudotropicalis #>               (0.363), and Kosakonia pseudosacchari (0.361) #> -------------------------------------------------------------------------------- #> \"S. aureus\" -> Staphylococcus aureus (B_STPHY_AURS, 0.690) #> Also matched: Staphylococcus aureus aureus (0.643), Staphylococcus #>               argenteus (0.625), Staphylococcus aureus anaerobius (0.625), #>               Staphylococcus auricularis (0.615), Salmonella Aurelianis (0.595), #>               Salmonella Aarhus (0.588), Salmonella Amounderness (0.587), #>               Staphylococcus argensis (0.587), Streptococcus australis (0.587), and #>               Salmonella choleraesuis arizonae (0.562) #> -------------------------------------------------------------------------------- #> \"S. pneumoniae\" -> Streptococcus pneumoniae (B_STRPT_PNMN, 0.750) #> Also matched: Streptococcus pseudopneumoniae (0.700), Streptococcus #>               phocae salmonis (0.552), Serratia proteamaculans quinovora (0.545), #>               Streptococcus pseudoporcinus (0.536), Staphylococcus piscifermentans #>               (0.533), Staphylococcus pseudintermedius (0.532), Serratia #>               proteamaculans proteamaculans (0.526), Streptococcus gallolyticus #>               pasteurianus (0.526), Salmonella Portanigra (0.524), and Streptococcus #>               periodonticum (0.519) #>  #> Only the first 10 other matches of each record are shown. Run #> print(mo_uncertainties(), n = ...) to view more entries, or save #> mo_uncertainties() to an object."},{"path":"https://amr-for-r.org/articles/AMR.html","id":"antibiotic-results","dir":"Articles","previous_headings":"Preparation","what":"Antibiotic results","title":"How to conduct AMR data analysis","text":"column antibiotic test results must also cleaned. AMR package comes three new data types work test results: mic minimal inhibitory concentrations (MIC), disk disk diffusion diameters, sir SIR data interpreted already. package can also determine SIR values based MIC disk diffusion values, read .sir() page. now, just clean SIR columns data using dplyr: basically cleaning, time start data inclusion.","code":"# method 1, be explicit about the columns: our_data <- our_data %>%   mutate_at(vars(AMX:GEN), as.sir)  # method 2, let the AMR package determine the eligible columns our_data <- our_data %>%   mutate_if(is_sir_eligible, as.sir)  # result: our_data #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   #>  7 J8         A        2016-06-14 B_ESCHR_COLI   R     S     S     S   #>  8 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   #>  9 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   #> 10 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"first-isolates","dir":"Articles","previous_headings":"Preparation","what":"First isolates","title":"How to conduct AMR data analysis","text":"need know isolates can actually use analysis without repetition bias. conduct analysis antimicrobial resistance, must include first isolate every patient per episode (Hindler et al., Clin Infect Dis. 2007). , easily get overestimate underestimate resistance antibiotic. Imagine patient admitted MRSA found 5 different blood cultures following weeks (yes, countries like Netherlands blood drawing policies). resistance percentage oxacillin isolates overestimated, included MRSA . clearly selection bias. Clinical Laboratory Standards Institute (CLSI) appoints follows: (…) preparing cumulative antibiogram guide clinical decisions empirical antimicrobial therapy initial infections, first isolate given species per patient, per analysis period (eg, one year) included, irrespective body site, antimicrobial susceptibility profile, phenotypical characteristics (eg, biotype). first isolate easily identified, cumulative antimicrobial susceptibility test data prepared using first isolate generally comparable cumulative antimicrobial susceptibility test data calculated methods, providing duplicate isolates excluded. M39-A4 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 4th Edition. CLSI, 2014. Chapter 6.4 AMR package includes methodology first_isolate() function able apply four different methods defined Hindler et al. 2007: phenotype-based, episode-based, patient-based, isolate-based. right method depends goals analysis, default phenotype-based method case method properly correct duplicate isolates. Read methods first_isolate() page. outcome function can easily added data: 91% suitable resistance analysis! can now filter filter() function, also dplyr package: future use, two syntaxes can shortened: end 2 724 isolates analysis. Now data looks like: Time analysis.","code":"our_data <- our_data %>%   mutate(first = first_isolate(info = TRUE)) #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'bacteria' as input for col_mo. #> ℹ Using column 'date' as input for col_date. #> ℹ Using column 'patient_id' as input for col_patient_id. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> => Found 2,724 'phenotype-based' first isolates (90.8% of total where a #>    microbial ID was available) our_data_1st <- our_data %>%   filter(first == TRUE) our_data_1st <- our_data %>%   filter_first_isolate() our_data_1st #> # A tibble: 2,724 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   TRUE  #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   TRUE  #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   TRUE  #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   TRUE  #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   TRUE  #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   TRUE  #>  7 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   TRUE  #>  8 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   TRUE  #>  9 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   TRUE  #> 10 P4         A        2011-06-21 B_ESCHR_COLI   S     S     S     S   TRUE  #> # ℹ 2,714 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"analysing-the-data","dir":"Articles","previous_headings":"","what":"Analysing the data","title":"How to conduct AMR data analysis","text":"base R summary() function gives good first impression, comes support new mo sir classes now data set:","code":"summary(our_data_1st) #>   patient_id          hospital              date            #>  Length:2724        Length:2724        Min.   :2011-01-01   #>  Class :character   Class :character   1st Qu.:2013-04-07   #>  Mode  :character   Mode  :character   Median :2015-06-03   #>                                        Mean   :2015-06-09   #>                                        3rd Qu.:2017-08-11   #>                                        Max.   :2019-12-27   #>    bacteria               AMX                    AMC                 #>  Class :mo             Class:sir              Class:sir              #>  <NA>  :0              %S   :41.6% (n=1133)   %S   :52.6% (n=1432)   #>  Unique:4              %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)      #>  #1    :B_ESCHR_COLI   %I   :16.4% (n=446)    %I   :12.2% (n=333)    #>  #2    :B_STPHY_AURS   %R   :42.0% (n=1145)   %R   :35.2% (n=959)    #>  #3    :B_STRPT_PNMN   %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)      #>     CIP                    GEN                  first         #>  Class:sir              Class:sir              Mode:logical   #>  %S   :52.5% (n=1431)   %S   :61.0% (n=1661)   TRUE:2724      #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)                     #>  %I   : 6.5% (n=176)    %I   : 3.0% (n=82)                    #>  %R   :41.0% (n=1117)   %R   :36.0% (n=981)                   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)  glimpse(our_data_1st) #> Rows: 2,724 #> Columns: 9 #> $ patient_id <chr> \"J3\", \"R7\", \"P3\", \"P10\", \"B7\", \"W3\", \"M3\", \"J3\", \"G6\", \"P4\"… #> $ hospital   <chr> \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\",… #> $ date       <date> 2012-11-21, 2018-04-03, 2014-09-19, 2015-12-10, 2015-03-02… #> $ bacteria   <mo> \"B_ESCHR_COLI\", \"B_KLBSL_PNMN\", \"B_ESCHR_COLI\", \"B_ESCHR_COL… #> $ AMX        <sir> R, R, R, S, S, R, R, S, S, S, S, R, S, S, R, R, R, R, S, R,… #> $ AMC        <sir> I, I, S, I, S, S, S, S, S, S, S, S, S, S, S, S, S, R, S, S,… #> $ CIP        <sir> S, S, S, S, S, R, S, S, S, S, S, S, S, S, S, S, S, S, S, S,… #> $ GEN        <sir> S, S, S, S, S, S, S, S, S, S, S, R, S, S, S, S, S, S, S, S,… #> $ first      <lgl> TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE,…  # number of unique values per column: sapply(our_data_1st, n_distinct) #> patient_id   hospital       date   bacteria        AMX        AMC        CIP  #>        260          3       1854          4          3          3          3  #>        GEN      first  #>          3          1"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"availability-of-species","dir":"Articles","previous_headings":"Analysing the data","what":"Availability of species","title":"How to conduct AMR data analysis","text":"just get idea species distributed, create frequency table count() based name microorganisms:","code":"our_data %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1518 #> 2 Staphylococcus aureus      730 #> 3 Streptococcus pneumoniae   426 #> 4 Klebsiella pneumoniae      326  our_data_1st %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1321 #> 2 Staphylococcus aureus      682 #> 3 Streptococcus pneumoniae   402 #> 4 Klebsiella pneumoniae      319"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"select-and-filter-with-antibiotic-selectors","dir":"Articles","previous_headings":"Analysing the data","what":"Select and filter with antibiotic selectors","title":"How to conduct AMR data analysis","text":"Using -called antibiotic class selectors, can select filter columns based antibiotic class antibiotic results :","code":"our_data_1st %>%   select(date, aminoglycosides()) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 2,724 × 2 #>    date       GEN   #>    <date>     <sir> #>  1 2012-11-21   S   #>  2 2018-04-03   S   #>  3 2014-09-19   S   #>  4 2015-12-10   S   #>  5 2015-03-02   S   #>  6 2018-03-31   S   #>  7 2015-10-25   S   #>  8 2019-06-19   S   #>  9 2015-04-27   S   #> 10 2011-06-21   S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, betalactams()) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 2,724 × 3 #>    bacteria     AMX   AMC   #>    <mo>         <sir> <sir> #>  1 B_ESCHR_COLI   R     I   #>  2 B_KLBSL_PNMN   R     I   #>  3 B_ESCHR_COLI   R     S   #>  4 B_ESCHR_COLI   S     I   #>  5 B_ESCHR_COLI   S     S   #>  6 B_STPHY_AURS   R     S   #>  7 B_ESCHR_COLI   R     S   #>  8 B_ESCHR_COLI   S     S   #>  9 B_STPHY_AURS   S     S   #> 10 B_ESCHR_COLI   S     S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, where(is.sir)) #> # A tibble: 2,724 × 5 #>    bacteria     AMX   AMC   CIP   GEN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   R     I     S     S   #>  2 B_KLBSL_PNMN   R     I     S     S   #>  3 B_ESCHR_COLI   R     S     S     S   #>  4 B_ESCHR_COLI   S     I     S     S   #>  5 B_ESCHR_COLI   S     S     S     S   #>  6 B_STPHY_AURS   R     S     R     S   #>  7 B_ESCHR_COLI   R     S     S     S   #>  8 B_ESCHR_COLI   S     S     S     S   #>  9 B_STPHY_AURS   S     S     S     S   #> 10 B_ESCHR_COLI   S     S     S     S   #> # ℹ 2,714 more rows  # filtering using AB selectors is also possible: our_data_1st %>%   filter(any(aminoglycosides() == \"R\")) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 981 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J5         A        2017-12-25 B_STRPT_PNMN   R     S     S     R   TRUE  #>  2 X1         A        2017-07-04 B_STPHY_AURS   R     S     S     R   TRUE  #>  3 B3         A        2016-07-24 B_ESCHR_COLI   S     S     S     R   TRUE  #>  4 V7         A        2012-04-03 B_ESCHR_COLI   S     S     S     R   TRUE  #>  5 C9         A        2017-03-23 B_ESCHR_COLI   S     S     S     R   TRUE  #>  6 R1         A        2018-06-10 B_STPHY_AURS   S     S     S     R   TRUE  #>  7 S2         A        2013-07-19 B_STRPT_PNMN   S     S     S     R   TRUE  #>  8 P5         A        2019-03-09 B_STPHY_AURS   S     S     S     R   TRUE  #>  9 Q8         A        2019-08-10 B_STPHY_AURS   S     S     S     R   TRUE  #> 10 K5         A        2013-03-15 B_STRPT_PNMN   S     S     S     R   TRUE  #> # ℹ 971 more rows  our_data_1st %>%   filter(all(betalactams() == \"R\")) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows  # even works in base R (since R 3.0): our_data_1st[all(betalactams() == \"R\"), ] #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"generate-antibiograms","dir":"Articles","previous_headings":"Analysing the data","what":"Generate antibiograms","title":"How to conduct AMR data analysis","text":"Since AMR v2.0 (March 2023), easy create different types antibiograms, support 20 different languages. four antibiogram types, proposed Klinker et al. (2021, DOI 10.1177/20499361211011373), supported new antibiogram() function: Traditional Antibiogram (TA) e.g, susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Combination Antibiogram (CA) e.g, sdditional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Syndromic Antibiogram (SA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Weighted-Incidence Syndromic Combination Antibiogram (WISCA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure section, show use antibiogram() function create antibiogram types. starters, included example_isolates data set looks like:","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"traditional-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Traditional Antibiogram","title":"How to conduct AMR data analysis","text":"create traditional antibiogram, simply state antibiotics used. antibiotics argument antibiogram() function supports (combination) previously mentioned antibiotic class selectors: Notice antibiogram() function automatically prints right format using Quarto R Markdown (page), even applies italics taxonomic names (using italicise_taxonomy() internally). also uses language OS either English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. next example, force language Spanish using language argument:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             mo_transform = \"gramstain\",             antibiotics = aminoglycosides(),             ab_transform = \"name\",             language = \"es\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"combined-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Combined Antibiogram","title":"How to conduct AMR data analysis","text":"create combined antibiogram, use antibiotic codes names plus + character like :","code":"combined_ab <- antibiogram(example_isolates,                            antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),                            ab_transform = NULL) combined_ab"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"syndromic-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Syndromic Antibiogram","title":"How to conduct AMR data analysis","text":"create syndromic antibiogram, syndromic_group argument must used. can column data, e.g. ifelse() calculations based certain columns:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems()),             syndromic_group = \"ward\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"weighted-incidence-syndromic-combination-antibiogram-wisca","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Weighted-Incidence Syndromic Combination Antibiogram (WISCA)","title":"How to conduct AMR data analysis","text":"create Weighted-Incidence Syndromic Combination Antibiogram (WISCA), simply set wisca = TRUE antibiogram() function, use dedicated wisca() function. Unlike traditional antibiograms, WISCA provides syndrome-based susceptibility estimates, weighted pathogen incidence antimicrobial susceptibility patterns. WISCA uses Bayesian decision model integrate data multiple pathogens, improving empirical therapy guidance, especially low-incidence infections. pathogen-agnostic, meaning results syndrome-based rather stratified microorganism. reliable results, ensure data includes first isolates (use first_isolate()) consider filtering top n species (use top_n_microorganisms()), WISCA outcomes meaningful based robust incidence estimates. patient- syndrome-specific WISCA, run function grouped tibble, .e., using group_by() first:","code":"example_isolates %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),         minimum = 10) # Recommended threshold: ≥30 example_isolates %>%   top_n_microorganisms(n = 10) %>%   group_by(age_group = age_groups(age, c(25, 50, 75)),            gender) %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-antibiograms","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Plotting antibiograms","title":"How to conduct AMR data analysis","text":"Antibiograms can plotted using autoplot() ggplot2 packages, since AMR package provides extension function:  calculate antimicrobial resistance sensible way, also correcting results, use resistance() susceptibility() functions.","code":"autoplot(combined_ab)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"resistance-percentages","dir":"Articles","previous_headings":"Analysing the data","what":"Resistance percentages","title":"How to conduct AMR data analysis","text":"functions resistance() susceptibility() can used calculate antimicrobial resistance susceptibility. specific analyses, functions proportion_S(), proportion_SI(), proportion_I(), proportion_IR() proportion_R() can used determine proportion specific antimicrobial outcome. functions contain minimum argument, denoting minimum required number test results returning value. functions otherwise return NA. default minimum = 30, following CLSI M39-A4 guideline applying microbial epidemiology. per EUCAST guideline 2019, calculate resistance proportion R (proportion_R(), equal resistance()) susceptibility proportion S (proportion_SI(), equal susceptibility()). functions can used : can used conjunction group_by() summarise(), dplyr package:","code":"our_data_1st %>% resistance(AMX) #> [1] 0.4203377 our_data_1st %>%   group_by(hospital) %>%   summarise(amoxicillin = resistance(AMX)) #> # A tibble: 3 × 2 #>   hospital amoxicillin #>   <chr>          <dbl> #> 1 A              0.340 #> 2 B              0.551 #> 3 C              0.370"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"interpreting-mic-and-disk-diffusion-values","dir":"Articles","previous_headings":"Analysing the data","what":"Interpreting MIC and Disk Diffusion Values","title":"How to conduct AMR data analysis","text":"Minimal inhibitory concentration (MIC) values disk diffusion diameters can interpreted clinical breakpoints (SIR) using .sir(). ’s example randomly generated MIC values Klebsiella pneumoniae ciprofloxacin: allows direct interpretation according EUCAST CLSI breakpoints, facilitating automated AMR data processing.","code":"set.seed(123) mic_values <- random_mic(100) sir_values <- as.sir(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\")  my_data <- tibble(MIC = mic_values, SIR = sir_values) my_data #> # A tibble: 100 × 2 #>          MIC SIR   #>        <mic> <sir> #>  1    16.000   R   #>  2     0.005   S   #>  3     1.000   R   #>  4 >=256.000   R   #>  5     2.000   R   #>  6     0.025   S   #>  7    16.000   R   #>  8     0.025   S   #>  9     0.500   I   #> 10     0.005   S   #> # ℹ 90 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-mic-and-sir-interpretations","dir":"Articles","previous_headings":"Analysing the data","what":"Plotting MIC and SIR Interpretations","title":"How to conduct AMR data analysis","text":"can visualise MIC distributions SIR interpretations using ggplot2, using new scale_y_mic() y-axis scale_colour_sir() colour-code SIR categories.  plot provides intuitive way assess susceptibility patterns across different groups incorporating clinical breakpoints. straightforward less manual approach, ggplot2’s function autoplot() extended package directly plot MIC disk diffusion values:   Author: Dr. Matthijs Berends, 23rd Feb 2025","code":"# add a group my_data$group <- rep(c(\"A\", \"B\", \"C\", \"D\"), each = 25)   ggplot(my_data,        aes(x = group, y = MIC, colour = SIR)) +   geom_jitter(width = 0.2, size = 2) +   geom_boxplot(fill = NA, colour = \"grey40\") +   scale_y_mic() +   scale_colour_sir() +   labs(title = \"MIC Distribution and SIR Interpretation\",        x = \"Sample Groups\",        y = \"MIC (mg/L)\") autoplot(mic_values) # by providing `mo` and `ab`, colours will indicate the SIR interpretation: autoplot(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\")"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"AMR for Python","text":"AMR package R powerful tool antimicrobial resistance (AMR) analysis. provides extensive features handling microbial antimicrobial data. However, work primarily Python, now intuitive option available: AMR Python package. Python package wrapper around AMR R package. uses rpy2 package internally. Despite need R installed, Python users can now easily work AMR data directly Python code.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"prerequisites","dir":"Articles","previous_headings":"","what":"Prerequisites","title":"AMR for Python","text":"package tested virtual environment (venv). can set environment running: can activate environment, venv ready work .","code":"# linux and macOS: python -m venv /path/to/new/virtual/environment  # Windows: python -m venv C:\\path\\to\\new\\virtual\\environment"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"install-amr","dir":"Articles","previous_headings":"","what":"Install AMR","title":"AMR for Python","text":"Since Python package available official Python Package Index, can just run: Make sure R installed. need install AMR R package, installed automatically. Linux: macOS (using Homebrew): Windows, visit CRAN download page download install R.","code":"pip install AMR # Ubuntu / Debian sudo apt install r-base # Fedora: sudo dnf install R # CentOS/RHEL sudo yum install R brew install r"},{"path":[]},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"cleaning-taxonomy","dir":"Articles","previous_headings":"Examples of Usage","what":"Cleaning Taxonomy","title":"AMR for Python","text":"’s example demonstrates clean microorganism drug names using AMR Python package:","code":"import pandas as pd import AMR  # Sample data data = {     \"MOs\": ['E. coli', 'ESCCOL', 'esco', 'Esche coli'],     \"Drug\": ['Cipro', 'CIP', 'J01MA02', 'Ciproxin'] } df = pd.DataFrame(data)  # Use AMR functions to clean microorganism and drug names df['MO_clean'] = AMR.mo_name(df['MOs']) df['Drug_clean'] = AMR.ab_name(df['Drug'])  # Display the results print(df)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"explanation","dir":"Articles","previous_headings":"Examples of Usage > Cleaning Taxonomy","what":"Explanation","title":"AMR for Python","text":"mo_name: function standardises microorganism names. , different variations Escherichia coli (“E. coli”, “ESCCOL”, “esco”, “Esche coli”) converted correct, standardised form, “Escherichia coli”. ab_name: Similarly, function standardises antimicrobial names. different representations ciprofloxacin (e.g., “Cipro”, “CIP”, “J01MA02”, “Ciproxin”) converted standard name, “Ciprofloxacin”.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"calculating-amr","dir":"Articles","previous_headings":"Examples of Usage","what":"Calculating AMR","title":"AMR for Python","text":"","code":"import AMR import pandas as pd  df = AMR.example_isolates result = AMR.resistance(df[\"AMX\"]) print(result) [0.59555556]"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"generating-antibiograms","dir":"Articles","previous_headings":"Examples of Usage","what":"Generating Antibiograms","title":"AMR for Python","text":"One core functions AMR package generating antibiogram, table summarises antimicrobial susceptibility bacterial isolates. ’s can generate antibiogram Python: example, generate antibiogram selecting various antibiotics.","code":"result2a = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]]) print(result2a) result2b = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]], mo_transform = \"gramstain\") print(result2b)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"taxonomic-data-sets-now-in-python","dir":"Articles","previous_headings":"Examples of Usage","what":"Taxonomic Data Sets Now in Python!","title":"AMR for Python","text":"Python user, might like important data sets AMR R package, microorganisms, antimicrobials, clinical_breakpoints, example_isolates, now available regular Python data frames:","code":"AMR.microorganisms AMR.antimicrobials"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"conclusion","dir":"Articles","previous_headings":"","what":"Conclusion","title":"AMR for Python","text":"AMR Python package, Python users can now effortlessly call R functions AMR R package. eliminates need complex rpy2 configurations provides clean, easy--use interface antimicrobial resistance analysis. examples provided demonstrate can applied typical workflows, standardising microorganism antimicrobial names calculating resistance. just running import AMR, users can seamlessly integrate robust features R AMR package Python workflows. Whether ’re cleaning data analysing resistance patterns, AMR Python package makes easy work AMR data Python.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-1-using-antimicrobial-selectors","dir":"Articles","previous_headings":"","what":"Example 1: Using Antimicrobial Selectors","title":"AMR with tidymodels","text":"leveraging power tidymodels AMR package, ’ll build reproducible machine learning workflow predict Gramstain microorganism two important antibiotic classes: aminoglycosides beta-lactams.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Objective","title":"AMR with tidymodels","text":"goal build predictive model using tidymodels framework determine Gramstain microorganism based microbial data. : Preprocess data using selector functions aminoglycosides() betalactams(). Define logistic regression model prediction. Use structured tidymodels workflow preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Data Preparation","title":"AMR with tidymodels","text":"begin loading required libraries preparing example_isolates dataset AMR package. Prepare data: Explanation: aminoglycosides() betalactams() dynamically select columns antimicrobials classes. drop_na() ensures model receives complete cases training.","code":"# Load required libraries library(AMR)          # For AMR data analysis library(tidymodels)   # For machine learning workflows, and data manipulation (dplyr, tidyr, ...) # Your data could look like this: example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # Select relevant columns for prediction data <- example_isolates %>%   # select AB results dynamically   select(mo, aminoglycosides(), betalactams()) %>%   # replace NAs with NI (not-interpretable)    mutate(across(where(is.sir),                  ~replace_na(.x, \"NI\")),           # make factors of SIR columns           across(where(is.sir),                  as.integer),           # get Gramstain of microorganisms           mo = as.factor(mo_gramstain(mo))) %>%   # drop NAs - the ones without a Gramstain (fungi, etc.)   drop_na() #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For betalactams() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define tidymodels workflow, consists three steps: preprocessing, model specification, fitting.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"create recipe preprocess data modelling. recipe includes least one preprocessing operation, like step_corr(), necessary parameters can estimated training set using prep(): Explanation: recipe(mo ~ ., data = data) take mo column outcome columns predictors. step_corr() removes predictors (.e., antibiotic columns) higher correlation 90%. Notice recipe contains just antimicrobial selector functions - need define columns specifically. preparation (retrieved prep()) can see columns variables ‘AMX’ ‘CTX’ removed correlate much existing, variables.","code":"# Define the recipe for data preprocessing resistance_recipe <- recipe(mo ~ ., data = data) %>%   step_corr(c(aminoglycosides(), betalactams()), threshold = 0.9) resistance_recipe #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Operations #> • Correlation filter on: c(aminoglycosides(), betalactams()) prep(resistance_recipe) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For betalactams() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem) #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Training information #> Training data contained 1968 data points and no incomplete rows. #>  #> ── Operations #> • Correlation filter on: AMX CTX | Trained"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"define logistic regression model since resistance prediction binary classification task. Explanation: logistic_reg() sets logistic regression model. set_engine(\"glm\") specifies use R’s built-GLM engine.","code":"# Specify a logistic regression model logistic_model <- logistic_reg() %>%   set_engine(\"glm\") # Use the Generalised Linear Model engine logistic_model #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"bundle recipe model together workflow, organises entire modelling process.","code":"# Combine the recipe and model into a workflow resistance_workflow <- workflow() %>%   add_recipe(resistance_recipe) %>% # Add the preprocessing recipe   add_model(logistic_model) # Add the logistic regression model resistance_workflow #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: logistic_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 1 Recipe Step #>  #> • step_corr() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"train model, split data training testing sets. , fit workflow training set evaluate performance. Explanation: initial_split() splits data training testing sets. fit() trains workflow training set. Notice fit(), antimicrobial selector functions internally called . training, functions called since stored recipe. Next, evaluate model testing data. Explanation: predict() generates predictions testing set. metrics() computes evaluation metrics like accuracy kappa. appears can predict Gram stain 99.5% accuracy based AMR results aminoglycosides beta-lactam antibiotics. ROC curve looks like :","code":"# Split data into training and testing sets set.seed(123) # For reproducibility data_split <- initial_split(data, prop = 0.8) # 80% training, 20% testing training_data <- training(data_split) # Training set testing_data <- testing(data_split)   # Testing set  # Fit the workflow to the training data fitted_workflow <- resistance_workflow %>%   fit(training_data) # Train the model # Make predictions on the testing set predictions <- fitted_workflow %>%   predict(testing_data)                # Generate predictions probabilities <- fitted_workflow %>%   predict(testing_data, type = \"prob\") # Generate probabilities  predictions <- predictions %>%   bind_cols(probabilities) %>%   bind_cols(testing_data) # Combine with true labels  predictions #> # A tibble: 394 × 24 #>    .pred_class   `.pred_Gram-negative` `.pred_Gram-positive` mo        GEN   TOB #>    <fct>                         <dbl>                 <dbl> <fct>   <int> <int> #>  1 Gram-positive              1.07e- 1              8.93e- 1 Gram-p…     5     5 #>  2 Gram-positive              3.17e- 8              1.00e+ 0 Gram-p…     5     1 #>  3 Gram-negative              9.99e- 1              1.42e- 3 Gram-n…     5     5 #>  4 Gram-positive              2.22e-16              1   e+ 0 Gram-p…     5     5 #>  5 Gram-negative              9.46e- 1              5.42e- 2 Gram-n…     5     5 #>  6 Gram-positive              1.07e- 1              8.93e- 1 Gram-p…     5     5 #>  7 Gram-positive              2.22e-16              1   e+ 0 Gram-p…     1     5 #>  8 Gram-positive              2.22e-16              1   e+ 0 Gram-p…     4     4 #>  9 Gram-negative              1   e+ 0              2.22e-16 Gram-n…     1     1 #> 10 Gram-positive              6.05e-11              1.00e+ 0 Gram-p…     4     4 #> # ℹ 384 more rows #> # ℹ 18 more variables: AMK <int>, KAN <int>, PEN <int>, OXA <int>, FLC <int>, #> #   AMX <int>, AMC <int>, AMP <int>, TZP <int>, CZO <int>, FEP <int>, #> #   CXM <int>, FOX <int>, CTX <int>, CAZ <int>, CRO <int>, IPM <int>, MEM <int>  # Evaluate model performance metrics <- predictions %>%   metrics(truth = mo, estimate = .pred_class) # Calculate performance metrics  metrics #> # A tibble: 2 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989   # To assess some other model properties, you can make our own `metrics()` function our_metrics <- metric_set(accuracy, kap, ppv, npv) # add Positive Predictive Value and Negative Predictive Value metrics2 <- predictions %>%   our_metrics(truth = mo, estimate = .pred_class) # run again on our `our_metrics()` function  metrics2 #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989 #> 3 ppv      binary         0.987 #> 4 npv      binary         1 predictions %>%   roc_curve(mo, `.pred_Gram-negative`) %>%   autoplot()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Conclusion","title":"AMR with tidymodels","text":"post, demonstrated build machine learning pipeline tidymodels framework AMR package. combining selector functions like aminoglycosides() betalactams() tidymodels, efficiently prepared data, trained model, evaluated performance. workflow extensible antimicrobial classes resistance patterns, empowering users analyse AMR data systematically reproducibly.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-2-predicting-amr-over-time","dir":"Articles","previous_headings":"","what":"Example 2: Predicting AMR Over Time","title":"AMR with tidymodels","text":"second example, aim predict antimicrobial resistance (AMR) trends time using tidymodels. model resistance three antibiotics (amoxicillin AMX, amoxicillin-clavulanic acid AMC, ciprofloxacin CIP), based historical data grouped year hospital ward.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Objective","title":"AMR with tidymodels","text":"goal : Prepare dataset aggregating resistance data time. Define regression model predict AMR trends. Use tidymodels preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Data Preparation","title":"AMR with tidymodels","text":"start transforming example_isolates dataset structured time-series format. Explanation: mo_name(mo): Converts microbial codes proper species names. resistance(): Converts AMR results numeric values (proportion resistant isolates). group_by(year, ward, species): Aggregates resistance rates year ward.","code":"# Load required libraries library(AMR) library(tidymodels)  # Transform dataset data_time <- example_isolates %>%   top_n_microorganisms(n = 10) %>% # Filter on the top #10 species   mutate(year = as.integer(format(date, \"%Y\")),  # Extract year from date          gramstain = mo_gramstain(mo)) %>% # Get taxonomic names   group_by(year, gramstain) %>%   summarise(across(c(AMX, AMC, CIP),                     function(x) resistance(x, minimum = 0),                    .names = \"res_{.col}\"),              .groups = \"drop\") %>%    filter(!is.na(res_AMX) & !is.na(res_AMC) & !is.na(res_CIP)) # Drop missing values #> ℹ Using column 'mo' as input for col_mo.  data_time #> # A tibble: 32 × 5 #>     year gramstain     res_AMX res_AMC res_CIP #>    <int> <chr>           <dbl>   <dbl>   <dbl> #>  1  2002 Gram-negative   1      0.105   0.0606 #>  2  2002 Gram-positive   0.838  0.182   0.162  #>  3  2003 Gram-negative   1      0.0714  0      #>  4  2003 Gram-positive   0.714  0.244   0.154  #>  5  2004 Gram-negative   0.464  0.0938  0      #>  6  2004 Gram-positive   0.849  0.299   0.244  #>  7  2005 Gram-negative   0.412  0.132   0.0588 #>  8  2005 Gram-positive   0.882  0.382   0.154  #>  9  2006 Gram-negative   0.379  0       0.1    #> 10  2006 Gram-positive   0.778  0.333   0.353  #> # ℹ 22 more rows"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define modelling workflow, consists preprocessing step, model specification, fitting process.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"Explanation: step_dummy(): Encodes categorical variables (ward, species) numerical indicators. step_normalize(): Normalises year variable. step_nzv(): Removes near-zero variance predictors.","code":"# Define the recipe resistance_recipe_time <- recipe(res_AMX ~ year + gramstain, data = data_time) %>%   step_dummy(gramstain, one_hot = TRUE) %>%  # Convert categorical to numerical   step_normalize(year) %>%  # Normalise year for better model performance   step_nzv(all_predictors())  # Remove near-zero variance predictors  resistance_recipe_time #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:   1 #> predictor: 2 #>  #> ── Operations #> • Dummy variables from: gramstain #> • Centering and scaling for: year #> • Sparse, unbalanced variable filter on: all_predictors()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"use linear regression model predict resistance trends. Explanation: linear_reg(): Defines linear regression model. set_engine(\"lm\"): Uses R’s built-linear regression engine.","code":"# Define the linear regression model lm_model <- linear_reg() %>%   set_engine(\"lm\") # Use linear regression  lm_model #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"combine preprocessing recipe model workflow.","code":"# Create workflow resistance_workflow_time <- workflow() %>%   add_recipe(resistance_recipe_time) %>%   add_model(lm_model)  resistance_workflow_time #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: linear_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 3 Recipe Steps #>  #> • step_dummy() #> • step_normalize() #> • step_nzv() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"split data training testing sets, fit model, evaluate performance. Explanation: initial_split(): Splits data training testing sets. fit(): Trains workflow. predict(): Generates resistance predictions. metrics(): Evaluates model performance.","code":"# Split the data set.seed(123) data_split_time <- initial_split(data_time, prop = 0.8) train_time <- training(data_split_time) test_time <- testing(data_split_time)  # Train the model fitted_workflow_time <- resistance_workflow_time %>%   fit(train_time)  # Make predictions predictions_time <- fitted_workflow_time %>%   predict(test_time) %>%   bind_cols(test_time)   # Evaluate model metrics_time <- predictions_time %>%   metrics(truth = res_AMX, estimate = .pred)  metrics_time #> # A tibble: 3 × 3 #>   .metric .estimator .estimate #>   <chr>   <chr>          <dbl> #> 1 rmse    standard      0.0774 #> 2 rsq     standard      0.711  #> 3 mae     standard      0.0704"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"visualising-predictions","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Visualising Predictions","title":"AMR with tidymodels","text":"plot resistance trends time amoxicillin.  Additionally, can visualise resistance trends ggplot2 directly add linear models :","code":"library(ggplot2)  # Plot actual vs predicted resistance over time ggplot(predictions_time, aes(x = year)) +   geom_point(aes(y = res_AMX, color = \"Actual\")) +   geom_line(aes(y = .pred, color = \"Predicted\")) +   labs(title = \"Predicted vs Actual AMX Resistance Over Time\",        x = \"Year\",        y = \"Resistance Proportion\") +   theme_minimal() ggplot(data_time, aes(x = year, y = res_AMX, color = gramstain)) +   geom_line() +   labs(title = \"AMX Resistance Trends\",        x = \"Year\",        y = \"Resistance Proportion\") +   # add a linear model directly in ggplot2:   geom_smooth(method = \"lm\",               formula = y ~ x,               alpha = 0.25) +   theme_minimal()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion-1","dir":"Articles","previous_headings":"Example 2: Predicting AMR Over Time","what":"Conclusion","title":"AMR with tidymodels","text":"example, demonstrated analyze AMR trends time using tidymodels. aggregating resistance rates year hospital ward, built predictive model track changes resistance amoxicillin (AMX), amoxicillin-clavulanic acid (AMC), ciprofloxacin (CIP). method can extended antibiotics resistance patterns, providing valuable insights AMR dynamics healthcare settings.","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to apply EUCAST rules","text":"EUCAST rules? European Committee Antimicrobial Susceptibility Testing (EUCAST) states website: EUCAST expert rules (see ) tabulated collection expert knowledge interpretive rules, expected resistant phenotypes expected susceptible phenotypes applied antimicrobial susceptibility testing order reduce testing, reduce errors make appropriate recommendations reporting particular resistances. Europe, lot medical microbiological laboratories already apply rules (Brown et al., 2015). package features latest insights expected resistant phenotypes (v1.2, 2023).","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to apply EUCAST rules","text":"rules can used discard improbable bug-drug combinations data. example, Klebsiella produces beta-lactamase prevents ampicillin (amoxicillin) working . words, practically every strain Klebsiella resistant ampicillin. Sometimes, laboratory data can still contain strains Klebsiella susceptible ampicillin. antibiogram available identification available, antibiogram re-interpreted based identification. eucast_rules() function resolves , applying latest ‘EUCAST Expected Resistant Phenotypes’ guideline: convenient function mo_is_intrinsic_resistant() uses guideline, allows check one specific microorganisms antimicrobials: EUCAST rules can used correction, can also used filling known resistance susceptibility based results antimicrobials drugs. process called interpretive reading, basically form imputation:","code":"oops <- tibble::tibble(   mo = c(     \"Klebsiella pneumoniae\",     \"Escherichia coli\"   ),   ampicillin = as.sir(\"S\") ) oops #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   S        #> 2 Escherichia coli        S    eucast_rules(oops, info = FALSE, overwrite = TRUE) #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   R        #> 2 Escherichia coli        S mo_is_intrinsic_resistant(   c(\"Klebsiella pneumoniae\", \"Escherichia coli\"),   \"ampicillin\" ) #> [1]  TRUE FALSE  mo_is_intrinsic_resistant(   \"Klebsiella pneumoniae\",   c(\"ampicillin\", \"kanamycin\") ) #> [1]  TRUE FALSE data <- tibble::tibble(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylenicillin   FOX = \"S\"  # Cefoxitin ) data eucast_rules(data, overwrite = TRUE)"},{"path":"https://amr-for-r.org/articles/MDR.html","id":"type-of-input","dir":"Articles","previous_headings":"","what":"Type of input","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function takes data set input, regular data.frame. tries automatically determine right columns info isolates, name species columns results antimicrobial agents. See help page info set right settings data command ?mdro. WHONET data (data), settings automatically set correctly.","code":""},{"path":"https://amr-for-r.org/articles/MDR.html","id":"guidelines","dir":"Articles","previous_headings":"","what":"Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function support multiple guidelines. can select guideline guideline parameter. Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. “Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.” Clinical Microbiology Infection (2012) (link) guideline = \"EUCAST3.2\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.2 “Intrinsic Resistance Unusual Phenotypes” (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 “Intrinsic Resistance Exceptional Phenotypes Tables” (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization “Companion handbook guidelines programmatic management drug-resistant tuberculosis” (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7. DOI: 10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Rijksinstituut voor Volksgezondheid en Milieu “WIP-richtlijn BRMO (Bijzonder Resistente Micro-Organismen) (ZKH)” (link) Please suggest (country-specific) guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://amr-for-r.org/articles/MDR.html","id":"custom-guidelines","dir":"Articles","previous_headings":"Guidelines","what":"Custom Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"can also use custom guideline. Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() dplyr package, recognise input method set rules. Rules must set using R considers ‘formula notation’: row/isolate matches first rule, value first ~ (case ‘Elderly Type ’) set MDRO value. Otherwise, second rule tried . maximum number rules unlimited. can print rules set console overview. Colours help reading console supports colours. outcome function can used guideline argument mdro() function: rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) custom #> A set of custom MDRO rules: #>   1. If CIP is  R  and age is higher than 60 then: Elderly Type A #>   2. If ERY is  R  and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B x <- mdro(example_isolates, guideline = custom) table(x) #> x #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732"},{"path":"https://amr-for-r.org/articles/MDR.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function always returns ordered factor predefined guidelines. example, output default guideline Magiorakos et al. returns factor levels ‘Negative’, ‘MDR’, ‘XDR’ ‘PDR’ order. next example uses example_isolates data set. data set included package contains full antibiograms 2,000 microbial isolates. reflects reality can used practise AMR data analysis. test MDR/XDR/PDR guideline data set, get: Frequency table Class: factor > ordered (numeric) Length: 2,000 Levels: 4: Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant … Available: 1,745 (87.25%, NA: 255 = 12.75%) Unique: 2 another example, create data set determine multi-drug resistant TB: column names automatically verified valid drug names codes, worked exactly way: data set now looks like : can now add interpretation MDR-TB data set. can use: shortcut mdr_tb(): Create frequency table results: Frequency table Class: factor > ordered (numeric) Length: 5,000 Levels: 5: Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant <… Available: 5,000 (100%, NA: 0 = 0%) Unique: 5","code":"library(dplyr) # to support pipes: %>% library(cleaner) # to create frequency tables example_isolates %>%   mdro() %>%   freq() # show frequency table of the result #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) # random_sir() is a helper function to generate # a random vector with values S, I and R my_TB_data <- data.frame(   rifampicin = random_sir(5000),   isoniazid = random_sir(5000),   gatifloxacin = random_sir(5000),   ethambutol = random_sir(5000),   pyrazinamide = random_sir(5000),   moxifloxacin = random_sir(5000),   kanamycin = random_sir(5000) ) my_TB_data <- data.frame(   RIF = random_sir(5000),   INH = random_sir(5000),   GAT = random_sir(5000),   ETH = random_sir(5000),   PZA = random_sir(5000),   MFX = random_sir(5000),   KAN = random_sir(5000) ) head(my_TB_data) #>   rifampicin isoniazid gatifloxacin ethambutol pyrazinamide moxifloxacin #> 1          I         R            S          S            S            S #> 2          S         S            I          R            R            S #> 3          R         I            I          I            R            I #> 4          I         S            S          S            S            S #> 5          I         I            I          S            I            S #> 6          R         S            R          S            I            I #>   kanamycin #> 1         R #> 2         I #> 3         S #> 4         I #> 5         I #> 6         I mdro(my_TB_data, guideline = \"TB\") my_TB_data$mdr <- mdr_tb(my_TB_data) #> ℹ No column found as input for col_mo, assuming all rows contain #>   Mycobacterium tuberculosis. freq(my_TB_data$mdr)"},{"path":[]},{"path":"https://amr-for-r.org/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"How to conduct principal component analysis (PCA) for AMR","text":"PCA, need transform AMR data first. example_isolates data set package looks like: Now transform data set resistance percentages per taxonomic order genus:","code":"library(AMR) library(dplyr) glimpse(example_isolates) #> Rows: 2,000 #> Columns: 46 #> $ date    <date> 2002-01-02, 2002-01-03, 2002-01-07, 2002-01-07, 2002-01-13, 2… #> $ patient <chr> \"A77334\", \"A77334\", \"067927\", \"067927\", \"067927\", \"067927\", \"4… #> $ age     <dbl> 65, 65, 45, 45, 45, 45, 78, 78, 45, 79, 67, 67, 71, 71, 75, 50… #> $ gender  <chr> \"F\", \"F\", \"F\", \"F\", \"F\", \"F\", \"M\", \"M\", \"F\", \"F\", \"M\", \"M\", \"M… #> $ ward    <chr> \"Clinical\", \"Clinical\", \"ICU\", \"ICU\", \"ICU\", \"ICU\", \"Clinical\"… #> $ mo      <mo> \"B_ESCHR_COLI\", \"B_ESCHR_COLI\", \"B_STPHY_EPDR\", \"B_STPHY_EPDR\",… #> $ PEN     <sir> R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, S,… #> $ OXA     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ FLC     <sir> NA, NA, R, R, R, R, S, S, R, S, S, S, NA, NA, NA, NA, NA, R, R… #> $ AMX     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ AMC     <sir> I, I, NA, NA, NA, NA, S, S, NA, NA, S, S, I, I, R, I, I, NA, N… #> $ AMP     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ TZP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CZO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ FEP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CXM     <sir> I, I, R, R, R, R, S, S, R, S, S, S, S, S, NA, S, S, R, R, S, S… #> $ FOX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ CTX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ CAZ     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, S, S, R, R, … #> $ CRO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ GEN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TOB     <sir> NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, S, S, NA, NA, NA… #> $ AMK     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ KAN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TMP     <sir> R, R, S, S, R, R, R, R, S, S, NA, NA, S, S, S, S, S, R, R, R, … #> $ SXT     <sir> R, R, S, S, NA, NA, NA, NA, S, S, NA, NA, S, S, S, S, S, NA, N… #> $ NIT     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R,… #> $ FOS     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ LNZ     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ CIP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, NA, S, S… #> $ MFX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ VAN     <sir> R, R, S, S, S, S, S, S, S, S, NA, NA, R, R, R, R, R, S, S, S, … #> $ TEC     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ TCY     <sir> R, R, S, S, S, S, S, S, S, I, S, S, NA, NA, I, R, R, S, I, R, … #> $ TGC     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ DOX     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ ERY     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ CLI     <sir> R, R, NA, NA, NA, R, NA, NA, NA, NA, NA, NA, R, R, R, R, R, NA… #> $ AZM     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ IPM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ MEM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ MTR     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CHL     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ COL     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, R, R, R, R, … #> $ MUP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ RIF     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… resistance_data <- example_isolates %>%   group_by(     order = mo_order(mo), # group on anything, like order     genus = mo_genus(mo)   ) %>% #  and genus as we do here   summarise_if(is.sir, resistance) %>% # then get resistance of all drugs   select(     order, genus, AMC, CXM, CTX,     CAZ, GEN, TOB, TMP, SXT   ) # and select only relevant columns  head(resistance_data) #> # A tibble: 6 × 10 #> # Groups:   order [5] #>   order             genus          AMC   CXM   CTX   CAZ   GEN   TOB   TMP   SXT #>   <chr>             <chr>        <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 (unknown order)   (unknown ge…    NA    NA    NA    NA    NA    NA    NA    NA #> 2 Actinomycetales   Schaalia        NA    NA    NA    NA    NA    NA    NA    NA #> 3 Bacteroidales     Bacteroides     NA    NA    NA    NA    NA    NA    NA    NA #> 4 Campylobacterales Campylobact…    NA    NA    NA    NA    NA    NA    NA    NA #> 5 Caryophanales     Gemella         NA    NA    NA    NA    NA    NA    NA    NA #> 6 Caryophanales     Listeria        NA    NA    NA    NA    NA    NA    NA    NA"},{"path":"https://amr-for-r.org/articles/PCA.html","id":"perform-principal-component-analysis","dir":"Articles","previous_headings":"","what":"Perform principal component analysis","title":"How to conduct principal component analysis (PCA) for AMR","text":"new pca() function automatically filter rows contain numeric values selected variables, now need : result can reviewed good old summary() function: Good news. first two components explain total 93.3% variance (see PC1 PC2 values Proportion Variance. can create -called biplot base R biplot() function, see antimicrobial resistance per drug explain difference per microorganism.","code":"pca_result <- pca(resistance_data) #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. summary(pca_result) #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\" #> Importance of components: #>                           PC1    PC2    PC3     PC4     PC5     PC6       PC7 #> Standard deviation     2.1539 1.6807 0.6138 0.33879 0.20808 0.03140 1.232e-16 #> Proportion of Variance 0.5799 0.3531 0.0471 0.01435 0.00541 0.00012 0.000e+00 #> Cumulative Proportion  0.5799 0.9330 0.9801 0.99446 0.99988 1.00000 1.000e+00 #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\""},{"path":"https://amr-for-r.org/articles/PCA.html","id":"plotting-the-results","dir":"Articles","previous_headings":"","what":"Plotting the results","title":"How to conduct principal component analysis (PCA) for AMR","text":"can’t see explanation points. Perhaps works better new ggplot_pca() function, automatically adds right labels even groups:  can also print ellipse per group, edit appearance:","code":"biplot(pca_result) ggplot_pca(pca_result) ggplot_pca(pca_result, ellipse = TRUE) +   ggplot2::labs(title = \"An AMR/PCA biplot!\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"import-of-data","dir":"Articles","previous_headings":"","what":"Import of data","title":"How to work with WHONET data","text":"tutorial assumes already imported WHONET data e.g. readxl package. RStudio, can done using menu button ‘Import Dataset’ tab ‘Environment’. Choose option ‘Excel’ select exported file. Make sure date fields imported correctly. example syntax look like : package comes example data set WHONET. use analysis.","code":"library(readxl) data <- read_excel(path = \"path/to/your/file.xlsx\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to work with WHONET data","text":"First, load relevant packages yet . use tidyverse analyses. . don’t know yet, suggest read website: https://www.tidyverse.org/. transform variables simplify automate analysis: Microorganisms transformed microorganism codes (called mo) using Catalogue Life reference data set, contains ~70,000 microorganisms taxonomic kingdoms Bacteria, Fungi Protozoa. tranformation .mo(). function also recognises almost WHONET abbreviations microorganisms. Antimicrobial results interpretations clean valid. words, contain values \"S\", \"\" \"R\". exactly .sir() function . errors warnings, values transformed succesfully. also created package dedicated data cleaning checking, called cleaner package. freq() function can used create frequency tables. let’s check data, couple frequency tables: Frequency table Class: character Length: 500 Available: 500 (100%, NA: 0 = 0%) Unique: 38 Shortest: 11 Longest: 40 (omitted 28 entries, n = 57 [11.4%]) Frequency table Class: factor > ordered > sir (numeric) Length: 500 Levels: 5: S < SDD < < R < NI Available: 481 (96.2%, NA: 19 = 3.8%) Unique: 3 Drug: Amoxicillin/clavulanic acid (AMC, J01CR02) Drug group: Beta-lactams/penicillins %SI: 78.59%","code":"library(dplyr) # part of tidyverse library(ggplot2) # part of tidyverse library(AMR) # this package library(cleaner) # to create frequency tables # transform variables data <- WHONET %>%   # get microbial ID based on given organism   mutate(mo = as.mo(Organism)) %>%   # transform everything from \"AMP_ND10\" to \"CIP_EE\" to the new `sir` class   mutate_at(vars(AMP_ND10:CIP_EE), as.sir) # our newly created `mo` variable, put in the mo_name() function data %>% freq(mo_name(mo), nmax = 10) # our transformed antibiotic columns # amoxicillin/clavulanic acid (J01CR02) as an example data %>% freq(AMC_ND2)"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"a-first-glimpse-at-results","dir":"Articles","previous_headings":"","what":"A first glimpse at results","title":"How to work with WHONET data","text":"easy ggplot already give lot information, using included ggplot_sir() function:","code":"data %>%   group_by(Country) %>%   select(Country, AMP_ND2, AMC_ED20, CAZ_ED10, CIP_ED5) %>%   ggplot_sir(translate_ab = \"ab\", facet = \"Country\", datalabels = FALSE)"},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Data sets for download / own use","text":"data set 78 679 rows 26 columns, containing following column names:mo, fullname, status, kingdom, phylum, class, order, family, genus, species, subspecies, rank, ref, oxygen_tolerance, source, lpsn, lpsn_parent, lpsn_renamed_to, mycobank, mycobank_parent, mycobank_renamed_to, gbif, gbif_parent, gbif_renamed_to, prevalence, snomed. data set R available microorganisms, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (1.8 MB) Download tab-separated text file (17.7 MB) Download Microsoft Excel workbook (8.7 MB) Download Apache Feather file (8.3 MB) Download Apache Parquet file (3.8 MB) Download IBM SPSS Statistics data file (28.4 MB) Download Stata DTA file (89.5 MB) NOTE: exported files SPSS Stata contain first 50 SNOMED codes per record, file size otherwise exceed 100 MB; file size limit GitHub. file structures compression techniques inefficient. Advice? Use R instead. ’s free much better many ways. tab-separated text file Microsoft Excel workbook contain SNOMED codes comma separated values. Example content Included (sub)species per taxonomic kingdom: First 6 rows filtering genus Escherichia:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antimicrobials-antibiotic-and-antifungal-drugs","dir":"Articles","previous_headings":"","what":"antimicrobials: Antibiotic and Antifungal Drugs","title":"Data sets for download / own use","text":"data set 497 rows 14 columns, containing following column names:ab, cid, name, group, atc, atc_group1, atc_group2, abbreviations, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antimicrobials, load AMR package. last updated 26 April 2025 14:23:14 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (43 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (75 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (0.3 MB) Download Stata DTA file (10 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain ATC codes, common abbreviations, trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"clinical_breakpoints-interpretation-from-mic-values-disk-diameters-to-sir","dir":"Articles","previous_headings":"","what":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","title":"Data sets for download / own use","text":"data set 40 217 rows 14 columns, containing following column names:guideline, type, host, method, site, mo, rank_index, ab, ref_tbl, disk_dose, breakpoint_S, breakpoint_R, uti, is_SDD. data set R available clinical_breakpoints, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (88 kB) Download tab-separated text file (3.7 MB) Download Microsoft Excel workbook (2.4 MB) Download Apache Feather file (1.8 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (6.6 MB) Download Stata DTA file (11.1 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-groups-species-groups-and-microbiological-complexes","dir":"Articles","previous_headings":"","what":"microorganisms.groups: Species Groups and Microbiological Complexes","title":"Data sets for download / own use","text":"data set 534 rows 4 columns, containing following column names:mo_group, mo, mo_group_name, mo_name. data set R available microorganisms.groups, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (50 kB) Download Microsoft Excel workbook (20 kB) Download Apache Feather file (19 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (65 kB) Download Stata DTA file (83 kB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"intrinsic_resistant-intrinsic-bacterial-resistance","dir":"Articles","previous_headings":"","what":"intrinsic_resistant: Intrinsic Bacterial Resistance","title":"Data sets for download / own use","text":"data set 271 905 rows 2 columns, containing following column names:mo ab. data set R available intrinsic_resistant, load AMR package. last updated 28 March 2025 10:17:49 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (0.1 MB) Download tab-separated text file (10.1 MB) Download Microsoft Excel workbook (2.9 MB) Download Apache Feather file (2.3 MB) Download Apache Parquet file (0.3 MB) Download IBM SPSS Statistics data file (14.8 MB) Download Stata DTA file (22.6 MB) Example content Example rows filtering Enterobacter cloacae:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"dosage-dosage-guidelines-from-eucast","dir":"Articles","previous_headings":"","what":"dosage: Dosage Guidelines from EUCAST","title":"Data sets for download / own use","text":"data set 759 rows 9 columns, containing following column names:ab, name, type, dose, dose_times, administration, notes, original_txt, eucast_version. data set R available dosage, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (4 kB) Download tab-separated text file (66 kB) Download Microsoft Excel workbook (37 kB) Download Apache Feather file (28 kB) Download Apache Parquet file (9 kB) Download IBM SPSS Statistics data file (97 kB) Download Stata DTA file (0.2 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates: Example Data for Practice","title":"Data sets for download / own use","text":"data set 2 000 rows 46 columns, containing following column names:date, patient, age, gender, ward, mo, PEN, OXA, FLC, AMX, AMC, AMP, TZP, CZO, FEP, CXM, FOX, CTX, CAZ, CRO, GEN, TOB, AMK, KAN, TMP, SXT, NIT, FOS, LNZ, CIP, MFX, VAN, TEC, TCY, TGC, DOX, ERY, CLI, AZM, IPM, MEM, MTR, CHL, COL, MUP, RIF. data set R available example_isolates, load AMR package. last updated 15 June 2024 13:33:49 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates_unclean-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates_unclean: Example Data for Practice","title":"Data sets for download / own use","text":"data set 3 000 rows 8 columns, containing following column names:patient_id, hospital, date, bacteria, AMX, AMC, CIP, GEN. data set R available example_isolates_unclean, load AMR package. last updated 27 August 2022 18:49:37 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-codes-common-laboratory-codes","dir":"Articles","previous_headings":"","what":"microorganisms.codes: Common Laboratory Codes","title":"Data sets for download / own use","text":"data set 5 063 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 20 April 2025 13:27:36 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (23 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (84 kB) Download Apache Feather file (87 kB) Download Apache Parquet file (59 kB) Download IBM SPSS Statistics data file (0.1 MB) Download Stata DTA file (0.1 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antivirals-antiviral-drugs","dir":"Articles","previous_headings":"","what":"antivirals: Antiviral Drugs","title":"Data sets for download / own use","text":"data set 120 rows 11 columns, containing following column names:av, name, atc, cid, atc_group, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antivirals, load AMR package. last updated 20 October 2023 12:51:48 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (17 kB) Download Microsoft Excel workbook (16 kB) Download Apache Feather file (16 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (32 kB) Download Stata DTA file (78 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Matthijs S. Berends. Author, maintainer. Dennis Souverein. Author, contributor. Erwin E. . Hassing. Author, contributor. Aislinn Cook. Contributor. Andrew P. Norgan. Contributor. Anita Williams. Contributor. Annick Lenglet. Contributor. Anthony Underwood. Contributor. Anton Mymrikov. Contributor. Bart C. Meijer. Contributor. Christian F. Luz. Contributor. Dmytro Mykhailenko. Contributor. Eric H. L. C. M. Hazenberg. Contributor. Gwen Knight. Contributor. Jane Hawkey. Contributor. Jason Stull. Contributor. Javier Sanchez. Contributor. Jonas Salm. Contributor. Judith M. Fonville. Contributor. Kathryn Holt. Contributor. Larisse Bolton. Contributor. Matthew Saab. Contributor. Natacha Couto. Contributor. Peter Dutey-Magni. Contributor. Rogier P. Schade. Contributor. Sofia Ny. Contributor. Alex W. Friedrich. Thesis advisor. Bhanu N. M. Sinha. Thesis advisor. Casper J. Albers. Thesis advisor. Corinna Glasner. Thesis advisor.","code":""},{"path":"https://amr-for-r.org/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). “AMR: R Package Working Antimicrobial Resistance Data.” Journal Statistical Software, 104(3), 1–31. doi:10.18637/jss.v104.i03.","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/index.html","id":"the-amr-package-for-r-","dir":"","previous_headings":"","what":"Antimicrobial Resistance Data Analysis","title":"Antimicrobial Resistance Data Analysis","text":"Provides --one solution antimicrobial resistance (AMR) data analysis One Health approach Peer-reviewed, used 175 countries, available 20 languages Generates antibiograms - traditional, combined, syndromic, even WISCA Provides full microbiological taxonomy ~79 000 distinct species extensive info ~620 antimicrobial drugs Applies CLSI 2011-2025 EUCAST 2011-2025 clinical veterinary breakpoints, ECOFFs, MIC disk zone interpretation Corrects duplicate isolates, calculates predicts AMR per antimicrobial class Integrates WHONET, ATC, EARS-Net, PubChem, LOINC, SNOMED CT, NCBI 100% free costs dependencies, highly suitable places limited resources Now available Python ! Click read . https://amr--r.org https://doi.org/10.18637/jss.v104.i03","code":""},{"path":"https://amr-for-r.org/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Antimicrobial Resistance Data Analysis","text":"AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. team many different researchers around globe make successful durable project! work published Journal Statistical Software (Volume 104(3); DOI 10.18637/jss.v104.i03) formed basis two PhD theses (DOI 10.33612/diss.177417131 DOI 10.33612/diss.192486375). installing package, R knows ~79 000 distinct microbial species (updated June 2024) ~620 antimicrobial antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI 2011-2025 EUCAST 2011-2025 included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen University Medical Center Groningen.","code":""},{"path":"https://amr-for-r.org/index.html","id":"used-in-over-175-countries-available-in-20-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, available in 20 languages","title":"Antimicrobial Resistance Data Analysis","text":"Since first public release early 2018, R package used almost countries world. Click map enlarge see country names. help contributors corners world, AMR package available  English,  Czech,  Chinese,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Italian,  Japanese,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swedish,  Turkish,  Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"filtering-and-selecting-data","dir":"","previous_headings":"Practical examples","what":"Filtering and selecting data","title":"Antimicrobial Resistance Data Analysis","text":"One powerful functions package, aside calculating plotting AMR, selecting filtering based antimicrobial columns. can done using -called antimicrobial selectors, work base R, dplyr data.table. defined row filter Gram-negative bacteria intrinsic resistance cefotaxime (mo_is_gram_negative() mo_is_intrinsic_resistant()) column selection two antibiotic groups (aminoglycosides() carbapenems()), reference data microorganisms antimicrobials AMR package make sure get meant.","code":"# AMR works great with dplyr, but it's not required or neccesary library(AMR) library(dplyr, warn.conflicts = FALSE)  example_isolates %>%   mutate(bacteria = mo_fullname()) %>%   # filtering functions for microorganisms:   filter(mo_is_gram_negative(),          mo_is_intrinsic_resistant(ab = \"cefotax\")) %>%   # antimicrobial selectors:   select(bacteria,          aminoglycosides(),          carbapenems()) #> ℹ Using column 'mo' as input for mo_fullname() #> ℹ Using column 'mo' as input for mo_is_gram_negative() #> ℹ Using column 'mo' as input for mo_is_intrinsic_resistant() #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). This note will be shown once per session. #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 35 × 7 #>    bacteria                     GEN   TOB   AMK   KAN   IPM   MEM   #>    <chr>                        <sir> <sir> <sir> <sir> <sir> <sir> #>  1 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  2 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  3 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  4 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  5 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  6 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  7 Stenotrophomonas maltophilia R     R     R     R     R     R     #>  8 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  9 Pseudomonas aeruginosa       S     S     S     R     NA    S     #> 10 Pseudomonas aeruginosa       S     S     S     R     S     S     #> # ℹ 25 more rows"},{"path":"https://amr-for-r.org/index.html","id":"generating-antibiograms","dir":"","previous_headings":"Practical examples","what":"Generating antibiograms","title":"Antimicrobial Resistance Data Analysis","text":"AMR package supports generating traditional, combined, syndromic, even weighted-incidence syndromic combination antibiograms (WISCA). used inside R Markdown Quarto, table printed right output format automatically (markdown, LaTeX, HTML, etc.). combination antibiograms, clear combined antimicrobials yield higher empiric coverage: Like many functions package, antibiogram() comes support 20 languages often detected automatically based system language:","code":"antibiogram(example_isolates,             antimicrobials = c(aminoglycosides(), carbapenems())) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ 502 combinations had less than minimum = 30 results and were ignored antibiogram(example_isolates,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") #> ℹ 3 combinations had less than minimum = 30 results and were ignored antibiogram(example_isolates,             antimicrobials = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian #> ℹ 3 combinations had less than minimum = 30 results and were ignored"},{"path":"https://amr-for-r.org/index.html","id":"interpreting-and-plotting-mic-and-sir-values","dir":"","previous_headings":"Practical examples","what":"Interpreting and plotting MIC and SIR values","title":"Antimicrobial Resistance Data Analysis","text":"AMR package allows interpretation MIC disk diffusion values based CLSI EUCAST. Moreover, ggplot2 package extended new scale functions, allow plotting log2-distributed MIC values SIR values.","code":"library(ggplot2) library(AMR)  # generate some random values some_mic_values <- random_mic(size = 100) some_groups <- sample(LETTERS[1:5], 20, replace = TRUE) interpretation <- as.sir(some_mic_values,                          guideline = \"EUCAST 2024\",                          mo = \"E. coli\", # or any code or name resembling a known species                          ab = \"Cipro\")   # or any code or name resembling an antibiotic  # create the plot ggplot(data.frame(mic = some_mic_values,                   group = some_groups,                   sir = interpretation),        aes(x = group, y = mic, colour = sir)) +   theme_minimal() +   geom_boxplot(fill = NA, colour = \"grey\") +   geom_jitter(width = 0.25) +      # NEW scale function: plot MIC values to x, y, colour or fill   scale_y_mic() +      # NEW scale function: write out S/I/R in any of the 20 supported languages   #                     and set colourblind-friendly colours   scale_colour_sir()"},{"path":"https://amr-for-r.org/index.html","id":"calculating-resistance-per-group","dir":"","previous_headings":"Practical examples","what":"Calculating resistance per group","title":"Antimicrobial Resistance Data Analysis","text":"manual approach, can use resistance susceptibility() function: use antimicrobial selectors select series antibiotic columns:","code":"example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance() for gentamicin and tobramycin   # and get their 95% confidence intervals using sir_confidence_interval():   summarise(across(c(GEN, TOB),                    list(total_R = resistance,                         conf_int = function(x) sir_confidence_interval(x, collapse = \"-\")))) #> # A tibble: 3 × 5 #>   ward       GEN_total_R GEN_conf_int TOB_total_R TOB_conf_int #>   <chr>            <dbl> <chr>              <dbl> <chr>        #> 1 Clinical     0.2289362 0.205-0.254    0.3147503 0.284-0.347  #> 2 ICU          0.2902655 0.253-0.33     0.4004739 0.353-0.449  #> 3 Outpatient   0.2       0.131-0.285    0.3676471 0.254-0.493 library(AMR) library(dplyr)  out <- example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance(), over all aminoglycosides and polymyxins:   summarise(across(c(aminoglycosides(), polymyxins()),             resistance)) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For polymyxins() using column 'COL' (colistin) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `across(c(aminoglycosides(), polymyxins()), resistance)`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = \"Outpatient\" (minimum = 30). out #> # A tibble: 3 × 6 #>   ward             GEN       TOB       AMK   KAN       COL #>   <chr>          <dbl>     <dbl>     <dbl> <dbl>     <dbl> #> 1 Clinical   0.2289362 0.3147503 0.6258993     1 0.7802956 #> 2 ICU        0.2902655 0.4004739 0.6624473     1 0.8574144 #> 3 Outpatient 0.2       0.3676471 0.6052632    NA 0.8888889 # transform the antibiotic columns to names: out %>% set_ab_names() #> # A tibble: 3 × 6 #>   ward       gentamicin tobramycin  amikacin kanamycin  colistin #>   <chr>           <dbl>      <dbl>     <dbl>     <dbl>     <dbl> #> 1 Clinical    0.2289362  0.3147503 0.6258993         1 0.7802956 #> 2 ICU         0.2902655  0.4004739 0.6624473         1 0.8574144 #> 3 Outpatient  0.2        0.3676471 0.6052632        NA 0.8888889 # transform the antibiotic column to ATC codes: out %>% set_ab_names(property = \"atc\") #> # A tibble: 3 × 6 #>   ward         J01GB03   J01GB01   J01GB06 J01GB04   J01XB01 #>   <chr>          <dbl>     <dbl>     <dbl>   <dbl>     <dbl> #> 1 Clinical   0.2289362 0.3147503 0.6258993       1 0.7802956 #> 2 ICU        0.2902655 0.4004739 0.6624473       1 0.8574144 #> 3 Outpatient 0.2       0.3676471 0.6052632      NA 0.8888889"},{"path":"https://amr-for-r.org/index.html","id":"what-else-can-you-do-with-this-package","dir":"","previous_headings":"","what":"What else can you do with this package?","title":"Antimicrobial Resistance Data Analysis","text":"package intended comprehensive toolbox integrated AMR data analysis. package can used : Reference taxonomy microorganisms, since package contains microbial (sub)species List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF) (manual) Interpreting raw MIC disk diffusion values, based CLSI EUCAST guideline (manual) Retrieving antimicrobial drug names, doses forms administration clinical health care records (manual) Determining first isolates used AMR data analysis (manual) Calculating antimicrobial resistance (tutorial) Determining multi-drug resistance (MDR) / multi-drug resistant organisms (MDRO) (tutorial) Calculating (empirical) susceptibility mono therapy combination therapies (tutorial) Apply AMR function predictive modelling (tutorial) Getting properties microorganism (like Gram stain, species, genus family) (manual) Getting properties antimicrobial (like name, code EARS-Net/ATC/LOINC/PubChem, defined daily dose trade name) (manual) Plotting antimicrobial resistance (tutorial) Applying EUCAST expert rules (manual) Getting SNOMED codes microorganism, getting properties microorganism based SNOMED code (manual) Getting LOINC codes antibiotic, getting properties antibiotic based LOINC code (manual) Machine reading EUCAST CLSI guidelines 2011-2021 translate MIC values disk diffusion diameters SIR (link) Principal component analysis AMR (tutorial)","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"latest-official-version","dir":"","previous_headings":"Get this package","what":"Latest official version","title":"Antimicrobial Resistance Data Analysis","text":"package available official R network (CRAN). Install package R CRAN using command: downloaded installed automatically. RStudio, click menu Tools > Install Packages… type “AMR” press Install. Note: functions website may available latest release. use functions data sets mentioned website, install latest beta version.","code":"install.packages(\"AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"latest-beta-version","dir":"","previous_headings":"Get this package","what":"Latest beta version","title":"Antimicrobial Resistance Data Analysis","text":"Please read Developer Guideline . install latest unpublished beta version:","code":"install.packages(\"AMR\", repos = \"beta.amr-for-r.org\")  # if this does not work, try to install directly from GitHub using the 'remotes' package: remotes::install_github(\"msberends/AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"get-started","dir":"","previous_headings":"","what":"Get started","title":"Antimicrobial Resistance Data Analysis","text":"find conduct AMR data analysis, please continue reading get started click link ‘’ menu.","code":""},{"path":"https://amr-for-r.org/index.html","id":"partners","dir":"","previous_headings":"","what":"Partners","title":"Antimicrobial Resistance Data Analysis","text":"initial development package part , related , made possible following non-profit organisations initiatives:","code":""},{"path":"https://amr-for-r.org/index.html","id":"copyright","dir":"","previous_headings":"","what":"Copyright","title":"Antimicrobial Resistance Data Analysis","text":"R package free, open-source software licensed GNU General Public License v2.0 (GPL-2). nutshell, means package: May used commercial purposes May used private purposes May used patent purposes May modified, although: Modifications must released license distributing package Changes made code must documented May distributed, although: Source code must made available package distributed copy license copyright notice must included package. Comes LIMITATION liability Comes warranty","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"objects -called 'Deprecated'. removed future version package. Using give warning name alternative object replaced (one).","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"","code":"ab_class(...)  ab_selector(...)"},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"object class tbl_df (inherits tbl, data.frame) 497 rows 14 columns.","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":null,"dir":"Reference","previous_headings":"","what":"Options for the AMR package — AMR-options","title":"Options for the AMR package — AMR-options","text":"overview package-specific options() can set AMR package.","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Options for the AMR package — AMR-options","text":"AMR_antibiogram_formatting_type  numeric (1-22) use antibiogram(), indicate formatting type use. AMR_breakpoint_type  character use .sir(), indicate breakpoint type use. must either \"ECOFF\", \"animal\", \"human\". AMR_capped_mic_handling  character use .sir(), indicate capped MIC values (<, <=, >, >=) interpreted. Must one \"standard\", \"strict\", \"relaxed\", \"inverse\" - default \"standard\". AMR_cleaning_regex  regular expression (case-insensitive) use .mo() mo_* functions, clean user input. default outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". AMR_custom_ab  file location RDS file, use custom antimicrobial drugs package. explained add_custom_antimicrobials(). AMR_custom_mo  file location RDS file, use custom microorganisms package. explained add_custom_microorganisms(). AMR_eucastrules  character set default types rules eucast_rules() function, must one : \"breakpoints\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expert\"). AMR_guideline  character set default guideline interpreting MIC values disk diffusion diameters .sir(). Can guideline name (e.g., \"CLSI\") name year (e.g. \"CLSI 2019\"). default latest implemented EUCAST guideline, currently \"EUCAST 2025\". Supported guideline currently EUCAST (2011-2025) CLSI (2011-2025). AMR_ignore_pattern  regular expression ignore (.e., make NA) match given .mo() mo_* functions. AMR_include_PKPD  logical use .sir(), indicate PK/PD clinical breakpoints must applied last resort - default TRUE. AMR_substitute_missing_r_breakpoint  logical use .sir(), indicate missing R breakpoints must substituted \"R\" - default FALSE. AMR_include_screening  logical use .sir(), indicate clinical breakpoints screening allowed - default FALSE. AMR_keep_synonyms  logical use .mo() mo_* functions, indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE. AMR_locale  character set language AMR package, can one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). default current system language (supported, English otherwise). AMR_mo_source  file location manual code list used .mo() mo_* functions. explained set_mo_source().","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"saving-settings-between-sessions","dir":"Reference","previous_headings":"","what":"Saving Settings Between Sessions","title":"Options for the AMR package — AMR-options","text":"Settings R saved globally thus lost R exited. can save options .Rprofile file, user-specific file. can edit using:   file, can set options ...   ...add Portuguese language support antimicrobials, allow PK/PD rules interpreting MIC values .sir().","code":"utils::file.edit(\"~/.Rprofile\") options(AMR_locale = \"pt\")  options(AMR_include_PKPD = TRUE)"},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"share-options-within-team","dir":"Reference","previous_headings":"","what":"Share Options Within Team","title":"Options for the AMR package — AMR-options","text":"global approach, e.g. within (data) team, save options file remote file location, shared network drive, user read file automatically start-. work way: Save plain text file e.g. \"X:/team_folder/R_options.R\" fill preferred settings. user, open .Rprofile file using utils::file.edit(\"~/.Rprofile\") put :   Reload R/RStudio check settings getOption(), e.g. getOption(\"AMR_locale\") set value. Now team settings configured one place, can maintained .","code":"source(\"X:/team_folder/R_options.R\")"},{"path":"https://amr-for-r.org/reference/AMR.html","id":null,"dir":"Reference","previous_headings":"","what":"The AMR Package — AMR","title":"The AMR Package — AMR","text":"Welcome AMR package. AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. Many different researchers around globe continually helping us make successful durable project! work published Journal Statistical Software (Volume 104(3); doi:10.18637/jss.v104.i03 ) formed basis two PhD theses (doi:10.33612/diss.177417131  doi:10.33612/diss.192486375 ). installing package, R knows ~79 000 microorganisms (updated June 2024) ~620 antibiotic, antimycotic antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI EUCAST included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences public University Groningen, collaboration non-profit organisations Certe Medical Diagnostics Advice Foundation University Medical Center Groningen. AMR package available English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":"https://amr-for-r.org/reference/AMR.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"The AMR Package — AMR","text":"cite AMR publications use: Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). \"AMR: R Package Working Antimicrobial Resistance Data.\" Journal Statistical Software, 104(3), 1-31. doi:10.18637/jss.v104.i03 BibTeX entry LaTeX users :","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/reference/AMR.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"The AMR Package — AMR","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/AMR.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"The AMR Package — AMR","text":"Maintainer: Matthijs S. Berends m.s.berends@umcg.nl (ORCID) Authors: Dennis Souverein (ORCID) [contributor] Erwin E. . Hassing [contributor] contributors: Aislinn Cook (ORCID) [contributor] Andrew P. Norgan (ORCID) [contributor] Anita Williams (ORCID) [contributor] Annick Lenglet (ORCID) [contributor] Anthony Underwood (ORCID) [contributor] Anton Mymrikov [contributor] Bart C. Meijer [contributor] Christian F. Luz (ORCID) [contributor] Dmytro Mykhailenko [contributor] Eric H. L. C. M. Hazenberg [contributor] Gwen Knight (ORCID) [contributor] Jane Hawkey (ORCID) [contributor] Jason Stull (ORCID) [contributor] Javier Sanchez (ORCID) [contributor] Jonas Salm [contributor] Judith M. Fonville [contributor] Kathryn Holt (ORCID) [contributor] Larisse Bolton (ORCID) [contributor] Matthew Saab [contributor] Natacha Couto (ORCID) [contributor] Peter Dutey-Magni (ORCID) [contributor] Rogier P. Schade [contributor] Sofia Ny (ORCID) [contributor] Alex W. Friedrich (ORCID) [thesis advisor] Bhanu N. M. Sinha (ORCID) [thesis advisor] Casper J. Albers (ORCID) [thesis advisor] Corinna Glasner (ORCID) [thesis advisor]","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":null,"dir":"Reference","previous_headings":"","what":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"antimicrobial drugs official names, ATC codes, ATC groups defined daily dose (DDD) included package, using Collaborating Centre Drug Statistics Methodology.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"","code":"as.ab(\"meropenem\") #> Class 'ab' #> [1] MEM ab_name(\"J01DH02\") #> [1] \"Meropenem\"  ab_tradenames(\"flucloxacillin\") #>  [1] \"bactopen\"             \"cloxacap\"             \"cloxacillinhydrate\"   #>  [4] \"cloxypen\"             \"floxacillin\"          \"floxacillinanhydrous\" #>  [7] \"floxapen\"             \"floxapensalt\"         \"fluclomix\"            #> [10] \"flucloxacilina\"       \"flucloxacilline\"      \"flucloxacillinum\"     #> [13] \"flucloxin\"            \"fluorochloroxacillin\" \"galfloxin\"            #> [16] \"latocillin\"           \"orbeninhydrate\"       \"rimaflox\"             #> [19] \"staphobristol\"        \"zoxin\""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 500 Isolates - WHONET Example — WHONET","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"example data set exact structure export file WHONET. files can used package, example data set shows. antimicrobial results example_isolates data set. patient names created using online surname generators place practice purposes.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET"},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"tibble 500 observations 53 variables: Identification number ID sample Specimen number ID specimen Organism Name microorganism. analysis, transform valid microbial class, using .mo(). Country Country origin Laboratory Name laboratory Last name Fictitious last name patient First name Fictitious initial patient Sex Fictitious gender patient Age Fictitious age patient Age category Age group, can also looked using age_groups() Date admissionDate hospital admission Specimen dateDate specimen received laboratory Specimen type Specimen type group Specimen type (Numeric) Translation \"Specimen type\" Reason Reason request Differential Diagnosis Isolate number ID isolate Organism type Type microorganism, can also looked using mo_type() Serotype Serotype microorganism Beta-lactamase Microorganism produces beta-lactamase? ESBL Microorganism produces extended spectrum beta-lactamase? Carbapenemase Microorganism produces carbapenemase? MRSA screening test Microorganism possible MRSA? Inducible clindamycin resistance Clindamycin can induced? Comment comments Date data entryDate data entered WHONET AMP_ND10:CIP_EE 28 different antimicrobials. can lookup abbreviations antimicrobials data set, use e.g. ab_name(\"AMP\") get official name immediately. analysis, transform valid antimicrobial class, using .sir().","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET #> # A tibble: 500 × 53 #>    `Identification number` `Specimen number` Organism Country         Laboratory #>    <chr>                               <int> <chr>    <chr>           <chr>      #>  1 fe41d7bafa                           1748 SPN      Belgium         National … #>  2 91f175ec37                           1767 eco      The Netherlands National … #>  3 cc4015056e                           1343 eco      The Netherlands National … #>  4 e864b692f5                           1894 MAP      Denmark         National … #>  5 3d051fe345                           1739 PVU      Belgium         National … #>  6 c80762a08d                           1846 103      The Netherlands National … #>  7 8022d3727c                           1628 103      Denmark         National … #>  8 f3dc5f553d                           1493 eco      The Netherlands National … #>  9 15add38f6c                           1847 eco      France          National … #> 10 fd41248def                           1458 eco      Germany         National … #> # ℹ 490 more rows #> # ℹ 48 more variables: `Last name` <chr>, `First name` <chr>, Sex <chr>, #> #   Age <dbl>, `Age category` <chr>, `Date of admission` <date>, #> #   `Specimen date` <date>, `Specimen type` <chr>, #> #   `Specimen type (Numeric)` <dbl>, Reason <chr>, `Isolate number` <int>, #> #   `Organism type` <chr>, Serotype <chr>, `Beta-lactamase` <lgl>, ESBL <lgl>, #> #   Carbapenemase <lgl>, `MRSA screening test` <lgl>, …"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Use function e.g. clinical texts health care records. returns list antimicrobial drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"ab_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_ab = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_ab type = \"drug\": column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"function also internally used .ab(), although searches first drug name throw note drug names returned. Note: .ab() function may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"default, function search antimicrobial drug names. text elements searched official names, ATC codes brand names. uses .ab() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(abx = ab_from_text(clinical_text)) returned AB codes can transformed official names, groups, etc. ab_* functions ab_name() ab_group(), using translate_ab argument. using collapse, function return character:df %>% mutate(abx = ab_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"# mind the bad spelling of amoxicillin in this line, # straight from a true health care record: ab_from_text(\"28/03/2020 regular amoxicilliin 500mg po tid\") #> [[1]] #> Class 'ab' #> [1] AMX #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") #> [[1]] #> Class 'ab' #> [1] AMX CIP #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"dose\") #> [[1]] #> [1] 500 400 #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"admin\") #> [[1]] #> [1] \"oral\" \"iv\"   #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", collapse = \", \") #> [1] \"AMX, CIP\" # \\donttest{ # if you want to know which antibiotic groups were administered, do e.g.: abx <- ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") ab_group(abx[[1]]) #> [1] \"Beta-lactams/penicillins\" \"Fluoroquinolones\"          if (require(\"dplyr\")) {   tibble(clinical_text = c(     \"given 400mg cipro and 500 mg amox\",     \"started on doxy iv today\"   )) %>%     mutate(       abx_codes = ab_from_text(clinical_text),       abx_doses = ab_from_text(clinical_text, type = \"doses\"),       abx_admin = ab_from_text(clinical_text, type = \"admin\"),       abx_coll = ab_from_text(clinical_text, collapse = \"|\"),       abx_coll_names = ab_from_text(clinical_text,         collapse = \"|\",         translate_ab = \"name\"       ),       abx_coll_doses = ab_from_text(clinical_text,         type = \"doses\",         collapse = \"|\"       ),       abx_coll_admin = ab_from_text(clinical_text,         type = \"admin\",         collapse = \"|\"       )     ) } #> Loading required package: dplyr #>  #> Attaching package: ‘dplyr’ #> The following objects are masked from ‘package:stats’: #>  #>     filter, lag #> The following objects are masked from ‘package:base’: #>  #>     intersect, setdiff, setequal, union #> # A tibble: 2 × 8 #>   clinical_text            abx_codes abx_doses abx_admin abx_coll abx_coll_names #>   <chr>                    <list>    <list>    <list>    <chr>    <chr>          #> 1 given 400mg cipro and 5… <ab [2]>  <dbl [2]> <chr [1]> CIP|AMX  Ciprofloxacin… #> 2 started on doxy iv today <ab [1]>  <dbl [1]> <chr [1]> DOX      Doxycycline    #> # ℹ 2 more variables: abx_coll_doses <chr>, abx_coll_admin <chr> # }"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antibiotic — ab_property","title":"Get Properties of an Antibiotic — ab_property","text":"Use functions return specific property antibiotic antimicrobials data set. input values evaluated internally .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"ab_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  ab_cid(x, ...)  ab_synonyms(x, ...)  ab_tradenames(x, ...)  ab_group(x, language = get_AMR_locale(), ...)  ab_atc(x, only_first = FALSE, ...)  ab_atc_group1(x, language = get_AMR_locale(), ...)  ab_atc_group2(x, language = get_AMR_locale(), ...)  ab_loinc(x, ...)  ab_ddd(x, administration = \"oral\", ...)  ab_ddd_units(x, administration = \"oral\", ...)  ab_info(x, language = get_AMR_locale(), ...)  ab_url(x, open = FALSE, ...)  ab_property(x, property = \"name\", language = get_AMR_locale(), ...)  set_ab_names(data, ..., property = \"name\", language = get_AMR_locale(),   snake_case = NULL)"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antibiotic — ab_property","text":"x (vector ) text can coerced valid antibiotic drug code .ab(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. lead e.g. \"polymyxin B\" \"polymyxin b\". ... case set_ab_names() data data.frame: columns select (supports tidy selection column1:column4), otherwise arguments passed .ab(). only_first logical indicate whether first ATC code must returned, giving preference J0-codes (.e., antimicrobial drug group). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antimicrobials data set: vector_or(colnames(antimicrobials), sort = FALSE). data data.frame columns need renamed, character vector column names. snake_case logical indicate whether names -called snake case: lower case spaces/slashes replaced underscore (_).","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antibiotic — ab_property","text":"integer case ab_cid() named list case ab_info() multiple ab_atc()/ab_synonyms()/ab_tradenames() double case ab_ddd() data.frame case set_ab_names() character cases","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antibiotic — ab_property","text":"output translated possible. function ab_url() return direct URL official website. warning returned required ATC code available. function set_ab_names() special column renaming function data.frames. renames columns names resemble antimicrobial drugs. always makes sure new column names unique. property = \"atc\" set, preference given ATC codes J-group.","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antibiotic — ab_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antibiotic — ab_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"# all properties: ab_name(\"AMX\") #> [1] \"Amoxicillin\" ab_atc(\"AMX\") #> [1] \"J01CA04\" ab_cid(\"AMX\") #> [1] 33613 ab_synonyms(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_tradenames(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_group(\"AMX\") #> [1] \"Beta-lactams/penicillins\" ab_atc_group1(\"AMX\") #> [1] \"Beta-lactam antibacterials, penicillins\" ab_atc_group2(\"AMX\") #> [1] \"Penicillins with extended spectrum\" ab_url(\"AMX\") #>                                                             Amoxicillin  #> \"https://atcddd.fhi.no/atc_ddd_index//?code=J01CA04&showdescription=no\"   # smart lowercase transformation ab_name(x = c(\"AMC\", \"PLB\")) #> [1] \"Amoxicillin/clavulanic acid\" \"Polymyxin B\"                 ab_name(x = c(\"AMC\", \"PLB\"), tolower = TRUE) #> [1] \"amoxicillin/clavulanic acid\" \"polymyxin B\"                  # defined daily doses (DDD) ab_ddd(\"AMX\", \"oral\") #> [1] 1.5 ab_ddd_units(\"AMX\", \"oral\") #> [1] \"g\" ab_ddd(\"AMX\", \"iv\") #> [1] 3 ab_ddd_units(\"AMX\", \"iv\") #> [1] \"g\"  ab_info(\"AMX\") # all properties as a list #> $ab #> [1] \"AMX\" #>  #> $cid #> [1] 33613 #>  #> $name #> [1] \"Amoxicillin\" #>  #> $group #> [1] \"Beta-lactams/penicillins\" #>  #> $atc #> [1] \"J01CA04\" #>  #> $atc_group1 #> [1] \"Beta-lactam antibacterials, penicillins\" #>  #> $atc_group2 #> [1] \"Penicillins with extended spectrum\" #>  #> $tradenames #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           #>  #> $loinc #>  [1] \"101498-4\" \"15-8\"     \"16-6\"     \"16365-9\"  \"17-4\"     \"18-2\"     #>  [7] \"18861-5\"  \"18862-3\"  \"19-0\"     \"20-8\"     \"21-6\"     \"22-4\"     #> [13] \"25274-2\"  \"25310-4\"  \"3344-9\"   \"55614-2\"  \"55615-9\"  \"55616-7\"  #> [19] \"6976-5\"   \"6977-3\"   \"80133-2\"  #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 1.5 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 3 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all ab_* functions use as.ab() internally, so you can go from 'any' to 'any': ab_atc(\"AMP\") #> [1] \"J01CA01\" \"S01AA19\" ab_group(\"J01CA01\") #> [1] \"Beta-lactams/penicillins\" ab_loinc(\"ampicillin\") #>  [1] \"101477-8\" \"101478-6\" \"18864-9\"  \"18865-6\"  \"20374-5\"  \"21066-6\"  #>  [7] \"23618-2\"  \"27-3\"     \"28-1\"     \"29-9\"     \"30-7\"     \"31-5\"     #> [13] \"32-3\"     \"33-1\"     \"3355-5\"   \"33562-0\"  \"33919-2\"  \"34-9\"     #> [19] \"43883-8\"  \"43884-6\"  \"6979-9\"   \"6980-7\"   \"87604-5\"  ab_name(\"21066-6\") #> [1] \"Ampicillin\" ab_name(6249) #> [1] \"Ampicillin\" ab_name(\"J01CA01\") #> [1] \"Ampicillin\"  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  # use set_ab_names() for renaming columns colnames(example_isolates) #>  [1] \"date\"    \"patient\" \"age\"     \"gender\"  \"ward\"    \"mo\"      \"PEN\"     #>  [8] \"OXA\"     \"FLC\"     \"AMX\"     \"AMC\"     \"AMP\"     \"TZP\"     \"CZO\"     #> [15] \"FEP\"     \"CXM\"     \"FOX\"     \"CTX\"     \"CAZ\"     \"CRO\"     \"GEN\"     #> [22] \"TOB\"     \"AMK\"     \"KAN\"     \"TMP\"     \"SXT\"     \"NIT\"     \"FOS\"     #> [29] \"LNZ\"     \"CIP\"     \"MFX\"     \"VAN\"     \"TEC\"     \"TCY\"     \"TGC\"     #> [36] \"DOX\"     \"ERY\"     \"CLI\"     \"AZM\"     \"IPM\"     \"MEM\"     \"MTR\"     #> [43] \"CHL\"     \"COL\"     \"MUP\"     \"RIF\"     colnames(set_ab_names(example_isolates)) #>  [1] \"date\"                          \"patient\"                       #>  [3] \"age\"                           \"gender\"                        #>  [5] \"ward\"                          \"mo\"                            #>  [7] \"benzylpenicillin\"              \"oxacillin\"                     #>  [9] \"flucloxacillin\"                \"amoxicillin\"                   #> [11] \"amoxicillin_clavulanic_acid\"   \"ampicillin\"                    #> [13] \"piperacillin_tazobactam\"       \"cefazolin\"                     #> [15] \"cefepime\"                      \"cefuroxime\"                    #> [17] \"cefoxitin\"                     \"cefotaxime\"                    #> [19] \"ceftazidime\"                   \"ceftriaxone\"                   #> [21] \"gentamicin\"                    \"tobramycin\"                    #> [23] \"amikacin\"                      \"kanamycin\"                     #> [25] \"trimethoprim\"                  \"trimethoprim_sulfamethoxazole\" #> [27] \"nitrofurantoin\"                \"fosfomycin\"                    #> [29] \"linezolid\"                     \"ciprofloxacin\"                 #> [31] \"moxifloxacin\"                  \"vancomycin\"                    #> [33] \"teicoplanin\"                   \"tetracycline\"                  #> [35] \"tigecycline\"                   \"doxycycline\"                   #> [37] \"erythromycin\"                  \"clindamycin\"                   #> [39] \"azithromycin\"                  \"imipenem\"                      #> [41] \"meropenem\"                     \"metronidazole\"                 #> [43] \"chloramphenicol\"               \"colistin\"                      #> [45] \"mupirocin\"                     \"rifampicin\"                    colnames(set_ab_names(example_isolates, NIT:VAN)) #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     set_ab_names()    # this does the same:   example_isolates %>%     rename_with(set_ab_names)    # set_ab_names() works with any AB property:   example_isolates %>%     set_ab_names(property = \"atc\")    example_isolates %>%     set_ab_names(where(is.sir)) %>%     colnames()    example_isolates %>%     set_ab_names(NIT:VAN) %>%     colnames() } #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # }"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Antimicrobials — add_custom_antimicrobials","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"add_custom_antimicrobials() can add custom antimicrobial drug names codes.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"add_custom_antimicrobials(x)  clear_custom_antimicrobials()"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"x data.frame resembling antimicrobials data set, least containing columns \"ab\" \"name\".","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"Important: Due R works, add_custom_antimicrobials() function run every R session - added antimicrobials stored sessions thus lost R exited. two ways circumvent automate process adding antimicrobials: Method 1: Using package option AMR_custom_ab, preferred method. use method: Create data set structure antimicrobials data set (containing least columns \"ab\" \"name\") save saveRDS() location choice, e.g. \"~/my_custom_ab.rds\", remote location. Set file location package option AMR_custom_ab: options(AMR_custom_ab = \"~/my_custom_ab.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_antimicrobials() function. Method 2: Loading antimicrobial additions directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_antimicrobials() clear previously added antimicrobials.","code":"# Add custom antimicrobial codes: options(AMR_custom_ab = \"~/my_custom_ab.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_antimicrobials(    data.frame(ab = \"TESTAB\",               name = \"Test Antibiotic\",               group = \"Test Group\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"# \\donttest{ # returns a wildly guessed result: as.ab(\"testab\") #> Class 'ab' #> [1] THA  # now add a custom entry - it will be considered by as.ab() and # all ab_*() functions add_custom_antimicrobials(   data.frame(     ab = \"TESTAB\",     name = \"Test Antibiotic\",     # you can add any property present in the     # 'antimicrobials' data set, such as 'group':     group = \"Test Group\"   ) ) #> ℹ Added one record to the internal antimicrobials data set.  # \"testab\" is now a new antibiotic: as.ab(\"testab\") #> Class 'ab' #> [1] TESTAB ab_name(\"testab\") #> [1] \"Test Antibiotic\" ab_group(\"testab\") #> [1] \"Test Group\"  ab_info(\"testab\") #> $ab #> [1] \"TESTAB\" #>  #> $cid #> [1] NA #>  #> $name #> [1] \"Test Antibiotic\" #>  #> $group #> [1] \"Test Group\" #>  #> $atc #> [1] NA #>  #> $atc_group1 #> [1] NA #>  #> $atc_group2 #> [1] NA #>  #> $tradenames #> [1] NA #>  #> $loinc #> [1] NA #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] NA #>  #> $ddd$oral$units #> [1] NA #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] NA #>  #> $ddd$iv$units #> [1] NA #>  #>  #>    # Add Co-fluampicil, which is one of the many J01CR50 codes, see # https://atcddd.fhi.no/ddd/list_of_ddds_combined_products/ add_custom_antimicrobials(   data.frame(     ab = \"COFLU\",     name = \"Co-fluampicil\",     atc = \"J01CR50\",     group = \"Beta-lactams/penicillins\"   ) ) #> ℹ Added one record to the internal antimicrobials data set. ab_atc(\"Co-fluampicil\") #> [1] \"J01CR50\" ab_name(\"J01CR50\") #> [1] \"Co-fluampicil\"  # even antimicrobial selectors work # see ?amr_selector x <- data.frame(   random_column = \"some value\",   coflu = as.sir(\"S\"),   ampicillin = as.sir(\"R\") ) x #>   random_column coflu ampicillin #> 1    some value     S          R x[, betalactams()] #> ℹ For betalactams() using columns 'coflu' (co-fluampicil) and #>   'ampicillin' #>   coflu ampicillin #> 1     S          R # }"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Microorganisms — add_custom_microorganisms","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"add_custom_microorganisms() can add custom microorganisms, non-taxonomic outcome laboratory analysis.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"add_custom_microorganisms(x)  clear_custom_microorganisms()"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"x data.frame resembling microorganisms data set, least containing column \"genus\" (case-insensitive).","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"function fill missing taxonomy , specific taxonomic columns missing, see Examples. Important: Due R works, add_custom_microorganisms() function run every R session - added microorganisms stored sessions thus lost R exited. two ways circumvent automate process adding microorganisms: Method 1: Using package option AMR_custom_mo, preferred method. use method: Create data set structure microorganisms data set (containing least column \"genus\") save saveRDS() location choice, e.g. \"~/my_custom_mo.rds\", remote location. Set file location package option AMR_custom_mo: options(AMR_custom_mo = \"~/my_custom_mo.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_microorganisms() function. Method 2: Loading microorganism directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_microorganisms() clear previously added microorganisms.","code":"# Add custom microorganism codes: options(AMR_custom_mo = \"~/my_custom_mo.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_microorganisms(    data.frame(genus = \"Enterobacter\",               species = \"asburiae/cloacae\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"# \\donttest{ # a combination of species is not formal taxonomy, so # this will result in \"Enterobacter cloacae cloacae\", # since it resembles the input best: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae\"  # now add a custom entry - it will be considered by as.mo() and # all mo_*() functions add_custom_microorganisms(   data.frame(     genus = \"Enterobacter\",     species = \"asburiae/cloacae\"   ) ) #> ℹ Added Enterobacter asburiae/cloacae to the internal microorganisms data #>   set.  # E. asburiae/cloacae is now a new microorganism: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # its code: as.mo(\"Enterobacter asburiae/cloacae\") #> Class 'mo' #> [1] CUSTOM1_ENTRB_ASB/  # all internal algorithms will work as well: mo_name(\"Ent asburia cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # and even the taxonomy was added based on the genus! mo_family(\"E. asburiae/cloacae\") #> [1] \"Enterobacteriaceae\" mo_gramstain(\"Enterobacter asburiae/cloacae\") #> [1] \"Gram-negative\"  mo_info(\"Enterobacter asburiae/cloacae\") #> $mo #> [1] \"CUSTOM1_ENTRB_ASB/\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Enterobacter\" #>  #> $species #> [1] \"asburiae/cloacae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] NA #>  #> $url #> [1] \"\" #>  #> $ref #> [1] \"Self-added, 2025\" #>  #> $snomed #> [1] NA #>  #> $lpsn #> [1] NA #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] NA #>  #> $group_members #> character(0) #>    # the function tries to be forgiving: add_custom_microorganisms(   data.frame(     GENUS = \"BACTEROIDES / PARABACTEROIDES SLASHLINE\",     SPECIES = \"SPECIES\"   ) ) #> ℹ Added Bacteroides/Parabacteroides to the internal microorganisms data #>   set. mo_name(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"Bacteroides/Parabacteroides\" mo_rank(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"genus\"  # taxonomy still works, even though a slashline genus was given as input: mo_family(\"Bacteroides/Parabacteroides\") #> [1] \"Bacteroidaceae\"   # for groups and complexes, set them as species or subspecies: add_custom_microorganisms(   data.frame(     genus = \"Citrobacter\",     species = c(\"freundii\", \"braakii complex\"),     subspecies = c(\"complex\", \"\")   ) ) #> ℹ Added Citrobacter braakii complex and Citrobacter freundii complex to the #>   internal microorganisms data set. mo_name(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Citrobacter freundii complex\" \"Citrobacter braakii complex\"  mo_species(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"freundii complex\" \"braakii complex\"  mo_gramstain(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Gram-negative\" \"Gram-negative\" # }"},{"path":"https://amr-for-r.org/reference/age.html","id":null,"dir":"Reference","previous_headings":"","what":"Age in Years of Individuals — age","title":"Age in Years of Individuals — age","text":"Calculates age years based reference date, system date default.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Age in Years of Individuals — age","text":"","code":"age(x, reference = Sys.Date(), exact = FALSE, na.rm = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/age.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Age in Years of Individuals — age","text":"x Date(s), character (vectors) coerced .POSIXlt(). reference Reference date(s) (default today), character (vectors) coerced .POSIXlt(). exact logical indicate whether age calculation exact, .e. decimals. divides number days year--date (YTD) x number days year reference (either 365 366). na.rm logical indicate whether missing values removed. ... Arguments passed .POSIXlt(), origin.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Age in Years of Individuals — age","text":"integer (decimals) exact = FALSE, double (decimals) otherwise","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Age in Years of Individuals — age","text":"Ages 0 returned NA warning. Ages 120 give warning. function vectorises x reference, meaning either can length 1 argument larger length.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Age in Years of Individuals — age","text":"","code":"# 10 random pre-Y2K birth dates df <- data.frame(birth_date = as.Date(\"2000-01-01\") - runif(10) * 25000)  # add ages df$age <- age(df$birth_date)  # add exact ages df$age_exact <- age(df$birth_date, exact = TRUE)  # add age at millenium switch df$age_at_y2k <- age(df$birth_date, \"2000-01-01\")  df #>    birth_date age age_exact age_at_y2k #> 1  1999-06-30  25  25.82192          0 #> 2  1968-01-29  57  57.23836         31 #> 3  1965-12-05  59  59.38904         34 #> 4  1980-03-01  45  45.15342         19 #> 5  1949-11-01  75  75.48219         50 #> 6  1947-02-14  78  78.19452         52 #> 7  1940-02-19  85  85.18082         59 #> 8  1988-01-10  37  37.29041         11 #> 9  1997-08-27  27  27.66301          2 #> 10 1978-01-26  47  47.24658         21"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Split Ages into Age Groups — age_groups","title":"Split Ages into Age Groups — age_groups","text":"Split ages age groups defined split argument. allows easier demographic (antimicrobial resistance) analysis.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split Ages into Age Groups — age_groups","text":"","code":"age_groups(x, split_at = c(12, 25, 55, 75), na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split Ages into Age Groups — age_groups","text":"x Age, e.g. calculated age(). split_at Values split x - default age groups 0-11, 12-24, 25-54, 55-74 75+. See Details. na.rm logical indicate whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Split Ages into Age Groups — age_groups","text":"Ordered factor","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Split Ages into Age Groups — age_groups","text":"split ages, input split_at argument can : numeric vector. value e.g. c(10, 20) split x 0-9, 10-19 20+. value 50 split x 0-49 50+. default split young children (0-11), youth (12-24), young adults (25-54), middle-aged adults (55-74) elderly (75+). character: \"children\" \"kids\", equivalent : c(0, 1, 2, 4, 6, 13, 18). split 0, 1, 2-3, 4-5, 6-12, 13-17 18+. \"elderly\" \"seniors\", equivalent : c(65, 75, 85). split 0-64, 65-74, 75-84, 85+. \"fives\", equivalent : 1:20 * 5. split 0-4, 5-9, ..., 95-99, 100+. \"tens\", equivalent : 1:10 * 10. split 0-9, 10-19, ..., 90-99, 100+.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split Ages into Age Groups — age_groups","text":"","code":"ages <- c(3, 8, 16, 54, 31, 76, 101, 43, 21)  # split into 0-49 and 50+ age_groups(ages, 50) #> [1] 0-49 0-49 0-49 50+  0-49 50+  50+  0-49 0-49 #> Levels: 0-49 < 50+  # split into 0-19, 20-49 and 50+ age_groups(ages, c(20, 50)) #> [1] 0-19  0-19  0-19  50+   20-49 50+   50+   20-49 20-49 #> Levels: 0-19 < 20-49 < 50+  # split into groups of ten years age_groups(ages, 1:10 * 10) #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+ age_groups(ages, split_at = \"tens\") #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+  # split into groups of five years age_groups(ages, 1:20 * 5) #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+ age_groups(ages, split_at = \"fives\") #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+  # split specifically for children age_groups(ages, c(1, 2, 4, 6, 13, 18)) #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+ age_groups(ages, \"children\") #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+  # \\donttest{ # resistance of ciprofloxacin per age group if (require(\"dplyr\") && require(\"ggplot2\")) {   example_isolates %>%     filter_first_isolate() %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(       x = \"age_group\",       minimum = 0,       x.title = \"Age Group\",       title = \"Ciprofloxacin resistance per age group\"     ) } #> Loading required package: ggplot2  # }"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Create detailed antibiograms options traditional, combination, syndromic, Bayesian WISCA methods. Adhering previously described approaches (see Source) especially Bayesian WISCA model (Weighted-Incidence Syndromic Combination Antibiogram) Bielicki et al., functions provide flexible output formats including plots tables, ideal integration R Markdown Quarto reports.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"antibiogram(x, antimicrobials = where(is.sir), mo_transform = \"shortname\",   ab_transform = \"name\", syndromic_group = NULL, add_total_n = FALSE,   only_all_tested = FALSE, digits = ifelse(wisca, 1, 0),   formatting_type = getOption(\"AMR_antibiogram_formatting_type\",   ifelse(wisca, 14, 18)), col_mo = NULL, language = get_AMR_locale(),   minimum = 30, combine_SI = TRUE, sep = \" + \", wisca = FALSE,   simulations = 1000, conf_interval = 0.95, interval_side = \"two-tailed\",   info = interactive(), ...)  wisca(x, antimicrobials = where(is.sir), ab_transform = \"name\",   syndromic_group = NULL, only_all_tested = FALSE, digits = 1,   formatting_type = getOption(\"AMR_antibiogram_formatting_type\", 14),   col_mo = NULL, language = get_AMR_locale(), combine_SI = TRUE,   sep = \" + \", simulations = 1000, conf_interval = 0.95,   interval_side = \"two-tailed\", info = interactive(), ...)  retrieve_wisca_parameters(wisca_model, ...)  # S3 method for class 'antibiogram' plot(x, ...)  # S3 method for class 'antibiogram' autoplot(object, ...)  # S3 method for class 'antibiogram' knit_print(x, italicise = TRUE,   na = getOption(\"knitr.kable.NA\", default = \"\"), ...)"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Bielicki JA et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data Journal Antimicrobial Chemotherapy 71(3); doi:10.1093/jac/dkv397 Bielicki JA et al. (2020). Evaluation coverage 3 antibiotic regimens neonatal sepsis hospital setting across Asian countries JAMA Netw Open. 3(2):e1921124; doi:10.1001.jamanetworkopen.2019.21124 Klinker KP et al. (2021). Antimicrobial stewardship antibiograms: importance moving beyond traditional antibiograms. Therapeutic Advances Infectious Disease, May 5;8:20499361211011373; doi:10.1177/20499361211011373 Barbieri E et al. (2021). Development Weighted-Incidence Syndromic Combination Antibiogram (WISCA) guide choice empiric antibiotic treatment urinary tract infection paediatric patients: Bayesian approach Antimicrobial Resistance & Infection Control May 1;10(1):74; doi:10.1186/s13756-021-00939-2 M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"x data.frame containing least column microorganisms columns antimicrobial results (class 'sir', see .sir()). antimicrobials vector specifying antimicrobials containing SIR values include antibiogram (see Examples). evaluated using guess_ab_col(). can : antimicrobial name code match (see guess_ab_col()) column x antimicrobial selector, aminoglycosides() carbapenems() combination , using c(), e.g.: c(aminoglycosides(), \"AMP\", \"AMC\") c(aminoglycosides(), carbapenems()) Combination therapy, indicated using \"+\", without antimicrobial selectors, e.g.: \"cipro + genta\" \"TZP+TOB\" c(\"TZP\", \"TZP+GEN\", \"TZP+TOB\") carbapenems() + \"GEN\" carbapenems() + c(\"\", \"GEN\") carbapenems() + c(\"\", aminoglycosides()) mo_transform character transform microorganism input - must \"name\", \"shortname\" (default), \"gramstain\", one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Can also NULL transform input NA consider microorganisms 'unknown'. ab_transform character transform antimicrobial input - must one column names antimicrobials data set (defaults \"name\"): \"ab\", \"cid\", \"name\", \"group\", \"atc\", \"atc_group1\", \"atc_group2\", \"abbreviations\", \"synonyms\", \"oral_ddd\", \"oral_units\", \"iv_ddd\", \"iv_units\", \"loinc\". Can also NULL transform input. syndromic_group column name x, values calculated split rows x, e.g. using ifelse() case_when(). See Examples. add_total_n (deprecated favour formatting_type) logical indicate whether n_tested available numbers per pathogen added table (default TRUE). add lowest highest number available isolates per antimicrobial (e.g, E. coli 200 isolates available ciprofloxacin 150 amoxicillin, returned number \"150-200\"). option unavailable wisca = TRUE; case, use retrieve_wisca_parameters() get parameters used WISCA. only_all_tested (combination antibiograms): logical indicate isolates must tested antimicrobials, see Details. digits Number digits use rounding antimicrobial coverage, defaults 1 WISCA 0 otherwise. formatting_type Numeric value (1–22 WISCA, 1-12 non-WISCA) indicating 'cells' antibiogram table formatted. See Details > Formatting Type list options. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). language Language translate text, defaults system language (see get_AMR_locale()). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether susceptibility determined results either S, SDD, , instead S (default TRUE). sep separating character antimicrobial columns combination antibiograms. wisca logical indicate whether Weighted-Incidence Syndromic Combination Antibiogram (WISCA) must generated (default FALSE). use Bayesian decision model estimate regimen coverage probabilities using Monte Carlo simulations. Set simulations, conf_interval, interval_side adjust. simulations (WISCA) numerical value set number Monte Carlo simulations. conf_interval numerical value set confidence interval (default 0.95). interval_side side confidence interval, either \"two-tailed\" (default), \"left\" \"right\". info logical indicate info printed - default TRUE interactive mode. ... used R Markdown Quarto: arguments passed knitr::kable() (otherwise, use). wisca_model outcome wisca() antibiogram(..., wisca = TRUE). object antibiogram() object. italicise logical indicate whether microorganism names knitr table made italic, using italicise_taxonomy(). na Character use showing NA values.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"functions return table values 0 100 susceptibility, resistance. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine one four available algorithms: isolate-based, patient-based, episode-based, phenotype-based. estimating antimicrobial coverage, especially creating WISCA, outcome might become reliable including top n species encountered data. can filter top n using top_n_microorganisms(). example, use top_n_microorganisms(your_data, n = 10) pre-processing step include top 10 species data. numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). ideal e.g. advanced plotting.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"formatting-type","dir":"Reference","previous_headings":"","what":"Formatting Type","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"formatting 'cells' table can set argument formatting_type. examples, 5 indicates antimicrobial coverage (4-6 confidence level), 15 number susceptible isolates, 300 number tested (.e., available) isolates: 5 15 300 15/300 5 (300) 5% (300) 5 (N=300) 5% (N=300) 5 (15/300) 5% (15/300) 5 (N=15/300) 5% (N=15/300) 5 (4-6) 5% (4-6%) - default WISCA 5 (4-6,300) 5% (4-6%,300) 5 (4-6,N=300) 5% (4-6%,N=300) - default non-WISCA 5 (4-6,15/300) 5% (4-6%,15/300) 5 (4-6,N=15/300) 5% (4-6%,N=15/300) default can set globally package option AMR_antibiogram_formatting_type, e.g. options(AMR_antibiogram_formatting_type = 5). note WISCA, total numbers tested susceptible isolates less useful report, since included Bayesian model apparent susceptibility confidence level. Set digits (defaults 0) alter rounding susceptibility percentages.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"antibiogram-types","dir":"Reference","previous_headings":"","what":"Antibiogram Types","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"various antibiogram types, summarised Klinker et al. (2021, doi:10.1177/20499361211011373 ), supported antibiogram(). clinical coverage estimations, use WISCA whenever possible, since provides precise coverage estimates accounting pathogen incidence antimicrobial susceptibility, shown Bielicki et al. (2020, doi:10.1001.jamanetworkopen.2019.21124 ). See section Explaining WISCA page. note WISCA pathogen-agnostic, meaning outcome stratied pathogen, rather syndrome. Traditional Antibiogram Case example: Susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Code example:   Combination Antibiogram Case example: Additional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Code example:   Syndromic Antibiogram Case example: Susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Code example:   Weighted-Incidence Syndromic Combination Antibiogram (WISCA) WISCA can applied antibiogram, see section Explaining WISCA page information. Code example:   WISCA uses sophisticated Bayesian decision model combine local pooled antimicrobial resistance data. approach evaluates local patterns can also draw multi-centre datasets improve regimen accuracy, even low-incidence infections like paediatric bloodstream infections (BSIs).","code":"antibiogram(your_data,             antimicrobials = \"TZP\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\")) antibiogram(your_data,             antimicrobials = penicillins(),             syndromic_group = \"ward\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             wisca = TRUE)  # this is equal to: wisca(your_data,       antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"grouped-tibbles","dir":"Reference","previous_headings":"","what":"Grouped tibbles","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"type antibiogram, grouped tibbles can also used calculate susceptibilities various groups. Code example:","code":"library(dplyr) your_data %>%   group_by(has_sepsis, is_neonate, sex) %>%   wisca(antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"stepped-approach-for-clinical-insight","dir":"Reference","previous_headings":"","what":"Stepped Approach for Clinical Insight","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"clinical practice, antimicrobial coverage decisions evolve microbiological data becomes available. theoretical stepped approach ensures empirical coverage can continuously assessed improve patient outcomes: Initial Empirical Therapy (Admission / Pre-Culture Data) admission, pathogen information available. Action: broad-spectrum coverage based local resistance patterns syndromic antibiograms. Using pathogen-agnostic yet incidence-weighted WISCA preferred. Code example:   Refinement Gram Stain Results blood culture becomes positive, Gram stain provides initial crucial first stratification (Gram-positive vs. Gram-negative). Action: narrow coverage based Gram stain-specific resistance patterns. Code example:   Definitive Therapy Based Species Identification cultivation pathogen, full pathogen identification allows precise targeting therapy. Action: adjust treatment pathogen-specific antibiograms, minimizing resistance risks. Code example:   structuring antibiograms around stepped approach, clinicians can make data-driven adjustments stage, ensuring optimal empirical targeted therapy reducing unnecessary broad-spectrum antimicrobial use.","code":"antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = NA) # all pathogens set to `NA`  # preferred: use WISCA wisca(your_data,       antimicrobials = selected_regimens) antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"gramstain\") # all pathogens set to Gram-pos/Gram-neg antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"shortname\") # all pathogens set to 'G. species', e.g., E. coli"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"inclusion-in-combination-antibiograms","dir":"Reference","previous_headings":"","what":"Inclusion in Combination Antibiograms","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Note combination antibiograms, important realise susceptibility can calculated two ways, can set only_all_tested argument (default FALSE). See example two antimicrobials, Drug Drug B, antibiogram() works calculate %SI:","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - --------------------------------------------------------------------"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"plotting","dir":"Reference","previous_headings":"","what":"Plotting","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"types antibiograms listed can plotted (using ggplot2::autoplot() base R's plot() barplot()). mentioned , numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). outcome antibiogram() can also used directly R Markdown / Quarto (.e., knitr) reports. case, knitr::kable() applied automatically microorganism names even printed italics default (see argument italicise). can also use functions specific 'table reporting' packages transform output antibiogram() needs, e.g. flextable::as_flextable() gt::gt().","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"explaining-wisca","dir":"Reference","previous_headings":"","what":"Explaining WISCA","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"WISCA, outlined Bielicki et al. (doi:10.1093/jac/dkv397 ), stands Weighted-Incidence Syndromic Combination Antibiogram, estimates probability adequate empirical antimicrobial regimen coverage specific infection syndromes. method leverages Bayesian decision model random effects pathogen incidence susceptibility, enabling robust estimates presence sparse data. Bayesian model assumes conjugate priors parameter estimation. example, coverage probability \\(\\theta\\) given antimicrobial regimen modelled using Beta distribution prior: $$\\theta \\sim \\text{Beta}(\\alpha_0, \\beta_0)$$ \\(\\alpha_0\\) \\(\\beta_0\\) represent prior successes failures, respectively, informed expert knowledge weakly informative priors (e.g., \\(\\alpha_0 = 1, \\beta_0 = 1\\)). likelihood function constructed based observed data, number covered cases regimen follows binomial distribution: $$y \\sim \\text{Binomial}(n, \\theta)$$ Posterior parameter estimates obtained combining prior likelihood using Bayes' theorem. posterior distribution \\(\\theta\\) also Beta distribution: $$\\theta | y \\sim \\text{Beta}(\\alpha_0 + y, \\beta_0 + n - y)$$ Pathogen incidence, representing proportion infections caused different pathogens, modelled using Dirichlet distribution, natural conjugate prior multinomial outcomes. Dirichlet distribution parameterised vector concentration parameters \\(\\alpha\\), \\(\\alpha_i\\) corresponds specific pathogen. prior typically chosen uniform (\\(\\alpha_i = 1\\)), reflecting assumption equal prior probability across pathogens. posterior distribution pathogen incidence given : $$\\text{Dirichlet}(\\alpha_1 + n_1, \\alpha_2 + n_2, \\dots, \\alpha_K + n_K)$$ \\(n_i\\) number infections caused pathogen \\(\\) observed data. practical implementation, pathogen incidences sampled posterior using normalised Gamma-distributed random variables: $$x_i \\sim \\text{Gamma}(\\alpha_i + n_i, 1)$$ $$p_i = \\frac{x_i}{\\sum_{j=1}^K x_j}$$ \\(x_i\\) represents unnormalised pathogen counts, \\(p_i\\) normalised proportion pathogen \\(\\). hierarchical modelling, pathogen-level effects (e.g., differences resistance patterns) regimen-level effects modelled using Gaussian priors log-odds. hierarchical structure ensures partial pooling estimates across groups, improving stability strata small sample sizes. model implemented using Hamiltonian Monte Carlo (HMC) sampling. Stratified results can provided based covariates age, sex, clinical complexity (e.g., prior antimicrobial treatments renal/urological comorbidities) using dplyr's group_by() pre-processing step running wisca(). Posterior odds ratios (ORs) derived quantify effect covariates coverage probabilities: $$\\text{}_{\\text{covariate}} = \\frac{\\exp(\\beta_{\\text{covariate}})}{\\exp(\\beta_0)}$$ combining empirical data prior knowledge, WISCA overcomes limitations traditional combination antibiograms, offering disease-specific, patient-stratified estimates robust uncertainty quantification. tool invaluable antimicrobial stewardship programs empirical treatment guideline refinement. Note: WISCA never gives output pathogen/species level, incidences susceptibilities already weighted species.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Implementation: Dr. Larisse Bolton Dr. Matthijs Berends","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ # Traditional antibiogram ----------------------------------------------  antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()) ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram (non-WISCA / 95% CI): 10 × 7 #>    Pathogen       Amikacin    Gentamicin Imipenem Kanamycin Meropenem Tobramycin #>    <chr>          <chr>       <chr>      <chr>    <chr>     <chr>     <chr>      #>  1 CoNS           0% (0-8%,N… 86% (82-9… 52% (37… 0% (0-8%… 52% (37-… 22% (12-3… #>  2 E. coli        100% (98-1… 98% (96-9… 100% (9… NA        100% (99… 97% (96-9… #>  3 E. faecalis    0% (0-9%,N… 0% (0-9%,… 100% (9… 0% (0-9%… NA        0% (0-9%,… #>  4 K. pneumoniae  NA          90% (79-9… 100% (9… NA        100% (93… 90% (79-9… #>  5 P. aeruginosa  NA          100% (88-… NA       0% (0-12… NA        100% (88-… #>  6 P. mirabilis   NA          94% (80-9… 94% (79… NA        NA        94% (80-9… #>  7 S. aureus      NA          99% (97-1… NA       NA        NA        98% (92-1… #>  8 S. epidermidis 0% (0-8%,N… 79% (71-8… NA       0% (0-8%… NA        51% (40-6… #>  9 S. hominis     NA          92% (84-9… NA       NA        NA        85% (74-9… #> 10 S. pneumoniae  0% (0-3%,N… 0% (0-3%,… NA       0% (0-3%… NA        0% (0-3%,… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = aminoglycosides(),   ab_transform = \"atc\",   mo_transform = \"gramstain\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 5 #>   Pathogen      J01GB01            J01GB03             J01GB04         J01GB06   #>   <chr>         <chr>              <chr>               <chr>           <chr>     #> 1 Gram-negative 96% (94-97%,N=686) 96% (95-98%,N=684)  0% (0-10%,N=35) 98% (96-… #> 2 Gram-positive 34% (31-38%,N=665) 63% (60-66%,N=1170) 0% (0-1%,N=436) 0% (0-1%… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = carbapenems(),   ab_transform = \"name\",   mo_transform = \"name\" ) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram (non-WISCA / 95% CI): 5 × 3 #>   Pathogen                                 Imipenem             Meropenem        #>   <chr>                                    <chr>                <chr>            #> 1 Coagulase-negative Staphylococcus (CoNS) 52% (37-67%,N=48)    52% (37-67%,N=4… #> 2 Enterococcus faecalis                    100% (91-100%,N=38)  NA               #> 3 Escherichia coli                         100% (99-100%,N=422) 100% (99-100%,N… #> 4 Klebsiella pneumoniae                    100% (93-100%,N=51)  100% (93-100%,N… #> 5 Proteus mirabilis                        94% (79-99%,N=32)    NA               #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Combined antibiogram -------------------------------------------------  # combined antimicrobials yield higher empiric coverage antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   mo_transform = \"gramstain\" ) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 4 #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # you can use any antimicrobial selector with `+` too: antibiogram(example_isolates,   antimicrobials = ureidopenicillins() + c(\"\", \"GEN\", \"tobra\"),   mo_transform = \"gramstain\" ) #> ℹ For ureidopenicillins() using column 'TZP' (piperacillin/tazobactam) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 4 #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # names of antimicrobials do not need to resemble columns exactly: antibiogram(example_isolates,   antimicrobials = c(\"Cipro\", \"cipro + genta\"),   mo_transform = \"gramstain\",   ab_transform = \"name\",   sep = \" & \" ) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 3 #>   Pathogen      Ciprofloxacin      `Ciprofloxacin & Gentamicin` #>   <chr>         <chr>              <chr>                        #> 1 Gram-negative 91% (88-93%,N=684) 99% (97-99%,N=694)           #> 2 Gram-positive 77% (74-80%,N=724) 93% (91-94%,N=847)           #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Syndromic antibiogram ------------------------------------------------  # the data set could contain a filter for e.g. respiratory specimens antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()),   syndromic_group = \"ward\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram (non-WISCA / 95% CI): 14 × 8 #>    `Syndromic Group` Pathogen   Amikacin Gentamicin Imipenem Kanamycin Meropenem #>    <chr>             <chr>      <chr>    <chr>      <chr>    <chr>     <chr>     #>  1 Clinical          CoNS       NA       89% (84-9… 57% (39… NA        57% (39-… #>  2 ICU               CoNS       NA       79% (68-8… NA       NA        NA        #>  3 Outpatient        CoNS       NA       84% (66-9… NA       NA        NA        #>  4 Clinical          E. coli    100% (9… 98% (96-9… 100% (9… NA        100% (99… #>  5 ICU               E. coli    100% (9… 99% (95-1… 100% (9… NA        100% (97… #>  6 Clinical          K. pneumo… NA       92% (81-9… 100% (9… NA        100% (92… #>  7 Clinical          P. mirabi… NA       100% (88-… NA       NA        NA        #>  8 Clinical          S. aureus  NA       99% (95-1… NA       NA        NA        #>  9 ICU               S. aureus  NA       100% (95-… NA       NA        NA        #> 10 Clinical          S. epider… NA       82% (72-9… NA       NA        NA        #> 11 ICU               S. epider… NA       72% (60-8… NA       NA        NA        #> 12 Clinical          S. hominis NA       96% (85-9… NA       NA        NA        #> 13 Clinical          S. pneumo… 0% (0-5… 0% (0-5%,… NA       0% (0-5%… NA        #> 14 ICU               S. pneumo… 0% (0-1… 0% (0-12%… NA       0% (0-12… NA        #> # ℹ 1 more variable: Tobramycin <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # now define a data set with only E. coli ex1 <- example_isolates[which(mo_genus() == \"Escherichia\"), ] #> ℹ Using column 'mo' as input for mo_genus()  # with a custom language, though this will be determined automatically # (i.e., this table will be in Spanish on Spanish systems) antibiogram(ex1,   antimicrobials = aminoglycosides(),   ab_transform = \"name\",   syndromic_group = ifelse(ex1$ward == \"ICU\",     \"UCI\", \"No UCI\"   ),   language = \"es\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram (non-WISCA / 95% CI): 2 × 5 #>   `Grupo sindrómico` Patógeno Amikacina            Gentamicina       Tobramicina #>   <chr>              <chr>    <chr>                <chr>             <chr>       #> 1 No UCI             E. coli  100% (97-100%,N=119) 98% (96-99%,N=32… 98% (96-99… #> 2 UCI                E. coli  100% (93-100%,N=52)  99% (95-100%,N=1… 96% (92-99… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # WISCA antibiogram ----------------------------------------------------  # WISCA are not stratified by species, but rather on syndromes antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   syndromic_group = \"ward\",   wisca = TRUE ) #> # An Antibiogram (WISCA / 95% CI): 3 × 4 #>   `Syndromic Group` `Piperacillin/tazobactam` Piperacillin/tazobactam + Gentam…¹ #>   <chr>             <chr>                     <chr>                              #> 1 Clinical          73.8% (53.8-89.1%)        93% (80.7-99.1%)                   #> 2 ICU               57.6% (31.5-85.2%)        85.5% (64-98.1%)                   #> 3 Outpatient        58.2% (18.1-94.1%)        77.6% (41.8-99.1%)                 #> # ℹ abbreviated name: ¹​`Piperacillin/tazobactam + Gentamicin` #> # ℹ 1 more variable: `Piperacillin/tazobactam + Tobramycin` <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Print the output for R Markdown / Quarto -----------------------------  ureido <- antibiogram(example_isolates,   antimicrobials = ureidopenicillins(),   syndromic_group = \"ward\",   wisca = TRUE ) #> ℹ For ureidopenicillins() using column 'TZP' (piperacillin/tazobactam)  # in an Rmd file, you would just need to return `ureido` in a chunk, # but to be explicit here: if (requireNamespace(\"knitr\")) {   cat(knitr::knit_print(ureido)) } #>  #>  #> |Syndromic Group |Piperacillin/tazobactam | #> |:---------------|:-----------------------| #> |Clinical        |73% (53.9-89.6%)        | #> |ICU             |56.9% (30.3-84.6%)      | #> |Outpatient      |57.3% (19-94.4%)        |   # Generate plots with ggplot2 or base R --------------------------------  ab1 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\" ) ab2 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\",   syndromic_group = \"ward\" )  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab1) }  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab2) }   plot(ab1)  plot(ab2)  # }"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":null,"dir":"Reference","previous_headings":"","what":"Antimicrobial Selectors — antimicrobial_selectors","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions allow filtering rows selecting columns based antimicrobial test results specific antimicrobial class group, without need define columns antimicrobial abbreviations. can used base R, tidyverse, tidymodels, data.table. short, column name resembles antimicrobial drug, picked functions matches pharmaceutical class: \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" picked using:","code":"library(dplyr) my_data_with_all_these_columns %>%   select(cephalosporins())"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"aminoglycosides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  aminopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  antifungals(only_sir_columns = FALSE, return_all = TRUE, ...)  antimycobacterials(only_sir_columns = FALSE, return_all = TRUE, ...)  betalactams(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  betalactams_with_inhibitor(only_sir_columns = FALSE, return_all = TRUE,   ...)  carbapenems(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_1st(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_2nd(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_3rd(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_4th(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_5th(only_sir_columns = FALSE, return_all = TRUE, ...)  fluoroquinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  glycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  isoxazolylpenicillins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lincosamides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lipoglycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  macrolides(only_sir_columns = FALSE, return_all = TRUE, ...)  monobactams(only_sir_columns = FALSE, return_all = TRUE, ...)  nitrofurans(only_sir_columns = FALSE, return_all = TRUE, ...)  oxazolidinones(only_sir_columns = FALSE, return_all = TRUE, ...)  penicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  phenicols(only_sir_columns = FALSE, return_all = TRUE, ...)  polymyxins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  quinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  rifamycins(only_sir_columns = FALSE, return_all = TRUE, ...)  streptogramins(only_sir_columns = FALSE, return_all = TRUE, ...)  sulfonamides(only_sir_columns = FALSE, return_all = TRUE, ...)  tetracyclines(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  trimethoprims(only_sir_columns = FALSE, return_all = TRUE, ...)  ureidopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  amr_class(amr_class, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  amr_selector(filter, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  administrable_per_os(only_sir_columns = FALSE, return_all = TRUE, ...)  administrable_iv(only_sir_columns = FALSE, return_all = TRUE, ...)  not_intrinsic_resistant(only_sir_columns = FALSE, col_mo = NULL,   version_expected_phenotypes = 1.2, ...)"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"only_sir_columns logical indicate whether columns class sir must selected (default FALSE), see .sir(). only_treatable logical indicate whether antimicrobial drugs excluded laboratory tests (default TRUE), gentamicin-high (GEH) imipenem/EDTA (IPE). return_all logical indicate whether matched columns must returned (default TRUE). FALSE, first unique antimicrobial returned, e.g. columns \"genta\" \"gentamicin\" exist data, first hit gentamicin returned. ... Ignored, place allow future extensions. amr_class antimicrobial class part , \"carba\" \"carbapenems\". columns group, atc_group1 atc_group2 antimicrobials data set searched (case-insensitive) value. filter expression evaluated antimicrobials data set, name %like% \"trim\". col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\".","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"used inside selecting filtering, returns character vector column names, additional class \"amr_selector\". used individually, returns 'ab' vector possible antimicrobials function able select filter.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions can used data set calls selecting columns filtering rows. work base R, Tidyverse, data.table. heavily inspired Tidyverse selection helpers everything(), limited dplyr verbs. Nonetheless, convenient use dplyr functions select(), filter() summarise(), see Examples. selectors can also used tidymodels packages recipe parsnip. See info tutorial using antimicrobial selectors predictive modelling. columns data functions called searched known antimicrobial names, abbreviations, brand names, codes (ATC, EARS-Net, , etc.) according antimicrobials data set. means selector aminoglycosides() pick column names like 'gen', 'genta', 'J01GB03', 'tobra', 'Tobracin', etc. amr_class() function can used filter/select manually defined antimicrobial class. searches results antimicrobials data set within columns group, atc_group1 atc_group2. administrable_per_os() administrable_iv() functions also rely antimicrobials data set - antimicrobials matched DDD (defined daily dose) resp. oral IV treatment available antimicrobials data set. amr_selector() function can used internally filter antimicrobials data set results, see Examples. allows filtering (part ) certain name, /group name even minimum DDDs oral treatment. function yields highest flexibility, also least user-friendly, since requires hard-coded filter set. not_intrinsic_resistant() function can used select antimicrobials pose intrinsic resistance microorganisms data set. example, data set contains microorganism codes names E. coli K. pneumoniae contains column \"vancomycin\", column removed (rather, unselected) using function. currently applies 'EUCAST Expected Resistant Phenotypes' v1.2 (2023) determine intrinsic resistance, using eucast_rules() function internally. determination, function quite slow terms performance.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"full-list-of-supported-antimicrobial-classes","dir":"Reference","previous_headings":"","what":"Full list of supported (antimicrobial) classes","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"aminoglycosides() can select:  amikacin (AMK), amikacin/fosfomycin (AKF), apramycin (APR), arbekacin (ARB), astromicin (AST), bekanamycin (BEK), dibekacin (DKB), framycetin (FRM), gentamicin (GEN), gentamicin-high (GEH), habekacin (HAB), hygromycin (HYG), isepamicin (ISE), kanamycin (KAN), kanamycin-high (KAH), kanamycin/cephalexin (KAC), micronomicin (MCR), neomycin (NEO), netilmicin (NET), pentisomicin (PIM), plazomicin (PLZ), propikacin (PKA), ribostamycin (RST), sisomicin (SIS), streptoduocin (STR), streptomycin (STR1), streptomycin-high (STH), tobramycin (TOB), tobramycin-high (TOH) aminopenicillins() can select:  amoxicillin (AMX) ampicillin (AMP) antifungals() can select:  amorolfine (AMO), amphotericin B (AMB), amphotericin B-high (AMH), anidulafungin (ANI), butoconazole (), caspofungin (CAS), ciclopirox (CIX), clotrimazole (CTR), econazole (ECO), fluconazole (FLU), flucytosine (FCT), fosfluconazole (FFL), griseofulvin (GRI), hachimycin (HCH), ibrexafungerp (IBX), isavuconazole (ISV), isoconazole (ISO), itraconazole (ITR), ketoconazole (KET), manogepix (MGX), micafungin (MIF), miconazole (MCZ), nystatin (NYS), oteseconazole (OTE), pimaricin (PMR), posaconazole (POS), rezafungin (RZF), ribociclib (RBC), sulconazole (SUC), terbinafine (TRB), terconazole (TRC), voriconazole (VOR) antimycobacterials() can select:  4-aminosalicylic acid (AMA), calcium aminosalicylate (CLA), capreomycin (CAP), clofazimine (CLF), delamanid (DLM), enviomycin (ENV), ethambutol (ETH), ethambutol/isoniazid (ETI), ethionamide (ETI1), isoniazid (INH), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), morinamide (MRN), p-aminosalicylic acid (PAS), pretomanid (PMD), protionamide (PTH), pyrazinamide (PZA), rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP), simvastatin/fenofibrate (SMF), sodium aminosalicylate (SDA), streptomycin/isoniazid (STI), terizidone (TRZ), thioacetazone (TAT), thioacetazone/isoniazid (THI1), tiocarlide (TCR), viomycin (VIO) betalactams() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), biapenem (BIA), carbenicillin (CRB), carindacillin (CRN), carumonam (CAR), cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), doripenem (DOR), epicillin (EPC), ertapenem (ETP), flucloxacillin (FLC), hetacillin (HET), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), latamoxef (LTM), lenampicillin (LEN), loracarbef (LOR), mecillinam (MEC), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), panipenem (PAN), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tebipenem (TBP), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC), tigemonam (TMN) betalactams_with_inhibitor() can select:  amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin/sulbactam (SAM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefoperazone/sulbactam (CSL), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefpodoxime/clavulanic acid (CDC), ceftaroline/avibactam (CPA), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), ceftolozane/tazobactam (CZT), ceftriaxone/beta-lactamase inhibitor (CEB), imipenem/relebactam (IMR), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), mezlocillin/sulbactam (MSU), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), ticarcillin/clavulanic acid (TCC) carbapenems() can select:  biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP) cephalosporins() can select:  cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), latamoxef (LTM), loracarbef (LOR) cephalosporins_1st() can select:  cefacetrile (CAC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefroxadine (CRD), ceftezole (CTL), cephradine (CED) cephalosporins_2nd() can select:  cefaclor (CEC), cefamandole (MAN), cefmetazole (CMZ), cefonicid (CID), ceforanide (CND), cefotetan (CTT), cefotiam (CTF), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefprozil (CPR), cefuroxime (CXM), cefuroxime axetil (CXA), loracarbef (LOR) cephalosporins_3rd() can select:  cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefetamet (CAT), cefetamet pivoxil (CPI), cefixime (CFM), cefmenoxime (CMX), cefodizime (DIZ), cefoperazone (CFP), cefoperazone/sulbactam (CSL), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotiam hexetil (CHE), cefovecin (FOV), cefpimizole (CFZ), cefpiramide (CPM), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefsulodin (CFS), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), latamoxef (LTM) cephalosporins_4th() can select:  cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetecol (CCL), cefoselis (CSE), cefozopran (ZOP), cefpirome (CPO), cefquinome (CEQ) cephalosporins_5th() can select:  ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT) fluoroquinolones() can select:  besifloxacin (BES), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) glycopeptides() can select:  avoparcin (AVO), bleomycin (BLM), dalbavancin (DAL), norvancomycin (NVA), oritavancin (ORI), ramoplanin (RAM), teicoplanin (TEC), teicoplanin-macromethod (TCM), telavancin (TLV), vancomycin (VAN), vancomycin-macromethod (VAM) isoxazolylpenicillins() can select:  cloxacillin (CLO), dicloxacillin (DIC), flucloxacillin (FLC), meticillin (MET), oxacillin (OXA), oxacillin screening test (OXA-S) lincosamides() can select:  clindamycin (CLI), lincomycin (LIN), pirlimycin (PRL) lipoglycopeptides() can select:  dalbavancin (DAL), oritavancin (ORI), telavancin (TLV) macrolides() can select:  acetylmidecamycin (ACM), acetylspiramycin (ASP), azithromycin (AZM), clarithromycin (CLR), dirithromycin (DIR), erythromycin (ERY), flurithromycin (FLR1), gamithromycin (GAM), josamycin (JOS), kitasamycin (KIT), meleumycin (MEL), midecamycin (MID), miocamycin (MCM), nafithromycin (ZWK), oleandomycin (OLE), rokitamycin (ROK), roxithromycin (RXT), solithromycin (SOL), spiramycin (SPI), telithromycin (TLT), tildipirosin (TIP), tilmicosin (TIL), troleandomycin (TRL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) monobactams() can select:  aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), carumonam (CAR), tigemonam (TMN) nitrofurans() can select:  furazidin (FUR), furazolidone (FRZ), nifurtoinol (NFR), nitrofurantoin (NIT), nitrofurazone (NIZ) oxazolidinones() can select:  cadazolid (CDZ), cycloserine (CYC), linezolid (LNZ), tedizolid (TZD), thiacetazone (THA) penicillins() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), carbenicillin (CRB), carindacillin (CRN), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), epicillin (EPC), flucloxacillin (FLC), hetacillin (HET), lenampicillin (LEN), mecillinam (MEC), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC) phenicols() can select:  chloramphenicol (CHL), florfenicol (FLR), thiamphenicol (THI) polymyxins() can select:  colistin (COL), polymyxin B (PLB), polymyxin B/polysorbate 80 (POP) quinolones() can select:  besifloxacin (BES), cinoxacin (CIN), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), flumequine (FLM), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nalidixic acid (NAL), nalidixic acid screening test (NAL-S), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), oxolinic acid (OXO), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pipemidic acid (PPA), piromidic acid (PIR), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rosoxacin (ROS), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) rifamycins() can select:  rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP) streptogramins() can select:  pristinamycin (PRI) quinupristin/dalfopristin (QDA) sulfonamides() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfamoxole (SLF8), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13) tetracyclines() can select:  cetocycline (CTO), chlortetracycline (CTE), clomocycline (CLM1), demeclocycline (DEM), doxycycline (DOX), eravacycline (ERV), lymecycline (LYM), metacycline (MTC), minocycline (MNO), omadacycline (OMC), oxytetracycline (OXY), penimepicycline (PNM1), rolitetracycline (RLT), sarecycline (SRC), tetracycline (TCY), tetracycline screening test (TCY-S), tigecycline (TGC) trimethoprims() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadiazine/trimethoprim (SLT1), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfadimidine/trimethoprim (SLT2), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamerazine/trimethoprim (SLT3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfametrole/trimethoprim (SLT4), sulfamoxole (SLF8), sulfamoxole/trimethoprim (SLT5), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13), trimethoprim (TMP), trimethoprim/sulfamethoxazole (SXT) ureidopenicillins() can select:  azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # you can use the selectors separately to retrieve all possible antimicrobials: carbapenems() #> ℹ in carbapenems(): Imipenem/EDTA (IPE) and meropenem/nacubactam #>   (MNC) are not included since only_treatable = TRUE. #> ℹ This 'ab' vector was retrieved using carbapenems(), which should #>   normally be used inside a dplyr verb or data.frame call, e.g.: #>   • your_data %>% select(carbapenems()) #>   • your_data %>% select(column_a, column_b, carbapenems()) #>   • your_data %>% filter(any(carbapenems() == \"R\")) #>   • your_data[, carbapenems()] #>   • your_data[, c(\"column_a\", \"column_b\", carbapenems())] #> Class 'ab' #>  [1] BIA DOR ETP IMR IPM MEM MEV PAN RIA RIT RZM TBP   # Though they are primarily intended to use for selections and filters. # Examples sections below are split into 'dplyr', 'base R', and 'data.table':  # \\donttest{ if (FALSE) { # \\dontrun{ # dplyr -------------------------------------------------------------------  library(dplyr, warn.conflicts = FALSE)  example_isolates %>% select(carbapenems())  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates %>% select(mo, aminoglycosides())  # you can combine selectors like you are used with tidyverse # e.g., for betalactams, but not the ones with an enzyme inhibitor: example_isolates %>% select(betalactams(), -betalactams_with_inhibitor())  # select only antimicrobials with DDDs for oral treatment example_isolates %>% select(administrable_per_os())  # get AMR for all aminoglycosides e.g., per ward: example_isolates %>%   group_by(ward) %>%   summarise(across(aminoglycosides(),                    resistance))  # You can combine selectors with '&' to be more specific: example_isolates %>%   select(penicillins() & administrable_per_os())  # get AMR for only drugs that matter - no intrinsic resistance: example_isolates %>%   filter(mo_genus() %in% c(\"Escherichia\", \"Klebsiella\")) %>%   group_by(ward) %>%   summarise_at(not_intrinsic_resistant(),                resistance)  # get susceptibility for antimicrobials whose name contains \"trim\": example_isolates %>%   filter(first_isolate()) %>%   group_by(ward) %>%   summarise(across(amr_selector(name %like% \"trim\"), susceptibility))  # this will select columns 'IPM' (imipenem) and 'MEM' (meropenem): example_isolates %>%   select(carbapenems())  # this will select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB': example_isolates %>%   select(mo, aminoglycosides())  # any() and all() work in dplyr's filter() too: example_isolates %>%   filter(     any(aminoglycosides() == \"R\"),     all(cephalosporins_2nd() == \"R\")   )  # also works with c(): example_isolates %>%   filter(any(c(carbapenems(), aminoglycosides()) == \"R\"))  # not setting any/all will automatically apply all(): example_isolates %>%   filter(aminoglycosides() == \"R\")  # this will select columns 'mo' and all antimycobacterial drugs ('RIF'): example_isolates %>%   select(mo, amr_class(\"mycobact\"))  # get bug/drug combinations for only glycopeptides in Gram-positives: example_isolates %>%   filter(mo_is_gram_positive()) %>%   select(mo, glycopeptides()) %>%   bug_drug_combinations() %>%   format()  data.frame(   some_column = \"some_value\",   J01CA01 = \"S\" ) %>% # ATC code of ampicillin   select(penicillins()) # only the 'J01CA01' column will be selected  # with recent versions of dplyr, this is all equal: x <- example_isolates[carbapenems() == \"R\", ] y <- example_isolates %>% filter(carbapenems() == \"R\") z <- example_isolates %>% filter(if_all(carbapenems(), ~ .x == \"R\")) identical(x, y) && identical(y, z)  } # } # base R ------------------------------------------------------------------  # select columns 'IPM' (imipenem) and 'MEM' (meropenem) example_isolates[, carbapenems()] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 2,000 × 2 #>    IPM   MEM   #>    <sir> <sir> #>  1   NA    NA  #>  2   NA    NA  #>  3   NA    NA  #>  4   NA    NA  #>  5   NA    NA  #>  6   NA    NA  #>  7   NA    NA  #>  8   NA    NA  #>  9   NA    NA  #> 10   NA    NA  #> # ℹ 1,990 more rows  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates[, c(\"mo\", aminoglycosides())] #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 2,000 × 5 #>    mo           GEN   TOB   AMK   KAN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   NA    NA    NA    NA  #>  2 B_ESCHR_COLI   NA    NA    NA    NA  #>  3 B_STPHY_EPDR   NA    NA    NA    NA  #>  4 B_STPHY_EPDR   NA    NA    NA    NA  #>  5 B_STPHY_EPDR   NA    NA    NA    NA  #>  6 B_STPHY_EPDR   NA    NA    NA    NA  #>  7 B_STPHY_AURS   NA    S     NA    NA  #>  8 B_STPHY_AURS   NA    S     NA    NA  #>  9 B_STPHY_EPDR   NA    NA    NA    NA  #> 10 B_STPHY_EPDR   NA    NA    NA    NA  #> # ℹ 1,990 more rows  # select only antimicrobials with DDDs for oral treatment example_isolates[, administrable_per_os()] #> ℹ For administrable_per_os() using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 23 #>    OXA   FLC   AMX   AMC   AMP   CXM   KAN   TMP   NIT   FOS   LNZ   CIP   MFX   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  2   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  3   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  4   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  5   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  6   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  7   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  8   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  9   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    S     NA  #> 10   NA    S     NA    NA    NA    S     NA    S     NA    NA    NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 10 more variables: VAN <sir>, TCY <sir>, DOX <sir>, ERY <sir>, CLI <sir>, #> #   AZM <sir>, MTR <sir>, CHL <sir>, COL <sir>, RIF <sir>  # filter using any() or all() example_isolates[any(carbapenems() == \"R\"), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … subset(example_isolates, any(carbapenems() == \"R\")) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter on any or all results in the carbapenem columns (i.e., IPM, MEM): example_isolates[any(carbapenems()), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering any of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 962 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  7 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  8 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  9 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #> 10 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #> # ℹ 952 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … example_isolates[all(carbapenems()), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering all of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 756 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-04-14 F30196     73 M      Outpat… B_STRPT_GRPB    S     NA    S     S   #>  2 2003-04-08 114570     74 M      ICU     B_STRPT_PYGN    S     NA    S     S   #>  3 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  4 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  5 2003-08-14 F71508      0 F      Clinic… B_STRPT_GRPB    S     NA    S     S   #>  6 2003-10-16 650870     63 F      ICU     B_ESCHR_COLI    R     NA    NA    R   #>  7 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  9 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> 10 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> # ℹ 746 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter with multiple antimicrobial selectors using c() example_isolates[all(c(carbapenems(), aminoglycosides()) == \"R\"), ] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 26 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  2 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  4 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  5 2008-12-06 501361     43 F      Clinical B_STNTR_MLTP   R     NA    NA    R   #>  6 2011-05-09 207325     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2012-03-12 582258     80 M      ICU      B_STPHY_CONS   R     R     R     R   #>  8 2012-05-19 C25552     89 F      Outpati… B_STPHY_CONS   R     R     R     R   #>  9 2012-07-17 F05015     83 M      ICU      B_STPHY_CONS   R     R     R     R   #> 10 2012-07-20 404299     66 F      Clinical B_STPHY_CONS   R     R     R     R   #> # ℹ 16 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter + select in one go: get penicillins in carbapenem-resistant strains example_isolates[any(carbapenems() == \"R\"), penicillins()] #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For penicillins() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> # A tibble: 55 × 7 #>    PEN   OXA   FLC   AMX   AMC   AMP   TZP   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    NA    NA    NA    NA  #>  2   NA    NA    NA    NA    NA    NA    NA  #>  3   R     NA    NA    R     R     R     R   #>  4   NA    NA    NA    NA    NA    NA    R   #>  5   NA    NA    NA    NA    NA    NA    R   #>  6   NA    NA    NA    NA    NA    NA    R   #>  7   NA    NA    NA    NA    NA    NA    R   #>  8   NA    NA    NA    NA    NA    NA    R   #>  9   R     NA    NA    NA    S     NA    S   #> 10   R     NA    NA    NA    S     NA    S   #> # ℹ 45 more rows  # You can combine selectors with '&' to be more specific. For example, # penicillins() would select benzylpenicillin ('peni G') and # administrable_per_os() would select erythromycin. Yet, when combined these # drugs are both omitted since benzylpenicillin is not administrable per os # and erythromycin is not a penicillin: example_isolates[, penicillins() & administrable_per_os()] #> ℹ For penicillins() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> ℹ For administrable_per_os() using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 5 #>    OXA   FLC   AMX   AMC   AMP   #>    <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA  #>  2   NA    NA    NA    I     NA  #>  3   NA    R     NA    NA    NA  #>  4   NA    R     NA    NA    NA  #>  5   NA    R     NA    NA    NA  #>  6   NA    R     NA    NA    NA  #>  7   NA    S     R     S     R   #>  8   NA    S     R     S     R   #>  9   NA    R     NA    NA    NA  #> 10   NA    S     NA    NA    NA  #> # ℹ 1,990 more rows  # amr_selector() applies a filter in the `antimicrobials` data set and is thus # very flexible. For instance, to select antimicrobials with an oral DDD # of at least 1 gram: example_isolates[, amr_selector(oral_ddd > 1 & oral_units == \"g\")] #> ℹ For amr_selector(oral_ddd > 1 & oral_units == \"g\") using columns 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'KAN' (kanamycin), 'FOS' #>   (fosfomycin), 'LNZ' (linezolid), 'VAN' (vancomycin), 'ERY' (erythromycin), #>   'CLI' (clindamycin), 'MTR' (metronidazole), and 'CHL' (chloramphenicol) #> # A tibble: 2,000 × 13 #>    OXA   FLC   AMX   AMC   AMP   KAN   FOS   LNZ   VAN   ERY   CLI   MTR   CHL   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  2   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  3   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  4   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  5   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  6   NA    R     NA    NA    NA    NA    NA    NA    S     R     R     NA    NA  #>  7   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  8   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  9   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #> 10   NA    S     NA    NA    NA    NA    NA    NA    S     S     NA    NA    NA  #> # ℹ 1,990 more rows   # data.table --------------------------------------------------------------  # data.table is supported as well, just use it in the same way as with # base R, but add `with = FALSE` if using a single AB selector.  if (require(\"data.table\")) {   dt <- as.data.table(example_isolates)    # this does not work, it returns column *names*   dt[, carbapenems()] } #> Loading required package: data.table #>  #> Attaching package: ‘data.table’ #> The following objects are masked from ‘package:dplyr’: #>  #>     between, first, last #> The following objects are masked from ‘package:AMR’: #>  #>     %like%, like #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: It should never be needed to print an antimicrobial selector class. Are you #> using data.table? Then add the argument with = FALSE, see our examples at #> ?amr_selector. #> Class 'amr_selector' #> [1] IPM MEM if (require(\"data.table\")) {   # so `with = FALSE` is required   dt[, carbapenems(), with = FALSE] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>         IPM   MEM #>       <sir> <sir> #>    1:  <NA>  <NA> #>    2:  <NA>  <NA> #>    3:  <NA>  <NA> #>    4:  <NA>  <NA> #>    5:  <NA>  <NA> #>   ---             #> 1996:  <NA>  <NA> #> 1997:     S     S #> 1998:     S     S #> 1999:     S     S #> 2000:     S     S  # for multiple selections or AB selectors, `with = FALSE` is not needed: if (require(\"data.table\")) {   dt[, c(\"mo\", aminoglycosides())] } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>                 mo   GEN   TOB   AMK   KAN #>               <mo> <sir> <sir> <sir> <sir> #>    1: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    2: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    3: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    4: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    5: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>   ---                                      #> 1996: B_STRPT_PNMN     R     R     R     R #> 1997: B_ESCHR_COLI     S     S     S  <NA> #> 1998: B_STPHY_CONS     S  <NA>  <NA>  <NA> #> 1999: B_ESCHR_COLI     S     S  <NA>  <NA> #> 2000: B_KLBSL_PNMN     S     S  <NA>  <NA> if (require(\"data.table\")) {   dt[, c(carbapenems(), aminoglycosides())] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>         IPM   MEM   GEN   TOB   AMK   KAN #>       <sir> <sir> <sir> <sir> <sir> <sir> #>    1:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    2:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    3:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    4:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    5:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>   ---                                     #> 1996:  <NA>  <NA>     R     R     R     R #> 1997:     S     S     S     S     S  <NA> #> 1998:     S     S     S  <NA>  <NA>  <NA> #> 1999:     S     S     S     S  <NA>  <NA> #> 2000:     S     S     S     S  <NA>  <NA>  # row filters are also supported: if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), ] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>            date patient   age gender       ward           mo   PEN   OXA   FLC #>          <Date>  <char> <num> <char>     <char>         <mo> <sir> <sir> <sir> #>   1: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   2: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   3: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   4: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   5: 2002-02-05  067927    45      F        ICU B_SERRT_MRCS     R  <NA>  <NA> #>  ---                                                                           #> 905: 2005-04-12  D71461    70      M        ICU B_ESCHR_COLI     R  <NA>  <NA> #> 906: 2009-11-12  650870    69      F Outpatient B_ESCHR_COLI     R  <NA>  <NA> #> 907: 2012-06-14  8CBCF2    41      F   Clinical B_STPHY_CONS     R     S     S #> 908: 2012-10-11  175532    78      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #> 909: 2013-11-23  A97263    77      M   Clinical B_KLBSL_PNMN     R  <NA>  <NA> #>        AMX   AMC   AMP   TZP   CZO   FEP   CXM   FOX   CTX   CAZ   CRO   GEN #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   2:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   3:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   4:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   5:     R     R     R  <NA>     R  <NA>     R     R  <NA>  <NA>  <NA>  <NA> #>  ---                                                                         #> 905:     S     S     S     S  <NA>     S     S     S     S     S     S     S #> 906:     S     S     S     S     S     S     S     S     S     S     S     S #> 907:  <NA>     S  <NA>  <NA>     S     S     S     S     S     R     S     S #> 908:     R     S     R     S  <NA>     S     R     R     S     S     S     S #> 909:     R     S     R     S  <NA>     S     S     S     S     S     S     S #>        TOB   AMK   KAN   TMP   SXT   NIT   FOS   LNZ   CIP   MFX   VAN   TEC #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   2:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   3:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   4:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   5:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>  ---                                                                         #> 905:     S     S  <NA>  <NA>     S     S  <NA>     R     S  <NA>     R     R #> 906:     S     S  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #> 907:  <NA>  <NA>  <NA>     S     S  <NA>  <NA>  <NA>     S  <NA>     S  <NA> #> 908:     S  <NA>  <NA>     R     R     R  <NA>     R     R     R     R     R #> 909:     S  <NA>  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #>        TCY   TGC   DOX   ERY   CLI   AZM   IPM   MEM   MTR   CHL   COL   MUP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   2:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   3:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   4:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   5:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>  ---                                                                         #> 905:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 906:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 907:  <NA>  <NA>  <NA>     S     S     S     S     S  <NA>  <NA>     R  <NA> #> 908:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #> 909:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #>        RIF #>      <sir> #>   1:     R #>   2:     R #>   3:     R #>   4:     R #>   5:     R #>  ---       #> 905:     R #> 906:     R #> 907:  <NA> #> 908:     R #> 909:     R if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), penicillins(), with = FALSE] } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For penicillins() using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #>        PEN   OXA   FLC   AMX   AMC   AMP   TZP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   2:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   3:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   4:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   5:     R  <NA>  <NA>     R     R     R  <NA> #>  ---                                           #> 905:     R  <NA>  <NA>     S     S     S     S #> 906:     R  <NA>  <NA>     S     S     S     S #> 907:     R     S     S  <NA>     S  <NA>  <NA> #> 908:     R  <NA>  <NA>     R     S     R     S #> 909:     R  <NA>  <NA>     R     S     R     S # }"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Two data sets containing antimicrobials antivirals. Use .ab() one ab_* functions retrieve values antimicrobials data set. Three identifiers included data set: antimicrobial ID (ab, primarily used package) defined WHONET/EARS-Net, ATC code (atc) defined , Compound ID (cid) found PubChem. properties data set derived one codes. Note drugs multiple ATC codes.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials  antivirals"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"object class tbl_df (inherits tbl, data.frame) 120 rows 11 columns.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antimicrobials-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antimicrobials data set: a tibble with 497 observations and 14 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"ab antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. cid Compound ID found PubChem. unique identifier. name Official name used WHONET/EARS-Net . unique identifier. group short concise group name, based WHONET WHOCC definitions atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, like J01CR02 atc_group1 Official pharmacological subgroup (3rd level ATC code) defined WHOCC, like \"Macrolides, lincosamides streptogramins\" atc_group2 Official chemical subgroup (4th level ATC code) defined WHOCC, like \"Macrolides\" abbr List abbreviations used many countries, also antimicrobial susceptibility testing (AST) synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 179 drugs oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral (intravenous) treatment, currently available 153 drugs iv_units Units iv_ddd loinc codes associated name antimicrobial drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use ab_loinc() retrieve quickly, see ab_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antivirals-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antivirals data set: a tibble with 120 observations and 11 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"av Antiviral ID used package (ACI), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. Combinations codes contain + indicate , ATA+COBI atazanavir/cobicistat. name Official name used WHONET/EARS-Net . unique identifier. atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC cid Compound ID found PubChem. unique identifier. atc_group Official pharmacological subgroup (3rd level ATC code) defined WHOCC synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral treatment iv_units Units iv_ddd loinc codes associated name antiviral drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use av_loinc() retrieve quickly, see av_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology (WHOCC): https://atcddd.fhi./atc_ddd_index/ Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Accessed https://loinc.org October 19th, 2023. European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials #> # A tibble: 497 × 14 #>    ab        cid name   group atc   atc_group1 atc_group2 abbreviations synonyms #>    <ab>    <dbl> <chr>  <chr> <lis> <chr>      <chr>      <list>        <named > #>  1 AMA      4649 4-ami… Anti… <chr> Drugs for… Aminosali… <chr [1]>     <chr>    #>  2 ACM   6450012 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  3 ASP  49787020 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  4 ALS      8954 Aldes… Othe… <chr> Drugs for… Drugs for… <chr [1]>     <chr>    #>  5 AMK     37768 Amika… Amin… <chr> Aminoglyc… Other ami… <chr [5]>     <chr>    #>  6 AKF        NA Amika… Amin… <chr> NA         NA         <chr [1]>     <chr>    #>  7 AMO     54260 Amoro… Anti… <chr> Antifunga… Other ant… <chr [1]>     <chr>    #>  8 AMX     33613 Amoxi… Beta… <chr> Beta-lact… Penicilli… <chr [3]>     <chr>    #>  9 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [5]>     <chr>    #> 10 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> # ℹ 487 more rows #> # ℹ 5 more variables: oral_ddd <dbl>, oral_units <chr>, iv_ddd <dbl>, #> #   iv_units <chr>, loinc <list> antivirals #> # A tibble: 120 × 11 #>    av       name      atc      cid atc_group synonyms oral_ddd oral_units iv_ddd #>    <av>     <chr>     <chr>  <dbl> <chr>     <list>      <dbl> <chr>       <dbl> #>  1 ABA      Abacavir  J05A… 4.41e5 Nucleosi… <chr>         0.6 g              NA #>  2 ACI      Aciclovir J05A… 1.35e8 Nucleosi… <chr>         4   g               4 #>  3 ADD      Adefovir… J05A… 6.09e4 Nucleosi… <chr>        10   mg             NA #>  4 AME      Amenamev… J05A… 1.14e7 Other an… <chr>         0.4 g              NA #>  5 AMP      Amprenav… J05A… 6.50e4 Protease… <chr>         1.2 g              NA #>  6 ASU      Asunapre… J05A… 1.61e7 Antivira… <chr>         0.2 g              NA #>  7 ATA      Atazanav… J05A… 1.48e5 Protease… <chr>         0.3 g              NA #>  8 ATA+COBI Atazanav… J05A… 8.66e7 Antivira… <chr>        NA   NA             NA #>  9 ATA+RIT  Atazanav… J05A… 2.51e7 Antivira… <chr>         0.3 g              NA #> 10 BAM      Baloxavi… J05A… 1.24e8 Other an… <chr>        40   mg             NA #> # ℹ 110 more rows #> # ℹ 2 more variables: iv_units <chr>, loinc <list>"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antibiotic ID — as.ab","title":"Transform Input to an Antibiotic ID — as.ab","text":"Use function determine antimicrobial drug code one antimicrobials. data set antimicrobials searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"as.ab(x, flag_multiple_results = TRUE, language = get_AMR_locale(),   info = interactive(), ...)  is.ab(x)  ab_reset_session()"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antibiotic ID — as.ab","text":"x character vector determine antibiotic ID. flag_multiple_results logical indicate whether note printed console probably one antibiotic drug code name can retrieved single input value. language Language coerce input values 20 supported languages - default system language supported (see get_AMR_locale()). info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antibiotic ID — as.ab","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antibiotic ID — as.ab","text":"entries antimicrobials data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .ab() can correct different forms misspelling: Wrong spelling drug names (\"tobramicin\" \"gentamycin\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"mreopenem\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use ab_* functions get properties based returned antibiotic ID, see Examples. Note: .ab() ab_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems. can add manual codes considered .ab() ab_* functions, see add_custom_antimicrobials().","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antibiotic ID — as.ab","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antibiotic ID — as.ab","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antibiotic ID — as.ab","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"# these examples all return \"ERY\", the ID of erythromycin: as.ab(\"J01FA01\") #> Class 'ab' #> [1] ERY as.ab(\"J 01 FA 01\") #> Class 'ab' #> [1] ERY as.ab(\"Erythromycin\") #> Class 'ab' #> [1] ERY as.ab(\"eryt\") #> Class 'ab' #> [1] ERY as.ab(\"ERYT\") #> Class 'ab' #> [1] ERY as.ab(\"ERY\") #> Class 'ab' #> [1] ERY as.ab(\"eritromicine\") # spelled wrong, yet works #> Class 'ab' #> [1] ERY as.ab(\"Erythrocin\") # trade name #> Class 'ab' #> [1] ERY as.ab(\"Romycin\") # trade name #> Class 'ab' #> [1] AST  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  # use ab_* functions to get a specific properties (see ?ab_property); # they use as.ab() internally: ab_name(\"J01FA01\") #> [1] \"Erythromycin\" ab_name(\"eryt\") #> [1] \"Erythromycin\"  # \\donttest{ if (require(\"dplyr\")) {   # you can quickly rename 'sir' columns using set_ab_names() with dplyr:   example_isolates %>%     set_ab_names(where(is.sir), property = \"atc\") } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           J01CE01 J01CF04 J01CF05 #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir>   <sir>   <sir>   #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R       NA      S     #> # ℹ 1,990 more rows #> # ℹ 37 more variables: J01CA04 <sir>, J01CR02 <sir>, J01CA01 <sir>, #> #   J01CR05 <sir>, J01DB04 <sir>, J01DE01 <sir>, J01DC02 <sir>, J01DC01 <sir>, #> #   J01DD01 <sir>, J01DD02 <sir>, J01DD04 <sir>, J01GB03 <sir>, J01GB01 <sir>, #> #   J01GB06 <sir>, J01GB04 <sir>, J01EA01 <sir>, J01EE01 <sir>, J01XE01 <sir>, #> #   J01XX01 <sir>, J01XX08 <sir>, J01MA02 <sir>, J01MA14 <sir>, J01XA01 <sir>, #> #   J01XA02 <sir>, J01AA07 <sir>, J01AA12 <sir>, J01AA02 <sir>, … # }"},{"path":"https://amr-for-r.org/reference/as.av.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antiviral Drug ID — as.av","title":"Transform Input to an Antiviral Drug ID — as.av","text":"Use function determine antiviral drug code one antiviral drugs. data set antivirals searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"as.av(x, flag_multiple_results = TRUE, info = interactive(), ...)  is.av(x)"},{"path":"https://amr-for-r.org/reference/as.av.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antiviral Drug ID — as.av","text":"x character vector determine antiviral drug ID. flag_multiple_results logical indicate whether note printed console probably one antiviral drug code name can retrieved single input value. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antiviral Drug ID — as.av","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antiviral Drug ID — as.av","text":"entries antivirals data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .av() can correct different forms misspelling: Wrong spelling drug names (\"acyclovir\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"aycclovir\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use av_* functions get properties based returned antiviral drug ID, see Examples. Note: .av() av_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antiviral Drug ID — as.av","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antiviral Drug ID — as.av","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antiviral Drug ID — as.av","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"# these examples all return \"ACI\", the ID of aciclovir: as.av(\"J05AB01\") #> Class 'av' #> [1] ACI as.av(\"J 05 AB 01\") #> Class 'av' #> [1] ACI as.av(\"Aciclovir\") #> Class 'av' #> [1] ACI as.av(\"aciclo\") #> Class 'av' #> [1] ACI as.av(\"   aciclo 123\") #> Class 'av' #> [1] ACI as.av(\"ACICL\") #> Class 'av' #> [1] ACI as.av(\"ACI\") #> Class 'av' #> [1] ACI as.av(\"Virorax\") # trade name #> Class 'av' #> [1] ACI as.av(\"Zovirax\") # trade name #> Class 'av' #> [1] ACI  as.av(\"acyklofir\") # severe spelling error, yet works #> Class 'av' #> [1] ACI  # use av_* functions to get a specific properties (see ?av_property); # they use as.av() internally: av_name(\"J05AB01\") #> [1] \"Aciclovir\" av_name(\"acicl\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Disk Diffusion Diameters — as.disk","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"transforms vector new class disk, disk diffusion growth zone size (around antibiotic disk) millimetres 0 50.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"as.disk(x, na.rm = FALSE)  NA_disk_  is.disk(x)"},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"object class disk (inherits integer) length 1.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"x Vector. na.rm logical indicating whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"integer additional class disk","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"Interpret disk values SIR values .sir(). supports guidelines EUCAST CLSI. Disk diffusion growth zone sizes must 0 50 millimetres. Values higher 50 lower 100 maximised 50. others input values outside 0-50 range return NA. NA_disk_ missing value new disk class.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"# transform existing disk zones to the `disk` class (using base R) df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = 20,   CIP = 14,   GEN = 18,   TOB = 16 ) df[, 2:5] <- lapply(df[, 2:5], as.disk) str(df) #> 'data.frame':\t1 obs. of  5 variables: #>  $ microorganism: chr \"Escherichia coli\" #>  $ AMP          : 'disk' int 20 #>  $ CIP          : 'disk' int 14 #>  $ GEN          : 'disk' int 18 #>  $ TOB          : 'disk' int 16  # \\donttest{ # transforming is easier with dplyr: if (require(\"dplyr\")) {   df %>% mutate(across(AMP:TOB, as.disk)) } #>      microorganism AMP CIP GEN TOB #> 1 Escherichia coli  20  14  18  16 # }  # interpret disk values, see ?as.sir as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R  # interpret whole data set, pretend to be all from urinary tract infections: as.sir(df, uti = TRUE) #>      microorganism AMP  CIP GEN TOB #> 1 Escherichia coli   S <NA>   S   S"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"transforms vectors new class mic, treats input decimal numbers, maintaining operators (\">=\") allowing valid MIC values known field (medical) microbiology.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"as.mic(x, na.rm = FALSE, keep_operators = \"all\")  is.mic(x)  NA_mic_  rescale_mic(x, mic_range, keep_operators = \"edges\", as.mic = TRUE)  mic_p50(x, na.rm = FALSE, ...)  mic_p90(x, na.rm = FALSE, ...)  # S3 method for class 'mic' droplevels(x, as.mic = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"x character numeric vector. na.rm logical indicating whether missing values removed. keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values, e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). .mic logical indicate whether mic class kept - default TRUE rescale_mic() FALSE droplevels(). setting FALSE rescale_mic(), output factor levels acknowledge mic_range. ... Arguments passed methods.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"Ordered factor additional class mic, mathematical operations acts numeric vector. Bear mind outcome mathematical operation MICs return numeric value.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"interpret MIC values SIR values, use .sir() MIC values. supports guidelines EUCAST (2011-2025) CLSI (2011-2025). class MIC values quite special data type: formally ordered factor valid MIC values factor levels (make sure valid MIC values retained), mathematical operation acts decimal numbers:   makes possible maintain operators often come MIC values, \">=\" \"<=\", even filtering using numeric values data analysis, e.g.:   -called group generic functions implemented MIC class (!, !=, <, >=, exp(), log2()). mathematical functions also implemented (quantile(), median(), fivenum()). Since sd() var() non-generic functions, extended. Use mad() alternative, use e.g. sd(.numeric(x)) x vector MIC values. Using .double() .numeric() MIC values remove operators return numeric vector. use .integer() MIC values R convention factors, return index factor levels (often useless regular users). function .mic() detects input contains class mic. input data.frame list, iterates columns/items returns logical vector. Use droplevels() drop unused levels. default, return plain factor. Use droplevels(..., .mic = TRUE) maintain mic class. rescale_mic(), existing MIC ranges can limited defined range MIC values. can useful better compare MIC distributions. ggplot2, use one scale_*_mic() functions plot MIC values. allows custom MIC ranges plot intermediate log2 levels missing MIC values. NA_mic_ missing value new mic class, analogous e.g. base R's NA_character_. Use mic_p50() mic_p90() get 50th 90th percentile MIC values. return 'normal' numeric values.","code":"x <- random_mic(10) x #> Class 'mic' #>  [1] 16     1      8      8      64     >=128  0.0625 32     32     16  is.factor(x) #> [1] TRUE  x[1] * 2 #> [1] 32  median(x) #> [1] 26 x[x > 4] #> Class 'mic' #> [1] 16    8     8     64    >=128 32    32    16  df <- data.frame(x, hospital = \"A\") subset(df, x > 4) # or with dplyr: df %>% filter(x > 4) #>        x hospital #> 1     16        A #> 5     64        A #> 6  >=128        A #> 8     32        A #> 9     32        A #> 10    16        A"},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"mic_data <- as.mic(c(\">=32\", \"1.0\", \"1\", \"1.00\", 8, \"<=0.128\", \"8\", \"16\", \"16\")) mic_data #> Class 'mic' #> [1] >=32    1       1       1       8       <=0.128 8       16      16      is.mic(mic_data) #> [1] TRUE  # this can also coerce combined MIC/SIR values: as.mic(\"<=0.002; S\") #> Class 'mic' #> [1] <=0.002  # mathematical processing treats MICs as numeric values fivenum(mic_data) #> [1]  0.128  1.000  8.000 16.000 32.000 quantile(mic_data) #>     0%    25%    50%    75%   100%  #>  0.128  1.000  8.000 16.000 32.000  all(mic_data < 512) #> [1] TRUE  # rescale MICs using rescale_mic() rescale_mic(mic_data, mic_range = c(4, 16)) #> Class 'mic' #> [1] >=16 <=4  <=4  <=4  8    <=4  8    >=16 >=16  # interpret MIC values as.sir(   x = as.mic(2),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R as.sir(   x = as.mic(c(0.01, 2, 4, 8)),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] S R R R  # plot MIC values, see ?plot plot(mic_data)  plot(mic_data, mo = \"E. coli\", ab = \"cipro\")   if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\") }  if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\", language = \"nl\") # Dutch }"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Use function get valid microorganism code (mo) based arbitrary user input. Determination done using intelligent rules complete taxonomic tree kingdoms Animalia, Archaea, Bacteria, Chromista, Protozoa, microbial species kingdom Fungi (see Source). input can almost anything: full name (like \"Staphylococcus aureus\"), abbreviated name (\"S. aureus\"), abbreviation known field (\"MRSA\"), just genus. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"as.mo(x, Becker = FALSE, Lancefield = FALSE,   minimum_matching_score = NULL,   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE),   reference_df = get_mo_source(),   ignore_pattern = getOption(\"AMR_ignore_pattern\", NULL),   cleaning_regex = getOption(\"AMR_cleaning_regex\", mo_cleaning_regex()),   only_fungi = getOption(\"AMR_only_fungi\", FALSE),   language = get_AMR_locale(), info = interactive(), ...)  is.mo(x)  mo_uncertainties()  mo_renamed()  mo_failures()  mo_reset_session()  mo_cleaning_regex()"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"x character vector data.frame one two columns. Becker logical indicate whether staphylococci categorised coagulase-negative staphylococci (\"CoNS\") coagulase-positive staphylococci (\"CoPS\") instead species, according Karsten Becker et al. (see Source). Please see Details full list staphylococcal species converted. excludes Staphylococcus aureus default, use Becker = \"\" also categorise S. aureus \"CoPS\". Lancefield logical indicate whether beta-haemolytic Streptococcus categorised Lancefield groups instead species, according Rebecca C. Lancefield (see Source). streptococci categorised first group, e.g. Streptococcus dysgalactiae group C, although officially also categorised groups G L. . Please see Details full list streptococcal species converted. excludes enterococci default (group D), use Lancefield = \"\" also categorise enterococci group D. minimum_matching_score numeric value set lower limit MO matching score. left blank, determined automatically based character length x, taxonomic kingdom human pathogenicity. keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). reference_df data.frame used extra reference translating x valid mo. See set_mo_source() get_mo_source() automate usage codes (e.g. used analysis organisation). ignore_pattern Perl-compatible regular expression (case-insensitive) matches x must return NA. can convenient exclude known non-relevant input can also set package option AMR_ignore_pattern, e.g. options(AMR_ignore_pattern = \"(reported|contaminated flora)\"). cleaning_regex Perl-compatible regular expression (case-insensitive) clean input x. Every matched part x removed. default, outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". default can set package option AMR_cleaning_regex. only_fungi logical indicate fungi must found, making sure e.g. misspellings always return records kingdom Fungi. can set globally microorganism functions package option AMR_only_fungi, .e. options(AMR_only_fungi = TRUE). language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). info logical indicate info must printed, e.g. progress bar 25 items coerced, list old taxonomic names. default TRUE interactive mode. ... arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"character vector additional class mo","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"microorganism (MO) code package (class: mo) human-readable typically looks like examples:   Values coerced considered 'unknown' return MO code UNKNOWN warning. Use mo_* functions get properties based returned code, see Examples. .mo() function uses novel scientifically validated (doi:10.18637/jss.v104.i03 ) matching score algorithm (see Matching Score Microorganisms ) match input available microbial taxonomy package. implicates e.g. \"E. coli\" (microorganism highly prevalent humans) return microbial ID Escherichia coli Entamoeba coli (microorganism less prevalent humans), although latter alphabetically come first.","code":"Code               Full name   ---------------    --------------------------------------   B_KLBSL            Klebsiella   B_KLBSL_PNMN       Klebsiella pneumoniae   B_KLBSL_PNMN_RHNS  Klebsiella pneumoniae rhinoscleromatis   |   |    |    |   |   |    |    |   |   |    |    \\---> subspecies, a 3-5 letter acronym   |   |    \\----> species, a 3-6 letter acronym   |   \\----> genus, a 4-8 letter acronym   \\----> kingdom: A (Archaea), AN (Animalia), B (Bacteria),                   C (Chromista), F (Fungi), PL (Plantae),                   P (Protozoa)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coping-with-uncertain-results","dir":"Reference","previous_headings":"","what":"Coping with Uncertain Results","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Results non-exact taxonomic input based matching score. lowest allowed score can set minimum_matching_score argument. default determined based character length input, taxonomic kingdom, human pathogenicity taxonomic outcome. values matched uncertainty, message shown suggest user inspect results mo_uncertainties(), returns data.frame specifications. increase quality matching, cleaning_regex argument used clean input. must regular expression matches parts input removed input matched available microbial taxonomy. matched Perl-compatible case-insensitive. default value cleaning_regex outcome helper function mo_cleaning_regex(). three helper functions can run using .mo() function: Use mo_uncertainties() get data.frame prints pretty format taxonomic names guessed. output contains matching score matches (see Matching Score Microorganisms ). Use mo_failures() get character vector values coerced valid value. Use mo_renamed() get data.frame values coerced based old, previously accepted taxonomic names.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"for-mycologists","dir":"Reference","previous_headings":"","what":"For Mycologists","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"matching score algorithm gives precedence bacteria fungi. analysing fungi, sure use only_fungi = TRUE, better yet, add code run every session:   make sure bacteria 'non-fungi' returned .mo(), mo_* functions.","code":"options(AMR_only_fungi = TRUE)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coagulase-negative-and-coagulase-positive-staphylococci","dir":"Reference","previous_headings":"","what":"Coagulase-negative and Coagulase-positive Staphylococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Becker = TRUE, following staphylococci converted corresponding coagulase group: Coagulase-negative: S. americanisciuri, S. argensis, S. arlettae, S. auricularis, S. borealis, S. brunensis, S. caeli, S. caledonicus, S. canis, S. capitis, S. capitis capitis, S. capitis urealyticus, S. capitis ureolyticus, S. caprae, S. carnosus, S. carnosus carnosus, S. carnosus utilis, S. casei, S. caseolyticus, S. chromogenes, S. cohnii, S. cohnii cohnii, S. cohnii urealyticum, S. cohnii urealyticus, S. condimenti, S. croceilyticus, S. debuckii, S. devriesei, S. durrellii, S. edaphicus, S. epidermidis, S. equorum, S. equorum equorum, S. equorum linens, S. felis, S. fleurettii, S. gallinarum, S. haemolyticus, S. hominis, S. hominis hominis, S. hominis novobiosepticus, S. jettensis, S. kloosii, S. lentus, S. lloydii, S. lugdunensis, S. marylandisciuri, S. massiliensis, S. microti, S. muscae, S. nepalensis, S. pasteuri, S. petrasii, S. petrasii croceilyticus, S. petrasii jettensis, S. petrasii petrasii, S. petrasii pragensis, S. pettenkoferi, S. piscifermentans, S. pragensis, S. pseudoxylosus, S. pulvereri, S. ratti, S. rostri, S. saccharolyticus, S. saprophyticus, S. saprophyticus bovis, S. saprophyticus saprophyticus, S. schleiferi, S. schleiferi schleiferi, S. sciuri, S. sciuri carnaticus, S. sciuri lentus, S. sciuri rodentium, S. sciuri sciuri, S. shinii, S. simulans, S. stepanovicii, S. succinus, S. succinus casei, S. succinus succinus, S. taiwanensis, S. urealyticus, S. ureilyticus, S. veratri, S. vitulinus, S. vitulus, S. warneri, S. xylosus Coagulase-positive: S. agnetis, S. argenteus, S. coagulans, S. cornubiensis, S. delphini, S. hyicus, S. hyicus chromogenes, S. hyicus hyicus, S. intermedius, S. lutrae, S. pseudintermedius, S. roterodami, S. schleiferi coagulans, S. schweitzeri, S. simiae, S. singaporensis based : Becker K et al. (2014). Coagulase-Negative Staphylococci. Clin Microbiol Rev. 27(4): 870-926; doi:10.1128/CMR.00109-13 Becker K et al. (2019). Implications identifying recently defined members S. aureus complex, S. argenteus S. schweitzeri: position paper members ESCMID Study Group staphylococci Staphylococcal Diseases (ESGS). Clin Microbiol Infect; doi:10.1016/j.cmi.2019.02.028 Becker K et al. (2020). Emergence coagulase-negative staphylococci. Expert Rev Anti Infect Ther. 18(4):349-366; doi:10.1080/14787210.2020.1730813 newly named staphylococcal species, S. brunensis (2024) S. shinii (2023), looked scientific reference make sure species considered correct coagulase group.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"lancefield-groups-in-streptococci","dir":"Reference","previous_headings":"","what":"Lancefield Groups in Streptococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Lancefield = TRUE, following streptococci converted corresponding Lancefield group: Streptococcus Group : S. pyogenes Streptococcus Group B: S. agalactiae Streptococcus Group C: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis, S. equi, S. equi equi, S. equi ruminatorum, S. equi zooepidemicus Streptococcus Group F: S. anginosus, S. anginosus anginosus, S. anginosus whileyi, S. constellatus, S. constellatus constellatus, S. constellatus pharyngis, S. constellatus viborgensis, S. intermedius Streptococcus Group G: S. canis, S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis Streptococcus Group H: S. sanguinis Streptococcus Group K: S. salivarius, S. salivarius salivarius, S. salivarius thermophilus Streptococcus Group L: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis based : Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"# \\donttest{ # These examples all return \"B_STPHY_AURS\", the ID of S. aureus: as.mo(c(   \"sau\", # WHONET code   \"stau\",   \"STAU\",   \"staaur\",   \"S. aureus\",   \"S aureus\",   \"Sthafilokkockus aureus\", # handles incorrect spelling   \"Staphylococcus aureus (MRSA)\",   \"MRSA\", # Methicillin Resistant S. aureus   \"VISA\", # Vancomycin Intermediate S. aureus   \"VRSA\", # Vancomycin Resistant S. aureus   115329001 # SNOMED CT code )) #> Class 'mo' #>  [1] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #>  [6] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #> [11] B_STPHY_AURS B_STPHY_AURS  # Dyslexia is no problem - these all work: as.mo(c(   \"Ureaplasma urealyticum\",   \"Ureaplasma urealyticus\",   \"Ureaplasmium urealytica\",   \"Ureaplazma urealitycium\" )) #> Class 'mo' #> [1] B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY  # input will get cleaned up with the input given in the `cleaning_regex` argument, # which defaults to `mo_cleaning_regex()`: cat(mo_cleaning_regex(), \"\\n\") #> ([^A-Za-z- \\(\\)\\[\\]{}]+|([({]|\\[).+([})]|\\])|(^| )( ?[a-z-]+[-](resistant|susceptible) ?|e?spp([^a-z]+|$)|e?ssp([^a-z]+|$)|serogr.?up[a-z]*|e?ss([^a-z]+|$)|e?sp([^a-z]+|$)|var([^a-z]+|$)|serovar[a-z]*|sube?species|biovar[a-z]*|e?species|Ig[ADEGM]|e?subsp|biotype|titer|dummy))   as.mo(\"Streptococcus group A\") #> Class 'mo' #> [1] B_STRPT_GRPA  as.mo(\"S. epidermidis\") # will remain species: B_STPHY_EPDR #> Class 'mo' #> [1] B_STPHY_EPDR as.mo(\"S. epidermidis\", Becker = TRUE) # will not remain species: B_STPHY_CONS #> Class 'mo' #> [1] B_STPHY_CONS  as.mo(\"S. pyogenes\") # will remain species: B_STRPT_PYGN #> Class 'mo' #> [1] B_STRPT_PYGN as.mo(\"S. pyogenes\", Lancefield = TRUE) # will not remain species: B_STRPT_GRPA #> Class 'mo' #> [1] B_STRPT_GRPA  # All mo_* functions use as.mo() internally too (see ?mo_property): mo_genus(\"E. coli\") #> [1] \"Escherichia\" mo_gramstain(\"ESCO\") #> [1] \"Gram-negative\" mo_is_intrinsic_resistant(\"ESCCOL\", ab = \"vanco\") #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant #>   Phenotypes' v1.2 (2023). This note will be shown once per session. #> [1] TRUE # }"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":null,"dir":"Reference","previous_headings":"","what":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Clean existing SIR values, interpret minimum inhibitory concentration (MIC) values disk diffusion diameters according EUCAST CLSI. .sir() transforms input new class sir, ordered factor containing levels S, SDD, , R, NI. Breakpoints currently implemented EUCAST 2011-2025 CLSI 2011-2025, see Details. breakpoints used interpretation available clinical_breakpoints data set.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"as.sir(x, ...)  NA_sir_  is.sir(x)  is_sir_eligible(x, threshold = 0.05)  # Default S3 method as.sir(x, S = \"^(S|U)+$\", I = \"^(I)+$\", R = \"^(R)+$\",   NI = \"^(N|NI|V)+$\", SDD = \"^(SDD|D|H)+$\", info = interactive(), ...)  # S3 method for class 'mic' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   verbose = FALSE, info = interactive(), conserve_capped_values = NULL,   ...)  # S3 method for class 'disk' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   verbose = FALSE, info = interactive(), ...)  # S3 method for class 'data.frame' as.sir(x, ..., col_mo = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   verbose = FALSE, info = interactive(), parallel = FALSE,   max_cores = -1, conserve_capped_values = NULL)  sir_interpretation_history(clean = FALSE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpretations minimum inhibitory concentration (MIC) values disk diffusion diameters: CLSI M39: Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. CLSI M100: Performance Standard Antimicrobial Susceptibility Testing, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m100/. CLSI VET01: Performance Standards Antimicrobial Disk Dilution Susceptibility Tests Bacteria Isolated Animals, 2019-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/veterinary-medicine/documents/vet01/. EUCAST Breakpoint tables interpretation MICs zone diameters, 2011-2025, European Committee Antimicrobial Susceptibility Testing (EUCAST). https://www.eucast.org/clinical_breakpoints. WHONET source machine-reading clinical breakpoints (read ), 1989-2025, Collaborating Centre Surveillance Antimicrobial Resistance. https://whonet.org/.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"x Vector values (class mic: MIC values mg/L, class disk: disk diffusion radius millimetres). ... using data.frame: names columns apply .sir() (supports tidy selection column1:column4). Otherwise: arguments passed methods. threshold Maximum fraction invalid antimicrobial interpretations x, see Examples. S, , R, NI, SDD case-independent regular expression translate input result. regular expression run non-letters whitespaces removed input. info logical print information process, defaults TRUE interactive sessions. mo vector (column name) characters can coerced valid microorganism codes .mo(), can left empty determine automatically. ab vector (column name) characters can coerced valid antimicrobial drug code .ab(). guideline guideline name (column name) use SIR interpretation. Defaults EUCAST 2025 (latest implemented EUCAST guideline clinical_breakpoints data set), can set package option AMR_guideline. Currently supports EUCAST (2011-2025) CLSI (2011-2025), see Details. Using column name allows straightforward interpretation historical data, must analysed context , example, different years. uti (Urinary Tract Infection) vector (column name) logicals (TRUE FALSE) specify whether UTI specific interpretation guideline chosen. using .sir() data.frame, can also column containing logicals left blank, data set searched column 'specimen', rows within column containing 'urin' ('urine', 'urina') regarded isolates UTI. See Examples. capped_mic_handling character string controls MIC values cap (.e., starting <, <=, >, >=) interpreted. Supports following options: \"none\" <= >= treated -. < > treated -. \"conservative\" <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < always returns \"S\", > always returns \"R\". \"standard\" (default) <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < > treated -. \"inverse\" <= >= treated -. < always returns \"S\", > always returns \"R\". default \"standard\" setting ensures cautious handling uncertain values preserving interpretability. option can also set package option AMR_capped_mic_handling. add_intrinsic_resistance (useful using EUCAST guideline) logical indicate whether intrinsic antibiotic resistance must also considered applicable bug-drug combinations, meaning e.g. ampicillin always return \"R\" Klebsiella species. Determination based intrinsic_resistant data set, based 'EUCAST Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021). reference_data data.frame used interpretation, defaults clinical_breakpoints data set. Changing argument allows using interpretation guidelines. argument must contain data set equal structure clinical_breakpoints data set (column names column types). Please note guideline argument ignored reference_data manually set. substitute_missing_r_breakpoint logical indicate missing clinical breakpoints R (resistant) must substituted R - default FALSE. (especially CLSI) breakpoints breakpoint S, meaning outcome can \"S\" NA. Setting TRUE convert NAs \"R\" R breakpoint missing. Can also set package option AMR_substitute_missing_r_breakpoint. include_screening logical indicate clinical breakpoints screening allowed - default FALSE. Can also set package option AMR_include_screening. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". host vector (column name) characters indicate host. useful veterinary breakpoints, requires breakpoint_type = \"animal\". values can text resembling animal species, even 20 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). verbose logical indicate notes printed interpretation MIC values disk diffusion values. conserve_capped_values Deprecated, use capped_mic_handling instead. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). parallel logical indicate parallel computing must used, defaults FALSE. max_cores Maximum number cores use parallel = TRUE. Use negative value subtract number available number cores, e.g. value -2 8-core machine means 6 cores used. Defaults -1. available number cores detected using parallelly::availableCores() package installed, base R's parallel::detectCores() otherwise. clean logical indicate whether previously stored results forgotten returning 'logbook' results.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Ordered factor new class sir","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Note: clinical breakpoints package validated , imported , WHONET. public use AMR package endorsed CLSI EUCAST. See clinical_breakpoints information. NA_sir_ missing value new sir class, analogous e.g. base R's NA_character_.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"how-it-works","dir":"Reference","previous_headings":"","what":"How it Works","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":".sir() function can work four ways: cleaning raw / untransformed data. data cleaned contain valid values, namely: S susceptible, intermediate 'susceptible, increased exposure', R resistant, NI non-interpretable, SDD susceptible dose-dependent. can set using regular expression. Furthermore, .sir() try best clean intelligence. example, mixed values SIR interpretations MIC values \"<0.25; S\" coerced \"S\". Combined interpretations multiple test methods (seen laboratory records) \"S; S\" coerced \"S\", value like \"S; \" return NA warning input invalid. interpreting minimum inhibitory concentration (MIC) values according EUCAST CLSI. must clean MIC values first using .mic(), also gives columns new data class mic. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   Operators like \"<=\" stripped interpretation. using capped_mic_handling = \"conservative\", MIC value e.g. \">2\" always return \"R\", even breakpoint according chosen guideline \">=4\". prevent capped values raw laboratory data treated conservatively. default behaviour (capped_mic_handling = \"standard\") considers \">2\" lower \">=4\" might case return \"S\" \"\". Note: using CLSI guideline, MIC values must log2-based doubling dilutions. Values format, automatically rounded nearest log2 level CLSI instructs, warning thrown. interpreting disk diffusion diameters according EUCAST CLSI. must clean disk zones first using .disk(), also gives columns new data class disk. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   interpreting complete data set, automatic determination MIC values, disk diffusion diameters, microorganism names codes, antimicrobial test results. done simply running .sir(your_data). points 2, 3 4: Use sir_interpretation_history() retrieve data.frame results previous .sir() calls. also contains notes interpretation, exact input output values.","code":"your_data %>% mutate_if(is.mic, as.sir) your_data %>% mutate(across(where(is.mic), as.sir)) your_data %>% mutate_if(is.mic, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.mic, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.mic, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE) your_data %>% mutate_if(is.disk, as.sir) your_data %>% mutate(across(where(is.disk), as.sir)) your_data %>% mutate_if(is.disk, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.disk, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.disk, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"supported-guidelines","dir":"Reference","previous_headings":"","what":"Supported Guidelines","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpreting MIC values well disk diffusion diameters, currently implemented guidelines : clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. guideline argument must set e.g., \"EUCAST 2025\" \"CLSI 2025\". simply using \"EUCAST\" (default) \"CLSI\" input, latest included version guideline automatically selected. Importantly, using column name data instead, allows straightforward interpretation historical data must analysed context , example, different years. can set data set using reference_data argument. guideline argument ignored. also possible set default guideline package option AMR_guideline (e.g. .Rprofile file), :","code":"options(AMR_guideline = \"CLSI\")   options(AMR_guideline = \"CLSI 2018\")   options(AMR_guideline = \"EUCAST 2020\")   # or to reset:   options(AMR_guideline = NULL)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"working-with-veterinary-breakpoints","dir":"Reference","previous_headings":"","what":"Working with Veterinary Breakpoints","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using veterinary breakpoints (.e., setting breakpoint_type = \"animal\"), column animal species must available set manually using host argument. column must contain names like \"dogs\", \"cats\", \"cattle\", \"swine\", \"horses\", \"poultry\", \"aquatic\". animal names like \"goats\", \"rabbits\", \"monkeys\" also recognised may available guidelines. Matching case-insensitive accepts Latin-based synonyms (e.g., \"bovine\" cattle \"canine\" dogs). Regarding choice veterinary guidelines, might best options set analysis:","code":"options(AMR_guideline = \"CLSI\")   options(AMR_breakpoint_type = \"animal\")"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"after-interpretation","dir":"Reference","previous_headings":"","what":"After Interpretation","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using .sir(), can use eucast_rules() defined EUCAST (1) apply inferred susceptibility resistance based results antimicrobials (2) apply intrinsic resistance based taxonomic properties microorganism. determine isolates multi-drug resistant, sure run mdro() (applies MDR/PDR/XDR guideline 2012 default) data set contains S//R values. Read interpreting multidrug-resistant organisms .","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"function .sir() detects input contains class sir. input data.frame list, iterates columns/items returns logical vector. base R function .double() can used retrieve quantitative values sir object: \"S\" = 1, \"\"/\"SDD\" = 2, \"R\" = 3. values rendered NA . Note: use .integer(), since (R works internally) return factor level indices, aforementioned quantitative values. function is_sir_eligible() returns TRUE column contains 5% invalid antimicrobial interpretations (S //R /NI /SDD), FALSE otherwise. threshold 5% can set threshold argument. input data.frame, iterates columns returns logical vector.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … summary(example_isolates) # see all SIR results at a glance #>       date              patient               age           gender          #>  Min.   :2002-01-02   Length:2000        Min.   : 0.00   Length:2000        #>  1st Qu.:2005-07-31   Class :character   1st Qu.:63.00   Class :character   #>  Median :2009-07-31   Mode  :character   Median :74.00   Mode  :character   #>  Mean   :2009-11-20                      Mean   :70.69                      #>  3rd Qu.:2014-05-30                      3rd Qu.:82.00                      #>  Max.   :2017-12-28                      Max.   :97.00                      #>      ward                mo                  PEN                 #>  Length:2000        Class :mo             Class:sir              #>  Class :character   <NA>  :0              %S   :25.6% (n=417)    #>  Mode  :character   Unique:90             %SDD : 0.0% (n=0)      #>                     #1    :B_ESCHR_COLI   %I   : 0.7% (n=11)     #>                     #2    :B_STPHY_CONS   %R   :73.7% (n=1201)   #>                     #3    :B_STPHY_AURS   %NI  : 0.0% (n=0)      #>     OXA                   FLC                   AMX                #>  Class:sir             Class:sir             Class:sir             #>  %S   :68.8% (n=251)   %S   :70.5% (n=665)   %S   :40.2% (n=543)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)     %I   : 0.2% (n=3)     #>  %R   :31.2% (n=114)   %R   :29.5% (n=278)   %R   :59.6% (n=804)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     AMC                    AMP                   TZP                #>  Class:sir              Class:sir             Class:sir             #>  %S   :71.4% (n=1342)   %S   :40.2% (n=543)   %S   :86.1% (n=862)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 4.8% (n=91)     %I   : 0.2% (n=3)     %I   : 1.3% (n=13)    #>  %R   :23.7% (n=446)    %R   :59.6% (n=804)   %R   :12.6% (n=126)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     CZO                   FEP                   CXM                 #>  Class:sir             Class:sir             Class:sir              #>  %S   :54.9% (n=245)   %S   :85.6% (n=620)   %S   :72.5% (n=1297)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      #>  %I   : 0.4% (n=2)     %I   : 0.1% (n=1)     %I   : 1.2% (n=22)     #>  %R   :44.6% (n=199)   %R   :14.2% (n=103)   %R   :26.3% (n=470)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      #>     FOX                   CTX                   CAZ                 #>  Class:sir             Class:sir             Class:sir              #>  %S   :71.6% (n=586)   %S   :84.4% (n=796)   %S   :33.5% (n=607)    #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      #>  %I   : 1.0% (n=8)     %I   : 0.1% (n=1)     %I   : 0.0% (n=0)      #>  %R   :27.4% (n=224)   %R   :15.5% (n=146)   %R   :66.5% (n=1204)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      #>     CRO                   GEN                    TOB                #>  Class:sir             Class:sir              Class:sir             #>  %S   :84.4% (n=796)   %S   :74.0% (n=1372)   %S   :65.1% (n=879)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.1% (n=1)     %I   : 1.5% (n=27)     %I   : 0.5% (n=7)     #>  %R   :15.5% (n=146)   %R   :24.6% (n=456)    %R   :34.4% (n=465)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     AMK                   KAN                    TMP                #>  Class:sir             Class:sir              Class:sir             #>  %S   :36.3% (n=251)   %S   : 0.0% (n=0)      %S   :61.2% (n=918)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)      %I   : 0.7% (n=10)    #>  %R   :63.7% (n=441)   %R   :100.0% (n=471)   %R   :38.1% (n=571)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     SXT                    NIT                   FOS                #>  Class:sir              Class:sir             Class:sir             #>  %S   :79.1% (n=1392)   %S   :76.0% (n=565)   %S   :57.8% (n=203)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.3% (n=6)      %I   : 6.9% (n=51)    %I   : 0.0% (n=0)     #>  %R   :20.5% (n=361)    %R   :17.1% (n=127)   %R   :42.2% (n=148)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     LNZ                   CIP                    MFX                #>  Class:sir             Class:sir              Class:sir             #>  %S   :30.7% (n=314)   %S   :78.9% (n=1112)   %S   :64.5% (n=136)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 4.9% (n=69)     %I   : 1.9% (n=4)     #>  %R   :69.3% (n=709)   %R   :16.2% (n=228)    %R   :33.6% (n=71)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     VAN                    TEC                   TCY                #>  Class:sir              Class:sir             Class:sir             #>  %S   :61.7% (n=1149)   %S   :24.3% (n=237)   %S   :68.3% (n=820)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)      %I   : 0.0% (n=0)     %I   : 1.9% (n=23)    #>  %R   :38.3% (n=712)    %R   :75.7% (n=739)   %R   :29.8% (n=357)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     #>     TGC                   DOX                   ERY                 #>  Class:sir             Class:sir             Class:sir              #>  %S   :87.3% (n=697)   %S   :71.7% (n=814)   %S   :42.3% (n=801)    #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      #>  %I   : 0.0% (n=0)     %I   : 0.6% (n=7)     %I   : 0.5% (n=9)      #>  %R   :12.7% (n=101)   %R   :27.7% (n=315)   %R   :57.2% (n=1084)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      #>     CLI                   AZM                    IPM                #>  Class:sir             Class:sir              Class:sir             #>  %S   :38.6% (n=586)   %S   :42.3% (n=801)    %S   :92.7% (n=824)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     #>  %I   : 0.3% (n=4)     %I   : 0.5% (n=9)      %I   : 1.1% (n=10)    #>  %R   :61.2% (n=930)   %R   :57.2% (n=1084)   %R   : 6.2% (n=55)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     #>     MEM                   MTR                  CHL                #>  Class:sir             Class:sir            Class:sir             #>  %S   :94.1% (n=780)   %S   :85.3% (n=29)   %S   :78.6% (n=121)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)    %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)    %I   : 0.0% (n=0)     #>  %R   : 5.9% (n=49)    %R   :14.7% (n=5)    %R   :21.4% (n=33)    #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)    %NI  : 0.0% (n=0)     #>     COL                    MUP                   RIF                #>  Class:sir              Class:sir             Class:sir             #>  %S   :18.8% (n=309)    %S   :93.0% (n=251)   %S   :30.2% (n=303)   #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)      %I   : 1.1% (n=3)     %I   : 0.2% (n=2)     #>  %R   :81.2% (n=1331)   %R   : 5.9% (n=16)    %R   :69.6% (n=698)   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      # For INTERPRETING disk diffusion and MIC values -----------------------  # example data sets, with combined MIC values and disk zones df_wide <- data.frame(   microorganism = \"Escherichia coli\",   amoxicillin = as.mic(8),   cipro = as.mic(0.256),   tobra = as.disk(16),   genta = as.disk(18),   ERY = \"R\" ) df_long <- data.frame(   bacteria = rep(\"Escherichia coli\", 4),   antibiotic = c(\"amoxicillin\", \"cipro\", \"tobra\", \"genta\"),   mics = as.mic(c(0.01, 1, 4, 8)),   disks = as.disk(c(6, 10, 14, 18)),   guideline = c(\"EUCAST 2021\", \"EUCAST 2022\", \"EUCAST 2023\", \"EUCAST 2024\") )  # most basic application: as.sir(df_wide) #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R  # return a 'logbook' about the results: sir_interpretation_history() #> # A tibble: 14 × 18 #>    datetime            index method ab_given    mo_given  host_given input_given #>    <dttm>              <int> <chr>  <chr>       <chr>     <chr>      <chr>       #>  1 2025-04-26 14:39:45     1 DISK   ampicillin  Strep pn… human      18          #>  2 2025-04-26 14:39:45     1 DISK   AMP         Escheric… human      20          #>  3 NA                     NA NA     NA          NA        NA         NA          #>  4 2025-04-26 14:39:46     1 DISK   GEN         Escheric… human      18          #>  5 2025-04-26 14:39:46     1 DISK   TOB         Escheric… human      16          #>  6 2025-04-26 14:39:47     1 MIC    AMX         B_STRPT_… human      2           #>  7 2025-04-26 14:39:47     1 MIC    AMX         B_STRPT_… human      0.01        #>  8 2025-04-26 14:39:47     2 MIC    AMX         B_STRPT_… human      2           #>  9 2025-04-26 14:39:47     3 MIC    AMX         B_STRPT_… human      4           #> 10 2025-04-26 14:39:47     4 MIC    AMX         B_STRPT_… human      8           #> 11 2025-04-26 14:39:53     1 MIC    amoxicillin Escheric… human      8           #> 12 2025-04-26 14:39:53     1 MIC    cipro       Escheric… human      0.256       #> 13 2025-04-26 14:39:53     1 DISK   tobra       Escheric… human      16          #> 14 2025-04-26 14:39:54     1 DISK   genta       Escheric… human      18          #> # ℹ 11 more variables: ab <ab>, mo <mo>, host <chr>, input <chr>, #> #   outcome <sir>, notes <chr>, guideline <chr>, ref_table <chr>, uti <lgl>, #> #   breakpoint_S_R <chr>, site <chr>  # \\donttest{ # using parallel computing, which is available in base R: as.sir(df_wide, parallel = TRUE, info = TRUE) #> ℹ Returning previously coerced values for various antimicrobials. Run #>   ab_reset_session() to reset this. This note will be shown once per #>   session. #>  #> Running SIR interpretation in parallel mode on five columns, using 3 out of #> 4 cores... #>  Done. #>  #> ℹ Run sir_interpretation_history() to retrieve a logbook with all the #>   details of the breakpoint interpretations. #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R   ## Using dplyr ------------------------------------------------- if (require(\"dplyr\")) {   # approaches that all work without additional arguments:   df_wide %>% mutate_if(is.mic, as.sir)   df_wide %>% mutate_if(function(x) is.mic(x) | is.disk(x), as.sir)   df_wide %>% mutate(across(where(is.mic), as.sir))   df_wide %>% mutate_at(vars(amoxicillin:tobra), as.sir)   df_wide %>% mutate(across(amoxicillin:tobra, as.sir))    # approaches that all work with additional arguments:   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       guideline = \"guideline\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     # given certain columns, e.g. from 'cipro' to 'genta'     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           guideline = \"CLSI\"         )       }     ))    # for veterinary breakpoints, add 'host':   df_long$animal_species <- c(\"cats\", \"dogs\", \"horses\", \"cattle\")   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))    # to include information about urinary tract infections (UTI)   data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     from_the_bladder = c(TRUE, FALSE)   ) %>%     as.sir(uti = \"from_the_bladder\")    data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     specimen = c(\"urine\", \"blood\")   ) %>%     as.sir() # automatically determines urine isolates    df_wide %>%     mutate_at(vars(cipro:genta), as.sir, mo = \"E. coli\", uti = TRUE) } #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `mics = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Interpreting MIC values: 'antibiotic' (ASP, acetylspiramycin), CLSI 2025... #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           8  <NA>     S     S   R   ## Using base R ------------------------------------------------  as.sir(df_wide) #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R  # return a 'logbook' about the results: sir_interpretation_history() #> # A tibble: 114 × 18 #>    datetime            index method ab_given   mo_given   host_given input_given #>    <dttm>              <int> <chr>  <chr>      <chr>      <chr>      <chr>       #>  1 2025-04-26 14:39:45     1 DISK   ampicillin Strep pneu human      18          #>  2 2025-04-26 14:39:45     1 DISK   AMP        Escherich… human      20          #>  3 NA                     NA NA     NA         NA         NA         NA          #>  4 2025-04-26 14:39:46     1 DISK   GEN        Escherich… human      18          #>  5 2025-04-26 14:39:46     1 DISK   TOB        Escherich… human      16          #>  6 2025-04-26 14:39:47     1 MIC    AMX        B_STRPT_P… human      2           #>  7 2025-04-26 14:39:47     1 MIC    AMX        B_STRPT_P… human      0.01        #>  8 2025-04-26 14:39:47     2 MIC    AMX        B_STRPT_P… human      2           #>  9 2025-04-26 14:39:47     3 MIC    AMX        B_STRPT_P… human      4           #> 10 2025-04-26 14:39:47     4 MIC    AMX        B_STRPT_P… human      8           #> # ℹ 104 more rows #> # ℹ 11 more variables: ab <ab>, mo <mo>, host <chr>, input <chr>, #> #   outcome <sir>, notes <chr>, guideline <chr>, ref_table <chr>, uti <lgl>, #> #   breakpoint_S_R <chr>, site <chr>  # using parallel computing, which is available in base R as.sir(df_wide, parallel = TRUE) #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R  # for single values as.sir(   x = as.mic(2),   mo = as.mo(\"S. pneumoniae\"),   ab = \"AMP\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R  as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R   # For CLEANING existing SIR values -------------------------------------  as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", \"A\", \"B\", \"C\")) #> Warning: in as.sir(): 3 results in index '20' truncated (38%) that were invalid #> antimicrobial interpretations: \"A\", \"B\", and \"C\" as.sir(\"<= 0.002; S\") # will return \"S\" sir_data <- as.sir(c(rep(\"S\", 474), rep(\"I\", 36), rep(\"R\", 370))) is.sir(sir_data) #> [1] TRUE plot(sir_data) # for percentages  barplot(sir_data) # for frequencies   # as common in R, you can use as.integer() to return factor indices: as.integer(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  3  4  5 NA # but for computational use, as.double() will return 1 for S, 2 for I/SDD, and 3 for R: as.double(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  2  3 NA NA  # the dplyr way if (require(\"dplyr\")) {   example_isolates %>%     mutate_at(vars(PEN:RIF), as.sir)   # same:   example_isolates %>%     as.sir(PEN:RIF)    # fastest way to transform all columns with already valid AMR results to class `sir`:   example_isolates %>%     mutate_if(is_sir_eligible, as.sir)    # since dplyr 1.0.0, this can also be:   # example_isolates %>%   #   mutate(across(where(is_sir_eligible), as.sir)) } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":null,"dir":"Reference","previous_headings":"","what":"Get ATC Properties from WHOCC Website — atc_online_property","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Gets data WHOCC website determine properties Anatomical Therapeutic Chemical (ATC) (e.g. antimicrobial), name, defined daily dose (DDD) standard unit.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"atc_online_property(atc_code, property, administration = \"O\",   url = \"https://atcddd.fhi.no/atc_ddd_index/?code=%s&showdescription=no\",   url_vet = \"https://atcddd.fhi.no/atcvet/atcvet_index/?code=%s&showdescription=no\")  atc_online_groups(atc_code, ...)  atc_online_ddd(atc_code, ...)  atc_online_ddd_units(atc_code, ...)"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"https://atcddd.fhi./atc_ddd_alterations__cumulative/ddd_alterations/abbrevations/","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"atc_code character (vector) ATC code(s) antimicrobials, coerced .ab() ab_atc() internally valid ATC code. property Property ATC code. Valid values \"ATC\", \"Name\", \"DDD\", \"U\" (\"unit\"), \"Adm.R\", \"Note\" groups. last option, hierarchical groups ATC code returned, see Examples. administration Type administration using property = \"Adm.R\", see Details. url URL website WHOCC. sign %s can used placeholder ATC codes. url_vet URL website WHOCC veterinary medicine. sign %s can used placeholder ATC_vet codes (start \"Q\"). ... Arguments pass atc_property.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Options argument administration: \"Implant\" = Implant \"Inhal\" = Inhalation \"Instill\" = Instillation \"N\" = nasal \"O\" = oral \"P\" = parenteral \"R\" = rectal \"SL\" = sublingual/buccal \"TD\" = transdermal \"V\" = vaginal Abbreviations return values using property = \"U\" (unit): \"g\" = gram \"mg\" = milligram \"mcg\" = microgram \"U\" = unit \"TU\" = thousand units \"MU\" = million units \"mmol\" = millimole \"ml\" = millilitre (e.g. eyedrops) N.B. function requires internet connection works following packages installed: curl, rvest, xml2.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"# \\donttest{ if (requireNamespace(\"curl\") && requireNamespace(\"rvest\") && requireNamespace(\"xml2\")) {   # oral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"O\")   atc_online_ddd(ab_atc(\"amox\"))    # parenteral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"P\")    atc_online_property(\"J01CA04\", property = \"groups\") # search hierarchical groups of amoxicillin } #> Loading required namespace: rvest #> [1] \"ANTIINFECTIVES FOR SYSTEMIC USE\"         #> [2] \"ANTIBACTERIALS FOR SYSTEMIC USE\"         #> [3] \"BETA-LACTAM ANTIBACTERIALS, PENICILLINS\" #> [4] \"Penicillins with extended spectrum\"      # }"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Use function e.g. clinical texts health care records. returns list antiviral drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_av = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_av type = \"drug\": column name antivirals data set translate antibiotic abbreviations , using av_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .av().","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"function also internally used .av(), although searches first drug name throw note drug names returned. Note: .av() function may use long regular expression match brand names antiviral drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"default, function search antiviral drug names. text elements searched official names, ATC codes brand names. uses .av() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(avx = av_from_text(clinical_text)) returned AV codes can transformed official names, groups, etc. av_* functions av_name() av_group(), using translate_av argument. using collapse, function return character:df %>% mutate(avx = av_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(\"28/03/2020 valaciclovir po tid\") #> [[1]] #> Class 'av' #> [1] VALA #>  av_from_text(\"28/03/2020 valaciclovir po tid\", type = \"admin\") #> [[1]] #> [1] \"oral\" #>"},{"path":"https://amr-for-r.org/reference/av_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antiviral Drug — av_property","title":"Get Properties of an Antiviral Drug — av_property","text":"Use functions return specific property antiviral drug antivirals data set. input values evaluated internally .av().","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"av_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  av_cid(x, ...)  av_synonyms(x, ...)  av_tradenames(x, ...)  av_group(x, language = get_AMR_locale(), ...)  av_atc(x, ...)  av_loinc(x, ...)  av_ddd(x, administration = \"oral\", ...)  av_ddd_units(x, administration = \"oral\", ...)  av_info(x, language = get_AMR_locale(), ...)  av_url(x, open = FALSE, ...)  av_property(x, property = \"name\", language = get_AMR_locale(), ...)"},{"path":"https://amr-for-r.org/reference/av_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antiviral Drug — av_property","text":"x (vector ) text can coerced valid antiviral drug code .av(). language Language returned text - default system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. ... arguments passed .av(). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antivirals data set: vector_or(colnames(antivirals), sort = FALSE).","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antiviral Drug — av_property","text":"integer case av_cid() named list case av_info() multiple av_atc()/av_synonyms()/av_tradenames() double case av_ddd() character cases","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antiviral Drug — av_property","text":"output translated possible. function av_url() return direct URL official website. warning returned required ATC code available.","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antiviral Drug — av_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antiviral Drug — av_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"# all properties: av_name(\"ACI\") #> [1] \"Aciclovir\" av_atc(\"ACI\") #> [1] \"J05AB01\" av_cid(\"ACI\") #> [1] 135398513 av_synonyms(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_tradenames(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_group(\"ACI\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_url(\"ACI\") #>                                                              Aciclovir  #> \"https://atcddd.fhi.no/atc_ddd_index/?code=J05AB01&showdescription=no\"   # lowercase transformation av_name(x = c(\"ACI\", \"VALA\")) #> [1] \"Aciclovir\"    \"Valaciclovir\" av_name(x = c(\"ACI\", \"VALA\"), tolower = TRUE) #> [1] \"aciclovir\"    \"valaciclovir\"  # defined daily doses (DDD) av_ddd(\"ACI\", \"oral\") #> [1] 4 av_ddd_units(\"ACI\", \"oral\") #> [1] \"g\" av_ddd(\"ACI\", \"iv\") #> [1] 4 av_ddd_units(\"ACI\", \"iv\") #> [1] \"g\"  av_info(\"ACI\") # all properties as a list #> $av #> [1] \"ACI\" #>  #> $cid #> [1] 135398513 #>  #> $name #> [1] \"Aciclovir\" #>  #> $group #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" #>  #> $atc #> [1] \"J05AB01\" #>  #> $tradenames #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            #>  #> $loinc #> [1] \"\" #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 4 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 4 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all av_* functions use as.av() internally, so you can go from 'any' to 'any': av_atc(\"ACI\") #> [1] \"J05AB01\" av_group(\"J05AB01\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_loinc(\"abacavir\") #> [1] \"29113-8\" \"30273-7\" \"30287-7\" \"30303-2\" \"78772-1\" \"78773-9\" \"79134-3\" #> [8] \"80118-3\" av_name(\"29113-8\") #> [1] \"Abacavir\" av_name(135398513) #> [1] \"Aciclovir\" av_name(\"J05AB01\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/availability.html","id":null,"dir":"Reference","previous_headings":"","what":"Check Availability of Columns — availability","title":"Check Availability of Columns — availability","text":"Easy check data availability columns data set. makes easy get idea antimicrobial combinations can used calculation e.g. susceptibility() resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check Availability of Columns — availability","text":"","code":"availability(tbl, width = NULL)"},{"path":"https://amr-for-r.org/reference/availability.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check Availability of Columns — availability","text":"tbl data.frame list. width Number characters present visual availability - default filling width console.","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check Availability of Columns — availability","text":"data.frame column names tbl row names","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check Availability of Columns — availability","text":"function returns data.frame columns \"resistant\" \"visual_resistance\". values columns calculated resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check Availability of Columns — availability","text":"","code":"availability(example_isolates) #>         count available     visual_availabilty resistant      visual_resistance #> date     2000    100.0% |####################|                                  #> patient  2000    100.0% |####################|                                  #> age      2000    100.0% |####################|                                  #> gender   2000    100.0% |####################|                                  #> ward     2000    100.0% |####################|                                  #> mo       2000    100.0% |####################|                                  #> PEN      1629     81.5% |################----|     73.7% |##############------| #> OXA       365     18.3% |###-----------------|     31.2% |######--------------| #> FLC       943     47.2% |#########-----------|     29.5% |#####---------------| #> AMX      1350     67.5% |#############-------|     59.6% |###########---------| #> AMC      1879     94.0% |##################--|     23.7% |####----------------| #> AMP      1350     67.5% |#############-------|     59.6% |###########---------| #> TZP      1001     50.0% |##########----------|     12.6% |##------------------| #> CZO       446     22.3% |####----------------|     44.6% |########------------| #> FEP       724     36.2% |#######-------------|     14.2% |##------------------| #> CXM      1789     89.5% |#################---|     26.3% |#####---------------| #> FOX       818     40.9% |########------------|     27.4% |#####---------------| #> CTX       943     47.2% |#########-----------|     15.5% |###-----------------| #> CAZ      1811     90.6% |##################--|     66.5% |#############-------| #> CRO       943     47.2% |#########-----------|     15.5% |###-----------------| #> GEN      1855     92.8% |##################--|     24.6% |####----------------| #> TOB      1351     67.6% |#############-------|     34.4% |######--------------| #> AMK       692     34.6% |######--------------|     63.7% |############--------| #> KAN       471     23.6% |####----------------|    100.0% |####################| #> TMP      1499     75.0% |###############-----|     38.1% |#######-------------| #> SXT      1759     88.0% |#################---|     20.5% |####----------------| #> NIT       743     37.2% |#######-------------|     17.1% |###-----------------| #> FOS       351     17.6% |###-----------------|     42.2% |########------------| #> LNZ      1023     51.2% |##########----------|     69.3% |#############-------| #> CIP      1409     70.5% |#############-------|     16.2% |###-----------------| #> MFX       211     10.6% |##------------------|     33.6% |######--------------| #> VAN      1861     93.1% |##################--|     38.3% |#######-------------| #> TEC       976     48.8% |#########-----------|     75.7% |###############-----| #> TCY      1200     60.0% |###########---------|     29.8% |#####---------------| #> TGC       798     39.9% |########------------|     12.7% |##------------------| #> DOX      1136     56.8% |###########---------|     27.7% |#####---------------| #> ERY      1894     94.7% |##################--|     57.2% |###########---------| #> CLI      1520     76.0% |###############-----|     61.2% |############--------| #> AZM      1894     94.7% |##################--|     57.2% |###########---------| #> IPM       889     44.5% |########------------|      6.2% |#-------------------| #> MEM       829     41.5% |########------------|      5.9% |#-------------------| #> MTR        34      1.7% |--------------------|     14.7% |##------------------| #> CHL       154      7.7% |#-------------------|     21.4% |####----------------| #> COL      1640     82.0% |################----|     81.2% |################----| #> MUP       270     13.5% |##------------------|      5.9% |#-------------------| #> RIF      1003     50.2% |##########----------|     69.6% |#############-------| # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     select_if(is.sir) %>%     availability() } #>     count available       visual_availabilty resistant        visual_resistance #> PEN   467    100.0% |######################|    100.0% |######################| #> OXA     0      0.0% |----------------------|                                    #> FLC     0      0.0% |----------------------|                                    #> AMX   392     83.9% |##################----|     50.0% |###########-----------| #> AMC   467    100.0% |######################|     13.1% |##--------------------| #> AMP   392     83.9% |##################----|     50.0% |###########-----------| #> TZP   416     89.1% |###################---|      5.5% |#---------------------| #> CZO    82     17.6% |###-------------------|      2.4% |----------------------| #> FEP   317     67.9% |##############--------|      2.8% |----------------------| #> CXM   465     99.6% |######################|      5.4% |#---------------------| #> FOX   377     80.7% |#################-----|      6.9% |#---------------------| #> CTX   459     98.3% |#####################-|      2.4% |----------------------| #> CAZ   460     98.5% |#####################-|      2.4% |----------------------| #> CRO   459     98.3% |#####################-|      2.4% |----------------------| #> GEN   460     98.5% |#####################-|      2.0% |----------------------| #> TOB   462     98.9% |#####################-|      2.6% |----------------------| #> AMK   171     36.6% |########--------------|      0.0% |----------------------| #> KAN     0      0.0% |----------------------|                                    #> TMP   396     84.8% |##################----|     39.1% |########--------------| #> SXT   465     99.6% |######################|     31.6% |######----------------| #> NIT   458     98.1% |#####################-|      2.8% |----------------------| #> FOS    61     13.1% |##--------------------|      0.0% |----------------------| #> LNZ   467    100.0% |######################|    100.0% |######################| #> CIP   456     97.6% |#####################-|     12.5% |##--------------------| #> MFX    57     12.2% |##--------------------|    100.0% |######################| #> VAN   467    100.0% |######################|    100.0% |######################| #> TEC   467    100.0% |######################|    100.0% |######################| #> TCY     3      0.6% |----------------------|     66.7% |##############--------| #> TGC    68     14.6% |###-------------------|      0.0% |----------------------| #> DOX     0      0.0% |----------------------|                                    #> ERY   467    100.0% |######################|    100.0% |######################| #> CLI   467    100.0% |######################|    100.0% |######################| #> AZM   467    100.0% |######################|    100.0% |######################| #> IPM   422     90.4% |###################---|      0.0% |----------------------| #> MEM   418     89.5% |###################---|      0.0% |----------------------| #> MTR     2      0.4% |----------------------|      0.0% |----------------------| #> CHL     0      0.0% |----------------------|                                    #> COL   240     51.4% |###########-----------|      0.0% |----------------------| #> MUP     0      0.0% |----------------------|                                    #> RIF   467    100.0% |######################|    100.0% |######################| # }"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Bug-Drug Combinations — bug_drug_combinations","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"Determine antimicrobial resistance (AMR) bug-drug combinations data set least 30 (default) isolates available per species. Use format() result prettify publishable/printable format, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"bug_drug_combinations(x, col_mo = NULL, FUN = mo_shortname,   include_n_rows = FALSE, ...)  # S3 method for class 'bug_drug_combinations' format(x, translate_ab = \"name (ab, atc)\",   language = get_AMR_locale(), minimum = 30, combine_SI = TRUE,   add_ab_group = TRUE, remove_intrinsic_resistant = FALSE,   decimal.mark = getOption(\"OutDec\"), big.mark = ifelse(decimal.mark ==   \",\", \".\", \",\"), ...)"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). FUN function call mo column transform microorganism codes - default mo_shortname(). include_n_rows logical indicate total number rows must included output. ... Arguments passed FUN. translate_ab character length 1 containing column names antimicrobials data set. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, summed, resistance based R - default TRUE. add_ab_group logical indicate group antimicrobials must included first column. remove_intrinsic_resistant logical indicate rows columns 100% resistance tested antimicrobials must removed table. decimal.mark character used indicate numeric     decimal point. big.mark character; empty used mark every     big.interval decimals (hence big)     decimal point.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function bug_drug_combinations() returns data.frame columns \"mo\", \"ab\", \"S\", \"SDD\", \"\", \"R\", \"total\".","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function format() calculates resistance per bug-drug combination returns table ready reporting/publishing. Use combine_SI = TRUE (default) test R vs. S+combine_SI = FALSE test R+vs. S. table can also directly used R Markdown / Quarto without need e.g. knitr::kable().","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ x <- bug_drug_combinations(example_isolates) head(x) #> # A tibble: 6 × 8 #>   mo                ab        S   SDD     I     R    NI total #>   <chr>             <chr> <int> <int> <int> <int> <int> <int> #> 1 (unknown species) AMC      15     0     0     0     0    15 #> 2 (unknown species) AMK       0     0     0     0     0     0 #> 3 (unknown species) AMP      15     0     0     1     0    16 #> 4 (unknown species) AMX      15     0     0     1     0    16 #> 5 (unknown species) AZM       3     0     0     3     0     6 #> 6 (unknown species) CAZ       0     0     0     0     0     0 #> Use 'format()' on this result to get a publishable/printable format. format(x, translate_ab = \"name (atc)\") #> # A tibble: 39 × 12 #>    Group     Drug  CoNS  `E. coli` `E. faecalis` `K. pneumoniae` `P. aeruginosa` #>    <chr>     <chr> <chr> <chr>     <chr>         <chr>           <chr>           #>  1 \"Aminogl… Amik… \"100… \"  0.0% … \"100.0% (39/… \"\"              \"\"              #>  2 \"\"        Gent… \" 13… \"  2.0% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  3 \"\"        Kana… \"100… \"\"        \"100.0% (39/… \"\"              \"100.0% (30/30… #>  4 \"\"        Tobr… \" 78… \"  2.6% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  5 \"Antimyc… Rifa… \"\"    \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  6 \"Beta-la… Amox… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  7 \"\"        Amox… \" 42… \" 13.1% … \"\"            \" 10.3% (6/58)\" \"100.0% (30/30… #>  8 \"\"        Ampi… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  9 \"\"        Benz… \" 77… \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> 10 \"\"        Fluc… \" 42… \"\"        \"\"            \"\"              \"\"              #> # ℹ 29 more rows #> # ℹ 5 more variables: `P. mirabilis` <chr>, `S. aureus` <chr>, #> #   `S. epidermidis` <chr>, `S. hominis` <chr>, `S. pneumoniae` <chr>  # Use FUN to change to transformation of microorganism codes bug_drug_combinations(example_isolates,   FUN = mo_gramstain ) #> # A tibble: 80 × 8 #>    mo            ab        S   SDD     I     R    NI total #>    <chr>         <chr> <int> <int> <int> <int> <int> <int> #>  1 Gram-negative AMC     463     0    89   174     0   726 #>  2 Gram-negative AMK     251     0     0     5     0   256 #>  3 Gram-negative AMP     226     0     0   405     0   631 #>  4 Gram-negative AMX     226     0     0   405     0   631 #>  5 Gram-negative AZM       1     0     2   696     0   699 #>  6 Gram-negative CAZ     607     0     0    27     0   634 #>  7 Gram-negative CHL       1     0     0    30     0    31 #>  8 Gram-negative CIP     610     0    11    63     0   684 #>  9 Gram-negative CLI      18     0     1   709     0   728 #> 10 Gram-negative COL     309     0     0    78     0   387 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format.  bug_drug_combinations(example_isolates,   FUN = function(x) {     ifelse(x == as.mo(\"Escherichia coli\"),       \"E. coli\",       \"Others\"     )   } ) #> # A tibble: 80 × 8 #>    mo      ab        S   SDD     I     R    NI total #>    <chr>   <chr> <int> <int> <int> <int> <int> <int> #>  1 E. coli AMC     332     0    74    61     0   467 #>  2 E. coli AMK     171     0     0     0     0   171 #>  3 E. coli AMP     196     0     0   196     0   392 #>  4 E. coli AMX     196     0     0   196     0   392 #>  5 E. coli AZM       0     0     0   467     0   467 #>  6 E. coli CAZ     449     0     0    11     0   460 #>  7 E. coli CHL       0     0     0     0     0     0 #>  8 E. coli CIP     398     0     1    57     0   456 #>  9 E. coli CLI       0     0     0   467     0   467 #> 10 E. coli COL     240     0     0     0     0   240 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format. # }"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Data set containing clinical breakpoints interpret MIC disk diffusion SIR values, according international guidelines. dataset contain breakpoints humans, 7 different animal groups, ECOFFs. breakpoints currently implemented: clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. Use .sir() transform MICs disks measurements SIR values.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"tibble 40 217 observations 14 variables: guideline Name guideline type Breakpoint type, either \"ECOFF\", \"animal\", \"human\" host Host infectious agent. mostly useful veterinary breakpoints either \"ECOFF\", \"aquatic\", \"cats\", \"cattle\", \"dogs\", \"horse\", \"human\", \"poultry\", \"swine\" method Testing method, either \"DISK\" \"MIC\" site Body site breakpoint must applied, e.g. \"Oral\" \"Respiratory\" mo Microbial ID, see .mo() rank_index Taxonomic rank index mo 1 (subspecies/infraspecies) 5 (unknown microorganism) ab Antimicrobial code used package, EARS-Net WHONET, see .ab() ref_tbl Info guideline rule can found disk_dose Dose used disk diffusion method breakpoint_S Lowest MIC value highest number millimetres leads \"S\" breakpoint_R Highest MIC value lowest number millimetres leads \"R\", can NA uti logical value (TRUE/FALSE) indicate whether rule applies urinary tract infection (UTI) is_SDD logical value (TRUE/FALSE) indicate whether intermediate range \"S\" \"R\" interpreted \"SDD\", instead \"\". currently applies 48 breakpoints.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"different-types-of-breakpoints","dir":"Reference","previous_headings":"","what":"Different Types of Breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Supported types breakpoints ECOFF, animal, human. ECOFF (Epidemiological cut-) values used antimicrobial susceptibility testing differentiate wild-type non-wild-type strains bacteria fungi. default \"human\", can also set package option AMR_breakpoint_type. Use .sir(..., breakpoint_type = ...) interpret raw data using specific breakpoint type, e.g. .sir(..., breakpoint_type = \"ECOFF\") use ECOFFs.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"imported-from-whonet","dir":"Reference","previous_headings":"","what":"Imported From WHONET","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Clinical breakpoints package validated imported WHONET, free desktop Windows application developed supported Collaborating Centre Surveillance Antimicrobial Resistance. can read website. developers WHONET AMR package contact sharing work. highly appreciate great development WHONET software. import reproduction script can found : https://github.com/msberends/AMR/blob/main/data-raw/_reproduction_scripts/reproduction_of_clinical_breakpoints.R.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"response-from-clsi-and-eucast","dir":"Reference","previous_headings":"","what":"Response From CLSI and EUCAST","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"CEO CLSI chairman EUCAST endorsed work public use AMR package (consequently use breakpoints) June 2023, future development distributing clinical breakpoints discussed meeting CLSI, EUCAST, , developers WHONET software, developers AMR package.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-note","dir":"Reference","previous_headings":"","what":"Download Note","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"AMR package (WHONET software well) contains rather complex internal methods apply guidelines. example, breakpoints must applied certain species groups (case package available microorganisms.groups data set). important considered implementing breakpoints use.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints #> # A tibble: 40,217 × 14 #>    guideline   type  host  method site    mo            rank_index ab   ref_tbl  #>    <chr>       <chr> <chr> <chr>  <chr>   <mo>               <dbl> <ab> <chr>    #>  1 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  2 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  3 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  4 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  5 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  6 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  7 EUCAST 2025 human human DISK   NA      B_ACNTB                3 AMK  Acineto… #>  8 EUCAST 2025 human human DISK   Uncomp… B_ACNTB                3 AMK  Acineto… #>  9 EUCAST 2025 human human MIC    NA      B_ACNTB                3 AMK  Acineto… #> 10 EUCAST 2025 human human MIC    Uncomp… B_ACNTB                3 AMK  Acineto… #> # ℹ 40,207 more rows #> # ℹ 5 more variables: disk_dose <chr>, breakpoint_S <dbl>, breakpoint_R <dbl>, #> #   uti <lgl>, is_SDD <lgl>"},{"path":"https://amr-for-r.org/reference/count.html","id":null,"dir":"Reference","previous_headings":"","what":"Count Available Isolates — count","title":"Count Available Isolates — count","text":"functions can used count resistant/susceptible microbial isolates. functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. count_resistant() used count resistant isolates, count_susceptible() used count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Count Available Isolates — count","text":"","code":"count_resistant(..., only_all_tested = FALSE)  count_susceptible(..., only_all_tested = FALSE)  count_S(..., only_all_tested = FALSE)  count_SI(..., only_all_tested = FALSE)  count_I(..., only_all_tested = FALSE)  count_IR(..., only_all_tested = FALSE)  count_R(..., only_all_tested = FALSE)  count_all(..., only_all_tested = FALSE)  n_sir(..., only_all_tested = FALSE)  count_df(data, translate_ab = \"name\", language = get_AMR_locale(),   combine_SI = TRUE)"},{"path":"https://amr-for-r.org/reference/count.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Count Available Isolates — count","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count Available Isolates — count","text":"integer","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Count Available Isolates — count","text":"functions meant count isolates. Use resistance()/susceptibility() functions calculate microbial resistance/susceptibility. function count_resistant() equal function count_R(). function count_susceptible() equal function count_SI(). function n_sir() alias count_all(). can used count available isolates, .e. input antimicrobials available result (S, R). use equal n_distinct(). function equal count_susceptible(...) + count_resistant(...). function count_df() takes variable data sir class (created .sir()) counts number S's, 's R's. also supports grouped variables. function sir_df() works exactly like count_df(), adds percentage S, R.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Count Available Isolates — count","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Count Available Isolates — count","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":[]},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Count Available Isolates — count","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info.  # base R ------------------------------------------------------------ count_resistant(example_isolates$AMX) # counts \"R\" #> [1] 804 count_susceptible(example_isolates$AMX) # counts \"S\" and \"I\" #> [1] 546 count_all(example_isolates$AMX) # counts \"S\", \"I\" and \"R\" #> [1] 1350  # be more specific count_S(example_isolates$AMX) #> [1] 543 count_SI(example_isolates$AMX) #> [1] 546 count_I(example_isolates$AMX) #> [1] 3 count_IR(example_isolates$AMX) #> [1] 807 count_R(example_isolates$AMX) #> [1] 804  # Count all available isolates count_all(example_isolates$AMX) #> [1] 1350 n_sir(example_isolates$AMX) #> [1] 1350  # n_sir() is an alias of count_all(). # Since it counts all available isolates, you can # calculate back to count e.g. susceptible isolates. # These results are the same: count_susceptible(example_isolates$AMX) #> [1] 546 susceptibility(example_isolates$AMX) * n_sir(example_isolates$AMX) #> [1] 546  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = count_R(CIP),       I = count_I(CIP),       S = count_S(CIP),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Number of available isolates for a whole antibiotic class   # (i.e., in this data set columns GEN, TOB, AMK, KAN)   example_isolates %>%     group_by(ward) %>%     summarise(across(aminoglycosides(), n_sir))    # Count co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy.   # Please mind that `susceptibility()` calculates percentages right away instead.   example_isolates %>% count_susceptible(AMC) # 1433   example_isolates %>% count_all(AMC) # 1879    example_isolates %>% count_susceptible(GEN) # 1399   example_isolates %>% count_all(GEN) # 1855    example_isolates %>% count_susceptible(AMC, GEN) # 1764   example_isolates %>% count_all(AMC, GEN) # 1936    # Get number of S+I vs. R immediately of selected columns   example_isolates %>%     select(AMX, CIP) %>%     count_df(translate = FALSE)    # It also supports grouping variables   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     count_df(translate = FALSE) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 12 × 4 #>    ward       antibiotic interpretation value #>    <chr>      <chr>      <ord>          <int> #>  1 Clinical   AMX        SI               357 #>  2 Clinical   AMX        R                487 #>  3 Clinical   CIP        SI               741 #>  4 Clinical   CIP        R                128 #>  5 ICU        AMX        SI               158 #>  6 ICU        AMX        R                270 #>  7 ICU        CIP        SI               362 #>  8 ICU        CIP        R                 85 #>  9 Outpatient AMX        SI                31 #> 10 Outpatient AMX        R                 47 #> 11 Outpatient CIP        SI                78 #> 12 Outpatient CIP        R                 15 # }"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom EUCAST Rules — custom_eucast_rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"Define custom EUCAST rules organisation specific analysis use output function eucast_rules().","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"custom_eucast_rules(...)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"... Rules formula notation, see instructions, Examples.","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"organisations adoption EUCAST rules. function can used define custom EUCAST rules used eucast_rules() function.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   two custom EUCAST rules: TZP (piperacillin/tazobactam) \"S\", aminopenicillins (ampicillin amoxicillin) must made \"S\", TZP \"R\", aminopenicillins must made \"R\". rules can also printed console, immediately clear work:   rules (part tilde, example TZP == \"S\" TZP == \"R\") must evaluable data set: able run filter data set without errors. means example column TZP must exist. create sample data set test rules set:","code":"x <- custom_eucast_rules(TZP == \"S\" ~ aminopenicillins == \"S\",                          TZP == \"R\" ~ aminopenicillins == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"S\" then set to  S : #>      amoxicillin (AMX), ampicillin (AMP) #> #>   2. If TZP is \"R\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) df <- data.frame(mo = c(\"Escherichia coli\", \"Klebsiella pneumoniae\"),                  TZP = as.sir(\"R\"),                  ampi = as.sir(\"S\"),                  cipro = as.sir(\"S\")) df #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    S     S  eucast_rules(df, rules = \"custom\", custom_rules = x, info = FALSE, overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    R     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"using-taxonomic-properties-in-rules","dir":"Reference","previous_headings":"","what":"Using taxonomic properties in rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"one exception columns used rules: column names microorganisms data set can also used, exist data set. column names : \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Thus, next example work well, despite fact df data set contain column genus:","code":"y <- custom_eucast_rules(TZP == \"S\" & genus == \"Klebsiella\" ~ aminopenicillins == \"S\",                          TZP == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\")  eucast_rules(df, rules = \"custom\", custom_rules = y, info = FALSE, overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"usage-of-multiple-antimicrobials-and-antimicrobial-group-names","dir":"Reference","previous_headings":"","what":"Usage of multiple antimicrobials and antimicrobial group names","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"can define antimicrobial groups instead single antimicrobials rule consequence, part tilde (~). examples , antimicrobial group aminopenicillins includes ampicillin amoxicillin. Rules can also applied multiple antimicrobials antimicrobial groups simultaneously. Use c() function combine multiple antimicrobials. instance, following example sets aminopenicillins ureidopenicillins \"R\" column TZP (piperacillin/tazobactam) \"R\":   35 antimicrobial groups allowed rules (case-insensitive) can used combination: aminoglycosides(amikacin, amikacin/fosfomycin, apramycin, arbekacin, astromicin, bekanamycin, dibekacin, framycetin, gentamicin, gentamicin-high, habekacin, hygromycin, isepamicin, kanamycin, kanamycin-high, kanamycin/cephalexin, micronomicin, neomycin, netilmicin, pentisomicin, plazomicin, propikacin, ribostamycin, sisomicin, streptoduocin, streptomycin, streptomycin-high, tobramycin, tobramycin-high) aminopenicillins(amoxicillin ampicillin) antifungals(amorolfine, amphotericin B, amphotericin B-high, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole) antimycobacterials(4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin) betalactams(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, biapenem, carbenicillin, carindacillin, carumonam, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, ciclacillin, clometocillin, cloxacillin, dicloxacillin, doripenem, epicillin, ertapenem, flucloxacillin, hetacillin, imipenem, imipenem/EDTA, imipenem/relebactam, latamoxef, lenampicillin, loracarbef, mecillinam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, tebipenem, temocillin, ticarcillin, ticarcillin/clavulanic acid, tigemonam) betalactams_with_inhibitor(amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin/sulbactam, aztreonam/avibactam, aztreonam/nacubactam, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefoperazone/sulbactam, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefpodoxime/clavulanic acid, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, ceftolozane/tazobactam, ceftriaxone/beta-lactamase inhibitor, imipenem/relebactam, meropenem/nacubactam, meropenem/vaborbactam, mezlocillin/sulbactam, penicillin/novobiocin, penicillin/sulbactam, piperacillin/sulbactam, piperacillin/tazobactam, ticarcillin/clavulanic acid) carbapenems(biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem) cephalosporins(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) cephalosporins_1st(cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine) cephalosporins_2nd(cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef) cephalosporins_3rd(cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefetamet, cefetamet pivoxil, cefixime, cefmenoxime, cefodizime, cefoperazone, cefoperazone/sulbactam, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotiam hexetil, cefovecin, cefpimizole, cefpiramide, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefsulodin, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, latamoxef) cephalosporins_4th(cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome) cephalosporins_5th(ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam) cephalosporins_except_caz(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) fluoroquinolones(besifloxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, pazufloxacin, pefloxacin, pefloxacin screening test, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) glycopeptides(avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod) glycopeptides_except_lipo(avoparcin, bleomycin, norvancomycin, ramoplanin, teicoplanin, teicoplanin-macromethod, vancomycin, vancomycin-macromethod) isoxazolylpenicillins(cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test) lincosamides(clindamycin, lincomycin, pirlimycin) lipoglycopeptides(dalbavancin, oritavancin, telavancin) macrolides(acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin) monobactams(aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam) nitrofurans(furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone) oxazolidinones(cadazolid, cycloserine, linezolid, tedizolid, thiacetazone) penicillins(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, carbenicillin, carindacillin, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, temocillin, ticarcillin, ticarcillin/clavulanic acid) phenicols(chloramphenicol, florfenicol, thiamphenicol) polymyxins(colistin, polymyxin B, polymyxin B/polysorbate 80) quinolones(besifloxacin, cinoxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nalidixic acid screening test, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pefloxacin screening test, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) rifamycins(rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine) streptogramins(pristinamycin quinupristin/dalfopristin) sulfonamides(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea) tetracyclines(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline) tetracyclines_except_tgc(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test) trimethoprims(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadiazine/trimethoprim, sulfadimethoxine, sulfadimidine, sulfadimidine/trimethoprim, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamerazine/trimethoprim, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfametrole/trimethoprim, sulfamoxole, sulfamoxole/trimethoprim, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea, trimethoprim, trimethoprim/sulfamethoxazole) ureidopenicillins(azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam)","code":"x <- custom_eucast_rules(TZP == \"R\" ~ c(aminopenicillins, ureidopenicillins) == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"R\" then set to \"R\": #>      amoxicillin (AMX), ampicillin (AMP), azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"x <- custom_eucast_rules(   AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",   AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\" ) x #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP)  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): eucast_rules(example_isolates,   rules = \"custom\",   custom_rules = x,   info = FALSE,   overwrite = TRUE,   verbose = TRUE ) #> # A tibble: 8 × 9 #>     row col   mo_fullname     old   new   rule  rule_group rule_name rule_source #>   <int> <chr> <chr>           <ord> <chr> <chr> <chr>      <chr>     <chr>       #> 1    33 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 2    33 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 3    34 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 4    34 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 5   531 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 6   531 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 7  1485 AMP   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 8  1485 AMX   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'…  # combine rule sets x2 <- c(   x,   custom_eucast_rules(TZP == \"R\" ~ carbapenems == \"R\") ) x2 #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   3. If TZP is  R  then set to  R : #>      biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), #>      imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), #>      meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), #>      razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP)"},{"path":"https://amr-for-r.org/reference/dosage.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"EUCAST breakpoints used package based dosages data set. can retrieved eucast_dosage().","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage"},{"path":"https://amr-for-r.org/reference/dosage.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"tibble 759 observations 9 variables: ab Antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available name Official name antimicrobial drug used WHONET/EARS-Net type Type dosage, either \"high_dosage\", \"standard_dosage\", \"uncomplicated_uti\" dose Dose, \"2 g\" \"25 mg/kg\" dose_times Number times dose must administered administration Route administration, either \"\", \"im\", \"iv\", \"oral\" notes Additional dosage notes original_txt Original text PDF file EUCAST eucast_version Version number EUCAST Clinical Breakpoints guideline dosages apply, either 15, 14, 13.1, 12, 11","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage #> # A tibble: 759 × 9 #>    ab   name            type  dose  dose_times administration notes original_txt #>    <ab> <chr>           <chr> <chr>      <int> <chr>          <chr> <chr>        #>  1 AMK  Amikacin        stan… 25-3…          1 iv             \"\"    \"25-30 mg/k… #>  2 AMX  Amoxicillin     high… 2 g            6 iv             \"\"    \"2 g x 6 iv\" #>  3 AMX  Amoxicillin     stan… 1 g            3 iv             \"\"    \"1 g x 3-4 … #>  4 AMX  Amoxicillin     high… 0.75…          3 oral           \"\"    \"0.75-1 g x… #>  5 AMX  Amoxicillin     stan… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  6 AMX  Amoxicillin     unco… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  7 AMC  Amoxicillin/cl… high… 2 g …          3 iv             \"\"    \"(2 g amoxi… #>  8 AMC  Amoxicillin/cl… stan… 1 g …          3 iv             \"\"    \"(1 g amoxi… #>  9 AMC  Amoxicillin/cl… high… 0.87…          3 oral           \"\"    \"(0.875 g a… #> 10 AMC  Amoxicillin/cl… stan… 0.5 …          3 oral           \"\"    \"(0.5 g amo… #> # ℹ 749 more rows #> # ℹ 1 more variable: eucast_version <dbl>"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply EUCAST Rules — eucast_rules","title":"Apply EUCAST Rules — eucast_rules","text":"Apply rules clinical breakpoints notes expected resistant phenotypes defined European Committee Antimicrobial Susceptibility Testing (EUCAST, https://www.eucast.org), see Source. Use eucast_dosage() get data.frame advised dosages certain bug-drug combination, based dosage data set. improve interpretation antibiogram EUCAST rules applied, non-EUCAST rules can applied default, see Details.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"eucast_rules(x, col_mo = NULL, info = interactive(),   rules = getOption(\"AMR_eucastrules\", default = c(\"breakpoints\",   \"expected_phenotypes\")), verbose = FALSE, version_breakpoints = 15,   version_expected_phenotypes = 1.2, version_expertrules = 3.3,   ampc_cephalosporin_resistance = NA, only_sir_columns = FALSE,   custom_rules = NULL, overwrite = FALSE, ...)  eucast_dosage(ab, administration = \"iv\", version_breakpoints = 15)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Apply EUCAST Rules — eucast_rules","text":"EUCAST Expert Rules. Version 2.0, 2012. Leclercq et al. EUCAST expert rules antimicrobial susceptibility testing. Clin Microbiol Infect. 2013;19(2):141-60; doi:10.1111/j.1469-0691.2011.03703.x EUCAST Expert Rules, Intrinsic Resistance Exceptional Phenotypes Tables. Version 3.1, 2016. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.2, 2020. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.3, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 9.0, 2019. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 10.0, 2020. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 11.0, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 12.0, 2022. (link)","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply EUCAST Rules — eucast_rules","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). info logical indicate whether progress printed console - default print interactive sessions. rules character vector specifies rules applied. Must one \"breakpoints\", \"expected_phenotypes\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expected_phenotypes\"). default value can set another value using package option AMR_eucastrules: options(AMR_eucastrules = \"\"). using \"custom\", sure fill argument custom_rules . Custom rules can created custom_eucast_rules(). verbose logical turn Verbose mode (default ). Verbose mode, function apply rules data, instead returns data set logbook form extensive info rows columns effected way. Using Verbose mode takes lot time. version_breakpoints version number use EUCAST Clinical Breakpoints guideline. Can \"15.0\", \"14.0\", \"13.1\", \"12.0\", \"11.0\", \"10.0\". version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\". version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\". ampc_cephalosporin_resistance (applies rules contains \"expert\" \"\") character value applied cefotaxime, ceftriaxone ceftazidime AmpC de-repressed cephalosporin-resistant mutants - default NA. Currently works version_expertrules 3.2 higher; versions 'EUCAST Expert Rules Enterobacterales' state results cefotaxime, ceftriaxone ceftazidime reported note, results suppressed (emptied) three drugs. value NA (default) argument remove results three drugs, e.g. value \"R\" make results drugs resistant. Use NULL FALSE alter results three drugs AmpC de-repressed cephalosporin-resistant mutants. Using TRUE equal using \"R\".  EUCAST Expert Rules v3.2, rule applies : Citrobacter braakii, Citrobacter freundii, Citrobacter gillenii, Citrobacter murliniae, Citrobacter rodenticum, Citrobacter sedlakii, Citrobacter werkmanii, Citrobacter youngae, Enterobacter, Hafnia alvei, Klebsiella aerogenes, Morganella morganii, Providencia, Serratia. only_sir_columns logical indicate whether antimicrobial columns must detected transformed class sir (see .sir()) beforehand (default FALSE). custom_rules Custom rules apply, created custom_eucast_rules(). overwrite logical indicating whether overwrite non-NA values (default: FALSE). FALSE, non-SIR values modified (.e., value already S, R). ensure compliance EUCAST guidelines, remain FALSE, EUCAST notes often state organism \"tested susceptibility individual agents reported resistant\". ... Column name antimicrobial, see section Antimicrobials . ab (vector ) text can coerced valid antimicrobial drug code .ab(). administration Route administration, either \"\", \"im\", \"iv\", \"oral\".","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply EUCAST Rules — eucast_rules","text":"input x, possibly edited values antimicrobials. , verbose = TRUE, data.frame original new values affected bug-drug combinations.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply EUCAST Rules — eucast_rules","text":"Note: function translate MIC values SIR values. Use .sir() . Note: ampicillin (AMP, J01CA01) available amoxicillin (AMX, J01CA04) , latter used rules dependency ampicillin. drugs interchangeable comes expression antimicrobial resistance. file containing EUCAST rules located : https://github.com/msberends/AMR/blob/main/data-raw/eucast_rules.tsv.  Note: Old taxonomic names replaced current taxonomy applicable. example, Ochrobactrum anthropi renamed Brucella anthropi 2020; original EUCAST rules v3.1 v3.2 yet contain new taxonomic name. AMR package contains full microbial taxonomy updated June 24th, 2024, see microorganisms.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"custom-rules","dir":"Reference","previous_headings":"","what":"Custom Rules","title":"Apply EUCAST Rules — eucast_rules","text":"Custom rules can created using custom_eucast_rules(), e.g.:","code":"x <- custom_eucast_rules(AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",                          AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\")  eucast_rules(example_isolates, rules = \"custom\", custom_rules = x)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"-other-rules","dir":"Reference","previous_headings":"","what":"'Other' Rules","title":"Apply EUCAST Rules — eucast_rules","text":"processing, two non-EUCAST rules drug combinations can applied improve efficacy EUCAST rules, reliability data (analysis). rules : drug enzyme inhibitor set S drug without enzyme inhibitor S drug without enzyme inhibitor set R drug enzyme inhibitor R Important examples include amoxicillin amoxicillin/clavulanic acid, trimethoprim trimethoprim/sulfamethoxazole. Needless say, rules work, drugs must available data set. Since rules officially approved EUCAST, applied default. use rules, include \"\" rules argument, use eucast_rules(..., rules = \"\"). can also set package option AMR_eucastrules, .e. run options(AMR_eucastrules = \"\").","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"antimicrobials","dir":"Reference","previous_headings":"","what":"Antimicrobials","title":"Apply EUCAST Rules — eucast_rules","text":"define antimicrobials column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antimicrobials eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), bleomycin (BLM, L01DC01), brodimoprim (BDP, J01EA02), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), carumonam (CAR, J01DF02), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefepime/amikacin (CFA, J01RA06), cefetamet (CAT, J01DD10), cefiderocol (FDC, J01DI04), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), chlortetracycline (CTE, J01AA03), ciprofloxacin (CIP, J01MA02), ciprofloxacin/metronidazole (CIM, J01RA10), ciprofloxacin/ornidazole (CIO, J01RA12), ciprofloxacin/tinidazole (CIT, J01RA11), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), clomocycline (CLM1, J01AA11), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), demeclocycline (DEM, J01AA01), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), eravacycline (ERV, J01AA13), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levofloxacin/ornidazole (LEO, J01RA05), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), lymecycline (LYM, J01AA04), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metacycline (MTC, J01AA05), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), nemonoxacin (NEM, J01MB08), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), nitroxoline (NTR, J01XX07), norfloxacin (, J01MA06), norfloxacin/metronidazole (NME, J01RA14), norfloxacin/tinidazole (NTI, J01RA13), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), ofloxacin/ornidazole (OOR, J01RA09), oleandomycin (OLE, J01FA05), omadacycline (OMC, J01AA15), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), oxytetracycline (OXY, J01AA06), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), penimepicycline (PNM1, J01AA10), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), rolitetracycline (RLT, J01AA09), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sarecycline (SRC, J01AA14), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/tetroxoprim (SLT, J01EE06), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Apply EUCAST Rules — eucast_rules","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"# \\donttest{ a <- data.frame(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylpenicillin   FOX = \"S\", # Cefoxitin   stringsAsFactors = FALSE )  head(a) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   -   -   -   -   S   S #> 2  Enterococcus faecalis   -   -   -   -   -   S   S #> 3       Escherichia coli   -   -   -   -   -   S   S #> 4  Klebsiella pneumoniae   -   -   -   -   -   S   S #> 5 Pseudomonas aeruginosa   -   -   -   -   -   S   S   # apply EUCAST rules: some results wil be changed b <- eucast_rules(a, overwrite = TRUE) #> Warning: in eucast_rules(): not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir))  head(b) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   S   R   R   S   S   S #> 2  Enterococcus faecalis   -   -   R   R   R   S   R #> 3       Escherichia coli   R   -   -   -   -   R   S #> 4  Klebsiella pneumoniae   R   R   -   -   -   R   S #> 5 Pseudomonas aeruginosa   R   R   -   -   R   R   R   # do not apply EUCAST rules, but rather get a data.frame # containing all details about the transformations: c <- eucast_rules(a, overwrite = TRUE, verbose = TRUE) #> Warning: in eucast_rules(): not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir)) head(c) #>   row col           mo_fullname old new rule          rule_group #> 1   1 AMX Staphylococcus aureus   -   S              Breakpoints #> 2   1 CXM Staphylococcus aureus   -   S              Breakpoints #> 3   1 CAZ Staphylococcus aureus   -   R      Expected phenotypes #> 4   1 COL Staphylococcus aureus   -   R      Expected phenotypes #> 5   2 CAZ Enterococcus faecalis   -   R      Expected phenotypes #> 6   2 COL Enterococcus faecalis   -   R      Expected phenotypes #>                                                         rule_name #> 1                                                  Staphylococcus #> 2                                                  Staphylococcus #> 3 Table 4: Expected resistant phenotype in gram-positive bacteria #> 4 Table 4: Expected resistant phenotype in gram-positive bacteria #> 5 Table 4: Expected resistant phenotype in gram-positive bacteria #> 6 Table 4: Expected resistant phenotype in gram-positive bacteria #>                                         rule_source #> 1   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 2   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 3 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 4 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 5 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 6 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 # }  # Dosage guidelines:  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\") #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v15.0 (2025). This note will be shown once per session. #> # A tibble: 3 × 5 #>   ab   name          standard_dosage  high_dosage  eucast_version #>   <ab> <chr>         <chr>            <chr>                 <dbl> #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA                       15 #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA                       15 #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv             15  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\", version_breakpoints = 10) #> # A tibble: 3 × 5 #>   ab   name          standard_dosage high_dosage eucast_version #>   <ab> <chr>         <chr>           <chr>                <dbl> #> 1 TOB  Tobramycin    NA              NA                      NA #> 2 GEN  Gentamicin    NA              NA                      NA #> 3 CIP  Ciprofloxacin NA              NA                      NA"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 2 000 Example Isolates — example_isolates","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"data set containing 2 000 microbial isolates full antibiograms. data set contains randomised fictitious data, reflects reality can used practise AMR data analysis. examples, please read tutorial website.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"tibble 2 000 observations 46 variables: date Date receipt laboratory patient ID patient age Age patient gender Gender patient, either \"F\" \"M\" ward Ward type patient admitted, either \"Clinical\", \"ICU\", \"Outpatient\" mo ID microorganism created .mo(), see also microorganisms data set PEN:RIF 40 different antimicrobials class sir (see .sir()); column names occur antimicrobials data set can translated set_ab_names() ab_name()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Unclean Data — example_isolates_unclean","title":"Data Set with Unclean Data — example_isolates_unclean","text":"data set containing 3 000 microbial isolates cleaned consequently ready AMR data analysis. data set can used practice.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Unclean Data — example_isolates_unclean","text":"tibble 3 000 observations 8 variables: patient_id ID patient date date receipt laboratory hospital ID hospital, C bacteria info microorganism can transformed .mo(), see also microorganisms AMX:GEN 4 different antimicrobials transformed .sir()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Unclean Data — example_isolates_unclean","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":null,"dir":"Reference","previous_headings":"","what":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"Export Data Set NCBI BioSample Antibiogram","code":""},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"","code":"export_ncbi_biosample(x, filename = paste0(\"biosample_\", format(Sys.time(),   \"%Y-%m-%d-%H%M%S\"), \".xlsx\"), type = \"pathogen MIC\",   columns = where(is.mic), save_as_xlsx = TRUE)"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"x data set. filename character string specifying file name. type character string specifying type data set, either \"pathogen MIC\" \"beta-lactamase MIC\", see https://www.ncbi.nlm.nih.gov/biosample/docs/.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine First Isolates — first_isolate","title":"Determine First Isolates — first_isolate","text":"Determine first isolates microorganisms every patient per episode (needed) per specimen type. functions support four methods summarised Hindler et al. 2007 (doi:10.1086/511864 ). determine patient episodes necessarily based microorganisms, use is_new_episode() also supports grouping dplyr package.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine First Isolates — first_isolate","text":"","code":"first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, col_testcode = NULL, col_specimen = NULL,   col_icu = NULL, col_keyantimicrobials = NULL, episode_days = 365,   testcodes_exclude = NULL, icu_exclude = FALSE, specimen_group = NULL,   type = \"points\", method = c(\"phenotype-based\", \"episode-based\",   \"patient-based\", \"isolate-based\"), ignore_I = TRUE, points_threshold = 2,   info = interactive(), include_unknown = FALSE,   include_untested_sir = TRUE, ...)  filter_first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, episode_days = 365, method = c(\"phenotype-based\",   \"episode-based\", \"patient-based\", \"isolate-based\"), ...)"},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine First Isolates — first_isolate","text":"Methodology functions strictly based : M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. Hindler JF Stelling J (2007). Analysis Presentation Cumulative Antibiograms: New Consensus Guideline Clinical Laboratory Standards Institute. Clinical Infectious Diseases, 44(6), 867-873. doi:10.1086/511864","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine First Isolates — first_isolate","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_date Column name result date (date received lab) - default first column date class. col_patient_id Column name unique IDs patients - default first column starts 'patient' 'patid' (case insensitive). col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). col_testcode Column name test codes. Use col_testcode = NULL exclude certain test codes (test codes screening). case testcodes_exclude ignored. col_specimen Column name specimen type group. col_icu Column name logicals (TRUE/FALSE) whether ward department Intensive Care Unit (ICU). can also logical vector length rows x. col_keyantimicrobials (useful method = \"phenotype-based\") column name key antimicrobials determine first isolates, see key_antimicrobials(). default first column starts 'key' followed 'ab' 'antibiotics' 'antimicrobials' (case insensitive). Use col_keyantimicrobials = FALSE prevent . Can also output key_antimicrobials(). episode_days Episode days genus/species combination determined 'first isolate' . default 365 days based guideline CLSI, see Source. testcodes_exclude character vector test codes excluded (case-insensitive). icu_exclude logical indicate whether ICU isolates excluded (rows value TRUE column set col_icu). specimen_group Value column set col_specimen filter . type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. method method apply, either \"phenotype-based\", \"episode-based\", \"patient-based\" \"isolate-based\" (can abbreviated), see Details. default \"phenotype-based\" antimicrobial test results present data, \"episode-based\" otherwise. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details. info logical indicate info printed - default TRUE interactive mode. include_unknown logical indicate whether 'unknown' microorganisms included , .e. microbial code \"UNKNOWN\", defaults FALSE. WHONET users, means records organism code \"con\" (contamination) excluded default. Isolates microbial ID NA always excluded first isolate. include_untested_sir logical indicate whether also rows without antibiotic results still eligible becoming first isolate. Use include_untested_sir = FALSE always return FALSE rows. checks data set columns class sir consequently requires transforming columns antibiotic results using .sir() first. ... Arguments passed first_isolate() using filter_first_isolate(), otherwise arguments passed key_antimicrobials() (universal, gram_negative, gram_positive).","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine First Isolates — first_isolate","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine First Isolates — first_isolate","text":"methodology implemented functions strictly based recommendations outlined CLSI Guideline M39 research overview Hindler et al. (2007, doi:10.1086/511864 ). conduct epidemiological analyses antimicrobial resistance data, -called first isolates included prevent overestimation underestimation antimicrobial resistance. Different methods can used , see . functions context-aware. means x argument can left blank used inside data.frame call, see Examples. first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names. isolates microbial ID NA excluded first isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"different-methods","dir":"Reference","previous_headings":"","what":"Different methods","title":"Determine First Isolates — first_isolate","text":"According previously-mentioned sources, different methods (algorithms) select first isolates increasing reliability: isolate-based, patient-based, episode-based phenotype-based. methods select combination taxonomic genus species (subspecies). mentioned methods covered first_isolate() function:","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"isolate-based","dir":"Reference","previous_headings":"","what":"Isolate-based","title":"Determine First Isolates — first_isolate","text":"method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"patient-based","dir":"Reference","previous_headings":"","what":"Patient-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient , set episode_days Inf. method makes sure duplicate isolates selected patient. method preferred e.g. identify first MRSA finding patient determine incidence. Conversely, large longitudinal data set, mean isolates excluded found years initial isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"episode-based","dir":"Reference","previous_headings":"","what":"Episode-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, 14, 30, 60 365. Short episodes common analysing specific hospital ward data ICU cases, long episodes common analysing regional national data. common method correct duplicate isolates. Patients categorised episodes based ID dates (e.g., date specimen receipt laboratory result). common method, take account antimicrobial test results. means e.g. methicillin-resistant Staphylococcus aureus (MRSA) isolate differentiated wildtype Staphylococcus aureus isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"phenotype-based","dir":"Reference","previous_headings":"","what":"Phenotype-based","title":"Determine First Isolates — first_isolate","text":"reliable method, since also weighs antibiogram (antimicrobial test results) yielding -called 'first weighted isolates'. two different methods weigh antibiogram: Using type = \"points\" argument points_threshold (default) method weighs antimicrobial drugs available data set. difference S R (vice versa) counts 0.5 points, difference S R (vice versa) counts 1 point. sum points exceeds points_threshold, defaults 2, isolate selected first weighted isolate. antimicrobials internally selected using all_antimicrobials() function. output function need passed first_isolate() function. Using type = \"keyantimicrobials\" argument ignore_I method weighs specific antimicrobial drugs, called key antimicrobials. difference S R (vice versa) key antimicrobials select isolate first weighted isolate. ignore_I = FALSE, also differences S R (vice versa) lead . Key antimicrobials internally selected using key_antimicrobials() function, can also added manually variable data set col_keyantimicrobials argument. Another option pass output key_antimicrobials() function directly col_keyantimicrobials argument. default method phenotype-based (using type = \"points\") episode-based (using episode_days = 365). makes sure every genus-species combination selected per patient per year, taking account antimicrobial test results. antimicrobial test results available data set, episode-based method applied default.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine First Isolates — first_isolate","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  example_isolates[first_isolate(info = TRUE), ] #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'date' as input for col_date. #> ℹ Using column 'patient' as input for col_patient_id. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # \\donttest{ # get all first Gram-negatives example_isolates[which(first_isolate(info = FALSE) & mo_is_gram_negative()), ] #> ℹ Using column 'mo' as input for mo_is_gram_negative() #> # A tibble: 441 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  7 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #>  8 2002-03-16 4FC193     69 M      Clinical B_PSDMN_AERG   R     NA    NA    R   #>  9 2002-04-01 496896     46 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> 10 2002-04-23 EE2510     69 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> # ℹ 431 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   # filter on first isolates using dplyr:   example_isolates %>%     filter(first_isolate(info = TRUE)) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # short-hand version:   example_isolates %>%     filter_first_isolate(info = FALSE) } #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # flag the first isolates per group:   example_isolates %>%     group_by(ward) %>%     mutate(first = first_isolate(info = TRUE)) %>%     select(ward, date, patient, mo, first) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #>  #> Group: ward = \"Clinical\" #> ℹ Excluding 9 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 865 'phenotype-based' first isolates (70.1% of total where a #>    microbial ID was available) #>  #> Group: ward = \"ICU\" #> ℹ Excluding 6 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 452 'phenotype-based' first isolates (70.0% of total where a #>    microbial ID was available) #>  #> Group: ward = \"Outpatient\" #> ℹ Excluding 1 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 99 'phenotype-based' first isolates (82.5% of total where a #>    microbial ID was available) #> # A tibble: 2,000 × 5 #> # Groups:   ward [3] #>    ward     date       patient mo           first #>    <chr>    <date>     <chr>   <mo>         <lgl> #>  1 Clinical 2002-01-02 A77334  B_ESCHR_COLI TRUE  #>  2 Clinical 2002-01-03 A77334  B_ESCHR_COLI FALSE #>  3 ICU      2002-01-07 067927  B_STPHY_EPDR TRUE  #>  4 ICU      2002-01-07 067927  B_STPHY_EPDR FALSE #>  5 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  6 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  7 Clinical 2002-01-14 462729  B_STPHY_AURS TRUE  #>  8 Clinical 2002-01-14 462729  B_STPHY_AURS FALSE #>  9 ICU      2002-01-16 067927  B_STPHY_EPDR TRUE  #> 10 ICU      2002-01-17 858515  B_STPHY_EPDR TRUE  #> # ℹ 1,990 more rows # }"},{"path":"https://amr-for-r.org/reference/g.test.html","id":null,"dir":"Reference","previous_headings":"","what":"G-test for Count Data — g.test","title":"G-test for Count Data — g.test","text":"g.test() performs chi-squared contingency table tests goodness--fit tests, just like chisq.test() reliable (1). G-test can used see whether number observations category fits theoretical expectation (called G-test goodness--fit), see whether proportions one variable different different values variable (called G-test independence).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"G-test for Count Data — g.test","text":"","code":"g.test(x, y = NULL, p = rep(1/length(x), length(x)), rescale.p = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"G-test for Count Data — g.test","text":"code function identical chisq.test(), except : calculation statistic changed \\(2 * sum(x * log(x / E))\\) Yates' continuity correction removed apply G-test possibility simulate p values simulate.p.value removed","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"G-test for Count Data — g.test","text":"x numeric vector matrix. x y can also     factors. y numeric vector; ignored x matrix.      x factor, y factor length. p vector probabilities length x.     error given entry p negative. rescale.p logical scalar; TRUE p rescaled     (necessary) sum 1.  rescale.p FALSE,     p sum 1, error given.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"G-test for Count Data — g.test","text":"list class \"htest\" containing following   components: statistic value chi-squared test statistic. parameter degrees freedom approximate     chi-squared distribution test statistic, NA     p-value computed Monte Carlo simulation. p.value p-value test. method character string indicating type test     performed, whether Monte Carlo simulation continuity     correction used. data.name character string giving name(s) data. observed observed counts. expected expected counts null hypothesis. residuals Pearson residuals,     (observed - expected) / sqrt(expected). stdres standardized residuals,     (observed - expected) / sqrt(V), V     residual cell variance (Agresti, 2007, section 2.4.5     case x matrix, n * p * (1 - p) otherwise).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"G-test for Count Data — g.test","text":"x matrix one row column, x vector y given, goodness--fit test performed (x treated one-dimensional contingency table). entries x must non-negative integers. case, hypothesis tested whether population probabilities equal p, equal p given. x matrix least two rows columns, taken two-dimensional contingency table: entries x must non-negative integers.  Otherwise, x y must vectors factors length; cases missing values removed, objects coerced factors, contingency table computed .  Pearson's chi-squared test performed null hypothesis joint distribution cell counts 2-dimensional contingency table product row column marginals. p-value computed asymptotic chi-squared distribution test statistic. contingency table case simulation done random sampling set contingency tables given marginals, works marginals strictly positive. Note usual sampling situation assumed chi-squared test (G-test) rather Fisher's exact test. goodness--fit case simulation done random sampling discrete distribution specified p, sample size n = sum(x). simulation done R may slow.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-goodness-of-fit-likelihood-ratio-test-","dir":"Reference","previous_headings":"","what":"G-test Of Goodness-of-Fit (Likelihood Ratio Test)","title":"G-test for Count Data — g.test","text":"Use G-test goodness--fit one nominal variable two values (male female, red, pink white flowers). compare observed counts numbers observations category expected counts, calculate using kind theoretical expectation (1:1 sex ratio 1:2:1 ratio genetic cross). expected number observations category small, G-test may give inaccurate results, use exact test instead (fisher.test()). G-test goodness--fit alternative chi-square test goodness--fit (chisq.test()); tests advantages disadvantages, results two tests usually similar.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-independence","dir":"Reference","previous_headings":"","what":"G-test of Independence","title":"G-test for Count Data — g.test","text":"Use G-test independence two nominal variables, two possible values. want know whether proportions one variable different among values variable. also possible G-test independence two nominal variables. example, Jackson et al. (2013) also data children 3, analysis old vs. young, thigh vs. arm, reaction vs. reaction, analyzed together. Fisher's exact test (fisher.test()) exact test, G-test still approximation. 2x2 table, Fisher's Exact test may slower still run seconds, even sum observations multiple millions. G-test independence alternative chi-square test independence (chisq.test()), give approximately results.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"how-the-test-works","dir":"Reference","previous_headings":"","what":"How the Test Works","title":"G-test for Count Data — g.test","text":"Unlike exact test goodness--fit (fisher.test()), G-test directly calculate probability obtaining observed results something extreme. Instead, like almost statistical tests, G-test intermediate step; uses data calculate test statistic measures far observed data null expectation. use mathematical relationship, case chi-square distribution, estimate probability obtaining value test statistic. G-test uses log ratio two likelihoods test statistic, also called likelihood ratio test log-likelihood ratio test. formula calculate G-statistic : \\(G = 2 * sum(x * log(x / E))\\) E expected values. Since chi-square distributed, p value can calculated R :   df degrees freedom. two categories want find ones significantly different null expectation, can use method testing category vs. sum categories, Bonferroni correction. use G-tests category, course.","code":"p <- stats::pchisq(G, df, lower.tail = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"G-test for Count Data — g.test","text":"McDonald, J.H. 2014. Handbook Biological Statistics (3rd ed.). Sparky House Publishing, Baltimore, Maryland. http://www.biostathandbook.com/gtestgof.html.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"G-test for Count Data — g.test","text":"","code":"# = EXAMPLE 1 = # Shivrain et al. (2006) crossed clearfield rice (which are resistant # to the herbicide imazethapyr) with red rice (which are susceptible to # imazethapyr). They then crossed the hybrid offspring and examined the # F2 generation, where they found 772 resistant plants, 1611 moderately # resistant plants, and 737 susceptible plants. If resistance is controlled # by a single gene with two co-dominant alleles, you would expect a 1:2:1 # ratio.  x <- c(772, 1611, 737) g.test(x, p = c(1, 2, 1) / 4) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 4.1471, p-value = 0.1257 #>   # There is no significant difference from a 1:2:1 ratio. # Meaning: resistance controlled by a single gene with two co-dominant # alleles, is plausible.   # = EXAMPLE 2 = # Red crossbills (Loxia curvirostra) have the tip of the upper bill either # right or left of the lower bill, which helps them extract seeds from pine # cones. Some have hypothesized that frequency-dependent selection would # keep the number of right and left-billed birds at a 1:1 ratio. Groth (1992) # observed 1752 right-billed and 1895 left-billed crossbills.  x <- c(1752, 1895) g.test(x) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 5.6085, p-value = 0.01787 #>   # There is a significant difference from a 1:1 ratio. # Meaning: there are significantly more left-billed birds."},{"path":"https://amr-for-r.org/reference/get_episode.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Clinical or Epidemic Episodes — get_episode","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"functions determine items vector can considered (start ) new episode. can used determine clinical episodes epidemiological analysis. get_episode() function returns index number episode per group, is_new_episode() function returns TRUE every new get_episode() index. absolute relative episode determination supported.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"get_episode(x, episode_days = NULL, case_free_days = NULL, ...)  is_new_episode(x, episode_days = NULL, case_free_days = NULL, ...)"},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"x Vector dates (class Date POSIXt), sorted internally determine episodes. episode_days Episode length days specify time period new episode begins, can also less day Inf, see Details. case_free_days (inter-epidemic) interval length days new episode start, can also less day Inf, see Details. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode(): integer vector is_new_episode(): logical vector","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"Episodes can determined two ways: absolute relative. Absolute method uses episode_days define episode length days, new episode start. common use case AMR data analysis microbial epidemiology: episodes S. aureus bacteraemia ICU patients example. episode length 30 days, new S. aureus isolates ICU episode 30 days considered different (new) episode. Thus, method counts since start previous episode. Relative method uses case_free_days quantify duration case-free days (inter-epidemic interval), new episode start. common use case infectious disease epidemiology: episodes norovirus outbreaks hospital example. case-free period 14 days, new norovirus cases time considered different (new) episode. Thus, methods counts since last case previous episode. table: ** marks start new episode, 8 January 2023 7 days since start previous episode (1 January 2023).  *** marks start new episode, 21 January 2023 7 days since last case previous episode (8 January 2023). Either episode_days case_free_days must provided function.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"difference-between-get-episode-and-is-new-episode-","dir":"Reference","previous_headings":"","what":"Difference between get_episode() and is_new_episode()","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode() function returns index number episode, cases/patients/isolates first episode number 1, cases/patients/isolates second episode number 2, etc. is_new_episode() function hand, returns TRUE every new get_episode() index. specify, setting episode_days = 365 (using method 1 explained ), two functions differ:","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names allows different isolate selection methods. dplyr package required functions work, episode functions support variable grouping work conveniently inside dplyr verbs filter(), mutate() summarise().","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"# difference between absolute and relative determination of episodes: x <- data.frame(dates = as.Date(c(   \"2021-01-01\",   \"2021-01-02\",   \"2021-01-05\",   \"2021-01-08\",   \"2021-02-21\",   \"2021-02-22\",   \"2021-02-23\",   \"2021-02-24\",   \"2021-03-01\",   \"2021-03-01\" ))) x$absolute <- get_episode(x$dates, episode_days = 7) x$relative <- get_episode(x$dates, case_free_days = 7) x #>         dates absolute relative #> 1  2021-01-01        1        1 #> 2  2021-01-02        1        1 #> 3  2021-01-05        1        1 #> 4  2021-01-08        2        1 #> 5  2021-02-21        3        2 #> 6  2021-02-22        3        2 #> 7  2021-02-23        3        2 #> 8  2021-02-24        3        2 #> 9  2021-03-01        4        2 #> 10 2021-03-01        4        2   # `example_isolates` is a data set available in the AMR package. # See ?example_isolates df <- example_isolates[sample(seq_len(2000), size = 100), ]  get_episode(df$date, episode_days = 60) # indices #>   [1] 33 15 22 12 31 27 11 45 38 19  3 29  4 42 41 41 13 36 23 33 38 46 31 45 21 #>  [26] 24  9 18 10  6 11 41  1 12 38 26 11 36  1 41 32 14  7 37 22 26 16 44 14  7 #>  [51] 44  4 45  4  2 39 20 43  9 42 29 11  6 36 25 30 23  8 14  4 28 11 14 20 40 #>  [76] 23  6 11 16 29 27  9  8 15 45 31 35 44 35 46  5 39 44 24 17 12 31 32 36 34 is_new_episode(df$date, episode_days = 60) # TRUE/FALSE #>   [1]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [13]  TRUE  TRUE  TRUE FALSE  TRUE  TRUE  TRUE FALSE FALSE  TRUE FALSE FALSE #>  [25]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE FALSE FALSE  TRUE FALSE FALSE  TRUE #>  [37] FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE  TRUE FALSE FALSE  TRUE  TRUE #>  [49] FALSE FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE  TRUE FALSE FALSE #>  [61] FALSE FALSE FALSE FALSE  TRUE  TRUE FALSE  TRUE FALSE FALSE  TRUE FALSE #>  [73] FALSE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE #>  [85] FALSE FALSE  TRUE FALSE FALSE FALSE  TRUE FALSE FALSE FALSE  TRUE FALSE #>  [97] FALSE FALSE FALSE  TRUE  # filter on results from the third 60-day episode only, using base R df[which(get_episode(df$date, 60) == 3), ] #> # A tibble: 1 × 46 #>   date       patient   age gender ward      mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr>     <mo>         <sir> <sir> <sir> <sir> #> 1 2002-07-16 241328     78 M      Outpatie… B_STPHY_CONS   R     NA    S     R   #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, RIF <sir>  # the functions also work for less than a day, e.g. to include one per hour: get_episode(   c(     Sys.time(),     Sys.time() + 60 * 60   ),   episode_days = 1 / 24 ) #> [1] 1 2  # \\donttest{ if (require(\"dplyr\")) {   # is_new_episode() can also be used in dplyr verbs to determine patient   # episodes based on any (combination of) grouping variables:   df %>%     mutate(condition = sample(       x = c(\"A\", \"B\", \"C\"),       size = 100,       replace = TRUE     )) %>%     group_by(patient, condition) %>%     mutate(new_episode = is_new_episode(date, 365)) %>%     select(patient, date, condition, new_episode) %>%     arrange(patient, condition, date) } #> # A tibble: 100 × 4 #> # Groups:   patient, condition [95] #>    patient date       condition new_episode #>    <chr>   <date>     <chr>     <lgl>       #>  1 067927  2002-02-14 B         TRUE        #>  2 067927  2002-02-14 B         FALSE       #>  3 0E2483  2007-06-21 B         TRUE        #>  4 151041  2006-02-10 C         TRUE        #>  5 155435  2014-06-18 A         TRUE        #>  6 167474  2008-02-15 A         TRUE        #>  7 174209  2011-10-03 B         TRUE        #>  8 175532  2012-10-11 A         TRUE        #>  9 187841  2012-09-30 C         TRUE        #> 10 197007  2012-07-17 B         TRUE        #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward, patient) %>%     transmute(date,       patient,       new_index = get_episode(date, 60),       new_logical = is_new_episode(date, 60)     ) %>%     arrange(patient, ward, date) } #> # A tibble: 100 × 5 #> # Groups:   ward, patient [93] #>    ward       date       patient new_index new_logical #>    <chr>      <date>     <chr>       <int> <lgl>       #>  1 ICU        2002-02-14 067927          1 TRUE        #>  2 ICU        2002-02-14 067927          1 FALSE       #>  3 ICU        2007-06-21 0E2483          1 TRUE        #>  4 Clinical   2006-02-10 151041          1 TRUE        #>  5 Clinical   2014-06-18 155435          1 TRUE        #>  6 Clinical   2008-02-15 167474          1 TRUE        #>  7 Outpatient 2011-10-03 174209          1 TRUE        #>  8 Clinical   2012-10-11 175532          1 TRUE        #>  9 Clinical   2012-09-30 187841          1 TRUE        #> 10 Clinical   2012-07-17 197007          1 TRUE        #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward) %>%     summarise(       n_patients = n_distinct(patient),       n_episodes_365 = sum(is_new_episode(date, episode_days = 365)),       n_episodes_60 = sum(is_new_episode(date, episode_days = 60)),       n_episodes_30 = sum(is_new_episode(date, episode_days = 30))     ) } #> # A tibble: 3 × 5 #>   ward       n_patients n_episodes_365 n_episodes_60 n_episodes_30 #>   <chr>           <int>          <int>         <int>         <int> #> 1 Clinical           55             13            35            44 #> 2 ICU                32              9            19            25 #> 3 Outpatient          6              6             6             6  # grouping on patients and microorganisms leads to the same # results as first_isolate() when using 'episode-based': if (require(\"dplyr\")) {   x <- df %>%     filter_first_isolate(       include_unknown = TRUE,       method = \"episode-based\"     )    y <- df %>%     group_by(patient, mo) %>%     filter(is_new_episode(date, 365)) %>%     ungroup()    identical(x, y) } #> [1] TRUE  # but is_new_episode() has a lot more flexibility than first_isolate(), # since you can now group on anything that seems relevant: if (require(\"dplyr\")) {   df %>%     group_by(patient, mo, ward) %>%     mutate(flag_episode = is_new_episode(date, 365)) %>%     select(group_vars(.), flag_episode) } #> # A tibble: 100 × 4 #> # Groups:   patient, mo, ward [95] #>    patient mo           ward       flag_episode #>    <chr>   <mo>         <chr>      <lgl>        #>  1 88B975  B_STRPT      Clinical   TRUE         #>  2 904485  B_ESCHR_COLI Outpatient TRUE         #>  3 167474  B_STPHY_CONS Clinical   TRUE         #>  4 777154  B_CTRBC      Clinical   TRUE         #>  5 E58140  B_ESCHR_COLI Clinical   TRUE         #>  6 E58549  B_ESCHR_COLI Clinical   TRUE         #>  7 D65308  B_STPHY_EPDR ICU        TRUE         #>  8 871020  B_STPHY_EPDR Clinical   TRUE         #>  9 B13995  B_STPHY_AURS Clinical   TRUE         #> 10 CB6026  B_STPHY_CONS Clinical   TRUE         #> # ℹ 90 more rows # }"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":null,"dir":"Reference","previous_headings":"","what":"PCA Biplot with ggplot2 — ggplot_pca","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"Produces ggplot2 variant -called biplot PCA (principal component analysis), flexible appealing base R biplot() function.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"ggplot_pca(x, choices = 1:2, scale = 1, pc.biplot = TRUE,   labels = NULL, labels_textsize = 3, labels_text_placement = 1.5,   groups = NULL, ellipse = TRUE, ellipse_prob = 0.68,   ellipse_size = 0.5, ellipse_alpha = 0.5, points_size = 2,   points_alpha = 0.25, arrows = TRUE, arrows_colour = \"darkblue\",   arrows_size = 0.5, arrows_textsize = 3, arrows_textangled = TRUE,   arrows_alpha = 0.75, base_textsize = 10, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"ggplot_pca() function based ggbiplot() function ggbiplot package Vince Vu, found GitHub: https://github.com/vqv/ggbiplot (retrieved: 2 March 2020, latest commit: 7325e88; 12 February 2015). per GPL-2 licence demands documentation code changes, changes made based source code : Rewritten code remove dependency packages plyr, scales grid Parametrised options, like arrow ellipse settings Hardened input possibilities defining exact type user input every argument Added total amount explained variance caption plot Cleaned syntax based lintr package, fixed grammatical errors added integrity checks Updated documentation","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"x object returned pca(), prcomp() princomp(). choices length 2 vector specifying components plot. default     biplot strict sense. scale variables scaled lambda ^ scale     observations scaled lambda ^ (1-scale)     lambda singular values computed     princomp. Normally 0 <= scale <= 1, warning     issued specified scale outside range. pc.biplot true, use Gabriel (1971) refers \"principal component     biplot\", lambda = 1 observations scaled sqrt(n)     variables scaled sqrt(n).  inner products     variables approximate covariances distances observations     approximate Mahalanobis distance. labels optional vector labels observations. set, labels placed respective points. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). labels_textsize size text used labels. labels_text_placement Adjustment factor placement variable names (>=1 means away arrow head). groups optional vector groups labels, length labels. set, points labels coloured according groups. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). ellipse logical indicate whether normal data ellipse drawn group (set groups). ellipse_prob Statistical size ellipse normal probability. ellipse_size size ellipse line. ellipse_alpha alpha (transparency) ellipse line. points_size size points. points_alpha alpha (transparency) points. arrows logical indicate whether arrows drawn. arrows_colour colour arrow text. arrows_size size (thickness) arrow lines. arrows_textsize size text end arrows. arrows_textangled logical whether text end arrows angled. arrows_alpha alpha (transparency) arrows text. base_textsize text size plot elements except labels arrows. ... Arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"colours labels points can changed adding another scale layer colour, scale_colour_viridis_d() scale_colour_brewer().","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    summary(pca_result)    # old base R plotting method:   biplot(pca_result, main = \"Base R biplot\")    # new ggplot2 plotting method using this package:   if (require(\"ggplot2\")) {     ggplot_pca(pca_result) +       labs(title = \"ggplot2 biplot\")   }   if (require(\"ggplot2\")) {     # still extendible with any ggplot2 function     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"ggplot2 biplot\")   } } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (minimum = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # }"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":null,"dir":"Reference","previous_headings":"","what":"AMR Plots with ggplot2 — ggplot_sir","title":"AMR Plots with ggplot2 — ggplot_sir","text":"Use functions create bar plots AMR data analysis. functions rely ggplot2 functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"ggplot_sir(data, position = NULL, x = \"antibiotic\",   fill = \"interpretation\", facet = NULL, breaks = seq(0, 1, 0.1),   limits = NULL, translate_ab = \"name\", combine_SI = TRUE,   minimum = 30, language = get_AMR_locale(), nrow = NULL, colours = c(S   = \"#3CAEA3\", SI = \"#3CAEA3\", I = \"#F6D55C\", IR = \"#ED553B\", R = \"#ED553B\"),   datalabels = TRUE, datalabels.size = 2.5, datalabels.colour = \"grey15\",   title = NULL, subtitle = NULL, caption = NULL,   x.title = \"Antimicrobial\", y.title = \"Proportion\", ...)  geom_sir(position = NULL, x = c(\"antibiotic\", \"interpretation\"),   fill = \"interpretation\", translate_ab = \"name\", minimum = 30,   language = get_AMR_locale(), combine_SI = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"AMR Plots with ggplot2 — ggplot_sir","text":"data data.frame column(s) class sir (see .sir()). position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". x Variable show x axis, either \"antibiotic\" (default) \"interpretation\" grouping variable. fill Variable categorise using plots legend, either \"antibiotic\" (default) \"interpretation\" grouping variable. facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. nrow (using facet) number rows. colours named vactor colour used filling. default colours colour-blind friendly. datalabels Show datalabels using labels_sir_count(). datalabels.size Size datalabels. datalabels.colour Colour datalabels. title Text show title plot. subtitle Text show subtitle plot. caption Text show caption plot. x.title Text show x axis description. y.title Text show y axis description. ... arguments passed geom_sir() , case scale_sir_colours(), named values set colours. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Plots with ggplot2 — ggplot_sir","text":"default, names antimicrobials shown plots using ab_name(). can set translate_ab argument. See count_df(). geom_sir() take variable data sir class (created .sir()) using sir_df() plot bars percentage S, , R. default behaviour bars stacked different antimicrobials x axis. Additional functions include: facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() sets colours bars (green S, yellow , red R). multilingual support. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage amount isolates using ggplot2::geom_text(). ggplot_sir() wrapper around functions uses data first input. makes possible use function pipe (%>%). See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"# \\donttest{ if (require(\"ggplot2\") && require(\"dplyr\")) {   # get antimicrobial results for drugs against a UTI:   ggplot(example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)) +     geom_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # prettify the plot using some additional functions:   df <- example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)   ggplot(df) +     geom_sir() +     scale_y_percent() +     scale_sir_colours(aesthetics = \"fill\") +     labels_sir_count() +     theme_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # or better yet, simplify this using the wrapper function - a single command:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # get only proportions and no counts:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(datalabels = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # add other ggplot2 arguments as you like:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(       width = 0.5,       colour = \"black\",       size = 1,       linetype = 2,       alpha = 0.25     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # you can alter the colours with colour names:   example_isolates %>%     select(AMX) %>%     ggplot_sir(colours = c(SI = \"yellow\")) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # but you can also use the built-in colour-blind friendly colours for   # your plots, where \"S\" is green, \"I\" is yellow and \"R\" is red:   data.frame(     x = c(\"Value1\", \"Value2\", \"Value3\"),     y = c(1, 2, 3),     z = c(\"Value4\", \"Value5\", \"Value6\")   ) %>%     ggplot() +     geom_col(aes(x = x, y = y, fill = z)) +     scale_sir_colours(       aesthetics = \"fill\",       Value4 = \"S\", Value5 = \"I\", Value6 = \"R\"     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # resistance of ciprofloxacine per age group   example_isolates %>%     mutate(first_isolate = first_isolate()) %>%     filter(       first_isolate == TRUE,       mo == as.mo(\"Escherichia coli\")     ) %>%     # age_groups() is also a function in this AMR package:     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(x = \"age_group\") } #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_col()`). #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_text()`).  if (require(\"ggplot2\") && require(\"dplyr\")) {   # a shorter version which also adjusts data label colours:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(colours = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # it also supports groups (don't forget to use the group var on `x` or `facet`):   example_isolates %>%     filter(mo_is_gram_negative(), ward != \"Outpatient\") %>%     # select only UTI-specific drugs     select(ward, AMX, NIT, FOS, TMP, CIP) %>%     group_by(ward) %>%     ggplot_sir(       x = \"ward\",       facet = \"antibiotic\",       nrow = 1,       title = \"AMR of Anti-UTI Drugs Per Ward\",       x.title = \"Ward\",       datalabels = FALSE     ) } #> ℹ Using column 'mo' as input for mo_is_gram_negative()  # }"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":null,"dir":"Reference","previous_headings":"","what":"Guess Antibiotic Column — guess_ab_col","title":"Guess Antibiotic Column — guess_ab_col","text":"tries find column name data set based information antimicrobials data set. Also supports WHONET abbreviations.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"guess_ab_col(x = NULL, search_string = NULL, verbose = FALSE,   only_sir_columns = FALSE)"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Guess Antibiotic Column — guess_ab_col","text":"x data.frame. search_string text search x , checked .ab() value column x. verbose logical indicate whether additional info printed. only_sir_columns logical indicate whether antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE).","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Guess Antibiotic Column — guess_ab_col","text":"column name x, NULL result found.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Guess Antibiotic Column — guess_ab_col","text":"can look antibiotic (trade) name abbreviation search x antimicrobials data set column containing name code antibiotic.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"df <- data.frame(   amox = \"S\",   tetr = \"R\" )  guess_ab_col(df, \"amoxicillin\") #> [1] \"amox\" guess_ab_col(df, \"J01AA07\") # ATC code of tetracycline #> [1] \"tetr\"  guess_ab_col(df, \"J01AA07\", verbose = TRUE) #> Auto-guessing columns suitable for analysis #> ... #>  OK. #> ℹ Using column 'amox' as input for AMX (amoxicillin). #> ℹ Using column 'tetr' as input for TCY (tetracycline). #> ℹ Using column 'tetr' as input for J01AA07 (tetracycline). #> [1] \"tetr\"  # WHONET codes df <- data.frame(   AMP_ND10 = \"R\",   AMC_ED20 = \"S\" ) guess_ab_col(df, \"ampicillin\") #> [1] \"AMP_ND10\" guess_ab_col(df, \"J01CR02\") #> [1] \"AMC_ED20\" guess_ab_col(df, \"augmentin\") #> [1] \"AMC_ED20\""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Data set containing 'EUCAST Expected Resistant Phenotypes' bug-drug combinations microorganisms antimicrobials data sets.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant"},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"tibble 271 905 observations 2 variables: mo Microorganism ID occurs microorganisms$mo. Names can retrieved using mo_name(). ab Antimicrobial ID occurs antimicrobials$ab. Names can retrieved using ab_name().","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"data set currently based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). data set internally used : not_intrinsic_resistant() (antimicrobial selector) mo_is_intrinsic_resistant()","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant #> # A tibble: 271,905 × 2 #>    mo          ab   #>    <mo>        <ab> #>  1 B_GRAMP     ATM  #>  2 B_GRAMP     COL  #>  3 B_GRAMP     NAL  #>  4 B_GRAMP     PLB  #>  5 B_GRAMP     TEM  #>  6 B_ANAER-POS ATM  #>  7 B_ANAER-POS COL  #>  8 B_ANAER-POS NAL  #>  9 B_ANAER-POS PLB  #> 10 B_ANAER-POS TEM  #> # ℹ 271,895 more rows"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":null,"dir":"Reference","previous_headings":"","what":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"According binomial nomenclature, lowest four taxonomic levels (family, genus, species, subspecies) printed italics. function finds taxonomic names within strings makes italic.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))  italicize_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"string character (vector). type Type conversion taxonomic names, either \"markdown\", \"html\" \"ansi\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"function finds taxonomic names makes italic based microorganisms data set. taxonomic names can italicised using markdown (default) adding * taxonomic names, <> <\/> using html. using 'ansi', ANSI colours added using \\033[3m \\033[23m taxonomic names. multiple ANSI colours available, conversion occur. function also supports abbreviation genus followed species, \"E. coli\" \"K. pneumoniae ozaenae\".","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(\"An overview of Staphylococcus aureus isolates\") #> [1] \"An overview of *Staphylococcus aureus* isolates\" italicise_taxonomy(\"An overview of S. aureus isolates\") #> [1] \"An overview of *S. aureus* isolates\"  cat(italicise_taxonomy(\"An overview of S. aureus isolates\", type = \"ansi\")) #> An overview of S. aureus isolates"},{"path":"https://amr-for-r.org/reference/join.html","id":null,"dir":"Reference","previous_headings":"","what":"Join microorganisms to a Data Set — join","title":"Join microorganisms to a Data Set — join","text":"Join data set microorganisms easily existing data set character vector.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join microorganisms to a Data Set — join","text":"","code":"inner_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  left_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  right_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  full_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  semi_join_microorganisms(x, by = NULL, ...)  anti_join_microorganisms(x, by = NULL, ...)"},{"path":"https://amr-for-r.org/reference/join.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join microorganisms to a Data Set — join","text":"x Existing data set join, character vector. case character vector, resulting data.frame contain column 'x' values. variable join - left empty search column class mo (created .mo()) \"mo\" column name exists x, otherwise column name x values exist microorganisms$mo (= \"bacteria_id\"), another column microorganisms (named, like = c(\"bacteria_id\" = \"fullname\")). suffix non-joined duplicate variables x y, suffixes added output disambiguate . character vector length 2. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join microorganisms to a Data Set — join","text":"data.frame","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Join microorganisms to a Data Set — join","text":"Note: opposed join() functions dplyr, character vectors supported default existing columns get suffix \"2\" newly joined columns get suffix. dplyr package installed, join functions used. Otherwise, much slower merge() interaction() functions base R used.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Join microorganisms to a Data Set — join","text":"","code":"left_join_microorganisms(as.mo(\"K. pneumoniae\")) #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list> left_join_microorganisms(\"B_KLBSL_PNMN\") #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>  df <- data.frame(   date = seq(     from = as.Date(\"2018-01-01\"),     to = as.Date(\"2018-01-07\"),     by = 1   ),   bacteria = as.mo(c(     \"S. aureus\", \"MRSA\", \"MSSA\", \"STAAUR\",     \"E. coli\", \"E. coli\", \"E. coli\"   )),   stringsAsFactors = FALSE ) colnames(df) #> [1] \"date\"     \"bacteria\"  df_joined <- left_join_microorganisms(df, \"bacteria\") colnames(df_joined) #>  [1] \"date\"                \"bacteria\"            \"fullname\"            #>  [4] \"status\"              \"kingdom\"             \"phylum\"              #>  [7] \"class\"               \"order\"               \"family\"              #> [10] \"genus\"               \"species\"             \"subspecies\"          #> [13] \"rank\"                \"ref\"                 \"oxygen_tolerance\"    #> [16] \"source\"              \"lpsn\"                \"lpsn_parent\"         #> [19] \"lpsn_renamed_to\"     \"mycobank\"            \"mycobank_parent\"     #> [22] \"mycobank_renamed_to\" \"gbif\"                \"gbif_parent\"         #> [25] \"gbif_renamed_to\"     \"prevalence\"          \"snomed\"               # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     left_join_microorganisms() %>%     colnames() } #> Joining, by = \"mo\" #>  [1] \"date\"                \"patient\"             \"age\"                 #>  [4] \"gender\"              \"ward\"                \"mo\"                  #>  [7] \"PEN\"                 \"OXA\"                 \"FLC\"                 #> [10] \"AMX\"                 \"AMC\"                 \"AMP\"                 #> [13] \"TZP\"                 \"CZO\"                 \"FEP\"                 #> [16] \"CXM\"                 \"FOX\"                 \"CTX\"                 #> [19] \"CAZ\"                 \"CRO\"                 \"GEN\"                 #> [22] \"TOB\"                 \"AMK\"                 \"KAN\"                 #> [25] \"TMP\"                 \"SXT\"                 \"NIT\"                 #> [28] \"FOS\"                 \"LNZ\"                 \"CIP\"                 #> [31] \"MFX\"                 \"VAN\"                 \"TEC\"                 #> [34] \"TCY\"                 \"TGC\"                 \"DOX\"                 #> [37] \"ERY\"                 \"CLI\"                 \"AZM\"                 #> [40] \"IPM\"                 \"MEM\"                 \"MTR\"                 #> [43] \"CHL\"                 \"COL\"                 \"MUP\"                 #> [46] \"RIF\"                 \"fullname\"            \"status\"              #> [49] \"kingdom\"             \"phylum\"              \"class\"               #> [52] \"order\"               \"family\"              \"genus\"               #> [55] \"species\"             \"subspecies\"          \"rank\"                #> [58] \"ref\"                 \"oxygen_tolerance\"    \"source\"              #> [61] \"lpsn\"                \"lpsn_parent\"         \"lpsn_renamed_to\"     #> [64] \"mycobank\"            \"mycobank_parent\"     \"mycobank_renamed_to\" #> [67] \"gbif\"                \"gbif_parent\"         \"gbif_renamed_to\"     #> [70] \"prevalence\"          \"snomed\"              # }"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"functions can used determine first weighted isolates considering phenotype isolate selection (see first_isolate()). Using phenotype-based method determine first isolates reliable methods disregard phenotypes.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"key_antimicrobials(x = NULL, col_mo = NULL, universal = c(\"ampicillin\",   \"amoxicillin/clavulanic acid\", \"cefuroxime\", \"piperacillin/tazobactam\",   \"ciprofloxacin\", \"trimethoprim/sulfamethoxazole\"),   gram_negative = c(\"gentamicin\", \"tobramycin\", \"colistin\", \"cefotaxime\",   \"ceftazidime\", \"meropenem\"), gram_positive = c(\"vancomycin\", \"teicoplanin\",   \"tetracycline\", \"erythromycin\", \"oxacillin\", \"rifampin\"),   antifungal = c(\"anidulafungin\", \"caspofungin\", \"fluconazole\", \"miconazole\",   \"nystatin\", \"voriconazole\"), only_sir_columns = FALSE, ...)  all_antimicrobials(x = NULL, only_sir_columns = FALSE, ...)  antimicrobials_equal(y, z, type = c(\"points\", \"keyantimicrobials\"),   ignore_I = TRUE, points_threshold = 2, ...)"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank determine automatically. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). universal Names broad-spectrum antimicrobial drugs, case-insensitive. Set NULL ignore. See Details default antimicrobial drugs. gram_negative Names antibiotic drugs Gram-positives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. gram_positive Names antibiotic drugs Gram-negatives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. antifungal Names antifungal drugs fungi, case-insensitive. Set NULL ignore. See Details default antifungal drugs. only_sir_columns logical indicate whether columns must included transformed class sir (see .sir()) beforehand (default FALSE). ... Ignored, place allow future extensions. y, z character vectors compare. type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"key_antimicrobials() all_antimicrobials() functions context-aware. means x argument can left blank used inside data.frame call, see Examples. function key_antimicrobials() returns character vector 12 antimicrobial results every isolate. function all_antimicrobials() returns character vector antimicrobial drug results every isolate. vectors can compared using antimicrobials_equal(), check two isolates generally antibiogram. Missing invalid values replaced dot (\".\") key_antimicrobials() ignored antimicrobials_equal(). Please see first_isolate() function important functions enable 'phenotype-based' method determination first isolates. default antimicrobial drugs used rows (set universal) : Ampicillin Amoxicillin/clavulanic acid Cefuroxime Ciprofloxacin Piperacillin/tazobactam Trimethoprim/sulfamethoxazole default antimicrobial drugs used Gram-negative bacteria (set gram_negative) : Cefotaxime Ceftazidime Colistin Gentamicin Meropenem Tobramycin default antimicrobial drugs used Gram-positive bacteria (set gram_positive) : Erythromycin Oxacillin Rifampin Teicoplanin Tetracycline Vancomycin default antimicrobial drugs used fungi (set antifungal) : Anidulafungin Caspofungin Fluconazole Miconazole Nystatin Voriconazole","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # output of the `key_antimicrobials()` function could be like this: strainA <- \"SSSRR.S.R..S\" strainB <- \"SSSIRSSSRSSS\"  # those strings can be compared with: antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\") #> [1] TRUE # TRUE, because I is ignored (as well as missing values)  antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\", ignore_I = FALSE) #> [1] FALSE # FALSE, because I is not ignored and so the 4th [character] differs  # \\donttest{ if (require(\"dplyr\")) {   # set key antimicrobials to a new variable   my_patients <- example_isolates %>%     mutate(keyab = key_antimicrobials(antifungal = NULL)) %>% # no need to define `x`     mutate(       # now calculate first isolates       first_regular = first_isolate(col_keyantimicrobials = FALSE),       # and first WEIGHTED isolates       first_weighted = first_isolate(col_keyantimicrobials = \"keyab\")     )    # Check the difference in this data set, 'weighted' results in more isolates:   sum(my_patients$first_regular, na.rm = TRUE)   sum(my_patients$first_weighted, na.rm = TRUE) } #> [1] 1383 # }"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":null,"dir":"Reference","previous_headings":"","what":"Kurtosis of the Sample — kurtosis","title":"Kurtosis of the Sample — kurtosis","text":"Kurtosis measure \"tailedness\" probability distribution real-valued random variable. normal distribution kurtosis 3 excess kurtosis 0.","code":""},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(x, na.rm = FALSE, excess = FALSE)  # Default S3 method kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'matrix' kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'data.frame' kurtosis(x, na.rm = FALSE, excess = FALSE)"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Kurtosis of the Sample — kurtosis","text":"x vector values, matrix data.frame. na.rm logical indicate whether NA values stripped computation proceeds. excess logical indicate whether excess kurtosis returned, defined kurtosis minus 3.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(rnorm(10000)) #> [1] 3.032783 kurtosis(rnorm(10000), excess = TRUE) #> [1] 0.05102003"},{"path":"https://amr-for-r.org/reference/like.html","id":null,"dir":"Reference","previous_headings":"","what":"Vectorised Pattern Matching with Keyboard Shortcut — like","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Convenient wrapper around grepl() match pattern: x %like% pattern. always returns logical vector always case-insensitive (use x %like_case% pattern case-sensitive matching). Also, pattern can long x compare items index vectors, can length iterate cases.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"like(x, pattern, ignore.case = TRUE)  x %like% pattern  x %unlike% pattern  x %like_case% pattern  x %unlike_case% pattern"},{"path":"https://amr-for-r.org/reference/like.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Idea like function data.table package, although altered explained Details.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"x character vector matches sought, object can coerced .character() character vector. pattern character vector containing regular expressions (character string fixed = TRUE) matched given character vector. Coerced .character() character string possible. ignore.case FALSE, pattern matching case sensitive TRUE, case ignored matching.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"like() %like%/%unlike% functions: case-insensitive (use %like_case%/%unlike_case% case-sensitive matching) Support multiple patterns Check pattern valid regular expression sets fixed = TRUE , greatly improve speed (vectorised pattern) Always use compatibility Perl unless fixed = TRUE, greatly improve speed Using RStudio? %like%/%unlike% functions can also directly inserted code Addins menu can keyboard shortcut like Shift+Ctrl+L Shift+Cmd+L (see menu Tools > Modify Keyboard Shortcuts...). keep pressing shortcut, inserted text iterated %like% -> %unlike% -> %like_case% -> %unlike_case%.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"# data.table has a more limited version of %like%, so unload it: try(detach(\"package:data.table\", unload = TRUE), silent = TRUE)  a <- \"This is a test\" b <- \"TEST\" a %like% b #> [1] TRUE b %like% a #> [1] FALSE  # also supports multiple patterns a <- c(\"Test case\", \"Something different\", \"Yet another thing\") b <- c(\"case\", \"diff\", \"yet\") a %like% b #> [1] TRUE TRUE TRUE a %unlike% b #> [1] FALSE FALSE FALSE  a[1] %like% b #> [1]  TRUE FALSE FALSE a %like% b[1] #> [1]  TRUE FALSE FALSE  # \\donttest{ # get isolates whose name start with 'Entero' (case-insensitive) example_isolates[which(mo_name() %like% \"^entero\"), ] #> ℹ Using column 'mo' as input for mo_name() #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_name() %like% \"^ent\") } #> ℹ Using column 'mo' as input for mo_name() #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/mdro.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Determine isolates multidrug-resistant organisms (MDRO) according international, national, custom guidelines.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"mdro(x = NULL, guideline = \"CMI2012\", col_mo = NULL, esbl = NA,   carbapenemase = NA, mecA = NA, mecC = NA, vanA = NA, vanB = NA,   info = interactive(), pct_required_classes = 0.5, combine_SI = TRUE,   verbose = FALSE, only_sir_columns = FALSE, ...)  custom_mdro_guideline(..., as_factor = TRUE)  brmo(x = NULL, only_sir_columns = FALSE, ...)  mrgn(x = NULL, only_sir_columns = FALSE, verbose = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = FALSE, verbose = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = FALSE, verbose = FALSE, ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = FALSE,   verbose = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/mdro.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"See supported guidelines list publications used function.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank automatic determination. guideline specific guideline follow, see sections Supported international / national guidelines Using Custom Guidelines . left empty, publication Magiorakos et al. (see ) followed. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). esbl logical values, column name containing logical values, indicating presence ESBL gene (production proteins). carbapenemase logical values, column name containing logical values, indicating presence carbapenemase gene (production proteins). mecA logical values, column name containing logical values, indicating presence mecA gene (production proteins). mecC logical values, column name containing logical values, indicating presence mecC gene (production proteins). vanA logical values, column name containing logical values, indicating presence vanA gene (production proteins). vanB logical values, column name containing logical values, indicating presence vanB gene (production proteins). info logical indicate whether progress printed console - default print interactive sessions. pct_required_classes Minimal required percentage antimicrobial classes must available per isolate, rounded . example, default guideline, 17 antimicrobial classes must available S. aureus. Setting pct_required_classes argument 0.5 (default) means every S. aureus isolate least 8 different classes must available. lower number available classes return NA isolate. combine_SI logical indicate whether values S must merged one, resistance considered isolates R, . default behaviour mdro() function, follows redefinition EUCAST interpretation (increased exposure) 2019, see section 'Interpretation S, R' . using combine_SI = FALSE, resistance considered isolates R . verbose logical turn Verbose mode (default ). Verbose mode, function return MDRO results, instead returns data set logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antimicrobial columns must detected transformed class sir (see .sir()) beforehand (default FALSE). ... case custom_mdro_guideline(): set rules, see section Using Custom Guidelines . Otherwise: column name antibiotic, see section Antimicrobials . as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"CMI 2012 paper - function mdr_cmi2012() mdro(): Ordered factor levels Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant (XDR) < Pandrug-resistant (PDR) TB guideline - function mdr_tb() mdro(..., guideline = \"TB\"): Ordered factor levels Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant < Extensively drug-resistant German guideline - function mrgn() mdro(..., guideline = \"MRGN\"): Ordered factor levels Negative < 3MRGN < 4MRGN Everything else, except custom guidelines: Ordered factor levels Negative < Positive, unconfirmed < Positive. value \"Positive, unconfirmed\" means , according guideline, entirely sure isolate multi-drug resistant confirmed additional (e.g. molecular) tests","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"functions context-aware. means x argument can left blank used inside data.frame call, see Examples. pct_required_classes argument, values 1 divided 100. support fractions (0.75 3/4) percentages (75). Note: Every test involves Enterobacteriaceae family, internally performed using newly named order Enterobacterales, since Enterobacteriaceae family taxonomically reclassified Adeolu et al. 2016. , Enterobacteriaceae family Enterobacteriales () order. species old Enterobacteriaceae family still new Enterobacterales (without ) order, divided multiple families. way tests performed now mdro() function makes sure results 2016 2016 identical.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"supported-international-national-guidelines","dir":"Reference","previous_headings":"","what":"Supported International / National Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. \"Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.\" Clinical Microbiology Infection (2012) (doi:10.1111/j.1469-0691.2011.03570.x ) guideline = \"EUCAST3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.2\" European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 \"Intrinsic Resistance Exceptional Phenotypes Tables\" (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization \"Companion handbook guidelines programmatic management drug-resistant tuberculosis\" (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7; doi:10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Samenwerkingverband Richtlijnen Infectiepreventie (SRI) (2024) \"Bijzonder Resistente Micro-Organismen (BRMO)\" (link) Also: guideline = \"BRMO 2017\" former Dutch national guideline - Werkgroep Infectiepreventie (WIP), RIVM, last revision 2017: \"Bijzonder Resistente Micro-Organismen (BRMO)\" Please suggest implement guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"using-custom-guidelines","dir":"Reference","previous_headings":"","what":"Using Custom Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   row/isolate matches first rule, value first ~ (case 'Elderly Type ') set MDRO value. Otherwise, second rule tried . number rules unlimited. can print rules set console overview. Colours help reading console supports colours.   outcome function can used guideline argument mdro() function:   Rules can also combined custom rules using c():   rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(CIP == \"R\" & age > 60 ~ \"Elderly Type A\",                                 ERY == \"R\" & age > 60 ~ \"Elderly Type B\") custom #> A set of custom MDRO rules: #>   1. CIP is \"R\" and age is higher than 60 -> Elderly Type A #>   2. ERY is \"R\" and age is higher than 60 -> Elderly Type B #>   3. Otherwise -> Negative #> #> Unmatched rows will return NA. x <- mdro(example_isolates,           guideline = custom) table(x) #>       Negative Elderly Type A Elderly Type B #>           1070            198            732 x <- mdro(example_isolates,           guideline = c(custom,                         custom_mdro_guideline(ERY == \"R\" & age > 50 ~ \"Elderly Type C\"))) table(x) #>       Negative Elderly Type A Elderly Type B Elderly Type C #>            961            198            732            109"},{"path":"https://amr-for-r.org/reference/mdro.html","id":"antimicrobials","dir":"Reference","previous_headings":"","what":"Antimicrobials","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"define antimicrobials column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antimicrobials eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), bleomycin (BLM, L01DC01), brodimoprim (BDP, J01EA02), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), carumonam (CAR, J01DF02), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefepime/amikacin (CFA, J01RA06), cefetamet (CAT, J01DD10), cefiderocol (FDC, J01DI04), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), chlortetracycline (CTE, J01AA03), ciprofloxacin (CIP, J01MA02), ciprofloxacin/metronidazole (CIM, J01RA10), ciprofloxacin/ornidazole (CIO, J01RA12), ciprofloxacin/tinidazole (CIT, J01RA11), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), clomocycline (CLM1, J01AA11), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), demeclocycline (DEM, J01AA01), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), eravacycline (ERV, J01AA13), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levofloxacin/ornidazole (LEO, J01RA05), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), lymecycline (LYM, J01AA04), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metacycline (MTC, J01AA05), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), nemonoxacin (NEM, J01MB08), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), nitroxoline (NTR, J01XX07), norfloxacin (, J01MA06), norfloxacin/metronidazole (NME, J01RA14), norfloxacin/tinidazole (NTI, J01RA13), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), ofloxacin/ornidazole (OOR, J01RA09), oleandomycin (OLE, J01FA05), omadacycline (OMC, J01AA15), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), oxytetracycline (OXY, J01AA06), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), penimepicycline (PNM1, J01AA10), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), rolitetracycline (RLT, J01AA09), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sarecycline (SRC, J01AA14), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/tetroxoprim (SLT, J01EE06), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"out <- mdro(example_isolates, guideline = \"EUCAST\") str(out) #>  Ord.factor w/ 3 levels \"Negative\"<\"Positive, unconfirmed\"<..: 1 1 1 1 1 1 1 1 1 1 ... table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1994                     0                     6   out <- mdro(example_isolates,   guideline = custom_mdro_guideline(     AMX == \"R\" ~ \"Custom MDRO 1\",     VAN == \"R\" ~ \"Custom MDRO 2\"   ) ) table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>           870           804           326   # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     mdro() %>%     table()    # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     pull(MDRO) %>%     table() } #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `MDRO = mdro()`. #> Caused by warning: #> ! in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> . #>                         Negative       Multi-drug-resistant (MDR)  #>                             1617                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0  # }"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Mean AMR Distance — mean_amr_distance","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Calculates normalised mean antimicrobial resistance multiple observations, help identify similar isolates without comparing antibiograms hand.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"mean_amr_distance(x, ...)  # S3 method for class 'sir' mean_amr_distance(x, ..., combine_SI = TRUE)  # S3 method for class 'data.frame' mean_amr_distance(x, ..., combine_SI = TRUE)  amr_distance_from_row(amr_distance, row)"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"x vector class sir, mic disk, data.frame containing columns classes. ... Variables select. Supports tidyselect language (column1:column4 (.mic)), can thus also antimicrobial selectors. combine_SI logical indicate whether values S, SDD, must merged one, input consists S+vs. R (susceptible vs. resistant) - default TRUE. amr_distance outcome mean_amr_distance(). row index, row number.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"mean AMR distance effectively Z-score; normalised numeric value compare AMR test results can help identify similar isolates, without comparing antibiograms hand. MIC values (see .mic()) transformed log2() first; distance thus calculated (log2(x) - mean(log2(x))) / sd(log2(x)). SIR values (see .sir()) transformed using \"S\" = 1, \"\" = 2, \"R\" = 3. combine_SI TRUE (default), \"\" considered 1. data sets, mean AMR distance calculated per column, mean per row returned, see Examples. Use amr_distance_from_row() subtract distances distance one row, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"interpretation","dir":"Reference","previous_headings":"","what":"Interpretation","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Isolates distances less 0.01 difference considered similar. Differences lower 0.025 considered suspicious.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"sir <- random_sir(10) sir #> Class 'sir' #>  [1] S S I I I R R S I S mean_amr_distance(sir) #>  [1] -0.4743416 -0.4743416 -0.4743416 -0.4743416 -0.4743416  1.8973666 #>  [7]  1.8973666 -0.4743416 -0.4743416 -0.4743416  mic <- random_mic(10) mic #> Class 'mic' #>  [1] >=128   0.125   0.01    64      64      8       0.002   1       >=128   #> [10] <=0.001 mean_amr_distance(mic) #>  [1]  1.02853908 -0.44976893 -0.98844311  0.88070828  0.88070828  0.43721587 #>  [7] -1.33169561 -0.00627653  1.02853908 -1.47952641 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1]  1.02853908 -0.44976893 -0.98844311  0.88070828  0.88070828  0.43721587 #>  [7] -1.33169561 -0.00627653  1.02853908 -1.47952641  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 39 35 46 27 13 50 30 49 41 20 mean_amr_distance(disk) #>  [1]  0.3216338  0.0000000  0.8844928 -0.6432675 -1.7689857  1.2061266 #>  [7] -0.4020422  1.1257182  0.4824506 -1.2061266  y <- data.frame(   id = LETTERS[1:10],   amox = random_sir(10, ab = \"amox\", mo = \"Escherichia coli\"),   cipr = random_disk(10, ab = \"cipr\", mo = \"Escherichia coli\"),   gent = random_mic(10, ab = \"gent\", mo = \"Escherichia coli\"),   tobr = random_mic(10, ab = \"tobr\", mo = \"Escherichia coli\") ) y #>    id amox cipr gent tobr #> 1   A    R   23  >=4    1 #> 2   B    I   26  <=1  0.5 #> 3   C    S   20  >=4 >=16 #> 4   D    R   27  >=4  0.5 #> 5   E    S   31  >=4    2 #> 6   F    I   27  >=4 >=16 #> 7   G    I   31  <=1    8 #> 8   H    R   30  >=4    4 #> 9   I    S   27  >=4    4 #> 10  J    I   20  >=4  0.5 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.12237407 -0.92897174 -0.07982527  0.24282355  0.22020411  0.34940813 #>  [7] -0.12306945  0.80126097  0.09975463 -0.70395902 y$amr_distance <- mean_amr_distance(y, is.mic(y)) #> ℹ Calculating mean AMR distance based on columns \"gent\" and \"tobr\" y[order(y$amr_distance), ] #>    id amox cipr gent tobr amr_distance #> 2   B    I   26  <=1  0.5  -1.52288635 #> 7   G    I   31  <=1    8  -0.52427235 #> 4   D    R   27  >=4  0.5  -0.33703222 #> 10  J    I   20  >=4  0.5  -0.33703222 #> 1   A    R   23  >=4    1  -0.08737872 #> 5   E    S   31  >=4    2   0.16227477 #> 8   H    R   30  >=4    4   0.41192827 #> 9   I    S   27  >=4    4   0.41192827 #> 3   C    S   20  >=4 >=16   0.91123527 #> 6   F    I   27  >=4 >=16   0.91123527  if (require(\"dplyr\")) {   y %>%     mutate(       amr_distance = mean_amr_distance(y),       check_id_C = amr_distance_from_row(amr_distance, id == \"C\")     ) %>%     arrange(check_id_C) } #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>    id amox cipr gent tobr amr_distance check_id_C #> 1   C    S   20  >=4 >=16  -0.07982527 0.00000000 #> 2   G    I   31  <=1    8  -0.12306945 0.04324419 #> 3   I    S   27  >=4    4   0.09975463 0.17957990 #> 4   A    R   23  >=4    1   0.12237407 0.20219934 #> 5   E    S   31  >=4    2   0.22020411 0.30002938 #> 6   D    R   27  >=4  0.5   0.24282355 0.32264882 #> 7   F    I   27  >=4 >=16   0.34940813 0.42923340 #> 8   J    I   20  >=4  0.5  -0.70395902 0.62413375 #> 9   B    I   26  <=1  0.5  -0.92897174 0.84914647 #> 10  H    R   30  >=4    4   0.80126097 0.88108624 if (require(\"dplyr\")) {   # support for groups   example_isolates %>%     filter(mo_genus() == \"Enterococcus\" & mo_species() != \"\") %>%     select(mo, TCY, carbapenems()) %>%     group_by(mo) %>%     mutate(dist = mean_amr_distance(.)) %>%     arrange(mo, dist) } #> ℹ Using column 'mo' as input for mo_genus() #> ℹ Using column 'mo' as input for mo_species() #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Calculating mean AMR distance based on columns \"TCY\", \"IPM\", and \"MEM\" #> # A tibble: 63 × 5 #> # Groups:   mo [4] #>    mo           TCY   IPM   MEM     dist #>    <mo>         <sir> <sir> <sir>  <dbl> #>  1 B_ENTRC_AVIM   S     S     NA   0     #>  2 B_ENTRC_AVIM   S     S     NA   0     #>  3 B_ENTRC_CSSL   NA    S     NA  NA     #>  4 B_ENTRC_FACM   S     S     NA  -2.66  #>  5 B_ENTRC_FACM   S     R     R   -0.423 #>  6 B_ENTRC_FACM   S     R     R   -0.423 #>  7 B_ENTRC_FACM   NA    R     R    0.224 #>  8 B_ENTRC_FACM   NA    R     R    0.224 #>  9 B_ENTRC_FACM   NA    R     R    0.224 #> 10 B_ENTRC_FACM   NA    R     R    0.224 #> # ℹ 53 more rows"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"data set containing commonly used codes microorganisms, laboratory systems WHONET. Define set_mo_source(). searched using .mo() consequently mo_* functions.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"tibble 5 063 observations 2 variables: code Commonly used code microorganism. unique identifier. mo ID microorganism microorganisms data set","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 5 063 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 5,063 × 2 #>    code  mo                #>    <chr> <mo>              #>  1 1011  B_GRAMP           #>  2 1012  B_GRAMP           #>  3 1013  B_GRAMN           #>  4 1014  B_GRAMN           #>  5 1015  F_YEAST           #>  6 103   B_ESCHR_COLI      #>  7 104   B_SLMNL_ENTR_ENTR #>  8 1100  B_STRPT           #>  9 1101  B_STRPT_VIRI      #> 10 1102  B_STRPT_HAEM      #> # ℹ 5,053 more rows  # 'ECO' or 'eco' is the WHONET code for E. coli: microorganisms.codes[microorganisms.codes$code == \"ECO\", ] #> # A tibble: 1 × 2 #>   code  mo           #>   <chr> <mo>         #> 1 ECO   B_ESCHR_COLI  # and therefore, 'eco' will be understood as E. coli in this package: mo_info(\"eco\") #> $mo #> [1] \"B_ESCHR_COLI\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Escherichia\" #>  #> $species #> [1] \"coli\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/escherichia-coli\" #>  #> $ref #> [1] \"Castellani et al., 1919\" #>  #> $snomed #>  [1] \"1095001000112106\" \"715307006\"        \"737528008\"        \"416989002\"        #>  [5] \"116397003\"        \"414097009\"        \"414098004\"        \"414099007\"        #>  [9] \"414100004\"        \"116395006\"        \"735270003\"        \"116396007\"        #> [13] \"83285000\"         \"116394005\"        \"112283007\"        \"710886005\"        #> [17] \"710887001\"        \"710888006\"        \"710889003\"        \"414132004\"        #> [21] \"721892009\"        \"416812001\"        \"416740004\"        \"417216001\"        #> [25] \"457541006\"        \"710253004\"        \"416530004\"        \"417189006\"        #> [29] \"409800005\"        \"713925008\"        \"444771000124108\"  \"838549008\"        #>  #> $lpsn #> [1] \"776057\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"11286021\" #>  #> $group_members #> character(0) #>   # works for all AMR functions: mo_is_intrinsic_resistant(\"eco\", ab = \"vancomycin\") #> [1] TRUE"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"data set containing species groups microbiological complexes, used clinical breakpoints table.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"tibble 534 observations 4 variables: mo_group ID species group / microbiological complex mo ID microorganism belonging species group / microbiological complex mo_group_name Name species group / microbiological complex, retrieved mo_name() mo_name Name microorganism belonging species group / microbiological complex, retrieved mo_name()","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups #> # A tibble: 534 × 4 #>    mo_group       mo           mo_group_name                   mo_name           #>    <mo>           <mo>         <chr>                           <chr>             #>  1 B_ACNTB_BMNN-C B_ACNTB_BMNN Acinetobacter baumannii complex Acinetobacter ba… #>  2 B_ACNTB_BMNN-C B_ACNTB_CLCC Acinetobacter baumannii complex Acinetobacter ca… #>  3 B_ACNTB_BMNN-C B_ACNTB_LCTC Acinetobacter baumannii complex Acinetobacter di… #>  4 B_ACNTB_BMNN-C B_ACNTB_NSCM Acinetobacter baumannii complex Acinetobacter no… #>  5 B_ACNTB_BMNN-C B_ACNTB_PITT Acinetobacter baumannii complex Acinetobacter pi… #>  6 B_ACNTB_BMNN-C B_ACNTB_SFRT Acinetobacter baumannii complex Acinetobacter se… #>  7 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex    Bacteroides frag… #>  8 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex    Bacteroides ovat… #>  9 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex    Bacteroides thet… #> 10 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex    Bacteroides vulg… #> # ℹ 524 more rows  # these are all species in the Bacteroides fragilis group, as per WHONET: microorganisms.groups[microorganisms.groups$mo_group == \"B_BCTRD_FRGL-C\", ] #> # A tibble: 5 × 4 #>   mo_group       mo           mo_group_name                mo_name               #>   <mo>           <mo>         <chr>                        <chr>                 #> 1 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex Bacteroides fragilis  #> 2 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex Bacteroides ovatus    #> 3 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex Bacteroides thetaiot… #> 4 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex Bacteroides vulgatus  #> 5 B_BCTRD_FRGL-C B_PRBCT_DSTS Bacteroides fragilis complex Parabacteroides dist…"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"data set containing full microbial taxonomy (last updated: June 24th, 2024) six kingdoms. data set backbone AMR package. MO codes can looked using .mo() microorganism properties can looked using mo_* functions. data set carefully crafted, yet made 100% reproducible public authoritative taxonomic sources (using script), namely: List Prokaryotic names Standing Nomenclature (LPSN) bacteria, MycoBank fungi, Global Biodiversity Information Facility (GBIF) others taxons.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"tibble 78 679 observations 26 variables: mo ID microorganism used package. unique identifier. fullname Full name, like \"Escherichia coli\". taxonomic ranks genus, species subspecies, 'pasted' text genus, species, subspecies. taxonomic ranks higher genus, name taxon. unique identifier. status  Status taxon, either \"accepted\", \"validly published\", \"synonym\", \"unknown\" kingdom, phylum, class, order, family, genus, species, subspecies Taxonomic rank microorganism. Note fungi, phylum equal taxonomic division. Also, fungi, subkingdom subdivision left since occur bacterial taxonomy. rank Text taxonomic rank microorganism, \"species\" \"genus\" ref Author(s) year related scientific publication. contains first surname year latest authors, e.g. \"Wallis et al. 2006 emend. Smith Jones 2018\" becomes \"Smith et al., 2018\". field directly retrieved source specified column source. Moreover, accents removed comply CRAN allows ASCII characters. oxygen_tolerance  Oxygen tolerance, either \"aerobe\", \"anaerobe\", \"anaerobe/microaerophile\", \"facultative anaerobe\", \"likely facultative anaerobe\", \"microaerophile\". data retrieved BacDive (see Source). Items contain \"likely\" missing BacDive extrapolated species within genus guess oxygen tolerance. Currently 68.3% ~39 000 bacteria data set contain oxygen tolerance. source Either \"GBIF\", \"LPSN\", \"Manually added\", \"MycoBank\", \"manually added\" (see Source) lpsn Identifier ('Record number') List Prokaryotic names Standing Nomenclature (LPSN). first/highest LPSN identifier keep one identifier per row. example, Acetobacter ascendens LPSN Record number 7864 11011. first available microorganisms data set. unique identifier, though available ~33 000 records. lpsn_parent LPSN identifier parent taxon lpsn_renamed_to LPSN identifier currently valid taxon mycobank Identifier ('MycoBank #') MycoBank. unique identifier, though available ~18 000 records. mycobank_parent MycoBank identifier parent taxon mycobank_renamed_to MycoBank identifier currently valid taxon gbif Identifier ('taxonID') Global Biodiversity Information Facility (GBIF). unique identifier, though available ~49 000 records. gbif_parent GBIF identifier parent taxon gbif_renamed_to GBIF identifier currently valid taxon prevalence Prevalence microorganism based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ), see mo_matching_score() full explanation snomed Systematized Nomenclature Medicine (SNOMED) code microorganism, version July 16th, 2024 (see Source). Use mo_snomed() retrieve quickly, see mo_property().","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Taxonomic entries imported order importance: List Prokaryotic names Standing Nomenclature (LPSN): Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. MycoBank: Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. Global Biodiversity Information Facility (GBIF): GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Furthermore, sources used additional details: BacDive: Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Systematized Nomenclature Medicine - Clinical Terms (SNOMED-CT): Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). Accessed https://www.cdc.gov/phin/php/phinvads/ July 16th, 2024. Grimont et al. (2007). Antigenic Formulae Salmonella Serovars, 9th Edition. Collaborating Centre Reference Research Salmonella (WHOCC-SALM). Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Please note entries based LPSN, MycoBank, GBIF (see ). Since sources incorporate entries based (recent) publications International Journal Systematic Evolutionary Microbiology (IJSEM), can happen year publication sometimes later one might expect. example, Staphylococcus pettenkoferi described first time Diagnostic Microbiology Infectious Disease 2002 (doi:10.1016/s0732-8893(02)00399-1 ), 2007 publication IJSEM followed (doi:10.1099/ijs.0.64381-0 ). Consequently, AMR package returns 2007 mo_year(\"S. pettenkoferi\").","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"included-taxa","dir":"Reference","previous_headings":"","what":"Included Taxa","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Included taxonomic data LPSN, MycoBank, GBIF : ~39 000 (sub)species kingdoms Archaea Bacteria ~28 000 species kingdom Fungi. kingdom Fungi large taxon almost 300,000 different (sub)species, microbial (rather macroscopic, like mushrooms). , fungi fit scope package. relevant fungi covered (species Aspergillus, Candida, Cryptococcus, Histoplasma, Pneumocystis, Saccharomyces Trichophyton). ~8 100 (sub)species kingdom Protozoa ~1 600 (sub)species 39 relevant genera kingdom Animalia (Strongyloides Taenia) ~22 000 previously accepted names included (sub)species (taxonomically renamed) complete taxonomic tree included (sub)species: kingdom subspecies identifier parent taxons year first author related scientific publication","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"manual-additions","dir":"Reference","previous_headings":"","what":"Manual additions","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"convenience, entries added manually: ~1 500 entries Salmonella, city-like serovars groups H 37 species groups (beta-haemolytic Streptococcus groups K, coagulase-negative Staphylococcus (CoNS), Mycobacterium tuberculosis complex, etc.), group compositions stored microorganisms.groups data set 1 entry Blastocystis (B.  hominis), although officially exist (Noel et al. 2005, PMID 15634993) 1 entry Moraxella (M. catarrhalis), formally named Branhamella catarrhalis (Catlin, 1970) though change never accepted within field clinical microbiology 8 'undefined' entries (unknown, unknown Gram-negatives, unknown Gram-positives, unknown yeast, unknown fungus, unknown anaerobic Gram-pos/Gram-neg bacteria) syntax used transform original data cleansed R format, can found .","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms #> # A tibble: 78,679 × 26 #>    mo          fullname   status kingdom phylum class order family genus species #>    <mo>        <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #>  1 B_GRAMN     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  2 B_GRAMP     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  3 B_ANAER-NEG (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  4 B_ANAER-POS (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  5 B_ANAER     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  6 F_FUNGUS    (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  7   UNKNOWN   (unknown … unkno… (unkno… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  8 P_PROTOZOAN (unknown … unkno… Protoz… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  9 F_YEAST     (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #> 10 F_AABRN     Aabaarnia  unkno… Fungi   Ascom… Leca… Ostr… \"\"     Aaba… \"\"      #> # ℹ 78,669 more rows #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Matching Score for Microorganisms — mo_matching_score","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm used .mo() mo_* functions determine probable match taxonomic records based user input.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_matching_score(x, n)"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"x user input value(s). n full taxonomic name, exists microorganisms$fullname.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm originally developed 2018 subsequently described : Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 . Later, work Bartlett et al. bacterial pathogens infecting humans (2022, doi:10.1099/mic.0.001269 ) incorporated, optimalisations algorithm made.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_reset_session() #> ℹ Reset 17 previously matched input values.  as.mo(\"E. coli\") #> Class 'mo' #> [1] B_ESCHR_COLI mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See ?mo_matching_score. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #>  #> Only the first 10 other matches of each record are shown. Run #> print(mo_uncertainties(), n = ...) to view more entries, or save #> mo_uncertainties() to an object.  mo_matching_score(   x = \"E. coli\",   n = c(\"Escherichia coli\", \"Entamoeba coli\") ) #> [1] 0.6875000 0.3809524"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of a Microorganism — mo_property","title":"Get Properties of a Microorganism — mo_property","text":"Use functions return specific property microorganism based latest accepted taxonomy. input values evaluated internally .mo(), makes possible use microbial abbreviations, codes names input. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of a Microorganism — mo_property","text":"","code":"mo_name(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_fullname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_shortname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_subspecies(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_species(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_genus(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_family(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_order(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_class(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_phylum(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_kingdom(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_domain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_type(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_status(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_pathogenicity(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gramstain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_negative(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_positive(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_yeast(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_intrinsic_resistant(x, ab, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_oxygen_tolerance(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_anaerobic(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_snomed(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_ref(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_authors(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_year(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_lpsn(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_mycobank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gbif(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_rank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_taxonomy(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_synonyms(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_current(x, language = get_AMR_locale(), ...)  mo_group_members(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_info(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_url(x, open = FALSE, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_property(x, property = \"fullname\", language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of a Microorganism — mo_property","text":"x character (vector) can coerced valid microorganism code .mo(). Can left blank auto-guessing column containing microorganism codes used data set, see Examples. language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). ... arguments passed .mo(), 'minimum_matching_score', 'ignore_pattern', 'remove_from_input'. ab (vector ) text can coerced valid antibiotic drug code .ab(). open Browse URL using browseURL(). property One column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\", must \"shortname\".","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of a Microorganism — mo_property","text":"integer case mo_year() ordered factor case mo_pathogenicity() list case mo_taxonomy(), mo_synonyms(), mo_snomed(), mo_info() logical case mo_is_anaerobic(), mo_is_gram_negative(), mo_is_gram_positive(), mo_is_intrinsic_resistant(), mo_is_yeast() named character case mo_synonyms() mo_url() character cases","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of a Microorganism — mo_property","text":"functions , default, keep old taxonomic properties, synonyms automatically replaced current taxonomy. Take example Enterobacter aerogenes, initially named 1960 renamed Klebsiella aerogenes 2017: mo_genus(\"Enterobacter aerogenes\") return \"Klebsiella\" (note renaming) mo_genus(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Enterobacter\" (-per-session warning name outdated) mo_ref(\"Enterobacter aerogenes\") return \"Tindall et al., 2017\" (note renaming) mo_ref(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Hormaeche et al., 1960\" (-per-session warning name outdated) short name (mo_shortname()) returns first character genus full species, \"E. coli\", species subspecies. Exceptions abbreviations staphylococci (\"CoNS\", Coagulase-Negative Staphylococci) beta-haemolytic streptococci (\"GBS\", Group B Streptococci). Please bear mind e.g. E. coli mean Escherichia coli (kingdom Bacteria) well Entamoeba coli (kingdom Protozoa). Returning full name done using .mo() internally, giving priority bacteria human pathogens, .e. \"E. coli\" considered Escherichia coli. result, mo_fullname(mo_shortname(\"Entamoeba coli\")) returns \"Escherichia coli\". Since top-level taxonomy sometimes referred 'kingdom' sometimes 'domain', functions mo_kingdom() mo_domain() return exact results. Determination human pathogenicity (mo_pathogenicity()) strongly based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ). function returns factor levels Pathogenic, Potentially pathogenic, Non-pathogenic, Unknown. Determination Gram stain (mo_gramstain()) based taxonomic kingdom phylum. Originally, Cavalier-Smith defined -called subkingdoms Negibacteria Posibacteria (2002, PMID 11837318), considered phyla Posibacteria: Actinobacteria, Chloroflexi, Firmicutes, Tenericutes. phyla later renamed Actinomycetota, Chloroflexota, Bacillota, Mycoplasmatota (2021, PMID 34694987). Bacteria phyla considered Gram-positive AMR package, except members class Negativicutes (within phylum Bacillota) Gram-negative. bacteria considered Gram-negative. Species outside kingdom Bacteria return value NA. Functions mo_is_gram_negative() mo_is_gram_positive() always return TRUE FALSE (NA input NA MO code UNKNOWN), thus always return FALSE species outside taxonomic kingdom Bacteria. Determination yeasts (mo_is_yeast()) based taxonomic kingdom class. Budding yeasts yeasts reproduce asexually process called budding, new cell develops small protrusion parent cell. Taxonomically, members phylum Ascomycota, class Saccharomycetes (also called Hemiascomycetes) Pichiomycetes. True yeasts quite specifically refers yeasts underlying order Saccharomycetales (Saccharomyces cerevisiae). Thus, microorganisms member taxonomic class Saccharomycetes Pichiomycetes, function return TRUE. returns FALSE otherwise (NA input NA MO code UNKNOWN). Determination intrinsic resistance (mo_is_intrinsic_resistant()) based intrinsic_resistant data set, based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). mo_is_intrinsic_resistant() function can vectorised argument x (input microorganisms) ab (input antimicrobials). Determination bacterial oxygen tolerance (mo_oxygen_tolerance()) based BacDive, see Source. function mo_is_anaerobic() returns TRUE oxygen tolerance \"anaerobe\", indicting obligate anaerobic species genus. always returns FALSE species outside taxonomic kingdom Bacteria. function mo_url() return direct URL online database entry, also shows scientific reference concerned species. MycoBank URL used fungi wherever available , LPSN URL bacteria wherever available, GBIF link otherwise. SNOMED codes (mo_snomed()) last updated July 16th, 2024. See Source microorganisms data set info. Old taxonomic names (-called 'synonyms') can retrieved mo_synonyms() (scientific reference name), current taxonomic name can retrieved mo_current(). functions return full names. output translated possible.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Get Properties of a Microorganism — mo_property","text":"function uses .mo() internally, uses advanced algorithm translate arbitrary user input valid taxonomy using -called matching score. can read public algorithm MO matching score page.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of a Microorganism — mo_property","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of a Microorganism — mo_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of a Microorganism — mo_property","text":"","code":"# taxonomic tree -----------------------------------------------------------  mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_phylum(\"Klebsiella pneumoniae\") #> [1] \"Pseudomonadota\" mo_class(\"Klebsiella pneumoniae\") #> [1] \"Gammaproteobacteria\" mo_order(\"Klebsiella pneumoniae\") #> [1] \"Enterobacterales\" mo_family(\"Klebsiella pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"Klebsiella pneumoniae\") #> [1] \"pneumoniae\" mo_subspecies(\"Klebsiella pneumoniae\") #> [1] \"\"   # full names and short names -----------------------------------------------  mo_name(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_fullname(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_shortname(\"Klebsiella pneumoniae\") #> [1] \"K. pneumoniae\"   # other properties ---------------------------------------------------------  mo_pathogenicity(\"Klebsiella pneumoniae\") #> [1] Pathogenic #> Levels: Pathogenic < Potentially pathogenic < Non-pathogenic < Unknown mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\" mo_snomed(\"Klebsiella pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_rank(\"Klebsiella pneumoniae\") #> [1] \"species\" mo_url(\"Klebsiella pneumoniae\") #>                                Klebsiella pneumoniae  #> \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\"  mo_is_yeast(c(\"Candida\", \"Trichophyton\", \"Klebsiella\")) #> [1]  TRUE FALSE FALSE  mo_group_members(c(   \"Streptococcus group A\",   \"Streptococcus group C\",   \"Streptococcus group G\",   \"Streptococcus group L\" )) #> $`Streptococcus Group A` #> [1] \"Streptococcus pyogenes\" #>  #> $`Streptococcus Group C` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #> [4] \"Streptococcus equi\"                      #> [5] \"Streptococcus equi equi\"                 #> [6] \"Streptococcus equi ruminatorum\"          #> [7] \"Streptococcus equi zooepidemicus\"        #>  #> $`Streptococcus Group G` #> [1] \"Streptococcus canis\"                     #> [2] \"Streptococcus dysgalactiae\"              #> [3] \"Streptococcus dysgalactiae dysgalactiae\" #> [4] \"Streptococcus dysgalactiae equisimilis\"  #>  #> $`Streptococcus Group L` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #>    # scientific reference -----------------------------------------------------  mo_ref(\"Klebsiella aerogenes\") #> [1] \"Tindall et al., 2017\" mo_authors(\"Klebsiella aerogenes\") #> [1] \"Tindall et al.\" mo_year(\"Klebsiella aerogenes\") #> [1] 2017 mo_synonyms(\"Klebsiella aerogenes\") #>   Hormaeche et al., 1960     Bascomb et al., 1971  #> \"Enterobacter aerogenes\"     \"Klebsiella mobilis\"  mo_lpsn(\"Klebsiella aerogenes\") #> [1] \"777146\" mo_gbif(\"Klebsiella aerogenes\") #> [1] \"9281703\" mo_mycobank(\"Candida albicans\") #> [1] \"256187\" mo_mycobank(\"Candida krusei\") #> [1] \"337013\" mo_mycobank(\"Candida krusei\", keep_synonyms = TRUE) #> Warning: Function as.mo() returned one old taxonomic name. Use as.mo(..., #> keep_synonyms = FALSE) to clean the input to currently accepted taxonomic #> names, or set the R option AMR_keep_synonyms to FALSE. This warning #> will be shown once per session. #> [1] \"268707\"   # abbreviations known in the field -----------------------------------------  mo_genus(\"MRSA\") #> [1] \"Staphylococcus\" mo_species(\"MRSA\") #> [1] \"aureus\" mo_shortname(\"VISA\") #> [1] \"S. aureus\" mo_gramstain(\"VISA\") #> [1] \"Gram-positive\"  mo_genus(\"EHEC\") #> [1] \"Escherichia\" mo_species(\"EIEC\") #> [1] \"coli\" mo_name(\"UPEC\") #> [1] \"Escherichia coli\"   # known subspecies ---------------------------------------------------------  mo_fullname(\"K. pneu rh\") #> [1] \"Klebsiella pneumoniae rhinoscleromatis\" mo_shortname(\"K. pneu rh\") #> [1] \"K. pneumoniae\"  # \\donttest{ # Becker classification, see ?as.mo ----------------------------------------  mo_fullname(\"Staph epidermidis\") #> [1] \"Staphylococcus epidermidis\" mo_fullname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"Coagulase-negative Staphylococcus (CoNS)\" mo_shortname(\"Staph epidermidis\") #> [1] \"S. epidermidis\" mo_shortname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"CoNS\"   # Lancefield classification, see ?as.mo ------------------------------------  mo_fullname(\"Strep agalactiae\") #> [1] \"Streptococcus agalactiae\" mo_fullname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"Streptococcus Group B\" mo_shortname(\"Strep agalactiae\") #> [1] \"S. agalactiae\" mo_shortname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"GBS\"   # language support  --------------------------------------------------------  mo_gramstain(\"Klebsiella pneumoniae\", language = \"de\") # German #> [1] \"Gramnegativ\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"nl\") # Dutch #> [1] \"Gram-negatief\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"es\") # Spanish #> [1] \"Gram negativo\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"el\") # Greek #> [1] \"Αρνητικό κατά Gram\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"uk\") # Ukrainian #> [1] \"Грамнегативні\"  # mo_type is equal to mo_kingdom, but mo_kingdom will remain untranslated mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_kingdom(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, no effect #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, translated #> [1] \"细菌\"  mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"de\") #> [1] \"Streptococcus Gruppe A\" mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"uk\") #> [1] \"Streptococcus Група A\"   # other --------------------------------------------------------------------  # gram stains and intrinsic resistance can be used as a filter in dplyr verbs if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_gram_positive()) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for mo_is_gram_positive() #> ℹ Using column 'mo' as input for mo_genus() #> # A tibble: 18 × 2 #>    `mo_genus()`        n #>    <chr>           <int> #>  1 Staphylococcus    840 #>  2 Streptococcus     275 #>  3 Enterococcus       83 #>  4 Corynebacterium    17 #>  5 Micrococcus         6 #>  6 Gemella             3 #>  7 Aerococcus          2 #>  8 Cutibacterium       1 #>  9 Dermabacter         1 #> 10 Fusibacter          1 #> 11 Globicatella        1 #> 12 Granulicatella      1 #> 13 Lactobacillus       1 #> 14 Leuconostoc         1 #> 15 Listeria            1 #> 16 Paenibacillus       1 #> 17 Rothia              1 #> 18 Schaalia            1 if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_intrinsic_resistant(ab = \"vanco\")) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for mo_is_intrinsic_resistant() #> ℹ Using column 'mo' as input for mo_genus() #> # A tibble: 19 × 2 #>    `mo_genus()`         n #>    <chr>            <int> #>  1 Escherichia        467 #>  2 Klebsiella          77 #>  3 Proteus             39 #>  4 Pseudomonas         30 #>  5 Serratia            25 #>  6 Enterobacter        23 #>  7 Citrobacter         11 #>  8 Haemophilus          9 #>  9 Acinetobacter        6 #> 10 Morganella           6 #> 11 Pantoea              4 #> 12 Salmonella           3 #> 13 Neisseria            2 #> 14 Stenotrophomonas     2 #> 15 Campylobacter        1 #> 16 Enterococcus         1 #> 17 Hafnia               1 #> 18 Leuconostoc          1 #> 19 Pseudescherichia     1  # get a list with the complete taxonomy (from kingdom to subspecies) mo_taxonomy(\"Klebsiella pneumoniae\") #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>   # get a list with the taxonomy, the authors, Gram-stain, # SNOMED codes, and URL to the online database mo_info(\"Klebsiella pneumoniae\") #> $mo #> [1] \"B_KLBSL_PNMN\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\" #>  #> $ref #> [1] \"Trevisan, 1887\" #>  #> $snomed #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  #> $lpsn #> [1] \"777151\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"3221874\" #>  #> $group_members #> character(0) #>  # }"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":null,"dir":"Reference","previous_headings":"","what":"User-Defined Reference Data Set for Microorganisms — mo_source","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"functions can used predefine reference used .mo() consequently mo_* functions (mo_genus() mo_gramstain()). fastest way organisation (analysis) specific codes picked translated package, since bother setting .","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"","code":"set_mo_source(path, destination = getOption(\"AMR_mo_source\",   \"~/mo_source.rds\"))  get_mo_source(destination = getOption(\"AMR_mo_source\", \"~/mo_source.rds\"))"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"path Location reference file, can text file (comma-, tab- pipe-separated) Excel file (see Details). Can also \"\", NULL FALSE delete reference file. destination Destination compressed data file - default user's home directory.","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"reference file can text file separated commas (CSV) tabs pipes, Excel file (either 'xls' 'xlsx' format) R object file (extension '.rds'). use Excel file, need readxl package installed. set_mo_source() check file validity: must data.frame, must column named \"mo\" contains values microorganisms$mo microorganisms$fullname must reference column defined values. tests pass, set_mo_source() read file R ask export \"~/mo_source.rds\". CRAN policy disallows packages write file system, although 'exceptions may allowed interactive sessions package obtains confirmation user'. reason, function works interactive sessions user can specifically confirm allow file created. destination file can set destination argument defaults user's home directory. can also set package option AMR_mo_source, e.g. options(AMR_mo_source = \"/location/file.rds\"). created compressed data file \"mo_source.rds\" used default MO determination (function .mo() consequently mo_* functions like mo_genus() mo_gramstain()). location timestamp original file saved attribute compressed data file. function get_mo_source() return data set reading \"mo_source.rds\" readRDS(). original file changed (checking location timestamp original file), call set_mo_source() update data file automatically used interactive session. Reading Excel file (.xlsx) one row size 8-9 kB. compressed file created set_mo_source() size 0.1 kB can read get_mo_source() couple microseconds (millionths second).","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"how-to-setup","dir":"Reference","previous_headings":"","what":"How to Setup","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"Imagine data sheet Excel file. first column contains organisation specific codes, second column contains valid taxonomic names:   save \"/Users//Documents/ourcodes.xlsx\". Now set source:   now created file \"~/mo_source.rds\" contents Excel file. first column foreign values 'mo' column kept creating RDS file. now can use functions:   edit Excel file , say, adding row 4 like :   ...new usage MO function package update data file:   delete reference data file, just use \"\", NULL FALSE input set_mo_source():   original file (previous case Excel file) moved deleted, mo_source.rds file removed upon next use .mo() mo_* function.","code":"|         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 |                    |                       | set_mo_source(\"/Users/me/Documents/ourcodes.xlsx\") #> NOTE: Created mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>       \"Organisation XYZ\" and \"mo\" as.mo(\"lab_mo_ecoli\") #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_mo_kpneumoniae\") #> [1] \"Klebsiella\"  # other input values still work too as.mo(c(\"Escherichia coli\", \"E. coli\", \"lab_mo_ecoli\")) #> NOTE: Translation to one microorganism was guessed with uncertainty. #>       Use mo_uncertainties() to review it. #> Class 'mo' #> [1] B_ESCHR_COLI B_ESCHR_COLI B_ESCHR_COLI |         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 | lab_Staph_aureus   | Staphylococcus aureus | 5 |                    |                       | as.mo(\"lab_mo_ecoli\") #> NOTE: Updated mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>        \"Organisation XYZ\" and \"mo\" #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_Staph_aureus\") #> [1] \"Staphylococcus\" set_mo_source(NULL) #> Removed mo_source file '/Users/me/mo_source.rds'"},{"path":"https://amr-for-r.org/reference/pca.html","id":null,"dir":"Reference","previous_headings":"","what":"Principal Component Analysis (for AMR) — pca","title":"Principal Component Analysis (for AMR) — pca","text":"Performs principal component analysis (PCA) based data set automatic determination afterwards plotting groups labels, automatic filtering suitable (.e. non-empty numeric) variables.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"pca(x, ..., retx = TRUE, center = TRUE, scale. = TRUE, tol = NULL,   rank. = NULL)"},{"path":"https://amr-for-r.org/reference/pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Principal Component Analysis (for AMR) — pca","text":"x data.frame containing numeric columns. ... Columns x selected PCA, can unquoted since supports quasiquotation. retx logical value indicating whether rotated variables     returned. center logical value indicating whether variables     shifted zero centered. Alternately, vector     length equal number columns x can supplied.     value passed scale. scale. logical value indicating whether variables     scaled unit variance analysis takes     place.  default FALSE consistency S,     general scaling advisable.  Alternatively, vector length     equal number columns x can supplied.      value passed scale. tol value indicating magnitude components     omitted. (Components omitted     standard deviations less equal tol times     standard deviation first component.)  default null     setting, components omitted (unless rank. specified     less min(dim(x)).).  settings tol     tol = 0 tol = sqrt(.Machine$double.eps),     omit essentially constant components. rank. optionally, number specifying maximal rank, .e.,     maximal number principal components used.  Can set     alternative addition tol, useful notably     desired rank considerably smaller dimensions matrix.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Principal Component Analysis (for AMR) — pca","text":"object classes pca prcomp","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Principal Component Analysis (for AMR) — pca","text":"pca() function takes data.frame input performs actual PCA R function prcomp(). result pca() function prcomp object, additional attribute non_numeric_cols vector column names columns contain numeric values. probably groups labels, used ggplot_pca().","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    pca_result   summary(pca_result)   # old base R plotting method:   biplot(pca_result) } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (minimum = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # new ggplot2 plotting method using this package: if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) }  if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"Title here\") }  # }"},{"path":"https://amr-for-r.org/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Plotting Helpers for AMR Data Analysis — plot","title":"Plotting Helpers for AMR Data Analysis — plot","text":"Functions plot classes sir, mic disk, support base R ggplot2. Especially scale_*_mic() functions relevant wrappers plot MIC values ggplot2. allows custom MIC ranges plot intermediate log2 levels missing MIC values.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"scale_x_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_y_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_colour_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_fill_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_x_sir(colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), eucast_I = getOption(\"AMR_guideline\",   \"EUCAST\") == \"EUCAST\", ...)  scale_colour_sir(colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), eucast_I = getOption(\"AMR_guideline\",   \"EUCAST\") == \"EUCAST\", ...)  scale_fill_sir(colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), eucast_I = getOption(\"AMR_guideline\",   \"EUCAST\") == \"EUCAST\", ...)  # S3 method for class 'mic' plot(x, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   main = deparse(substitute(x)), ylab = translate_AMR(\"Frequency\", language   = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'mic' autoplot(object, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' plot(x, main = deparse(substitute(x)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Disk diffusion diameter (mm)\", language = language),   mo = NULL, ab = NULL, guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' autoplot(object, mo = NULL, ab = NULL,   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language), xlab = translate_AMR(\"Disk diffusion diameter (mm)\",   language = language), guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'sir' plot(x, ylab = translate_AMR(\"Percentage\", language =   language), xlab = translate_AMR(\"Antimicrobial Interpretation\", language =   language), main = deparse(substitute(x)), language = get_AMR_locale(),   ...)  # S3 method for class 'sir' autoplot(object, title = deparse(substitute(object)),   xlab = translate_AMR(\"Antimicrobial Interpretation\", language = language),   ylab = translate_AMR(\"Frequency\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(), ...)  facet_sir(facet = c(\"interpretation\", \"antibiotic\"), nrow = NULL)  scale_y_percent(breaks = function(x) seq(0, max(x, na.rm = TRUE), 0.1),   limits = c(0, NA))  scale_sir_colours(..., aesthetics, colours_SIR = c(\"#3CAEA3\", \"#F6D55C\",   \"#ED553B\"))  theme_sir()  labels_sir_count(position = NULL, x = \"antibiotic\",   translate_ab = \"name\", minimum = 30, language = get_AMR_locale(),   combine_SI = TRUE, datalabels.size = 3, datalabels.colour = \"grey15\")"},{"path":"https://amr-for-r.org/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plotting Helpers for AMR Data Analysis — plot","text":"keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values (using rescale_mic()), e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). Note: rescales values filter - use ggplot2 limits argument separately exclude values plot. ... Arguments passed methods. colours_SIR Colours use filling bars, must vector three values (order S, R). default colours colour-blind friendly. language Language used translate 'Susceptible', 'Increased exposure'/'Intermediate' 'Resistant' - default system language (see get_AMR_locale()) can overwritten setting package option AMR_locale, e.g. options(AMR_locale = \"de\"), see translate. Use language = NULL prevent translation. eucast_I logical indicate whether '' must interpreted \"Susceptible, increased exposure\". TRUE default AMR interpretation guideline set EUCAST (default). FALSE, interpreted \"Intermediate\". x, object Values created .mic(), .disk() .sir() (random_* variants, random_mic()). mo (vector ) text can coerced valid microorganism code .mo(). ab (vector ) text can coerced valid antimicrobial drug code .ab(). guideline Interpretation guideline use - default latest included EUCAST guideline, see Details. main, title Title plot. xlab, ylab Axis title. expand logical indicate whether range x axis expanded lowest highest value. MIC values, intermediate values factors 2 starting highest MIC value. disk diameters, whole diameter range filled. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. nrow (using facet) number rows. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. aesthetics Aesthetics apply colours - default \"fill\" can also (combination ) \"alpha\", \"colour\", \"fill\", \"linetype\", \"shape\" \"size\". position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. datalabels.size Size datalabels. datalabels.colour Colour datalabels.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Plotting Helpers for AMR Data Analysis — plot","text":"autoplot() functions return ggplot model extendible ggplot2 function.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-mic-functions","dir":"Reference","previous_headings":"","what":"The scale_*_mic() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_mic(), scale_y_mic(), scale_colour_mic(), scale_fill_mic() functions allow plot mic class (MIC values) continuous, logarithmic scale. also allow rescale MIC range 'inside' 'outside' range required, retain operators MIC values (>=) desired. Missing intermediate log2 levels plotted .","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-sir-functions","dir":"Reference","previous_headings":"","what":"The scale_*_sir() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_sir(), scale_colour_sir(), scale_fill_sir() functions allow plot sir class right order (S < SDD < < R < NI). default, translate S//R values interpretative text (\"Susceptible\", \"Resistant\", etc.) 20 supported languages (use language = NULL keep S//R). Also, except scale_x_sir(), set colour-blind friendly colours colour fill aesthetics.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"additional-ggplot-functions","dir":"Reference","previous_headings":"","what":"Additional ggplot2 Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"package contains functions extend ggplot2 package, help visualising AMR data results. functions internally used ggplot_sir() . facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() allows set colours aesthetic, even shape linetype. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage number isolates, using ggplot2::geom_text(). interpretation \"\" named \"Increased exposure\" EUCAST guidelines since 2019, named \"Intermediate\" cases. interpreting MIC values well disk diffusion diameters, default guideline EUCAST 2025, unless package option AMR_guideline set. See .sir() information.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"some_mic_values <- random_mic(size = 100) some_disk_values <- random_disk(size = 100, mo = \"Escherichia coli\", ab = \"cipro\") some_sir_values <- random_sir(50, prob_SIR = c(0.55, 0.05, 0.30))  # \\donttest{ # Plotting using ggplot2's autoplot() for MIC, disk, and SIR ----------- if (require(\"ggplot2\")) {   autoplot(some_mic_values) }  if (require(\"ggplot2\")) {   # when providing the microorganism and antibiotic, colours will show interpretations:   autoplot(some_mic_values, mo = \"Escherichia coli\", ab = \"cipro\") }  if (require(\"ggplot2\")) {   # support for 20 languages, various guidelines, and many options   autoplot(some_disk_values,     mo = \"Escherichia coli\", ab = \"cipro\",     guideline = \"CLSI 2024\", language = \"no\",     title = \"Disk diffusion from the North\"   ) }    # Plotting using scale_x_mic() ----------------------------------------- if (require(\"ggplot2\")) {   mic_plot <- ggplot(     data.frame(       mics = as.mic(c(0.25, \"<=4\", 4, 8, 32, \">=32\")),       counts = c(1, 1, 2, 2, 3, 3)     ),     aes(mics, counts)   ) +     geom_col()   mic_plot +     labs(title = \"without scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic() +     labs(title = \"with scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(keep_operators = \"all\") +     labs(title = \"with scale_x_mic() keeping all operators\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(1, 16)) +     labs(title = \"with scale_x_mic() using a manual 'within' range\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(0.032, 256)) +     labs(title = \"with scale_x_mic() using a manual 'outside' range\") }    # Plotting using scale_y_mic() ----------------------------------------- some_groups <- sample(LETTERS[1:5], 20, replace = TRUE)  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey\", fill = NA) +     scale_y_mic() }  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey\", fill = NA) +     scale_y_mic(mic_range = c(NA, 0.25)) }    # Plotting using scale_x_sir() ----------------------------------------- if (require(\"ggplot2\")) {   ggplot(     data.frame(       x = c(\"I\", \"R\", \"S\"),       y = c(45, 323, 573)     ),     aes(x, y)   ) +     geom_col() +     scale_x_sir() }    # Plotting using scale_y_mic() and scale_colour_sir() ------------------ if (require(\"ggplot2\")) {   plain <- ggplot(     data.frame(       mic = some_mic_values,       group = some_groups,       sir = as.sir(some_mic_values,         mo = \"E. coli\",         ab = \"cipro\"       )     ),     aes(x = group, y = mic, colour = sir)   ) +     theme_minimal() +     geom_boxplot(fill = NA, colour = \"grey\") +     geom_jitter(width = 0.25)    plain }  if (require(\"ggplot2\")) {   # and now with our MIC and SIR scale functions:   plain +     scale_y_mic() +     scale_colour_sir() }  if (require(\"ggplot2\")) {   plain +     scale_y_mic(mic_range = c(0.005, 32), name = \"Our MICs!\") +     scale_colour_sir(       language = \"pt\",       name = \"Support in 20 languages\"     ) }  # }  # Plotting using base R's plot() ---------------------------------------  plot(some_mic_values)  # when providing the microorganism and antibiotic, colours will show interpretations: plot(some_mic_values, mo = \"S. aureus\", ab = \"ampicillin\")   plot(some_disk_values)  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\")  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\", language = \"nl\")   plot(some_sir_values)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate Antimicrobial Resistance — proportion","title":"Calculate Antimicrobial Resistance — proportion","text":"functions can used calculate (co-)resistance susceptibility microbial isolates (.e. percentage S, SI, , IR R). functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. resistance() used calculate resistance, susceptibility() used calculate susceptibility.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"resistance(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  susceptibility(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  sir_confidence_interval(..., ab_result = \"R\", minimum = 30,   as_percent = FALSE, only_all_tested = FALSE, confidence_level = 0.95,   side = \"both\", collapse = FALSE)  proportion_R(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_IR(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_I(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_SI(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_S(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)  sir_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Calculate Antimicrobial Resistance — proportion","text":"M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate Antimicrobial Resistance — proportion","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. Use multiple columns calculate (lack ) co-resistance: probability one two drugs resistant susceptible result. See Examples. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. as_percent logical indicate whether output must returned hundred fold % sign (character). value 0.123456 returned \"12.3%\". only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . ab_result Antibiotic results test , must one values \"S\", \"SDD\", \"\", \"R\". confidence_level confidence level returned confidence interval. calculation, number S SI isolates, R isolates compared total number available isolates R, S, using binom.test(), .e., Clopper-Pearson method. side side confidence interval return. default \"\" length 2 vector, can also (abbreviated ) \"min\"/\"left\"/\"lower\"/\"less\" \"max\"/\"right\"/\"higher\"/\"greater\". collapse logical indicate whether output values 'collapsed', .e. merged together one value, character value use collapsing. data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate Antimicrobial Resistance — proportion","text":"double , as_percent = TRUE, character.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate Antimicrobial Resistance — proportion","text":"automated comprehensive analysis, consider using antibiogram() wisca(), streamline many aspects susceptibility reporting , importantly, also support WISCA. functions described offer hands-, manual approach greater customisation. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine data set one four available algorithms. function resistance() equal function proportion_R(). function susceptibility() equal function proportion_SI(). Since AMR v3.0, proportion_SI() proportion_I() include dose-dependent susceptibility ('SDD'). Use sir_confidence_interval() calculate confidence interval, relies binom.test(), .e., Clopper-Pearson method. function returns vector length 2 default antimicrobial resistance. Change side argument \"left\"/\"min\" \"right\"/\"max\" return single value, change ab_result argument e.g. c(\"S\", \"\") test antimicrobial susceptibility, see Examples. functions meant count isolates, calculate proportion resistance/susceptibility. Use count_*() functions count isolates. function susceptibility() essentially equal count_susceptible()/count_all(). Low counts can influence outcome - proportion_*() functions may camouflage , since return proportion (albeit dependent minimum argument). function proportion_df() takes variable data sir class (created .sir()) calculates proportions S, , R. also supports grouped variables. function sir_df() works exactly like proportion_df(), adds number isolates.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Calculate Antimicrobial Resistance — proportion","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Calculate Antimicrobial Resistance — proportion","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # base R ------------------------------------------------------------ # determines %R resistance(example_isolates$AMX) #> [1] 0.5955556 sir_confidence_interval(example_isolates$AMX) #> [1] 0.5688204 0.6218738 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975 ) #> [1] 0.5650148 0.6255670 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975,   collapse = \", \" ) #> [1] \"0.565, 0.626\"  # determines %S+I: susceptibility(example_isolates$AMX) #> [1] 0.4044444 sir_confidence_interval(example_isolates$AMX,   ab_result = c(\"S\", \"I\") ) #> [1] 0.3781262 0.4311796  # be more specific proportion_S(example_isolates$AMX) #> [1] 0.4022222 proportion_SI(example_isolates$AMX) #> [1] 0.4044444 proportion_I(example_isolates$AMX) #> [1] 0.002222222 proportion_IR(example_isolates$AMX) #> [1] 0.5977778 proportion_R(example_isolates$AMX) #> [1] 0.5955556  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       r = resistance(CIP),       n = n_sir(CIP)     ) # n_sir works like n_distinct in dplyr, see ?n_sir } #> # A tibble: 3 × 3 #>   ward           r     n #>   <chr>      <dbl> <int> #> 1 Clinical   0.147   869 #> 2 ICU        0.190   447 #> 3 Outpatient 0.161    93 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       cipro_R = resistance(CIP),       ci_min = sir_confidence_interval(CIP, side = \"min\"),       ci_max = sir_confidence_interval(CIP, side = \"max\"),     ) } #> # A tibble: 3 × 4 #>   ward       cipro_R ci_min ci_max #>   <chr>        <dbl>  <dbl>  <dbl> #> 1 Clinical     0.147 0.124   0.173 #> 2 ICU          0.190 0.155   0.230 #> 3 Outpatient   0.161 0.0932  0.252 if (require(\"dplyr\")) {   # scoped dplyr verbs with antimicrobial selectors   # (you could also use across() of course)   example_isolates %>%     group_by(ward) %>%     summarise_at(       c(aminoglycosides(), carbapenems()),       resistance     ) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `KAN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = #> \"Outpatient\" (minimum = 30). #> # A tibble: 3 × 7 #>   ward         GEN   TOB   AMK   KAN    IPM    MEM #>   <chr>      <dbl> <dbl> <dbl> <dbl>  <dbl>  <dbl> #> 1 Clinical   0.229 0.315 0.626     1 0.0498 0.0458 #> 2 ICU        0.290 0.400 0.662     1 0.0862 0.0894 #> 3 Outpatient 0.2   0.368 0.605    NA 0.0541 0.0541 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = resistance(CIP, as_percent = TRUE),       SI = susceptibility(CIP, as_percent = TRUE),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Calculate co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy:   example_isolates %>% susceptibility(AMC) # %SI = 76.3%   example_isolates %>% count_all(AMC) #   n = 1879    example_isolates %>% susceptibility(GEN) # %SI = 75.4%   example_isolates %>% count_all(GEN) #   n = 1855    example_isolates %>% susceptibility(AMC, GEN) # %SI = 94.1%   example_isolates %>% count_all(AMC, GEN) #   n = 1939     # See Details on how `only_all_tested` works. Example:   example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN),       denominator = count_all(AMC, GEN),       proportion = susceptibility(AMC, GEN)     )    example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN, only_all_tested = TRUE),       denominator = count_all(AMC, GEN, only_all_tested = TRUE),       proportion = susceptibility(AMC, GEN, only_all_tested = TRUE)     )     example_isolates %>%     group_by(ward) %>%     summarise(       cipro_p = susceptibility(CIP, as_percent = TRUE),       cipro_n = count_all(CIP),       genta_p = susceptibility(GEN, as_percent = TRUE),       genta_n = count_all(GEN),       combination_p = susceptibility(CIP, GEN, as_percent = TRUE),       combination_n = count_all(CIP, GEN)     )    # Get proportions S/I/R immediately of all sir columns   example_isolates %>%     select(AMX, CIP) %>%     proportion_df(translate = FALSE)    # It also supports grouping variables   # (use sir_df to also include the count)   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     sir_df(translate = FALSE) } #> # A tibble: 12 × 7 #>    ward       antibiotic interpretation value ci_min ci_max isolates #>    <chr>      <chr>      <ord>          <dbl>  <dbl>  <dbl>    <int> #>  1 Clinical   AMX        SI             0.423 0.389   0.457      357 #>  2 Clinical   AMX        R              0.577 0.543   0.611      487 #>  3 Clinical   CIP        SI             0.853 0.827   0.876      741 #>  4 Clinical   CIP        R              0.147 0.124   0.173      128 #>  5 ICU        AMX        SI             0.369 0.323   0.417      158 #>  6 ICU        AMX        R              0.631 0.583   0.677      270 #>  7 ICU        CIP        SI             0.810 0.770   0.845      362 #>  8 ICU        CIP        R              0.190 0.155   0.230       85 #>  9 Outpatient AMX        SI             0.397 0.288   0.515       31 #> 10 Outpatient AMX        R              0.603 0.485   0.712       47 #> 11 Outpatient CIP        SI             0.839 0.748   0.907       78 #> 12 Outpatient CIP        R              0.161 0.0932  0.252       15 # }"},{"path":"https://amr-for-r.org/reference/random.html","id":null,"dir":"Reference","previous_headings":"","what":"Random MIC Values/Disk Zones/SIR Generation — random","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"functions can used generating random MIC values disk diffusion diameters, AMR data analysis practice. providing microorganism antimicrobial drug, generated results reflect reality much possible.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(size = NULL, mo = NULL, ab = NULL, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, ...)  random_sir(size = NULL, prob_SIR = c(0.33, 0.33, 0.33), ...)"},{"path":"https://amr-for-r.org/reference/random.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"size Desired size returned vector. used data.frame call dplyr verb, get current (group) size left blank. mo character can coerced valid microorganism code .mo(). ab character can coerced valid antimicrobial drug code .ab(). ... Ignored, place allow future extensions. prob_SIR vector length 3: probabilities \"S\" (1st value), \"\" (2nd value) \"R\" (3rd value).","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"class mic random_mic() (see .mic()) class disk random_disk() (see .disk())","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"base R function sample() used generating values. Generated values based EUCAST 2025 guideline implemented clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(25) #> Class 'mic' #>  [1] <=0.005 0.25    1       0.0625  128     0.01    1       4       128     #> [10] <=0.005 0.25    0.5     0.125   0.01    0.25    2       8       16      #> [19] 0.125   0.5     >=256   >=256   >=256   0.25    16      random_disk(25) #> Class 'disk' #>  [1] 24 14 46 41  9  8 22 41 50 38 48 48 28 43 47 30 13 13 38 14 48 47 21  6 22 random_sir(25) #> Class 'sir' #>  [1] I I I I I I S R R S I S S R I R R R I S S R R I R  # \\donttest{ # make the random generation more realistic by setting a bug and/or drug: random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 0.025  4      1      0.0625 0.005  0.002  2      0.002  >=128  0.0625 #> [11] 0.125  0.5    0.002  0.01   0.001  0.002  0.01   32     64     0.005  #> [21] 0.01   1      4      1      32     random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] <=1 4   4   2   32  4   32  16  <=1 32  8   8   32  8   4   32  <=1 <=1 16  #> [20] 8   32  8   16  4   8   random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] 0.125    >=16     0.125    >=16     2        0.5      1        0.5      #>  [9] 0.125    0.5      <=0.0625 0.25     0.25     0.5      >=16     >=16     #> [17] 1        >=16     8        0.25     8        0.25     >=16     >=16     #> [25] 0.125     random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 42 36 49 13 45 50 37 33 30 14 23 15 30  9 21 47 32 17 48 47 24 23 14 27 48 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 13 16 13 16 13 11 17 12 16 14 14 15 11 16 12 13 14 12 13 12 15 12 12 13 17 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 16 20 25 24 21 22 21 16 15 18 18 25 19 26 27 26 21 21 19 25 15 22 19 24 26 # }"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":null,"dir":"Reference","previous_headings":"","what":"Predict Antimicrobial Resistance — resistance_predict","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Create prediction model predict antimicrobial resistance next years. Standard errors (SE) returned columns se_min se_max. See Examples real live example. NOTE: functions deprecated removed future version. Use AMR package combined tidymodels framework instead, written basic short introduction website.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"resistance_predict(x, col_ab, col_date = NULL, year_min = NULL,   year_max = NULL, year_every = 1, minimum = 30, model = NULL,   I_as_S = TRUE, preserve_measurements = TRUE, info = interactive(), ...)  sir_predict(x, col_ab, col_date = NULL, year_min = NULL, year_max = NULL,   year_every = 1, minimum = 30, model = NULL, I_as_S = TRUE,   preserve_measurements = TRUE, info = interactive(), ...)  # S3 method for class 'resistance_predict' plot(x, main = paste(\"Resistance Prediction of\",   x_name), ...)  ggplot_sir_predict(x, main = paste(\"Resistance Prediction of\", x_name),   ribbon = TRUE, ...)  # S3 method for class 'resistance_predict' autoplot(object,   main = paste(\"Resistance Prediction of\", x_name), ribbon = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Predict Antimicrobial Resistance — resistance_predict","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_ab Column name x containing antimicrobial interpretations (\"R\", \"\" \"S\"). col_date Column name date, used calculate years column consist years already - default first column date class. year_min Lowest year use prediction model, dafaults lowest year col_date. year_max Highest year use prediction model - default 10 years today. year_every Unit sequence lowest year found data year_max. minimum Minimal amount available isolates per year include. Years containing less observations estimated model. model statistical model choice. generalised linear regression model binomial distribution (.e. using glm(..., family = binomial), assuming period zero resistance followed period increasing resistance leading slowly resistance. See Details valid options. I_as_S logical indicate whether values \"\" treated \"S\" (otherwise treated \"R\"). default, TRUE, follows redefinition EUCAST interpretation (increased exposure) 2019, see section Interpretation S, R . preserve_measurements logical indicate whether predictions years actually available data overwritten original data. standard errors years NA. info logical indicate whether textual analysis printed name summary() statistical model. ... Arguments passed functions. main Title plot. ribbon logical indicate whether ribbon shown (default) error bars. object Model data plotted.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Predict Antimicrobial Resistance — resistance_predict","text":"data.frame extra class resistance_predict columns: year value, estimated preserve_measurements = FALSE, combination observed estimated otherwise se_min, lower bound standard error minimum 0 (standard error never go 0%) se_max upper bound standard error maximum 1 (standard error never go 100%) observations, total number available observations year, .e. \\(S + + R\\) observed, original observed resistant percentages estimated, estimated resistant percentages, calculated model Furthermore, model available attribute: attributes(x)$model, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Valid options statistical model (argument model) : \"binomial\" \"binom\" \"logit\": generalised linear regression model binomial distribution \"loglin\" \"poisson\": generalised log-linear regression model poisson distribution \"lin\" \"linear\": linear regression model","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Predict Antimicrobial Resistance — resistance_predict","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"x <- resistance_predict(example_isolates,   col_ab = \"AMX\",   year_min = 2010,   model = \"binomial\" ) #> Warning: The resistance_predict() function is deprecated and will be removed in a #> future version, see ?AMR-deprecated. Use the tidymodels framework #> instead, for which we have written a basic and short introduction on our #> website: https://amr-for-r.org/articles/AMR_with_tidymodels.html #> This warning will be shown once per session. plot(x)  # \\donttest{ if (require(\"ggplot2\")) {   ggplot_sir_predict(x) }   # using dplyr: if (require(\"dplyr\")) {   x <- example_isolates %>%     filter_first_isolate() %>%     filter(mo_genus(mo) == \"Staphylococcus\") %>%     resistance_predict(\"PEN\", model = \"binomial\")   print(plot(x))    # get the model from the object   mymodel <- attributes(x)$model   summary(mymodel) }  #> NULL #>  #> Call: #> glm(formula = df_matrix ~ year, family = binomial) #>  #> Coefficients: #>             Estimate Std. Error z value Pr(>|z|) #> (Intercept) 35.76101   72.29172   0.495    0.621 #> year        -0.01720    0.03603  -0.477    0.633 #>  #> (Dispersion parameter for binomial family taken to be 1) #>  #>     Null deviance: 5.3681  on 11  degrees of freedom #> Residual deviance: 5.1408  on 10  degrees of freedom #> AIC: 50.271 #>  #> Number of Fisher Scoring iterations: 4 #>   # create nice plots with ggplot2 yourself if (require(\"dplyr\") && require(\"ggplot2\")) {   data <- example_isolates %>%     filter(mo == as.mo(\"E. coli\")) %>%     resistance_predict(       col_ab = \"AMX\",       col_date = \"date\",       model = \"binomial\",       info = FALSE,       minimum = 15     )   head(data)   autoplot(data) }  # }"},{"path":"https://amr-for-r.org/reference/skewness.html","id":null,"dir":"Reference","previous_headings":"","what":"Skewness of the Sample — skewness","title":"Skewness of the Sample — skewness","text":"Skewness measure asymmetry probability distribution real-valued random variable mean. negative ('left-skewed'): left tail longer; mass distribution concentrated right histogram. positive ('right-skewed'): right tail longer; mass distribution concentrated left histogram. normal distribution skewness 0.","code":""},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Skewness of the Sample — skewness","text":"","code":"skewness(x, na.rm = FALSE)  # Default S3 method skewness(x, na.rm = FALSE)  # S3 method for class 'matrix' skewness(x, na.rm = FALSE)  # S3 method for class 'data.frame' skewness(x, na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/skewness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Skewness of the Sample — skewness","text":"x vector values, matrix data.frame. na.rm logical value indicating whether NA values stripped computation proceeds.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Skewness of the Sample — skewness","text":"","code":"skewness(runif(1000)) #> [1] -0.01662734"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter Top n Microorganisms — top_n_microorganisms","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function filters data set include top n microorganisms based specified property, taxonomic family genus. example, can filter data set top 3 species, species top 5 genera, top 3 species top 5 genera.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"top_n_microorganisms(x, n, property = \"species\", n_for_each = NULL,   col_mo = NULL, ...)"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"x data frame containing microbial data. n integer specifying maximum number unique values property include output. property character string indicating microorganism property use filtering. Must one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". NULL, raw values col_mo used without transformation. using \"species\" (default) \"subpecies\", genus added make sure (sub)species still belongs right genus. n_for_each optional integer specifying maximum number rows retain value selected property. NULL, rows within top n groups included. col_mo character string indicating column x contains microorganism names codes. Defaults first column class mo. Values coerced using .mo(). ... Additional arguments passed mo_property() property NULL.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function useful preprocessing data creating antibiograms analyses require focused subsets microbial data. example, can filter data set include isolates top 10 species.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"# filter to the top 3 species: top_n_microorganisms(example_isolates,   n = 3 ) #> # A tibble: 1,015 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  5 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  7 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #>  8 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   R     NA    R     NA  #>  9 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   S     NA    S     NA  #> 10 2002-02-21 A56499     64 M      Clinical B_STPHY_CONS   S     NA    S     NA  #> # ℹ 1,005 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to any species in the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\" ) #> # A tibble: 1,742 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,732 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to the top 3 species in each of the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\", n_for_each = 3 ) #> # A tibble: 1,497 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  8 2003-09-05 F35553     52 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #> 10 2003-09-28 1B0933     80 M      Clinical B_ENTRC        NA    NA    NA    NA  #> # ℹ 1,487 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/translate.html","id":null,"dir":"Reference","previous_headings":"","what":"Translate Strings from the AMR Package — translate","title":"Translate Strings from the AMR Package — translate","text":"language-dependent output AMR functions, mo_name(), mo_gramstain(), mo_type() ab_name().","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Translate Strings from the AMR Package — translate","text":"","code":"get_AMR_locale()  set_AMR_locale(language)  reset_AMR_locale()  translate_AMR(x, language = get_AMR_locale())"},{"path":"https://amr-for-r.org/reference/translate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate Strings from the AMR Package — translate","text":"language Language choose. Use one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). x Text translate.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate Strings from the AMR Package — translate","text":"currently 20 supported languages English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). languages translations available antimicrobial drugs colloquial microorganism names. permanently silence -per-session language note non-English operating system, can set package option AMR_locale .Rprofile file like :   save file. Please read adding updating language Wiki.","code":"# Open .Rprofile file utils::file.edit(\"~/.Rprofile\")  # Then add e.g. Italian support to that file using: options(AMR_locale = \"Italian\")"},{"path":"https://amr-for-r.org/reference/translate.html","id":"changing-the-default-language","dir":"Reference","previous_headings":"","what":"Changing the Default Language","title":"Translate Strings from the AMR Package — translate","text":"system language used default (returned Sys.getenv(\"LANG\") , LANG set, Sys.getlocale(\"LC_COLLATE\")), language supported. language used can overwritten two ways checked order: Setting package option AMR_locale, either using e.g. set_AMR_locale(\"German\") running e.g. options(AMR_locale = \"German\"). Note setting R option works session. Save command options(AMR_locale = \"(language)\") .Rprofile file apply every session. Run utils::file.edit(\"~/.Rprofile\") edit .Rprofile file. Setting system variable LANGUAGE LANG, e.g. adding LANGUAGE=\"de_DE.utf8\" .Renviron file home directory. Thus, package option AMR_locale set, system variables LANGUAGE LANG ignored.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Translate Strings from the AMR Package — translate","text":"","code":"# Current settings (based on system language) ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negative Staphylococcus (CoNS)\"  # setting another language set_AMR_locale(\"Dutch\") #> ℹ Using Dutch (Nederlands) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacine\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negatieve Staphylococcus (CNS)\"  # setting yet another language set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Koagulase-negative Staphylococcus (KNS)\"  # set_AMR_locale() understands endonyms, English exonyms, and ISO-639-1: set_AMR_locale(\"Deutsch\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"de\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/Clavulansäure\"  # reset to system default reset_AMR_locale() #> ℹ Using the English language (English) for the AMR package for this #>   session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/clavulanic acid\""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-2119255","dir":"Changelog","previous_headings":"","what":"AMR 2.1.1.9255","title":"AMR 2.1.1.9255","text":"(beta version eventually become v3.0. ’re happy reach new major milestone soon, new One Health support! Install beta using instructions .)","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9255","dir":"Changelog","previous_headings":"","what":"A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)","title":"AMR 2.1.1.9255","text":"package now supports tools AMR data analysis clinical settings, also veterinary environmental microbiology. made possible collaboration University Prince Edward Island’s Atlantic Veterinary College, Canada. celebrate great improvement package, also updated package logo reflect change.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"breaking-2-1-1-9255","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 2.1.1.9255","text":"Dataset antibiotics renamed antimicrobials data set contains just antibiotics. Using antibiotics still work, now returns warning. Removed functions references used deprecated rsi class, replaced sir equivalents two years ago. Functions resistance_predict() sir_predict() now deprecated removed future version. Use tidymodels framework instead, wrote basic introduction.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"new-2-1-1-9255","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 2.1.1.9255","text":"Function .sir() now extensive support veterinary breakpoints CLSI. Use breakpoint_type = \"animal\" set host argument variable contains animal species names. clinical_breakpoints data set contains breakpoints, can downloaded download page. (new) antimicrobials data set contains veterinary antibiotics, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antibiotics (start “Q”) ab_url() now supports retrieving WHOCC url ATCvet pages antibiogram() function now supports creating true Weighted-Incidence Syndromic Combination Antibiograms (WISCA), powerful Bayesian method estimating regimen coverage probabilities using pathogen incidence antimicrobial susceptibility data. WISCA offers improved precision syndrome-specific treatment, even datasets sparse data. dedicated wisca() function also available easy usage. MycoBank now integrated primary taxonomic source fungi. microorganisms data set enriched new columns (mycobank, mycobank_parent, mycobank_renamed_to) provide detailed information fungal species. remarkable addition 20,000 new fungal records New function mo_mycobank() retrieve MycoBank record number, analogous existing functions mo_lpsn() mo_gbif(). .mo() function mo_*() functions now include only_fungi argument, allowing users restrict results solely fungal species. ensures fungi prioritised bacteria microorganism identification. can also set globally new AMR_only_fungi option. Also updated kingdoms, welcoming total 2,149 new records 2023 927 2024. Breakpoint 2024 2025 CLSI EUCAST now supported, adding 10,000 new clinical breakpoints clinical_breakpoints data set usage .sir(). EUCAST 2025 now new default guideline MIC disk diffusion interpretations. Added Expected Resistant Phenotypes EUCAST (v1.2). default rules eucast_rules() now: c(\"breakpoints\", \"expected_phenotypes\"). Updated intrinsic_resistant data set, now based EUCAST Expected Resistant Phenotypes v1.2 .sir() now brings additional factor levels: “NI” non-interpretable “SDD” susceptible dose-dependent. Currently, clinical_breakpoints data set contains 24 breakpoints can return value “SDD” instead “”. EUCAST interpretive rules (using eucast_rules()) now available EUCAST 12 (2022), 13 (2023), 14 (2024), 15 (2025). EUCAST dosage tables (dosage data set) now available EUCAST 13 (2023), 14 (2024), 15 (2025). New function group scale_*_mic(), namely: scale_x_mic(), scale_y_mic(), scale_colour_mic() scale_fill_mic(). allow easy plotting MIC values. allow manual range definition plotting missing intermediate log2 levels. New function group scale_*_sir(), namely: scale_x_sir(), scale_colour_sir() scale_fill_sir(). allow plot sir class, translates system language default. also set colourblind-safe colours plots. New function rescale_mic(), allows users rescale MIC values manually set range. powerhouse behind scale_*_mic() functions, can used independently , instance, compare equality MIC distributions rescaling range first. using R heavy lifting, ‘AMR’ Python Package developed run AMR R package natively Python. Python package always version number R package, built automatically every code change. antimicrobial selectors (aminoglycosides() betalactams()) now supported tidymodels packages recipe parsnip. See info tutorial using AMR functions predictive modelling. New function top_n_microorganisms() filter data set top n taxonomic property, e.g., filter top 3 species, filter species top 5 genera, filter top 3 species top 5 genera New function mo_group_members() retrieve member microorganisms microorganism group. example, mo_group_members(\"Strep group C\") returns vector microorganisms belong group. New functions mic_p50() mic_p90() retrieve 50th 90th percentile MIC values.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-2-1-1-9255","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 2.1.1.9255","text":"Support parallel computing using parallel package (part base R). Use .sir(your_data, parallel = TRUE) run SIR interpretation using multiple cores. now possible use column names arguments guideline, ab, mo, uti: .sir(..., ab = \"column1\", mo = \"column2\", uti = \"column3\"). greatly improves flexibility users. Users can now set criteria (using regular expressions) considered S, , R, SDD, NI. get quantitative values, .double() sir object return 1 S, 2 SDD/, 3 R (NI become NA). functions using sir classes (e.g., summary()) updated reflect change contain NI SDD. Following CLSI interpretation rules, values outside log2-dilution range rounded upwards nearest log2-level interpretation. using CLSI guideline. Combined MIC values (e.g., CLSI) now supported argument conserve_capped_values .sir() replaced capped_mic_handling, allows greater flexibility handling capped MIC values (<, <=, >, >=). four available options (\"standard\", \"strict\", \"relaxed\", \"inverse\") provide full control whether values interpreted conservatively ignored. Using conserve_capped_values now deprecated returns warning. Added argument info silence console messages Argument antibiotics renamed antimicrobials. Using antibiotics still work, now returns warning. Added argument formatting_type set 22 options formatting ‘cells’. defaults 18 non-WISCA 14 WISCA, changing output antibiograms cells info. reason, add_total_n now deprecated FALSE default since denominators added cells dependent formatting_type setting ab_transform argument now defaults \"name\", displaying antibiotic column names instead codes ‘Antibiotic selectors’ now called ‘antimicrobial selectors’ since scope broader just antibiotics. documentation updated, ab_class() ab_selector() replaced amr_class() amr_selector(). old functions now deprecated removed future version. Added selectors isoxazolylpenicillins(), monobactams(), nitrofurans(), phenicols(), rifamycins(), sulfonamides() using antimicrobial selectors exclude non-treatable drugs (gentamicin-high using aminoglycosides()), function now always returns warning can included using only_treatable = FALSE Added new argument return_all selectors, defaults TRUE include match. FALSE, old behaviour, first hit unique antimicrobial returned. selectors can now run separate command retrieve vector possible antimicrobials selector can select selectors lincosamides() macrolides() overlap anymore - antibiotic now classified either Fixed selector fluoroquinolones(), now really selects second-generation quinolones (first-generation quinolones contain fluorine group) Added agents used screening, ID ending -S: benzylpenicillin screening test (PEN-S), beta-lactamase screening test (BLA-S), cefotaxime screening test (CTX-S), clindamycin inducible screening test (CLI-S), nalidixic acid screening test (NAL-S), norfloxacin screening test (-S), oxacillin screening test (OXA-S), pefloxacin screening test (PEF-S), tetracycline screening test (TCY-S). ID cefoxitin screening renamed FOX1 FOX-S, old code remains work. reason, antimicrobial selectors cephalosporins(), cephalosporins_3rd(), lincosamides(), isoxazolylpenicillins(), quinolones(), fluoroquinolones(), tetracyclines() now contain argument only_treatable = TRUE (similar antimicrobial selectors contain non-treatable drugs) Added amorolfine (AMO, D01AE16), antimycotic, now also part antifungals() selector Added cefepime/enmetazobactam (FPE), 4th gen cephalosporin Added tigemonam (TNM), monobactam Added bleomycin (BLM), glycopeptide Added efflux (EFF), allow mapping AMRFinderPlus Updated ATC codes, trade names, DDDs Added valid levels: 4096, 6 powers 0.0625, 5 powers 192 (192, 384, 576, 768, 960) Fixed bug .mic() failed translation scientifically formatted numbers Added new argument keep_operators .mic(). can \"\" (default), \"none\", \"edges\". argument also available new rescale_mic() scale_*_mic() functions. Comparisons MIC values now strict. example, >32 higher (never equal ) 32. Thus, .mic(\">32\") == .mic(32) now returns FALSE, .mic(\">32\") > .mic(32) now returns TRUE. Sorting MIC values (using sort()) fixed manner; <0.001 now gets sorted 0.001, >0.001 gets sorted 0.001. Intermediate log2 levels used MIC plotting now common values instead following strict dilution range .mic() now returns vector TRUE/FALSE input data.frame, just like .sir() eucast_rules() now argument overwrite (default: FALSE) indicate whether non-NA values overwritten Disks 0 5 mm now allowed, newly allowed range disk diffusion (.disk()) now 0 50 mm Updated italicise_taxonomy() support HTML output custom_eucast_rules() now supports multiple antibiotics antibiotic groups affected single rule mo_info() now contains extra element rank group_members (contents new mo_group_members() function) Updated ATC codes WHOCC Updated antibiotic DDDs WHOCC Fix using manual value mo_transform antibiogram() Fixed bug antibiogram() returns empty data set Fix mapping ‘high level’ antibiotics .ab() (amphotericin B-high, gentamicin-high, kanamycin-high, streptomycin-high, tobramycin-high) Improved overall algorithm .ab() better performance accuracy, including new function as_reset_session() remove earlier coercions. weight given genus species combinations cases subspecies miswritten, result correct genus species Genera World Health Organization’s () Priority Pathogen List now highest prevalence Fixed bug sir_confidence_interval() isolates available Updated prevalence calculation include genera World Health Organization’s () Priority Pathogen List Improved algorithm first_isolate() using phenotype-based method, prioritise records highest availability SIR values scale_y_percent() can now cope ranges outside 0-100% range Implemented new Dutch national MDRO guideline (SRI-richtlijn BRMO, Nov 2024) Added arguments esbl, carbapenemase, mecA, mecC, vanA, vanB denote column names logical values indicating presence genes (production proteins) Added console colours support sir class Positron","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"other-2-1-1-9255","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 2.1.1.9255","text":"New website domain: https://amr--r.org! old domain (http://amr--r.org) remain work. Added Dr. Larisse Bolton Aislinn Cook contributors fantastic implementation WISCA mathematically solid way Added Matthew Saab, Dr. Jordan Stull, Prof. Javier Sanchez contributors tremendous input veterinary breakpoints interpretations Added Prof. Kathryn Holt, Dr. Jane Hawkey, Dr. Natacha Couto contributors many suggestions, ideas bugfixes Greatly improved vctrs integration, Tidyverse package working background many Tidyverse functions. users, means functions dplyr’s bind_rows(), rowwise() c_across() now supported e.g. columns class mic. Despite , AMR package still zero-dependent package, including dplyr vctrs. Greatly updated expanded documentation Stopped support SAS (.xpt) files, since file structure extremely inefficient requires disk space GitHub allows single commit.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"older-versions-2-1-1-9255","dir":"Changelog","previous_headings":"","what":"Older Versions","title":"AMR 2.1.1.9255","text":"changelog contains changes AMR v3.0 (March 2025) later. prior v2 versions, please see v2 archive. prior v1 versions, please see v1 archive.","code":""}]