From 2d20ac1a7d551ba21bd3f3131c36a0e1e34bd8f2 Mon Sep 17 00:00:00 2001
From: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 20 Sep 2025 16:24:20 +0000
Subject: [PATCH] Built site for AMR@3.0.1: adee419

---
 404.html                                 |   2 +-
 LICENSE-text.html                        |   2 +-
 articles/AMR.html                        |  10 ++--
 articles/AMR_for_Python.html             |   2 +-
 articles/AMR_with_tidymodels.html        |   2 +-
 articles/EUCAST.html                     |   2 +-
 articles/PCA.html                        |   2 +-
 articles/WHONET.html                     |   2 +-
 articles/WISCA.html                      |   2 +-
 articles/datasets.html                   |   4 +-
 articles/index.html                      |   2 +-
 authors.html                             |   2 +-
 index.html                               |   2 +-
 news/index.html                          |  13 +++--
 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 |   2 +-
 reference/add_custom_microorganisms.html |   2 +-
 reference/age.html                       |  22 +++----
 reference/age_groups.html                |   2 +-
 reference/antibiogram.html               |   2 +-
 reference/antimicrobial_selectors.html   |   2 +-
 reference/antimicrobials.html            |   2 +-
 reference/as.ab.html                     |   2 +-
 reference/as.av.html                     |   2 +-
 reference/as.disk.html                   |   2 +-
 reference/as.mic.html                    |   2 +-
 reference/as.mo.html                     |   2 +-
 reference/as.sir.html                    |  10 ++--
 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/custom_mdro_guideline.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 87342 -> 70715 bytes
 reference/plot-11.png                    | Bin 70715 -> 19312 bytes
 reference/plot-12.png                    | Bin 19312 -> 86421 bytes
 reference/plot-13.png                    | Bin 73842 -> 85572 bytes
 reference/plot-14.png                    | Bin 86113 -> 38976 bytes
 reference/plot-15.png                    | Bin 83999 -> 55162 bytes
 reference/plot-16.png                    | Bin 38976 -> 37343 bytes
 reference/plot-17.png                    | Bin 55162 -> 53379 bytes
 reference/plot-18.png                    | Bin 37343 -> 51169 bytes
 reference/plot-19.png                    | Bin 53379 -> 43411 bytes
 reference/plot-20.png                    | Bin 51169 -> 0 bytes
 reference/plot-21.png                    | Bin 43411 -> 0 bytes
 reference/plot-5.png                     | Bin 25019 -> 29773 bytes
 reference/plot-6.png                     | Bin 27974 -> 29773 bytes
 reference/plot-7.png                     | Bin 30826 -> 26190 bytes
 reference/plot-8.png                     | Bin 26190 -> 33705 bytes
 reference/plot-9.png                     | Bin 33705 -> 92180 bytes
 reference/plot.html                      |  70 ++++++++++-------------
 reference/proportion.html                |   2 +-
 reference/random-1.png                   | Bin 32898 -> 32918 bytes
 reference/random-2.png                   | Bin 48295 -> 48276 bytes
 reference/random.html                    |  19 +++---
 reference/resistance_predict.html        |   2 +-
 reference/skewness.html                  |   2 +-
 reference/top_n_microorganisms.html      |   2 +-
 reference/translate.html                 |   2 +-
 search.json                              |   2 +-
 98 files changed, 145 insertions(+), 147 deletions(-)
 delete mode 100644 reference/plot-20.png
 delete mode 100644 reference/plot-21.png

diff --git a/404.html b/404.html
index f1cc285d4..81f69e965 100644
--- a/404.html
+++ b/404.html
@@ -31,7 +31,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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 21ddbf62a..f1f583dc6 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 2515860ed..b87a125bd 100644
--- a/articles/AMR.html
+++ b/articles/AMR.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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">
@@ -91,7 +91,7 @@
 website update since they are based on randomly created values and the
 page was written in <a href="https://rmarkdown.rstudio.com/" class="external-link">R
 Markdown</a>. However, the methodology remains unchanged. This page was
-generated on 19 September 2025.</p>
+generated on 20 September 2025.</p>
 <div class="section level2">
 <h2 id="introduction">Introduction<a class="anchor" aria-label="anchor" href="#introduction"></a>
 </h2>
@@ -147,21 +147,21 @@ make the structure of your data generally look like this:</p>
 </tr></thead>
 <tbody>
 <tr class="odd">
-<td align="center">2025-09-19</td>
+<td align="center">2025-09-20</td>
 <td align="center">abcd</td>
 <td align="center">Escherichia coli</td>
 <td align="center">S</td>
 <td align="center">S</td>
 </tr>
 <tr class="even">
-<td align="center">2025-09-19</td>
+<td align="center">2025-09-20</td>
 <td align="center">abcd</td>
 <td align="center">Escherichia coli</td>
 <td align="center">S</td>
 <td align="center">R</td>
 </tr>
 <tr class="odd">
-<td align="center">2025-09-19</td>
+<td align="center">2025-09-20</td>
 <td align="center">efgh</td>
 <td align="center">Escherichia coli</td>
 <td align="center">R</td>
diff --git a/articles/AMR_for_Python.html b/articles/AMR_for_Python.html
index fe427dd01..2383dd202 100644
--- a/articles/AMR_for_Python.html
+++ b/articles/AMR_for_Python.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 ae6a18056..2678de5e2 100644
--- a/articles/AMR_with_tidymodels.html
+++ b/articles/AMR_with_tidymodels.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 1870599ad..029f444d0 100644
--- a/articles/EUCAST.html
+++ b/articles/EUCAST.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 a1c77c1c0..81b4d3b84 100644
--- a/articles/PCA.html
+++ b/articles/PCA.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 2a547a0f6..46a427571 100644
--- a/articles/WHONET.html
+++ b/articles/WHONET.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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/WISCA.html b/articles/WISCA.html
index 594b77feb..b8fcee6e5 100644
--- a/articles/WISCA.html
+++ b/articles/WISCA.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 9ed7ec970..e45a1e2b6 100644
--- a/articles/datasets.html
+++ b/articles/datasets.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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">
@@ -80,7 +80,7 @@
   <main id="main" class="col-md-9"><div class="page-header">
       <img src="../logo.svg" class="logo" alt=""><h1>Download data sets for download / own use</h1>
             
-            <h4 data-toc-skip class="date">19 September 2025</h4>
+            <h4 data-toc-skip class="date">20 September 2025</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/msberends/AMR/blob/main/vignettes/datasets.Rmd" class="external-link"><code>vignettes/datasets.Rmd</code></a></small>
       <div class="d-none name"><code>datasets.Rmd</code></div>
diff --git a/articles/index.html b/articles/index.html
index acd1f6aa7..a6b4a0d61 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 84dd29241..53ffb7b79 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 8420ff1a1..c72c5dd3d 100644
--- a/index.html
+++ b/index.html
@@ -33,7 +33,7 @@
 
     <a class="navbar-brand me-2" href="index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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/news/index.html b/news/index.html
index b84b137bd..cf24889b2 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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,11 +49,16 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="3.0.0.9036" id="amr-3009036">AMR 3.0.0.9036<a class="anchor" aria-label="anchor" href="#amr-3009036"></a></h2>
+<h2 class="pkg-version" data-toc-text="3.0.1" id="amr-301">AMR 3.0.1<a class="anchor" aria-label="anchor" href="#amr-301"></a></h2><p class="text-muted">CRAN release: 2025-09-20</p>
 <p>This is a bugfix release following the release of v3.0.0 in June 2025.</p>
 <div class="section level4">
-<h4 id="changed-3-0-0-9036">Changed<a class="anchor" aria-label="anchor" href="#changed-3-0-0-9036"></a></h4>
-<ul><li>Fixed bugs introduced by <code>ggplot2</code> v4.0.0 (<a href="https://github.com/msberends/AMR/issues/236" class="external-link">#236</a>)</li>
+<h4 id="changed-3-0-1">Changed<a class="anchor" aria-label="anchor" href="#changed-3-0-1"></a></h4>
+<ul><li>Fixed bugs introduced by <code>ggplot2</code> v4.0.0 (<a href="https://github.com/msberends/AMR/issues/236" class="external-link">#236</a>)
+<ul><li>MIC scale functions (such as <code><a href="../reference/plot.html">scale_y_mic()</a></code>) will now be applied automatically when plotting values of class <code>mic</code>
+</li>
+<li>SIR scale functions (such as <code><a href="../reference/plot.html">scale_x_sir()</a></code>) will now be applied automatically when plotting values of class <code>sir</code>
+</li>
+</ul></li>
 <li>Fixed a bug in <code><a href="../reference/antibiogram.html">antibiogram()</a></code> for when no antimicrobials are set</li>
 <li>Fixed a bug in <code><a href="../reference/antibiogram.html">antibiogram()</a></code> to allow column names containing the <code>+</code> character (<a href="https://github.com/msberends/AMR/issues/222" class="external-link">#222</a>)</li>
 <li>Fixed a bug in <code><a href="../reference/as.ab.html">as.ab()</a></code> for antimicrobial codes with a number in it if they are preceded by a space</li>
diff --git a/pkgdown.yml b/pkgdown.yml
index b166d892c..8559d9a3e 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -10,7 +10,7 @@ articles:
   PCA: PCA.html
   WHONET: WHONET.html
   WISCA: WISCA.html
-last_built: 2025-09-19T11:34Z
+last_built: 2025-09-20T16:20Z
 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 1be180845..40cefa46d 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 788681cbb..7f27a5392 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 baee8526d..bc8442f7f 100644
--- a/reference/AMR.html
+++ b/reference/AMR.html
@@ -21,7 +21,7 @@ The AMR package is available in English, Arabic, Bengali, Chinese, Czech, Danish
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 518efcefb..92e476151 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 5514953ca..c5e5f17ec 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 b8535e470..1caf67cff 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 987d58070..a814bc396 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 a643a71b1..0a91e69c5 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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_microorganisms.html b/reference/add_custom_microorganisms.html
index bff1b72e7..4495bdf88 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 4ae69fc7d..7459a21f4 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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">
@@ -112,16 +112,16 @@
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="va">df</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>    birth_date age age_exact age_at_y2k</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 1  1980-02-27  45  45.55890         19</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 2  1953-07-26  72  72.15068         46</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 3  1949-09-02  76  76.04658         50</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 4  1986-08-03  39  39.12877         13</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 5  1932-11-19  92  92.83288         67</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 6  1949-03-30  76  76.47397         50</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 7  1996-06-23  29  29.24110          3</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 8  1963-09-16  62  62.00822         36</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 9  1952-05-16  73  73.34521         47</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 10 1952-11-14  72  72.84658         47</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 1  1980-02-27  45  45.56164         19</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 2  1953-07-26  72  72.15342         46</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 3  1949-09-02  76  76.04932         50</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 4  1986-08-03  39  39.13151         13</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 5  1932-11-19  92  92.83562         67</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 6  1949-03-30  76  76.47671         50</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 7  1996-06-23  29  29.24384          3</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 8  1963-09-16  62  62.01096         36</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 9  1952-05-16  73  73.34795         47</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 10 1952-11-14  72  72.84932         47</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/age_groups.html b/reference/age_groups.html
index 00d3e8d24..7710095b4 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 d0df2d211..5d004d65d 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 9f03fb531..b2916e195 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 357f0d6fd..a37e401ca 100644
--- a/reference/antimicrobials.html
+++ b/reference/antimicrobials.html
@@ -9,7 +9,7 @@ The antibiotics data set has been renamed to antimicrobials. The old name will b
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 3bc827fc5..bef218db7 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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.av.html b/reference/as.av.html
index 62333914f..bd4335ef4 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 ea00f41dc..cc151b268 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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.mic.html b/reference/as.mic.html
index e04983356..8c060fa71 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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.mo.html b/reference/as.mo.html
index 2e2ca973d..12d5a6d07 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 4d6e493b6..7a5f36c65 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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">
@@ -415,10 +415,10 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 4 × 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-09-19 <span style="color: #949494;">11:35:37</span>     1 MIC    amoxicillin Escherich… human      8          </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 2025-09-19 <span style="color: #949494;">11:35:38</span>     1 MIC    cipro       Escherich… human      0.256      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> 2025-09-19 <span style="color: #949494;">11:35:38</span>     1 DISK   tobra       Escherich… human      16         </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 2025-09-19 <span style="color: #949494;">11:35:38</span>     1 DISK   genta       Escherich… human      18         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 2025-09-20 <span style="color: #949494;">16:21:07</span>     1 MIC    amoxicillin Escherich… human      8          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 2025-09-20 <span style="color: #949494;">16:21:07</span>     1 MIC    cipro       Escherich… human      0.256      </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> 2025-09-20 <span style="color: #949494;">16:21:07</span>     1 DISK   tobra       Escherich… human      16         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 2025-09-20 <span style="color: #949494;">16:21:07</span>     1 DISK   genta       Escherich… 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>
diff --git a/reference/atc_online.html b/reference/atc_online.html
index 367a57e40..84d910343 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 70c8feaf4..44168c67a 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 842f6efdb..8a9f2ceaf 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 b7ec91cc5..3443de0fe 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 08b46b660..5b405917b 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 093df8f8c..114972710 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 cfbd7f350..c6216dfe9 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 876acdfc2..66c8cba73 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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_mdro_guideline.html b/reference/custom_mdro_guideline.html
index b021ab0c3..56d680f90 100644
--- a/reference/custom_mdro_guideline.html
+++ b/reference/custom_mdro_guideline.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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 0060ccf47..3b60824f2 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 bdc01f4e5..2c54d87d3 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 bec10cbad..db0fd511a 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 b283bcfd4..a36077a13 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 428ae1891..b8ff33c1f 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 6b7b65388..5325fdfc2 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 0faf66ead..e9e6357fe 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 702ff484b..2ebc29fcf 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 0aaa86a3a..89f4979a2 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 25e656e67..0c22e021f 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 f2e4fe379..2ab1b3562 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 317e23150..201cfbc66 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 b43c717c3..7ab209a9c 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 402d3d747..bcb2f10d9 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 6f498e8bb..5452b946c 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 02ccc226d..da2263e69 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 4ee41eaf4..e362d6efd 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 c5ca22633..7bc1bb196 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 e44125af3..0b724c8d5 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 b33247d4b..ba203cb7f 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 b13bec913..cc1c4a0cb 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 802ee632d..26bab0ef7 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 24daba342..5801232ea 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 b48c88afd..f62476283 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 1ff1e69c3..68f5ceecc 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 ac17800b4..0713e0c3f 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 cfdd45aa5..389cf9bfd 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 08d3d903a592180bd8953dc2203e18867ad1d078..47ce782c2c40c2200717c33e93d1eb0fda713c29 100644
GIT binary patch
literal 70715
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

literal 87342
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%0AEsXQOIYc})@~uTNUfS4d
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
PE{mq2qn@_w#HIfMQq*OF

diff --git a/reference/plot-11.png b/reference/plot-11.png
index 47ce782c2c40c2200717c33e93d1eb0fda713c29..f944a974a42b2664610126b625121bd2714248f9 100644
GIT binary patch
literal 19312
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%0Al%Zx_j-Hg)
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
DMydL5

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

diff --git a/reference/plot-12.png b/reference/plot-12.png
index f944a974a42b2664610126b625121bd2714248f9..047d6203649aa059608bfa8dad9831dc8a132ff2 100644
GIT binary patch
literal 86421
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%0A45%
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
AyZ`_I

literal 19312
zcmeHv2UL@3w{8@bnL*?@j-u3=A%G*zLXi@1#)44+#{$w-s<hBcsE)s7R6v9DrlKGM
zL3#@bjw1*NQKU!<C?(PoAV3Hux%-VX|9|dU_uljW>#lX~Id_d~&4h76zVCbA{qFrd
z&wh4(J!xtz{*}~M7z{=nfAr8P3}$^W1|xFuiw*EMy$KJd;bp_c<Hm>J75?xJ)<nX~
zm)=J${V*8W>*${~u_H517|gdA{GlJu1gA~*N9K2OZ3TjcfKA?;zG*Vs`foqI`#MX#
zOuM)|`|#f7%hwLckecM(Zg`FRpDk|pP$|}Q>pE3oC0*QdINI7-!Ad5uEd8xx{+k_E
z+AaxKqg73^0v)cdWn!kHUR1TtuV&e|?o4~JlUY~B4DhOW)HpUz&0urJFAY|=u2Sd|
z{jOzJ1;TqhX=+g;Dg3E!WOMKu^wZ6+|H;>scGh~EFRyQsZDJY;cwxL|`_=~sug@wN
z%_>x_F7%f8jx?=&isgTL;<viG+Fj&eoDs?A&CSm{jkP_ttnzg-&p&sU#bVuxXf1lZ
z7G2pU=15+LTUqGlp~oF=BPE%u9)_G``t7AOS^YrAwnt($3;fk(zkzVBldJ2eUmT7n
zs<$MlS+~7=x9_8F!(K7;5#CjLyQU3ie%}(ZGSjf{Qrja6JDlCzJHTI<TUc=R_TDYJ
zN#@l%Goy4ag^80~$JnB5>iFWC_$BSss%2J9NyO^X+}zyo;PWdXpB`MFH4<=)c)Uyj
z&!eYw>=(Ljf+e~}RMDp-T(E?^VOoQHqyc{RSF^D1Y13k~JGrNGvfsKo&JH(P7CYiu
zRm_adg^cj=+?+NK?UFFwtjGIj-__REUec6GHj0dpi&*^N9~9(5&%o*We|l5dDqMrx
zha1*0rg|%s@tp<Mi98O|e%2<hqbbhJFd1t}i&$OXkYkdX(2-}MjL!&VRr#c@N4K;+
zFXjtMfw_wP;%|~9tcnFW?05+*x^DQAKgsd!!@~-O%uZ{935hcOo7j-HaHV#eOR_9Z
zzA18O*t>i89W1&d>U;sgX?bCa*V9E!a3@zO>Gb=b?##E0llH3o@JqLXaSRqe+LD?G
zo3@!wJOBI_Y~yi_T1~GKbPE`Vj?I@VXf&fn=?C*-_KQCmE)>Oz%j*Y>p9y63C8z5L
zIrmow@LC2|T69|Ej3Nvgxd$hYW}Bv`V0Ucaezc@pCZ@_E88;9_Tka1V6p`OPZy;f~
zcz&C@&Hizp!Ruxg78cdjjK#yhK6vn8qqulk$YIQxH~szTN3!l>Vf)7Jhkh^Oy*@pZ
z{^0rZ=i20Tl`;zbI+G-q1|L~ZzrfVLWf{kgI>;}d>m=Kz+OKxlx6F;b^IMu5o9ro5
zkrymBlsGiR^!dLtsp5^MUU#9V>BeEl#>RHcuP~2v!zDjN$~RB)TH&t=5uDVl4Cd?P
zeGW_V;-y_xMUoix4p+A9n!$^6B1z};9%`qB59w=a-m@muYO#r3HG3WEZ)-|LLj;bJ
zYgkfLUoM-^Vly;D7c^>1?gnF9oc$Ju{6t#LISUV9{ZoaAM}AXfU7I3TnrSP|uz9lV
zU}MA8F*9bQfE(#I`a1bUhJh}AFZ_gUR4JtF9p{;47$grz-w$P-{RXY#!^5|VL%FP<
zV>9&v+=A)$_pdP+3>&`|Ej+2qJ`$H>n(oHAiFtA!7T^W#yTHl!duYyLb&AQj(7@{I
z>NdAB-?>k312sg0Z;iI5hjy39ZVskj>%=DSb7{Rn*Oj&;=`6g!Ne9y-X6(Y}JAUTA
z!Ua#CCk-!66h^)qf*Y`h?aDSu)gGUDmt)pT+j3Jkl71+3=h|uWGAp%0c?`wLPXGMH
zu^TuMB9S;dWW*oBQzKuLal+Z51EKFY^b{?3^XwDJB&@FYVBL)pcoY*-Utq5%ff%Ox
zk8slw9ujQG(pZkM0l&|Wu82=iw_VC^sh5sEf&v%YO$}dO@26~*@p>QKAP!qK6r<1Z
z_xSrq?71BD^5)iL!*C*>V<gxYYs6oiW>mPerZq~^7GJJFu$qvDZD9}Bm$-M4O|ss;
zDxn*udiIt(oj?CA-gj~Og9n46d*#X%%W@CPQF^8k`H!1>>l*N;UKJ&qS}tQbdun^@
zyfke_8lB)94OISop$liUMM2IQ@`T~i+t}=iil9ChjkEUl_9-o+Nv&&aY#~vg`y%Oh
z6$dVenqj>6>~ns-opCCkMjJ5c#8hHo^LJ1iQ&LM0;^4DtCc9(4qBL?V4!<vRx3G)g
zjl9ml=^JtVj1q&WoODY{@XTSCSQ%Xs%B3jf5a(QBty0eBnUA#Uvt?#BxD9EA{;<yO
ziSgk2LEkSZ7@JL(CEd0JD`PH8jzejvlv%5RNjx}swWt2;V0~u^J9OrwemycMOh7x2
z{Wp7cI|X%5p}W$@p(YVi_eHr^e-BF$p2&NX#k4RHf1~)<E860}*5SW+9BAeCiw(B<
z2V9!Ll-dUc1wlN^7QS`e7}?j+F+!Kc5R$t#C7oNx_&(b#lcnK`>G4{a?4Gh)dtzso
zU8pC#`@o*)BQHX=lg`6?sN7mMfUmO99hei|4YBeB?$`H+Ow#qV;*`xyNfiFl1k_qj
zyUm!buaovDL?2NA(4lOa=F0Vrs&G{`dM_D#YrBlh+^Aesx%Bq!uIRVt=jJv>hC$8R
zxM@?lj~3?4Teq@n6}*`Yaiwk2HGiG8zs}fSIp#mR)}WkGNm^Q3nq>vi^x+HxN}~@5
zRtN0oc>hPTrt+CQc<btEPnTO2gbgdmHx3S-Cq3%+u$$v8bJ_H8Zhs=e%MA-ty@}z=
z3nODWnXP}&G}dQyl$hsG;TjD5sF*N7&9|*t5H;lf{_B?R(o3hWUAyMX?GIx9s+{qP
zX~?ZwnYR}N0BEkJEPlKdGWXWFA$%LEO6OJe_D)k5dfY=MiyCGH`~g98Q@l##ASaVJ
zo~xPKqH0eykk<A%N+1xVqK^PF%e*chvA@5+zq`c6Y?G{>=HG$Z-OJpf2D#?p#yCz5
zZMg=>nPj-v|C(`y3_Ts3N%@m-iBarV$1O^N*bItbm2E~KuqDDGA|oSBGY!+RmZh$5
zZ_umeJFVle8o;_LTRyY9v&QQgr*lk4=z<lxAE!mfrMuWEQPXeu)m>~OC4|$~-;ev~
zw@vlj9c;+h<HUN;&kvigR2I5sXe=&s#nCifFFurA%O$zQ$Qxx0FMk(^h0ik~ZQQsK
z_Fz*(U(xFfHt^j*#wsf)mY87{F&hVLwDB<iIA*XZb)SnVst@cwwR&>xLJ#nysAE8@
zDz8Ds2&Qk?ast@r>N3}b*_saYH54(7;~DyXqbEp@a&lbSnQ78a*I|zY;i@G}X(=fw
z>i5B=LoR~i4N-wJR_iPhjr;&N7Rv7~@;@|)gI|*in|`ipS&YpyFCZQ-iBqbbQQTjX
z$T|urce;VeSJX}D=4eSppGejAY#*|<wY^kkl_e({mG|6zvrP!o?)d~=29ww{A=)0u
z%KT9ARADXKXyt{`@cSYM-Ya9n*#z2lm%@eck$8(E;jN8v%5jv<{`A_lL2!50lwhAg
zHUl?4L#0x0*?kbhSX}A)zH-(X3fGGC#fBK!W(eF=i**Oq3z78x*P+@^To{y)L|pIY
z%UqgZnHGly@gP)Vzcz3=YzPptSryu>3Z4X<jP^R9%Qg|4tRLh>8t$;Lmko&RyCN!~
zgeTMZOFB5iKb3;<CnlEgtm_47%kE#g$m@6ITbAr~YPyGQyeuMm#DLAH4UNNA^au9-
zBS37PFTZz)jV4ZxB-*#)xP5VmiT9R!)(i#%{{Uh%+f9$q?yVruh16o`e<C-3j~Ko2
zuNZgJ`s274LpfyI8f_@mbi-wja?jp`%a<=>8$Z0bUJ}9?g_`UPAqecB|91hx*yg#u
zIS{?q*Ns+${6={3V*`rE6NW|P7wanNpJVxI-Ljx&re2zpYZkssKXCF@1}+rQMpfHt
zP1x_I^dN@rNAdQ02VoEo`f6D*8CP%1TZM;*OZI(Bj`QrREb2dwIls=j!pjpOg%*Gm
zI2;a7;`8|kEFg-%8_1Y{KmZbiUforgvfDJhttC~5UF@PC@dpJl{m)LGe_ih{(Du)O
zHdJKceNlluf3VDu&n)xahp#@9=ZEY5KY2yv$tDFKr}Q}Qc&zCCS|ziLK9=Hv27NAW
z;1NEq%~i9fQVJ8bFkRd5cuVlDByCTt>YAF~+Km{cN|2PwL%-bp;6$cjEo1|XtJpxO
zjo#&o8%U=*c<|tq-3H7S8>p+OZV`G)FD37FIz}1>yzmDTsq4^rOXVhMxpz9zzoH!0
zOf?~}*0|Py3K*!dM$ay<LyBM7?Xl!1iaBwVA!4hSTK%tuuNLca(E0P{DP~_H;8FKQ
zJ#M-+RYxOLhtP_Yl^H`V^!FI%c5YqhczdqF+?#_?{eO;_k&N6^6U1(P^X5%(q!fBf
z)R%-l5w`s5TY0DeKj29k5i_?ei!L6Hm~4npMH-~v%Hqrn-ygjfv!%0Al%Zx_j-Hg)
z6}j5g=i97?C%w2X!Ia<+N}$TT(n(k~r_MwZZgX>ls3gf7ZceH3-Vdi|kJILkhkUpy
zIg1oS-ka-&_b$E5R>TWML{CDfHDjT?V#J<5V&8X999?d3ukGEsQ1Z)LlFZAZa<4!Z
zo@ER8Y)fib2x(Y)VDSi&qhYT``O9oN(r8s`zd^qj732F-gl!q8WYYBXY#!1a!<hO5
zji_`Wh6qAqlZb@DovUJ!Nc(I`q|QACc$QbDD*WYQveh82>$j_7s1}7ySPwLr3Fgcs
zjQH|`8F_SVXL?3DEJEcE(&+tlhi&HTdfm!q;|s$SX$$VOg!N+EC}Y>$n-evVKx~?}
z|1L<0My-?GC7g=L<qC_?U(xSj6m81tdIttF&B8uzv8?pIz~C=bxIkIMldAlf&J&#l
zV-pk2to|BKk9*+=x`j9_gdQ(_fR`S|=Va2Xn%AL^**SD`0|UUVfnbGWS>a`i?hZtF
z<wD9Vge1sluc6fXetPp@<%2x`f^$nsJT@8hR~Ajc4`cadN*mHMSGzN98=Zs^cu#Ze
zSlS#^HQs9%!#Gj-u-(QnGCLwD6%{)2D}$n(3@$}kY@2H3CtdSGJKV}lB5h?vrRW5@
zk*GG<Xb3*`>(geq`Rs;>QI`lM34`ea@XmC=LH2DSt>Fxayh`$B^#1!>Zif!8q80fN
zivq$3WY*=`Ek-k25(CHs%e4d2g-$~4*+0!kf^thzqji-#kXgf~>UV)?oYXpR5jk%$
zRJu!e?bdy)%iNce_9wF5ZfCy}K8kk+dB*TT<>wYm09;ELj)UX>_D{Bw{@Iq(U+??Z
zT6BM{*T1%2sHJ&35#VRol)HU1B;Cl7)PWUeAj&A;_5}|`S51&>W=|W<pHB3T0V#c$
z$ILVX)gDRd@hTS1&`lU)v8WgSAi7yVSZ0PAN-n&(CMFj--(gYW$84SKtJ+u5=X+e+
zvq#g-qn{QT$%2yxJuPvgav;Q$y%ic}Myvki9^Isjj0~Sl;aRG*fffvOHN0r63zQ*Q
z_A7CnzB`sB&X4o*R76BXcuf{mlCfL}77}m^N`a%OWN0KA`FuPC*SQBts}Gnt^dG{Z
z;o>_z_#D-#keQc~oKIP?&hN5KhV(wS1-Ho-iL!6+*f;xJB4RhXO=tk6LdOp^u%I=%
z&`Y3SH=KKbZQNpJaM!sc<oODupm^t!<dNn?7igu9O--Rb$qJ9dnSLRWQ&XcKx-i)Y
zjp6!$KbiaY)BJCZmP?FMu|W59eLnu48Uy`k1Kw~Po-{wvWxreBv!^uQu2v5}3q76a
zUSX}MJ7;pEE|kTnWU{ZKR1S)TGJczymFCBlf(k|o78SdHu%C+(40%TZe-+QT@eKHJ
z_`9M%yO%oS;_v?*!CnX}Fn2%EfWjo|*PI~{c3s^8xsYL?<Mq+f8v7%lB4Y<6iWGFE
zuZnKi0FB)14y<#|bna}kh70sFp%IwLAItQ8A+B?qD1#wigF04*;LPh3t-Qa(nd%tE
z!wasiJ0);)Cn1(PMfPs_(+f}xRbpk>j6b}du8U~4ScTXAuBx9G`ljUSKex1Zo6Cl-
zCx9ZM5NkjxjF`_u&2>&MZM9dykkIx>hq}&%+a`;L1}eWYZ(`X58e|FuL)8$cpJx2%
z>oHS<WnYjfWHK3c5KFN6_I#c?=KS|5t^=XB7pw(|4;4hvhiAnarf7tZ9j_Wmu%6{}
zX_1R2vpnb4v}9}uV%NBV&+OWgzIrj%X(3EZQvEgRj>i%yg@qcx=>EalQJab{UNqDY
z>*DSGtVLxlrgBNChb!mMO?o&~?z&$(C}^rD-l;jk38GH2))%_NRd|wxeRx27=0+KV
z;N5uN)%mX2KX*Og%pgvO#R%iHbb~-5L7{{|WA8Htth+3tVCVuI8c*u=s`2dmvwiBY
z7Cn*u%1e94F0yUaSazzfV3lj%#@Grh*u66!Px2U`uKx1BW6s}CXGGT^<QA>NNHXHZ
z8HF5|-ctClap<g$H5DVP3l+3<E=cNlM&;9mi=iy9{%S2KuGGPq!pPML^gK8A9Zyhg
zG&Wj#3*F(EVA#9Fr-g-tpZam$L-o<1(qk0fR|mL%)@)Mq=egXPMk$;1Q~_r3!#;q$
z+nY@~m7<6AB6gNq72LY^<}Gmn-L+Zx_-W+00Hr?;8sE;yaZ%=WmPO&T-m=?l@P|6l
z+_BkW+H@Tm8h+QGA6ouFuk?ya@P~2Es%V`==C2F24d=*%Q#Wv*Yq-+)mxV@=`#b-7
z6+){2#_KRBaA&s;<&!5?FVi+%5jpY87Yu33;jf3OiB@hQFZ<oS;<-eEm3pjdO}Xp6
z8I`h;(SwD}FOPZGK6JYAf#f5$#|JN>re;-nY{SKe-!@&0QuT|7oKCvyv(33x#(;B`
z$<avmqYltrs1eLnLuLS#$w4)2=gu`6Xyp$4_~qx2`s!Gnu;!dRx%M*={^jdGdTsZj
zKF8Yqbrkd)nDvT(w3q+-i2vlZ7`L7H@{Mk)XSpSjyFe3*>KTW^Tabg1t_7dSsDKQ~
zYKDM`GP%l?OIO~bdIKC(AwCiZTISgUw9eB}CdYtB!P_w>w=hEeGomWKMM$Z>zTV1A
zB+8@@yep?BeyBS_04dxIstC!kk)&u@OALs1S%;bK>}_X+Zj{n|^3iiWW&O|UiR&qt
z_B6Y7(sorgUVL_a{gKEZOr27r`~6nGI3Wv<`YVDkf1M@_<{z1*)*ZJ76XmAM?elZT
zt;h82CeD4bGFyYuwt}*UQp;ai>Hk%FJ;Sy#JMU2B`u5?8wEcT%V2a|5=M_4?e|AB4
z^4W{o4-%340|EldGUU)UJ=^^CwE1%|-Ele!BebHUqg#xYhvWrGM*NxBDlQ|G)6b63
z316Da{jgDp<)iN^N>yJ1+*399i&)$H_err4b6E&E`=RzC$UH6Oy<Vw6phj-0ke|$J
ze*UF9Q5C7kw+USuB~e-blcu=&_PMEEoyVtsICyPiqhg{B3DTay!g~kgmn_IZmSBvB
z<2p+JN%cg(F54hb*x-gLh?EBpzB85$I71r#0FB4vOym^Cc&xx1pTYAY9|fKiR6Ako
zY3Krk?l=h=U{h+T!lL)=l6PF0*EvwBNRD|0<;S2amP!w4&}ZDmhAecu==XJvcjR%J
zR0>O%gW>-X=SdABC#{K_G4XGVFrRkSW^vF}AdzATf2;Hy>ngM-IgT{N!=swi{5UP9
zLAe9Wt*C$Xw!D!cJA@uuy~i5!iTdM}4IRX<FyGwauQ^~bCY!E2ICTxYVTyQg2)<+a
zb&C5-OH22P2VWWku=+D(^aE?g<S}P{5@7DXg6qAh;r6`fD&0h|26X;zWkA-}ijiZM
zi8`YM?hJ6A(E~enUbCwuYDGRN0m`GPt=$=X1oO@F>f?R|!1P9ZtLpcyz5fM~%Su0$
zdk;G+vh#k6c5gn){Qb{fZnMVX?ZReW24*53E!JJk)7XMdU7aG(wYqHHv4#q%OK#gV
z>})=qxNP+aT4UM+VH|AZ&8;da6KgR3k0J&9mVti@g$`aZaeiEi{zcUH+cjNJ9(#PM
zX{2}s^OY;C^V4AKysbem!1^191=Y>f=P|3=jyU!h+X$3bkkBGTD(^MF2(Gy>Sa&(M
zu+Xe{LFtmG(4*%F^dho(RG3dZq);^MiuZ-av=UzFMADn_8KA~Y7o%lM(r}%KMA*NN
z27j<A=bYK)1j2FERC#YPc&4$9%^I|{pR<lQ&5w743@kGezdLxXJvbXhP+fiYnLulX
zSLz;zBS)g8Iz}COJxWZ}YbJ{!N-L}#C`;pcQ)G_V+=&T>;}knmP?MU!=FJcAAD-X>
z_A1_RAP4H{&RXL9u_~KZ&|TeeviEOQ`^A+p&ZadexkD$i*+i%R-mhDfM^RTC>N5$n
zixFV*^c$NMPJzZc@q<wDlm5<PdfVSrf*%CiJQq8l_~*Y~cBZQY7d-#}4c0yOt+FA{
zV=>xCkS7^3iM%4-)Q~qU<NNA6t&Gi>!`?tynKKRYW~AFvTD#a0+!}WS1<cJs6?@(>
z5Gn2%hA%lnYqTr_`j-e&VLbAY2r;lSs)Hw8kua<*k6UwpcSiU^_b9)}qq|s&z9H&i
z66`XvE&!(LAnvNOe*Lvjs{dyYAS!!N(H+wtUidZrkb}hszQ1r?_?i0$qeO~3%&isi
z8^oo~40U5pegiJ{FgrLLb1b#-%O)ndHtLD)IAOB`Q{DO>Ub3lR>t*w%5#Lr_W|~LQ
z%WXVxl=P0zKs&|}QU{X1k%~ZrM9_WlmfBwMz)wQoy4$_5b~aY97+bKw8_|f=&9f+M
zjkmB%K9zgsZQrgPsSD9Ex_jvcoD*KvW7!*J_CIT3+5~^N%3EbeW=az%d#t^xoH%r&
z<!-t&wCs6ME0VyLpdQ`JFudT<`Lm}ij_5BJJa`$Y_w?tY@_iSj%SxC(>xYhpMVT}#
zF$y*3I|Aa5Jw~TNf2#EKCfwYcN$N7obD_g+j={PuFn{VS%RWKKznY<^@kD!##+#;t
z61aQJ%t%9KdXQaSLxQR$iPNgDp;0?`>Q<)4xo6)((s<<%i%Y=rKsmdEl6y;R;<3kR
zA*0DVbbTGc4V?g@I<1-W)Ze403n~&Uk^f>ESote>Y4CG?P%oLaMcY}nqcfY9<6G7D
zk?H0_e-udWcsDBIp{F;Vi(f7a<gf5h=|R4V$+9lHDlqiF%d=?K(6-3p2D+?NoYI;I
zb|E^b&9#U8SoUS`<!w^Z(tZ$}E)xY6t&qtEJ{I{_q3km9IMJ?2yVoPmuT@vM*R#TQ
zd}87q+!fj>WCI6he$QymTm8vr2g`fh@@#_o1G)*c)#|xl1A-bhJb4`BHnH?19W#B6
zJlC!f_CZW{_|8F6{?xB3=J~IXN_ATfr)Or!b41#vjL+|z3(6-<*#-5B7+c_SR>2>C
zRW1&m`IrU~UtsqN%_Tr{$rPpkX7w6X@C|uJ<dezjA{#cof=|fk4;rX#35Vr`22SQH
z6e$A&KDQgzTMt*riZK~M&5(BDS0{sE`R0Gtzjf*Kll0Wz*k8;U*pB5+7~1WMZ!5H?
z$q+w1K*pNApz8tXC~Ao+)32?N8ls(T_jw=u1uT~r2w>R8Wd@gO9$O1{g(uktc0WFR
z^v%}gsS10}ep~S$cFES*s55`xVs?Vm7s5>UH2mz!hw3t#XTR#kkx7N>HfljzI*S@V
z2CH-LkoIzI;|>x$tg^z9+ppd{IN00A^rPbvGX*Qmkl9A%5}2m&fJ=9~WQO|=-!*oI
z9r5%_1xXMFU+}ysLS!l^WLgM>tPz#D6Uk>rnu5I9+vnUrFOvwdsL!fY0Q-6{8ma+1
ziJEd|nC~?SdB(+5my8f45I;Tm)osc~yvA)B2aKU|gl+P7_9RQ%hZUV33OuaXu$K5V
z#?9U3NxGYhOKp5v$-aq=h3AUC59;$VMv;rWAGPdof~nrvBXoXcSv4xm=hZ{tA#$&R
zbHIV+7)FMb!;-dVe0G<R$ueE`D<36y>~lU5*dNdp#z`IU*m^(>tRXJx0p{jpo8&zX
z^`++o)g;c>+FJcnxs5$kJ=m4k&{_pB&~m@BjbU9d6G!fvBQG#wh-Y269r27xfDWjw
zNL%VCL{k;2HkG?kh{%Ob-i27uMsZxzke^rkScUUT^yMf?*98PAVQiz@v!cHZ5Q%xL
z&Q*~T7dmVD>QQ4bFrkDb+@fm#OF07`fkBh=1vTxZ+V4`kXdWIOuh&c3+=1yPx>|%G
zI8gw9D#OUoYl+Ck7u#sYP(zUo2>e(TFSSu7P%=rm2W@btzDggpZ9I*{W})~9xUlT~
zD8R~QwB=uJQ5tSLuF>-B!i%1jel(>ZDi{1MOrLnpya%kc4?t{M#L}29e{rZ6rvyk>
zP0pITKcC=9Cdbqm_UmqYv!$T0Jn&jiZXnrA&5gO#xg!FMaU9s5!k0cNP&2^dbQeT<
zE&0_?#=R@JYNDKGv`)ZyJE;2EF9Qku$o8}GGF>kuj0|E8W{*Ox8gPOj(;ZE6u$p9B
z4=kC3T`z$i&hjhp@;Wyb@@48xx4HJ#r=?u;gNkK2Bu1~DEPI@)*DFn^{BX^DKK%JF
z>yaP}^BQel1XrmnSpJefmmeCz-{Fy<OlxUK?X0u{S62P)9dVJo#K_!FUU^_A65R{A
zZ)MCZ(k<YnMd(wlKnnofr+J)AK^k-ogh#5JL7bQy?@&Qi;+6(A2}ZRF&z_$JKO7dI
zKLKS8C?$ed5zAAFP%Ix8741R0fo{kx6?R7ll9$D`O|mJl{yHc|An%nRi=c$jiZ>M!
z9`hG5^;c>YeQm6>!LSo8Pzh2|UKA1C^cvdQvx8S8Mj?=diZDt=y#1Tx4Gn-(nn6EX
z!wEJKjSZ<7X4vki*!R>&^}e#Dz2}r_+3Bgtqh|T(Ai=i&Y%Cjp+EiB&g)92VR|>Ji
zPxHu4l|Dnh?LQljpr-sS&t19_DX>jSC`;t#WTb#g%-qR#>{yI@?wKYOi%8ksp&#h6
z0G$yE<h&Eb3vP>$I-S82*m~i*Y$vO-!_erw!_Ng7deB9|HhR@ebzUfV@`!8huyV}J
zOtH2CXWMOIK^#Iuakrt$g1ORtiObFeaPGvL9f5OsM4h%Wds|vZ9qmqvyR)@kul3XJ
zk_TV71=Sq6-+;z#z#0c}(;K#eZX1~jlr5Lb`reu9t7R^==gdNxHbO`V(91xsPkFa<
zDz*{arGfyWSBF$hUIx@etUK*%O_+OY@92080Jx+@yBX4=AAGh8h(Ux1ez8;YUa!7N
zY$K$VjL4;&NF*fzWFH?NF9u&Fv;DML%QkC|x0DvZ`KV=(12Dg8wn?Sr#U}knRH`A6
zHt4D8e!QVDn@kT=Dx~p=sB8u@myqc->qvA{g0&YQj(b2)WB?%XCS8nD9jBB>37!63
z3>M`}vSZ)EnTc};%!;W!J(g}cJ>3}@R{BPB4<ttRW%5pxzrT2EbYSMr!A(ND1NKsY
z(>X;*iogzI)4&$c(okAc?Pmiv$=UhBNF07Pnh>UdjB#nYe!|hhORlc3p#86(=AcEF
zc%S57kwXPyh#*satb8VR%1*845uCRE8I=N@?NqI7uA_bWSagGIkj*B8={kgpLNehA
zQCaqd?w68f&1)0m>K^N-Z(*<2Q4W-3J1>qFijgOh9AeNaGANrm0P}Nh*{^(`Xde;M
zYQTA&24N19oBXy9`w5ZDy>b4lS5Ilxvz}&~g}`KDe=gGq4kNyk{AK4`sZ$e62!8>7
zh%?puVSaudO5YXvmGdMW!zn^Dglo^JSmI`dBUsDjj>pgq4RkZL{kg>_F96QN*a^?6
zjb$Z@WgKx_SzyGZgS<P3X=3pl%zT9}=_<MsodEz;&&-R51;s+^ij@MBTIvW=p;}J}
z8<NI%ZlJ=$%Es8{alR&2lNZ|2;G1%q_fMw#Km1Jw3Kj2tgJFUSx$^tkP;RRQbv7OW
zBv~)}OYEuE#rVz)R7cME*{9D#ao54mLj0G%U<Q;`)MfwnwKy!+1}b&_F{+uA2sm80
zL{vDDFB(Pq>vVk`RL|hVg(=rem0PFwN^IZ#Eq->ggdP|Y(=S_-XE=RXVmQT}+z94W
zl*DCVzOx%n<lf-vLG6KHt*clQjcUEDu`RQy1Zov8do!W4^hkSOm0xeaS*U$SpGQec
zF;GBf=-Gror#RLAiTQD@hJwzbsEkJ?WdY&stqJX|I&<wkx~^~TYezEtJGv$cX^fA|
z_%zXp9^yoSN)H*=v7el|GOR2t$9Ik8@FbbYm6>ipDP8)31+B+FjqMuC^(@#E`s%yu
zh_u?X%lpS_<74bEO^vy+r;ciI=bfQL-GWTqIT^%V8q~#$<^@(AAA^W|9#g-MnpeAC
zd+S=e`<CzGzpV`oB5T4QM~KMRG5V||RDsb@E+EU40k9ue4U>-h0`4s5t-XIq03Myf
zU~+s+|5-2?)91VFGku2YN08Y_INS=1nhuWMyJ#oXsJp6>fN{x(lQ@seRHQNuH$A_D
zSqpO$U4{J(Kwa*Ek=q5j?dcg7E@%Dv++@W*;j68zd$R(|9|ck$<aD-zPy?&P&^2!i
zc}8aOqiZd-V%$M60SzT{1pw7?(l#BNiKD_*sqQ&Vo4%?65Ox#3c!BK?D4U1uPiV{%
zxna7f3uT*@?SeuHibEDwq18R1`lnjL3noBAY6f7@IW~~1W;><!Ecf50*R}wVMzhb*
zz^;Bc1(x_s)K}G=Dt%Y%Kh{Qp1hvB;*gKD@HATzP(U5kVT=1X!=^}LGc^@TdNvP`3
zjRawcG(pRi3G4a_9AMB?P1?9)@1qd8Mrpz+{j9MK`|P3T?_0M<)Sp<RV+~fRywncO
zOT-72-?6l9{ycPEo}Led3v$6BHyy>v(}mP!H<_-S%m_VHy*M-t&<<<@yPYP|-Tz#P
zu2t&^U?m8!Lb2VC@EU@E${E2AUr3h+RB+ArMg+N;SrFOQRfSj{oTCJ2zp6n#&;?&q
z2^0Y*B<B~})t=fFkNVqb-oJfmyA*y|=iC)Z*K&w)B{ZgKHDj1Ut-n_)m`}>q@#>&1
z`?=J6u}@C}=FJZhz^8RXIrjr(!$f5=$7pp7!D^r|goxHq1}6h+Ydz!*Vj-Rc1eWry
zxAbwXRx$XW`d7+|#eJCX-D0c@9M<6QT5j$S1F6Y9ylc^q1I>NqJdXC`$cUu?RK16-
z8h@Hs%%(1nqA>+zmY?^s7A6>gJWv<VRJ&>M0-+=;&r#<P+jd~F<H=b1SS?|m%AdY&
zgvGb+AG$pWFdvcI6hdi&zaZdik8zZIWrO<m;Hv{H<^#HN+z8>1vR8G~9@(o+MceL*
zPhpq#c1ndbC#X%F95w{KdJ%muKr`^efsvV%&ZizrJx-)aK#cHka-sR}CS<hxZ9aej
z%n7Mr>h!Ee@I3TT0z0bZfYD$ZP4%bR$K5isRn}E=wCKm`J<ZBu*3V%(o)k=Y6$X+Y
z2U7nC0O?afG423c(Gi95FSVTXK&$eBh~+dG&F_XD`#z|+D^RVbyqDcF<e%-yH8<;b
zO0+Eo;nW4h)RssK&+e186<ISnhfD~0T=P)-iHT^FW}DIqO1*7Rf5%i+*<&f3^vwfx
zVw&#6572VAL{4&KRskyDIP>wPnxUs1U~NF`MJqG`S3tr7{5`(}(;}l0DGLMflE?aG
zm){(eFd^CayxeN}?EH_UG6EGj?SSvo`psBS?G{eJM4AR|#h2p;$^#NokWnAc2tJsS
zAHHUWAXp&ah3q`maLJXk)yHJQD;m^JILTf`EthiA6R@ZszySzWdXDK1;%GAX_*s=h
zF|X5fOZpw=AgPbi_!G1gE+}Q=$SH%ugoK5P;GE}~!a5ZJxw9}Ry3j4AH$#|uIxVdA
zk58S^?|ql<u!q2)jOtUmh@PBdtyfwXLElK;V!Ho3NxR?+iOkbuKD7e=GRn}x#0irw
zN!T&aEY+!tAF+)(;O87IJJj3O!O3bH*nBhF3RiY!*9hE^Dai&znu*oyV`U<YnEJxf
z1^+T`;3HCaL7|Se?2A;d>K~B9pL6{j%E2u<18Jb*1-g0Jo{i2BKYU)??tV82g(NHw
zwzq$D$rvFKz_RJU&ud<+Zj{zmMP#%$eC4gNya~y)|8TXHgM9ehTSV{nfrlr}r+!C4
zIU2iYyBJMT0<bV3Oz!#&ea1|TdBZr!@xf>>P}(9LSHI*}qY$(I;Y*sC!OZWfc9i`H
zgsa!iwFNdTcUDk4SPqbdh+dSLdV`he7X@<qBlk}44O^TxH<I6T@sN^fS`s*?T)=<R
z;(k6FiE3b3?2*l@847$P1$31(-_hB6O24Bu<_u9)&u>d+#VG(^OOPWV<7jOyxMJJr
zlMYJBkyyEObdXmk><L91m`D)=zKuQ??de|M;aA$+E?8`Rn!-2uGNK#c=|PY@5vC6r
zyeyhx)NW$|pjm3j;#BCavDzsBVG#02GlHy{xH1zP`C5`Xebs!~V0p3xrD@ZaLY2QG
zu;*7qnJ_<Y!Czq-p>kC~9_|6k2!r@tj=+Nu_2<B`Rs=uI2|)O0B`3kUqx<Rpm0}P=
zN<%q!kW&V3W{0-NxkMJFr@v@oVqzam?4L;5{T*1FT9A7d;fCLDY}Q@+l*Iw!L}~G%
zgB&O0|K>+DGqn#fWl*SAm*$&+b%JJjefa*BO>XmAS%7{K(bEMwg1#-o0Ki_0jykkQ
zYLN<2UVSha?g~<42AGfb!VG9D`t}0^h5+C+>JRW*LFJa?4T>7QrzlxiZ!%h$M(RNF
z?h8LfKzuj@pXdfGAzX1tHEw>Xh|(eU3)%55q;xYhRzrH!Qh3$euP^4z&>vuX2Y~G=
z!+5z{+4G9m#ibMMYTX1QR5(rIxJ*zMKrI`duon<X!|wLWR-EXe&iO*YQeiUq%8_?V
z#=CBfC*x3V4^z}b_37KwT>((@nJXMR9kF$!wjL%RHj4-m5fP&JN%!#DA~<Gfa0*P>
z_DFO=IROC;7{S?xBvRmy)jzIfxXpR&{N+@)rFi~O7mXhv{N4bNS6%~<IXAy*28qeS
z#^<nl^{0nuCC&~AvOm4c<ol!V%|I4!!2D0<{iC$~E6SgycjN?;wJ!YjH)QQbU`hMc
zRyY4>&exrUgEad~54md(pIVL`yDaAf-+9s!wMGQqR&i$abPFJG5I`UEcF9DU91e2J
z>uJ0;2c*LZuvXyNohP?T&#oTZQY*Pr3Ute#pbq<vCc7Y=RE?EyCyrEAbWGt35lZ?M
zWkA#J&n<9MmPY<<M8(qrIxSn(?(fzfUXE8HYMj&rxEC)G{^{V3y^crgV`Qz%!V{WD
zz@Th|bSw^tozL8s*YCV}On4uq!1YGpn@JiCmnTn8<YN3AuLaZE4zbtYd}Y!ZWe({y
z9)hd<>9T74F?0Z*R+~kApZf?F1M{Zm-@O%eJ1}20{fF}N|D}cG{syGEgY2S=;0rhq
z^}|@Pkt;*(U0pdqA$9t^Us!7%gfGRpe?~pAxhw;0;2t+o&O+G`PeKTGOXlLCJoI%S
z%Dn_yIFegm?`aqYymIN-<2GyDSqz3Kbgi@>g}RGZPQRzmrtE9%$s<+(Y8q{@D6oo0
zlTy$XYl7wz%CsI--e_5hItGKgqX>fo_m2SU^{Sok1OSM|@4fi@jeMJ`V%`ioxXJK6
z86-!TCiu-3gR$BS_L&3XS^&v~^987-D)g3Pc`!1T0PC)e_k|{=BOS-h@0MAE`BbI)
z7M2-T2NP`RNE^ZXf+LiPP642P;ijV;*p`>*z7HldOpsj%cK{v(s0Bi&I)X{W|1$tQ
zAU1k!p9to@@)mRx5;I_sWXkhD$fpRxA$mukq8EI)jlp~x3!}rQ5O2U#TlPyD8!(Pk
z%Q{TdL+|xq4w}Ot4RZm?61EW*qs05eZ&>oj^_cq(s9PT;g}yHXB^hiZnC;VGKv5m3
zvZP@Me$P#zYcPW?$S`#B;E1oTa=QO1)Oi6K&=)iij<_~GVxa_ea}oH1B9|_-p=`xO
z$sI)xrsWT;%SE_wAkjI(Su!mSOum-MpUc6M#@^*HkrTLO^b5=Zx|2Bgm7d&%83zfZ
zE0VBC^za>u)+r~pqVGaN+BbeL$S<P-#5I_2h1+7HYF)01v?tWjfqbnFxab5}Uh<fz
z{|RWw7%pVw1ieKhgm2im{p6J$BA7Q@EFVH^nsE`H2>6H~1HKVR8IOc5=gL$pBDyfR
zdfLJw@$ju}Bah-tZ@O#3Mt%Haz~~oWw5b1u9ajQ*C316s<e4Pld<_1u=^^q@=YRPh
DMydL5

diff --git a/reference/plot-13.png b/reference/plot-13.png
index e6075e38df1992a5847aeb5c0d699703f3a3b9f1..be04eafbd9c45a793257b409816ca730fd941c2c 100644
GIT binary patch
literal 85572
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
Nf3oT0ioh?v`41C%lc4|r

literal 73842
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%0Ak7%p=SpHs)b
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

diff --git a/reference/plot-14.png b/reference/plot-14.png
index 20575f0c7e5472efe70851e9d9e95feefa60941c..c3dc4034c9126b435d4f58c18f10fe1b6bd47920 100644
GIT binary patch
literal 38976
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

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

diff --git a/reference/plot-15.png b/reference/plot-15.png
index 0659620f9bcaea82ada24237972e54b599d559af..071d225f00ad34b2d1ef08ee26cfb5c156443def 100644
GIT binary patch
literal 55162
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%0D6qLE*f~bRi&8De_5puQKRV5ks#&i}oDd|aN
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

literal 83999
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
La!+%g=z0AQRkI#i

diff --git a/reference/plot-16.png b/reference/plot-16.png
index c3dc4034c9126b435d4f58c18f10fe1b6bd47920..ccd1d9353a28b52c981749a1dcfeeac2806e2b5c 100644
GIT binary patch
literal 37343
zcmeFaXH=GF*DZ=BYSgF!MFa&5Dk=yBX@V4Eu%Un;O==VsqzZ^2Juya<rXr$(Vn7tB
zBGPLNMMOZ9UX=%=i%938?741}cf8~K#y;ol^J9N!@3S+;`)c4R_kG>#T5GO3=elzF
zu*SY+OZb*>aBwU;uwPZ1gJXd!2gg^(zgdW%G~N8;6aH9u{NO%S{E2@if6Dg8AB)fI
zKkCH6!GDSVH!rAj=p+ZndX59CKkB%K_qVv*&>hWGnYCE>`|^32+P_{gy|Tsk&iZe@
zIX=%^BDr0AL)Ds5QG*R>Yq*XdbQD{YyP7N1RZNwYdVhEP77_D+{rgre;QVgeymf0%
zRSX7AE9!TIZ+#^%mGXYn&{}V-KUbyFtKzoj)9Z2(!wm}_>xghO7q(I3n28+ow}KCx
zpXSrwHs0{zp+DFE@pTUU$+39Ty9M;;{w?z)=+9ld7rV}*zi_D)ETuoM9-ePXfBO8!
z^?yF%e~Yy!Slx3)G|_i&0N=^!$1jdu;=k$e>c>U=ItTC84SJ=?wt92i&$BkDTZUjz
zz7Z0#=k)2*sU^1cPrhemls^txI+_rX5HK#t5i|Je|2A|4o?^?i4ZV`8tae5;9X^Rz
zy5G80RMfA%z1?-J!GbkfXBKpR_(Rc~=z~%5@!Jejt+)r8(t{FBvWqKr4z9~}8@*z3
zu3=NwxdFZe!_?SXXXUBxDA&)Wo1-!^c3koEGaqU%x~3K#>B$~Tt}}Jt6QS(c{`#jC
z0raLNOO`l}O=&;YIdoS+=3@pc(Dh?x*YWZ@GRf?Z*(IOe|HXRtR>N<#nBj?a!*32s
z6q&fRa7*NT+U+q^#8VZ0Fm%T|pRd}xROZf)d~9(~VIO^Z;=rLh(pw*DMhLupq!|>X
zGP~pD%a`q!RHl#hr&KCSTE4!&qc<k%c$jV4<I=K<%h-o+AFBH;5^!CA&ugm3AnWYu
zv;Fmw%N0Kr?3fvOYd)AeUeVJQn`PD4+SxY#JXSaEcx%piNsEeb*SVQ-^NMi!WY?kg
z34C^YnMA(-@5|N}%Qo4pq%~>HbuW2x?5{}gx!J1tqbXT-DoLLwZ=VbLYM0WD`5ZC(
z1Ux?dsS_q^tIer35W!>W`iENGEoD!)Sfg}1-NYuWZuJpOCEe)8pML-L05><c?Pn>Q
z`X@RfA!-Sxxe78TUR;f@vwHL3fK_kx<Fz%$c^>DjDwW3LpOlyfDaq<;YilQrPvwrc
z9vnz65zzG#4BYuKqdL^g>u7>?#~VD!BTDXLc=3-H7Dl`0jJ!FRa!>!-Pb-w3J<mTT
zJDKIOLZSP<zxh~`eSW-oZK6ro)KHLj_>l7|Ztm#BoX;<pn3a8)7<sFiVmg>wXBwv+
zV4ajJ%bG~DZF(q+tE|dol?1iLk1Ggi>zkfGX*JN8s@wZGYtZ}r`SZ2o?|b8t5<eN1
z2zq-IJAAe9+ZgSn$=O47#oj7kanx8Wqwt%U8T1z1e9!ebJ?Ha}^N;=Y`x?pPsv~`M
z5+5of%sL&)LM4KJS}wnFIj(c!LzumYV*0aZ(tVl-4jlM)%@6BM@xFN0K{d7GpWgjB
zRJ_(+RkiR6w`ipM_{Sl{td48TB|)zpzc1(K>+I|d$-DRY^XD}(RyqixovohZEozl>
zwQaLw=@ai)c&|Zx#C^VHe0!&h-PxWun@&}PAANsbB7fR(q_;*iZ>l%0Jg*kd{pswo
zl+y8BBmOpzVRgEOR=2(c|D<EDZb=Shx6O!m)eY1qoA+b6c$3bv2h#Nwlta{t1m`A7
z{8{?~__&wxNxwLnWL^>&VAqmWgo}058_s^(qH^-&N$$Y1bA#C3e>`_c9lD*UIlhDA
zi6m;lVTo6_r8d*^$f=Q#kO+zjR1le+s>`=K7qIon!@`1JzA~Sg8m$p9($?lund#AF
zAs*u1OfC}iI1_J}Dl#?N$7AL-c`~FpXZmy5&;%<;-&I2-<VvuH!dAP?&YL1N(|M`Z
zb;Zi;{*~BFZSg~4tiGiDz&uZOabv1=+}YXoB0uxj_kT>bX?UvWGG;%S=Mu*Xv(LNy
z%U6p|Et|B<9j(pie_HnW+>B^qh7fBOTUtU*O-*FoPV-`agG|Sh#pWCK`o}ofx22yb
zy}m};@^Hwk)&u3ZfXcI;Stav))KTYr+}`8yR%FZ}LHVyxnf{?R$xILrEg2y}A2B@~
zG3T!`H(8n7b<bVz@obAr8-K8{daOglV9v0Hv2%@Xjlg)Lby5*+rp{sgL}Ol)>~jJ5
zq$h@Tym;mpO9rzC^KR{MI9_ayt#<jgl*K~}K5>I5>lZHLyD`*^@6nY%lknJ2JZnqd
z>{Opsz->wMz0FRQN|UF%-9LK{>giI@@kwv#vl(<B%$2K98gC9a9cEJwv8;}%5@wf`
zm9ZwfB9hM7q<MSv)Fqjn?XBM0moYaHH0RqkH#@FnY`hKut(o73hdqRJTT=b_NR(N=
z7jH?$-JNm*uJ3+X!hRWTT(Nsr&(`B%UzyT!juToX2LWy#Aa%wbd882*-+<^U(ZL3b
zHdjIBs$M47eAR8VMqf(6EY(Uk_Q{hU`Wmn96F7gu>d#*nJYKd|_5l*3wjYm##$AVE
zUhc%rlYcG}Jdsn2s1aQ!cjjF|^{)$-YU6?)U%!66T3xP1r>8LlLAqZF*`0o-bM)xZ
zUM#nIs#T3h-(-a6*wNxv+7CJx7B1T!DBp4QCwhCB|5h=v@~qiGtbkch+rx*eB}|Rq
zyF0y-EP0?j{pm0I7^}a2U-mfDsq5i#<a4#Qw^wvr%4<AYvvmi$5Kae1d){vD>+|eS
zE)f~nq%WS;9qF&6^XzvARJ~ZOsJ*-;N<)P!c}o=W|Bp+9H(TV`=O>|1Ilud5(W&@0
zgz%CQy9&OXhS}wayT`~p>zoc1JD?nuyL#DrJ{<N8`ieuwd?7Ye7nXAyib(JbD%q7^
zfBjXh#0BL*JhS6^cU!)9F>8h5r(Ly4$5sd`D++jyRCObhN?X2OzhvpsC_Dv+Iun<o
zB(Kr9__~~dv?h^(J~mZFDp-^{=v5A^Vo9s&n0n_r6VY|!2%{pcef-=3Yvlr;KYw12
z+`~eCdgV6ToarR>(fiY%i&7HjxgoKu9((_A?k(!c?+zvWE+^JGm5HV6Or^5#yp)xa
z6l%xj4Wg8GuGyhv%eHO)h+Wn3k1ggeZ)|lan761SHOan{-I{R4xv#e9{*M>h%jMc$
zxlU(x-SgWJxZ`+ApMIT$_hgwr`_ZA>*PU%UP^QILZ#M7Qvquu?+~0ip&i*HBWNi$J
z*<)<nMM}kPlP5p_m>|}5t&cZ{a?%Rqq{B>3>Ox81?v>#Fu{l%Ht~tXX*UdSgx9!Yd
z%Z>)&F2$|)OP+dlYm11;ONGQNYnN8XGBMshey@r5M@#x~Imv^0Y`do_Z}aTM44-Xb
z%_83@vt}<WSJ;x)a;_<U)N3S4@MN=@si^=hYOO=&RWaWy6XWdLJ@)zr1_sfW+&XvX
z4Ys_DH%b>@xI!RYvRMqPQD^3@G}h)lmoxUslXky=lG_QzvBH&_Cz>M$2Ax~acb)X`
zmfII9Zt_$huHq*i>qwDfXPv8yEwT~^9XReg5+pKRv*XOq#WNfB1^V9<Gun&Sw%<6S
zae1wMj^x8bx4919-1b<zAPc!W{+BMFd0!F2C{;*15G?F~M{-gz&1+^Ve#LJuPoW_3
zjt>IW94!fVs*vX$Pq%H7?Ynho#Yq%?lWoQsKd>f4%0Jp5ul7IrYdLR_dYEj&^JE!H
zc=0LMT$*gtE!*-uYm-~DoZ~(zy^Qu~$qqRR+|rLUhD?%Enhe-jv~w^g*m<DAgFTw$
zeb>SJp|{N>^61mV3t_ghpFX@83z7lsNKKT}7yqiYar#hQ4RVT306LEto{AkT|0O{Z
zxRQ_f$c#_Vm$L3(SbhZoEq+JVmM?#zNTPipy{$swBM?=YTfB(W+LVh=IXMMAN3^0@
z`85yK!z=-kip{wfTx$@})~V9Zm0BRmox7r~;(B~{7b{4mV#m3uk)ES{wbcMrPX*R)
zKe0cWH4d<`?p&}*-p7`gRM%MSww&|B1hb-C23x~SvL6O2etzN4ws>_bxwLKu`KH0Y
zYplC!LzZ)&UQg;vBw1vmfF`?aF%9L(j(X(cDD3g7XQ$t)e`ML<N5N`I!Amp0b+sOr
zGSR1im0=$2j@b!T+^P>Abts6e#O#k(s3<4T&9Y1G$XLtDZ*IC1!O4kbH;Jz6Mv|??
zeO+zSud<HY;`(w-rmwdmFs|Ek3+nHiH*c1BKP{EL@B@#?RPQ*@lUdJ1Y<Tce04ljU
zgtF;?mt(@wlv55<J&!CD$7Y;EQW65fY*&9ur>h4<^96z`zUTgt7sbr3*?VqA(sOFW
z0NC!vjT<&+S6CRu$+owp_y#|eRe3u)Ah3u-Ru}-k_agAeUIzz<+NAmVA1?Bk`fdnP
z+>TVH!H(_zes@i#UdpL*M7E`#8LK!z>SL0GnYU^7Ia`zTtGc=Z9OxGYTKSdS&R#rr
z%9dB&@kH^A_te{nH%X%eX>ldutn&@0=Ixti&#C}Bw}<9WpDf;Vpf~R2tT^|Aq|{As
zEwb`jSR4h#XjpgUR^fTLc82J;2gtShN>wUK-H|@6oiKzPW(+K39_5MD`qIto;pV@*
z+mJp}a9uO4gK-H@B*O%!-z{=>n<=k~+~XHtqKq=8R#I16_i@8#r$M_!?4_d1o9`KP
z&3*F(P-5RBjk~f9`9Kc0<m^pVRTc3Vc}oJ<NJc*QUNs3=5I*{g?PvoYs;J^DYMV}`
zo~`%8zPAW;n?q=vt9N2;FJqrb0pPBs@&zCzD(N*nv14v}IBH*z0C%7#x)`~s+@CHj
zKU(PtC@MOD8#66+i+Ad(2nkG*5OEWnogL5LClb;aA8}>=r#rD*c6rZEc8T)Op<C&E
zdRL^hGuP-gx)vD(eDF~HUn^ABJ-U0&@NUJeZCkeZVu2M|$?hLBHwy{PPL!yeQoLt7
zW?z_ZF*w_+pa0TrI;$_yFGzW6i`v11Q8_t^o=J9qfxYEjr95UH*G3Ic0bkvbiF=va
z+bd-f_OFm`6~SkZ4K$Sy1T6IBbYKO@756u!m`{H09EzBmjNmQF!3wUOX?<`YINo|7
z5BQJUE7u(<WeA<wNku&!og2=c%~LTbS4Y3<v00HBYYoWYkFMmD;#jNuU{P0u_dVzS
z=NFgKXHHrrXlG`)h`t3hbnS@_J>GTKrNVVOkNwflY`UGtneX$xvu_UYjt8Ltd?*hK
zb=YfxhbQ8(tNHq-gOLv&Y-A;`wafTkJa^<xHwvG$P5qgu+rtgT9fm*t_#=9blZvwF
zxZ+u{pI2zK>DEQ`G-d!E#u8z2IR$y?lqbiLhu=MlZ16%Kb*$DLD7t(qq!$=1{duZW
zUzE+@Uw8z%1B=#U_X!hVHh!l2M@of)XkYR{@yv~^S@eOpX45>w*lWG5*&(NE<BuMS
zP*!4Tf5XY?(&p*n&nFXGvAb2)wz2U2CBeMXSsClv!Y_TfuD*%x`|HA@`iZaHY`S0n
zag@o}ziK$eSybNR9oM|QeG`i>ebc5*4j*n?=&=<>hotWIxv%4hF@8F0wwU8dQC8<o
zqjuz+eIbI|pZ)yjum0?8m%+T!y!U@yvPc-N%b%6eQ0RFu(Gjfq#!SmJ&E{yhOY3>b
zbN%)4tO{Urk<p_O-vW=AZ!s}6<ooN=iljFeGWC*7`2j{uko<)0vIo*Uo@HKJsj=hx
zJ|@^Slt!zmeS7Pjy~l4ggFrNuMs-@<*?P)@EwK}SuJHQKK6g~_nO%zlYX~t=)Lj)N
z7k5tl#M1Vz%7_RD?>*kbzE|o_c@e<;IEQQGeiZJgcG21Cbb-%2-to}T(301G{PecZ
zJ2WJOYSBvf{^Whz44=g`);&(BJZsX%;@DNhq>CTi$NC9cNZYq6Rw(qvyCOHTP$L4d
z!VfG2A8J1~NIt#?HI)D8Uv-D1CK}Uh*CLCRxecI?`Qcpsu}g$^0G_b)KQ*K0I$EiM
z{kxJ^hpzr(&Txf)iGcU?P<Kt7{xnN)&ewaU&#Y%W2kj!21Xny1rjVnk7oQ9@(d)eb
z=wVu$7kkHO^^p{Th#!vaCbT}2-h?YiQO*!G`+OddpFK7})uw#vT^vQO*Kk;y&AFL7
zYkv57*Toe(rxT-slohNG&m`EZ#N7@@Mi|1=E0$~XSjjnOdaAR*A|l{pOLkrFb^a0o
zcbi)Cq`WCBoAj1*T89sRNBc~0rhA{H%g5&OEDZqEzP||Y*F8yG%fT^`h$@pYT(L9d
z_to4zxaD=|4tRs^0!je>Y8Kwudc>;Qtn!``3#lVcD<Dhyc%kntWMD<W_ONwfQWhHD
zu9b~no)udU47e^x@$>%FJjXnIV2P>w0QY!{i<!XACIb}V*j{YK9H0iGVl2Wl<$>EQ
z8=svvcI%0j$<lC^0q&(8o6&wnR77dK-A^KMB%Gkfi)$NL55w#lJ19LBZ~9(HNIZY~
zbH;}|)*|*h76Fy5<KKBMzV@eYRw#|U-XbQJFy_6l=EE1PwO&dJJ)hX_sJ#L0HTq@&
zz_BM3O$`jzXev*hsJ*1DTlDVF3+BkBRT&Pf@<gpVpv`uBZ?@5N{@nOnZ&rwiHIi5k
z`n0MTttgSZZOB-+WNi&=olp0Lz5LkH+ue|2LGA9*pdbOItmh5=la7t2AL+VjfQdN{
zwkJ_Lm$;0+zg9}g_dE!;a$e|!cIK(_eaT<|up&HH!}p(8Hf($^b+-(gxSq(`{W)Mx
zq(M@x+Bxv-$i*(OHAOSyZGyxcj5H5gHKo}qj@5$(^OM*+{Gr^s(eAD_;GI9RA=m_7
zfRu!>38IVmU7D{sFRSsOSS2KQ4#;##WnW9S%d2pCDMY@}!MinwbO&)8=teGDe;2e)
zetU6{U_?rv?jB@R;+nYcIW?RN)t&tFqWT@_%e+#j3bA6MO5?vS7581dQn=bJV+TmE
zTiZ{n)t;2fb4K_VqX<OC#8{>z=|-r$out$na5QorkRa2+<MAE`&qbUU%J*KnF1l4w
zy?9@2QB|~WHYw$@RS8DvblDV+1mgE%hr~H2%=>C#Ar*=D&o2(un+FvEE^`twSLDZo
zqIm^1Y9GLClxBpo19tMBB-7l;`}fytCgptWNBsVSeh%GJlt*-?y7nccA0O*)NIq45
z#}eFEKVWoKuKRd5R%m3fO$Bjr#Nz#FtOUJkhzP^4Rw#Z)xow+CmbAjT{xvA&0l}Ke
z@<eTkT>33jJ8axemmgG|<gw?!#jjYsljScJ35X_hr^?iX$g6d3-AL*B<KJ824g*6?
z-L?|3lYv`or}hai-Gg*w9%^##GK#w*rPi}g3`|W;qh{qO2bzP+k#uM;oM5-j3D7=|
z2Yr`ywug&)asM@vLXY~+clAk`2%^(?H@E6Ro(Z=gL*}a{tA0g)`M;q1tr!aU$;mBS
zw!AnhRynUi#an{IN9+Rce@{5zez5Hpqa|G3f9n581^>%R1v2q{3uESpsl0{ybR#sh
zE~6H`N;|UCl_6G134%M~!behsj734@Q;&Lc+fnVhgpNWl_5jbmbq=Z~>GRHOT~&+L
zc5eB4v}y6?@b6Y`)_8TgoB%r&&G6c<@qR~EXQ)}=pBEO@Ij@y}3l`fT<&-+T_1Hp*
zkgWH=uRZ>*;1?}DJw2A;96Nt*EjSROFFWr`;mzv>30Qw=ogyvrP{}i9#+u$HElN|J
zZz@s)zGn@Z4Gk;L>7f!y=iX||`qv4I@V-%#OUwD&ku4JXWM!Mu=SkR<DxQGU@&8jv
zY*}B{yx#niWjBlPY*vE$lu49v`tZuvcZ;ZKoP!vxOMT;F*T>Z;c<p~&5_oyKe7wzD
z<<Thp=4b1T@1nI)O|KwlcburTMVE+<K@_yqoeLGrEBb`-iW&BJ(CiGm>p|@T9^>!O
zE?xmn?|L9WudpfquUUTF_%8|N=-<q1Vs)t{w8Z}vJKYpF;RAhpCI`GeLT@!8%WwG=
zq)}mm3_q@>D~_rBIw$o6-sJ%Os-*Dp%D3!=->&%%%i?|ZW3znjV37B;xv^vErnLdN
z=<_!SMcTLJNuK}QVF~asAkD;Dwe?NQm<3ejfYj_)ecY>>18$S5jR8a^Rn=zj3t_)y
zx9Nhs1;BNh?lYTvX`N4Bziaz9uGW86?GxljQ*dam_36p7k!{VReRU*gnL`W#;cD@q
zG7~U_*<WZ{zTX?T?sjXw$K>Y#FWLhfX{PgA6~mO=&m9Vr6`NtBM7PH!<z11;n-GGe
z78Mh-<)Ox1K6I&pz=OWNu22+M<N0%*jLHRZC<DOF9MVt^A4o>cc!T7~S~Es0KAiuJ
z>oBNPfrIvD4n^D!FTTH|iY`l4m81z`?0kJkyiKt-M5x<oTL7r6E&nuAqB47}GL2+s
zpRd3B^q~RNPgtumFtVJyS0U#<n-O-U_v~<dYK44P_{bP8*YPz!-N)4vbRY6gr`+5x
z@t>>jaLqn9AUl<d{`si2^I)q|?#wKEu<QO#dhPnsuXE0)S=GdjoI^>KlWzr68Q@iU
zwjv$L?PlvewE4@kn3{O~P(hdlcmy^3N7|45yGWKw&o_yX3kGGoW!v<4gbjob`QGp7
zQ}>I^v%fb0X|ZPj>}O4k9&iWr9$#N-a}Gxt(rb2wRP0H>1u$NK&y-%%&Qe?v{N>~v
z0(DI}HNRBerNvnvf~&4!9Qudc7ATO-GK=XGHeUCUtDG7i6r^rZRrM8kd-DQ!f|ieK
z_02p(S`kGqc6^jnIk?KWmYuInw{II6^OMLkh%y}Rs?@X}#FEOyGSzuw1TPkXFu8zx
zKPM;WVE&v}fR#Er$y_Bc^L#aoQQ*2J76BA3DOw#5^nhpEYmMv!e0_m=KRghoZ@Owc
zzx8Ws4Ej2<*2>!W0uHJ|A_%Y+Gs{z4#Lu`0IOm(jzKc((xRO8JDIuRAZ(SQ7UQ4U&
zlW@%^R1NLOHZ=UX;jiAA<hVL)!y6mZQC|Knd29|pvpf9E^TqOyo&Q|GQwXhKm2Fd6
z`2i)mg!(&+T~~e}4H-Q)Cnpk363dQ$;ghxTo%$`*mVIawR8<wanOjfOxaizMzvkcw
z+xH*s4Nn)^-xC9ndo&8Z%*k*Cy=uQW9<MWY^~_;u`gb4Wr~lxl+kYDQxs7ylUc4w%
zR&7y!CnW027e83}>BCVh*YRS1UOZhq*?oZO);dWL6K;CYhj0iz$0L%%J{lR@9O0qu
z62Sb_XdS)_`&c3u>S@11Kl3!}-(W*g^LEfaAK~I$&&0!%Xin@BP<ppo?<qK2wa74!
z%*H|Sgjgjh=%}{-zP`UNvz|Q{dgDfQ2KiPvo}B#dQ|+%H0>v#-mn>D!VtzQQZukxT
z@_(+&Bj$HJhEmcS!mGDRNK_tRcJr=+gWUeSQo>lcmGH1w$f%&J3}?d8Cm{sUB4bs(
z<;s;Sk@4~I#YD+&2vOT}?2nos=?3mUd|;!~`?O5lk5mXymR8eJkV1TYf&BS<Cv+(q
zcYXdp-j@B$+K;yVws>XxR9{jMk`-T_A$T8ERm$VVskE3sTW?0$PRjYLMy=r^83>!V
z-@4Inp2%>0(teC=r6iv7={W-u5=ch*2=x~<&c5XeUp99b9vAoO)#Tv_4>oMFNm1A6
zrT23%ju6C~!T$_bQ4Ls)`o?JO$6K~;y$q>tFZxMR)R6I4Qv-{Ho@K{u^q3M9^=;71
zAqnzos?3~)8n9sqsp+JW3wEEMd7!-Ta^;D4_2}OtpS=Ffn(pP@97=K3N=-%1u5c%f
zZKgRHYF(ALBsYM|;Di`>Igo#6u~>RDBafH&GZ{$eIbTky5Wc79QG@_N<=QjpKwnkJ
zs+J8;PZqNdhKdK!9@T*02-?5WBAdQx*KR8MfXf0@aHqzX^D7ia%#J)_d?KU0HCoWD
z%)Douw;82vBORFp1N6%!kUEGhxq>TsSfUZWLsC3%qFuq2v4`#Q-0-eEWz)f%g^&wF
zXJ_Q{C)IHeJLtg@kpa%kBX|=JIFLvfbdviLvx@-&kHc@{P%cyVAgIli6_5<nWa!R7
znq4y+@o{Jn9;H`;ILrW^iGl&7CRPgs3mVv?#%KOq(BnxpuELGUZPyQ=#8CU}#(pW9
z6t9&~CZ4^`+=TA;=RW!{LYlcPfBbZbucq-_ldV+k-$@)r-x`3_EgOkoFC~JvO?aA*
zwZ!PH>nBm?WnDkL8yUmhTkBY(S??L3D~Vy?+f@&|eP_GxhBr;{2lyi4+Uwl~%pnU%
zaTa|-K`mVvxK2%pN1qVDs`*|sL{ikmO4_&P5DT}8hi9Lvs+N{kxZ}&M@`KEB?!Sqo
zR&bMqgdwn>CDaR{xI%G+OF=yOt;Wux(#;X;z{dpO>8bYBCJ@eoq2)WWNq7KDl2T6+
z@HT@dKS$lsR2)*3M!6I>T}~HuIEW(P>i0h#2Q}dUQ1n3X*%;X3Vu(g@x{sj13xG@5
z(S85I=c+H&`3FGEO_$a=?#I3sO3dnwg<n7`wRko7BkWXjM4JPU+K0zK(Z{bp{pwx9
z9^1xem&uyqP@}6~1bwU>dIWhEiou3{7vb^w0F)wC7$73iiZPrFc06H1{1Iez={bE+
z!A;EqqeYaZK~PtvSX5@&MXM2-bZK_j_obO6#+H*aPCqG;X)t;#F04>q6Qnd|V3K}q
zC7HkAHP{PVR&N%!kJZY*(+wG#!fU7BU0C5rrP-$u#UO^nE4)bx9HRX?DCW*B3wNbb
zw~~<F%C}F@^X$|-2N~jCi1#(eJ}&#w0@qj_f~USuwQvuQ$tn^+S$48*5Vg2)wHo;X
zJ`XtYouriwl?X-z8x|E6(F5Ig?2j%ss))^EA{oVu(&DLs6iv#Zw<Y$;a>$1H$Q?8F
zo*CUAt<A|<mG3>L@R6ypF$d*u@0ItM__Re_yrT4{jF@_&89`-B{#@XbWyb_{jJf<`
zS3xM%-Q?haE1)=FEl-?Y!pl8JX;nEyuD-o^I8?$+fFxqNHWK!ea>wo*&1HUn{(7*F
z%k1<dJ-I#Tu->o%?vg21pIO(5+vQDuAU}(^IP+x%a}t|Z9PI-GJ3W@3A7C~&RYxsy
z##o~@i`Zjd-w;v#V&GCi2r*v7QAq;nFoD1N!`aVga#LYA2(Ojez(?Obp{Fsw^=$I*
z%gmvs27#JX(Tg|WB(B%ksa%HOEtVRXodUNC@-0!i?XaH(*rvD0hKg11yt~td`iv|)
z27TAh@3iHE>|(c;$N0>Tl+e(UupR_!s0p&cakk@sf#(Jqi!{AH2a_BGG_cJK@EZTv
zTys>oAQwzt2c+qCVE-T((>9QZRstHg$sps*F;!LK`-C;`ts@f#Nn{$}Rf*ouYl>Z|
z<TesB^kx+n@TC^xoZa=NQ|aAIBJua9AKhL3=$@Mu^=3mU5i{F7`^m6`*e{{|1g?Ve
zVj<cJu#ER*jb3HK2~Y??BP2wMb|7xOHpUd)^0rClYE@MQLM>lB0Mw_efjg*SOY=<L
z>9-GyAZ@LMtYYLb@%~b3-OmEw@^0UlJA>>|ZL)#hTCn<&-u%{!OL>a%#ZeGhhJque
zH)50BQI-XQC;F8v3Pk@R#qAfQ4(V)Ptr(hH!?m^__8_0VX`-n8OM^bnM@+qSeye@n
zq%frr;#tX0l9)d`WsvXXsY+RBTOzzS20-YHig~vCHRTe9M1`Vh@XS(+%xywK<c5U*
zu0lWTd^)7^=ycfC%KwFAJEY&KM{842ExK)Sj~5;cU(`-XT;^?MWo!jTEulWNZTf>;
z)#D?N{GCaGaRr0(HlMIyrcH|8mtJeI!uZS9dK|8JVt|z7O9F0NiUaxA!gJKxZGarb
z1PTd+$>4?bGe5v(a<z4KdbrZ5>eO9JwC{&d4uypHWaB5BOyFo_F~MAL^ZU*7?9oO>
zK6`dH$`g&AAFfD&>{hUq#GWe$WH5fFC$SFcOg>K6z#y)&hzZ-?<nXU^+K`j9jA0LS
zs6A?7EB%#=)28#MnG5ytC_7M)4d+V{6>&I{n&KO>8rC^iYstqkd-6$i>4AcsNWjK7
zn8xWo-?nZtpaYr9qtyTvk>2WNt*T186Gf~@0GqVd3Ea>Ip>|k(0)AiSl(q2(dP~7-
zvCWrz0n+$s|Ej9`^Y2W1$wCaT<}o>|rK&mt%hST;>u&j-qgQjJEs;MO`5xl;etSV=
zSzQ5_*FP?bP8Wo(W&DikES}W7I8Z>l?_oNY#<0_YqzJdB3ysYCV>fS}H;82Nwy8W!
zF6nay0{vk+bwqx8Up}7?xeX#s*_^0>!RYk`3l{VYfU6ea`Fq#OIC6bTLzc?T1-mB_
zBq}DRZl4a@*T4UM3<P|xlK1SiND%weUn|}=VH3KD8!}5(Z`HB!9lyd^OE>lk?}?v6
zO5jHHR<mD$-tyl+0&q!1-Cpz758vN&>wT<Nq6i_+0lMr%Zxv`Uj#bQR7wAPD6Td>5
z15*PBy~eYBeRqt!{>gl#yUGC~{XXa|atba)|G*?w2+`sVn@nSrLBtKeU$J_d!FQy4
zeJORMNN{rY)g>kU!=-g@d>7!G(Hk3g{BuVsReVlPl2VO<i>grf$fOm8Vm>=r>0J!{
zT9$7dvf_@!+_6UE)E@<mL8=hnA6^?SW38vrNB3V)yTxLjJ-`SlPYfqzHv2hrWES*6
zF)R>Lf%33Au+WDFMMg%_hfKr88HlCc12i094MU+5nOF<Ov-_|A(|F%Z@sSgXM8`^w
zg^Y=IKUO{{So7(LAyP*IDo(?KGd<m<5`^Nv6Sd)5Sy}LAw5|TQg%4k7KKq=Zz0!8g
zJ2wAK72bU7Gj5dK|MXxpa)QHfxf~f_+9`wj`syVZ?tykS>~Mer#wS4o{M4XTYfk3j
zFT)BemVl;YVo5gWKh7_Ngvz+WFU1F%gAsn<mkcQhfb=0az`O%Rf$x(tJ!|aABG?XP
zt#iJ7#{FK$G}XTZXFpvcqqpqNW@aPacXQl+!3Fm>6lXRgGUJYbZwEZ}SN5DzExRce
z1qF#Gl)0F9I}y0_pfv2q(Y6!F3E-1?x#u+Vy-#11axDwqtf^r?*D2x6`H|U3)xRQ3
z0NSY8!*!&@vx)hf7*!Ndx{RIyD3TqK8=3cqV9U7^&P&%%GQI0}o%x}T5Vjf$K{(U*
zi>omodiXLvl<X!EGyN8voW%bX!b0n$#o%3^CD<JZIbbB#E%U(30O#At=vIWv<fzLe
zJ)dv+K19ACnx1GJ(%n=Gv7gBqMFqRNDcv5;K#rQT!1<1A#?P31_e7UcLU&Zq-qWXh
zgxUFskz0!A9mU0&TPhguu(`}6J`O8=jZ>dyiND;#%iKdOWmr&fPFi0wqt%mtD3!&o
zeaY~ClB*Ba(|?fBrO#ZSD!?ieEx;bk_qIW4{F|^X+S>)$e+yjOf_VIGR`XvGaDh<4
zC)es~u83_*@Wb9w1Cid0E+-i_zdc}MqNwEp{V-9g>BR*sn{XkKF572HWV7`rFYC^i
zA(DV=R7az`pxrW-FVLVUL@Xqq%9Em_72Y#--bDbA&q`;}GRlKt1>1v-9)wO~kAuU|
z-Y#T-l8(|~bL?}6ms=kdVxz6Rcv0Almam{z++yqd&z)sa)^&+%FJ?pit8kkI-V_A4
z1^fke&ff1{kvoiGC%<*sAOz)`8{-D9s;c4e^AIyE2UJTvmQyPO3FZXd#|2KEJUSRO
zC$+g^%Wk19zY1-+AG!aufyl>iW%6BLC|cjnzH6v`+$u6NeYD(3<XZIU$7|J#q_T?E
zFH^i|_B!B-kIy$k_tzJm5eUDX>g7G*wCVYab@ybf1wM>si6{1%TDMdxMHJ2a&^&z4
zqGiPcO`&=AvS9&e&h~=yQ&nAu&`5?|ieM%<OxvMbWF>&-X+wMP0AJc_n};=sN%Q(A
z$1+QRvV4(SiYU7h+)!2Z7<6y*1Gy<jNqUcJ;rEx;ae>7R=<V%|NlXl+0TH>pp@8N!
z`Lm-*Bzgw0_fjzV2yedTGfu9l1<zpi_k9%Mr2zFItA-VbIT2$vR#Y?chOk9{ee$)^
z6GB4A+dRhu<efeg;^DWGXid!xW?xo8`EbDF?V6g#a6pi0t{a}A1GRZDJ5bt_1g>h%
zh%g;xXl`k<%U|c9=c!1Ak);;o!s8l;?2lR2i8D}zH)*K_OTj>6%qGH=lo0{)seCCV
zG=zbI%qJtFc2KU3FBA5py76HavyaP<2+17{gPS5z31~>&R1|<?D5EyPsH-t4f7XpF
zT3Q~lTb8Oa=dyCBlsh|OG$hF*x;R<cecGa=JRST-@j;2)8`)f$-_wrZOjaMv{FZ~m
z=rhEEBAC9Hn(P%K3-82dnCvd949?>S*l^9q1&-~^b7(bsW%h#arEfukdYRgkYMtKD
z7cs}S!j}e^d!`M-kiRk}@f<qhoQX2C+3Vf6B21I<1?5GY`_^#+Kc4!dZ2v3robQ13
zda21m4rzC+6C{bU1<z_~YK)qX|9nu^uKAYrIE<B-weN&KefqSyO<gvurC+W&BLBMc
zLC>`6^t7g*H@+uBzHXe}9%pCg3sflds3{J+YY+LQ6lGDUJy`QY%~`2lX|m^0gFEiU
z;qzP#H~>a}MJNZHoXN+FuG9mxJ0@}S)a8^9qMvmfK&!cfz8RZQibQ|kiH^ZjWR2(;
z#n;(>c4aOBj)BGchAA}i5U9`_qgu?T?BVJUI|O-mRExjj@OhSr(2j!Me^ETDmB2BL
z7A?Uof0{ekA#4paUz%DHuvWj1MS7<(8=3b21tJ8G%rQu9DOg&wHA?UZ$pns~yX<Pj
zl+e%fYnbeL`sV%ucchGtM#5|HCfQ?VX7_&=b%jZS7yaL>(FVP*S_wMWQC$Pm#G6?H
z(e5&AI-7-*8@gnL+Bd6AmaZPJGl6xN9735T)YcE{Zl_Iil?zV=jgdK_2~JMpjux#u
zvkS_dwV!8PY-~IHjQ*t8-OC2$Og7g8H{Ntm8<-4+2DO1yGgulg-&1nmJJ_0Qjz07X
zu}!}$5?BKplG8KGDj}MrAV5ImAXP>ZZ^P`ewt~k=C!JSS6<x&lfjioLcjqy@&Hcsu
zPpoM5^^Hr+5)sx2Ujv)0%5nI-tCGy}$+s78makmb<+~x!7YvK7V@e{({SxSjS9N&R
zHLzL9@IpG=?L)#sLWute_gri)DjH<1AQz+tMi(aFWoLnpiF0^G4zC)yle8in*RQ?c
z22zWTj+Q+A<^egzK4zju*uLq44Wnse^GsEc*Q%AmhkQ|<9=x=?PFf7<n3zSe8=D5t
zMC5{>uP<00F|un_@1VJ|c9495<d%)-WH$KLYxVRkm|Gy1{u;#8G?3~QG8OA38fPAe
zAO|2CaDMa$e!v?WCp*KQF_G#yT0@i`M6d{IXBc;C-#9g)WC_U_Z*^xyhnkWBe-9il
z=CFZFQj-S3ab7H=_}z(A{i;=S0G*`+Ty-UIKk>szM2{Zp1<579{9~$-5kRyr$SIFw
z5g4EAT$*mlEROGsBL(cE)GmvgWOcC1m>){-ygcwHlMHvU{vHf{pd(}?O^V{v2Ac~d
z^1xJFF-(cSe}4bQcS@k9BC+BBWNqZ+VjzSxPuiC+*#B5H@f`?c_YJ|NHmPRFLL`k1
zVe(EMR!MM0p~jBP<ke*+emU-hsLpRaq9GrxF=L<c{`ZXTNIyoLf}wn;7nX>Y=lYf}
zXs%()i`C2iS#emwNn)aIE+#fsM0G23E01-bD7pGwxzbKdsjn}UAp$zPLzstlRc%3T
zX(Mt)h_wpR+Jbn7yIk+NgzwYMkdV$s;3=DVqRhVCAMxwLoRE-^%rUr>ml!Zo&913c
z((gQB>~$P~U1`-5F8WHJk*x*=*>Gd-Kmu?I%AXmq=ZRg#{6<Ga{rFYl*JI=2(i<hh
z%8P0Kh$e_=^l;pR!V2A<dgPavpF##7r_C<R?y21a?5hYkPmRPzHRh5mWtXJwL7L)k
zM`a42mH>9j(cK};FRvP2HvV%bGRKQkDXG0p5Wz_-p;1aLSab_RnaHuc$+g(keY7{E
zkm)Tss(<|R@5grk*xxh6TmP9Meylq7?qt)=@>4A2S>Hp#Z{H=;eBZ7;9Iq9z3&j!T
zN4vLk5gCf+qk(6v^u%@o4SQp^<Rb_Lao?VQlyThug@!!qGaStSD6@Qmn4vU|<a+fg
zo;z$)n-E}JKh?l#_Tzc}h&#*RPxWFqwFxVHK%Q91zk(ypnP_w}y&<P9F;NqOcWb58
zsaL-3?RQiT%VKM+k+U=2pcg^|a2P(E-jD}*k|%2wM{f_ckkiOL;%9j;XTnwpha=}j
z@vrvp5}G#%0|XzQ?}2Z1qdXS9sE&uQPnta-irpszl+Y`rF~FO)GUi*3J3%ngZl?G}
zR;dC`+8z3KJxvy-w|VU(+80PKAsN+jaBi=vYDpk}{tw^S_0sFt%Gm*%pZdmip0*7v
zk>C<R_|abeCGK%P#$1YVQ;u_$^Ls4(7N+%5>kluo+_mK2R|qonAa?1-?E)Oqa;R_m
z(;r>(MbGjsa~!GKSJ%Tz@P<v5risqSZ^_3vLKb;^u;lB%Cx`Mn3{Fu&yN8l7fvyD)
z%jfG&T%Tx^>RS0J2Fm`mOs?ae3g)klqvfT$2QPAkxTp*V*75ej%bChlwAMMk`2N5b
zCgXMdMy^i+;7f);$d$O{vs<8!H`e8?CW!=j=4479{N@f|9u_gJ3mg?pw@QN&L?Hhw
zlDQgQ*`RMA)|4s;jigX7EcSbLL@%)A^nks$9};pgl_#PikqtL#F<t$xlxzD7c0!gR
zw=dik=ezF0+>usej)B2;;2D2kO*=&gV8efZJsXyf&PM7u5`vnL6r2VyGb(gho5>k>
z0uYL1t*Em@FOmS#Vy13&0Spw!xuTgDNUuea)z#I_JZCcYCLt!~MJmiv!CMv-xJx3f
zeDMO%3-32jZk%{`!D#@Nh{W0wC6x5cF#zD}f2XJNy@)(il6%%Pl`;e;gi~Azjabqs
zO*0Flhcf?uQS|Q$E+4@w0Mk~1Wq0j;{3tDBU^gyCarl)K{piaw&;$_K#)bb`B(1Db
zaicn<0oTdSP#O``I(n2BE)##6`Xv^YCUw9>h=Sf{Jdo&%RfU5~`Dq4JB6mdl8CaWt
zzZPF#An77(N~ZH9e}F1pe;H$R)ET9_9wPM6oZ&#%^x!44ZkDoK4UzAUP>ay>_7T}@
zSb#@CsJrD;P#+3OLjjfBM&JLO(TaTB)cTjSYLYLOcy-i1dXhy*!8GcPuw@2yAh01&
z)uzgrq>k#fC?`T!M`sn#sUPU%&f&ky+QG|qRm_F#VwIM0=SW#p_|xbc?Fho|7+8bl
zn37uGFcF!UGhW9T(R{x=Z5i_}=U~f%YyeMYzWe!ai;V`@pUWglcrC)g1Ch;`%tWPM
zVkqtWW!tJJ7;i-nR44r24q4i&-y1_ARKL)xpjX1x2a9|uWJeJv<)>1pt`ijSWyWw|
zyyKz=gd8a*a0Cv0GL@=&JT>_XR_%Y4K)jQwK=TGLJH~(#tcKla1{!6BIxn<6h)cS9
zCKhQ{C(#pL*uAJG34u*$o1F&8nfmV!77(nn5e-*;M=D4qz98~NC(b}m-u$mvx>LA*
z>FRASQjIVmnj|SAB65Ap$*^SjZ)gnuL`nlqH`?USj9nCG>ZIjyuFPN4F+Z1i4wxT1
z4%t7k1wGbAwF9X(vTHG?VoAm#%A|}43ye;G?}p(Q&@b`zCg#Da@5g2V1@Ab(EvjcT
zwcv{NEEkxiveXq2Z#Sx)c0~WNW*@(^4pFZ(e#pnx)z>c}?xSt8!lfOy`<DJusGlX0
zCF@qUv0KN5f=fG6PSEnK--Jqd>093G)^(jCZ_x!w)hU0tWqy52bm?tSAO3<W%CJid
zvinms17`O6ui?a`NJ~d1X7h>=D!HXjWT+xMERo7wYtQxn2Qa^KVJlgiR<lW(wSz6K
znMMBnWbk)nn9dokHA==e&>)>t5|qTwFq5rJC`zmRzd`v#ie{d}aA$gb7utYVsR&BG
z{JELIC<tYlU54p){OQe(2g5OOli5WmNl}LZfe#LV4^S<{xJpRVKFk&{u${{GaZu=)
z%A|Btav<iqxxAhfG*Wl8PfDX1e^r`_>BQV3Wg4Dv8h~_@R-8;dl`)%0>H7-I;+JzR
zbv=0SpgB~eu;%^PH7CPH&ZFsa{L`**vk~VZ@Vdz6*F~aAAIHbPN=<3#U(F^kT1Vcf
z0Q1rQ2B|ulC|Mc9=&Act-fUb%{#7C(=qLzH@2Mlr=uVOyJ720#(P#_Jzfdbcba|;n
z+eSL<U<h-Ldzo?n<J2|AYXYn$nvh4;AY$2bmAUadn&gKxo9WdD;lQU@`$+$+#L=e@
z{xk>TlIEtpN_`8eidnZdmqWGIJ~H#0b#K3~br*Pn2Bf&N{8h<&J_Kd87^JLrx3=Zi
zmlx(lG|~Vs<dr~DB(R|(F|)P(_MvC?ZC+t5*6G3|n>fuIoET!U&^|ZESJEu*7d?-T
zs({HOvj}8?%$d4Gli|YyH^mT9Lt$BTvPabr)_6&e_uRO*lM35*DNTh_SCQVM+5Eg~
z22g<P6RUA$@y40kP0x3R?11lUsmYRn^<WU_5f3cF1VMJG_1|s6#-WqiJ-@Bg@THzl
zNQj^b9mxPO(k@t;ww2?&L4cfgpRbnJw;Q0!SESO;dUQq3WoERl#Fuje(!n?#Q$kpn
z+?QXAplPr)9K#Nsz}Trt_jbMxG;>J~em`0+r|Y!@Pw_`tOgfAT;!xC#ySH1aVhf<B
zd0}GGtMZFF8Sxp5C1gNq13)O*7lOdfE)97_14iVRr{M!A|3OG_d$hEwgjvW`#D6;l
zX<|%julowlh*u6=@K}Ys*nuTe*Mhw)h20@yV-5To(d(1`Oj<&){?TG00hFI=r64;}
z{dEk&>@ycl2U8zTZ5L-me>NKrlbQ9UsY;p~fIxR==La%cOI7UHK*@xY6PeYzT9i4H
z$LHZztTxHmsV0ABXQD+X<<TjqF2RV0X49ykSHbz0fg?AFv>L*I9HYry+b3`tsE{!o
z0CrZv9gPKB1Qz9o3G!gKx2rz<vMZ8R6B`J8vq-V@^`)+!{N9C6nr_fU8;a^`dX6+^
zFg}e(bC;dX&H)@y7jS{Vh~d)AZoqC+Yo?yO`TknjE)=~EV|M_<1K(z<D*#9`&I9oO
zROPHZjcJ;Qu5WU<s|4@AU9yCF6CddV9ZOni+MNm>En)j2m5CpxoAPIj$PRbl+uZWg
z$N@B)MurulfoL#C5{?O1K-uGHp{rnx?FKL$!Pa*h|Hw}SA&fAqvur4#++VELpXNqo
z#iP%t?TST&r!0UY59MeK+*IFXTO9^GptDwhVYty6;Ggx;TnEfF<vVYndwkh4VGS<~
zV#s3y5)X3{3!&kyTN`?J(8qFh(pxyBmm&y>yVcRtvm5h3aigpRTK#6>-!g&}S7s^0
z!*c{kToZMzi$5CtuU-pT6{17%nlDtjLX1-Z8|2+4Y<p0_&b3D`^Dyn`u7PU#cQeqr
zBeMT6RG*jh-5UDp^>c)!hOJi4XZr2eKNMXQr=Nr9{`)wn2mc%g75yJuxvhU62c`D6
zWllTx+4qa`!Aoly=bYbbY+{mIqipmB8~67cUp_oudds^3q*@_Q<&g4IYqgnp+LdzL
z@5`m%h#lt6fsfcsM_0Eqicuywdhb`v8w4>qti^Pi9L^{HdGSAt!hgCv-LA0ss%b^E
z%|lIXv$9x+3ngxN-hfMB?UxDoouG0Kd><MX^=vJ;K=L4<eR~lFVoHjNGB|pPvs;(x
z0W2}J0`K+*ucHs|B8Jr%<&!4icZa_D8BLo5Mx7Yid3Wf1jwj_SKRwkYWsewQ&9ko{
zyKhnuSSAPIW#VnbtPc8GDR4)$_rCCg3tj}1HvnzX5|h2hk$tzmv;BaAb&qsz`VkVQ
z=(`0RmS4{|P3xukY?@HkGBIg+m+UpiZYv=jgTTc6kZTV#yV6l39jf;5aA(~4eX>Zx
zi*7`-BYeS~M9sMXL6|)x;dy$#`Yi|XQUE7!$G16l6_BI=Y21=pM+nHGAG7+zyQDdG
zZQ#V+kjJ_Il0Q7C+l7R%iMe=#I#Qu8(`g2~L#x(ftn{MzJWExipo6312?*kh*PC7!
zlJ5Ul`BC~sF<}mlH-+l8OiXG2b6%MC-_E`p|J{f94_)w|V(h=<BObrm&9kd~7852r
z!MQ+8$H@s>&&beC?K-mIo$d2kmdfk~5mC_%yT4e5Z7NoO0sC7!m$WJx0nX+Im7mz2
zIYut2qN1=5LnM#qmN0?;hJ4hd4cLWU{JkE5Dd#R8RxaymOrO6#*XB#JaaB9<o$W@D
z5mhL&3j8T&-aj|a#sd$t{qlQhdzjYxuvN$sLR}e!?sWG)m00J)#M?BFEhihda@q85
zR6#$)o&D3zXFPL(3PFS;q!$K-*u!3QjFbl`3i{pJeDR=1^Tu-ri{Mnlzu&JysiSj>
zXn6ag_$E%mFmyl`*aMEk)=PQB{fXL#&a6dmhU>=b(*;3QoVT^aWC@4OUfd>`-KP63
zRQ!n1gavmsdA{i26l&vlhw53A(oL$|<v@8@oK;K8E|EWn#O>Xo*KQFp0^5^5z)%&<
zM^j#>pVQaUITw2{MM>XP{gQ@2ZyMQc1w})La?x1^*y9|sWN5_Ql`xtvJekbNCDcZe
z(>;HxCW*)#EyKo<NAI9``_mauc;sspYcUcmfXQADGP5n#xoH+*dUCoZ$x8+<34?c5
zz4nyoF#!9ZJ@)keH;=kJx+?CHB}wFr%rYn7Kvg_BA-RFCeTqN#%oPEz8;I1-$()A=
ziUp@j^1X%kORc7Q+GX1zn>fCTP*Is3R+*C``emYWZn~1RS#wBKG}^d2D@URlbtL26
zuS>ajts%|~!Q$~qsD8GZj!L3qs|e)Kp(FQP+b{19owwjE=sumfwSkPrdoi2iK`pg;
zfJ|a%c}K@+P7#8`k?!pr_xFBmtnnq24$dqJpmv=4Z@9+DtTxe5>9rcv)3&qcnb3dv
zjqB3;-~gziW*}|A#RTjd2nAJ)(A7JpUH6gZ{Iq&M8b!toKqVX;k01rwI)JSqWJ(n#
z+CI}q`mFly)9QK*jIV}ZVAzbXBmV;#TKl1qkWKH!iR~A~89%P&^RIK%cY)R?y^~y~
z3}XbEfZ@~e(3YAoCG+)fi(SL6qMa?qu)`XhGGj*W@Yi2Tue$N+KbHP{1Q4Ch#3&)l
z+>wWeww{$|Zg8dWJKIQ_+N5?66d3(;=LaLk=g;v!P#FJ9lGcApow3heFL*sd^9%RR
zf4Gf>Tqa-*@dNS>Q&2eStEVT2%>lzMif`b&tKfWv9L;J6#dLAkdA<>M>SM`IOvmS_
zmUy81=i*=C<4dNwA$0XTS^kBzk7*ZjXF>Aw5mqlK)0=@<8-OX>&5kt#;2UV-ftVa1
z^>-;Z;Z@}1q^$tQQdU7tbsO3!I;<~q9C%?@`PVr%HRw-{gTuY-FGFfOy4hzqt>)Sg
zM}0GS4`B-g2RnL>j+cP+NO~g2E|H8cP-)k{aLNBSmj8eJDwwj<LO#7ZJ9vuzmJpVd
zbLRwDf(0HL1T&lrC-`0@+<v4+hk?{OlG+nW7?K{n1ewMa^%#Ql!7o1P*P3C-CbcXB
z9nf(coPp^R?AT&5oRP&6)#*tAH^V%fMp^rstj5f^eV!=_3Y{B5M+Q;Xn!KI%!g@TT
z^JzGr0Vjz~1U0khL`7;zh{MK&HMJf@B*SomJXiAg(LIq42K8I*K`DS%_M&A?0yKQe
zA8R1I&_M?@a=xQ4KBXN!Zx98bkdOd8uR8{wz5R`uDlX6qS)Ju$+XBMzrZu$IfhrvO
zQ9ebcH!^K8P9(}g<o3g<B`okN0qyP2Ek1$Vq?;AyQjowF_~nYv6f_O`YO*l?aq#pL
z5QsF^4hnG<gXOnu!L*G!&V{U-P4{M}^RbCPq~RhuOM^m=X6)heWsZM?98$d|y0)86
zdTd4)j`{`KLbc?pw2w6GM+z&pl_UsUJ4$O*i_lK1VI5#gsZ1p=WWpHylzrxCOB}Gf
ziqXaLGoL>Fe#L@i=Yya!(+1Gd*OzmRC*M1{^$14H51HpowsUaiZ$k4{;c$a(XJkgx
zv8N1R$NV^hFWTiKjJlWQ<&gnHIXOj0i2&gwX9s$XoQ~wUTCnsybz&qqt>m?y`1D@V
zvExN^K&MZ!OZ(-`#akbRYj<z&MU0vH;n0!?uTRnk2OpkTW}5B*6}gn?Yis922u27F
zO5_{|4MKGo^k(HjPrRCAm)m03VaT*znPWJ439TK{HysQ?z|_~5Y6x?>kB}TQBf^ok
z447su&b>;cDZRR$dKg9~;1lAbKJAMRe9iL=(+t{P!2Da@=a8fh#tCsZ$R4d<4%+f6
z9A>id3#FSj4<Cn)bjEQ2LkM-&j7yr1x&w?l5W+;J%~xtmO$yQyAr3h}Ab^D*YFe*S
z1v*?hPQi}|lmj6QY<m!nZv-T62LL*FB3{C?=b%H2bKR!xOy_dd>mTLvKjq>7@kH=n
z^AT7Hj-JE1y4(#mX@9a#Y`^_=>@OW?QCDaErb@mS)O6HD9|b6Ms32flxU|qQp_Ec^
zTmDYzn+|m&CnFcX6JW~az(u1&aMS%jh6lhlUpmrDSpCi_JkBj=w{jd7r6as3lMR7b
zT$Oc0l`)o|ezWm=369s@_&{B<*Fkl^Y-~bio#4`pH&=z<qXrqNdN__+-|=2k2D#8}
zv=_##D?U6v)wkel7H?K(H$KVAQZRLWf05LE`h<((i#RM#(KX`GmDMzSB4kb~A-S{&
ziwm)S<YFe4zzz_aA_v!Om-p-=g#E5uI_v?jg!sjW8NKhdkXrzrd``Xm-=Wia-Fz~o
zAtok<24D7pjG&1Q;Oa=YUy$W=y1yVb;X?&YFQBs0R5G33TS&bqIeY?;{XoEBY=EEU
zD?B<y%`Uee=P_nDfH|RewyHGHL!HSLG{`lvb5!-Az77HTZl~i4i5-P?r7DD(TiB&q
ze<589jmHGI3qd-rCg8mt1k@-L4odxEd33l|;epL}SCRD|Vd`=73*Y>kPdX>{>kc^j
zt3$vAhIPBFo`=jC9*}epKgTf^l?)?0xe4(;0~|?)6T&u72%vVB^Rq#<78UWB8T+_U
zj^U7&LH;m8P9-aDW{JLuvo3iH$=l1E_6FW8%r=uaA^a_XNPRHIZ^`>k6hmg6Jq|T>
z#ThSr14{I99O}WyAhYnub~Ta<d%DhhMjwk^ecB&KAJecAQCH*5V0~{J1kf9HDIk5?
zKn=?rlkghyTNogNZbdARxm{_^=!@b%8;!$J*4ap=p4SHGoLH-2`y!431F#V<%3G*r
zd^suaLW$Kj8e<15{>ST+)kfI2cc&z9>?m>C)2rU@hk|AFXqI$WnDsgz-<dXoGJ1C^
z2;-N89~E_jz2OCoIWh<9UG!{tVxM~+To#cSOP(u|Fw4u)m_ffeJ3$t7dad)_HacN*
zHoO(G&E2Uv07F~7t`T@T*3xlVM`R|`v0@6N5tupet?Y@7ja3*G1hsxwrKavi^=LRm
z@Yz9E6qV09>a#VY;rFn!@j4q>T%^kEP*7CHj@-JSn$fPe*uJ8K8R%OvLlt*q4*lJu
zDO};?I!*`R3z;~lJ0k}N)#NuBKC`^W{%{od_rCpi5z7pqMAf`&wCbbNuxPHaO0wzM
z>ELeH$=BdaeSHleR6$maEvS)hel++<7+h8m8FENY#tAb4I=Zver;vx#^H>C(QwuY3
zJB$vN4`M$*Lg~f$Op-+ZaF6_9@VgLS1GMx^Z3n_zG3OHL+*eC&xNUoQD+IMDgpgVN
zBiIM1wV{#!4Z0yJ6+Pu-&>`9q-UpVfgT^4nV2n&EM+TbYNP@?^#l^(~;RqUD%9c)d
z%Aye~bpN&=!drou(x#TO=(4C2!We`dU6y#)$jcB>b8usSU(M{ux_Z5e9(;yVoJu~x
zyBtlQpblEm%Rvc%DV@3K8UD5>Ep?oIIs#)DvSChlZ1-uUDd)euUmK`0JJHNd=N9_`
zA?3H4mt#|5cr5||r8Yf}n`S44WbD)-^OFAoo!Uy?BrFbcK=2EL$uuw<3UlXDwoZ+#
zWp~+kkDn(=gbvKT7W*=Z4nvUn78bNCh$dO>J(D%0@HM9P>9NTk<eax8daI*`eM8z=
zjX`kTsZ$+gX^tA9H*fC6**<A*8gq1BFHA17+Paf9U~&^?pQk^4x*bt*mn<e$?i$zw
z_bc?B<@Tg1J<^XixW@iXztMBbuSnvl*xk1PSN?a;HJ*-}fq%@bOY?@z9yIn)ecX3E
zQlX<I$%raLmxWd7Zq6LmW6PvFxdCc7y{fqnI|5tJJF|IR<!J`mWCMn`x6RG8Z4f$+
zVXq+)%L#8NYT!dXAaw<KK2ebc&SuU9z?sT$)`4{wAQTz-w?ZfcU<VXJh~F{)eG_;N
z7EE?AZ@J^i??)nmDXd{IG0NE@;2zh1phUv)LU5k_hFdU_uERzNQ%ncFz$nmUF{IHR
zg|pq?;Tllbxbdzbnj%E|){alE?>9Fl6^`{{Ly*m@bmr5ff1KaCcRS8**Z~=4?Xw^{
z<pa`<aNh9U!Houtr~9g&na9CHT*C?Wo}#24knguIXOTT@*Tyh-APsB3XPD=!tR=1U
zW8&le$%6~C>MAnjkh>Rxm>>{%6@X(sYIY=9&mU<<Okh+&01WHnx_}0{7$4iPzy1Hw
z|6<Pm7o!{hYvA5L^uDfP_x$w(bbuekdB$NujXN||>Xn-NXov!RUUVzVBBg=+{M7Xi
zrRUFxeW<v*mNo;Tvl!91nyNo>Jd~|Awk|ii8YEwFV*AkZr4ofirqL1RutjbLZAt)~
zJUbLVES!|#M~uPDxe0%$`ef6BReu8=a!aHTrDZyT1&}KlO;ZuHj!se<&4I%xHWUKP
zw6r*>bHz-PtSJtQBPfI1urqHo!M+H`gRCTccdwO~bMkhZM}$<hx_M;@NJVqNmY~kE
zP+UH0bR=B&%REJ^?@NBDH;g;;St-BPNc|_=9$hkB3+6Tg>AL6?Bmxl7puVS*DJMS2
z<@18@Gsa=@NgC!x)-uZuR3xXau0FClCLO|<;#y9#i7q6@r11$l<1h^eeHzX1!9n8s
z>)@5jmnG}+A=o#dd$V<J1`g=QMD<fRFf|9MrL~M3{?tPz&=YiOxM9!?m_G|tt<j6-
zbgLiaf<8;;Pbyl(WEbBHqG}@h5ngC6H#wUFd0n`XC!gi%M#zV2(05({>c<#P4U4bI
zs5MmIciqV*VZo@m-$KjCk0{;s5WL#4aH40oZnVU-3sHaoGgW%*Q`>Jda}jdQXMWnC
zQ(Q~N+X^^`=#0IzMi-b`nA6nu>?z_I%f=~9?Kptm4iN6a%Ln&*x94A67d&O%?LlH3
zb2L3O6?lDHz;D&gfeEQ^qQ!@;b3;sNf#GnabMy0_M5OAu)tn2o{>yOb?4E+9%MQa%
zM1#xZPbS*6kWLqc$V}I`Fn~=l21Cs?_hzKwHL$DDkSJ02!KH-|D4AhP0u9L+x04x3
zIDFwj7oA5LbVwLhQqrdhLy*)OR)<-aLX^vl(g|u3Jm8VLoFgb(gPOVnGhyxIwaP(R
zr!(luj%cThNhM|wgVLzWD{g&bPGqnchgUd8VM1lDYpz3J9Nhys%b8vTeF<4~(Dj$)
zdXXy$)7rzs3&S!!UfC-bKbYmSR>lrtc7?C+wGI3B;@}W2Pr>SKW_VgP(jC@b3F&uk
zqAZpWi$exvltBr2t0Tf-SiN!!2QC^zjL)2<JdWn;N%2s8>YaNV5e-XwAHNR$?yodU
zbh?$EHV+a7+uCpoX)uFkvKC?b&jfLOPb508SE>YrL1V{;Jv6cv;E4jyvVkh=<XPg+
z8?4h){TKX(Pl1Li%Nh3`ADcNoc9cAEDahGI{p0A`73z|(sTwe_;So})SAEiJsl4!L
z-Rnsz1u2}@1~Ar~2Fq<zoW6vSw6vu2ZFB2{k;i4zhW62Qa4g8(&c0K7xYn>ow@E&6
znYCE`4N=!WE>B|iZ4GXX6XOnx0QAGxs@QCRiS)KL)aHSuN%O^F;Gi>B$LmY>EsX=N
zCoZZ>Km{y^QNO;fZffbiLh=Ui*}s$mnr<$igbnDzEu5M1EB6te)VpoFgAUBdoKXJo
z>h?+;@i+?@NK-yhz(GS(mKj;El2i4ja5D+%Z>%W=0gg1Y#5{j%GZbyHk}63(nXn*?
z>(lO)*I{|p&!5u$IFy9)Sq~0qsR8GKsea?tJoYn9G@O^13+=QkTG(n3mWLOqD$5os
z+ruW4nforwWl(^o83S0{JUk_^ao=&DM!0U)**dBfHfg)WT-$r}b`Tb}x%S(+QL{O2
zFya=bRvUOznKg_Z$UoMXa28XO<$up?U=`C-<r9}$i%sy%laT(NGCid}0rC%C6#c!>
z8QBcV#u`peQgv|1U`>5Go(=tH8Jb!4@UNdw3X&LW2y;c2v-k5fMVn>J#wE4&-eLwD
z(8yOU)Y<n_%_*<2=eMfOJU^Isytu|3bpz)R3$Be9`lmNOkVOoKn5NFi*<iy1FqX}*
zVZ8pz9P?XE@j<D2Sv98u`<{Q<^Xe}!DtXO%9RJk|1?OI!0;?C7B+ZLElv~{~i&{hn
z8v`f4YH3K1j1(fs!;ECY0tk*XtZiBthDYNkcP0x-Dl%r{==6r;5g6_H(71^I>}$P}
z{?=T!aLK8b_nALiN#&~_JJg$$IGhY9N`xZd8MGJpL2srv?%!*RiXfWX``NzUO_V&?
zjFXvEsyxU?d*L*)P(%b7_1h<eC_CR}Wj(3=wQ@_x!h$CWv4iThiEs=zJHS9vc`7BM
zdHOxzeA#kLZ-d}%vVq^>DH);0pgp}3M{j9n|4V}9i+~Z#j9w*sylm#51vh8O-p~Nd
zxlMD>Ckr0HpT-WFO=-&tJq0t_K(4mrHbBy_uzd3R#j%jC)jxPZqCF6*Ay$3PYpIg(
zsD9lfJjoTy*X{UWEoTE&im|M)cp0VCyV!MSV=KpX`Vt=Y(8a;RezNT4%d{PWW^8zJ
z&)C`~)QrfS4YV#ZTq@hS#ME*(l|W;68uy^1qQSm!TiiQ;itJWUc6jIrGqO%F{}BWH
z!1!#{9wJN%VjsuR_&fPGF=rK%T#4$*PbXB;Sxx~4yhgNTa0)=VXLvtsA9PlVT{4Xr
zISo{{?uryf$C~`t@|_(5Nk-|3ztm{!JKt{G9e7}-#zGlHVxlXU%63|pW*q(>pe4NQ
zaHxD*ty;vCmu70K)gAZ(z-8?{d9w3V(p|8#BrbL1@&ZawvOSmGWi{ftl`nSvWASAF
zujW|1WRT58I7>AD(=8*r%uVQWTm|LSt|11=n$1Grose7!)O#FR$e-qH;3KT}tr<E`
zb%U^okPw|O3`ee%RX@AIv%re&@DY`~qjCOk#rmO>Vjb8g|E;|%|ED_t_cBdWlWJ;O
zEj2|=MMYVUqEtA_5{j(JR@ON7LQ~RaJtS*nUqaGx973gNL9(5!Eo3{6H4MUizU%wA
z_kXze&Z8fuc^K!M_j!L_%k%ksJzvH>=6!W3PS5}VJ4M5`7Rl(%#X!m9#^lm@_s<+?
z^b++Zj>=@3m<%jRP2@GHF<Yvf?DcJ*tzA9PV)ntmak6s;NA5OQsHs>t%E<NJB@gok
zI~<sF*lP<J%vZ$$NuEHZ)!LP`8zSr1o$_DC`sFLhm;tSlEYu)ouof7ajn2j`!37!s
z4wg^&&jR21IhM~azb&tVq^*0TT`Mep{(BG0Q}(mppO5ghntt#_E5n)t%<7h1s*D@$
zTuHL;%|{t2MKzB1k<$7pn^4fm1M{^zV(|`V!aviTc)u^5BWP%wa?HCd4H5q^M8ohJ
z-z*OnSiPIF<q<M9cWp2}>)q+9ktTfBh$SAISM&?ap%}G{`JU$fe97MySy@@O1M|e{
zfXzf*)qH$g*paCQCGTzzjD*E}*J9y;=ASur@}wpD$zh{;!a`@%Wn9D05h9%CJ5MB@
zHVh9z%!&_2l6Y^LU0P#3U!7}QEPZpd`POueqd5{nqq_pAtgyfvc7UStQ5a|B#b0I)
z;|LL2YeR-Inhg8KE9Ti9aVjb&Qsy_!TiEh05TRdPz;{UG@<QG>d#~IQNL;w(R$}jB
z%I<XG{$W=Yp)+k-%E3u{3okEE+%CRXEb)({lKdwuLXK{|e0jUX!W$z0h$Yt>mnn`O
zQ~x{p?l<}%eUcNakXAI)RKnzBXzbK<XfHk=wo*vQz9Q+q+(TB=BWcsK1IyV4m#vS#
z=Q$DrbytI@0<HV_QI+EPXpMM<_O_0E>tG0zl$vA~I)LNto&Xqrhfe=eV0Zj@01}?L
z0!mE-)fxYJCrVrqM!?5WZXTl(rx;3>)5SW5tsbp7A>pa5C%cs|rHJ{*7D?Wljyg?C
z=BEULzkE51Ndyh;>g;yV7<`_lpW_df(u{16mLBv?buO_q-mqbV7qkl1J;*+?seEjM
zrtV__0?!$1KM5@{`Rht@N=j5K8cCavr6rZ4@D0$z+){N9I1<}e)BaDtc6Ud&0yZmU
zkAk|AW=?Wj(@<h*xh&m{nCyyintr&J+)a*_D?xKF1QMp00urf;nDBY-8lnuDBN3rC
zX)Iixbb>d~QKxaq{I9Emfq4R4P@@C$+8R^cJu!k-C3+?$IXN;H1&_Q){L=Y9d)<R<
zvtO+Zh|e%`JlzUqXf+qWXLsZz&RoG!A}82(*Hf8G!j~6+nf}c$w@@{2Is2ON_nQK@
zmHe83#Yx$H5TC{5Qm9BfSeIz*bxPX3@wXKl?FbpuYVy_>HD>n&CRUqobR_0oS@|(F
z{m;3jR{I5)UuW@p9A4pW8K+^brLdHLZNPe3_8QieaiMOnw=IIpRj#%&3V*x>x0g6Y
z`O-B97s4zg5aq*e>Z4ZfPBAeob9nSf8<8w~>Iurc&D>4AIs%5&X{7Fwh}^PF8RpXK
z8lIjkfPi-Js#m5<I(<1(0*E(ouKXdoGyuMI8;7seu)i~G>T|KdL(n}|Rdrm^Yq{w{
z(bD@lf6fVSEc1PKOM-0>x+C(VSq}4oJ)XVp35+NBRLvOKo{nd(XMb^*uT}kgZ{hlX
z4~)8pN|lQTz+@_NCTPRHiq5keQJ}@2hTTKXKW+knpELv3?J=<%G|z9|zq_jQf@}bi
zRn%8vvVO)@XdHOydK8{A!Q)6m>uR@9puf6tnvGX;fQ(E^e-P>liMNo<)O2o995#K}
zDUeC|Tz26_68cJ?`FkpzzsgtOPDY%myvy0enFdwG5xYT_r7U{ulx=BTS`lfxD`7-+
zn0NCZs#n+!Oo5DyjP5xcos_g=hn-0w=r{p+w*he&ix~FY?Sx|e@W_cz{)!Sg>FMHM
zIy<Xpp#-%g!)g_Xh*l;KfuOH9^&Y=N#)T;(v+!kCnsN#<#P=_Wvc_U#4}6(LK2cD+
z2Si4$&#!@mQ^2smPC{?0z0B7)&hH<QP5{D73XKItSC1?^8aHfO_yv+6y?k}e*TM^T
zua@XG5Owz3QflOQGy*d>{7A{^Fr_eEf9=|}3f#VGS=l&^PSA1{=y?N)Blk_>_R_ZP
zTVc~Jv1dW};x7B*^DekRiBmQ*YLi&OHZ_uvkf?kz56b=GgGuzTl0aSKy!Ia;vYc(x
zFDm2DRC<6!RH$T35Q7`Zku(LL!XO@}b;sPXlti03UKF%^Yyy3lr0^;w5xnh2xnJh}
zL^q0f#Au|Stzw+ASbXvltK*g+@sqn+DNmua*o%RV4L~UuJno#mM(&D`c@BeTUi`N`
ze<W0hm1@t3^Oc*&0r1bnaDqxoYO0t0JcMj)Oz`qf^9_qdN^F$2i+q%ye<w1sSEm)d
z<hD}vSFO+025bJA1_7FaV^KwL+4!~{$RA+fm9(2up=VyoG`K$ZebG6&N1vSI-d{z@
zIV!l{)(%1_lXo9%fZV*-$v20w#WX=8=jD*wQ<=QagFKi05h2b&G(8P^iGkVHY$KL7
zTud++9f*n31SrV+0Pg9+M5eI#mNE!~+q(Mt>Cny+f#@{!6AbSew`Q)J>%fN-7_MtX
zjZaoftu$RKKygXOU=1(<N1|qZ^ZNA(OUsnH`g&mhi%9?>Hu;6cOL!`G<uH6c7Ixg?
zgN`vDBTM_Ujf+po$;q`m@yvG{Y{Sm1Rn2zNP%UNvI(t)9)c|jTWDK@U8Oh*b-5f5l
z=u`3b@>VUSADAB4h9hTh{a`xr_lMh8{q*#P@!AQIpX)#2QILp>^7E%J9}R_2@#jCc
zxBMLY#NXB)z4F7K1OF;^YvG>%{DA)IB|jF1;;;Yzi~kQC#e!q1sv*@@I#2>CY5Sf$
zdB;vV27dr$2+^f^8E0Sqo*!&_Y2@ftOMY4`_Ir&(nbrqRu>nIjXPSuBf%zMU=0`{2
z*`%$k?BDEPZB>s_<(FCg&1?F{Dl)Hl@BaL+<$8atzB4-Zeg8Qd7_!+kJ&3|<puk=|
zILO2EN63c@?znG$uy~0}LAp+THi__jCp<hE;_VC+i~a1}cz?bPiG=XTTvpt^ySP0E
zE%h0fW_tm;Qj79meC6UZ=hiD<wY+pdBi?5^qXsEx(Z{T^A&`~#5w(+_Jz9Rf+>lwG
zxuZrv^!IL-pZNy=`!K_y(n$<xYikpq-0lLF=J409E*QOO0H|>+EdKKZCODIT?Wv*x
zt_S)v4scME5<Q~H!(;nJ1~Tn38mtkl_NLEuqSk0BxyXcaDhJxUb7)HYYwushx+x2S
z9f$-!f9k-rg@94vPCI_AwQD!eWYG16tn$yb(5;A2y`boC02+(;F-m#|dNSGRgQ-fh
zLC96-gvnzY6dE6&ivgQc$f{&8ro26_^9{7<x+W&Osr-`XLPp2NzFv^ESntnQUJI(;
zHo_b5Q8gF33gVkiukVw5s{kBVy~CF$)C{SgOg)J7LA<<}=D4LE@iU$L_8*0XTwIO#
zB+O;!Ll8SY$<puMwca+*R~}N|7vAo`#uN<0tbEY{fK4b;_r4u!VI0HIUoFuzH5r~f
zxwTyU8;<Jww6K2ko=Q?*>}8_e$i#ShVTrv5sK4$Blz@7S^Yug_b%^7b?$q&bu=#JA
zu^MTRAZSpv(b3bx!phr{UX6q6rP2WxBn=D<h)*K!{pU?-E1p;nd*=@y^cnW8r|=?0
z;1<o+tX@qdSXNO0MV4*YdjyS-dV71PHn%N{9*&fgH$YM?*U!%{WPHhGMpt)tW<tV2
zx+FZl#V5Bt0`YtdV<GfpVC0fjB@1|-Dw3djP$(}iuL#)3H{`OI+^;=79H?z*#hOY=
zS8$g>kagw_qV?)UdZ^oa*C-JmH67rL+VSHJ`20DT95Vr?91#^htas?pKiWDvVDf>x
zenV&dt8Tn*Sl2xn$9tHx$w8wlDj|Uk6IcgS<^G#DYVjN=_gJ5~DeL?)26O4LI@C?)
zOFL@G_Fb8`+qP|M@_fe##GQ!AB}P6bGgJ7TQD574)#{0cL{58ks7ft0&o(VH0p!QT
z8%^@_TL?7bJY+;(C_gYq*~JLLVU5wS{jTMbH}FpE<)TB-)9}QThMHU*ocdj0Al;0b
zir>dsU2kxcG0Gb)M@t1{!cRyy3R=wYkdOpCuzg5}Cp9#JG?^*I@@|M7*9ecE1x*0)
zgaQPSg4#e0xvsKd1gFvuiAW5FVfh$#&DuM5?1&aOyMkun(p(!I^;j}+AY#jg@trX8
zZpM4xABGY>%b7-N_qhjl5NQ(;B`OyK>N(Gbnus;Rw+UO8d;|<t8R*qFrlh51fullo
z46N3+AumJ9yn>IaZDbS+8;Bu2-{>s`q0T0aL2f2xJ|(zhont;cJV*E-iTIwgOi;Eq
z#6op%f#b)HbZ=+`*3v#AD{s(9%YWvK62)I62_&uq#|tw7RYgw@pcvo`T>RF1VypxT
zYo@&&tga#9y0iK9ji4ZDT*~_Ncda4liTGc?e(f+59T|C!fQ1#X5~^l9J3I3~c-v0I
zuJM-?q)QcyT0gL8X;af<?-Yl|_hIQ?tymePbj+{3H#5>YPkh9*bO8K{JncI%mO#50
z#9xuu6I%XR9CL=s!LDS3kxB5~+~_Yx&X{`ts$&Ok*uJZ$=i<P{S#xV<Yakwj;_Q3~
zJ(NvM?y=_K!#9w(0`mu>Uf&1YiX|-Htj>*3gCMK|v~*DOJnB+~_+0R^%e`jq1$_ng
z!T*4RsAm#<JMEpE&v%d9ujLzBRb_Mek_O+s0>;sl24UF^kpNPBIIuc$ihSpN%GMbf
zg4ib<#u?YFLue#UqIYxsci8M@WhJ>(6zpc@%^brz;`f+8wA!uP5Q2(+$AJUJEEa14
z!%|9prA|io6U-9U1NJD1n1!{OqI#tGvotU4Qgua%+pyu+_7DsybD(+|&Ct-?GG)~A
z$nrMIGORxSqBAu*>TC>Z!r+NVUgcga@WCe16l^p|1K?0?9*3}5Opu?6+5UbTW0>AX
zOWQ}Y=VoD`e-gSqmrqX@<XU>K$(+D`9b#Sy&F<r8lgrA_xtJQOwBtWMIx*ufTo798
z29<erX#2gvQww<h(*99_IiM0vhv>4K=IeO647~2o&<uD{2YnqPAO2u6@Ui=l3EJ}G
z0DsQA%%T};#AGz$I{K+(NDoMf=rhiUFk8<r=bS7zc>&Rs;W2XdPDI3;K9@}NkmTy`
z-MbeUS}NofGwr8rY%*EH?S_semZhb*zm(fw8hr`$X4MQ9i!yZ0Yb0B%QaAJFGmy8b
z00*er02weRh#q`R)Y63@yiS4)?pDAcKobNBB~2Ktve{)+s0Fc3J(3nFp3`b@7o#l6
zLsB+9G%Xk1Z{+L>8=T%D-}z!VCM2M<RYxp#ro=hR0>kMIfzjxFARnrka=!3~Jrv&$
zPJ;mzOlm`eF4?Y!=XIYsQ4mFr9oj^3QH5&01QOQV-rjSwpcZP;e&JMfjg7NmJIj`<
zK?&mA+KsI~3FttL=nbjr0@e2p7^2okgN>Knxn~a>cc!{;F~p}oZc2vm=FNxv&0c-J
z5ScqZ^s(&O(5cxB<16od4&zx(x+AK$6M-0Fj8jfddH8OcgFzs9W+#<GZWYyP9qXi=
zG_g#@PWV2z#&73N9-ft&)FX#<@%G5Qq1&t#9(T8a-1>QH-=d{(9lEgC;?^Sc(@+-F
zwE3bvUluXqQtSay9%~+5U|a9RvhuOj%P_Pq`H@qXa@%S6)1k7K^gVz7UHO2C0p1Ec
z@cd%r$=!U|zk#(&Hl(#5E7u&GI?sD8EEn%TzDLWzpufQAVcNOH%Ey<L&y2jPu9j-O
zdGn^z#W_lx1{uD!YVPW?DF1vxP^V^mKi$HG+tMiO+@*Te6~J3#l!h5b3VeKPF2o%x
zm4%sVXlSTefgZ5Lf>_%!uZe;4xKh&k6T~*K`_vQ^6FJWw;fg3D2cFKk?@_2>h9-L*
z_?H*l9w%8rWh<-H(>~AzR)zzl>YhP*bTQORZ^`u)3kwSqh<*OT6b+RW2mSc4fkJHF
zGV9iHe9mgIc_=BocCFw!C}Kt$li_qk+3pDx7yKo@xS1?(+^dBtn%dRruRzY~V^HOK
za&)LijEv(cJWN-$=RrAEb8%mcA%t8OaXT=u5tOVzxODawU5V^>Qj2gwp0Mh?y-|CR
z*xit0EKjXNn0t(Up}FIG3?9D{T%&J_905A{tis1Ua~1O<6BUv8W709|fK(N$d%z%1
zo-ad2)q_oe?QjWD<+Pet^@uy72M&}xdo(gK5-sbLIQ1Pkm_jO;aat7@+LlbDQ-_%~
zLPEyYErDkQ-)S)wL4L#mRsY9zbbcS-Va#xZi=a(a!Y>HSN!np9K(&uYg6%HYqo_#2
zDJe!StK=+s2nJDkXw$lN)-~6NO92P<*4=i873rE9X*x3PE@AiJ_)Ps#inO&EF<(=B
z3%6Negzj@5!9`uMiSoB>uIjp5k<wiNEhLzg!JCHi?Ck6wKv86;V480gSUHNMdJ2uf
z{s?TQj%UpxLwJaBsLAo9))QxXNBO7V<McOX-EEyrN=%fz@af<fi}|5Z!}c#KAPvA0
zXslJ~n3Ut>wHy2$=R%J<^6vHP5rd8xt%6NLLP8B5#TvUly;C%erWAzM6^Ly8`|p@m
z_&kNNA!Iy4|JfECk!JfHf(yWGW+&Ft=^_YYFEpma#g3||kb;^YXaXtXF}a$BWTwz~
zQcEjgrLc13*n<wlxafV>L5WFMCw)1n7HFjnh#GIL@;%$FL3){l-75S0S-|<ja3M#8
z+d=LBke5_>B8-7%<E#U8+s)?9z?*hpC9!!FB2#qh+;`gH-{)B<v4Jr?0H1RXUqA6M
z$FJpxb$oT9RCAHvy|U}?n)guXrN~_y-xdX#WCtQ{z-D`XZkC=5=wvKjmf`KjE#_Ef
z&R)N|XQ`d%s{V=k`uggZC0Cw}_b_aq*XgMvo7xonOkKIcoBMUae}DBr$FH)Ci~rIw
zM>^@nC2s^7kqVCos#~!!<o#??P3%PxR}XQBq{r}?U{_X$Qb&QkApr{ysSm12iMF!)
zo3djxXOdG>7co|Z?v9kOe}$cr)%I+|v;!G&iHAlNzBEaBa)Ou^VSAo??nb#wROcj*
zzMFwHB33}Z&7;j~R8)A)g_YMk?S_foSlit>)~JlcM_n$IXp%*m_W;1fw9XxWR~w!e
zm|VbNuj}>v1ygzE1iJWig8OEK-d5w@d;7(UBSg@KaE~r4<{QSUZJ_n+zELqSU>Aoe
z*&@7cPQb0KT+kcc-*`Zk@MB3JAlHwxqZRBfr-xxxr~Y^l>D9@}b5-vx3`z}Ht?s!S
z=`a(SGEi+$Iq^cJL<6_D##)FkhpJ|(oc+buD6Dg?Bb%4!V4<L|?@ctH@w0e_S^&CF
zJ-IkJxPZN3-MX}Z0KRrCp*ASIa35bWnXRNbyaaHE{`IuOB=mnJK(SmuUt6a}$L8_}
zWRrb5)r1{t0n5$F^P94&ntP8WqGC-7%-mNSDg8ofQBKmU0~z2`f1i7$>U)i2<b`67
z@VQhe;VZCd@Z}&{G(kzwbwRevg@U%3uUrc;>M8fyEzXEMX5y+8W~S5QHkM~{Wg<BH
zyYM92))i#exIT8nzm|XalZS^tn1sv=S#B%$QPG=?+P>fDc=qgB$um!RfEriC-gd_7
zpN*3@Z{My*>`Vt@OU*ppJcm!8yN_4&k0nc%SeZhiFjUWbmO<lH*}|4n@SWkx<bDM=
zwO;Gu+>6Jh=pSez!+72}$D2RZK!$4OU~OR`nOUN>gw2w?IAKSXV)pq0DlURqcsQM&
zi2nf(D|-XiC}wfc5xfM9MDB>}kdcw;y*=eQb6q99b%iwBGZ){NP{lp{U|XdpXcs<n
z(0}^;MLJ*p@UXBX)P&8K6fEC_Csa}Ui9=h}nuZk{_xHMX86r}XY64<{BlO3YrkvsA
zy7L^h0|cOICY6T}b>_{_pDS5fTmP2QuBCeXxFi!QgFk~Uxo*Wo?ve1g^+RNnjN5=d
z?IP6h8{bj{m#c$@xnv?As3LN%pY|FhLQ)iQ3(KX&)L;fMVM2)u32|6*bSD$c)nyKC
zR<8T4QPwjD#qh+Wq(-KrDb;n|PCs`H{dBuQ81npozMOO<;B$}<P;l$3*%)F=2iE)V
zNmC!6QaI4N<_dodLU9RN<ya<F+r#jnN@kR!Gjxjl5@-EH`k+~@MJ;}n-c^F_uvJ_v
z89js+XjueJR*+xO=MpZ9HWD&x`a2FRgAg$KHR62jP#^BxwQF48bh~+fKZb3jnW(fi
zF!Rl}Z-#tvyP~40cJ;ZjgWb267o;lO#b>By8N-{PM?!;e5_8b<Eo!sct{yA<zKtxY
z@Q&8|fRBOGLQSQ2b;up?sJ6QHyVmU;T8}rW;a23aX3^hCd(NC1hyEqH6<xL20PJD{
zRRBC*?u1BHmrA_}k>hU%Fet62uHLvzrtM5AQd$}gy6TB>X&#}A>eXd3Q1)VgC=Kbk
zi6Z)blfotac;7h|Om`I{$9he`GAitmTq7Wmg$&z|k;ywEWH=f`{)&H3^<&^g4_=1h
zy7`fYU`@Y4Fc~d8hu;kFVcW8e`(+bVhSa2l*E$w+rN^dFYTpS9Gv6o-hzTNTlc=aD
zFXYOSrgi<1O%%M(YR^j;ra^Q`#lU1ty%ZpORKdrv$ccfG&Ly-mqC87nTVmT!BYER{
z8g>|E_%9dA#P=C9;wCFNjl+<HN+J$^Sqqr!Y;Y{o(ARItNF4(026nvo8x#`_QG1FK
z6P3VU)GpogBmq@hppbkMH+=*~4sRbgA_8qx8TC(`)yj-3Ql_K6uI=I)hMKK6Kn<N7
z?Qv0Hd^yj-<eRagrU2NSk*@*r?c0P{a_i>J6M){r@7>FRZiOxQ>yAdT8dCSf;e;13
zz0r!P-`js0C#H*A1P2VVK?|4!QP6ZN8KCP`*t)^^<%<{R0FM{Jw0bKQUgJ(rsU6S>
zV|P@W;1W+nG)pV1Ok`seDL-0mvhkDCv_nC`1b068qrKEM=wK>im%1S#{&);%Pp$GZ
z;FWB^a!x_PkOj5t(=^KA4LTXy79EQalju2^{op|Z5q~2Nx9oSvph5$MS#1hv!peD{
zwqK`_7X;{4+}K#b@xJ=X0C!X}AZ?OCvQg<|$?xUXr3?UbkxNC@>L40R|MtxVEoV%R
zF#<_LwxLWrNGgiQa6;uY$QNq|P2BT<quh5D#I7ZodtIBWcvR#(ylc%k*YBXbto-i%
zneqio@UlpNdg}C|&jqkZ%nEmaR#J`~`?(+Tgg<pT0Q3rvi^~RBcX3xtZ0rN9%-X(n
zYs!1>3mhQS-$f8uZKY!DvI(BHylSIveRW5nG>elfIdpi{s#T9M4s#=VjIkL-yot)$
zwA55IF`5w5jp^&@ywuG+UF`#bL;uIJGWH`_DY3yf9H!_!E{mQvdh_a4Evn8Z5n!mI
zFl`V-4ggRYVju^OCBx@k-0<ceTfAPy>^X-*9j-o?syGZq0gmR_s)32a8F*<h5#hS~
z%AC2|y$UBuBi72GS^dIuW-BQ|WrJ{j9FSy91nz?6N*}8BCS(Ote~}(XaAd;`+zDfd
zN?M9svq%q!DMl@H0lJ9S0L=hMWFzuzmzOt0&XrpCbyNk_J@hmQun|?Ge*+NG54j*;
zuXG>OC?rBbH~k*siZz=y<szpT!>b>~cLZSRM#P{pj-wjs=grLSr)tLMpdu69woMr|
zY!gzjl<(Xnd?$y|5SVbzzll_<!&pi(?qnan;5xkX9P$$6=M5Njc!_Zglap$V;Idn6
zZ2YHjq=aT?pgBJPHNTpsrc7`%+O`J}rD{Ntrv=T$k!>#oRtX7Z!@xlY2%EvfGymW+
zrJ>0szZrRtf4|2=U>`n&{=x8D6F`(Up8|A@-iR?UnTSGHn1uE>w?{*~bp@m4#J}j6
z4KM_$KYeB^{OJ-!GEjC9TFFBm9p$D(0N>Bse_B;uKqMj@6$*iR!cid>`WGKtX-mLX
z!DeDG@Irlrm*?`HE$%md4E!X#Cqe#11{yRSGc&Wui>p~Ux7}0<kRvkF`#(@Cq}v~(
zQ2iSLwxSbA&YvX{no(G&Pr&-*X!F&tbwELVT2l6mut=ZWfk`R@D~QnDr^Y~`UUlHs
zenwI(K5!0d8~ndmJMyDS0mil*fx-r3#Awk;F$75a1_H(dXhYTL(DA?PHRidTlK1MT
v!wL_N{_6SEAD$_Ao&V>u{#Vm_4fDUe5KZ1|@=CIZ+$!o(jUzcqXRiDgmcsf@

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

diff --git a/reference/plot-17.png b/reference/plot-17.png
index 071d225f00ad34b2d1ef08ee26cfb5c156443def..5471646427f5e70f5c0adee1694112ab83624b7f 100644
GIT binary patch
literal 53379
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
aM={P<H-2d6Ji1&;R)y|$!n49XB<0^ZAzwQH

literal 55162
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%0D6qLE*f~bRi&8De_5puQKRV5ks#&i}oDd|aN
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

diff --git a/reference/plot-18.png b/reference/plot-18.png
index ccd1d9353a28b52c981749a1dcfeeac2806e2b5c..f194dd02602d5fac5d313b3f12d5529dbc0cf692 100644
GIT binary patch
literal 51169
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

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

diff --git a/reference/plot-19.png b/reference/plot-19.png
index 5471646427f5e70f5c0adee1694112ab83624b7f..00349255bb0b0aa045bc10887bd2a239851b423d 100644
GIT binary patch
literal 43411
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
AT>t<8

literal 53379
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
aM={P<H-2d6Ji1&;R)y|$!n49XB<0^ZAzwQH

diff --git a/reference/plot-20.png b/reference/plot-20.png
deleted file mode 100644
index f194dd02602d5fac5d313b3f12d5529dbc0cf692..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

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

diff --git a/reference/plot-21.png b/reference/plot-21.png
deleted file mode 100644
index 00349255bb0b0aa045bc10887bd2a239851b423d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 43411
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
AT>t<8

diff --git a/reference/plot-5.png b/reference/plot-5.png
index 572aa477ba2a74cb8edbbbca58943920a203d436..cc37b3ce0762ca2d499df464b77d9764802f2165 100644
GIT binary patch
literal 29773
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

literal 25019
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
Ba?St%

diff --git a/reference/plot-6.png b/reference/plot-6.png
index f763b8dbd3b1dce69de4042e3efd18b5cace9d22..9f84b452fc47d25f3c416e4e1aa2085ff06afe7f 100644
GIT binary patch
literal 29773
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

literal 27974
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
Oa<ZqZpUXO@geCwUHAf-<

diff --git a/reference/plot-7.png b/reference/plot-7.png
index 8199e7a8cd4935fce6abcdaabf4d49b7a0ed8c59..a9140938af5d3cbd41e2f93a328da2f4a52942b3 100644
GIT binary patch
literal 26190
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
ST9;3*P~rF)x%i_OZ~ZTPq@acX

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

diff --git a/reference/plot-8.png b/reference/plot-8.png
index a9140938af5d3cbd41e2f93a328da2f4a52942b3..da96fb53607b5c357fa72688d66700999ff8aabe 100644
GIT binary patch
literal 33705
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
Aj{pDw

literal 26190
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
ST9;3*P~rF)x%i_OZ~ZTPq@acX

diff --git a/reference/plot-9.png b/reference/plot-9.png
index da96fb53607b5c357fa72688d66700999ff8aabe..e26051d4b8dc6186d55dff7cd85c70dc11a17ee8 100644
GIT binary patch
literal 92180
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%0DQ
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
CJX`z#

literal 33705
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
Aj{pDw

diff --git a/reference/plot.html b/reference/plot.html
index 7362d595e..654921f44 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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">
@@ -267,14 +267,18 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <h3 id="the-scale-mic-functions">The <code>scale_*_mic()</code> Functions<a class="anchor" aria-label="anchor" href="#the-scale-mic-functions"></a></h3>
 
 
-<p>The functions <code>scale_x_mic()</code>, <code>scale_y_mic()</code>, <code>scale_colour_mic()</code>, and <code>scale_fill_mic()</code> functions allow to plot the <a href="as.mic.html">mic</a> class (MIC values) on a continuous, logarithmic scale. They also allow to rescale the MIC range with an 'inside' or 'outside' range if required, and retain the operators in MIC values (such as <code>&gt;=</code>) if desired. Missing intermediate log2 levels will be plotted too.</p>
+<p>The functions <code>scale_x_mic()</code>, <code>scale_y_mic()</code>, <code>scale_colour_mic()</code>, and <code>scale_fill_mic()</code> functions allow to plot the <a href="as.mic.html">mic</a> class (MIC values) on a continuous, logarithmic scale.</p>
+<p>There is normally no need to add these scale functions to your plot, as they are applied automatically when plotting values of class <a href="as.mic.html">mic</a>.</p>
+<p>When manually added though, they allow to rescale the MIC range with an 'inside' or 'outside' range if required, and provide the option to retain the operators in MIC values (such as <code>&gt;=</code>). Missing intermediate log2 levels will always be plotted too.</p>
 </div>
 
 <div class="section">
 <h3 id="the-scale-sir-functions">The <code>scale_*_sir()</code> Functions<a class="anchor" aria-label="anchor" href="#the-scale-sir-functions"></a></h3>
 
 
-<p>The functions <code>scale_x_sir()</code>, <code>scale_colour_sir()</code>, and <code>scale_fill_sir()</code> functions allow to plot the <a href="as.sir.html">sir</a> class in the right order (S &lt; SDD &lt; I &lt; R &lt; NI). At default, they translate the S/I/R values to an interpretative text ("Susceptible", "Resistant", etc.) in any of the 28 supported languages (use <code>language = NULL</code> to keep S/I/R). Also, except for <code>scale_x_sir()</code>, they set colour-blind friendly colours to the <code>colour</code> and <code>fill</code> aesthetics.</p>
+<p>The functions <code>scale_x_sir()</code>, <code>scale_colour_sir()</code>, and <code>scale_fill_sir()</code> functions allow to plot the <a href="as.sir.html">sir</a> class in the right order (S &lt; SDD &lt; I &lt; R &lt; NI).</p>
+<p>There is normally no need to add these scale functions to your plot, as they are applied automatically when plotting values of class <a href="as.sir.html">sir</a>.</p>
+<p>At default, they translate the S/I/R values to an interpretative text ("Susceptible", "Resistant", etc.) in any of the 28 supported languages (use <code>language = NULL</code> to keep S/I/R). Also, except for <code>scale_x_sir()</code>, they set colour-blind friendly colours to the <code>colour</code> and <code>fill</code> aesthetics.</p>
 </div>
 
 <div class="section">
@@ -336,33 +340,27 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><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/geom_bar.html" class="external-link">geom_col</a></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"><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="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">"scale_x_mic() automatically applied"</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-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="fu">scale_x_mic</span><span class="op">(</span>keep_operators <span class="op">=</span> <span class="st">"none"</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 no 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-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>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-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">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-8.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-9.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>
@@ -378,9 +376,9 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><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/geom_boxplot.html" class="external-link">geom_boxplot</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/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">"grey30"</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="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">"scale_y_mic() automatically applied"</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-10.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>
@@ -393,7 +391,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">"grey30"</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-11.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>
@@ -408,12 +406,12 @@ 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-12.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>
 <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">&lt;-</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="va">mic_sir_plot</span> <span class="op">&lt;-</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>
 <span class="r-in"><span>      mic <span class="op">=</span> <span class="va">some_mic_values</span>,</span></span>
 <span class="r-in"><span>      group <span class="op">=</span> <span class="va">some_groups</span>,</span></span>
@@ -427,45 +425,39 @@ 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/ggtheme.html" class="external-link">theme_minimal</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/geom_boxplot.html" class="external-link">geom_boxplot</a></span><span class="op">(</span>fill <span class="op">=</span> <span class="cn">NA</span>, colour <span class="op">=</span> <span class="st">"grey30"</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/geom_jitter.html" class="external-link">geom_jitter</a></span><span class="op">(</span>width <span class="op">=</span> <span class="fl">0.25</span><span class="op">)</span></span></span>
-<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="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">"scale_y_mic()/scale_colour_sir() automatically applied"</span><span class="op">)</span></span></span>
+<span class="r-in"><span>    </span></span>
+<span class="r-in"><span>  <span class="va">mic_sir_plot</span></span></span>
 <span class="r-in"><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-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-14.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="va">mic_sir_plot</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>
 <span class="r-in"><span>    <span class="fu">scale_colour_sir</span><span class="op">(</span></span></span>
-<span class="r-in"><span>      language <span class="op">=</span> <span class="st">"pt"</span>,</span></span>
-<span class="r-in"><span>      name <span class="op">=</span> <span class="st">"Support in 27 languages"</span></span></span>
+<span class="r-in"><span>      language <span class="op">=</span> <span class="st">"pt"</span>, <span class="co"># Portuguese</span></span></span>
+<span class="r-in"><span>      name <span class="op">=</span> <span class="st">"Support in 28 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-15.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="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-16.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"># 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-plt img"><img src="plot-17.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></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-18.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-16.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-plt img"><img src="plot-19.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>, language <span class="op">=</span> <span class="st">"nl"</span><span class="op">)</span></span></span>
-<span class="r-plt img"><img src="plot-20.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-18.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-21.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-19.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 efbca0f60..4d1ffedf3 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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-1.png b/reference/random-1.png
index 05ac1ed35931d0eda965bfc0685f5845ec82785a..0c385a219e2095070bb5b2e7cb97ea9e97a55f9b 100644
GIT binary patch
literal 32918
zcmeFa2~>{z+ctb-W1DxzC`C#XwHqZ3*o8t7B2AQ%N~tty#Kv8zXpjb?qG*y(X)-iv
zkPH>6Xhd_VG~VBFUjBPO`+L`V*YkegdY|Y0-tT>^WtF<``?{{*aGu9;oX7d&wM%2`
ztm#XpvskQIYTHz_SggrTEY>8WU#H+FHCJwS<I5DI?ORpw6@P~Q$n?OMX(zVn*s)kk
zFVNo!{>?omEY>oXn#!iVP7&?3E<xJ%*~;DJGfRu~|IA;z`Bl2}>AV@gu%iUbuY@km
z->x2Ddf<%H>bKk0K76nvBWSgj*uD9FeDmfk6O3Z>&AxQ?<1h0CH#La}Ec?B*w9DUJ
zY3q?oCGAJAzwbVknBP0nUefAZ{^j7~y3YPu=UezQfo^Q$x29Hk`i8|C+4^(_eZ8bL
z-GIJ&25EIqq;Fz^&Mcy@%WlojqOYvgw?0j#uiI8n7N@Tp)mJ+)pQfe$Umx-RkFl7V
zP-B(3cKVDNC8K?+IX%ACLC)nmN3ZSM^g`5;kHr%4znd`|Gyh&oPmfnsRdvL*-f!uK
z;w)<qQ=yypn<ubt^mhO9@2!pA02vnRM?`C+hf)<6i*+b@6;{!<;McETJN3WY-{>WL
zojq;d%Dm!W(P*{6l@-xj{nLAkMH?*)M-DbMH#e^_w6U=%y(+Q7!0Ge3t4eOC)*O7W
zN;^q!aejXO?pTd$W^dzmKd^i+`QgE_d4+r~mb~_FcURmuDT&(?tMO9OL;FMDBo?nF
zE$Ntosr;_LDW3YycJ6EGIO+QJ^(_h4AKlzau1+W0D%W0j>CBM({_2mx5f>VXyco4W
zhxP6sj>YEZdChZlssB<D9c^8o)ARWP{}pHVw#vkmQ~lqrN*#SE)_QwK=-k>&$NH|)
z$iWxFkt%6cwGCzK>euv*YI+R6`Oz%yk?|&_IEbI+nH`NiwQRvcF+J`=eh*j6_xGD;
zB)c>R?{BC!_V>-OYwa9#?5Ivz;qC41u->3DMYGmzu(l^Pa?CO}S4u6?wO8%r*VjUI
zPK~~j<@I*uiZ&%{)7noaNH$Mp9qMv^v4q76t}F26i8e0ub6Ml4{Lpo%_e*7>Zo<Kb
zA|)@zI}+3C?n*a*5sq}7tDosmdpu)<W%WJ%;#%h3-00qJyw2<?;4yA2@Eti>9<ko8
zA*GP7MB_&JVg;uYp@qpg!`}`(K6%WtK1WeqUEQeAZ)u8E?c*P<%ACcyoUyLxKQ7Gn
zYN>u~Z$Tq!T7F%>W$5yXtp)z>-=o#T@%(PFbPX-t6eCrI;V;pdiXKlVFUos;YkPEh
zx|~CMHP?(qVi%=e%0*9{w?$#_qg^Ji#p@U~h0*Tk6;Y}_t5&UIXJuu@Y28wP8^2%t
zLz*>zm4VCgtnuNtp7D{cLX6d-3%s`5G9+COc8)jlb5`|@rj{%5gc!Oz-zuBKdNQ6e
z70WgF!&M1m2baz$A2DwXg=BAUuVmrDG^?e7D|dQdS9B?8dJ&j<J^8@{Y3+mqDJ4Df
z_TSorEF8n6kIh|I?`oGJX<74V?PL44g{h`xB7LKHb>sIpn&N$WCPj3OKH3t&AD+)q
z&Z@Ed<NVCksehK1m-}DfJGCl2g)SC#@7{@!Mtahle_SZIy)*p&@L0{G<34*d*54|%
zU8k(9d|NXzr^a@jz~ImX)+&AqzrmHUx?(}MFl!ZYyQ6FCYVPifk2B15e-zabV^Ni4
z!q-)mZ1^@we?v}haB^OAh#}t`h3<_z!lYN@8MuUmgqp|ef<^Zi+=;!uM9Q?Zx>@h=
z;lriZ6*u7F_8!9?+2#JojD_hxnCm`fRc_x^=jJ~c>G0uL&)YqkLRaG~_v_p5+Yu^h
zlGYlsMrZE!D{H*4fEDZ#?%n(S)L`dQ<<ZY`8h<qU*C%(mwI!w%D;QvKt}41XJTQM}
zp4`$TqRe77w@yRK5lIyPz;{C@)zl@+!#YXrnd&0_2URBDVjo%8^F6;X$A6xN+;R=&
zvG3Jc&UQx5G!mN5BD(G@*1&ZnD9=fiby<RIrtOQ@_FXJx+U^j4RuOll?%JkX?~RzE
z(mRt^?ssn=pTXhb;w!Y{m=*UL!&PZjp3NB_amnIj57up$e7WeZZkpAOaM`t{FC!N3
zH*~Y#8?SvlvNKY_*|s!PO8D{`Yyux2@f@effftE8FcZ}-lrlvUvF|$uKH@j&g(HUU
zL(PJX?ZNXj6(snan=V)1H`(sm{dB6t@edEUC5%+`JjVJf9v!a{&l=3-jN}e}&Gb_m
z{vy|tH?Krt5JRilRhK<DbmxP2=^WO^Axf}u5AJFwE?KMlXieY8aO<4KnBCfrY#Q))
z@%xX8e&9n;RE^%^8--s~#A-%5eL6kW=;@is6prM2i&m6mwfe5BtB&oW$e1<STT+1)
zCRwgL{-d$yEdS`C+(#O5>`@jgD3XR#y(7#b>3v5Au9Q*Q2)tlZYhPs|s+A#a_G+2?
zcwc0QvlU|9h(huf-z7ct2o(>Gy}`#}_g3V3aPkHUcgoY;GQmTu?OlA8Rk`9owXse9
zg8g|TUAg@D%-shME-AUP)~ByrS-HTU-|+C_3o{qb_27)uN5{pPB`0}|bflFi)L~1F
z4UhjZM^Spb$KOMx_OX45g7V2Puejw-e6s2)x2HAm^QIHAeCPu01EbgtQODlgz8o3J
zKQuH%QG$DegXQFv7Z2P!wCQ{MdnxnEgvC{Qb~|@m{eAg(f3in@OIf&-=F2Nrt`vmH
zSTrD<`(<`MjxSw*^tyA4`%z}p5CSvZ)_<UQ;`q^K>(AJ6C#(&*@SgD5sdM~dBi-d?
zt?RO?1~D2dHRQj>IF0rcre3u?iZt0%w8B4cg}=i6@<Cavk8-EJf7zYXg%>-QhRKNL
z48Kd>Vq?=I*4mZT_cG2P`_$<7Smm{S<9e-#;q}hUq$DG#O1KSwU$th<$M`lLSxat;
zyjFv^5-pLe8y{8~_=xPg8{|?cQOG+lIjgtWs(cQX{rTBT4|aA9B?w|a-?L_N-ZR8+
z9$GxI$3M7!w(qD(^GEhm9UJZ!U8OS=ft;6uBqZ0sUNJZPJ@SwE$Fu1OD-uR|Y?T~Q
z9%j{3U|1#-CVPCzjD>612&U_=J2iN5E4#ZU=w(P!Sj5no>N&hOu|c|2b$8EKD*PRZ
zCB5TOO#@PncUs*k(U#KCd2}BpC0Ft>?nZqrWxIhY`oF#N(M~*=Pq#^_d5@-|%n}*%
zpx_;?5q26Em&k~S<&O4BmK)l?+qWC5KD{YmyNC&`1Pz0)vDP~Yn6j4bv#emg`7cn*
zV*Q_t&hG%PZfqVb;IYo5xDXQ)^D!0Ml(#Eq#Oflqga8)am5oG%JjbMty^gv1`{B(=
z#)3&$ST@gRty4itOp4w$p;vwT_U(2{&lD%_Pd1P+ExoF8)WEI(9c^nt`FVKvAw%io
zAEfI%IAeN+MczG)g@x-|BLdsF_p&s*?{6Kfbu>KL@j(Vjs6?^N+G9j_$2EDGgAdJv
zH%c;>PQxBxv%kEF)kMZwTX-y>XSA=pFhFR#q%zM`rODzhZ?l~Hz963qq%r~P?VUZ*
z=KDBbh<pV<Ps`~~i~|n9jT^m;Sf6s_MSx!6jfo8S`#+SV-EEO)1=l0RHw?8#`UeCA
z*p`Q_vo=ssnZIaJh|59@8;iGnepdT#&iI(|_b(M*FC#WMT1EBIFFqZL`DEfhJlMtm
z(EOcx)14ZiioDUGzGzI+G{H%Dh3DDuGa-uKK4#dR?EJX?vd*L_GucCZty{~&WafoV
zrO%iuC9XrS{7<IJd*A6zm8&K!UYTr2x9?4h%()Cysu4KPJ5=f@GK~!{QkYFk=+Oe3
z!lnD49-~#{S-j(^?k0Md+sJ^ggmJ+UKYQ?s@!_i6EeOm~h3+FY^#!0XS#PpE#@Y;5
z2t<KVNZ2&w#Q`(r|4H%(OGHLjdatL9MWqS=f}@Dz3IPL`j)!JQ+d$0%0s>q7cr&(V
zjOYMvvXOoAfEOd)G19_D`BhG$PttP7Iu4{+>9^Q*e0V6O`Pm8&B9{IAH9;sng!@nn
ztL*+tCy*nf;-J+P$%eV5J%B)6-xt%><(yVKrCI{_^n8m?HdXTHStkZy75$_8`5fbd
zi;H*f+VvY4pzrBPQ@8Biy<0_vNP-QvW+4a~FUXqz)3Z|xv9qM4_*~jk4y2myJjYo>
zAH1<S>QmYMqmgd1sX3Iu+6+0TKtxql^3;T{%?H8pWfzV1w}e~!&0Z?sE*Xmf*`WA&
z1n^EVJcSwD`MbJJ-_H=wx};+Wkdhgpj7;w^JUZ6p;gOb_ls)jF^wh_6n`tr3l6k%3
zX}Af-yd+_c@@TjI%XOC3Ct}OX!q?SzB!Iact+Z=>xpUc4y0c5B)9cpg=DNF?x)m+I
z&~BTf9xSrKO{^_U^IhET6{!Xf%yv)wN-y-3-qUTWb4}h}vJH?}GI{l?RYeKPwUKFS
zoSmI7M{>GyO={AtHCHWXK2;l^Y60M6nti<Hk!_jC+O@veLTomX;Sw1}EZUZfz<T1w
zhR*axqsjywF0K@Zjt^#)3Gc<KX7Vd35ZsoFkBeKCI$pd#CqQo-eeSa0`B^%ZfD}&O
zE4Ho>F#7!LoXNthY?r~hcpZMX@4HQFbKFLbOk}jDJ0?Eo*R)lq7@Lm0-Yy<&QQ461
zBh?nDsg$9YN}uKVz3&(6D-Qv+{BRF!_El`(4AY%pH>sT;9$I9W(zvs}#$w{moH;|Z
zLm>6TqvJf!&(HE<v#+exT`5U%o3%}RvbDFKYft|Ap}M6T9P&VLe<lg-WP@uP1?VNq
zHa{&fNN)+VXaINL6D8GJ9vS&Xfqo;$z1r!0H1R`#<<O#eStTLj{#cM(0ZZm?W46T9
zbrikh_a}eB&jnJa%;f%Uj?#}qZ<7s`FFVs`ocMiD_wCZ}U*AN7T?z=uJ9b7iO4Bbk
zimi6q(-O2t!z(H(ip}0p!Hhd^M6Vq)^+;F*u<_^L)VTL&*OfpB3H_3V=~8L^IRv*b
z1OT{44ZN8fx+JK}d_2@WVJFdDV3{kFb6u|uBf!m5XVzcLwKMBVXsqm7O1;?ZDnk#&
zyGVOU&gagZd*n)2WC=W5I7_DrGgmqc=2W8p8~yN;XEZLQaZTQ&5~#4~@LcAH8|jBw
z8zz;Yf5rd&;li~Ck5pnumi_hiMj;CwZ3sBrQl>jpRQ4tw95)=qf-g~IZcFZW3K8cP
z8C<PS7<HYa&-{>cd+jfDnSUFD{|rTv!tAo85GO7dMbJpM&@Hg08w@<V=2*AbvCjEu
z(3LAIW&3I!>vvlIOg0IWY=9=_&!4Y?2%K>=I4DTv*s)_xtu;%TCn(-tQovVhTe3C<
zdk*V<YX;|gSG}@;z-$BoUd~>+!X@|rQfRgAnkP-#HRKB((22FTYW3>Xg9+gNh{nKj
z#fr2`irab$`TbqGvezLF*)0{?{m`PyZ!4d(AW<#%&-RdDye{y&%K_Da^W?{2bzkIN
zFX^YyTco%3biy7$wl}wT`hXS*$=e}&dA-D9^Bf~>km5{|@sa%c@qskOg;^dyp7T>2
zTM!gyv@=3ZVtAk<yp8*kJ=VgPn-}=Jd92cxU*?26cV!P26kT2sjk#qYglF&2_ZROd
z6@|+lw~bi2*aPXc;r-Fb+W1&o<?I$nk6tTxh8@{(@ErGg+ar)!nmt`a7CUTxTEf@d
z+A2ICo&j<%BuQW+;BC51qZ!B~@Lv>Y;)tsz?milXSZCXw9`mZCYi+;ox|wxk7A>Lw
z94(*bh_@ZXYfP#raMLO=F+cEA6--+cAj##BkdQXiO%UaTZhuNV1Vuo?qB4Qdx5C)>
zH$BLuodX{bHS#Af()*2gU&P7RYL_FsPFv8MK5-BVUP0_!L}K3>!yMP-q)4fw8YI$m
zf<v1@A)L8bQZT3QT9?y(riQ`()umgTjoimb$#_l8@eJKehYqvqdxs&CWtR4d?oYai
z6#ctc&W{GHsu!kubg5-R^RpIws?@dig_OLeFT<v>z=kt6SP1NAj8WdLr8Sploz+Dw
zz<g3!V`2mWY~~|-`#@U$9ZWbN!x37w&6}O;nm@(TC$dC%CR<-g1R!z;jykGT4-l3D
zRW|+ed7g%=#(rK{#+~<@HyaojyiL%NB5~+TeXa+dQlT@W^?K>hR6eI=NMPEBm6;H@
zYdyi9JT_OTeSMBw<3NqIKSsL!&Bf8t(e&mkx<*etCxjY9N7G!hf-Zka1KFJiRNZt8
zDsqBes#Qkw70Fg6>rNHMt(9HdurAdKcqGGA#_ZLN(hPdnlc#DxCCC7w_7uKM5x$O8
zzPr0mw2Fa9%f^t}9g0`S9;w8$i&iB}p0V&qCAQB0?e}%gttOQaF}xr;bX7$luMy=5
zwPP^S*+8TnLVKkS(^HR@`yr9!>sn_&)RaP^n6Ll%q!)0wii*mnO`G%}v3VV3lHcoF
zwA8);=`WnOatHg3#)h>50;Gn^eT$2RhT+F95zAa7@6gWe%d^f8deRoWza4tItY!6Y
z{I1=bsE|P7g%cDf$FQM~cIB#Aq_#bc^wg|i_L;PaC%fttF}aIcuQ?jDs9J0f5%YyU
zWD(iY)Y@8zB0yt8>dWFSJLvVxOe`yQZOQ>jD<nzd)s0QN4;)C>99%eme%_PQlZ-K9
zJ^Y*=ejW8+>E$uL$ic4;Us$>@_eZ`sy*$ONBI>H_@q?w|>%=i!*PIYJjIfDzCmwug
zhKdHnQxVF|P^oPn9ItVR+<uro=+hG*ozp-%axGVlX%)S&56YIb|Mu4D$L9-Jm0-Ql
z-j{N5A>4=zGE*j3P2hzz=<BY%FI0}^^u64`1Uk^0%b+()WGxT4A}YPiT9%{$sc!*|
zFSex6rI~ca*;a^gaqeToHWjLigd{D1uq6&Z`?IKg&>i9*i?s^Cs(44Fk|Lr2$O16y
zdJSg1Hfag??>0E~^%h9RMHPc*`HMC*2knW%s8-zC9-_CEK`pjxE}t1B#)4I#3K8Du
z%d49yxR_u8vrfAw&#nE{9!e2$01~|;JjRE5lsSFM*S|5#q9{ORdR@NHqQV=S&PL(p
zLygOoMl7jPg2&<}z0SU^QmAJi-6?C-!z=4ZBBFhdkKw2QNt{Fj8u#Z8@5}0bHUroe
zQ8gWGp>en^*&ktN-IUq9+_WM`M^*Uwk{&RaOF>hGdA>;Xm``Oh;}6P^WG#niW(-=`
z10lRnaq#0jNVL9eHlj#Af_B5b=d*pN-j<Z!;Ek=eDS%7l8nD_{@RKBC=H8~>NKo8T
zgQwvB{m@1#+CY5Z3emGwYx#%_#=Wlg<Q{3u>fc`~jkG%rHHT2qM0Ypy&e_|%l%DEd
zK@^bt8WY%%>@j9RRg)e=PQM}ZpjV*Ub8*cR*0|_3Pk0NsK?8-kx@?!NkhxQriV9<$
z>2@ZrZUNrig*p;ecgKB$Zg*{vvuMYzI!4b$QfqXnA2De8h#g}5>B(t{6Q7=Z0RqQH
zQmjbSO)DxXi7#S%SpaBKcoq;afc{M)XGY6{g$qCQGSkgwud%Awbp-+8s+^4x_M2O*
z?O-2CEOPyC_e4Y6NWt8B&$v1nJgq#T9;yA~Wagc-<rZjli|O1Kq$wf7i|WpX+Zxxx
z)>k3vUzI+lMWq>x=_16P7ZKqQ0cZ<h#&ozOQlkJrL;KH6o?&~H0bz2ljwF5>YYNmf
zf+k?oo>Ew_AJvoe!8#Y?k%0~_E=F%08>lfJ>TM=HU#_oIDjM|;3eu$QuYpESH7G7F
z)FN#VQI3k5R^mRyQm@NcXwMG(Ii+DLGwP_=*;lr%F>LReyBJu;3jo^chvb-_zsQi6
z_+La9%3und(Y~IFt^D~*9Y1pIL~X+EB?M|dknb{AcX0TCi#j(CJ}|qi<1z5Ugg)Q1
zSG`Hd0tzu3mD56f$Jzy8CG}tRFgOjj!>zpeM?X!iNYF{mzV3|JaI_LDa;Jc)23EW<
z_V7F|u6^-WI91u$AGYPp{m!20H9u<>kL*QE&ow{9l+{+bV*`kLTLEU<`$|!N6O7t7
zeUX9FVWZUEKGE;l|H|xFwmluW^X%EP^sl$W8>p!8b=t?V;Fd&&t+Vd0#TJhV)bK`-
zmpL`io?)oj*7*{0O=L9_pFAh+6qwu<pPUnx$IaZw!0B1~%$#e9To!in@$oT6?#7&;
zw)&+ubI_o6FeG<Ws4_{Phl@*jxWYfm{GCeLFAV9CyCL*CE{FL3Sbx=4l{}2f!>U1q
zR1vGJo&peCR9~Vo5NdhM1>{x<-dBB&1stLiY4>uyi(5TP;K4fnOE<`RtzzzFsxRV8
zh{37Vsa7c18q_=Hacw<PY4Dc0+CA&JtDP2!>0Q;SO3<-O?uy51H&yf)9~F#Z-pnhF
z--Fe6drayZbU%VbZ#sq<7UE(;*QXnow>_=7cldefDeM^+H$wyiQ+?2)f4+MIXrhj|
zL6%c;moBQWrehD2-PZo|-lWPEq*BMrtld+q25TWphT4~3R}5q`(euQsZ84w5UOMIk
z>i7djqyCax=wbj4?9_C5t7N2jMpMAw*Sfn>A_liFf#^h4>&0ALt=C<wsG?@|`0H(i
z-f@kpB*R>#^C;gC@oA|>sflu}hQM^4Zh(=(H=4>zsoHp527HpuuFi3D$vBE(-sLW;
zoxm2p?qn1@*u?uQW$^m3PRHm?XQyQNO}w-Zi;j!y?37vFh)!6TQUU@ERk`E#qfn&$
z0FCnyp5GOrit2%Qonn;leXVoD=RfB)P}J6vC^|!76>kgtQVL~GSbh!xcqw{{zDQ0)
z8@Eo+)2aM<AP|7-ES=y3Pjw*=p>Cr7y`yH`IO;DZe#t0hP@HH{+;8A)q5$m!64Ir;
zGw**waod@q2&3m(^ftYaz@ri1U`YQ)=i?vKB?JUCl!lt1i0Jse5j5^;$R~hXT0Z5(
zvh4|<eA%euT;y7@C2!}t+W8)%jr_&{a4ASZ*OKl4xVxed<_|Gs3sykj=&AcngbRT=
zM1N|HknswZU*HWWA{8RQreN{WJmku-Hf}GfbWu&IN`fV#5;eIi)=&Oh95*WUGx-$c
zpnFFQDVt&k6UH=c6lE6sY<Zp4PRjA7Wnt?2v^+i66qVaE>y$O%|KA#bf`b*E_QPu7
zvq;>pxg?|z^n7qQN6BsY$O^KBu%1j<U2$d*0qmkhQpU<U_mPgV$A&+>LH7pd)<k_?
zmpimG0(U&3-^r{+>=oxTj?kKV0wYHS`!WtcKTqa{H5v*%d8BDWXA|myT?Btzw;&#L
zp+;Ex7-3rikAXqlVf0hY$h=&%a29e|X#xk6x7v|;G?9&X2b>?008qNZ5{w|>sYr|e
zbx2N-&i*@ELSC1d&u-s@R|0N@=vaSvu=<}rGzrnaqN549{+~aDMTNV5q;3#v@@{;R
zH%haD5)9Ax6u-3XDGyiAmuUY2qAr9mc|AsZB#yp}h}pv6gI(wEs?GcgHHbl>C`E8F
z7Kee3nnD7C5TPy-19%rf6-6&O=JuwZL%2anZ6)IZ8Ak#rfCVM+2ieeAEG6NTwM>3y
z#U1cccsc^|D=fi8B2PEmjtitg!N2}}$mi!T;PKKnf>7y;l%fh9A}N~rsNh}D{;**R
zNyxwroT8$y`MbLdkUc(p4Wm*Wgg9ExQ+J-u04#Ds3Tik#m5)g_Nc)Z%w*f)U&*A4Y
z9PbT@21(rwmKBGz7U4GVo+gbqhPeZgc$I-qV{d`T8zAuc!sye{^8qz?8L`av`)oEX
zWY@m%`W=$$xB4>c$HXX5>-){YG9K=4Tg1f$xzZok&qri%czheYYo$g6H-VWF@mvKG
zaDha-nT5mKKG$LzDE?AR)5kj>fk`^8l5@XA`9uLwa&b|4d+969p7GCfJXWQC^koy<
zx`<FOAOMdFe}`75dmTzg4Txo$3M*)oE-4{4fwJ}>yh;&|;Nm)Z&0aeTRs!+@5yJ=_
zgnT74W!94UT%5Y3!<zY~2LTsWCt(klwgQb5URwSKVOsJfq3{D#vj!N3&+U5!{)NT5
z#vn@$(S_g~u>iToi&BzOosZj+NFL80Uq-jF@mAorryBrkc5JGFZG?NBm7esm*GK#Z
zuOVlJ_9FuXssyRGLR9#v-kMb<>62B8ZsG^Z>AZcd<^II7&d=g$K)tD4udl&Jd<)9*
zD_}V3?dxkqd5f@N!8GBBOQ9oQ_vF%LpF9=4e8#b<=yGU3l2jBFXBT@zXnT@vD7p)A
z-Fodj@cyV&8#b~k^sW{=jK<8R@{l&E-pj>B+RNR2j<riN@Xk;RWo3q*%gG7#20UaE
zYUit)&ox?Mig9o;1j3hUTUY0_!fRFV%l7xFQf=iND}nK`yw0Q7AP8h$>wiC@ykT7p
zac;2j5(O_kKB8xAxf_FeQ&^r4Rzr7yMzB^1UI)FcYJ1(?-6OzucE@Wcf@ydrsKtCj
zN#9Yb4Qsrk>LS+0N<4v1j;ph&ex=7=*YUx9&~j^E4!1u<w%WF=wr&W^gxh1N#BlDl
zp|A5wFb$n!L**WR04nlT689UP%@Dr`X451;g>?h~#u^|)a`JI-=1|?4K_-ajq4vOb
zfo!d>Ku<^9*I^xHDpZUP3G0+RzMWt(=)iMP&~-4g-q&Agc-7AYLnV#Q%r3rr9=Q`(
z%Y3QI$Y%dQ2%ArP%ns@izsIP}ngjQi^`%aDa$4l_nKaO?9-^`;dDvi4fUTi+LqnPM
zErZzCFA_3Oeht9Vhy}*OIv8Dn5zRdI>c&%zRx)v1Qwp))sZ#}uitOi@Oh?RSA=c2f
zqJ#;PrsSQSqr?r)XeNMCnP(G4avPLmTI9Dd(>pdYSZ+U)RrFZJ;C>}YeCestA3cCi
z-JhRJwGnZ`JZiMQye8EKgI~L?J5uKcH@*!H?N&zt8N^aMA$<N-u-G2+sRL2c)D3mm
zJQ!BSyJk4_{n7=Ux)G_nRL}0l!mRqCmyVKcNR$Prk4i=^f>1#60^6g@j)#l5q2yqd
z{zLP9l+^o%&dd-i(mq0Kc$p9o7>~5sZ)vp-x+*GgCM@@Z9fk}dp;fqv6-0^6Ag8oc
zcexK{QX-nWTjUz-SVCla;NsGKWa(w>uP95Bp&3X$c|PFm;HKzJC<d&bn_dIYha}0A
zSJ&H_mPV|X>dfVggW;>T_&&nm`|>HCYU(Xy5~0Xx#6w?pdZXV4DsJ_But=s*+lWl!
zhYeZ)#YeIVtYigI=W7O)@1VZZE{@oHQC%4O6)28>sr*ScQ>Y<FUW;q6$UfpRyR%RA
zJAunEaTdx;A%qCW4SlG3U4&qeaFi)nilnJr$K@$dXMKOYo$>tmB?9@yTCCK(p0y_f
zg}kZ)I3Q`mtL4W95zQg<2h3TALmDZRK&DYq$rB3En~O4@wd00Z5F?UJC^pJAG7q`>
za`il*y2+C#OB^Y>M3k01e?71Mn3E4SoBl>d#{4b2%dN|WuCK~~pJDYxj1++<p#47*
z05xYTet$*4Q>>~MI*(0H{-Q#}XCsIs1fU3pMY#-iGQk;ji|c2<(~NI42{Hp4S>Y!q
z(3vyRnLg5)$!L=ZQxN;Skh%EpxpZ_Ul0pR8Dz`ffOV0iCLPj)Yap{NvB4KPQz}hW6
zm>)jbB%Gr7)BYTH;4fWX{fN)`_o+v>BBN%sQsSQ$^OI4?32JpafI1<87b^;T1u&H6
z)1kwErDOG`X?579s%mO4_>ya2m&_V!2`A6Z4=4vK1RDNTT@>VEFvO=D0pJLzD!Dx#
z$J6+b%#1~{kg#xLtn%0~sxSRb2O^+J0o_vMrCJr9mE52y_^YSF+}*ash>oY>At8$f
z>peVFR45f)KlSa7p6buv-ipXMk_em-+V3&m>e2H1G-g1Dn;v{xOJzhu*l>AQ{(Na<
z#KJ82okIJO<LrKN>Sb=W2fH;O1f?Rf|M4#l9HaSidYxmv+d8qwU!qD|XNaXQ+y7Ix
z(7Izj_mA-(h00`!;!74q?XkbDsxWBvo`zc?2F1MM0M3Lh|9(0kBjoXp2a%mQWCPuC
zU19yVckv-A^XV=<&u)47$c#$VqfNrfUL@0E-ABa#WR!P;QM03^3pSqp_z~9Y><#Vr
z{)V0X^a-q~w{Qh282$yJE~WkpZT<9NVr~6x{T8{b=(PS`FpOkmUjAt|IsPGt>WJIw
zFhS$|E{=SB`<w^;Ia1S>Z@dw;?2LfOcGbPVBv#(CdMNO%G3V^Ts$u*12Ce)=F?*MU
z%2OG->mJxA>%QBpzwyB;F*e(qr$|e6)B8n%rK98BtqNLC1)FxP6n4%|60Ne=w2gF8
z5*{p#*w7WR{!LS5eCUpqmGHUopU|HHSE9)p{l^cgO$6^IB&?}CVC-uYGGXIsp}E~T
zFjrqLX%65vKlkW^dHfl_a_?CX&&Nkwm4)S7urIHEaROcA7tj8#)sFbId*8l&?OJmk
z;W8|kG)G}qyX2CGxuebEq?atrym*ETSq)IwMI9Ei=I;`i(B)8bd{J<4u-eRro6pU@
zq?0mBwt5-%*}`}4-u3fYbbic8IrQ`lp_7Th6IdH13Gl?-z3UAKurgIU5#O!1Yso`}
zRi|BRNj9W2RTUMiu?IkZMehWS$+Yb;?%Fr!)y#C2Niy=NNH^dvw;xGZ{>S+|7~^=Z
zZE(~$0;;s_wdaIMMn#vF=Zmf2g7EB5hTLkCm|~FcrI3^yQ%bhwk)Dgny<18N>&67Z
zx!p?OeHa}h=){cKaj45Wv*QuWX)a{y76^QiM_S?6*hoJJAj|7pAH31<Ii6N4>qX8U
z7Aq`RWnvu){GtdaS2$hWvNe|T$cLNou=1et7Z;*#FcvH%MUvicl{3`Bh!KcjYC%lQ
zd}SFVC{aX)Xb;Xfo^-StQLhno&;wTKBiF?AALr#lZmzaWEi*!5p`>>p{lww9x0uUI
z^LYJ|Mb{%^uYiCRZhe)gXuM50RYKrp5D+jLA04uR$h>klLnbz+Uf%YEu`bki!f%wA
zR)eecbx`rcOY7$o`QnKd8M;c;L;5gDOtYwH;D}97fTvMVoe2VFvU8_7#oxW#+woX$
zyW@)hp&<to6O(`55ELK#oH5{&cc(HD^qOlx){p=51)%-KY5wpa{(vTC{?Qa`M8c{2
z(`X0ahulB!gZ>S_@_a5XDppf;Ba6Vt60yDe_T>Ws&r@_6xJUt6B@aYx2_cuiud~*?
zQ!5o4y8w)VmtaG2aq$l*yvF5<gBOuTe*o6;wI%1eACU|tArYoZ(aU9~eKlkh-7cOz
zAJ9%c>SvfSU2)lSoj}yl^6SI^3J9$c7h$t4WqBZTdjS!yaSTT~%_lhoH?`v~qoRA_
zjoYPNks>R-sOJF%sNYEQ!1VBcUyay@4fZ=@`9kXbGn1JB(bXwZPPu_Eju>57>cC#=
zP`#WG22FZtq_VPYhTa1Rj#MMS_Wzp6Xi8=dbLTkaiU+<>K~AM2<hd*!`Ycb=)fL-+
z66jYarrS>G%IwPFnWOl97uhUV?zs9J@q9KL#hj)Q*Ws_RJum>N<fZYyYPtV2G1>>3
zJ=x$g(9SJwwhMN;sDd2v+)-N+8w3QXs)8N{#eg-;J=}P)y?yR1L)RWvcyR4PPo%+U
zB--wQD6-|k?4@ARkX`-s#6tG2W}dQav%myvu@E0PhgbY$4&a5`5tBGx$+_e5n5!$9
zJAD?eCFbJKwid7Y9rgHsu0TWQ=3v*2HE<+5eY+D&^#vKLw6>(omKq@Ie_I9EAMk{f
zq~Sw{SFK%}_|Cy1IolzJTqi>R*b*CTn~GdBu>(s+*95*uIFSjG)>>no-LL&`>nVWy
z2$0*51IUH8`9-1aR|I#f2TC}0ekAnQWSj8?MZ<*q#UlA)Oa?VOGI#yiG)%^jgT1|d
zVj2l~IoU7e+wiu#&9)h&#zk%Q=c@p|Jpj?1G<W)**dkR)^ToJmq|8*X-O>=aT`>>u
zOX@bg@a}48^jChF29s@@p!%_sSH$#}Oqx3TBFfDL$bMPR+!1+GP!P#Oiv&MfNM6iw
zSAzMm8dRu}G`1tD?>Apz)@O_g;y0ou_Hu;DshZ<y%{5peE^}{5%hR&{{QN>8u)T4#
zuk69YxzxLW3+I#$4uAhT518b$WIc4~1A3T=$#)je&29@p@HjhLepS6v$AdRyQs+2M
z6_q;+4p#4rftRh1y)z}Neoj_ez57V>K&XWA7BYSf)d)wN*t|wB{dZ#dFi&X^k=0P_
ze>+-U4yPr5#A;?eN-JYJ!Ng8Qz{bqQMXF2n$u~P2u|IUJ>hIpYn+}dnJv&2P`gUb9
z6)61D0HHt>Z0*=qc|6070J^J-zv2L!FcmOmAjbgeQ6pJ@cuzc;Fw~`pBFf}AM(x=a
zh^Jw*scP)8v=(ly-|4|E5>mF%?bWxE7D+nc?Db8TMlYmvpxk5gT1{AJ-<Ie;aG0hV
z@J$1&NJ4Ex1L)Amd6q&2P}dQpm+d#mmC9OHHg|@T?gKNf6<huETF&O7IPGIHOpP!@
zht@UJZ08~qD@tsEBGDCh5)w+&>@q&uj$8zps_%sJetO|I6m)XN5Y~iu{mU}8Hh?z)
z5P)O=ZpkCtkhwj)!mS>!CVkvwn3#+oBCp&~Qy{H4wK})xw`jql`Y1eGSYj!|-{Ltp
z%HdA!?YMvc{sO=Lv1OyV9?9oU0<<&5i}#j~>WtkSw+zygo${Z|5=1%>LF-5?Rrpi3
ztLedZ89wTTxFD_Rh56ROMq=m*!m2dYr6`&sbfVH^alh(={$<eC_59tl;VdKc&;R|s
zd3++-B~VMV&KX)+Tv8IUp>nW%N+<H<guD7VC>0Bi-?T#b(m1KWx-m}uSmHT9j8aNg
zv8nG2RkW06<tm7P57Y%e>BA>C-aBc*f(0d`<Rz(qM@_JEWiY63WICP}&kfX&f-=xn
z#LtkgeQ*HE^LJ~&@F81!@=dd!40eyJ3kvO%@BX-ughatDf6`3gXg76`*`UmWU931a
zZYFEhpD(X%C|sNNQL9~YuHD<+TZP8U&9Q~oU<*Ugid4=#sah3!Jn0d3F3CV-6NWIm
zU_-})Jqjc3sU;CFTwiUPnhzjtjHSkqDA+@gpiBy0G~1FA++@v<WjgE89IpD8HgiE)
zf{Wx>8$SmH1xep=)X!K0{;*R=fd9T}MV1i~1QFfQ4sd}jA!7Os<sRd9OqDJtyR#Fi
zj}Oqvk8=HNh3+R5#oWUY-zBHa;p3&o95x#pNcPL(ELy1>8-unz!J2Aosd@Qn>?V<N
z=tI3}D1>mwUO#1?@c7%^l&4d8@`zDWi(Lfj1-rGi7h>O>ARjIDTVV<+?(B(8hdo=M
zq2~7=*c5&+SlwpC<!vb{Viorg!V9R2go_J0iqAf69U-s7;X%)5Z&>r#p<@ZbII5k)
zqfzgn%*h<FMvH+?iv!SQBis{xpO-QBsv>xDN*83ytJb-w@T$#xFW3Rh2r6lqCsU<2
z4@5ey-+?@#fWLAez`V+1Uo~eOSWa)gw9+f$X(pT%1&|rJG?j*q@Y<D1^pqHmOS<<4
zMhZ%t4BTU2z(;h8dKXA~azX=C1A>qbi8>3#4S3P9L)Gpt*qq<Ly%Qy~aeU&VgDEA9
zHoD{{6IaNw1nivVgmoCL8L1=zouV2L4jnCdol$Bpj!0HOWBCGjld_#bUMP%x@4s<&
zwl^Z(=v0p~SQ}{5A+7mhI<^3>Mm>1&pumROk_3x?g0+QMdN5yB#3dw*J{^pYk2i+%
zLjv{>!OovbahF=tAC>gnEHfuO_y($DooC*AV>aGfQc@Dg{qvRbaduBekUwPZzqeFT
z;dQ7!?6rs~t8VOgyZ)0RI+6PL;~qtM?*Em^ExVk&^rAlJzFYaTMt8$q-J2;uuvns7
zpD<>}OIj1rUWH8>H21HLWY2$fB>%#!Io4{Se|aG9EbM>(BididJ0O7HG!OYrW<ck9
zXKiLxEHCp3rnd|xSSK4~&;8nWO;2opq%HlF6}BJ*oh<mX?T&op)65qu!&N|TmYe_U
z@xJkP=L~$XI2Xr|Zclkzub&V4-@l!Gt#fpuhnyR{gqgjBM0(1<AM^r39DJ1eT`8;^
zzr9rEj5>Y272>VGr2(j!i#iA&m>nKU6R3CX+ezMR36tU=qmY1flzb(`(m$O6Q)6wM
zaNzTvXj+cf;dM|cj6maSRO5t=a~G~T@Eh6C@Nt{S#ik+m`A<rEKKkm>WJ)eTv2$O$
z<a8rQwl<YIM^)kYrS-Dx@I(XilUSGq)H1|yv9|L(R%}{zvLDQ%e-WAFdBkndDi}O0
z9Zh3CdOK~CGFrl@<5r-s_jY?`eK`ba9uj-#cP|zCO5>7}0O9txgDI?HO%RuXs=Ch-
z8k^U}{=9jbFz>7kR09)R^(XKxwKITl?EsZa*}g3p!pKS)4hn_O+*qC~OD`laa}X2s
z-<$B&6VL-m+<V$zE$IJ`*UW$DN36wS7Igrw*$Qxn-GC-!)g)&5m|6ak<y%edO(4Zw
z%YQCl_adPs6Eth!ZT{&6pl4%g6)(=3EQ?$iTqhe|)>0GcHlPy}v?jbTIi+BUsG=;r
z=92rwx{10_=lVi);`|Z3`li;GG~4#`F&kx@_+JZr_0ewGOGwvWkRh)<3YE7v&#8qo
zfnP6*8ECV*U$Q1w0>S+No{qkMUy`O1D`}qj(zlP$Ozq)(0rLKW`=$Ichz;DRdPr9N
zVxU7g6@rmLR(hTBg!#qf2El4y>#*31yxS3oKB!*rZrAeM@&yFmi$roI7#e7CV_C|;
zv~i#vM0xt=C%T8ImpQ_H_$ztkNTuNgezj0Q<6s4(PNNWQi~V{wstP|oo%Qltk9@0A
zIBDB!&WHym`9+RKKic{TWnrgCZ!TBnxJIA`k}np$j1SF_D;MicVyXP<G$RR0qD`ak
zx`N$XmoA`8K^=g!1(D)xs7L`L#ps?B@AmD_e^g_|^K(z&d3-@q^SAIE587zLI@eR1
zIg>oOBv@RIS1W+5y{IdfljFFHCHlR#?fI#;#6_Uly7W72?Ri-K;Z;hk8)_D#UybH5
z#Z5{mi}X%x(u0M@hT5H}+UBo3?qrD~SH4)+R@~=WY9Ul92ty|;k+B6&WuE}CEg^78
zG6h;EcyU#C$P`+K5+7E2!<CW@afi&PHpm$ZGH0?p&-C8WpM}7_hC1fRSwp#oE>1lj
zAfk$31_#@FX&HG2adj`;6shFKq$$y)bhK;GZa?5yYi|tgLp6zs+1ut#u)Yj)a{&wy
z3j&2T{UE*N15oi1rRPOjNjdTPnNbKMDaUwvrWI9UnxP=9V+2f)>U5-UqcWK)Dt@cT
zhOc#COz<05to(HR7xa&la^v&$O>80QB$VIv9o`GwjgR-yX9}FJ*wdVNE|ca#G7VXp
zf`Wq=WHKTC#$}7$?Gq1ZuMG5pg&?2YcBruCi!t|NmWMs}7NBt<h|n4cQ~0xSMa$fu
zEcWj#@*f%z{)cnfzke6zcv7=b>QXLO=-a_$85y+Vu-OQ}NrMM=Z6gCEK$i%BfVaMS
z6nM-$ltj1g-Me>wCMg!nCQ$H)Uo#H^!=*1*iBd&1ZhB3gHPXg?kWA3O?ZL+CPOCPd
z;hOeaw^lS&K!C|ZigeN-AN!JV48D?iaWkhM{n-TqtIrmARlN0fO434ub+5RKqy~g3
z1M>&(v~}~fb&m%Z9Uydscb{^RyORQ{Cp7Rw{1Jn-c82Yxh`{pvW#|%9zWpCa{{Q}f
z{k!<#KlCFg7ucs_XSilkFGny9Co8{YX5EzUbuL}`BtH^q1&psg61cOWw?y0@lIPn~
z7x(SgmmwtwBEi~2x9D9Pm;CC)Q-q%{AjJx;FDr;2aB*4ZjyX`wW6(25u8-bwdif>U
ziFH#>)VmGl6Y5?to`uLxagwSe0^wz{hnT6|7&gsmh9!hll5ktBlc7yAUUzub$R10T
z1u8AE*&DjDq-LXiWjT|3cZnkP@WA#qezt-{IH-sQGr50XCV%qFZ;<Fs2?3Hzj&uc-
zFvt)8$L#egMGUrk8>gBw!|dDm_+V~p4FiEJsye5-5eXnj%~Tc<Czyic+Jg_+U{b>B
z>fVu0_e0sMvCh4=?TZ33<1ZrS+!=aeR1<aGSicvcX$#7B=%sm3&5YMBP23~Zu6jGD
zSSs2c^5RGX8SO{_{dPCLfx0n+LP82V((3s_cidjCu79(Bv}K(Q%)Tq-TOf9Xe{ni@
z0_0cR&e`{N6Zuy@qDv!Rj4+|+skz+?t8v^zUq>Vg3^D_`&<M#LK|V9aLjj;q8E2tP
z(^9z;hjxH5BAT@+R)S`u*q+0dsXVaabn)~y=q3=_&_C9c92nsMUCSF$uyv5)ljq5K
z-3t%s*H4MWtpjoSfSneQmy{Vb$O{ywqt0c)7k-Er>CWq-42o;%0Iqu$T<wG(lFVC1
zA(z=yNT;+;a1twNv$x0Ts+CD76*B^D;v*0Wn<{<Be6UvdyvSNlD{Ar`c&C7n#V1&w
z?*IBmxc)j?AQIC=Q8i--O7-CjY&QI>q767bL%r$jOM12E?M=w&;m058<S1eV$RDo(
zX<-fpL5Uc=ktCDLZJ!u{d*@ltv?sE_zOEy58cE*(#!LcPnL4HdOc->s6RG5h?E52u
zt}Z{iKa0w20cgy^16BaR#1u2166U!uU+l)6HfU_49o8N{o4k^~%f%<$S0_1yN=hsD
zF<Io2E!IQ{9+r$TlG-@3q|sY6Y1@%Cbmz;){)LE^-TH4i#(!vx_@A5|wp~EzFCrW$
z9A36^*Q{AWcbu(vNQUlsVD|Y|vaE=xsE_{U24q}fgw-a}r?82bWU-|IYEpDe9_P^n
z%%W=XCSNMirGq8UTWSY+)5~vbF9n3H{B9=$XE@`<jpQnY&iknPmb5wbYLGo2B^Dcy
zc{(d3AI=#=lx`kU8HDr(ti^Qlo$y#^aiOxl)`1jXFD|4PP>ogM;{M;heLLkJTxPl=
zyiESA*km%FgO*)>aU`sCvGsdPS!^L=u$hT<OGp&q;@W97PAUTwNv`h7PllY~{VJ|5
z1$HX~SKG?GAWj09Du4pHIAQIu`5-3pcwb|CYPrV0Rf$OU6=>Y;M6RcHz&|Pyk!hSx
zF~IlxAZMN@>6OqI3Oow|?TNnxQ<{bTgp4VG(-xNCSO#-|GHe*VH*#y4P<LbT|JwBP
z|9)xRr5N3bk^+^4sSN{=n2zqimiEFK4XPO7e*m~cSVQFQW;|h+xAJ*G#C196hOpCE
zjasiUVv8>d2ny=z5hobnHOfE1deW)h7s8Ey&eLEc;8oq_{5fr&(X&6NQCEQ~Nm3N>
zfNje|vuSs3R7sy=eHQE52I6=D$!pI}q+tzF+5;f3we=W>W|u!<D(`RTzd6AO*~}co
z{OOrCfx;O@xMpjJ^6QgufQA#oJgLyA>lmYhihP_`VG+ms$O}T@n!0m|Gr8ALL(fY%
zu>{(&idd{y)nF8su$Yn$zR8-Z;B-KT9O>GytXu@4<=3-aj+zUC75Y1cHP$x=5qYKs
zH5AGDs_EgasXX@J>A+6{76Ah0fIQP$L+3z^A}>-|THcphjHt&L)y$?`M?iZa?G<$W
zOB$5fP?YKGK<7rXf$=Ql=!~B}i?TgFMvGp(&BiZ=9N@QUlc_|`%lT+C<2YOt<k(r+
z``L<WF)AvqXdCF~i@!+*S27$>ra<lDt#de`3qBlOGjZ>mZk$hbp!GNzWAjPA^fX_B
z;p+RARffZQ<|ANFj=TNY4N1?wt_3F_!3z>raMKo$5dWrgtO5dV_vC)+@>72J(5a_^
z4i}leX9t%ngf07T${6&O4>|U3qaHA%?=<I#ii)<q<@8q>T1$@PO14#zV2j;rh>IHN
zw<-xVP<J0F*@7Ek=hGxD>fzzYNBq&In<`Flqe@OXo_xlxozKISJ>0LQWwhTfiGr?6
zH(3@c75lP=%!tq)nYX}K)|OQUOK0_w%A8}xdfT?V`4Rt+%L3KS@h1oM_4Sh%`E-fz
z;_1E72lwfQI-nVqLQB}qq8b-Go5EuW`yX;B9o4lkBkYJ<n)So4eed=g=EKam?@Pdv
zy~hVRaOWPpvnwGbzGFNWX^WQGl(@LV{Sc@Mlz1%fZ6cu;S~*90qv|YS)Rdvu8ye?Q
zp`08vs8w5g-d&;rSU@F4<qxrNV^DL&RnU06_2Fp|3vT?=&%RQpb?XR;sbtT=RgT$?
z)I;3;Qk~N1KR_ybR92P(Sl@@Hfn1cB$$rS+@dic`(g-o@(ivmPWhvH}NdFxx=ixvq
zy*q~zB;rdx&|x*A{hFT(62wN7QC10_Ua%zfaXSZtw_k+YqSQQ-gCapvpYoq?ZalK6
zN00N3mz>|M+P~c&Sc-PuK;02kO}9XR^VXj-OE3@$MZQ?n>Kc&nMw(5gB}NqoO=+J>
zAjcudHfp*=qZQBq;`R1GAgTe>BffY4eql+2m4SEOZMrQ%j~}S}$zxD}Q_tU-ra%e;
znH(nEHJ5|g^CIbg=^R8QItKuj0`nWiOQ_+}e5R8?j$0iqH?N3{`m0nhg?N0>I2S39
z&I{nV5q16{&|&4bT0!y?0+Gf{5HUYMDBX90VP4u%1(}B@L>p?l9UvAYrqp9E7$FqQ
z+O_-nH}E5TU{Zm*p<DmHz|q!9`L={T@gDa)u+et*Muy{1n>dM2em@2*2X8OzG?5H-
zbutWuxRQ@PlqEOrp5KE2iwbeVJ1^Niw|97<i)r1)eY0Xg;{l3x$3N^se8|!|>bA}l
z1!(X7O5NlFcQsB~%>nd-$yVaTg(V~V_U|tQo8sQNmd_k;7`-#M3fxIubj6uO%uS+#
zaPr&RJJlwyHd5RvT<VxdG=z(b@EQE>x3qmqINCZoi<!nW5NQ}?QOGDnvto!@BE_GL
zk1774yq|)BYDwn6a+FKD{kM}-+UQt4vNTZdxIoUBcsttawQNEe8TH1AU$SN$Li$dD
z)lIAq2Ri7AQ$a!3GDUU#lq0MHFqkaB+Vz5tqfp?tl!r2{D~=2(u^d5xLJHwC<orh_
z2H)VC3ssAZ(gSc4oYH?23nMT|KGom@^Adha7V%-p(wYJ!r2hc3YJ|R(+$ZByQe4~s
z0N@8N{dC4H?x}DT3J5MwhjsO!{7a|&H4-kTxk0syB1lT*K?_x^;wV(cm?kQmbe65f
zU&;u3(#QYGwEw<P{FiS1zYC`P&p<GDfZ$nS-Z1gy!|p{WKms*=>VM8c>1`-d6V@(_
zf8vrtXAn9gVi$Loh@o3Wt}P)|+g$gX@SPz}4!|R~jQQS=KpZ_3uhE4O7#A1EKK|(a
zO4!%Ng~^o-XsXsV{b3M{JunwYxR3rI!#UJ99&*|ipavF=iY19xKi-$SFGN~4BxZ|p
z+P=1w89hz{I_JVT<QMsLc8(Et2b~E-$6o>63QHhXl6TY+fH4Jms1RF{*!t>jgZl#K
zu5!RBH~7KUaIorLnQRSNK6XXc9ug8#<W#zU)hcSteP}2@zu~~~j*!{suDVz#&kdaP
ztpl60Of}En9f3bl+t_#MhDQY{+TZQ5Z|6H{>RcCW<!m4`LK2*A%JQbLA9jLni@Y+}
z9f-Ynud=)h7U?GPi5&FRWf#tSA^LXIIwgPMLq12;or>MYhgv7s?YR>BTOXagR`vC2
zE^bZw$@TjRYUQ|}$Me7S*MAUK3{cY69l5o2dF8Q6cfow2B{!x4ZMk{tPn<@>_r0x3
z9Ibc5(PIGUjh>Tcvw`qaPKy|ufWWV!!fiSdvA6zo)m?Ez{KyL5J8L(fE%n-$bitCo
zTxZemqq-w9Ru8XvSmfR=NqIaZlK0U?p~v`_tV^DNLe<#9jo9W)CpJ2O<`YXsU8~YL
zflwt-YGRH7tOlbF5U{KtSl27PsExW35W!LPS(yJ4p19m>te$+-<Q9;!h=c-C!F2I~
zwDh`B#|cg6-1m#jlhNp4^JK!*JW>U$vwF6mIcgELAQG9t8!6v|07=tn9rZ1APe@wh
zU((f-uCI#NT;@T?eFAKHLFCLsbXtNtE%wjAxlD8c#%n)F{p!#ea#vTo-*?4g>LSCZ
zOwt6h_ipasli7A^JaO!`(AS}~f$fno{_n6hcC+on9`bt~yE^aOP3LbYpKPkvwnMOL
zE#$zlcJ0THx8=p9oWc62Ogv{Z>O%LP<<xs@s6xr`%HH>amT-ENWHt99zZu@KnLc)E
z^I<_54(B)+bxD?qH6pp!#qIaMNpk8v#`v+8CuytQoZm2H-4Vj~b4ucK3e7EYzl-F_
zmwoULlRLXe%N)imYKPydq5=<31NB8+78RIAC!FNCLB=2ZGWA$H79F|L*lZ_&)kf$M
zqE2pa^-)M~#H5tgyQ5g<ePGtC#9e*Lhn{$vy!_awon7z(>tQ=H1h*dbS$9;OT(7;(
z5Zl3D*j(V#xu8?94fS@QT(L#XE7opLH_&ZMjq=F*a`X0F#ERA$xb{W1?R;AgZW?A?
z4$Q|6-Zc}$3=-2+137J{rCvbuP<@urdfIh+!ZFMiA9&-#lQ)-U7tT{IxXaR76;eWO
zhKO7@NE{1NmIUkt7K|OQ=QMVrI<ez1@7(*CQP)gVW>pjZG+LE6N=FX;l;bFwk>gbD
zh+aS|T}Fm3vzNKd<G(K>!_~ccIvL-osh5k3s{E9cixylC8Xp^Jt!XUuPfo#vb`GMB
zw=ibqw=T3tmZ!~;|8he>d$R;)4}7eL2oHplCAwA_CMqfr#GC8y?`(V^+2=tCn}QFy
z(m_Y6PduN+^mI_eSqgCY=3w;+g8iddVX+@dvCZE!9H@0&VAQF2JucA5@E7i|`<wN-
zJ<yjtWP{Sv`@8}n9Z@L`y}Pd_0o9odV3Xu~U2LuuS2A9?Bj{+|3cP`zwW8ntYGgDD
z)5&k;l+0FK`zFP~tXL-j!|d1AepG5VmYIxrTwr|ja(v0C2j}b+_x5;%whU7FLdr~e
zPG}xjtd>3AYFp`kY;O(ifwawh@rh$g(l9>{`TIZ5G}snOiGt4IV6)AD#x2p5s+z<W
zTxyfYHI!Dj6Ujmr%#+f`_{Bs$G1Pc^RH@=3fmH^$TV}1RufG%}IMqAh&A_8Jw3F&J
z>`4Jbp+LLouGy;oYaHx$yr#s>06i8x#E+=C*{DAtVY4EK`VHX0J1{zsmYX<uV7^8G
zmTHKSeJBFhNxKBAoaqvSe41}BcrMav8R5TYgY_?NchmlLGWZ;wJk@IL0a!ygh)^lK
zq$+A^Y6+<AN#Kl2h-!dFA@7wS)0$<Erc+}xAMSzuW8jn*z?GP-s&vfemmKOKq(dBu
zt))n)Y3sM<f)Lx_tcU`@)g|c6@kXK=<v&H$!;b*m<Zf~0kg+i|&HPQe;1Df<$j8hA
zX#RTv?B*)xJHJx=YuY=I;g86=!TfzF8ST8GKK+(bAK=ws>%m8sL($f6ve6N0OQ)Vn
z*2iOlU)Al}PnLgo1G3NPA;xAG^vPzQR68}E`rgtC;%Ek%z1B)Os5DVo>d(6?SF4qC
z96?ILcp#Cwx5FaSiUcxmad?v;vpZAo)3Ca$!6GsCI{LRZX$$3V>Q81&4*I@n2$8?k
zKkdC~xX`ZU=l0eQMS}2kLKk?^0bhIu>8Sz&)CvBPI(WlTOcM(!X@<KdanudP5W(yj
z34dD3hHn7L=<B-=-CTHX=Ygi!KW?^ga((%gmG*0C1>{CTnGkm8f2;pTDd*X_86ne7
zliaLQc(i$e5e4ZLUKBkJesf89G_XB+bHba1u{f{o(i^??;4vE-Kp)_)Jaw~Q5p{h3
zI?6N;4cG#RFC+s)dt`&SQENOJ-d#C(q^twCdO0PgsWz|(<&%Y(i;L7<m~bYQ=!yH^
zj$huI3l|$ra*MSGXYI%NTmLBYz#3{ma4)ZS$J&~=G%|Qk9POM7F)j5Ul8@Q^y&hGb
z%veoEV(M$h(F{0uiXgSXeih^HT4NY7$+pHNdJ_O>px%Q+6+3uwEIMJ)a~qnYar2mH
z!Dts`nV|tlX4>~gZko<gWR_FT7-;W;CZ)LS&1D2)q`&t8H0b{w?vx7_3@;ZVMZtB1
z%$`vD1hoG!{vB!(x8kXj;{%v7-8}QKG&o}lsMsl<)x8;|bGU14;8WN_dY*~&pGIXK
z_V)d@HPQ)2r5v!FtJcXdRZh<2H`gwri5OinOi4@0?_Jsc<t=rMUi>RQotsaZ5t4YT
zHSJ^7g!2UrI90kR4W7xxC@+f{$&^(=qBa8h@n=|z0M%d9VQ2a?vrI*zm4kYHN!rL@
zmtprv;{|UC4xL;I;i1`j5Ub<RV7|X-6QLLPe5Y|hB!6T3zJ2VBL8peoU!9gurbbvI
zt17M|k4ht<q99Ni72}Se#E99MmIG#p?OJn&0@^}dOD<H+x-|n-|MCKOv)R<n4PTkM
zUB!<1cH@QU)2HK!#|L1|obDdECZ4;`5TuEm!yxhK!hzZOacT1sGr4ou5sL~EZ$?u7
zY5IG2dm$u!qL2jOw<u-ql4po6j8PeN1u3eC10X|hH3BGL05KWP(4jmuPKRleqeC?z
z-8l@Ws#&57d`S68IVwZs`}fvcFzeQDeH`lOAtf(F-@yy6XH}e@5RKRX{TV*k1F+i>
zpJPh#$XsFdR;gvOJ_uwF3<h`B3Mz7_7LLZwm2{{B$s+{j5N#I2um*1tIn=0Kosrtm
zLN?R^ZFUNO!+~FB^$Y_mIQ`s~&;LS@m*aSMk!+0AGjKMUUF3lVjqy*dq*vIqquEtl
z>LpR{L;i6-F|8aRZGF=k{*e#p{Ix~spOsaJd;W-~g#C@Y$zLo;2;oh;lq@VrXc?!i
zuNibU(9*j9tjZHd;kN+K);@93eBGxEx0ZbQ7<5pbKNW>TL_fB1921xXhP`p>p8!9g
z3E6C$iAl5nc-G^`!&4V+E^oG#@f*P)HrH(BwNXK&O3*t!fA7r}4^=9XQ_nHvKqnW2
z6)9Qk4RmIWIYo^F=yI-<nTCvvkryrrBG``?n(kVcMs5vEm*JFzj{pHMXAB`kXpW8_
zSpP3%-`md_q5B%9{Q5ec39s7cJr^xWLC##He{%Qu!0OlttvqwHRmjdqsg{CckwfXY
zi;IYmbhHM^BGeg@g0ptWQ`|L2$;`-aealq<r=?8i1ZrIcDB3N>=Cdiq`9d_AXiM|P
zVF7Z)%&RfH(dg>V7YqH9+~bc>V<V3g^{)+OMAE4pR<-i7A5T1I8Xb_zywJTM#^~;n
zlZ`s66m&*zUHEI$38;lec#M!p!HUsROJM|H)}iKK|G()J`b#wU&!E`<JIM|G+Pimi
zk&L%f_I=E<MnbcsSDHbWZ3l;*oZ&x=CbigJnH)4MmUQe1segmW&={~?%nK5=q_&Pp
z@Mtw$M?-UlHQ@816Dr_)DXZU#4(CR+=_YhpE!caLf8DX*@5Wv&qR7T5R7HAMojorL
zfs^V`)Ex4or_o1$HtX$nDC#WM{7N#WB%>x^>rsg#D<G^ITRy1RQjzJ{#jH$7mOk*O
zy#1<#5*zubpeP2cay~bRuE%WuVPv79C5%P;?ZBWkdJ3vZP#a0*)D2J<Jk$c~3^$lC
zEkrWomNeJ|Zc$UZ^5Z5pA|!U4Lj;Ogh;9|VChzI3p+~QKku?|Kj#AkwhxNYd2(!lM
zDyQN}J`Co()PoW*w^ez<B@MqrtXFveW6jTRaK^)clBiLRs&Pye9JJIA-Z3e%&;mR}
zcE|mS`!~k7$@}VG1PUkr{&BK)!unsDKsam=y3tQV4j}R+*sA)LqljJueg{xUols)7
zGOT;OsGdHVL-qmETL^99f*IA#(xPBB{-ETrM8XQPfX;%2WP^dBE-QFXhjKV5)%JEk
zc~c@wdXZ`BP!64Vbhc`a^lUiu54a*}L5>7(gy3Fq?BP3YA2@#Sd2}2ryyry=COj$T
z>Ylh!su#hi^?5GF58<C42o(uBT&{qBy!!&pT@Hu-=L-M;KS;byTMNhVOTuN4{$^y)
zxT76j{{~W2ZwJ+@(MnggAm{iG@Y#|yao93R<bh`+@7r2w|M1{e$3p)XfNW5JFgj!n
zhItww-M0$K6ZQvyXJ6<6^D~yP4y>PO@PqRqbMRAK{0OHp*;4HM8WqXI%h=1=Q#MbW
zu>AGh1qW~GP2@VQb;x_;!)1GewB$cMd9d;Lf?L1ujkz&#w$Yu9CW2gl?v0tULgtUl
zy3;~FU;ph_m4J<6g6-}(9!(+T*7H(BK03DbNu)|e)+*u*8~2xoPY+%%A7MQi+*Y>n
zW@KdK#EBE<^YJACKOKO~zt_qt31ee?Wwp3?6|7VH3=HZ%){Yt6EzTBELmR(XNnM6r
zp~9nsi90KWSvf*0R{W8Xkr5Ds&Y%Y;th01s0$Q+i=~}hn+AjC1XW96FVBCL&W!KXj
zmytFum<jfHw8dim`t_%<q^?~zet2-f{P{6(KW8S4;5-N5@iaQdiXi4=(24mA7v82j
zgZ^Cs{p!#Zp>Lw=*6oLtaQgJ=S~!J;1pO)Rg!fI!Sa<wG4BAjcrKR`cKIx!%SZWlJ
zx1II;Q`;cf2&LxkOPjI%^&F2MfAsZ#;6q2s?<MEYo!jS9p5lw<&+z2rgAa?3E2H&&
zMQT>+tl_)TM|LP)Tc_1raA4{jzPG4wyvua7)=AU`jnIJYy$bt2C^E9^5df@hpB?_w
zi2~O#%yF31QNO6@XjooF;osYdcF6!#xtkxod~E(LqbV*bYV(CT{FUfUg;h(X|4YRm
zfZxdp+VMF1=nhI;24BB^<*U8Y+5W)|g#tRL@)iO~97N}D?^9zz<7I%!++zK3PT?0k
z%UK*X8IKkLQAtTH)Q76DNfpOG2H?h$;hV6)|Mc+f)y=aIEN@-C%B={`WpPo_iD74)
zC_p3s<jKaqhoz;Z2RW9YIXM+I$qnrX-BI=l+u)eg(9rM}4}mW2JL&1^8dbN85q1UD
zPM<!lzHM9FevdF?%WM;aeTfcAPTe=e46?rTz{KY?3+n!;W?Ox3?(!Fxj=-M$Sff=V
zT((Ss8okcfS|vZ!J9OyA@)vAhU;BeqPzDcIHh1Dgon0LtahlQ9E+Jvz4aXbNOi5gL
zrrP;@BMF>|vOl(5Hymy@^xSi4j4WBW&{Qw|#M5m%cgh%U*VIgYD0Z~!D>xaSA&(}%
z-|+}Vmr7T+=Hg&0<vxr}S#M})s78s*ksbQ_{$V(#$O<CvljA%%%Hf3k)>)02eF!d#
zQRGi3k*8u!T2;xOGKmmg+=`2|Ebxh>t*x!zKz7SR9A*4F>N|}OUS7KNTjT%L-nG9&
zoxg9jZEXj;Z6}5FZI{ZR<%2{?M;f9U#u$cHQ>>A5<PiFF*v=F=TdQ&$#%vgj<60Xz
zm-A_iT?{#ElEmn9zwPJyM|`jA>xZtoE*bCl>-Bn``?;U{xnB_ci007Z@$S40v+IJA
zAgoL!s)wGS1n42R!D~d)FqiKp{NP&}vQ0DPP4^XVHKT{JRA*ZdgPsAljKBsgSCN`9
zj5#VTu2E+P8|^(;+Vk8?N@{9XCLvNV)9uZQjf$d8N)tW|DJTrIE%RC4eZMbzSy?%P
zM_cpt*KOGLGtYNO(vEoBm0qQzt)#9)V%Nhcdb5m7>VpRlR`Ld&W0|LtYy4!kZ|6Yx
zSfDl^CtNVZc9~7<4GY@<$I=&Fq~R_wg@-?5v`(MhyxA?m1cDfI1|uH#O6Zf$Q7F&Q
zKx84a?5)MyJB$ViF%<>I>aXkuG*3pL`85-wnV5xnztw8=>_1&T6P?U7FwuoUlEUun
z1Qz=PidD|Qzy(}n^t^3Wx+2Z%+;*BER9-jRY$)%~4*z4_aMRPE`4kn};Njg)5Tft>
zo40LC2Nw|6I2us<38%2WpZGXz5R$U;V}Wawz?J6Yl%AcF6A>2n3}eBq{6!F5do(o8
z?u#?U<WMs-0fh6i{|xV*{Z?6B&!m`u{Rk5nv_T|!Jmyn`)cGE5W|c#S?BLgCjrqHh
zZlL6U>6FeRA=b6y28}Z==Ebq0_(`!B*REN^E@^LxbJL!QHjZFUq0gO>n0PpBU~-ZR
zrGpJF8xgJiH=Ry5HZ$ATNY8iu#b>g2JZ}Qog@q9^G~!Aq6pDqFl@+G}RvOV4(Z#jo
zE*=O95yhH>plh{^FcKj&*zZvfvWtruK1H^86dkwT7QBa6o->UcAs)g=%!f2Y&RLR@
z(g{SwPiSaS8H`IIa~Q^{yZV~=cH}HAzjqhts#_$O?mBB{mjIGuqPHXiOHV6mKy%Hb
zO9UqkUhwB2G6hsD59oSOBw`~-;X|Rq*K_Z?788<~mUa>tBGdAAD=Wf&D{3#1^Xk>B
zd5fLwn66}vE^a;e_uPP4R~UmjVT+LV?0F<`)tScyGjjRfExC@33gQB+y|-SzQe~T5
zSDuxsKhm}$)z#2i*n%Pa+-Q-FD%y0`M~_jow*G97>xrrl1_R;oB0ao|e6hZMiwLcw
zJ*D;qW^aD;pJ9nh@R+hXu03fqIql@s)VLWOkhX##i9ctML?RJGj+RAg1v~Rw(T3^F
ztfKm_s8DAo%j_YMJgu`{m}_ZOM$7&@Kl=FbWBa`R$;rvfi(TVBOx&B`(0S+1R}~I9
zfvNHR2g5E9dWcF8YtEb;INVw5-5MJk^AB!_j5SFp@EQvFcE=94JQ{;BmK)D3JI`c3
zgtp$gHV71hkWXC%YUD+#si|orzSFbvrrl53H(~wY75Mt?(2LGXhTxUxivS=(WoCYN
z{Va%u$=s|IR+)&0q2V;`TjW4!?W!`1a&uc;<|5_0BQF)DptO%3ESnR_<qt0V-$1b!
z@gTMe5|0e=+~VS*Xc~In*LwoPNVF4s83kv+pj=O?iSWe$8r9d=_jyYh7Fz6!iC6dn
z+j0hxp5J3&d7p7y>9h38++9@~R(#K7esiEHoO1jjTx@||8@UM?1sQcPZxMhmCS$qt
znsw`15bx@S0F={B+B2p_e7M;p5rgO=F}O+p%e_e7X{Z-d+hz&UlBIH5M%5}2>BPEr
z<*HS1^Pr2w=&T2()*=1Z_Y((KORL4HOm&M1FIVoNhkjh41kCsdlDUi3?$0|a)GvRW
zvL{ncp1gDY#*I;ikyi*uhbMS$^o_V9d=d)9;?>JAE7TXpl*)vntzl@@%9XKvcRXYU
zklk?vXz7t~fonVT%&CMhBaDC>7cX4cFWuI9oB5*y$c??V=r*1;z)eGP92d9tO-$>!
zGTdM$nnt*{jg<cCtJh!&>V~k*z37J!M{opv=qWHC6-~nm%{J2eW%m%})Tsx4V`SOL
z*RRiDCZYN5Jl^97a^hT%po5yM{fM}lD{x3c#EUTCuZe5{39=pa8^g%{uC+zYPsVLj
zBMrB^RkbXinVU}LSGC!6MJ8cmia#RFxz>Im)n~fgx)8bc_afbu>xhOVR}XY#AOSfL
zn-O~=U!H#hN?z;2tM$ap6=8;P^ytxpYyv@jZ}>o6oC#P$9c|}Ey=?L=vyqXJiJPNr
z+^_*FIPf7Jm$Ma0lNNt)s?*?@lF7tSydoLqpq_kIb`6kWeLr}ULe*{<j3D6gRh!{e
zA}%;&;CfQcAZlI3YuG~ayoStha8B<&onQfTLtcFmVy)lR4`cLvZ-38md0LYYIB##Q
zUX~q4R!o8xi-=H)$_56)g>O^YjUj<o7EVzO_WNd+N2-_#f{=^&d>Yezq10!cl|Ngz
zsx7W7i+)H)r`-j><G%~vgbrL?KU+FxgakwckGeN1+~Q|wQkY=vjZICdEEb#YfH6+O
zEOW!gjkaxrzH9w_eG3S?2}9`#<A?*@w6|@XIHMs5wzOG0ifx%8PA)K+xTtWTS8v>y
zdT(X5<ep7cA4hZIx@p2s)%+*n;m?tSiAfiQU(G3$zw;jKZf}@wym0v1=x5J@!Ujae
z)`Wm21EU$~Ivv_PLXP)DxC*2L+M%Q22~Yp~Am@$^K@C^`a1;LgJ(>MWzmjhKmEpT^
zBY{cuQ6wfk&w)GmEw|%5G%(&oM@FWg_h>;hhw?~SDK~Gf(9}O16jX|N{r`!px10>(
z_d87$ytq+Un)sr!W&3F^hk3ZlLpwSDrv^TlB*M<IRk>jFp|!t!Tw!3<)wYM_8YkaY
zv#ATgA?4GbdO6Fb4x7v^N={>T&v)$IU~QrA^s~8Q$c3b{G}YD5Oixe41SvMpRlo*@
zxai;z%ij!K!v+-EuV03-0BAy+VZ)$I?kWu|f`Fqt?TB4f#0A_;_F-85Ty^I#IdKLF
z&6}O`lxZzjrQyyvF=5=wc~9x*KFH)Ez(T=Q=-OMXobGvI3g__~fCDn%6xb~s;VAp9
z|5|qpdr#Vxo4((!3~HF3v7FRU_WP}+T|u_GqMc<(6FGU~qw+N8E9lLC8Gr{8e7gjz
zs4nMsk%0{|+Eer=KF%Wz7%k1$*D;=8R@leS3=s8@<h?lzP>xdu8$J*mVcznLoe1Nd
zQAA+N{kIj>>_@kO=zcNyEN`1djK52>xQCe5;jJuf+HyxnN191zUmfnma#E<Os%lR!
zNok^ZIl)sXjO5mA5VTN$H<Iz{)kzc-bk#^!#xEJm%X?q3cx?2)!jb^n425-#f^QVC
z@tIzA0fFe+ZW+5f>9Ow4707r7_3$wI>xqZq8J|Agj%HN-5ZcSEC-F%QH*emIK9D9X
z@TeHC$p^$A@8O#x)Q2l3r=+k@5j@;7uwBPBKB-3PHLNliktIIkv1qKzCJR#516eCz
zuyAN^t)+#<FbXl3CqAQkDcYvd>g5M}voGGS%?1`BToit#B~MSStk;hMrr^iUff)CS
z>%NSZI^ILN<Zqd>M;3k(?2fL!Px56|2djBq9pgGm_g_APP2@>->Diq<2mIb8`N?nG
z*nC|dmEy!dl_Gu`9JJC<$;WVE6G#SB;nD(8GIsrDf1^9X4I7{h!9|I>Qn|+^@q4N$
z?v$x%D*~M&84iO@fT40quMXfACb2I-B9KTLFTUQP8Npkw$Id+4nj@MJ1LQ|EB<R~X
z>sF|1x%D1IXy9jZm8)9b{17~6BL0YWuZ53KUUN3yD8<YyB&nuVBwZ~d=!gy23oxab
z@9f}^QtR;vEW!JE;pftFmwm~w>x`*Fp*p>X`x`zFoDuYQd~4xkOL}-xO=3b3wb=Ac
zkhv^Iiv6ylG;wef($MFji99Y}zP$Fs3aM*_-(z&~_t|&=T6_Dam@0pYe4;`k8G{hj
z7Jh?V3!cZmckekGLPsl+!KS9%K|whqHna0KN}&A91(1{Utujy-4`cf_E4XQGUcWvO
zS#=oF!!X71&Kx6Du5MGD7W4=xmo8-{)ztTZ>|sNJ+QOK=GCN_rUDxyY-Ma)^Ph&G)
z>_^cq_B((6SyOX!y|cyHvrj)mkqYv;3C>1>w)PgL^&nPWQ~WV9B0^bD&l=9k`<k^o
z#(fC49mJ+~v^jQ*3E@s-#=a8g2|moy9T$hsA^_o@ol(qhiF~^+?XyMYf|F+nDur04
z`ynB1#8?+OA}};Gv>kQ;Nx+{LwKBHW)@<CYI*jI+#qr}e5$pOcw-N)tthRiIdf6xy
zzqn_T6pM&L!!R`cTE@obzpGHsy)tP>j_4nEZ9O0*)ms^`I0z~@mVq1%<FmTkU_lln
zlGZ#I8wA<6xO|AiUqfN{#4D?)m=F?%8{MVeqmj^2BzAOI;kY8^R5v!Be){yO?0)w|
z{$oo73!@{3M!;P}q%#av009C`nXLT4j96@rgu~zP4*WRY8i8Bj#Jy?j)-;@gJ(`;4
z<>lq5wOvcPSzkj<qU}{K8XSZN-w~1gSD-k+r|<|^efzdE&c8xy=MyH08d8o}cS&?u
zO+}@dnAE@Z^Utwfv*7tMeYzLm4^!8dlK<0P{`(pgZgds!#E76MU$=MJvSqlbDhE^W
z-;qDz2Gowe53yY+=<6PCR&oMa0Y<>w-TgP+Nq~eFj*U(|&IjPNJ6(vT6H}ovR=ZaI
zK6|nfmzwD~&6}o=7=26b;(IyXpQ(sq6#KqenE%7$rM{F@>2)bg1qr`L{eWX7s)zw-
zL1&K)i0I_*PB;=GFPP6x2n3OEZ2+jhy=mJv`j8KnfCu5C1k&ON#c@Fq4WnUBXCCDP
zDCr?u#`Grcv&^8PCKa>exxCeD*LoFgIDo@JpbH2_8Evf$yqgJ!U{T#RB}K&oHMkp6
z;K2KW>~*4@=GB<|@uM&2Tv@LR|H+e0C75F%^2V1dRzLz^3UWBbC?f~_Lnc~I9dG4L
zu~g^J|9!=d`^hykMwI-b+szoq%Mx%ssb--DgzsNHM48pkj_<@B#v7Jn4E<{8m#bEd
zf@y4r-+`86gFFVJgUt~}JiWYN458@t((%~Gxw*Hy4d(8mNI+|UX9?!12~@cJi!TT^
z24~I*b`He*!GGf`(*lv2oIz86g7|C~8IH$`$>1rokK~i9{`_;#?%hT}Z|!~MH#W=5
zt7f#a@h({~na6pKRq!8v>fbJm$3;Vlc!N$z86a&Qm6eqpJ$6jnp>C^7Z!sN9Lb$T_
zv^B>wNo3&9GYD&oxQ)sgVz_&E?>@%2qsV`bgX#>Yb97mnQ7o2_w2zr0>?c4+aM97x
z8Iz{iJDS{1tR?UK%Qd!TLAKS^)ppy~a~}eNV!A2qk3WvObY`Exkm3XUa-`tkU>qZ*
zUAtIlq7fBl!><Nh2)T77m$uwLff|U02`>nqQ*m)rzE`S7w;PL^F$ISK@2S4>EpKo9
zK!=@$VmbsjBT(em`oQ7Se@b&*#ZPa|mYO}Xw-G`yeRz3hgbHsM^DbPY0|zQ+;NlqF
zY=gOhja-vyu#&rruiX7di`t;N<vyRJjY=Aog7aSreq8jPjl<vq6C}OkQ1PvRFQg7j
zma?tXwa*$r1C|Iricat)RqK(Pv^aAn5jGR&D1+MXM4Pbt3;q!PNc<*K29-kLITZcj
z7JOqKs-9Z`1A%NyUBqu&7`a^fs~3i9!7G;fQGLN@u)B!$x_56)2?%dB!FDb<PC`gy
z5(dxax)EEcYp0pvOVg0V4?nwbYRNzde?N4OICM*2ANLTOap|k?IgwJAzOIFS_s?8B
v{`LRg{D1Rp=naonV)<5*j~}u4WUxB%vC$2A57@>?Ns&*O9nU)Y<Msalu~9f#

literal 32898
zcmeFacT`mQ)-76gw{5GfHYi{M6hR4sq8O2&T_`~X6O!o$BPfU<Ai1?wGAbg1q!yGY
zh=>S9Fc1_3M2V7=s6+wDq3&GU?(>~{-}}ZL@1O6z`|f3obI`J?_TIm+)?9PW^=l8U
zy}RbjT0D!zV$D%gW$$OPrrWbv-<$mOBVMV!`PUcx`q4yV7aPCvGx{sX6~AVlQPs6(
zu>`Ns|EBr1_8n!hma){>+Yj1@bk#fF2soFe^riIY*Dnok<Vo*%^W^*=xwC(8zawIH
zGe|H`L;d<Ood|o0a#iWnN4wK)c3(5`xO?X7Eqm7Tz6+n0FOyA|5LdnM@(^43$gP?j
zrLlCsm&*drZ*&xD8`O)huu}>wbt(OzS9$xmbNGebEB$9OH?}`|ZR0fNPu23XjOY(;
zH}-$|j{XpJ<AMPFUUqjuCjDkf-2E_}eyd7MUqio@)g|ni&+b=$Hk)3!y8r)t#s5FX
zqS~_FX`pzYfq_AfYxc`c*?m4|d$&w}eK)+Xzc6$L%dIfdA^Ur*fW#X&Z|+o6dnMGE
zcDnZQ+1}dQx@s|}&a+rC+qV5r*F@%#IV_f9d(iQ)S9U+JSk=<BdiIO?zsfCIle5%M
zaqPtIkj=8%2|7G`Zg2DnQ*g{b8feIGJpR7wPDI2q%TaX=4byz@MSWc<rTJe!zcc;#
z{8F+>o~O99w2#AJhe~t4PvoI^?Xt(GYd3eqL^geSG0#u?zMe{!!(ji-(UiAg!mNn6
zeOT*P7x(6HUA}hJtZys6omSr`rg1aZoo9s!{;w>{aoB$Bb9D35@8{KZ_KxOn%I5K3
zrP=Ut<khP1rT#1Ty#MTsd+>0X9Lt*_?4;E*Dy{!GH||ipNlC~S`4Gpc(e}t)enO6+
zqXUXlBh8;0vK%v~#yVTWxSus$7w1g0u1S;E4(k7&^}vxfS=95}mf4F6mRj#V)sQ(l
zJIV3$-N2@pNMFx%>-L^OI}EY3y1KgUW}}8=&3dZ>!M>F6$x}%=>(zu^C#-C`-)}H-
z>`pyf+IYS_)T-HMlZ9Qvy4D%2--ge>TFhbvG+dsu<j#TUy`0r{N~x!69@5<;7^JT&
zcs14Sv#B9QuJu!au<O$LjB~Xo)8(B;z6ci97v2zNxhX_q<43&Z^kj6Jytq8a(WW$H
zi?vC4%)a!QU$^{v`DcmY5x&C)JQ_Dwd)(Jg+o`LodkS}2nP|9#JJGJxJe<RIw&|*t
zEnBMp_>@OaJ*S|nCZ$M$iwP<4bNL#new(flP1o43pY3#h+t)Y0$}70`q_^i^7t^@&
z=#d<zkl!+U^jL^PN9_38-*ew-DrLP$zPIOg{`d2?{emI)zH{e}xVX5xSw&plvl+rm
z1-II`$0ue;8aWSE*!N})H}!COeZQZ(Ibz2mMQJ;3pP%au$En!pFi#Dc^r*LO7^B|m
zivlb+_0wI|$?^(zn70B`KL!5j)2G*%o__zx<CXuaT}eh+CWSX7wv-0GI$|=~-zvW}
z>2OkmZMyBflke_Xy_mD<p!kbb;ZD5u96LYVlw$#oE_k<9p+xiz$Ha9lbdB?fsBY@r
zf6Nf7{+#~TuUBsB@8IX>&z~G_3@_5r#l^7WGGFv<YIItUx#C~4$>R0rVb}gwtE`$l
zR^8O^p*Lft+v)Y}Y*A8TvG~4C%$QBlrT#~jjf#smS!BL*)K9YzoU>T&<)KI2Hl3CC
z>zcp+@n`ppbDjBzv-<;{v|QI{YH;lJ!4nnqw-!YvBqTg<<Y3=y{v73Rg8d{PA|)f^
zTa$8pS9?jQ)M*zMOR|I?JN2L*zO43hx{!iHSO1j1rs5VM*NMI#<_Gll7p?JY4|jEm
zZWmZ%wA4#rjqfg@^P-LkPo8WZ`}%pl(!|Gk&9_W_YvOyIu__A{j5xO4w-g+0A6e8p
zq_wq3(UY{##O9a0zvjJA#QA|XPNu6}qT2J(_VAqAqaD$YE$SDq*y-(#DcQJpOY4p5
zM<)-MoWG|Tp1te5q(1J@Hk?Lwva%;rboI=N_``mS)*tJ#iN9!g9y8gj-#DgyWL*%u
z|L4VW;)oh{<70(4vF7TTHTO2|Ky=C8(yZYIM@}ZU-mY=ax)Omn;~baWw>L^3D+yV2
z*uY8!i`~?(Cw$#e_18h`S6y4(T;S(7Tjt4cenYSB?;f4Ts&=N}C3*kiJVpEH_Atku
zbi)R2lh>M+i;kx)wX3u0`*3kyKEg{g=GqU-CGX|670tosi5|Ay@0~wpaR-#RDZ3ia
z<?`&x#lAk=la8IZ4TG0bpjpvVG=b3%Vb)GOB3l{a%h}Q_#F6A<#lfKs9Q(c|om8_!
ziFdm9Z{NOM&Z2HJW}Dx6e8|VKH)|9BYMo!=weNerm@A)9=SUGkVazw*XGwwAn(T!X
zQidm1_-*4=8hJKv$gJ~E=W7@l&jW~yTCs-bTLZ8gu(WSDZu5V|=1xso^TqC1yz$gR
zCGKcxkwV(hqMHg~hw=3z<BeRQ;@}NZ!xO*GQ&@1=*!i5vc=O6o`Z5Z#TCsyY^^Vc)
zJAD@O1sXY=%*1eCdv!zv(f;jSjph*R5|5elS9Ya%|9WMvPtIhw<-Yy<AL>`-3|8v5
z3R%9pS8U|W#lBg{9Vt+{gK*m#CcN>K4kq+O^l-a8R*<765{~lS%FOcvPrkm@uyb(v
z`l+leK{rKw^=j|u&!3;Dd3e+tJ4$$^x6Xs#wtwxYkTR=E6g+Hn{wSrHslg=IJVca-
znkC291?gltoZI&0>GxLS-D!dH?T_B=t?m5TXUQhtDkI0!(Q9^b#(Ox;mHL+VAJN>)
zR}2UO{@5OUd3AYT?tIN$e2?vT7@}5wUxBc&-?o0$x&Eh<qM}5FoW4A>|MG0c@JPeT
zJ;ChKFa@cvlhS&R+z~JG4(E(jAbHh)oH(6U&%eRE(mQ<WYjkTvcrWI^Yl|k0;^&Ga
zV<jwnp}f32&N=7Eojy&ifyND=vmXWQv9hwt>@SqscV91cR_WIMmn)j@1{%HpJi7hj
zk9iM%e<3-c5FT&@n`OwGmeN5=iY9$cd6Xd6WF}(VWi1;rPrQkErl_thdpz`<_G-fn
zxw#5o-{c;%{rt9d_V6;HwZAEQFWs{4T5q8Wv+JahS5$ql3iB>ZpWT!vVC=n1*jaAn
z?pwb|X(zZ-fIb-=$}eE-WEJAn|7xGk6U%VZg^Eu0bwC$=`AaNwmsn=<Shv0Q$nz2?
zz&bD;?5Ie__MjY&t+ZJWp=_7nxr3CP_ip_hb)xQx)!ucX=i7p09lm~|SXQXuI@%hz
z3(ws2eD<1z8#EsZ(}Oe{g9(wcl;f)JFc|g!pxFP-5k2;(TVZc%m62Cj<gQ)7D3^{S
zu}d@nD=pk|_K2Ki!?r(cXvsJp?{9e}Yt@wNRG?}A5ZV0RJjti2smW>A@516Qkw=`a
zM4atJlJ^#r-&htz*<strhl?I1z_6_9`G|pDh;3^cWzU*C|8u5QThQ?~`5(vKR@v9w
z<@9FDQ)s?>_by-9U{%i4hI@NM7XvfxUA71xe%er*dET1M{@Pu;$*er)TD#mUdwiTW
zX-&A#WcY<ZL$k6wDnBn=yX=}ScdRPMq@z4`Usi_eSA5v5@FV59^85Om8fAH9kC%k#
zWZGM0n?9Jwpuhi3%eA<6c~(GUVSrRK$_$T(4<F7d4c=sF#Ac&#(YEKuxUmkNn`LDC
zxg$QwSJpINbgOkwUAjjJiW`<&oa(b88ACwGebIYE*<l%>vZgy<hbt-RrJ4mOucOb#
zykC&nwLehC@Qy~HjK}N6o6r14Z$M%ReYuT!Lm^Y;{FhhJSnUyUH5up36ZF$$uuA5i
z>nN8P4(5~6&TaNn5?X(}#QW{rx0}a4MK&Y3c}4muItWKI)xG5U>Ai{%E$TBqRV5kI
z5_e26uS)C-%$X3=dvxNO!ccAF)JBUZA1`<JOcohW@$&G5ZawFz=D$*9a%^yT&k1_!
zi2W%lFBBgDtDHdQwr#aw=Sn4I@)D44EehPl&V4aYDf8F#aozRDUb|D8MAo?R4h0Za
z=~i+3;Xf>0$7_=Tjk?;gU5<r6M@?dGU{j`&3~cyhqQ5Ams?O%!p1!vlYw`w4m4pFs
zUkVwgnpN0_Q?Pf7(|C5<bT<EL_dsKpE#v1WM*8|bUJ=emh4u?w5yir-t>?@bG^nmF
zBGOcG*w{zD=gEq_n?L^f3E|=AMe9VdGlN5Au?>L*1{JxwbaQTnD)?eeg~5Zi&I84p
z3b2C*sqAof$Dk?_Waqgy*}KHz$?~nXT~A(wpw_V*{<F7nYADShpO_)mer0??sp9x4
zTW8dEJ!hs+yf*X<phTJsEy?JJi+|YJ*Icmb>RfuW>iX%HzQwmUt>GxPT>aH{b7RcD
z$Zo~76J;jRDeoVh^fxRGmEZI&XekFv*jt~%Fx3oBo3Zr4i&0cUr-#!s%@t7s-|uoj
zZ9FrI7B%bbZrlOVY*FI+pxx<J3;6hsR)zPJ>W5vpa6x?a#ISHp<$eA6>OawYqXI5$
zD$sj;D#(zE5We7mS4Zw7B&-$@nG0|<tC*pQ-X?(x=<4-V9Q$-@gSj@F4al_;do26K
z27>HZWrih^5)!WxbNU04L<M;1dsW5oVCO!+6%%s!^q0H4J;t&~+I}2xS3gB@;>(M!
z44{!$KTtqr?Jwe=v!ycjKy=sGB>|(DHwh|U{70)+g`C-O=@^sQKex|pSZZGT`1Dfe
zuVp+uvUWXnvx<Yaoj+?^kI4GZU25W~Ra8`D9f!Ku$5PF!WG>GW7UJOnZcsn6lCE>r
zXja35^bZ$i_xESv%e=N&x3QTlfwxHh!SHy>e_jZzKhqj;IA0hrlzqGeTfGcq2aBb}
zCxP&8l;x1unUoXua(-sfO=&NTJdqIdRhgMTbQ|Hj18L)HPrdv#-S212^#+Js0|0yV
zpHQ(NQ)0dI*jMBj9-gwh8iCuQnFs7wdv<%>sxW(#8#ivS*+;xkXkd$(NxrtDKLF49
z0?*;+KOoN0c@0bTlTB3a3=|d?@`A9zPgEeyC3dj01V9@$+VxXq^c$>Q*oXQn?^DeM
zE?wg5EN?Fj57%Pev8;PR<`z`(oLlRU?`5+y$2#Kor5r1sRgC)ZaVxW!e&Kn1;w4pt
zN2+?W$1SEVFyA;XNYmR>w}oQ_q%GwC?ZqW{F%?BBCk)HvzkBgi%{opPHsrrPzDBnw
z8Nnm3I@xrE$Q_44Pi{uqsha&CDM_-PPHlh2nHOT$aNeU>a`o3Y8|cL^mhX4a@Bd=<
z@=&QA>+SDYE*`HXq@*;C(6+tm9W|xodUU^z&caKV!px)0w7xvlNUOKiud}T^jgp7=
z_GpQGujodiOsnN5$A|qszPQpZzq6^MB3__WVc1})V^{L1?{{0GKO7D8^zw>~iJ_uZ
zYFj+E-nt;~92E?`oBD4+DLg#;w6uN!Z*YFEzc-Rw^@HDkotW%(J^W?Am^c<B(6y{Z
zW?w%0*qo)C*MbAd-i$!P8$=7@U>%~#9mLa7-)ru)5>XNc_AY!-YVXbL(f?RY{~OZ2
zabdlzgD#-%d_j6iVG~JiGjA;n;NhWVIja<b&&|`J<=U>ML{5(<LY&hswSx%0&ETHA
zlUxSlF?}t!u-}6>p4NMf0A3b^9J<Fw2;<)6!?R*%Ze6<dfZ&Q%Qvh+2_J7TyB{JOT
z>S}=M++*T&o1tAj-#n#>Gmj9c{y2h9X~_odUMV8-<DA6{P_h?W2OpV0!Riwo<{&wq
zGHra*^fjD=Iy$$ib6Vyqj(lLZ;Umh|gXK>0qPTo%=glrh+1SYA=KNBl690s#`d>oX
z1AQqUBDM_SkWx35bx2Gq2&s2K1Yq%A?S*WDdlkF)p}t^U(C*h@5LWIDS*W?Kk4;Re
zeAZ*|7*@mu0>CW-E8?_(-{AujpGK5sH8_9z93AdURNqa|fcjOXU}xH12hFGbCU^S1
z+~v7~iyKEv?6%b~3I+R51^Z!--7Dt@8rtfHI1kmxOWT3fTH>>KgC~&2O-GkJPd+Qu
z1bNd141PI!^k}*_^SP)$FW3n``F!s-v7R-hdxGUWK=G_<D+yf!O5vZaM`Y^8Q`Pjj
zWUJ=<TL7AMc8$(uk50bp$}%nR^+9q_oTtRVEUg-GBy6yVeVxYKt>dF06MR6X<e@-W
z0`}}kd7`1?6={K4vu51^4zeO*2q;C6@``+K=6c5|;_#3odQuq3!-@$(u-<sK<z-g}
zs4J@?=`=R*(9nsUzyJPwoqe;9?3oWwyOOc=L~ruYh^wwbINoz>?Q+gkO{t6aU%Hzb
z>`l|HzriOY98>G|lH$bMawqryr8{TI#?^K*^eL?kfEmQ=ab%>W@4rbv%<0M?N++0k
zsHkw{n7!Nja=RQFGSBk`r~dZrLRW_4aL>R0dx_$BS67B*V|Mbn&dRLd1N-;$Vv42z
z?E+nQykrV3qSqo<f5JvV09)cHNA!Lf689~Da5fvTB~L8S;JUpw-PSTgthA?7iMSIg
z+%}K4_^%LYqFN6?a~n|@Pez)&BEfx^MXCA6V1VfJ0G=kmtbJ4Cy#?Nj);E>y681@J
za4_ctX(~<Hl*b*C5>{exn3e}&Qe?T@k-p|;Ahwe16Q^HY7bAA4w=4wY(!%w}c89o(
zeNK00WVI-7>BU3Wl3XV{DPAnxW`AaZfIx3q76A|tEIR3Dk4_Z0PVDmKWgyha=9yT?
z5f|rr8c#F{$l8DTp!4L+??gX>F%+=OnY7JBfKJBpK*-)HXI{CQc#-b+sb2H<ZeEVe
zomOynEseti?tw3D+xP9;xAc6=H7mrYHu*w}AY@kJvi50fYk$;DIbQ1P?hY#JzpH*Q
z1bziVj;qUp=xTQc=*uD`_aiF3xH8X=(0GkN?x9>@W7DQwkFsp%@gJ_!Qc<qBha?3I
z^9%96A}PmS-{P6SYOnY69lgU$3FW!}%e~j2tXF_NWV2By^@lKM=w&opC^GZY9WP>>
zJu?6FT4M`}duLUmVI(3Y!YAE9i>}D@UMg2Y<?VclOahB#f-tM*&8)T$vqdv_I!J7J
z>Nc$`V*AC-?IG4puH0c)g^F)_<O+`knO^+Tp3g4MAcp8+K^O#tPZ%&cvvTpvKQH2?
zsN57!*J6!udC$Mn!@HXVaz<1pAYAwXbmmhuw;!rGzCy$V18!Bkp(=MnmBD<X$EbeD
zu<c%a>5_-yHiMJ*b&^HO&WE`(&!-rm`s}u#c9uiP*+NDG$VGN<zP3xqgLZFag6@1C
z9^#Mz_6xSp5L^Jt-`c?8^W8E$qUef)TZt3Ae*L;r0dsFdzix5#e*F83%e0GW^}N0%
zyFw=O%k!@Ed5R;;5_6`;P9QLaSmiJ31L?f;<jIqXcbHFh1@byyNZWSl(j}{jzJdbd
zss2Fw4}Z*P%HfXZG}D8wHp<*AA_6jU0n{u{0$qDH)h_@F^}uT_TeXdlf)bzWAE2`K
zFFE>7<@c?bA0`tJE_a42Iya#P^SL7IvN?M=tM_Q>>FNi|DM?-YagHZy$h=UyhDD@@
zptx{eBx^-$mVh-oH$EwQF(}T2H<?XMCi;rZ&GKA(A-%Ye0s`F&_S>n$JuVF-2CfRV
z*-rw;&DFXOd%tT__7hTg*on}($#pw@(rvOtQNo_Y2fFUoa~-*hj)(AIyBCKcy6f)_
z+qOj!F@XXyaVw4%h)!jA03GOs+3rE}vA#+Y1y<`^EfA%zdpfo9`1D@V!bsbT^xY~6
z;Up=Sk}|XvA9r^U0D01Bb-WafiOeUG6ND@ir9teQetvtm4Dyb<J0(1Qi*&KWvet<R
zay5e}j{0vgbxn1nsNNS)&GwUnRn4B$U8bB7#~3ewRH8dQ0%f3qw&J3&UM$#c1FzRJ
zHSGPghQ&m)+m$T8vXmF)MUjgOYBPWDbWLb_>o`+g{zdc*EWQBb`pP6@VS0vI%Nzwt
zkoD<{H<;xPRv8Nu-B0L`qcCvw*SW6}s}gkm*{?HW4ksB=(JvwrcQ|Pz$q`S;7e+gs
z)g{a;VZUU9*#a>!v0A}S#O1oPMbc%6C*qQl@0){wLe<#u3jl31bC2=y_q-c!Vm=q3
zgH0R_9NRqBndAo=;4Ej=nPKhVv}5$Gte2_mSq)S@TV#B`_o*Vj%1GfpXFWFZUXv8&
z4MUr-iPz*zoaHrT{$Bn4MjK}PtH!d!K1gGL0iSoV*@)zkn&FC^bB*Cp9d%NU?P0Sg
zKJ8NS?5LPu&%2O5`&-UU)kst^N%^#ed3e$qUB)dM)6TXQK7q6e9^gr{uNPLW7!Ol1
zMX0MD@wyxx?y{Amh~c*z&xY=(z!BPHVZghOxtBO^+`NF1{c?^)MO=kNqur;!t{kf}
zDrZ8#gX0*mMiAXy2omo(&c>Lwl+MwC_EkL0{YMn4Mtv~Mahc@KSzR}IjikmwY@}Q4
z1@zr+k}IxVNJF@<8HA?zuy#1$#*HIYsM|F}$aKO|4!EZJtQG*E%K?-i$GH(w>BG(>
z=WcT~HZ$%q>u`BZ`R+$uW1DhDi*a+PEsj)y%uxTgZx|2lby~&2R<qfCYwhoW!`p`I
ztVydnretjY@zTG(DsGi*3tsg_AT3zqI$GrJzPU3Y#pF%Ib}KC3UD$PxIkt$*vNoUI
zJn4R1`>+7OIOD|IC^g=FFaJPNl?t<O@(`DjivN-jwEp-`b}qK1)HXzEH%~_L1rb%7
zwd%O578H$<9=n_+z#Omb7Py6|M}6>drwqC~SWbe{3lC2Yw3=p6FXss0Wsg-P5yqJq
z2<Li(T(Y!lOfC>w0x2cwy65(}Bs9p{c2)mdvECI*PeIa(Q^89Qpl&5hej+06%h=pm
z4d90C!OYwNM(8V0nv!*N0wN?^!P(yQu7^cUlqvC^D3hz-lLQtC46{#9Pw%7dfqT0>
z@M!rUn!*@zP|^%qIS-H3^O>vI*vA7QD;H5Ng3@!;b)(y)uE}&uHXE7^2`Uu9M_vd|
z{jy@0uQ%Kdr|tG2R5n9XbNSj?wFUtou%*g>1p&i4m+|hunZ}SU>*sF%;KpvlgkSYO
zpsBEdG!oF(xlgQ`O^{?peWyLpM3`~uAoIiWUoYogUH+@dyL)?Ta%AJN(*ZK&1&kTU
zqSe|Gg{Y1zNu6WX&)JCo+!=Im@6ZQB@C&Q;9*HBY@I%+H=^h^&>b~u@nHDE&{4RTT
z17uK{L?}}Bo%hp*I$XY)hMx9lobtNdIMKGrsv|bK=Uh6Ish@_awajd|G+Q8F)1}|P
zs~tctuheBIWpmGy<~!JtR4L?EF<<><5#j;pvfh-=l2G}A^4J5Bz@r}DxQs5gh`t=H
z6wXw$FgK=-*=W@>uoD11f(_G7zFX;Wjrp3c9SBQ-*<bH=WgwcXc{4HjHvzm8>|9ru
z10w6czqlrQq^ZjRMC!l4=m*Ylq+vK)fQJV}<9T>Cws<5n-|qAW0)xBz6(I-l5{2P9
zd+y{gDc~N+eWDwf;>GRkK}{3Y-i9nwum>c0eWSr5L3~-g**-%Bj57g$&W3i6Rbi?k
z3=UNexT^YWyv1LWEH`rtl%P7?0zl_AW+v=uyXa%02JkbkEu#6w<!jk4HE-shew!z{
z|BKL>r_=uR_kUBx0;(~ECU{<O6a9kBh{gPQcK;V*w=6i_k2km8IB*BpgGlfgNaeOw
zqzm#(>n*@?j$1dq4Qr+ub{KCGn}O!$BdgbZ3`SMFP}YR)G+Jcr8@$1MC!#|n-~}Mc
z@mx&Wz*S}#ViI_3E)E|6#_;iy$q-+u8J1aOZtODJN`M`h3wmE)v8BuUSK<LBy)MHX
z3e>in6_32Ux)53<n+?iyLxx?i5NO@%o?w(CG$6D9WYSx%FWg{u5Y^%cbEUY9T)pQ+
z$$<}jEM?bOm6Y?Yvs8&Y0YJVTnoDn^YmSTOuo9&BB5Au7B8k~!9Safazh#m4f7MN9
zf*CGA+P`kUlLmR2GZqUtRHuR4joyQuRiL#|iwePQVg!|U#=e6G5B4aK7lF`cZcdtc
z^`Yb-Z7LV1CdZE}fyNb~>J&l3i)=}3HqaDFJ$-L}ork{-_tcvrvLm=GhFsJ)RBKrP
z!%A={6&(c_^5O1z3`jn>75m{`v}P&)BSCpvZve_&*x+{O8&NL@87cwxsIg;h2>2rW
zdbzs~b=MX=zcf42l{?jkJ+is2G+dbQHJ+egOM8faR$F>|7;{I6staH^`TdF@KjASl
zU&s%?i*}(U<rXJ(?ZPl(T}k2<5UCY$hidPSgY^wF)I{0hf!RVh3NV}}thf!SKPBAD
z)6)d(6zEw9Q||5yx7wUIn3UaI`4XQjG8!LErx8`IxB<*!gv8U8fpWPvR7zaD`m-}&
z;_F0XFe9RO4sHeBC`nY}ay&+c=X1i(0o3-|R37i;cGVfwKCv>TqG??8tO{_VsEA2U
zgEc6_xA$NnGJ=(1<Wr<yzo6JYLc<i5AzaXcKf4l-0-*XT(Y!n+`S5xKv+L{|>c?Ri
zs5y6@8`(6FlY|)2jq4;C!k_frXWP<wt|Ko-ka9vkz19rZLB8+r)pQ*@U|^NU2R?0n
zd#D`)qZ(yd%LoQ^mdE-_pU}|ID5^J!*cR^8uV!0+N5zXC2sL3%<DQlNH6K0NN|j#e
zHEd`#<Zx<#6aC0(oV0Kn`FQ19ejzynoagbJ$$=kPZgLJ-XFx0(#$)?wi<N*8a>9mB
zri#1tN7i^e0+5Vh23e&9d3b1lf!{k`3Sj1RyAi-gp3{Rx#Jf*2bmQswxk^)ge(oc~
zz4x%sYeUJIl{RibcTx-b_fP+xI>OV(L#%d+r2IH{>B8Z9JL9FOBRpOs-dwjvASY|y
z&EAC`L=_uAF+=8IZ3)C|V#@~@Y64rN^)5j;uywA~Jub#`_bni@hOGjMb-@zNpmj$%
zr3gT^pA)crk5^${)R&Q?f_3#67B@V2C5cH{L+`7R*0|2k_J(~3RdRJ9YNf_}sOrM7
zeB<a|+xjHq90K@51GKt9FYxsBI$Nv|`SIt4T0K)4Qil`0VH-KB6b|Ah-ScPq_9(W<
zbW7~N=C<3GD2izZ$QCS}kC7H1eh->0k1SxYlD!lfukUpcK&sy(qJGz!3RUpnA|fV8
z>sICacID9)f!5$lQr6!lyFSdG43@qry{G#3D|u8sknBbn0V!cV(D>`@vd6e5!q84r
zI&??MVpm@ZWdfOkhS<iP80agMO3KATX>woT>rP1#gg{CaxgltmbQ@JxfTJ9Noh{^`
zw|ex02W!cCL16%q(A{0<;SseVC(uA9s27R4r+~=FXn2%`awp#GJ+3%ZZHh>BW1x$<
zeCthU7d$)^wFuUZ4flpCJO*ReorpOqv~BG<bl8v&21sALCdL=JzvInczpmDKu*_Fs
zs9Mms6d40*(IOrmeE9c?p|qU(&mmCG7b>|pG3?0SWE$H<^UF?#!okN)KRo?|LS7!6
zQNqHAoVHa&y-+!+0>4qDA;(tD#rbX}>VMLg5{z>cfgJ^A2-*LJC;073Cn3!z&}~fM
z_mPFfNanDmE+Zcit^G#YHsvg$`0=X)JzvB+^+z8j%m2C}v>2YOU3IWp5v!t;<KlcH
zAV38vYPdGb*6uLX5||ic`#l)6>@!{ro_BL!%9j~_2mqCEZDJ1dVnm_Zsd<bb!y1zQ
z#}+O2P~`<Ij^I2F+LvHO`73`*`Eknu>A|bP+O+@U7PT9>bWf~9m&iqfpZ${8R@uWX
zDhU3NlWBp{s}Chp0XfB>&w9GM|1B)uVl%7PO;QYBXV=@{Xfp}dnjl$|enz|nuvN-K
zFnULc?O%mT=BYBRg9jIoyNYBgWMr~}CS#R5eXAE#?`L*D(}$dZ3P6+1CSHL2eNHM2
zf>6DinSJCw-d!{3I$7n~D$9UI<*}C357Ls7g^A(dQn#)A_SW!B{!A2!HG`P4zl+^v
z&i#5{_J%7eaC)HW{4M@OX*SGiKuB9vf-KzCZe6Od$@p7cwLjK@_t&W}SCrT%Pkxq3
zDmt<*86eP}ynN6AUka^(K@pYYIuCJX;12BsmUEl-{o`6qJI#af+S2!S2k}DeJ@X$=
zf4WQymDb2BO&4B@1jL&e%YGYmDU3QqFX5ow$I=p|@y!?KZWZqUDNGfulLEa-Ip7A0
zEig@@`OIe?%;^6IYB3f}y!aocc(I2w){LitV<rm}_TjA3_ef0Nc_3+W3mQVN>^jsi
z+05O&gLhekxO;^Al7qQ(9_a;UR7l47jr(dCc2?c@)Zk0YDDO_z>uj~Cf5Tsuap->e
zbOX<(3+^#7KRt{Q7aupd9@Hp26|zh6>YpL6T11no&b4OrsP$Nvwzq@@S+|F-KdxF?
zW$Y>lgeGab$U_pDA3Ha-`Y225H;*4O5lr=3&ZdiA){DFU_<dYNbBYb=k>p4A@EwI`
zZPivt6;J!ez)deM5VSK$E)sXwSd%43Gi4GuO?jFa?-vVj?E4NK3dq&cIP{4XbXVVX
zaxfBH@4f>E-hCivA|IBz58%csEhJ&(7vR_>MMQ8bktlFf62DbL0K~Z<Ck(sxv&7d1
zo`}#UhJPv6orm`Za9srV7;A+$D)Os0OntYk90Kue5_pY~_GyVM;QY*5yj^5kFWC;$
z4P<tDFXREa#l6j)dR%L<1X|iIo8ATmXbS`j!$8v7_vHx;IPX=O{8|k~&R?9t%n>ST
zq95wbld?>ps}Yd{j%s7=srmD^eNj#T6jb``2rEuLtZY0$^(Qg`Pl;sDRa+Ih0HyF=
z-n-1oc(hPV?dOLl%I<usO|vAc=*IUaBI$yG3wx#_kcRtuUAgl3;*?uRVIW3VA)*Je
zC72IO@5Ez}qnS(!?(Rg|KzcH(C;VcOGdbk$PU)5Mp4trt`@Jy{<^4jH&dW52=Lg!m
z>1s~nD1bHYd}9&#S6p)&h7GVVt*EG|Gt)3$n`<}o1KA=x(6fRcJ#Y4R4ILdFP8`Lm
zw}zmdvkft)|9(SICPFPS?*r!=EJnV3938^2-v0MDVCVIB!$P_)d$jGgURn^M^it^h
zqqWQy{AXOS?C9?{kcCA=$X2W1@YNmE##xU*!<fWG-{WEDSHjcB^X=IKwDlzB%6B~w
zRcB(#30b|0hP$?{t*w2aZ+4<=ij0es%$^*otwz|0gtOA6&&xR1q4T}~bTS|v0b1fm
zQfek16L>}zWrGOx7iX%Qh&)wMkP2k<Z~}fz2De_oD9s|bi}U|B{%h3TJ6;;r_w}77
z0<yw&$!}{UPql@2j*^ab@di_5RH9n*@$hh{e_iDaiI%zqyj{8Djk2)deq;obr)Sl>
zer^zkYYZ4b(Bz7sEu*y(uTQo|0~vwt+B82DdMYdZ)y6ECht&(o{k}mML9Yzp>jWtA
z<-Ol>jf(nLUKp|QBNuid<k>h07qse$qlb4X7amN268M)!6%mhhodDB#`X*;QN<YQi
zzVf8#;x8p&jsb~&K_a-H+Dj}fEoU|xqRo7)8%I&yZ}d`1V71s{towKjQ-R4xiz{;l
zZ@%Z!1NsWegTIl84&lXai~V~Q{fSkChoRl}8nlFn$k<?~K)CDFc_)-BP#zxVo(6>G
z6EHZlo$chBe)-ypT`Tu}yOP&6)u-d|*tLHD9=bw4>IOdK{QKuPKujANsfzvgc@qQ`
zl<f>hGE&3I(8v0wJ{$VGVd540_w@`E+gc00)v)V0qIzs?D(e157l88X|Ez!$0lCW{
zRJ=|Dp_^r3y4v8$T95s~K4im%S|<`%qyoagB#-a#YFjlLaOL^_FBfHklPO9wH#6(V
zB=p|j4H|L1$Nv4&fkk;_p#~JO00FifJ0=TM=3)9X@Gl?9Ny!=v!w`HG1BI9?*%*cy
zYqHaN_?1KOC_4*A=T-aE{ZlA*H0HRX9#tZ%``w}V*jNu_*HuG}uG|qUNZ0-Wh>Lkp
z^M%0cSz^)hKRiPBxJ-<9roCOw(Ln6w<3SDJiAIO;t}wR5o)RqUrkdm7KF7nIH*Tyu
z^WyH%61fvv+t8EZ<(vczk^Jn(C98+Bh#5noICNEyR-&5?Vxj_sss3(aKB0DwyV^at
zvECkcGD)Gi-#OU)>3H)~M@+J@NjT{x5Gg}*oB@&ZVZ=5;H$@-fb>7720Qt;{xD$2O
zrIW9M-qQUl7x}9`<rGTB=fZ;t4u#M$#0NPD*cZiy?jt6Q_vR>VY_M;h7)}KIKhc=&
z%zIaE3zmCn8pp0TJ6Dl3^Xx1v+gvoTkeR*MH3`|JuU(0|g{ZNKVId&F?+!8~Q<R#>
zG)s1_ih$vb9N!+I_fc8+;&C^i1`h8XAR(57wJS@{s!qMAw#AMmCDC6p^3^C+j@_t~
zRwtJd{pd9ADV3<xp+hoq_GGoGpP1G^^~&^2C{3PNfzm_UO^i_rnK*~JPK`P}SkgCn
z_b00O5s}ma%32N{I@DU5ZeZcz3}7E%Iowra9cy|&rDW^q5W0YZl+Q6^6r8Gl_5o1D
z6NupqR3_J`1tRST7y*IKcPKeFlhymifxR98c4Fs;_q+w2xrFREY&Pjc+PX&r!oTV=
zp&c8sJlSRGpWNZz)T=}~l7$*8Xrq0CaLK2siGk83+xS^m6Oa(9A!<<FkS8N%g{^dY
zXchmPwZP}wyAUS&iZ?Yb;M`yzT^B@cBTd&eWF%}QSjvAO!c6_vom%BvB*R%P!|8fR
zN+v~whc%}l;AGbrncJPTg~0Cgbe#IO5EO^}74=W29wO$Mho=un78P+GZ^2k!%~Qky
zY2{RnjW93fDwUspc44}Q?+lh)U9QJ`^0ouoOz(s1oA{)_v7n#UqGyRV6QLE5oj=)6
zi&&%~$`p%J{oe-!1b9s*pz<MWm1xh(0H}K5Puhab5i?PPB*V133ymrKo#1mORtkSX
zoZGmu-sYW{?*@yyCr*x-YYDA9rE?XB4(CB^<lS;{ICG%Hi{zb3gsLBqBWC>t8>kiN
zPJWJeF4@sMxGBMH@g&G&N8m-a6EG}s4}@AGo?^es+kCpJ#IZS96?8iGaf3rAHDwV{
zA&)=E`vWvAUZJm?zzNb-sR4;Zz=ddjKvK!ef7N=Hu^3wlgWmIbJddZb)QT6YIP~Ra
zmhwk9#^mDd4AWPCKe*4xsNs|lm+Ra=hxKNgSpRZ!{$dSyGnzo%y>1kO1)3VjpbzHc
z0=KMa8t?3(d`^Q!gm@E$e$bSyX`?7gno+PZu|z}!GFoNKar7qOXU_ou7(Mg*0haO?
zhofod5_3N_giz2#HdD&#mBy}<Bk(8*lM6BgI|JE)pS&(M@B_ltI3M#=hJLq&>yD_h
zorHhPA=}yh>o3ch+$eGLrPyNI`g2ty;3&Wk4t3QeH+f2}ls%Pl7F5ZuG>du@FeB8y
z)SklyKh@@H$2|?}fLDDF%0{ZG6_+xR*xmilk`D^d#Rs|p>SR5Z-@YqoS0_s;@5#`6
z^GFa-06d}RDm_Tuq`F#Zyry)P&T@Ltt1CT1o^e`l>gNkNcJXK`jvgV?R$sjFq@=da
z@0Ua`Ti8lUO472jdVexHk8A@Vm^?_VB_Wa;P(Tl|k=sq_3g~UziQr}mYoUy74P8Ka
z{teZqOL+QTuJFqR3CmBuFftDQI8SJ4?ddebM`i)lhH_E>JA|14rNpuQ=yU2~*RzFe
z-fZ7zXc)@<kVGMQuYC6c#GGW<D0YEWjC}OyQKgj-90H<+%$T0w!8#PiYK@7D8+$d3
z{6;Ppvc8J;e5-tg)mnc2<{LWUga?-ghbMZO`D}y`J}V_Dd41uxcRIw_JsnTWnUuzU
zXS1mc_Yh!)Te-em{(}NqPWpvo9zSwB{1a2dYT0`j-1(SOA@;*Jg!8+)ry)HCi&eDi
zDHF7>?*EP{uib9&ep_QvH{AYqJO02JhFKC~9~fAt8mm30W(0j{9@npjAIsgaVMFSW
z?)7t(y3xy9nXh~#K4+FaJS9P@;likXF5h5K(VII@*x%rhdd2w94SP1$h{nao&)&ye
zoi(V{>o$zsBF<*wJFDDZgAu{e9sQr)hJ)+N#nPqoHMj9VDKq{SU9m(&MMMa&{^&QI
zb?MBr=>lYl-ru#3Hw}q2pVZ|0db(56#X$E0R0N?ZDY^Qts0GR|@7ZfIAE0()X|c3N
z$~&;CeTkhZla1aTbp4Y(>*}A_FN`PEByis^L@49pvJ|^a0^c6V!bPnB1qC?X7bt9y
z?Fkl<eJHtDs<+$%_3BXtSs|+L+_PuT#exhh6UL}8XH(tUKMGmPbd@so@7}p1lK7;_
zQ{=FJ2x_E_D6p@;OwQag{&6^^QqMe(sCoJ~WG^W*Gc({PJ`M_yS;|i}?o&#oB`ad8
z0F24QLl($I^AIah)u6-e0EXZIjJ938`|l#p=@z@Hsd=11Z|<Uj<>t)1{cD0Hrv2S_
zKJ%Zx^Z&<d<iGSQ4#t}ZJbhb_3I#PWo*XWBn``mRz6oAD&2qji2q=|9hYqoksqmz3
z;b%Q)8}N)5;E;fCUH}+c&;Drn2T6kIX~oA<Mu(^Z6%+Gn?}O>B<E$T34@8B#r9G|G
zG4+`^%D>nowL*LR)$rMLgNp^s#&}yK_BX*)xG2*n3NBIz(t1g!Veq(N3Hw|3szAoI
z&(hmC&GL_P=+w=I#U8=HlctmGTw7<PqVyUql82Kb{pwMfckm&ZeEIOq%W%H^`7CtX
z!59hR8B1GBoR%LR^ilOu(L^vzR_LDIMTR(yX~7WyB{GTWZNVex81*t#Z=yg>U^lsl
z#S;Gs7k9?H8HEV=Vrg{9S#|Qv_5okzZS71r(Dk;X3#FVl>d3WavIX#~V)3huxpI5C
z8)~a!$)E*O1oo8M%1_{l+%fQJ)khcPqNIMa`l30@4VQREwE%eysQ1B?QUz5`gqQ*i
z&Z?262X)HWfir^@hYN^5Kp2@L)JfJb*bE9TFR{3#e3W&m?*->)-_1?#1WB*OtL0M@
zg0RcTUv^q7jlmb4FHp`1LORo@f1?cz!kts4$coT4ANy>wz7N8|Hp(bOlNvynu=;pO
zAfE_gKcy-AQ;*7a=E+zFk*r1av54s&^e4iu9_IPmlHaNf?R>sbIie<i_cicyeqJ_R
z8&I<v<}FXdog!3S;);&Uu!@JjuW$#AfGnBlo@`pM6HSMvXiTDXP(ZXk!x5dQou*v)
zlf732s)0WESaSmo8-d9sRxu&9Qco7`@FItqC>`bDmZnPOE&!Y_nl?$eYJyA08{U+y
zzFRwDh=xxtVuI>^<)`{b%<rdaXQIAgT#0IGYIV-T^~vwe;`2cNu0Z+1VOnJ(X3qbz
zaT<t2#;J5e;(*ER(~mun$ajIcyL0c}z3RKn*4cB*Ep6s!h!>eyrG1oZ@N}Mrj6(V*
zH&xPh+G-hel~Q32jY}4mNRvS3UgUoNu3@Daa;z@|H~|1K{6x&OX7(KR+5a@Z{Fla#
z|1`b)>n`X?<(#4Qc@cGje0#BAvAiv^Zh3jRoc(I?DD*(*QZ-#sQ2`LY57m(mX!;dI
z1{zZ7eU&wBP3qRc@&nCitW~vnO<ikcealXg&Vw>dAx|c9*%aDs^HH81?plXWxc%^x
zeQX6}$i-kSG+PpCQO4(kIswxzH1pt(m#BNe-Mt#EIg#N0h~t~Ta<@CG)z)E(Q>se1
zAm;tPN&NlC>PHg(_<ja`I!hs>oR%)H<Agvh44X?K1xeY0Gh``WaC*svE@k!qMMD06
zI&HDqc`|NeLD(7DhRAlg>Ucbsn~C+0mMg~KtZ5>5z#(m2G4Pb99==)$9q};X@Xl@d
z>QeU?kZ%qo5#IxbZdo?xhfJRq>R3auP(T(t=)ZpM?uay-$ZkNU**cWyDv7_)RaBQu
zvs^)NdSYrg$GD?3J}#~ao-YrG3R|&kR%n0Q)j`N1r0NsjJ2ixF7b1kd8>BroDPEj0
z&-WYiLvacb_`y{MhQ-WB*q$S}RgU}Y1j)z*ac#jte8R*gJbrIx1yo+p^2*;72n4rC
zj)=KiT7Fs1WOA)|j7miMIE*&eEE~yA1_mhnE6R*L+W?cPu*oMwG`{q=M`jh0J!sMw
zmymGz(b&*XkSbh}zXm|p@W#Yg0nkxNFfh&8nj~{{K3Ji}kDpKoi?vwwss3-4nSDF6
zCjrsTVka@m24L~%oz$sLJrjPOo}Tc3$)h7(ZfC5<Aho#xnI*CdoZ#M=FPQWTyePhT
zGD&42q-^<s;~_pBKW~)3YxwT=+TV9%XFZ=KRsNnE7oX@keKvnC5Y#Vr_2&))>gR&k
zI9Pr)jUp24NHMXoC%@>Bkd~A^CaG<BuHpwtDH1<HI~Vv04pgb_<-jRcfGF5MPSc~D
zG1Go_Lbm0_(j)80a#a8$A#;oam7j#LC{CB{Xh5o4OU+sAeCkCsz|~`C?H)#<OLmFm
zBGp{nHXoT+DK`LQEYHh%YQDY-MV=EUE-r3wEsDw~AVf`3aCp1BgVB<q6?LJUal}Oh
zVvRTq_k>!O25*Qjsf8ykmxwPAwZF32OeO=>y{dovar$!Qfn^`09~5t_UELUlcC4(&
zry=%FfMxN-EQ3NMBIf0}GYs@;+m0Cm?QuSP5)Q(0$8pStJsP_s!NRKDWMGWk_Za5d
zBmR5(yTM}Frsu~bBzVKMzJiSV2X&b%u749(JzdVuFvG@!EJEmyF*3@oYfb=krFv%M
zUHH_EgD07{7GgkGBToP^Tz{!UJ&dF%U1R(^ZeRbG%?kg-$+$zwvzG~?l35X0w81{)
z)W+M&8{}?AwPi`X0<jzy5SX0-gePe`(?d!^!UJX<lfbf;*0brL;$@&1Nx@fnotImS
zwHGWPF(WktdPg&C`RX>WJ?5`kxmD=Z5>)m}tzXL)%d|+~&6v9_zVJh#;)n``#7+Th
z0a%bj+S&}I3o*kvS>xnel-5c1FsynR?rhp>*R#|zYfzg`DXG4TSrOfddI5zq40a+Y
zBNlJd-gw*R)W*)AGZxUP0S6Bs-nG*I<i_KfM^kFBg*?Er&9pb~L$Xp~%W+1-5na6(
z%I<io??o&;xbH=!LA&q0tPqX7cW)(C_6rpp9#P$PLi>lz@(wz5!n$P3s%yz)Y5=k_
zOi0dO?BTuZV<<pqa;*i250nitFjiQKsGkm|12jd#IF~20g50ByXcUdAJ{na>X%;{9
zGC7bTy=5`6K{WAv$hXz|=DUApM*aWWMa%ysgH>QlJ+cAU&o5)JaG<@^FE}`ue9d4U
zcVgn8axeHd0QV3o03FrC7?z2>K+_qgJbTIMNBg?)$7Dp5eAq37#KiVKVe-zDpIaJ_
z0!4cwjS=uV%3VP_%EIf(G;KgLV*(!N?Dp3T6|hXi;9}Z71bpTM3t~php41|wP}&2>
z=;EP7C$BWQeLvTo&X7QgTVBLOko`NJ*8W7{j3V4X8pq}{Z<T@d9y*GIx<+3fOQH7A
zThy}^rXY{cy+(g+zOUdCS{lTT<#gi<7Xoe_;~8QIuM=iJWKJh~@(B*!7)V=_@#)Sj
zoDoB22V&IOM~}8@%A{XK+w8-K>kv2v(XeH<J7}GlOwL6AL@6DQRDfVsd19Pm5=(9m
zLL3K4sK1*O>c186lUeyldLDF)$J0N)A86#Dpr0SlLmyCGh3u<<gSkeBa8^!ZL^8bh
zk8-V;ka{x~A>c$0==Urq4tU8qi_HUoFq)oR+K3L5C+Ici9X*pq`3J-V*ySJnDs-qH
zm%Le&DPW`N%qk{yLFso|+({=`S>lH`x=sy*)7dA|${Tzv!M_bQv|+e?5wO2I_-=$K
z4hKtXxcu1h+QrRUTL201cdB&N)CNY3zsxHL&(H(^MJ+0qB<}qLW2KkFU^oUn<vn*y
zaY_lA#IaN^%HqKeE>_CM+mps&gPov2egVvs!9|m@t%Z5|Mw<N!zI=Q!TWe3VepqVn
zhi4a?K}<{0O`WgI-c)zy*Sd36hSOv2^%V!Lk8Y?nfT@r?|8$d(A9Z_Am%#1@PaN|R
z_!jXTQT}_)Hkvoe9hDJ{JU>zK{?CBG!1j3wR0BFBkMw<)Dm!m0Ouw#8@TzFqyv7b#
zxz%WS0(f*7+hBVng9=K%%6a43fr_wx?}7Vx(<PbMeHG`p;c(!!&dLkU$mrqHsVBfV
z=6`xFMli`T>rTP=7oat%35BF3Ue#Rb?}36TsnP{4V=mrM&cV36{prw#FtQ3lk-S+G
z4LncBll^UYjJ+mlzLXm5p-EW>IcH#P!@1-Rx6ww<WG@JEn~w66LC%#p|0gCU#vM)6
z8#t53KmvC%Go6B*9frCV5l49D<MU%_+;dxoP|G=hsWCyPL=m6&hNFYJ<HevU)2Afr
zZd4rSf&ol7c&2keJA5)61@zhJrh9Y^hq*Y5CUIEl&vy}t=8ZVOEvA9{i$zCA%8($e
zUn%<IH*s1V%1<xDAALmqi(1d-$=umei}l$I%K^Y4-0mu<C2u+=pia$4t-X+khpOmp
zs8Kx1b#9;9xP+{8sBc8q8Ljk>eYgFd1U-I={s-<C5pJV!Pnu}B%h*ZSl4E${%(j8E
zNG{phS)Rc~^djCB$;~3FaPcl!Zq4V|i)6btz-dt65t80`gStzwI<(DmpnZ&BaV`1l
zPJZfJb*YNa^`hk4hKTowN7Bq7KH;JI{b|Oz!^gL6NIN6dH2%f*Zh&@NY9ky!rZ5Qm
zXzgo;dqkhqj!G9=1Su2kl{o52H`?_9ED}}4{o%JsDZD?;4qw9Aly+u~|Erc4<L{|W
z1sYo|O*0ZQ>C>Tm9|di;GJ(Y^f*y!?6kyWIlil(z6C<r#J2?{OFfAoO97`S27_)4+
zcL$OQa+rDf`y`}1I&<!XMV}VL+dGJ(sY8f+y+j)@HwlCeH9o!i=o?i;F<Z!^`DB0N
z;ep)a13Y<uuU8RQ`_Lgi@`aeTyu1c8J6RquS>Y${Q}|KN_{o0uDX{Cw7^v1HZh5q3
zI29UMCBIEVF>4}~fDSVg$>y%<LN#;1Du}7XBhH|J`3-*1WW+j|p)6p0dFs-uHt~|~
zui{`&dSMoBZLvP)gv3iFJbf!p5L)GRdK_(aQc#zxZgJ=qSaRFHYuMQjU9<qFZq-DX
zk3sVw#^)D^hpra_7|P(}q49t=HHJus`f$zw^y^^ukCv#z00FkZG$!{=t-sp-bAt#G
zUs${1<QQFug4$bHNfEx}rLzTOyfLo@R2eBa4tbM}ih3caY2~c*+9h-|Z!-VM@`e9!
zZvU&L`+wN<fAI|eJkfv2gXr;bSSMtTm4*pY8zE71)K7(#LX=dCtK#p^|I~q|YA)Cg
zQr`Xa<C<gXW^~*aaZyHzr%&FBYU36FI-0<#A`6%JNU7`8e2NJNfkVm9Lnp1xrvvdo
z8b#S%+FICpmP~^HhBnlQ0R`?px%Ew<L_tCkB<hOk1w>j~Lv`&5?6=SYncQZNBYb94
zR7#UKk9ZJrj=+N02NQTcVgWh%2?OM!o>>a>@?pp~oTrYj-Yzhi>V?IcS{phHUeG<E
zxxnOC+l#F?zE0?m-_=;|$E|evtmST+nrggtfl1H(N!8tRPduQLwFG#ICg^C3(EP;^
z?CzUNcX#6JSAPk6D5_S%okxcm89?F*+;R-=h#vSHCEpnByG_-4Nog_CRU4fFu+>N3
zy<q+;sqzWS<UIa!LUv$d3Z1dhrZ*h88THG6D;R+C&RaRC+~l6qH<#w58fPr%7;JpM
zM&Y`mHtuoP^2(EyE~0s2iz61HxODb3{B9<lqC|!!(8`ZqyC7#;J)Jg#>fUnIfaFZF
znZx~}Luoiq=8}kb`Gns>SrM{F!11GMV{pB7wDBRI!_@uB;KvyyxZ*&oPW@RvlOBaI
z9sX%+L?h@NNJtf%dou@`km<e11OZ=xDUK9O9M+-Q5s+}JGh(6nX!j6w<WHa%uX9uc
z#kOz>wgSm)adiZ*>qlMlw8UyoZA5`&N`@~qn756G*t}Ki1Jx_`a80@4`Sa(OLQ;iA
z)Q%~d!LJ^oeixEA;1i<yn^<9ZtXtBy;GW3qP_%T@tAhEL4#bSYq2w5XGKd<YMzA(b
zrY1&5Wd(qsA++tI05m#9eg`@lW_qpW%>=Ch?nPpWD>pnPT_~nLlK<Pdiz?7+@c)|p
z9-}`id2h<l3RxfPJ8K{92C|a)RBJ{J{}UqwOL&FDFYAVla{Kgcz-kQE0S^bhA1<(L
ze~$y@u1ntj6G-TIa+-k<{B1=W_Wot8DejH^lA{1A-Ye^<B?7sJx5mSc^;{*FNnz}W
z720ZlEod6G><$z<7wT%B(-!|%fth*ESIOM1#qa&zZ@wt7-wbU=R@gA#hzq8r^qQ2&
zOoEKrbVkmafs1lv+4}^F3N9l+RWJm`3o;cul8~ybfUH|Bm7oi$BwWtdju~yFBVOgL
zOZ5kXSC(>bN`D?r8`22;AJ#*RkDI{$4v>~F(`KO8R7@<ar1%*fykbd!Iw_Tl>xEjP
z_aJlGhO#raEiz7KE5L0fqP;_Qf!UNkPH(bI!@&y4R%$ofU5jqE(5}-oY-@a<bly6_
zB7K(Zu#o0zuS3(Kv}6Lka6+i4>o};TH6|NGV?je3O}b7L)I(<sve_bf1Y<U8i`n+l
znVF~MJ}L}{HBn|FB9D>GAO-XBE(&ZpKb3Y$tr%;1YsFDo;A;vxZpQy&-P^}L{X^!}
z9k3L8LZ}5LLQ*YQG?}w1qIZEGMuz|b%)7bGY2&2gO^@}s><Fo#zZ(|S8213JpVf+8
zA=)`%NUb2T<=xb`0A&x9Fq(Giot$*(1aWG~NaajB5lWDa)xTY24#N%SP8=sxp>=mZ
zOHF}$fAVdt%z$NgRpw^xG=odG9Q{^x+^rUvcDXG<OCVnu+>uKiwR2&}D*In^sd;W<
zBZNR(3wSa#x?y5?lPB}YSWhqb;AhbjcrATz=+@Tu6M)r48+_-zSB<{>nhVxH5UITg
z0>AW-0r#Uh`29Ye6HT<<rXubhbxu89yU`AkOdGM1Ju{0|#8z<)O5U&W>DWqpK>H;{
z#CO{6>1jie%R`>cmROH+jX8Ldhlkkh?zG12mweZv$cxCW<UpFp-MQrS0w_{N;mH9-
ztxd4IF)R-Sa+I*emio};P-&>d-WCHKwL;rYd*j}7pehTXGa0nRomf35lndC2_h>j7
zg`asolQ#4xzyOoM>j^s)xMUoLKfrzhJ&WdFbQbKrj!_I$91Oy4vH90xlKT@2wyi+;
z0cl&SZT~v=HVO6uE0nG+mUOZb!JwT0rKqLZ&_@z*5EPvg;O<Vnl>D`dFzA?Nt*%AA
zGM^M8IOwu+Vf=galCSL6tSww>9>;Ah?|~mBH(ykDFqBJOKIE!O%9(PY^$2dS-}RF-
zEtE#*VKTS%Pg>#-ue^r1J@2l!3?Q^SV;(A9iUUp06&-R<AGW`vt+LH=VQ^MdqqcwX
zF>8#SgUf4B!mIy~l(>QEL=6-!wPuZRTdfV|tf7t}J%(|iS&ufAS0O8eh6j>w?XaO?
zeMDd8o;8No!!VY&^-=u6P-ErgBgm63mH0&DuQ)aJw+MfzNm{AnK$xo4bg&HU{FPhO
zC>4yY?xj6y{FaG6;!N}z<NdN@nwYZ|c!9KmW<mlp52`NTU^CVJI>?`clHMAr&M^_=
zobLV-9u;Xj_<h=Ow#Y5abUNA2U4^j{)q1}xT7J8@4Lk4AL}phGcgo{WdH&JQS}~(s
zOB9?X;5b`)kHdE3(KutUYT<wq4#~{h5dp`_+Oj@fmrJ)W(_d9hXj=zf7K+DCivOik
z&Rof?nRm`r5u#<Yov~;6lX(~a3VTu0gBNqXsDze9_<jlSalXHW$OBWHEC9k4gQ(Ex
zN^w&=c7lt2KrSLH$fPRlTsr;~cI2lfRYj4bX0JyZajZu(ro5<es!#ukgl~Q@7b!lU
zXV=neIg{{)uG*?t6s<+;aV`^l2Acj!s7wH*BdVFjz$Pmt+DwzMoEA)cx#jLYg0p1|
zbJfX~i&<9c$sX@<ADIev#97a;T+hrZ)|YK_MdU6{qg%L8KQGn1Yt$G_UVk^JpL@%O
zx7Pz3VI=-a4yTR#uj}gYAO3XZ1|5Jp(0yR<7BNtLo;q{(JcB;ajMA~Bu>lf>m(HG|
z$8bSbqkM0sBSqbrbAPE75hr7*Bzos-C5$G;#_F2f&OhWm%0;a<(2et_lYbljwHv#k
z(q)gasS<^>g5-==$=o`}ZON;@GgAEn%oJ(7Q$sUXg=poPoscX6N#(?Wc2$OESP|`a
zXN%Fm@)%9wbRZcH5J9J<FVc$9liD2%tfz$G@NwcGDo@W*a*10wkb_#8u{TlppKWWr
zT7P*vQpjhid}cQ-jn_}y@j9zuev!zBOAG7~Q%un|0#34ao$F9aIA6Mmrv!YXjFuau
zfOeEC%E><wD$zfctb&7TWkf_!yB^+cfHrvHDf({&BoJrwT4naW*Q3Iyr%AvVt%b!-
z<5{nN9-rw{Jg^K-!k`)+y+0@K2JmwXzW0fKLvj7lh9SDE(0|=kD$kc4vnEEq-zbCL
z8DvINdq5yM@;n)FKA-e(Yz`s-kl>gTQpkJ;L^V1^_Q+H4{;MQBIU0<^SWZDqA60rv
zt(1hsy$tw#?*1~srIsF?)k2Nb)Zj#5jCyQ9Y+xP;kC7#Ygm{W^{k61#lX1Y##!uO?
z;Zf~eVgztn4IMdbilW(XuHaTSAQ|KdqUn&$8B-d{K0k!{mNX8CS!Z`s9=ZHZ#EW-_
z+zB_#`&XL1b5{8xIAa4{-5Sko5fSboJ-spiaBy%%slE!}GV=0+<n1h0bny&c`#PZn
zXMopfPC^nLGmLn)_`DxncIlvIaw@kNy{`he58P_8+*ng}@A5V-m@vbpfy}6=Be6--
zAR`nO-;#~IHXIh!?h1#*VAwd$kBIxpaj(qbCskZwo$(E)zl99(Ttak$02=_(uNGxq
zy^2d6oyxp-uWgmUj?&h%slMYF!`51A`bPC4WBkX0gMYQTp2P|8O{D!nJ#}z2nx7oC
z#mLBK(*DlJ>mgk3&EjK$Ba?LM4IR-)_+!@DoN_~aPR-g_S9cMe^0O51&!bVeXw^4x
zwIh3qdkbS$`G(S~1D{FgvF?KYU%u>^e-kMa)Lu!WA_y2SojE>7NfiQ1lefNf+k9#z
z0!2ZGxtoGm^dR>fxxP_%=O~Rt1Z_cUnJF3GF^#!s9$7$w9Tn5m8UkvDRz>xRNFNid
zB`*T!kOK_5uB*MI_AJO+N9i!*J~&0%+g(62mZ6&n=w*&cO7TW7$}4bZa6n~=+rC=h
zo@!il1R&M7Li+IXwuWX8(W7Ulx*4kBs=8Pn<HTpVwXXQvDE9wOY5PCg)&9?2{D*b#
z|8^|obbw@U1O^tYynSl_)xI2%SK@2d`1SYqS0hc#J}W#2%Tlw|+zFPBo7K^ZIni_$
z3w*)M>LJZ<G#SunApEN!j%WHAC*Uz&a%cKVXpiM@>Lp`#C|SIf{9M2*eHc(5_)(EB
zX@<{foFE2+91j*L9Wzb#kvVUng0NVZQc)Dsq1DN`;i(q&TX9ay0(9m5PN#`eQ%^Or
z6ftds8GhK!#3X^o5>+?qaAvc&_eL&<DJwhQKqf6$@!X^W9jiqaFtMqwoU|-DTmt@U
zW0OW8pZA3_aryRjQTwj@iMdFk8v#FPc84LC`d|3d?>xs5*vFgjte)`9ZN}*&UWR-9
z-{Q;}v~_A3pdcVDOI<CIQMsd<tSJ8#3t4j3aDt4k{gjhKC!~=x1NNeI)aSk#j(bzs
z#^~^qJRA}6=Png3@O}iKLdW)^c{lc>%mW+g<;#$EJ*Wu_xe2EvP;bgLDKiI{{~Cc$
zfP)uOs{<@<Zmp}Z*Iej)V%guGy6FHL&|%1VGSMpN`>~<Jgis;D3PR_wg3o1R^pO@&
z2o(-b!n_}3Nm#oN6S8yT?c!mwm@Ub2i8yHwn<8U1a(DONyEXP@h1?!g%V+6CWD$|Q
zpm>oSR1$w;-SmUXr+1Y=n(!22H(o}o8XwstP-M%Kt7RvSGw7d06WBXy)o_CGtZ3;l
zo|x_fpi%m(Oq8CXizd?~Lb{I5>C}pwV~;<Q!J#qx%k$Yp@Q{}=KJCpmi<{w%f<@Ph
zk1;-ccX#sHfP&xO;u)L>-3EgLl7t^0kUqPC^}uN=XQ)SEb4SM%cSP#8*Yerdb}#(N
z<fl7-Tvb+ff5g6|EfJ{9j#zL@L`(W7zPmT(ZeA;`rLQ9KGoM6^+eIBotwm}-Ea!`T
zrdq7kqW%2nlT|-_cTM!_?3tYKUg6Q!f!f?IvElkLr`KJtkK2{DhoppC>wL&+A5i=O
zF2fO_*hS)B2L=u(E4w{^@nR5ltvND$VR3N<T0&p1!;*(_Afm9S=r)JbsBtL$u$aW^
z)vu4%$lLYYD$tHkeKq#O)3hT;j)-sCbolxsnEv>CeC#@FQljrfMvAHBpix@y$tD)7
zeBLx@by|CH83=iQp=@~VB)w|YF64m3ch(8o@i-8woMUGhcn<i$5X<8x`ljz;higJ@
z^}~s3U+K<(y2%{#I)d%o+SUfNsE+@>0gl9b3ofiYVl1j~*)Xz#oYTmeOP4Q8u3o(x
z3+OHMglLqyew|jfp<ri@45fA0{;oFmah~gmY@=FJRD;KA9z1wp*1P4g)zrlKfk7M!
zk>1^ouRL<o?(ufxfXm*o(E~f<>K1lFR0>vbd<@}EI=&(f2Aq?i72yvI=pPuUuY|Y2
z!X*(L<*g*)tv0H_B>QY^9^s$wVjICSZ}b*LeO;yQ;XMk0OAj49_z7~AUY0{DYLFOs
z6+eNc2&gbS1VLmF8(&I6p+2(qZKxp!haK&w^J~iQY6zftTODL`Icn{DP{n)8ty&BD
zCh;s<a2{4<oHJM1xzh|T+O6mNqYA?Huj9s29R|(NYpD+T2mYG-3+B&{#Nlj4ixw@~
ztE6dVm5h;JuyEmt?3+PBx}D+oVLI95Fn%b+un4uH9&B5O3=Bf(A@JYW;S&(3`uzT&
zE=~Xzl~}u0Yv#<EgB_aIF#5fYkE<w|F;A!*2lp!|&SSBXeutfjdlJW)ZW3K|-5Wct
z>T@09aZvkX%f^NWwcV*VXaD@OoamzD<mA1b4j}DbXVfWRF5^NS+e-uovRYb>M4t`;
ze!`K_KFeP{&{>@iO}FFgd2{QbF5ML(BF|46zj*%K8#MgF*x1-M^Ut3@r&hLhZAH`K
zvu5+=&o7dFfGC2Kk_^({b{}uZ_;2l9_g9l?w*~zMM+aqeEC^1}85{=?8HCWJs3R@3
zp$4RbAcQIr5TsZb?iB<yN(WJTU;qUIgsR`DNE0cc1&r572T=i)fO_}q+;#tlyVhm-
z3u`5qywCHTv-dgs>?gR?PFqQ-&zp_)ES)v)L(3pRc)duSpF13VOec$7BSJ~20P?|9
zgY70kZ)e_zhn1*LF!JzGk{%bLGpA>2n%L1i*cgJ|{$qgItbyIzwz*|#hV^PjLy~o9
z^{!`^MD1WjZtlNr;jGK;?t{%HA5L#Pb%KGDx(Bg4l*3oc%g3RZrIn#wZtq_aU)rr6
z_U=^exP6dsldIEiz2$``a4tH3781tiF*~4Yzc16uwO)MpZl>wKMnLJ{P2c!<#-?n`
z9<|#;L$;_u8$EdNKqKPgUEH1{MJ|5Yk*ZJ%8Z)7%%VLKu7GmW7=Jo46w`(Fy=vSFm
z>I*oV!7uI$*Lp-_w#5tEg~YM9u*ijy!^Zv_$4qFIrce+n(hshG*+rj5)_`$=rK{^5
z{c$4-MLA^7){oab=8=x42h9yEHvD?wm*_Bn;a%e&)q@^RuR=4*f#&=Uu1>0(=Yifz
zfpMF_Ks?lbz|w^C8FInotgOG_OwccAb`=kPUCJ+6MbUg<dNf7cKER7${1ff|)X-8P
zp%-P}5=#G~pML(C!=|5J42uk~%fTrO)5L#ASVKS}TFITqKUsNs>yVHdOw;4elRAyT
z7WdXI`+xbR-Lr~`+9GoEO_Z0dE1GQ-MSq8}k}_TFKVoBPtMBI#Nf=}PR6DzLG`@Wv
zwYHYl)!E`Bl!e+O?@v4q#hlZ{6#)=-iC-LbQ89SNs>&CkhxH*Ne6g&MWXTK?#U!!!
zj_unG7;B$CEn^l-PDh6~y7xD@0JpWZO{in3`%v&78)yn$aPk|gx5gu&QYdkozWc6}
zqwaEFsA>+%wHZ!yYj=+Wy{!iwtJ{R3lm_O3&_lOJ=efhbw!^b(8fxAVHoXX%ZCPf}
zXF~K!;$ZsCsUSZe&TAA5S+cQQU5Y%IM5T)f@bZkq9&zYc9gKgJOSJ9~%u&GUgAHFW
zmYy~k2I6nZ&C-c(e!sv|Fr;y7%CIksMn@eGq@MWKmgeW5*sx{KZ+%<glIab<N6yUM
zlVyiRe@7~gkl(lO&VY_R*|I@dZ<RG%8;}F~TL$L|Y!OFH%wt(Rb<jNF*Cb{DwY!r(
z;ES71);t^v|DC%tUKhr$G5PIX2D6zG>xC}t?2Cy1Q&{Mzk(WW7$lt$Rg^hgrq=J3T
zUjv8B{dXzI%agkiTD`Kls-lB35;hf1e$9g{A1VZ*lFPKb!lk9NRnKuiB(T#eSPr_n
ze-g7%wAyb}U)2a;oSwN{M@e!K*JCZM1AsE^Acw@oJ{Gt9J1|=7@ZrOqAy~TXr_K#y
z{^(7%9+cd=)pf|XX5l71OP_HSO2sF2k*gR)O-W6q8Wmm3&URer9=4#j{Q#|q;!8fi
z>ph-(b_#ut>g)R#;jZa3OxQ#nsco0iiE13EL_a;2LnC)^R7i<3##lcZ>~u6fY2q;&
zP$-8xq>hBl9r2h8X;_H@%gr9(SfT!!0)sPF;cv_e?MOjdaB50Qy*!WM&Sm%wR-bCy
zR<#B|%ddf6`hNmN0ph{pM-=*lwR!l_jDoqNM1h&bc*zsEY0W?df6a=$Z2@KEO=4mJ
zHwA-b_NPe!LwAoMe3h~ske&&@bv^Gssxl{S;FX#P+!2&R>nqy2yUie&j2)>BP%x|y
zUoHX6935yuftGIVVsi1~MZ!sZWev|QcsiW?Tr(9}WeKB+oQSA5FODTWB?{)jV2k|%
z!rafvZ+sfV$uL2s`V7B#;Q}YTj)*8&z%1OfYl&(KYsA4t2G^KRedNYW3CU9|KW$mt
za)z%rhGf2Z_SF}6@z^a=+6N6cZQN)c7#Ns6>-F^Ba$(K+r72g^`FEd$g)XS>BV<($
zL82FuQ&I+2*6!aws<ex+xLL-0TQO4Su}Eyqa1=R~fS@T10&ZNrDq8fQUJxkS3DwxY
zJ%*ugoq-hfOde}~KEut}hp^=z(}Z@hvZGR1SQx66iz^YxyN5auM@kU$4t1bx)~(qb
zv4U5WpIdc^yK+S_Nz3r>Z4weCP)le;^6(sqoS4%f*-%m~!hnj1wb1wl@xq7!{N-3<
zUjS6-`Mnmhzh78rMrCCDquyfveA>y|+B(h3ABMt>xQy-Cm?USUIX}qs8x4;dg`(Ab
zPPO&IG356d>sB!C3P27fVl!e-rR_lpMYkB(o93c)Z~}&Z76u0YsUHjkMMHhZ^A-oN
zga(U~N?VDA&{^1TDml}RAIAb-8oi|y^va<2*rPA|6VwY?GBPseh>_BGJ<1m*HoJig
z!y=ZZ%u_v9muC;?=;)++Kzr&(8k}t1%p9L&xQc6pFBONp9%Vv8Fpa7nLQiQ;Sn8O+
zY7$`1Y>lZ|c{ZOS0M6_7uxsU%TDv=q!^Mq=P}1X*lbJd%t(J%HEhOeJXEtmwQyB^>
zU~-e<<CRoD&_ok?gNedMX5`7Ca7!+^V{&4mUS8~f7hdDc%a||+);>!|Afg#u_z@0P
zxP;;iGdK4*@B+oegxmqS-U(<qEZp33JL>lY>=P3c8-!nFU-1J+X3*(XS!CA5sVo!~
z^yV+u`gAImb-~rA)4kQc$dO6u*~@l5Gb`R0{Mhks+Yj>UsX;+O1oT8w>*Ui>l^IQW
z`)Wk}bGqoafuEeWPzTvSnIm*F!DMms#gz$~&f&wAPa}iIkrgJ+MD{8v|MNv=eWn_P
zg>JL26ZaI=S+VGi(nTv<w6^ZtS%}*@ijkP~6ZiDsQ|6)JnJy>M*W0@UZ3PV~4vx(u
z&dqDrTnaZl>Fyqk+4utt4`#*`LNzy&R70)}?@}H}tLIO%f<>p)$_tlvcB!XAq}7jF
zr^Yv-P3A^P?v}L+Y2EdTY9caPcC5HB-HK{XyasE?BV~9kU#?)2CBg5?4!)|&IoRz@
z4}wKRL}azKouFOnL&~rQhUn}xR;qo8Us!-bMU$a(L*}R^hoh;n-w+lUg8&nf<R`Or
zj5+j%N!ffkbxEy_)z6X8OoLU<8vF3oL=sD%I5O*#ooH*x*OxgK^lA8$4kCK*w=Vzo
zGtMJ1R67kgg=#pCF!E5W>#sUGEf40&J6dNyp!}N|`F_bfne;c6TOrq~`3k_zZ=fbJ
zn@^j^iLP-m!#yoW))BCZSz^*DO<;rNk?PhTqobp>FglG8my;eJ1n0Fw-5W(k`(gN5
zg6Uy{lF?z}3Nen23poa1d^Ly&Y%1TEwr`wE*h7yX`VRgbQrZ!9$L2YwjeROlmQ7Gz
z%+1ZwWF)gzP`2vgfBg7SgEeS%l6DB&$kbxoPtckqMLdxmyLZc!a%AHlS@^N&)_aE}
z?aFL0m!!uaVB1vY3VZcI9+Mm3n;2FBPbJ<Zt+!f<!f!!lsvY$4Wi}9B=C%z0@JSdY
ztVF;jE`f2QKmFRZ@97(s;V@U{xUy4RycnHC8l)49{QiC`FoKevOO42!H>`FGjZ~dZ
z>Zk;Lw}f|PUNv_+7*{7BCEQVu;kdX>O*o(lz5b4^)rF|8rnSP~@r>PoXO%ZX_QYa|
zGU@qk_9WP@5>-hDRX%@uCLDFy$L7f_!oZp#TfxJIkaWo5e@HvPwvlZ3RCwy1EyO`m
zh8$JdnDYnBZYd|ZySbgbdjL%F$FEE=0SE<Io$U2&?;;D$LvKKp<q`!@MoAUlz=n78
z*Z@Ru0q6U(Ve{Gi_J|ue)kL6^_Qv-h<PdrP3M(?n^dy;OYghw`uu`gqeF?F|Wv&m!
zrj#=p`57R;7Xw8;@~6dPfs=|LGfrJ5kEdw}#ucKyNiC2fwm*Fuaxw%@w7sqEx)pn*
zao<X=q&>ZRfBYl2iIA?&&a>*Ks3|2xL13&}*HuWkaW9?&Q6-J<s2TPhsq~0PK%>sC
z0;w{rcK6e3<7#C_0w{>`<RpTc%+0TsKy=xznV6X9|KJu#a_CoLeya+A_Ta&Ofb!~y
zl_201Z&XhvR*`E3D8hDf$7g2{I*1ImokS`}W61>iB~D0g3*_$raurf*FE)6R#;|=y
z_z8vU)~%~XR@Fj@jFArp=>_Jxxj8u;o=|ZK3CULMbbCCuWr$TW<UYTC-c$;J{HvlO
zIw1>`WVxNEJJVdX&5Vt$!o%ys5`dSNcwatK(VINU4l3XZGQy2ZHL>!ZBp#@?uD-qx
zw4t8$A`N5ZV36L3O#(>mPu)TrZXt|Q7}}+ky0*5~DW!z~q<rp;%a2;&{d)p3y9&Wv
zd~ot+5Gt@tw4R<G0eVmJ%*utgZ{NZXJM}E^Cv7Dc)_K7box7Vbkq#rQXNYxK<r2~G
z2I&$&fWQyhA7EL{yIEo}Xh0OfGMXZtPl?CAe?2D03~C%J3*R7gpL?#mB?3_MM*Nj4
zgq`Tho5jT&EiEk|SU~@3pD@!wrXHgtXDXrUI1ROtZy*=b<h=xLk(89faYepcSy_=$
zR<?p!lCo;=CQ;F)U!P1p;qjb_NC%9y-;nTKxqP`XDk_RdIMm~iPg>%s0k>Sw$;nx_
zemw`Lz{As1R!z+oPYQ&i%M}_t&qG6vjhe)zomuO_GiFdvAz<~JH-TtL@$xh>gNzH>
z6$x2l*Pdd0J^|Do<<Fk|L4Qq{WpMm6bCkUqyGNIH$}6Tqx3*(ZO-suW;!u^=BYXEA
zMI0D_J+QQ4^cr7Ea@5HZ=Q*8yFIO5)6%;toZrZX%WzrEK0RqTEoR3)?#6z=$-%%$Y
zjwtEw=F4Mh5FGyE*CJ#6>DQkOQ4I3E7xj^Wt3ETLoz=?g@O-J?qvH4C{6p{u(BTL*
z=m_s%Y;_tCar2hfzyx;43p3A~8n~5!xCG4s!J8dT#1a6(7ZQ>JMm|0=4VNfx-t-Q|
z7HdRH)jrAo$28Uqf~HgQB1;9Hl>SsVeO+AwUCazt<aE?$_~6-$&EZbkyqK7O)q0?}
zT>^i574PyX0qr$=yOdM~sDFceDua=Wfy+C{8>|Z#gn-VcF=e{s6&!+lPM6VdI+C4-
zrJ@)cuRWc$<|UB(8kIv<O_*S^NbU@)bZ0hghgKFBG%L&@SqXYS=i{g{URbyXL_3CY
zD_o12hRSLlaeF1gh>gF0IkZrx%0K#ki>>qN)d3xlgcLNg^5MT^2UJLPak&lDg^a9V
zlB4a2=YzMYsE(J2AvO68SLzau1JZ`XO>ax+MXF4xOsA!ZkH3251@tDNdG79|%a=V^
zC&_20{wTAnBFyvqpbD^B5M=gY`jHT<%RAOvp=k5&!w0IDS25HWdC04?SQ6rfGH!SV
z-FQC}k*U42vmf&^0bN<@mWqms#LGeQiGwQd-0Xn1TL#D?wZOBO$)4=3>eeouoAZ@-
zsQUwZXM!xLakdzjG~Yo3Sx#MjSZ@7G);-&U;gA|w+u9bx=5Pv5q~`c=;|mK4D5E`m
zcmf~73=H!bMx4lS;xEeSa=YgR4n#3D?19H4Xy<syYh}+>lQP<lsIV~h7Lw-BPmyo-
z1MV`Um#6#mG2r7p{1mZMEGpJjTz+gLA-+7yN0|vR^G3N-QwcO)6!0sr=|f><n0Qvw
ze~)7K%U~H)CEvt+ICO@1gHV6^BR55AL1BJAaVdcO=+6r*6m1QA(e$psxNmJ>0J5zV
zk!|rV9Z#SE1fOftWll}?f1c-Oqk6T3KD$v#qu%qZmuL@AKT3X`D*fF0adnkY<}zfd
z%$>V-)dnUtnsH<&5x;$)qm>`U=9x(nQXu~BnizIhFV@S--24uqp(tqJTjMWRpL^?O
z*o!P>*Yusx8*ksruhSBEgLYhw%vV(_0FC}u9J+sgq;&r=B*1SG+liF=_2-Q_kzBt1
i{QrxE{%<~wFB{|y{wUwk{NsCK9SwC&Pm~{bx%A)t=3ZI=

diff --git a/reference/random-2.png b/reference/random-2.png
index a7345690cec05dc411def4174aebb5124e05f0d9..6c33fe0bd69d71ac26a3953b6c2641fbf93d6da4 100644
GIT binary patch
delta 29542
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

delta 28701
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

diff --git a/reference/random.html b/reference/random.html
index 5dfd1caa5..af317b6be 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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">
@@ -111,15 +111,16 @@
     <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
     <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="fu">random_mic</span><span class="op">(</span><span class="fl">25</span><span class="op">)</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'mic'</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>  [1] 0.016  0.125  0.125  0.25   0.5    0.004  0.002  0.002  0.032  0.004 </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [11] 0.032  0.0005 0.5    1      0.016  0.008  2      0.125  0.25   0.25  </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [21] 0.032  1      0.008  0.004  0.25  </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>  [1] 0.008    0.016    0.25     0.5      0.5      1        0.002    0.002   </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>  [9] 0.001    0.064    0.002    0.064    &lt;=0.0002 1        4        0.016   </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [17] 0.008    8        0.25     0.5      0.5      0.032    4        0.008   </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [25] 0.004   </span>
 <span class="r-in"><span><span class="fu">random_disk</span><span class="op">(</span><span class="fl">25</span><span class="op">)</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'disk'</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>  [1] 47 20 36 18 44 43 25 28 26 44 36 42  8 28 44 31 29 49 30 28 39 49 25 49 48</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>  [1] 39 47 20 36 18 44 43 25 28 26 44 36 42  8 28 44 31 29 49 30 28 39 49 25 49</span>
 <span class="r-in"><span><span class="fu">random_sir</span><span class="op">(</span><span class="fl">25</span><span class="op">)</span></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 S R S R R S I I I S R R S I I S I I I S S R S S</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>  [1] I R S R S R R S I I I S R R S I I S I I I S S R S</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># add more skewedness, make more realistic by setting a bug and/or drug:</span></span></span>
 <span class="r-in"><span><span class="va">disks</span> <span class="op">&lt;-</span> <span class="fu">random_disk</span><span class="op">(</span><span class="fl">100</span>, severity <span class="op">=</span> <span class="fl">2</span>, mo <span class="op">=</span> <span class="st">"Escherichia coli"</span>, ab <span class="op">=</span> <span class="st">"CIP"</span><span class="op">)</span></span></span>
@@ -132,9 +133,9 @@
 <span class="r-in"><span><span class="co"># \donttest{</span></span></span>
 <span class="r-in"><span><span class="fu">random_mic</span><span class="op">(</span><span class="fl">25</span>, <span class="st">"Klebsiella pneumoniae"</span><span class="op">)</span> <span class="co"># range 0.0625-64</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'mic'</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>  [1] 0.004  4      0.032  16     0.016  16     0.001  0.0002 0.002  0.004 </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [11] 0.001  0.0005 0.0001 0.002  0.125  &gt;=64   0.004  0.0005 0.001  0.0002</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [21] 0.0005 0.001  0.0005 0.004  0.032 </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>  [1] 1      8      0.004  4      0.032  8      0.016  8      0.001  0.0002</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [11] 0.002  0.004  0.001  0.0005 0.0001 0.002  0.125  &gt;=64   0.002  0.0005</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [21] 0.001  0.0002 0.0005 0.001  0.0005</span>
 <span class="r-in"><span><span class="fu">random_mic</span><span class="op">(</span><span class="fl">25</span>, <span class="st">"Klebsiella pneumoniae"</span>, <span class="st">"meropenem"</span><span class="op">)</span> <span class="co"># range 0.0625-16</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'mic'</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>  [1] &lt;=0.5 &lt;=0.5 &lt;=0.5 1     &lt;=0.5 &lt;=0.5 &lt;=0.5 &lt;=0.5 &lt;=0.5 &lt;=0.5 1     1    </span>
diff --git a/reference/resistance_predict.html b/reference/resistance_predict.html
index 1204fbe6e..c0a87012a 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 3cfd1c266..b50f3a76d 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 05f9320f9..2dd3ea9e6 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 d1a0d6cc4..f1ced9934 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="">3.0.0.9036</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.1</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 dfc5fc373..f77b01558 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":"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":"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":"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":"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":"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":"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":"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":"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":"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":"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":"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, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. 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":"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":"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":"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":"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":"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":"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 <=0.0001   S   #>  2   0.0160   S   #>  3 >=8.0000   R   #>  4   0.0320   S   #>  5   0.0080   S   #>  6  64.0000   R   #>  7   0.0080   S   #>  8   0.1250   S   #>  9   0.0320   S   #> 10   0.0002   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":"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.93 e- 1 Gram-p…     5     5 #>  2 Gram-positive              3.17e- 8             1.000e+ 0 Gram-p…     5     1 #>  3 Gram-negative              9.99e- 1             1.42 e- 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.42 e- 2 Gram-n…     5     5 #>  6 Gram-positive              1.07e- 1             8.93 e- 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.22 e-16 Gram-n…     1     1 #> 10 Gram-positive              6.05e-11             1.000e+ 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-esbl-presence-using-raw-mics","dir":"Articles","previous_headings":"","what":"Example 2: Predicting ESBL Presence Using Raw MICs","title":"AMR with tidymodels","text":"second example, demonstrate use <mic> columns directly tidymodels workflows using AMR-specific recipe steps. includes transformation log2 scale using step_mic_log2(), prepares MIC values use classification models. approach idea formed basis publication DOI: 10.3389/fmicb.2025.1582703 model presence extended-spectrum beta-lactamases (ESBL). NOTE: EXAMPLE AVAILABLE NEXT VERSION (#TODO) new AMR package version contain new tidymodels selectors step_mic_log2().","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":"third 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":"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":"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":[]},{"path":"https://amr-for-r.org/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"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":"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":"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":"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":"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/QJ01CR02) 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":"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/WISCA.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Estimating Empirical Coverage with WISCA","text":"Clinical guidelines empirical antimicrobial therapy require probabilistic reasoning: chance regimen cover likely infecting organisms, culture results available? purpose WISCA, Weighted-Incidence Syndromic Combination Antibiogram. WISCA Bayesian approach integrates: Pathogen prevalence (often species causes syndrome), Regimen susceptibility (often regimen works pathogen known), estimate overall empirical coverage antimicrobial regimens, quantified uncertainty. vignette explains WISCA works, useful, apply using AMR package.","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"why-traditional-antibiograms-fall-short","dir":"Articles","previous_headings":"","what":"Why traditional antibiograms fall short","title":"Estimating Empirical Coverage with WISCA","text":"standard antibiogram gives : clinicians don’t know species priori. need choose regimen covers likely pathogens, without knowing one present. Traditional antibiograms calculate susceptibility % just number resistant isolates divided total number tested isolates. Therefore, traditional antibiograms: Fragment information organism, weight real-world prevalence, account combination therapy sample size, provide uncertainty.","code":"Species → Antibiotic → Susceptibility %"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"the-idea-of-wisca","dir":"Articles","previous_headings":"","what":"The idea of WISCA","title":"Estimating Empirical Coverage with WISCA","text":"WISCA asks: “probability regimen cover pathogen, given syndrome?” means combining two things: Incidence pathogen syndrome, Susceptibility pathogen regimen. can write : Coverage=∑(Incidencei×Susceptibilityi)\\text{Coverage} = \\sum_i (\\text{Incidence}_i \\times \\text{Susceptibility}_i) example, suppose: E. coli causes 60% cases, 90% E. coli susceptible drug. Klebsiella causes 40% cases, 70% Klebsiella susceptible. : Coverage=(0.6×0.9)+(0.4×0.7)=0.82\\text{Coverage} = (0.6 \\times 0.9) + (0.4 \\times 0.7) = 0.82 real data, incidence susceptibility estimated samples, carry uncertainty. WISCA models probabilistically, using conjugate Bayesian distributions.","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"pathogen-incidence","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Pathogen incidence","title":"Estimating Empirical Coverage with WISCA","text":"Let: KK number pathogens, α=(1,1,…,1)\\alpha = (1, 1, \\ldots, 1) Dirichlet prior (uniform), n=(n1,…,nK)n = (n_1, \\ldots, n_K) observed counts per species. posterior incidence : p∼Dirichlet(α1+n1,…,αK+nK)p \\sim \\text{Dirichlet}(\\alpha_1 + n_1, \\ldots, \\alpha_K + n_K) simulate , use: xi∼Gamma(αi+ni,1),pi=xi∑j=1Kxjx_i \\sim \\text{Gamma}(\\alpha_i + n_i,\\ 1), \\quad p_i = \\frac{x_i}{\\sum_{j=1}^{K} x_j}","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"susceptibility","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Susceptibility","title":"Estimating Empirical Coverage with WISCA","text":"pathogen–regimen pair prior data: Prior: Beta(α0,β0)\\text{Beta}(\\alpha_0, \\beta_0), default α0=β0=1\\alpha_0 = \\beta_0 = 1 Data: SS susceptible NN tested SS category also include values SDD (susceptible, dose-dependent) (intermediate [CLSI], susceptible, increased exposure [EUCAST]). posterior : θ∼Beta(α0+S,β0+N−S)\\theta \\sim \\text{Beta}(\\alpha_0 + S,\\ \\beta_0 + N - S)","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"final-coverage-estimate","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Final coverage estimate","title":"Estimating Empirical Coverage with WISCA","text":"Putting together: Simulate pathogen incidence: 𝐩∼Dirichlet\\boldsymbol{p} \\sim \\text{Dirichlet} Simulate susceptibility: θi∼Beta(1+Si,1+Ri)\\theta_i \\sim \\text{Beta}(1 + S_i,\\ 1 + R_i) Combine: Coverage=∑=1Kpi⋅θi\\text{Coverage} = \\sum_{=1}^{K} p_i \\cdot \\theta_i Repeat simulation (e.g. 1000×) summarise: Mean = expected coverage Quantiles = credible interval","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"prepare-data-and-simulate-synthetic-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Prepare data and simulate synthetic syndrome","title":"Estimating Empirical Coverage with WISCA","text":"","code":"library(AMR) data <- example_isolates  # Structure of our data data #> # 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>, …  # Add a fake syndrome column data$syndrome <- ifelse(data$mo %like% \"coli\", \"UTI\", \"No UTI\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"basic-wisca-antibiogram","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Basic WISCA antibiogram","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"CIP\", \"GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"use-combination-regimens","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Use combination regimens","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"stratify-by-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Stratify by syndrome","title":"Estimating Empirical Coverage with WISCA","text":"AMR package available 28 languages, can used wisca() function :","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = \"syndrome\") wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = gsub(\"UTI\", \"UCI\", data$syndrome),       language = \"Spanish\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"sensible-defaults-which-can-be-customised","dir":"Articles","previous_headings":"","what":"Sensible defaults, which can be customised","title":"Estimating Empirical Coverage with WISCA","text":"simulations = 1000: number Monte Carlo draws conf_interval = 0.95: coverage interval width combine_SI = TRUE: count “” “SDD” susceptible","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"limitations","dir":"Articles","previous_headings":"","what":"Limitations","title":"Estimating Empirical Coverage with WISCA","text":"assumes data representative adjustment patient-level covariates, although passed onto syndromic_group argument WISCA model resistance time, might want use tidymodels , wrote basic introduction","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"summary","dir":"Articles","previous_headings":"","what":"Summary","title":"Estimating Empirical Coverage with WISCA","text":"WISCA enables: Empirical regimen comparison, Syndrome-specific coverage estimation, Fully probabilistic interpretation. available AMR package via either:","code":"wisca(...)  antibiogram(..., wisca = TRUE)"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"reference","dir":"Articles","previous_headings":"","what":"Reference","title":"Estimating Empirical Coverage with WISCA","text":"Bielicki, JA, et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data. J Antimicrob Chemother. 71(3):794-802. https://doi.org/10.1093/jac/dkv397","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Download 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 18 September 2025 12:58:34 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.8 MB) Download Apache Feather file (8.4 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":"Download data sets for download / own use","text":"data set 496 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 1 September 2025 14:56:55 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (45 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (78 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (0.4 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":"Download 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":"Download 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":"Download 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":"Download 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":"Download 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":"Download 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":"Download data sets for download / own use","text":"data set 6 036 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 4 May 2025 16:50:25 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (27 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (98 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (68 kB) Download IBM SPSS Statistics data file (0.2 MB) Download Stata DTA file (0.2 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":"Download 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 28 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 . amr--r.org 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-28-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, available in 28 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,  Arabic,  Bengali,  Chinese,  Czech,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Hindi,  Indonesian,  Italian,  Japanese,  Korean,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swahili,  Swedish,  Turkish,  Ukrainian,  Urdu,  Vietnamese. 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 28 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) antibiogram(example_isolates,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") antibiogram(example_isolates,             antimicrobials = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian"},{"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 = \"grey30\") +   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.229 0.205-0.254        0.315 0.284-0.347  #> 2 ICU              0.290 0.253-0.33         0.400 0.353-0.449  #> 3 Outpatient       0.2   0.131-0.285        0.368 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.229 0.315 0.626     1 0.780 #> 2 ICU        0.290 0.400 0.662     1 0.857 #> 3 Outpatient 0.2   0.368 0.605    NA 0.889 # 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.229      0.315    0.626         1    0.780 #> 2 ICU             0.290      0.400    0.662         1    0.857 #> 3 Outpatient      0.2        0.368    0.605        NA    0.889 # 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.229   0.315   0.626       1   0.780 #> 2 ICU          0.290   0.400   0.662       1   0.857 #> 3 Outpatient   0.2     0.368   0.605      NA   0.889"},{"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 functions 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-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), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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. 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. AMR package available English, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. 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\"  \"QG51AA03\" \"QJ01CA04\" 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\"  \"QG51AA03\" \"QJ01CA04\" #>  #> $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\"  \"QJ01CA01\" \"QJ51CA01\" \"QS01AA19\" \"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\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  \"QJ01DD04\"  # 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  1980-02-27  45  45.55890         19 #> 2  1953-07-26  72  72.15068         46 #> 3  1949-09-02  76  76.04658         50 #> 4  1986-08-03  39  39.12877         13 #> 5  1932-11-19  92  92.83288         67 #> 6  1949-03-30  76  76.47397         50 #> 7  1996-06-23  29  29.24110          3 #> 8  1963-09-16  62  62.00822         36 #> 9  1952-05-16  73  73.34521         47 #> 10 1952-11-14  72  72.84658         47"},{"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. function returns ordered factor.","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(0, 12, 25, 55, 75), names = NULL,   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. names Optional names given various age groups. 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+ age_groups(ages, c(20, 50), names = c(\"Under 20 years\", \"20 to 50 years\", \"Over 50 years\")) #> [1] Under 20 years Under 20 years Under 20 years Over 50 years  20 to 50 years #> [6] Over 50 years  Over 50 years  20 to 50 years 20 to 50 years #> Levels: Under 20 years < 20 to 50 years < Over 50 years  # 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 = \" + \", sort_columns = TRUE,   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 = \" + \", sort_columns = TRUE, 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()) Column indices using numbers 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. sort_columns logical indicate whether antimicrobial columns must sorted name. 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 (Weighted-Incidence Syndromic Combination Antibiogram) estimates probability empirical coverage combination regimens. weights susceptibility pathogen prevalence within clinical syndrome provides credible intervals around expected coverage. background, interpretation, examples, see WISCA vignette.","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: 10 × 7 #> # Type:           Non-WISCA with 95% CI #>    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: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   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: 5 × 3 #> # Type:           Non-WISCA with 95% CI #>   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: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   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: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   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: 2 × 3 #> # Type:           Non-WISCA with 95% CI #>   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: 14 × 8 #> # Type:           Non-WISCA with 95% CI #>    `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: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   `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: 3 × 4 #> # Type:           WISCA with 95% CI #>   `Syndromic Group` `Piperacillin/tazobactam` Piperacillin/tazobactam + Gentam…¹ #>   <chr>             <chr>                     <chr>                              #> 1 Clinical          73.4% (67.6-78.6%)        92.4% (90.6-93.7%)                 #> 2 ICU               57.4% (49.7-65.6%)        85% (82.1-87.6%)                   #> 3 Outpatient        56.9% (46.9-66.7%)        74.4% (69-79.7%)                   #> # ℹ 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.6% (68.4-79%)        | #> |ICU             |57.4% (49.7-65.4%)      | #> |Outpatient      |57% (47.2-66.7%)        |   # 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. Simply puy, column name resembles antimicrobial drug, picked functions matches pharmaceutical class, code name: column names \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" included following selection:","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 antimicrobial columns must included transformed class sir beforehand. Defaults FALSE. 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), 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 616 Antimicrobial Drugs — antimicrobials","title":"Data Sets with 616 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. antibiotics data set renamed antimicrobials. old name removed future version.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 616 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials  antibiotics  antivirals"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 616 Antimicrobial Drugs — antimicrobials","text":"object class deprecated_amr_dataset (inherits tbl_df, tbl, data.frame) 496 rows 14 columns. 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 496 observations and 14 variables:","title":"Data Sets with 616 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 (last updated May 4th, 2025): 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 ATC properties (last updated May 4th, 2025): oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 180 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: 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 616 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, see Details 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 616 Antimicrobial Drugs — antimicrobials","text":"Collaborating Centre Drug Statistics Methodology, Guidelines ATC classification DDD assignment, Oslo Accessed https://atcddd.fhi./atc_ddd_index/ May 4th, 2025. 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 616 Antimicrobial Drugs — antimicrobials","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. note ATC codes unique. example, J01CR02 officially ATC code \"amoxicillin beta-lactamase inhibitor\". Consequently, two items antimicrobials data set return \"J01CR02\":   Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":"ab_atc(\"amoxicillin/clavulanic acid\") ab_atc(\"amoxicillin/sulbactam\")"},{"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 616 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 616 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 616 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials #> # A tibble: 496 × 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 [6]>     <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 [4]>     <chr>    #>  9 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [6]>     <chr>    #> 10 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> # ℹ 486 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 28 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  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  \"QJ01DD04\"  # 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,   language = get_AMR_locale(), 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,   language = get_AMR_locale(), 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,   language = get_AMR_locale(), 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: selection columns apply .sir() . Supports tidyselect language (.mic), starts_with(...), column1:column4, can thus also antimicrobial selectors .sir(df, penicillins()). 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 cases \"R\". 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 28 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). language Language convert values set host using animal breakpoints. Use one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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. requires additional packages, used parallel package part base R. Windows R < 4.0.0 parallel::parLapply() used, cases efficient parallel::mclapply() used. 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. never used cores variables analyse. 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% potentially invalid antimicrobial interpretations, 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[, 1:10]) # 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)      # create some 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\") ) # and clean previous SIR interpretation logs x <- sir_interpretation_history(clean = TRUE)   # For INTERPRETING disk diffusion and MIC values -----------------------  # 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: 4 × 18 #>   datetime            index method ab_given    mo_given   host_given input_given #>   <dttm>              <int> <chr>  <chr>       <chr>      <chr>      <chr>       #> 1 2025-09-19 11:35:37     1 MIC    amoxicillin Escherich… human      8           #> 2 2025-09-19 11:35:38     1 MIC    cipro       Escherich… human      0.256       #> 3 2025-09-19 11:35:38     1 DISK   tobra       Escherich… human      16          #> 4 2025-09-19 11:35:38     1 DISK   genta       Escherich… 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 in parallel mode using 3 out of 4 cores, on columns 'amoxicillin', #> 'cipro', 'tobra', 'genta', and 'ERY'... #>  DONE #>  #>  #> ℹ Run `sir_interpretation_history()` to retrieve a logbook with all 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))    df_wide %>% mutate(across(aminopenicillins(), 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) } #> ℹ For `aminopenicillins()` using column 'amoxicillin' #> 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 ------------------------------------------------   # 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\" #> Class 'sir' #> [1] S    SDD  I    R    NI   <NA> <NA> <NA> as.sir(\"<= 0.002; S\") # will return \"S\" #> Class 'sir' #> [1] 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 the more impractical:   # 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 #> ℹ in `atc_online_property()`: no properties found for ATC QG51AA03. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QG51AA03&showdescription=no. #> ℹ in `atc_online_property()`: no properties found for ATC QJ01CA04. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QJ01CA04&showdescription=no. #> [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":"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":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"rules set (y object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"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, 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/custom_mdro_guideline.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom MDRO Guideline — custom_mdro_guideline","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Define custom MDRO guideline organisation specific analysis use output function mdro().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"custom_mdro_guideline(..., as_factor = TRUE)  # S3 method for class 'custom_mdro_guideline' c(x, ..., as_factor = NULL)"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"... Guideline rules formula notation, see instructions, Examples. as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector. combining rules sets (using c()) value inherited first set default. x Existing custom MDRO rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data.","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom MDRO Guideline — custom_mdro_guideline","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:   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():","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) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> => Found 930 custom defined MDROs out of 2000 isolates (46.5%)  table(x) #> 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\"))) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B < Elderly Type C. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> - Custom MDRO rule 3: ERY == \"R\" & age > 50 (109 rows matched) #> => Found 1039 custom defined MDROs out of 2000 isolates (52.0%)  table(x) #> x #>       Negative  Elderly Type A  Elderly Type B  Elderly Type C #>            961             198             732             109"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.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 MDRO Guideline — custom_mdro_guideline","text":"can define antimicrobial groups instead single antimicrobials rule , part tilde (~). Use () () specify scope antimicrobial group:   35 antimicrobial selectors supported use rules: aminoglycosides() can select:  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() can select:  amoxicillin ampicillin antifungals() can select:  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() can select:  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, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin betalactams() can select:  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() can select:  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() can select:  biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem cephalosporins() can select:  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() can select:  cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine cephalosporins_2nd() can select:  cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef cephalosporins_3rd() can select:  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() can select:  cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome cephalosporins_5th() can select:  ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam fluoroquinolones() can select:  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() can select:  avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod isoxazolylpenicillins() can select:  cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test lincosamides() can select:  clindamycin, lincomycin, pirlimycin lipoglycopeptides() can select:  dalbavancin, oritavancin, telavancin macrolides() can select:  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() can select:  aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam nitrofurans() can select:  furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone oxazolidinones() can select:  cadazolid, cycloserine, linezolid, tedizolid, thiacetazone penicillins() can select:  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() can select:  chloramphenicol, florfenicol, thiamphenicol polymyxins() can select:  colistin, polymyxin B, polymyxin B/polysorbate 80 quinolones() can select:  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() can select:  rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine streptogramins() can select:  pristinamycin quinupristin/dalfopristin sulfonamides() can select:  brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea tetracyclines() can select:  cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline trimethoprims() can select:  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() can select:  azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam","code":"custom_mdro_guideline(   AMX == \"R\"                       ~ \"My MDRO #1\",   any(cephalosporins_2nd() == \"R\") ~ \"My MDRO #2\",   all(glycopeptides() == \"R\")      ~ \"My MDRO #3\" )"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"x <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) x #> 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  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): out <- mdro(example_isolates, guideline = x) table(out) #> out #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732   out <- mdro(example_isolates, guideline = x, verbose = TRUE) head(out) #>    row_number microorganism           MDRO #> V1          1          <NA> Elderly Type B #> V2          2          <NA> Elderly Type B #> V3          3          <NA>       Negative #> V4          4          <NA>       Negative #> V5          5          <NA>       Negative #> V6          6          <NA>       Negative #>                                   reason #> V1 matched rule 2: ERY == \"R\" & age > 60 #> V2 matched rule 2: ERY == \"R\" & age > 60 #> V3                      no rules matched #> V4                      no rules matched #> V5                      no rules matched #> V6                      no rules matched #>                               all_nonsusceptible_columns        guideline #> V1 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V2 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V3                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V4                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V5                PEN, FLC, CXM, CAZ, TMP, ERY, AZM, COL Custom guideline #> V6           PEN, FLC, CXM, CAZ, TMP, ERY, CLI, AZM, COL Custom guideline  # you can create custom guidelines using selectors (see ?antimicrobial_selectors) my_guideline <- custom_mdro_guideline(   AMX == \"R\" ~ \"Custom MDRO 1\",   all(cephalosporins_2nd() == \"R\") ~ \"Custom MDRO 2\" ) my_guideline #> A set of custom MDRO rules: #>   1. If AMX is  R  then: Custom MDRO 1 #>   2. If all of cephalosporins_2nd() is  R  then: Custom MDRO 2 #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Custom MDRO 1 < Custom MDRO 2  out <- mdro(example_isolates, guideline = my_guideline) #> ℹ Column 'esbl' is SIR eligible (despite only having empty values), since #>   it seems to be tazobactam (TAZ) #> ℹ Column 'mecC' is SIR eligible (despite only having empty values), since #>   it seems to be mecillinam (MEC) #> ℹ Column 'vanA' is SIR eligible (despite only having empty values), since #>   it seems to be lenampicillin (LEN) #> ℹ Column 'vanB' is SIR eligible (despite only having empty values), since #>   it seems to be metronidazole (MTR) #> ℹ For `cephalosporins_2nd()` using columns 'CXM' (cefuroxime) and 'FOX' #>   (cefoxitin) #> ℹ Assuming a filter on all 2 cephalosporins_2nd. Wrap around `all()` or #>   `any()` to prevent this note. table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>          1144           804            52"},{"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 = any(is.sir(x)),   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 included transformed class sir beforehand. Defaults FALSE columns x class sir. custom_rules Custom rules apply, created custom_eucast_rules(). overwrite logical indicating whether overwrite existing SIR 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 names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning. 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":"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: Isolate-based Minimum variables required: Microorganism identifier method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID. Patient-based Minimum variables required: Microorganism identifier, Patient identifier method includes every genus-species combination per patient . 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. Episode-based Minimum variables required: Microorganism identifier, Patient identifier, Date include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, e.g., 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. Phenotype-based Minimum variables required: Microorganism identifier, Patient identifier, Date, Antimicrobial test results 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.","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] 17 19 32  7 48 16 36 11 41 30 43 42  3 37  6 42 16 46 12  6 38 15 31 23 44 #>  [26] 35 42 21 10 21 18 22  9 29 40  8 22 14 31 47 18 26 28 18 25 20 11 49  8 27 #>  [51] 50 23 46  3 27  6 31  1 33 10 23 31 11 20 46 13  4 24  4 27  8 48 16  2 20 #>  [76] 35 31 19 33 34 16 14 33 17 46 24 15 17  7  9 39 14 50  5 12  2 45 35  8 28 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 FALSE  TRUE  TRUE FALSE  TRUE  TRUE  TRUE  TRUE #>  [25]  TRUE  TRUE FALSE  TRUE  TRUE FALSE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [37] FALSE  TRUE FALSE  TRUE FALSE  TRUE  TRUE FALSE  TRUE  TRUE FALSE  TRUE #>  [49] FALSE  TRUE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE FALSE #>  [61] FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE FALSE FALSE FALSE FALSE #>  [73] FALSE  TRUE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE FALSE FALSE #>  [85] FALSE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE  TRUE FALSE FALSE #>  [97]  TRUE FALSE FALSE FALSE  # filter on results from the third 60-day episode only, using base R df[which(get_episode(df$date, 60) == 3), ] #> # A tibble: 2 × 46 #>   date       patient   age gender ward  mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr> <mo>         <sir> <sir> <sir> <sir> #> 1 2002-07-23 F35553     51 M      ICU   B_STPHY_AURS   R     NA    S     R   #> 2 2002-07-23 F35553     51 M      ICU   B_STPHY_AURS   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 011307  2011-09-20 B         TRUE        #>  2 011307  2011-09-20 C         TRUE        #>  3 021368  2016-03-25 A         TRUE        #>  4 060287  2007-03-11 B         TRUE        #>  5 078381  2014-07-17 A         TRUE        #>  6 097186  2015-10-28 B         TRUE        #>  7 0DBB93  2003-10-02 A         TRUE        #>  8 0DBF93  2015-12-03 C         TRUE        #>  9 114570  2003-04-22 A         TRUE        #> 10 141061  2014-10-22 C         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 Clinical   2011-09-20 011307          1 TRUE        #>  2 Clinical   2011-09-20 011307          1 FALSE       #>  3 Outpatient 2016-03-25 021368          1 TRUE        #>  4 Clinical   2007-03-11 060287          1 TRUE        #>  5 ICU        2014-07-17 078381          1 TRUE        #>  6 Clinical   2015-10-28 097186          1 TRUE        #>  7 ICU        2003-10-02 0DBB93          1 TRUE        #>  8 ICU        2015-12-03 0DBF93          1 TRUE        #>  9 ICU        2003-04-22 114570          1 TRUE        #> 10 Clinical   2014-10-22 141061          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           51             12            33            43 #> 2 ICU                31             11            26            30 #> 3 Outpatient         11              8            11            11  # 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 690B42  B_ESCHR_COLI ICU        TRUE         #>  2 550406  B_ESCHR_COLI Outpatient TRUE         #>  3 F86227  B_STPHY_CONS Clinical   TRUE         #>  4 859863  B_STPHY_EPDR ICU        TRUE         #>  5 987C84  B_ESCHR_COLI Clinical   TRUE         #>  6 E19440  B_ESCHR_COLI ICU        TRUE         #>  7 F42C5F  B_MRGNL_MRGN Clinical   TRUE         #>  8 F54261  B_STPHY_AURS Clinical   TRUE         #>  9 5D1690  B_ESCHR_COLI Outpatient TRUE         #> 10 874171  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\", SDD = \"#8FD6C4\", 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     ) } #> Warning: Ignoring unknown parameters: `size`  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 antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir.","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 = any(is.sir(x)), ...)  all_antimicrobials(x = NULL, only_sir_columns = any(is.sir(x)), ...)  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 antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... 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.071712 kurtosis(rnorm(10000), excess = TRUE) #> [1] -0.02774835"},{"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 = \"CMI 2012\", 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 = any(is.sir(x)), ...)  brmo(x = NULL, only_sir_columns = any(is.sir(x)), ...)  mrgn(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE,   ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = any(is.sir(x)),   verbose = FALSE, ...)"},{"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 returns data set MDRO results logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... Column names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning.","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":"verbose set TRUE: data.frame containing columns row_number, microorganism, MDRO, reason, all_nonsusceptible_columns, guideline 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. genotypic) 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":"Please suggest implement guidelines letting us know. Currently supported guidelines (case-insensitive): guideline = \"CMI 2012\" (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 = \"EUCAST 3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) Also: guideline = \"EUCAST 3.2\" former European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST 3.1\" former 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 2024\" (simply 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)\"","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":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. Custom guidelines can set custom_mdro_guideline() function.","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":[]},{"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) #> Warning: in `mdro()`: NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with `pct_required_classes`) str(out) #>  Ord.factor w/ 4 levels \"Negative\"<\"Multi-drug-resistant (MDR)\"<..: NA NA 1 1 1 1 NA NA 1 1 ... table(out) #> out #>                         Negative       Multi-drug-resistant (MDR)  #>                             1617                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0   out <- mdro(example_isolates, guideline = \"EUCAST 3.3\") table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1994                     0                     6   # \\donttest{ if (require(\"dplyr\")) {   # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     count(MDRO) } #> 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`) #> # A tibble: 3 × 2 #>   MDRO                           n #>   <ord>                      <int> #> 1 Negative                    1617 #> 2 Multi-drug-resistant (MDR)   128 #> 3 NA                           255 # }"},{"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 (.mic), starts_with(...), column1:column4, 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] I I R I R S S S I S mean_amr_distance(sir) #>  [1] -0.4743416 -0.4743416  1.8973666 -0.4743416  1.8973666 -0.4743416 #>  [7] -0.4743416 -0.4743416 -0.4743416 -0.4743416  mic <- random_mic(10) mic #> Class 'mic' #>  [1] 0.004  2      0.002  0.0001 0.004  0.002  >=4    0.0002 0.032  0.004  mean_amr_distance(mic) #>  [1] -0.2047915  1.5799751 -0.4038557 -1.2641969 -0.2047915 -0.4038557 #>  [7]  1.7790393 -1.0651327  0.3924011 -0.2047915 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1] -0.2047915  1.5799751 -0.4038557 -1.2641969 -0.2047915 -0.4038557 #>  [7]  1.7790393 -1.0651327  0.3924011 -0.2047915  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 43 12 28 32 22 31 35 25 43 35 mean_amr_distance(disk) #>  [1]  1.30998909 -1.96498364 -0.27467513  0.14790199 -0.90854082  0.04225771 #>  [7]  0.46483484 -0.59160798  1.30998909  0.46483484  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    S   31    2 >=16 #> 2   B    S   27  <=1    8 #> 3   C    R   25    2    4 #> 4   D    R   25  <=1    2 #> 5   E    I   31  <=1    2 #> 6   F    S   32  <=1    8 #> 7   G    I   29    2    2 #> 8   H    S   18  <=1    4 #> 9   I    S   28  <=1    4 #> 10  J    R   17  <=1    2 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.90606144 -0.03989270  0.66241774 -0.09230226 -0.32300020  0.19914999 #>  [7]  0.09893189 -0.70734036 -0.22925499 -0.47477055 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 #> 4   D    R   25  <=1    2   -0.7848712 #> 5   E    I   31  <=1    2   -0.7848712 #> 10  J    R   17  <=1    2   -0.7848712 #> 8   H    S   18  <=1    4   -0.3105295 #> 9   I    S   28  <=1    4   -0.3105295 #> 2   B    S   27  <=1    8    0.1638121 #> 6   F    S   32  <=1    8    0.1638121 #> 7   G    I   29    2    2    0.2502272 #> 3   C    R   25    2    4    0.7245688 #> 1   A    S   31    2 >=16    1.6732521  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    R   25    2    4   0.66241774  0.0000000 #> 2   A    S   31    2 >=16   0.90606144  0.2436437 #> 3   F    S   32  <=1    8   0.19914999  0.4632678 #> 4   G    I   29    2    2   0.09893189  0.5634858 #> 5   B    S   27  <=1    8  -0.03989270  0.7023104 #> 6   D    R   25  <=1    2  -0.09230226  0.7547200 #> 7   I    S   28  <=1    4  -0.22925499  0.8916727 #> 8   E    I   31  <=1    2  -0.32300020  0.9854179 #> 9   J    R   17  <=1    2  -0.47477055  1.1371883 #> 10  H    S   18  <=1    4  -0.70734036  1.3697581 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 6 036 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 6 036 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 6 036 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 6 036 Common Microorganism Codes — microorganisms.codes","text":"tibble 6 036 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 6 036 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 6 036 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 6,036 × 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      #> # ℹ 6,026 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 ~19 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) ~26 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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_colour_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I =   \"#F6D55C\", R = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_fill_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\",   R = \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#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(S   = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R = \"#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(S = \"#3CAEA3\", SDD =   \"#8FD6C4\", I = \"#F6D55C\", R = \"#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.) 28 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\")) {   autoplot(some_mic_values, mo = \"Staph aureus\", ab = \"Ceftaroline\", guideline = \"CLSI\") }   if (require(\"ggplot2\")) {   # support for 27 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 = \"grey30\", 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 = \"grey30\", 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 = \"grey30\") +     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 27 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, skew = \"right\",   severity = 1, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, skew = \"left\",   severity = 1, ...)  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(). Can length size. ab character can coerced valid antimicrobial drug code .ab(). skew Direction skew MIC disk values, either \"right\" \"left\". left-skewed distribution majority data right. severity Skew severity; higher values increase skewedness. Default 2; use 0 prevent skewedness. ... 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":"Internally, MIC disk zone values sampled based clinical breakpoints defined clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument. MICs sampled log2 scale disks linearly, using weighted probabilities. weights based skew severity arguments: skew = \"right\" places emphasis lower MIC higher disk values. skew = \"left\" places emphasis higher MIC lower disk values. severity controls exponential bias applied.","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.016  0.125  0.125  0.25   0.5    0.004  0.002  0.002  0.032  0.004  #> [11] 0.032  0.0005 0.5    1      0.016  0.008  2      0.125  0.25   0.25   #> [21] 0.032  1      0.008  0.004  0.25   random_disk(25) #> Class 'disk' #>  [1] 47 20 36 18 44 43 25 28 26 44 36 42  8 28 44 31 29 49 30 28 39 49 25 49 48 random_sir(25) #> Class 'sir' #>  [1] R S R S R R S I I I S R R S I I S I I I S S R S S  # add more skewedness, make more realistic by setting a bug and/or drug: disks <- random_disk(100, severity = 2, mo = \"Escherichia coli\", ab = \"CIP\") plot(disks)  # `plot()` and `ggplot2::autoplot()` allow for coloured bars if `mo` and `ab` are set plot(disks, mo = \"Escherichia coli\", ab = \"CIP\", guideline = \"CLSI 2025\")   # \\donttest{ random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 0.004  4      0.032  16     0.016  16     0.001  0.0002 0.002  0.004  #> [11] 0.001  0.0005 0.0001 0.002  0.125  >=64   0.004  0.0005 0.001  0.0002 #> [21] 0.0005 0.001  0.0005 0.004  0.032  random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] <=0.5 <=0.5 <=0.5 1     <=0.5 <=0.5 <=0.5 <=0.5 <=0.5 <=0.5 1     1     #> [13] <=0.5 <=0.5 <=0.5 <=0.5 1     <=0.5 <=0.5 <=0.5 <=0.5 1     1     <=0.5 #> [25] <=0.5 random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] >=2 1   1   1   >=2 >=2 >=2 1   >=2 1   1   >=2 1   1   1   >=2 1   1   1   #> [20] >=2 >=2 1   1   1   1    random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 28 12 30 26  9 34 30 19 32 31 33 34 30 19 15 24 18 34 12 32 29 33 29 32 17 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 18 15 19 13 22 20 22 13 18 14 19 13 12 22 20 21 12 20 18 19 20 22 18 17 20 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 21 31 27 28 30 34 16 32 28 25 25 23 29 26 24 28 27 33 30 19 30 22 27 22 32 # }"},{"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) } #> Warning: Removed 8 rows containing missing values or values outside the scale range #> (`geom_ribbon()`).   # 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) } #> Warning: Removed 16 rows containing missing values or values outside the scale range #> (`geom_ribbon()`).  # }"},{"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.01429035"},{"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), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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 28 supported languages English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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-3009036","dir":"Changelog","previous_headings":"","what":"AMR 3.0.0.9036","title":"AMR 3.0.0.9036","text":"bugfix release following release v3.0.0 June 2025.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-3-0-0-9036","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.0.9036","text":"Fixed bugs introduced ggplot2 v4.0.0 (#236) Fixed bug antibiogram() antimicrobials set Fixed bug antibiogram() allow column names containing + character (#222) Fixed bug .ab() antimicrobial codes number preceded space Fixed bug eucast_rules() using specific custom rules Fixed bug .sir() allow tidyselect language (#220) Fixed bug .sir() pick right breakpoint uti = FALSE (#216) Fixed bug ggplot_sir() using combine_SI = FALSE (#213) Fixed bug mdro() make sure genes specified arguments acknowledged Fixed bug antimicrobials data set remove statins (#229) Fixed bug microorganisms data set MycoBank IDs synonyms (#233) Fixed ATC J01CR05 map piperacillin/tazobactam rather piperacillin/sulbactam (#230) Fixed skimmers (skimr package) class ab, sir, disk (#234) Fixed plotting contain separate colour SDD (susceptible dose-dependent) (#223) Fixed specific Dutch translations antimicrobials Added warning .ab() input resembles antiviral codes names (#232) Added reasons verbose output mdro() (#227) Added names age_groups() custom names can given (#215) Added note .sir() make explicit higher-level taxonomic breakpoints used (#218) Added antibiotic codes Comprehensive Antibiotic Resistance Database (CARD) antimicrobials data set (#225) Updated Fosfomycin antibiotic class Phosphonics (#225) Updated random_mic() random_disk() set skewedness distribution allow multiple microorganisms","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-300","dir":"Changelog","previous_headings":"","what":"AMR 3.0.0","title":"AMR 3.0.0","text":"CRAN release: 2025-06-02 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-3-0-0","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 3.0.0","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-3-0-0","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 3.0.0","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 antimicrobials, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antimicrobials (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. Added full support 8 new languages: Arabic, Bengali, Hindi, Indonesian, Korean, Swahili, Urdu, Vietnamese. AMR package now available 28 languages. 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-3-0-0","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.0","text":"Support parallel computing greatly improve speed 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 antimicrobials antimicrobial groups affected single rule mo_info() now contains extra element rank group_members (contents new mo_group_members() function) Updated ATC codes WHOCC Updated antimicrobial DDDs WHOCC Fix using manual value mo_transform antibiogram() Fixed bug antibiogram() returns empty data set Argument only_sir_columns now defaults TRUE column data set contains class ‘sir’ (functions eucast_rules(), key_antimicrobials(), mdro(), etc.) Added Sensititre codes animals, antimicrobials microorganisms Fix mapping ‘high level’ antimicrobials .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 Verbose Mode (verbose = TRUE) now includes guideline name 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 upport antimicrobial selectors use custom rule (custom_mdro_guideline()) Added console colours support sir class Positron","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"other-3-0-0","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 3.0.0","text":"New website domain: https://amr--r.org! old domain 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-3-0-0","dir":"Changelog","previous_headings":"","what":"Older Versions","title":"AMR 3.0.0","text":"changelog contains changes AMR v3.0 (June 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":"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":"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":"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":"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":"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":"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":"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":"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":"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":"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":"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, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. 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":"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":"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":"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":"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":"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":"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 <=0.0001   S   #>  2   0.0160   S   #>  3 >=8.0000   R   #>  4   0.0320   S   #>  5   0.0080   S   #>  6  64.0000   R   #>  7   0.0080   S   #>  8   0.1250   S   #>  9   0.0320   S   #> 10   0.0002   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":"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.93 e- 1 Gram-p…     5     5 #>  2 Gram-positive              3.17e- 8             1.000e+ 0 Gram-p…     5     1 #>  3 Gram-negative              9.99e- 1             1.42 e- 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.42 e- 2 Gram-n…     5     5 #>  6 Gram-positive              1.07e- 1             8.93 e- 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.22 e-16 Gram-n…     1     1 #> 10 Gram-positive              6.05e-11             1.000e+ 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-esbl-presence-using-raw-mics","dir":"Articles","previous_headings":"","what":"Example 2: Predicting ESBL Presence Using Raw MICs","title":"AMR with tidymodels","text":"second example, demonstrate use <mic> columns directly tidymodels workflows using AMR-specific recipe steps. includes transformation log2 scale using step_mic_log2(), prepares MIC values use classification models. approach idea formed basis publication DOI: 10.3389/fmicb.2025.1582703 model presence extended-spectrum beta-lactamases (ESBL). NOTE: EXAMPLE AVAILABLE NEXT VERSION (#TODO) new AMR package version contain new tidymodels selectors step_mic_log2().","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":"third 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":"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":"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":[]},{"path":"https://amr-for-r.org/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"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":"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":"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":"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":"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/QJ01CR02) 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":"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/WISCA.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Estimating Empirical Coverage with WISCA","text":"Clinical guidelines empirical antimicrobial therapy require probabilistic reasoning: chance regimen cover likely infecting organisms, culture results available? purpose WISCA, Weighted-Incidence Syndromic Combination Antibiogram. WISCA Bayesian approach integrates: Pathogen prevalence (often species causes syndrome), Regimen susceptibility (often regimen works pathogen known), estimate overall empirical coverage antimicrobial regimens, quantified uncertainty. vignette explains WISCA works, useful, apply using AMR package.","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"why-traditional-antibiograms-fall-short","dir":"Articles","previous_headings":"","what":"Why traditional antibiograms fall short","title":"Estimating Empirical Coverage with WISCA","text":"standard antibiogram gives : clinicians don’t know species priori. need choose regimen covers likely pathogens, without knowing one present. Traditional antibiograms calculate susceptibility % just number resistant isolates divided total number tested isolates. Therefore, traditional antibiograms: Fragment information organism, weight real-world prevalence, account combination therapy sample size, provide uncertainty.","code":"Species → Antibiotic → Susceptibility %"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"the-idea-of-wisca","dir":"Articles","previous_headings":"","what":"The idea of WISCA","title":"Estimating Empirical Coverage with WISCA","text":"WISCA asks: “probability regimen cover pathogen, given syndrome?” means combining two things: Incidence pathogen syndrome, Susceptibility pathogen regimen. can write : Coverage=∑(Incidencei×Susceptibilityi)\\text{Coverage} = \\sum_i (\\text{Incidence}_i \\times \\text{Susceptibility}_i) example, suppose: E. coli causes 60% cases, 90% E. coli susceptible drug. Klebsiella causes 40% cases, 70% Klebsiella susceptible. : Coverage=(0.6×0.9)+(0.4×0.7)=0.82\\text{Coverage} = (0.6 \\times 0.9) + (0.4 \\times 0.7) = 0.82 real data, incidence susceptibility estimated samples, carry uncertainty. WISCA models probabilistically, using conjugate Bayesian distributions.","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"pathogen-incidence","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Pathogen incidence","title":"Estimating Empirical Coverage with WISCA","text":"Let: KK number pathogens, α=(1,1,…,1)\\alpha = (1, 1, \\ldots, 1) Dirichlet prior (uniform), n=(n1,…,nK)n = (n_1, \\ldots, n_K) observed counts per species. posterior incidence : p∼Dirichlet(α1+n1,…,αK+nK)p \\sim \\text{Dirichlet}(\\alpha_1 + n_1, \\ldots, \\alpha_K + n_K) simulate , use: xi∼Gamma(αi+ni,1),pi=xi∑j=1Kxjx_i \\sim \\text{Gamma}(\\alpha_i + n_i,\\ 1), \\quad p_i = \\frac{x_i}{\\sum_{j=1}^{K} x_j}","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"susceptibility","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Susceptibility","title":"Estimating Empirical Coverage with WISCA","text":"pathogen–regimen pair prior data: Prior: Beta(α0,β0)\\text{Beta}(\\alpha_0, \\beta_0), default α0=β0=1\\alpha_0 = \\beta_0 = 1 Data: SS susceptible NN tested SS category also include values SDD (susceptible, dose-dependent) (intermediate [CLSI], susceptible, increased exposure [EUCAST]). posterior : θ∼Beta(α0+S,β0+N−S)\\theta \\sim \\text{Beta}(\\alpha_0 + S,\\ \\beta_0 + N - S)","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"final-coverage-estimate","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Final coverage estimate","title":"Estimating Empirical Coverage with WISCA","text":"Putting together: Simulate pathogen incidence: 𝐩∼Dirichlet\\boldsymbol{p} \\sim \\text{Dirichlet} Simulate susceptibility: θi∼Beta(1+Si,1+Ri)\\theta_i \\sim \\text{Beta}(1 + S_i,\\ 1 + R_i) Combine: Coverage=∑=1Kpi⋅θi\\text{Coverage} = \\sum_{=1}^{K} p_i \\cdot \\theta_i Repeat simulation (e.g. 1000×) summarise: Mean = expected coverage Quantiles = credible interval","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"prepare-data-and-simulate-synthetic-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Prepare data and simulate synthetic syndrome","title":"Estimating Empirical Coverage with WISCA","text":"","code":"library(AMR) data <- example_isolates  # Structure of our data data #> # 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>, …  # Add a fake syndrome column data$syndrome <- ifelse(data$mo %like% \"coli\", \"UTI\", \"No UTI\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"basic-wisca-antibiogram","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Basic WISCA antibiogram","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"CIP\", \"GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"use-combination-regimens","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Use combination regimens","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"stratify-by-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Stratify by syndrome","title":"Estimating Empirical Coverage with WISCA","text":"AMR package available 28 languages, can used wisca() function :","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = \"syndrome\") wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = gsub(\"UTI\", \"UCI\", data$syndrome),       language = \"Spanish\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"sensible-defaults-which-can-be-customised","dir":"Articles","previous_headings":"","what":"Sensible defaults, which can be customised","title":"Estimating Empirical Coverage with WISCA","text":"simulations = 1000: number Monte Carlo draws conf_interval = 0.95: coverage interval width combine_SI = TRUE: count “” “SDD” susceptible","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"limitations","dir":"Articles","previous_headings":"","what":"Limitations","title":"Estimating Empirical Coverage with WISCA","text":"assumes data representative adjustment patient-level covariates, although passed onto syndromic_group argument WISCA model resistance time, might want use tidymodels , wrote basic introduction","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"summary","dir":"Articles","previous_headings":"","what":"Summary","title":"Estimating Empirical Coverage with WISCA","text":"WISCA enables: Empirical regimen comparison, Syndrome-specific coverage estimation, Fully probabilistic interpretation. available AMR package via either:","code":"wisca(...)  antibiogram(..., wisca = TRUE)"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"reference","dir":"Articles","previous_headings":"","what":"Reference","title":"Estimating Empirical Coverage with WISCA","text":"Bielicki, JA, et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data. J Antimicrob Chemother. 71(3):794-802. https://doi.org/10.1093/jac/dkv397","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Download 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 18 September 2025 12:58:34 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.8 MB) Download Apache Feather file (8.4 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":"Download data sets for download / own use","text":"data set 496 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 1 September 2025 14:56:55 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (45 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (78 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (0.4 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":"Download 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":"Download 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":"Download 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":"Download 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":"Download 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":"Download 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":"Download data sets for download / own use","text":"data set 6 036 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 4 May 2025 16:50:25 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (27 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (98 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (68 kB) Download IBM SPSS Statistics data file (0.2 MB) Download Stata DTA file (0.2 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":"Download 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 28 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 . amr--r.org 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-28-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, available in 28 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,  Arabic,  Bengali,  Chinese,  Czech,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Hindi,  Indonesian,  Italian,  Japanese,  Korean,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swahili,  Swedish,  Turkish,  Ukrainian,  Urdu,  Vietnamese. 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 28 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) antibiogram(example_isolates,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") antibiogram(example_isolates,             antimicrobials = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian"},{"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 = \"grey30\") +   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.229 0.205-0.254        0.315 0.284-0.347  #> 2 ICU              0.290 0.253-0.33         0.400 0.353-0.449  #> 3 Outpatient       0.2   0.131-0.285        0.368 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.229 0.315 0.626     1 0.780 #> 2 ICU        0.290 0.400 0.662     1 0.857 #> 3 Outpatient 0.2   0.368 0.605    NA 0.889 # 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.229      0.315    0.626         1    0.780 #> 2 ICU             0.290      0.400    0.662         1    0.857 #> 3 Outpatient      0.2        0.368    0.605        NA    0.889 # 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.229   0.315   0.626       1   0.780 #> 2 ICU          0.290   0.400   0.662       1   0.857 #> 3 Outpatient   0.2     0.368   0.605      NA   0.889"},{"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 functions 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-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), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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. 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. AMR package available English, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. 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\"  \"QG51AA03\" \"QJ01CA04\" 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\"  \"QG51AA03\" \"QJ01CA04\" #>  #> $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\"  \"QJ01CA01\" \"QJ51CA01\" \"QS01AA19\" \"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\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  \"QJ01DD04\"  # 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  1980-02-27  45  45.56164         19 #> 2  1953-07-26  72  72.15342         46 #> 3  1949-09-02  76  76.04932         50 #> 4  1986-08-03  39  39.13151         13 #> 5  1932-11-19  92  92.83562         67 #> 6  1949-03-30  76  76.47671         50 #> 7  1996-06-23  29  29.24384          3 #> 8  1963-09-16  62  62.01096         36 #> 9  1952-05-16  73  73.34795         47 #> 10 1952-11-14  72  72.84932         47"},{"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. function returns ordered factor.","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(0, 12, 25, 55, 75), names = NULL,   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. names Optional names given various age groups. 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+ age_groups(ages, c(20, 50), names = c(\"Under 20 years\", \"20 to 50 years\", \"Over 50 years\")) #> [1] Under 20 years Under 20 years Under 20 years Over 50 years  20 to 50 years #> [6] Over 50 years  Over 50 years  20 to 50 years 20 to 50 years #> Levels: Under 20 years < 20 to 50 years < Over 50 years  # 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 = \" + \", sort_columns = TRUE,   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 = \" + \", sort_columns = TRUE, 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()) Column indices using numbers 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. sort_columns logical indicate whether antimicrobial columns must sorted name. 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 (Weighted-Incidence Syndromic Combination Antibiogram) estimates probability empirical coverage combination regimens. weights susceptibility pathogen prevalence within clinical syndrome provides credible intervals around expected coverage. background, interpretation, examples, see WISCA vignette.","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: 10 × 7 #> # Type:           Non-WISCA with 95% CI #>    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: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   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: 5 × 3 #> # Type:           Non-WISCA with 95% CI #>   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: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   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: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   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: 2 × 3 #> # Type:           Non-WISCA with 95% CI #>   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: 14 × 8 #> # Type:           Non-WISCA with 95% CI #>    `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: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   `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: 3 × 4 #> # Type:           WISCA with 95% CI #>   `Syndromic Group` `Piperacillin/tazobactam` Piperacillin/tazobactam + Gentam…¹ #>   <chr>             <chr>                     <chr>                              #> 1 Clinical          73.4% (67.6-78.6%)        92.4% (90.6-93.7%)                 #> 2 ICU               57.4% (49.7-65.6%)        85% (82.1-87.6%)                   #> 3 Outpatient        56.9% (46.9-66.7%)        74.4% (69-79.7%)                   #> # ℹ 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.6% (68.4-79%)        | #> |ICU             |57.4% (49.7-65.4%)      | #> |Outpatient      |57% (47.2-66.7%)        |   # 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. Simply puy, column name resembles antimicrobial drug, picked functions matches pharmaceutical class, code name: column names \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" included following selection:","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 antimicrobial columns must included transformed class sir beforehand. Defaults FALSE. 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), 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 616 Antimicrobial Drugs — antimicrobials","title":"Data Sets with 616 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. antibiotics data set renamed antimicrobials. old name removed future version.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 616 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials  antibiotics  antivirals"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 616 Antimicrobial Drugs — antimicrobials","text":"object class deprecated_amr_dataset (inherits tbl_df, tbl, data.frame) 496 rows 14 columns. 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 496 observations and 14 variables:","title":"Data Sets with 616 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 (last updated May 4th, 2025): 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 ATC properties (last updated May 4th, 2025): oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 180 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: 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 616 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, see Details 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 616 Antimicrobial Drugs — antimicrobials","text":"Collaborating Centre Drug Statistics Methodology, Guidelines ATC classification DDD assignment, Oslo Accessed https://atcddd.fhi./atc_ddd_index/ May 4th, 2025. 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 616 Antimicrobial Drugs — antimicrobials","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. note ATC codes unique. example, J01CR02 officially ATC code \"amoxicillin beta-lactamase inhibitor\". Consequently, two items antimicrobials data set return \"J01CR02\":   Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":"ab_atc(\"amoxicillin/clavulanic acid\") ab_atc(\"amoxicillin/sulbactam\")"},{"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 616 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 616 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 616 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials #> # A tibble: 496 × 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 [6]>     <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 [4]>     <chr>    #>  9 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [6]>     <chr>    #> 10 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> # ℹ 486 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 28 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  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  \"QJ01DD04\"  # 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,   language = get_AMR_locale(), 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,   language = get_AMR_locale(), 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,   language = get_AMR_locale(), 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: selection columns apply .sir() . Supports tidyselect language (.mic), starts_with(...), column1:column4, can thus also antimicrobial selectors .sir(df, penicillins()). 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 cases \"R\". 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 28 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). language Language convert values set host using animal breakpoints. Use one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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. requires additional packages, used parallel package part base R. Windows R < 4.0.0 parallel::parLapply() used, cases efficient parallel::mclapply() used. 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. never used cores variables analyse. 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% potentially invalid antimicrobial interpretations, 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[, 1:10]) # 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)      # create some 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\") ) # and clean previous SIR interpretation logs x <- sir_interpretation_history(clean = TRUE)   # For INTERPRETING disk diffusion and MIC values -----------------------  # 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: 4 × 18 #>   datetime            index method ab_given    mo_given   host_given input_given #>   <dttm>              <int> <chr>  <chr>       <chr>      <chr>      <chr>       #> 1 2025-09-20 16:21:07     1 MIC    amoxicillin Escherich… human      8           #> 2 2025-09-20 16:21:07     1 MIC    cipro       Escherich… human      0.256       #> 3 2025-09-20 16:21:07     1 DISK   tobra       Escherich… human      16          #> 4 2025-09-20 16:21:07     1 DISK   genta       Escherich… 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 in parallel mode using 3 out of 4 cores, on columns 'amoxicillin', #> 'cipro', 'tobra', 'genta', and 'ERY'... #>  DONE #>  #>  #> ℹ Run `sir_interpretation_history()` to retrieve a logbook with all 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))    df_wide %>% mutate(across(aminopenicillins(), 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) } #> ℹ For `aminopenicillins()` using column 'amoxicillin' #> 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 ------------------------------------------------   # 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\" #> Class 'sir' #> [1] S    SDD  I    R    NI   <NA> <NA> <NA> as.sir(\"<= 0.002; S\") # will return \"S\" #> Class 'sir' #> [1] 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 the more impractical:   # 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 #> ℹ in `atc_online_property()`: no properties found for ATC QG51AA03. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QG51AA03&showdescription=no. #> ℹ in `atc_online_property()`: no properties found for ATC QJ01CA04. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QJ01CA04&showdescription=no. #> [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":"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":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"rules set (y object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"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, 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/custom_mdro_guideline.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom MDRO Guideline — custom_mdro_guideline","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Define custom MDRO guideline organisation specific analysis use output function mdro().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"custom_mdro_guideline(..., as_factor = TRUE)  # S3 method for class 'custom_mdro_guideline' c(x, ..., as_factor = NULL)"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"... Guideline rules formula notation, see instructions, Examples. as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector. combining rules sets (using c()) value inherited first set default. x Existing custom MDRO rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data.","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom MDRO Guideline — custom_mdro_guideline","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:   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():","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) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> => Found 930 custom defined MDROs out of 2000 isolates (46.5%)  table(x) #> 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\"))) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B < Elderly Type C. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> - Custom MDRO rule 3: ERY == \"R\" & age > 50 (109 rows matched) #> => Found 1039 custom defined MDROs out of 2000 isolates (52.0%)  table(x) #> x #>       Negative  Elderly Type A  Elderly Type B  Elderly Type C #>            961             198             732             109"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.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 MDRO Guideline — custom_mdro_guideline","text":"can define antimicrobial groups instead single antimicrobials rule , part tilde (~). Use () () specify scope antimicrobial group:   35 antimicrobial selectors supported use rules: aminoglycosides() can select:  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() can select:  amoxicillin ampicillin antifungals() can select:  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() can select:  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, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin betalactams() can select:  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() can select:  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() can select:  biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem cephalosporins() can select:  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() can select:  cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine cephalosporins_2nd() can select:  cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef cephalosporins_3rd() can select:  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() can select:  cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome cephalosporins_5th() can select:  ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam fluoroquinolones() can select:  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() can select:  avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod isoxazolylpenicillins() can select:  cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test lincosamides() can select:  clindamycin, lincomycin, pirlimycin lipoglycopeptides() can select:  dalbavancin, oritavancin, telavancin macrolides() can select:  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() can select:  aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam nitrofurans() can select:  furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone oxazolidinones() can select:  cadazolid, cycloserine, linezolid, tedizolid, thiacetazone penicillins() can select:  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() can select:  chloramphenicol, florfenicol, thiamphenicol polymyxins() can select:  colistin, polymyxin B, polymyxin B/polysorbate 80 quinolones() can select:  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() can select:  rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine streptogramins() can select:  pristinamycin quinupristin/dalfopristin sulfonamides() can select:  brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea tetracyclines() can select:  cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline trimethoprims() can select:  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() can select:  azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam","code":"custom_mdro_guideline(   AMX == \"R\"                       ~ \"My MDRO #1\",   any(cephalosporins_2nd() == \"R\") ~ \"My MDRO #2\",   all(glycopeptides() == \"R\")      ~ \"My MDRO #3\" )"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"x <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) x #> 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  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): out <- mdro(example_isolates, guideline = x) table(out) #> out #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732   out <- mdro(example_isolates, guideline = x, verbose = TRUE) head(out) #>    row_number microorganism           MDRO #> V1          1          <NA> Elderly Type B #> V2          2          <NA> Elderly Type B #> V3          3          <NA>       Negative #> V4          4          <NA>       Negative #> V5          5          <NA>       Negative #> V6          6          <NA>       Negative #>                                   reason #> V1 matched rule 2: ERY == \"R\" & age > 60 #> V2 matched rule 2: ERY == \"R\" & age > 60 #> V3                      no rules matched #> V4                      no rules matched #> V5                      no rules matched #> V6                      no rules matched #>                               all_nonsusceptible_columns        guideline #> V1 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V2 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V3                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V4                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V5                PEN, FLC, CXM, CAZ, TMP, ERY, AZM, COL Custom guideline #> V6           PEN, FLC, CXM, CAZ, TMP, ERY, CLI, AZM, COL Custom guideline  # you can create custom guidelines using selectors (see ?antimicrobial_selectors) my_guideline <- custom_mdro_guideline(   AMX == \"R\" ~ \"Custom MDRO 1\",   all(cephalosporins_2nd() == \"R\") ~ \"Custom MDRO 2\" ) my_guideline #> A set of custom MDRO rules: #>   1. If AMX is  R  then: Custom MDRO 1 #>   2. If all of cephalosporins_2nd() is  R  then: Custom MDRO 2 #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Custom MDRO 1 < Custom MDRO 2  out <- mdro(example_isolates, guideline = my_guideline) #> ℹ Column 'esbl' is SIR eligible (despite only having empty values), since #>   it seems to be tazobactam (TAZ) #> ℹ Column 'mecC' is SIR eligible (despite only having empty values), since #>   it seems to be mecillinam (MEC) #> ℹ Column 'vanA' is SIR eligible (despite only having empty values), since #>   it seems to be lenampicillin (LEN) #> ℹ Column 'vanB' is SIR eligible (despite only having empty values), since #>   it seems to be metronidazole (MTR) #> ℹ For `cephalosporins_2nd()` using columns 'CXM' (cefuroxime) and 'FOX' #>   (cefoxitin) #> ℹ Assuming a filter on all 2 cephalosporins_2nd. Wrap around `all()` or #>   `any()` to prevent this note. table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>          1144           804            52"},{"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 = any(is.sir(x)),   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 included transformed class sir beforehand. Defaults FALSE columns x class sir. custom_rules Custom rules apply, created custom_eucast_rules(). overwrite logical indicating whether overwrite existing SIR 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 names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning. 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":"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: Isolate-based Minimum variables required: Microorganism identifier method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID. Patient-based Minimum variables required: Microorganism identifier, Patient identifier method includes every genus-species combination per patient . 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. Episode-based Minimum variables required: Microorganism identifier, Patient identifier, Date include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, e.g., 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. Phenotype-based Minimum variables required: Microorganism identifier, Patient identifier, Date, Antimicrobial test results 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.","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] 17 19 32  7 48 16 36 11 41 30 43 42  3 37  6 42 16 46 12  6 38 15 31 23 44 #>  [26] 35 42 21 10 21 18 22  9 29 40  8 22 14 31 47 18 26 28 18 25 20 11 49  8 27 #>  [51] 50 23 46  3 27  6 31  1 33 10 23 31 11 20 46 13  4 24  4 27  8 48 16  2 20 #>  [76] 35 31 19 33 34 16 14 33 17 46 24 15 17  7  9 39 14 50  5 12  2 45 35  8 28 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 FALSE  TRUE  TRUE FALSE  TRUE  TRUE  TRUE  TRUE #>  [25]  TRUE  TRUE FALSE  TRUE  TRUE FALSE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [37] FALSE  TRUE FALSE  TRUE FALSE  TRUE  TRUE FALSE  TRUE  TRUE FALSE  TRUE #>  [49] FALSE  TRUE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE FALSE #>  [61] FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE FALSE FALSE FALSE FALSE #>  [73] FALSE  TRUE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE FALSE FALSE #>  [85] FALSE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE  TRUE FALSE FALSE #>  [97]  TRUE FALSE FALSE FALSE  # filter on results from the third 60-day episode only, using base R df[which(get_episode(df$date, 60) == 3), ] #> # A tibble: 2 × 46 #>   date       patient   age gender ward  mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr> <mo>         <sir> <sir> <sir> <sir> #> 1 2002-07-23 F35553     51 M      ICU   B_STPHY_AURS   R     NA    S     R   #> 2 2002-07-23 F35553     51 M      ICU   B_STPHY_AURS   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 011307  2011-09-20 B         TRUE        #>  2 011307  2011-09-20 C         TRUE        #>  3 021368  2016-03-25 A         TRUE        #>  4 060287  2007-03-11 B         TRUE        #>  5 078381  2014-07-17 A         TRUE        #>  6 097186  2015-10-28 B         TRUE        #>  7 0DBB93  2003-10-02 A         TRUE        #>  8 0DBF93  2015-12-03 C         TRUE        #>  9 114570  2003-04-22 A         TRUE        #> 10 141061  2014-10-22 C         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 Clinical   2011-09-20 011307          1 TRUE        #>  2 Clinical   2011-09-20 011307          1 FALSE       #>  3 Outpatient 2016-03-25 021368          1 TRUE        #>  4 Clinical   2007-03-11 060287          1 TRUE        #>  5 ICU        2014-07-17 078381          1 TRUE        #>  6 Clinical   2015-10-28 097186          1 TRUE        #>  7 ICU        2003-10-02 0DBB93          1 TRUE        #>  8 ICU        2015-12-03 0DBF93          1 TRUE        #>  9 ICU        2003-04-22 114570          1 TRUE        #> 10 Clinical   2014-10-22 141061          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           51             12            33            43 #> 2 ICU                31             11            26            30 #> 3 Outpatient         11              8            11            11  # 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 690B42  B_ESCHR_COLI ICU        TRUE         #>  2 550406  B_ESCHR_COLI Outpatient TRUE         #>  3 F86227  B_STPHY_CONS Clinical   TRUE         #>  4 859863  B_STPHY_EPDR ICU        TRUE         #>  5 987C84  B_ESCHR_COLI Clinical   TRUE         #>  6 E19440  B_ESCHR_COLI ICU        TRUE         #>  7 F42C5F  B_MRGNL_MRGN Clinical   TRUE         #>  8 F54261  B_STPHY_AURS Clinical   TRUE         #>  9 5D1690  B_ESCHR_COLI Outpatient TRUE         #> 10 874171  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\", SDD = \"#8FD6C4\", 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     ) } #> Warning: Ignoring unknown parameters: `size`  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 antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir.","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 = any(is.sir(x)), ...)  all_antimicrobials(x = NULL, only_sir_columns = any(is.sir(x)), ...)  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 antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... 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.071712 kurtosis(rnorm(10000), excess = TRUE) #> [1] -0.02774835"},{"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 = \"CMI 2012\", 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 = any(is.sir(x)), ...)  brmo(x = NULL, only_sir_columns = any(is.sir(x)), ...)  mrgn(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE,   ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = any(is.sir(x)),   verbose = FALSE, ...)"},{"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 returns data set MDRO results logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... Column names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning.","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":"verbose set TRUE: data.frame containing columns row_number, microorganism, MDRO, reason, all_nonsusceptible_columns, guideline 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. genotypic) 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":"Please suggest implement guidelines letting us know. Currently supported guidelines (case-insensitive): guideline = \"CMI 2012\" (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 = \"EUCAST 3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) Also: guideline = \"EUCAST 3.2\" former European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST 3.1\" former 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 2024\" (simply 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)\"","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":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. Custom guidelines can set custom_mdro_guideline() function.","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":[]},{"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) #> Warning: in `mdro()`: NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with `pct_required_classes`) str(out) #>  Ord.factor w/ 4 levels \"Negative\"<\"Multi-drug-resistant (MDR)\"<..: NA NA 1 1 1 1 NA NA 1 1 ... table(out) #> out #>                         Negative       Multi-drug-resistant (MDR)  #>                             1617                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0   out <- mdro(example_isolates, guideline = \"EUCAST 3.3\") table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1994                     0                     6   # \\donttest{ if (require(\"dplyr\")) {   # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     count(MDRO) } #> 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`) #> # A tibble: 3 × 2 #>   MDRO                           n #>   <ord>                      <int> #> 1 Negative                    1617 #> 2 Multi-drug-resistant (MDR)   128 #> 3 NA                           255 # }"},{"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 (.mic), starts_with(...), column1:column4, 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] I I R I R S S S I S mean_amr_distance(sir) #>  [1] -0.4743416 -0.4743416  1.8973666 -0.4743416  1.8973666 -0.4743416 #>  [7] -0.4743416 -0.4743416 -0.4743416 -0.4743416  mic <- random_mic(10) mic #> Class 'mic' #>  [1] 0.004  2      0.002  0.0001 0.004  0.002  >=4    0.0002 0.032  0.004  mean_amr_distance(mic) #>  [1] -0.2047915  1.5799751 -0.4038557 -1.2641969 -0.2047915 -0.4038557 #>  [7]  1.7790393 -1.0651327  0.3924011 -0.2047915 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1] -0.2047915  1.5799751 -0.4038557 -1.2641969 -0.2047915 -0.4038557 #>  [7]  1.7790393 -1.0651327  0.3924011 -0.2047915  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 43 12 28 32 22 31 35 25 43 35 mean_amr_distance(disk) #>  [1]  1.30998909 -1.96498364 -0.27467513  0.14790199 -0.90854082  0.04225771 #>  [7]  0.46483484 -0.59160798  1.30998909  0.46483484  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    S   31    2 >=16 #> 2   B    S   27  <=1    8 #> 3   C    R   25    2    4 #> 4   D    R   25  <=1    2 #> 5   E    I   31  <=1    2 #> 6   F    S   32  <=1    8 #> 7   G    I   29    2    2 #> 8   H    S   18  <=1    4 #> 9   I    S   28  <=1    4 #> 10  J    R   17  <=1    2 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.90606144 -0.03989270  0.66241774 -0.09230226 -0.32300020  0.19914999 #>  [7]  0.09893189 -0.70734036 -0.22925499 -0.47477055 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 #> 4   D    R   25  <=1    2   -0.7848712 #> 5   E    I   31  <=1    2   -0.7848712 #> 10  J    R   17  <=1    2   -0.7848712 #> 8   H    S   18  <=1    4   -0.3105295 #> 9   I    S   28  <=1    4   -0.3105295 #> 2   B    S   27  <=1    8    0.1638121 #> 6   F    S   32  <=1    8    0.1638121 #> 7   G    I   29    2    2    0.2502272 #> 3   C    R   25    2    4    0.7245688 #> 1   A    S   31    2 >=16    1.6732521  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    R   25    2    4   0.66241774  0.0000000 #> 2   A    S   31    2 >=16   0.90606144  0.2436437 #> 3   F    S   32  <=1    8   0.19914999  0.4632678 #> 4   G    I   29    2    2   0.09893189  0.5634858 #> 5   B    S   27  <=1    8  -0.03989270  0.7023104 #> 6   D    R   25  <=1    2  -0.09230226  0.7547200 #> 7   I    S   28  <=1    4  -0.22925499  0.8916727 #> 8   E    I   31  <=1    2  -0.32300020  0.9854179 #> 9   J    R   17  <=1    2  -0.47477055  1.1371883 #> 10  H    S   18  <=1    4  -0.70734036  1.3697581 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 6 036 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 6 036 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 6 036 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 6 036 Common Microorganism Codes — microorganisms.codes","text":"tibble 6 036 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 6 036 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 6 036 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 6,036 × 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      #> # ℹ 6,026 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 ~19 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) ~26 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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_colour_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I =   \"#F6D55C\", R = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_fill_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\",   R = \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#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(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#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(S   = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R = \"#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(S = \"#3CAEA3\", SDD =   \"#8FD6C4\", I = \"#F6D55C\", R = \"#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. normally need add scale functions plot, applied automatically plotting values class mic. manually added though, allow rescale MIC range 'inside' 'outside' range required, provide option retain operators MIC values (>=). Missing intermediate log2 levels always 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). normally need add scale functions plot, applied automatically plotting values class sir. default, translate S//R values interpretative text (\"Susceptible\", \"Resistant\", etc.) 28 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\")) {   autoplot(some_mic_values, mo = \"Staph aureus\", ab = \"Ceftaroline\", guideline = \"CLSI\") }   if (require(\"ggplot2\")) {   # support for 27 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 = \"scale_x_mic() automatically applied\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(keep_operators = \"none\") +     labs(title = \"with scale_x_mic() keeping no 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 = \"grey30\", fill = NA) +     labs(title = \"scale_y_mic() automatically applied\") }  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey30\", 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\")) {   mic_sir_plot <- 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 = \"grey30\") +     geom_jitter(width = 0.25)     labs(title = \"scale_y_mic()/scale_colour_sir() automatically applied\")        mic_sir_plot }  if (require(\"ggplot2\")) {   mic_sir_plot +     scale_y_mic(mic_range = c(0.005, 32), name = \"Our MICs!\") +     scale_colour_sir(       language = \"pt\", # Portuguese       name = \"Support in 28 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, skew = \"right\",   severity = 1, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, skew = \"left\",   severity = 1, ...)  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(). Can length size. ab character can coerced valid antimicrobial drug code .ab(). skew Direction skew MIC disk values, either \"right\" \"left\". left-skewed distribution majority data right. severity Skew severity; higher values increase skewedness. Default 2; use 0 prevent skewedness. ... 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":"Internally, MIC disk zone values sampled based clinical breakpoints defined clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument. MICs sampled log2 scale disks linearly, using weighted probabilities. weights based skew severity arguments: skew = \"right\" places emphasis lower MIC higher disk values. skew = \"left\" places emphasis higher MIC lower disk values. severity controls exponential bias applied.","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.008    0.016    0.25     0.5      0.5      1        0.002    0.002    #>  [9] 0.001    0.064    0.002    0.064    <=0.0002 1        4        0.016    #> [17] 0.008    8        0.25     0.5      0.5      0.032    4        0.008    #> [25] 0.004    random_disk(25) #> Class 'disk' #>  [1] 39 47 20 36 18 44 43 25 28 26 44 36 42  8 28 44 31 29 49 30 28 39 49 25 49 random_sir(25) #> Class 'sir' #>  [1] I R S R S R R S I I I S R R S I I S I I I S S R S  # add more skewedness, make more realistic by setting a bug and/or drug: disks <- random_disk(100, severity = 2, mo = \"Escherichia coli\", ab = \"CIP\") plot(disks)  # `plot()` and `ggplot2::autoplot()` allow for coloured bars if `mo` and `ab` are set plot(disks, mo = \"Escherichia coli\", ab = \"CIP\", guideline = \"CLSI 2025\")   # \\donttest{ random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 1      8      0.004  4      0.032  8      0.016  8      0.001  0.0002 #> [11] 0.002  0.004  0.001  0.0005 0.0001 0.002  0.125  >=64   0.002  0.0005 #> [21] 0.001  0.0002 0.0005 0.001  0.0005 random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] <=0.5 <=0.5 <=0.5 1     <=0.5 <=0.5 <=0.5 <=0.5 <=0.5 <=0.5 1     1     #> [13] <=0.5 <=0.5 <=0.5 <=0.5 1     <=0.5 <=0.5 <=0.5 <=0.5 1     1     <=0.5 #> [25] <=0.5 random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] >=2 1   1   1   >=2 >=2 >=2 1   >=2 1   1   >=2 1   1   1   >=2 1   1   1   #> [20] >=2 >=2 1   1   1   1    random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 28 12 30 26  9 34 30 19 32 31 33 34 30 19 15 24 18 34 12 32 29 33 29 32 17 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 18 15 19 13 22 20 22 13 18 14 19 13 12 22 20 21 12 20 18 19 20 22 18 17 20 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 21 31 27 28 30 34 16 32 28 25 25 23 29 26 24 28 27 33 30 19 30 22 27 22 32 # }"},{"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) } #> Warning: Removed 8 rows containing missing values or values outside the scale range #> (`geom_ribbon()`).   # 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) } #> Warning: Removed 16 rows containing missing values or values outside the scale range #> (`geom_ribbon()`).  # }"},{"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.01429035"},{"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), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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 28 supported languages English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). 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-301","dir":"Changelog","previous_headings":"","what":"AMR 3.0.1","title":"AMR 3.0.1","text":"CRAN release: 2025-09-20 bugfix release following release v3.0.0 June 2025.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-3-0-1","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.1","text":"MIC scale functions (scale_y_mic()) now applied automatically plotting values class mic SIR scale functions (scale_x_sir()) now applied automatically plotting values class sir Fixed bug antibiogram() antimicrobials set Fixed bug antibiogram() allow column names containing + character (#222) Fixed bug .ab() antimicrobial codes number preceded space Fixed bug eucast_rules() using specific custom rules Fixed bug .sir() allow tidyselect language (#220) Fixed bug .sir() pick right breakpoint uti = FALSE (#216) Fixed bug ggplot_sir() using combine_SI = FALSE (#213) Fixed bug mdro() make sure genes specified arguments acknowledged Fixed bug antimicrobials data set remove statins (#229) Fixed bug microorganisms data set MycoBank IDs synonyms (#233) Fixed ATC J01CR05 map piperacillin/tazobactam rather piperacillin/sulbactam (#230) Fixed skimmers (skimr package) class ab, sir, disk (#234) Fixed plotting contain separate colour SDD (susceptible dose-dependent) (#223) Fixed specific Dutch translations antimicrobials Added warning .ab() input resembles antiviral codes names (#232) Added reasons verbose output mdro() (#227) Added names age_groups() custom names can given (#215) Added note .sir() make explicit higher-level taxonomic breakpoints used (#218) Added antibiotic codes Comprehensive Antibiotic Resistance Database (CARD) antimicrobials data set (#225) Updated Fosfomycin antibiotic class Phosphonics (#225) Updated random_mic() random_disk() set skewedness distribution allow multiple microorganisms","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-300","dir":"Changelog","previous_headings":"","what":"AMR 3.0.0","title":"AMR 3.0.0","text":"CRAN release: 2025-06-02 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-3-0-0","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 3.0.0","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-3-0-0","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 3.0.0","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 antimicrobials, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antimicrobials (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. Added full support 8 new languages: Arabic, Bengali, Hindi, Indonesian, Korean, Swahili, Urdu, Vietnamese. AMR package now available 28 languages. 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-3-0-0","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.0","text":"Support parallel computing greatly improve speed 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 antimicrobials antimicrobial groups affected single rule mo_info() now contains extra element rank group_members (contents new mo_group_members() function) Updated ATC codes WHOCC Updated antimicrobial DDDs WHOCC Fix using manual value mo_transform antibiogram() Fixed bug antibiogram() returns empty data set Argument only_sir_columns now defaults TRUE column data set contains class ‘sir’ (functions eucast_rules(), key_antimicrobials(), mdro(), etc.) Added Sensititre codes animals, antimicrobials microorganisms Fix mapping ‘high level’ antimicrobials .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 Verbose Mode (verbose = TRUE) now includes guideline name 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 upport antimicrobial selectors use custom rule (custom_mdro_guideline()) Added console colours support sir class Positron","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"other-3-0-0","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 3.0.0","text":"New website domain: https://amr--r.org! old domain 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-3-0-0","dir":"Changelog","previous_headings":"","what":"Older Versions","title":"AMR 3.0.0","text":"changelog contains changes AMR v3.0 (June 2025) later. prior v2 versions, please see v2 archive. prior v1 versions, please see v1 archive.","code":""}]