From 0b0a4b6a51b314192d24f8f4e097e49a7047a34e Mon Sep 17 00:00:00 2001
From: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Date: Mon, 20 May 2024 19:35:19 +0000
Subject: [PATCH] cli-147-2196

---
 404.html                                      |   2 +-
 LICENSE-text.html                             |   2 +-
 articles/AMR.html                             |   2 +-
 articles/EUCAST.html                          |   2 +-
 articles/MDR.html                             |   2 +-
 articles/PCA.html                             |   2 +-
 articles/WHONET.html                          |   2 +-
 .../figure-html/unnamed-chunk-7-1.png         | Bin 62857 -> 62375 bytes
 articles/datasets.html                        |   2 +-
 articles/index.html                           |   2 +-
 articles/other_pkg.html                       |   2 +-
 articles/resistance_predict.html              |   2 +-
 articles/welcome_to_AMR.html                  |   2 +-
 authors.html                                  |   2 +-
 index.html                                    |   2 +-
 news/index.html                               |  17 +-
 pkgdown.yml                                   |   2 +-
 reference/AMR-options.html                    |   2 +-
 reference/AMR.html                            |   2 +-
 reference/Rplot005.png                        | Bin 13381 -> 9042 bytes
 reference/Rplot006.png                        | Bin 13059 -> 9792 bytes
 reference/Rplot007.png                        | Bin 8352 -> 9232 bytes
 reference/Rplot008.png                        | Bin 9042 -> 20259 bytes
 reference/Rplot009.png                        | Bin 9792 -> 8863 bytes
 reference/Rplot010.png                        | Bin 9232 -> 15682 bytes
 reference/Rplot011.png                        | Bin 20259 -> 0 bytes
 reference/Rplot012.png                        | Bin 18185 -> 0 bytes
 reference/Rplot013.png                        | Bin 8863 -> 0 bytes
 reference/WHOCC.html                          |   2 +-
 reference/WHONET.html                         |   2 +-
 reference/ab_from_text.html                   |   2 +-
 reference/ab_property.html                    |   2 +-
 reference/add_custom_antimicrobials.html      |   4 +-
 reference/add_custom_microorganisms.html      |   2 +-
 reference/age.html                            |   2 +-
 reference/age_groups-1.png                    | Bin 44344 -> 43166 bytes
 reference/age_groups.html                     |   2 +-
 reference/antibiogram.html                    |   2 +-
 reference/antibiotic_class_selectors.html     |   2 +-
 reference/antibiotics.html                    |   2 +-
 reference/as.ab.html                          |   2 +-
 reference/as.av.html                          |   2 +-
 reference/as.disk.html                        |  17 +-
 reference/as.mic-2.png                        | Bin 34827 -> 0 bytes
 reference/as.mic-3.png                        | Bin 75979 -> 0 bytes
 reference/as.mic-4.png                        | Bin 74640 -> 0 bytes
 reference/as.mic.html                         |  18 +--
 reference/as.mo.html                          |   2 +-
 reference/as.sir.html                         | 149 +++++++-----------
 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                          |  30 ++--
 reference/custom_eucast_rules.html            |   2 +-
 reference/dosage.html                         |   2 +-
 reference/eucast_rules.html                   |   2 +-
 reference/example_isolates.html               |   2 +-
 reference/example_isolates_unclean.html       |   2 +-
 reference/first_isolate.html                  |   2 +-
 reference/g.test.html                         |   2 +-
 reference/get_episode.html                    |   2 +-
 reference/ggplot_pca.html                     |   2 +-
 reference/ggplot_sir-1.png                    | Bin 30513 -> 29639 bytes
 reference/ggplot_sir-10.png                   | Bin 47008 -> 46444 bytes
 reference/ggplot_sir-2.png                    | Bin 48695 -> 47092 bytes
 reference/ggplot_sir-3.png                    | Bin 47734 -> 46254 bytes
 reference/ggplot_sir-4.png                    | Bin 37412 -> 36825 bytes
 reference/ggplot_sir-5.png                    | Bin 50910 -> 49462 bytes
 reference/ggplot_sir-6.png                    | Bin 35802 -> 34428 bytes
 reference/ggplot_sir-8.png                    | Bin 37191 -> 35782 bytes
 reference/ggplot_sir-9.png                    | Bin 47734 -> 46254 bytes
 reference/ggplot_sir.html                     |   6 +-
 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 27064 -> 0 bytes
 reference/plot-11.png                         | Bin 64884 -> 0 bytes
 reference/plot-12.png                         | Bin 56797 -> 0 bytes
 reference/plot-13.png                         | Bin 27111 -> 0 bytes
 reference/plot-4.png                          | Bin 40277 -> 25157 bytes
 reference/plot-5.png                          | Bin 40137 -> 26567 bytes
 reference/plot-6.png                          | Bin 38447 -> 29775 bytes
 reference/plot-7.png                          | Bin 25157 -> 27064 bytes
 reference/plot-8.png                          | Bin 26567 -> 64884 bytes
 reference/plot-9.png                          | Bin 29775 -> 27111 bytes
 reference/plot.html                           |  22 +--
 reference/proportion.html                     |  38 ++---
 reference/random.html                         |   2 +-
 reference/resistance_predict.html             |   2 +-
 reference/skewness.html                       |   2 +-
 reference/translate.html                      |   2 +-
 search.json                                   |   2 +-
 109 files changed, 194 insertions(+), 241 deletions(-)
 delete mode 100644 reference/Rplot011.png
 delete mode 100644 reference/Rplot012.png
 delete mode 100644 reference/Rplot013.png
 delete mode 100644 reference/as.mic-2.png
 delete mode 100644 reference/as.mic-3.png
 delete mode 100644 reference/as.mic-4.png
 delete mode 100644 reference/plot-10.png
 delete mode 100644 reference/plot-11.png
 delete mode 100644 reference/plot-12.png
 delete mode 100644 reference/plot-13.png

diff --git a/404.html b/404.html
index 08611ff0..8aa9011f 100644
--- a/404.html
+++ b/404.html
@@ -37,7 +37,7 @@
     
     <a class="navbar-brand me-2" href="https://msberends.github.io/AMR/index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 37b718aa..d2eebf3e 100644
--- a/LICENSE-text.html
+++ b/LICENSE-text.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 c311a0aa..ef35a9c8 100644
--- a/articles/AMR.html
+++ b/articles/AMR.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 663e90d5..40802b69 100644
--- a/articles/EUCAST.html
+++ b/articles/EUCAST.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/MDR.html b/articles/MDR.html
index d0827180..0cc0909f 100644
--- a/articles/MDR.html
+++ b/articles/MDR.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 4c575620..76297c9c 100644
--- a/articles/PCA.html
+++ b/articles/PCA.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 7f98f665..a75128e7 100644
--- a/articles/WHONET.html
+++ b/articles/WHONET.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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_files/figure-html/unnamed-chunk-7-1.png b/articles/WHONET_files/figure-html/unnamed-chunk-7-1.png
index eecb7fc2063937be65108673f02b037113cedff2..d4eb752ce8a69a33dd3f8c4988c4a1a8d0ef95b4 100644
GIT binary patch
delta 46701
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

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

diff --git a/articles/datasets.html b/articles/datasets.html
index 7db84a2b..e8c6ced9 100644
--- a/articles/datasets.html
+++ b/articles/datasets.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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/index.html b/articles/index.html
index 2816d439..9f2e43fd 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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/other_pkg.html b/articles/other_pkg.html
index bb67c41d..0f10fb21 100644
--- a/articles/other_pkg.html
+++ b/articles/other_pkg.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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/resistance_predict.html b/articles/resistance_predict.html
index d3237a19..bf6d5171 100644
--- a/articles/resistance_predict.html
+++ b/articles/resistance_predict.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/welcome_to_AMR.html b/articles/welcome_to_AMR.html
index 3b416cae..0af06152 100644
--- a/articles/welcome_to_AMR.html
+++ b/articles/welcome_to_AMR.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 7c563b26..b77bdfd8 100644
--- a/authors.html
+++ b/authors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 ab43855f..46fde140 100644
--- a/index.html
+++ b/index.html
@@ -39,7 +39,7 @@
     
     <a class="navbar-brand me-2" href="index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 ab82a541..c92e2f07 100644
--- a/news/index.html
+++ b/news/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -159,18 +159,18 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="2.1.1.9031" id="amr-2119031">AMR 2.1.1.9031<a class="anchor" aria-label="anchor" href="#amr-2119031"></a></h2>
+<h2 class="pkg-version" data-toc-text="2.1.1.9032" id="amr-2119032">AMR 2.1.1.9032<a class="anchor" aria-label="anchor" href="#amr-2119032"></a></h2>
 <p><em>(this beta version will eventually become v3.0. We’re happy to reach a new major milestone soon, which will be all about the new One Health support!)</em></p>
 <div class="section level5">
-<h5 id="a-new-milestone-one-health-support--human--veterinary--environmental-2-1-1-9031">A New Milestone: One Health Support (= Human + Veterinary + Environmental)<a class="anchor" aria-label="anchor" href="#a-new-milestone-one-health-support--human--veterinary--environmental-2-1-1-9031"></a></h5>
+<h5 id="a-new-milestone-one-health-support--human--veterinary--environmental-2-1-1-9032">A New Milestone: One Health Support (= Human + Veterinary + Environmental)<a class="anchor" aria-label="anchor" href="#a-new-milestone-one-health-support--human--veterinary--environmental-2-1-1-9032"></a></h5>
 <p>This package now supports not only tools for AMR data analysis in clinical settings, but also for veterinary and environmental microbiology. This was made possible through a collaboration with the <a href="https://www.upei.ca/avc" class="external-link">University of Prince Edward Island</a>, Canada. To celebrate this great improvement of the package, we also updated the package logo to reflect this change.</p>
 </div>
 <div class="section level3">
-<h3 id="breaking-2-1-1-9031">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9031"></a></h3>
+<h3 id="breaking-2-1-1-9032">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9032"></a></h3>
 <ul><li>Removed all functions and references that used the deprecated <code>rsi</code> class, which were all replaced with their <code>sir</code> equivalents over a year ago</li>
 </ul></div>
 <div class="section level3">
-<h3 id="new-2-1-1-9031">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9031"></a></h3>
+<h3 id="new-2-1-1-9032">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9032"></a></h3>
 <ul><li>One Health implementation
 <ul><li>Function <code><a href="../reference/as.sir.html">as.sir()</a></code> now has extensive support for animal breakpoints from CLSI. Use <code>breakpoint_type = "animal"</code> and set the <code>host</code> argument to a variable that contains animal species names.</li>
 <li>The <code>clinical_breakpoints</code> data set contains all these breakpoints, and can be downloaded on our <a href="https://msberends.github.io/AMR/articles/datasets.html">download page</a>.</li>
@@ -187,8 +187,9 @@
 <li>Function <code><a href="../reference/mo_property.html">mo_group_members()</a></code> to retrieve the member microorganisms. For example, <code>mo_group_members("Strep group C")</code> returns a vector of all microorganisms that are in that group.</li>
 </ul></div>
 <div class="section level3">
-<h3 id="changed-2-1-1-9031">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9031"></a></h3>
-<ul><li>For MICs:
+<h3 id="changed-2-1-1-9032">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9032"></a></h3>
+<ul><li>For SIR interpretation, it is now possible to use column names for argument <code>ab</code> and <code>mo</code>: <code>as.sir(..., ab = "column1", mo = "column2")</code>. This greatly improves the flexibility for users.</li>
+<li>For MICs:
 <ul><li>Added as valid levels: 4096, 6 powers of 0.0625, and 5 powers of 192 (192, 384, 576, 768, 960)</li>
 <li>Added new argument <code>keep_operators</code> to <code><a href="../reference/as.mic.html">as.mic()</a></code>. This can be <code>"all"</code> (default), <code>"none"</code>, or <code>"edges"</code>. This argument is also available in the new <code><a href="../reference/as.mic.html">limit_mic_range()</a></code> and <code>scale_*_mic()</code> functions.</li>
 <li>Comparisons of MIC values are now more strict. For example, <code>&gt;32</code> is higher than (and never equal to) <code>32</code>. Thus, <code>as.mic("&gt;32") == as.mic(32)</code> now returns <code>FALSE</code>, and <code>as.mic("&gt;32") &gt; as.mic(32)</code> now returns <code>TRUE</code>.</li>
@@ -205,7 +206,7 @@
 <li>Improved overall algorithm of <code><a href="../reference/as.ab.html">as.ab()</a></code> for better performance and accuracy</li>
 </ul></div>
 <div class="section level3">
-<h3 id="other-2-1-1-9031">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9031"></a></h3>
+<h3 id="other-2-1-1-9032">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9032"></a></h3>
 <ul><li>Added Jordan Stull, Matthew Saab, and Javier Sanchez as contributors, to thank them for their valuable input</li>
 </ul></div>
 </div>
diff --git a/pkgdown.yml b/pkgdown.yml
index 0f305fc4..757cbbfa 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -11,7 +11,7 @@ articles:
   resistance_predict: resistance_predict.html
   welcome_to_AMR: welcome_to_AMR.html
   WHONET: WHONET.html
-last_built: 2024-05-20T17:01Z
+last_built: 2024-05-20T19:32Z
 urls:
   reference: https://msberends.github.io/AMR/reference
   article: https://msberends.github.io/AMR/articles
diff --git a/reference/AMR-options.html b/reference/AMR-options.html
index 811f2511..77261b4c 100644
--- a/reference/AMR-options.html
+++ b/reference/AMR-options.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 1e2edfff..07bf5fe2 100644
--- a/reference/AMR.html
+++ b/reference/AMR.html
@@ -24,7 +24,7 @@ The AMR package is available in English, Chinese, Czech, Danish, Dutch, Finnish,
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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/Rplot005.png b/reference/Rplot005.png
index d466911db2d98c727e4f0ef4cc830f218a343d29..302659c9d4fe6a3be18ab93d1c8df68f61f1a698 100644
GIT binary patch
literal 9042
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

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

diff --git a/reference/Rplot006.png b/reference/Rplot006.png
index 8d414b01e32b9f577204de973f021496de7f601b..70c012484e2a8df86c7a1248c3684aa7aca12794 100644
GIT binary patch
literal 9792
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
bD!#G35$U)*d6F%QfQR;_>lX_y+<NqHP1wOe

literal 13059
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
Ny0?vPRcblD_+K3J+C~5X

diff --git a/reference/Rplot007.png b/reference/Rplot007.png
index 84cda4210f0f3e33e2cab21b08e85dd74c04d05f..8325b81e118c4aa47d9cdc9928218c929d8b5500 100644
GIT binary patch
literal 9232
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

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

diff --git a/reference/Rplot008.png b/reference/Rplot008.png
index 302659c9d4fe6a3be18ab93d1c8df68f61f1a698..a34071ba20a03031a8b9d4aab12c0248ac4c0d16 100644
GIT binary patch
literal 20259
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
bu}_}RmGQcY<+vAl)}4f?tVov7tM~s8Za%_i

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

diff --git a/reference/Rplot009.png b/reference/Rplot009.png
index 70c012484e2a8df86c7a1248c3684aa7aca12794..560ee769ccd79883db132259d1ff3e1be82e2925 100644
GIT binary patch
literal 8863
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
Ml7R;1!u3D?13fNXUH||9

literal 9792
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
bD!#G35$U)*d6F%QfQR;_>lX_y+<NqHP1wOe

diff --git a/reference/Rplot010.png b/reference/Rplot010.png
index 8325b81e118c4aa47d9cdc9928218c929d8b5500..3d2af5fa33f7794478249b8d683d15628a4f0a5f 100644
GIT binary patch
literal 15682
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
S04^m20@pXbSbqM-z5fMA%@dFS

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

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

literal 20259
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
bu}_}RmGQcY<+vAl)}4f?tVov7tM~s8Za%_i

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

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

diff --git a/reference/Rplot013.png b/reference/Rplot013.png
deleted file mode 100644
index 560ee769ccd79883db132259d1ff3e1be82e2925..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8863
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
Ml7R;1!u3D?13fNXUH||9

diff --git a/reference/WHOCC.html b/reference/WHOCC.html
index 2ca04ef5..5026c513 100644
--- a/reference/WHOCC.html
+++ b/reference/WHOCC.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 c6986d5d..55d6936a 100644
--- a/reference/WHONET.html
+++ b/reference/WHONET.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 bd0d35cf..72311297 100644
--- a/reference/ab_from_text.html
+++ b/reference/ab_from_text.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 48a5f20d..5fb0e8c5 100644
--- a/reference/ab_property.html
+++ b/reference/ab_property.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 db15c76e..95e24d45 100644
--- a/reference/add_custom_antimicrobials.html
+++ b/reference/add_custom_antimicrobials.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -209,7 +209,7 @@
 <span class="r-in"><span>  <span class="fu"><a href="as.ab.html">as.ab</a></span><span class="op">(</span><span class="st">"testab"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">)</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'ab'</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] FUS</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> [1] &lt;NA&gt;</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># now add a custom entry - it will be considered by as.ab() and</span></span></span>
 <span class="r-in"><span><span class="co"># all ab_*() functions</span></span></span>
diff --git a/reference/add_custom_microorganisms.html b/reference/add_custom_microorganisms.html
index f1b611f3..49058ab2 100644
--- a/reference/add_custom_microorganisms.html
+++ b/reference/add_custom_microorganisms.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 f4ec4fce..cd19c668 100644
--- a/reference/age.html
+++ b/reference/age.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/age_groups-1.png b/reference/age_groups-1.png
index e6938926bdaac4fec175f217f12dee23352dee37..376444dd7b2734a2e7fe255edb3ed7615b19c77c 100644
GIT binary patch
literal 43166
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

literal 44344
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
F1OPw;q`&|G

diff --git a/reference/age_groups.html b/reference/age_groups.html
index 3621c8fd..a43f3010 100644
--- a/reference/age_groups.html
+++ b/reference/age_groups.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 fa20260d..b14689d1 100644
--- a/reference/antibiogram.html
+++ b/reference/antibiogram.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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/antibiotic_class_selectors.html b/reference/antibiotic_class_selectors.html
index 74cd94d8..6d7eada3 100644
--- a/reference/antibiotic_class_selectors.html
+++ b/reference/antibiotic_class_selectors.html
@@ -12,7 +12,7 @@ In short, if you have a column name that resembles an antimicrobial drug, it wil
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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/antibiotics.html b/reference/antibiotics.html
index 528df417..ab1723c2 100644
--- a/reference/antibiotics.html
+++ b/reference/antibiotics.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 9292dd90..b2a4a9ae 100644
--- a/reference/as.ab.html
+++ b/reference/as.ab.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 4be3b9c2..92c9a536 100644
--- a/reference/as.av.html
+++ b/reference/as.av.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 fc9c4a57..a45e0235 100644
--- a/reference/as.disk.html
+++ b/reference/as.disk.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -244,7 +244,8 @@
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'ampicillin' (AMP), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'ampicillin' (AMP) (AMP, ampicillin),</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> [1] R</span>
@@ -255,17 +256,13 @@
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'AMP' (ampicillin), EUCAST</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'AMP', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'CIP' (ciprofloxacin), EUCAST</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'CIP', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'GEN' (gentamicin), EUCAST</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'GEN', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'TOB' (tobramycin), EUCAST</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'TOB', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism AMP  CIP GEN TOB</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli   S &lt;NA&gt;   S   S</span>
diff --git a/reference/as.mic-2.png b/reference/as.mic-2.png
deleted file mode 100644
index f045b5f386377c8bf673d54eea2f8e4e1b5d993c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 34827
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
Ks=VNN@4o=B_}PU3

diff --git a/reference/as.mic-3.png b/reference/as.mic-3.png
deleted file mode 100644
index fad69a68a40981e742f57bac9451a0cfc48783fa..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

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

diff --git a/reference/as.mic-4.png b/reference/as.mic-4.png
deleted file mode 100644
index adfa5c8b956cee70475edbfcc1574c98d063bfee..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 74640
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%0Dfm!
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

diff --git a/reference/as.mic.html b/reference/as.mic.html
index 3abdcd4d..11fdb504 100644
--- a/reference/as.mic.html
+++ b/reference/as.mic.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -291,7 +291,7 @@
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMX' (amoxicillin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMX', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for amoxicillin (AMX) in Streptococcus</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      pneumoniae - assuming body site 'Meningitis'.</span>
@@ -307,27 +307,23 @@
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMX' (amoxicillin), EUCAST 2023...</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for amoxicillin (AMX) in Streptococcus</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>      pneumoniae - assuming body site 'Meningitis'.</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> [1] S R R R</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMX', EUCAST 2023...</span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 4, 1</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># plot MIC values, see ?plot</span></span></span>
 <span class="r-in"><span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">mic_data</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="as.mic-1.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
-<span class="r-plt img"><img src="as.mic-2.png" alt="" width="700" height="433"></span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 9, 1</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="as.mic-3.png" alt="" width="700" height="433"></span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 9, 1</span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span>, language <span class="op">=</span> <span class="st">"nl"</span><span class="op">)</span> <span class="co"># Dutch</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="as.mic-4.png" alt="" width="700" height="433"></span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 9, 1</span>
 </code></pre></div>
     </div>
   </main><aside class="col-md-3"><nav id="toc"><h2>On this page</h2>
diff --git a/reference/as.mo.html b/reference/as.mo.html
index f9d6dae0..9c6e9bac 100644
--- a/reference/as.mo.html
+++ b/reference/as.mo.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 08d6256d..553bdc30 100644
--- a/reference/as.sir.html
+++ b/reference/as.sir.html
@@ -24,7 +24,7 @@ All breakpoints used for interpretation are available in our clinical_breakpoint
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -280,11 +280,11 @@ All breakpoints used for interpretation are available in our clinical_breakpoint
 
 
 <dt>mo</dt>
-<dd><p>any (vector of) text that can be coerced to valid microorganism codes with <code><a href="as.mo.html">as.mo()</a></code>, can be left empty to determine it automatically</p></dd>
+<dd><p>a vector (or column name) with <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a>s that can be coerced to valid microorganism codes with <code><a href="as.mo.html">as.mo()</a></code>, can be left empty to determine it automatically</p></dd>
 
 
 <dt>ab</dt>
-<dd><p>any (vector of) text that can be coerced to a valid antimicrobial drug code with <code><a href="as.ab.html">as.ab()</a></code></p></dd>
+<dd><p>a vector (or column name) with <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a>s that can be coerced to a valid antimicrobial drug code with <code><a href="as.ab.html">as.ab()</a></code></p></dd>
 
 
 <dt>guideline</dt>
@@ -576,23 +576,21 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: column 'AMP' (ampicillin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: column 'AMP', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: column 'CIP' (ciprofloxacin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: column 'CIP', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      - assuming body site 'Non-meningitis'.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'GEN' (gentamicin), EUCAST</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'GEN', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'TOB' (tobramycin), EUCAST</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: column 'TOB', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
@@ -604,22 +602,13 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># return a 'logbook' about the results:</span></span></span>
 <span class="r-in"><span><span class="fu">sir_interpretation_history</span><span class="op">(</span><span class="op">)</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 13 × 14</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>    datetime            index ab_user    mo_user    ab   mo                input</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;ab&gt;</span> <span style="color: #949494; font-style: italic;">&lt;mo&gt;</span>              <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> 2024-05-20 <span style="color: #949494;">17:02:01</span>     1 TOB        Escherich… TOB  B_[ORD]_ENTRBCTR 16    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 2</span> 2024-05-20 <span style="color: #949494;">17:02:00</span>     1 GEN        Escherich… GEN  B_[ORD]_ENTRBCTR 18    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> 2024-05-20 <span style="color: #949494;">17:02:00</span>     1 CIP        Escherich… CIP  B_[ORD]_ENTRBCTR  0.256</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> 2024-05-20 <span style="color: #949494;">17:02:00</span>     1 AMP        Escherich… AMP  B_[ORD]_ENTRBCTR  8    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> 2024-05-20 <span style="color: #949494;">17:01:56</span>     1 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      0.01 </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> 2024-05-20 <span style="color: #949494;">17:01:56</span>     2 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      2    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> 2024-05-20 <span style="color: #949494;">17:01:56</span>     3 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      4    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> 2024-05-20 <span style="color: #949494;">17:01:56</span>     4 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      8    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> 2024-05-20 <span style="color: #949494;">17:01:55</span>     1 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      2    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> 2024-05-20 <span style="color: #949494;">17:01:55</span>     1 TOB        Escherich… TOB  B_[ORD]_ENTRBCTR 16    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">11</span> 2024-05-20 <span style="color: #949494;">17:01:55</span>     1 GEN        Escherich… GEN  B_[ORD]_ENTRBCTR 18    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">12</span> 2024-05-20 <span style="color: #949494;">17:01:55</span>     1 AMP        Escherich… AMP  B_[ORD]_ENTRBCTR 20    </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">13</span> 2024-05-20 <span style="color: #949494;">17:01:55</span>     1 ampicillin Strep pneu AMP  B_STRPT_PNMN     18    </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 4 × 14</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>   datetime            index ab_user mo_user        ab   mo                input</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;ab&gt;</span> <span style="color: #949494; font-style: italic;">&lt;mo&gt;</span>              <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 2024-05-20 <span style="color: #949494;">19:33:13</span>     1 TOB     Escherichia c… TOB  B_[ORD]_ENTRBCTR 16    </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 2024-05-20 <span style="color: #949494;">19:33:13</span>     1 GEN     Escherichia c… GEN  B_[ORD]_ENTRBCTR 18    </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> 2024-05-20 <span style="color: #949494;">19:33:12</span>     1 CIP     Escherichia c… CIP  B_[ORD]_ENTRBCTR  0.256</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 2024-05-20 <span style="color: #949494;">19:33:12</span>     1 AMP     Escherichia c… AMP  B_[ORD]_ENTRBCTR  8    </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 7 more variables: outcome &lt;sir&gt;, method &lt;chr&gt;, breakpoint_S_R &lt;chr&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   guideline &lt;chr&gt;, host &lt;chr&gt;, ref_table &lt;chr&gt;, uti &lt;lgl&gt;</span></span>
 <span class="r-in"><span></span></span>
@@ -634,7 +623,7 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP', EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ampicillin (AMP) in Streptococcus</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      pneumoniae - assuming body site 'Non-meningitis'.</span>
@@ -651,7 +640,8 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'ampicillin' (AMP), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'ampicillin' (AMP) (AMP, ampicillin),</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Class 'sir'</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> [1] R</span>
@@ -666,7 +656,7 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-in"><span>  <span class="va">df</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span> <span class="fu"><a href="https://dplyr.tidyverse.org/reference/mutate.html" class="external-link">mutate</a></span><span class="op">(</span><span class="fu"><a href="https://dplyr.tidyverse.org/reference/across.html" class="external-link">across</a></span><span class="op">(</span><span class="va">AMP</span><span class="op">:</span><span class="va">TOB</span>, <span class="va">as.sir</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span>  <span class="va">df</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
-<span class="r-in"><span>    <span class="fu"><a href="https://dplyr.tidyverse.org/reference/mutate_all.html" class="external-link">mutate_at</a></span><span class="op">(</span><span class="fu"><a href="https://dplyr.tidyverse.org/reference/vars.html" class="external-link">vars</a></span><span class="op">(</span><span class="va">AMP</span><span class="op">:</span><span class="va">TOB</span><span class="op">)</span>, <span class="va">as.sir</span>, mo <span class="op">=</span> <span class="va">.</span><span class="op">$</span><span class="va">microorganism</span><span class="op">)</span></span></span>
+<span class="r-in"><span>    <span class="fu"><a href="https://dplyr.tidyverse.org/reference/mutate_all.html" class="external-link">mutate_at</a></span><span class="op">(</span><span class="fu"><a href="https://dplyr.tidyverse.org/reference/vars.html" class="external-link">vars</a></span><span class="op">(</span><span class="va">AMP</span><span class="op">:</span><span class="va">TOB</span><span class="op">)</span>, <span class="va">as.sir</span>, mo <span class="op">=</span> <span class="st">"microorganism"</span><span class="op">)</span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span>  <span class="co"># to include information about urinary tract infections (UTI)</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>
@@ -690,14 +680,14 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      - assuming body site 'Non-meningitis'.</span>
@@ -705,25 +695,25 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      - assuming body site 'Non-meningitis'.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' (gentamicin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' (tobramycin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
@@ -732,14 +722,14 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      - assuming body site 'Non-meningitis'.</span>
@@ -747,25 +737,25 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      - assuming body site 'Non-meningitis'.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' (gentamicin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' (tobramycin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
@@ -774,25 +764,25 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      - assuming body site 'Non-meningitis'.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' (gentamicin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' (tobramycin) based on column</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> 'microorganism', EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
@@ -801,21 +791,25 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' (ciprofloxacin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      - assuming body site 'Non-meningitis'.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' (gentamicin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      set which isolates are from urine. See ?as.sir.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' (tobramycin), EUCAST 2023...</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism',</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> EUCAST 2023...</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>  NOTE </span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>      Escherichia coli - assuming an unspecified body site. Use argument uti to</span>
@@ -824,31 +818,8 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: column 'NIT' (nitrofurantoin), EUCAST 2023...</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> ℹ Assuming value "urine" in column 'specimen' reflects a urinary tract</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   infection.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   Use as.sir(uti = FALSE) to prevent this.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: column 'NIT' (nitrofurantoin), EUCAST 2023...</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   all the details of the breakpoint interpretations. Note that some</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   microorganisms might not have breakpoints for each antimicrobial drug in</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>   EUCAST 2023.</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'AMP' (ampicillin), EUCAST 2023...</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: 'CIP' (ciprofloxacin), EUCAST 2023...</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'GEN' (gentamicin), EUCAST 2023...</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting disk diffusion zones: 'TOB' (tobramycin), EUCAST 2023...</span>
-<span class="r-msg co"><span class="r-pr">#&gt;</span>  OK </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>      microorganism AMP  CIP GEN TOB ERY</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 1 Escherichia coli   S &lt;NA&gt;   S   S   R</span>
+<span class="r-msg co"><span class="r-pr">#&gt;</span> Interpreting MIC values: column 'NIT', EUCAST 2023...</span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 2, 1</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># For CLEANING existing SIR values ------------------------------------</span></span></span>
 <span class="r-in"><span></span></span>
diff --git a/reference/atc_online.html b/reference/atc_online.html
index 980104c1..8fccf083 100644
--- a/reference/atc_online.html
+++ b/reference/atc_online.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 4fcee7d1..41fc4b61 100644
--- a/reference/av_from_text.html
+++ b/reference/av_from_text.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 6d5385ef..4d6bba56 100644
--- a/reference/av_property.html
+++ b/reference/av_property.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 30eff86a..7d010931 100644
--- a/reference/availability.html
+++ b/reference/availability.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 b62eecf7..00f4f945 100644
--- a/reference/bug_drug_combinations.html
+++ b/reference/bug_drug_combinations.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 6ad6c2e1..193aee11 100644
--- a/reference/clinical_breakpoints.html
+++ b/reference/clinical_breakpoints.html
@@ -16,7 +16,7 @@ Use as.sir() to transform MICs or disks measurements to SIR values."><meta prope
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 4e86e835..2db801d7 100644
--- a/reference/count.html
+++ b/reference/count.html
@@ -12,7 +12,7 @@ count_resistant() should be used to count resistant isolates, count_susceptible(
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -377,27 +377,21 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-in"><span><span class="op">}</span></span></span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB'</span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin)</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 18 × 4</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 12 × 4</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>    ward       antibiotic interpretation value</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>  <span style="color: #BCBCBC;">*</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;ord&gt;</span>          <span style="color: #949494; font-style: italic;">&lt;int&gt;</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> Clinical   AMX        SI               357</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 2</span> Clinical   AMX        R                487</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> Clinical   AMX        <span style="color: #BB0000;">NA</span>                 0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> Clinical   CIP        SI               741</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> Clinical   CIP        R                128</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> Clinical   CIP        <span style="color: #BB0000;">NA</span>                 0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> ICU        AMX        SI               158</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> ICU        AMX        R                270</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> ICU        AMX        <span style="color: #BB0000;">NA</span>                 0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> ICU        CIP        SI               362</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">11</span> ICU        CIP        R                 85</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">12</span> ICU        CIP        <span style="color: #BB0000;">NA</span>                 0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">13</span> Outpatient AMX        SI                31</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">14</span> Outpatient AMX        R                 47</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">15</span> Outpatient AMX        <span style="color: #BB0000;">NA</span>                 0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">16</span> Outpatient CIP        SI                78</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">17</span> Outpatient CIP        R                 15</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">18</span> Outpatient CIP        <span style="color: #BB0000;">NA</span>                 0</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> Clinical   CIP        SI               741</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> Clinical   CIP        R                128</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> ICU        AMX        SI               158</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> ICU        AMX        R                270</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> ICU        CIP        SI               362</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> ICU        CIP        R                 85</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> Outpatient AMX        SI                31</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> Outpatient AMX        R                 47</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">11</span> Outpatient CIP        SI                78</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">12</span> Outpatient CIP        R                 15</span>
 <span class="r-in"><span><span class="co"># }</span></span></span>
 </code></pre></div>
     </div>
diff --git a/reference/custom_eucast_rules.html b/reference/custom_eucast_rules.html
index 6c519850..69f7cc96 100644
--- a/reference/custom_eucast_rules.html
+++ b/reference/custom_eucast_rules.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 6b196d0f..af632995 100644
--- a/reference/dosage.html
+++ b/reference/dosage.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 334337fa..64bac4df 100644
--- a/reference/eucast_rules.html
+++ b/reference/eucast_rules.html
@@ -12,7 +12,7 @@ To improve the interpretation of the antibiogram before EUCAST rules are applied
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 26339c31..7a031b20 100644
--- a/reference/example_isolates.html
+++ b/reference/example_isolates.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 d0dc4083..9e7fb7f0 100644
--- a/reference/example_isolates_unclean.html
+++ b/reference/example_isolates_unclean.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 d7699670..5942c2d7 100644
--- a/reference/first_isolate.html
+++ b/reference/first_isolate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 9da66d46..31088798 100644
--- a/reference/g.test.html
+++ b/reference/g.test.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 58970c2f..cfb7458e 100644
--- a/reference/get_episode.html
+++ b/reference/get_episode.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 07b9dbad..6f1d0f3f 100644
--- a/reference/ggplot_pca.html
+++ b/reference/ggplot_pca.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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-1.png b/reference/ggplot_sir-1.png
index 911bcd575894a6bc18e411aad539502466e87f7f..14fec60f1904c451a91eae0aec3294f814c0fca7 100644
GIT binary patch
literal 29639
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%0ANKY~6iLu_$J4g?ivJ)AFFQr(d_LpE?6$
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

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

diff --git a/reference/ggplot_sir-10.png b/reference/ggplot_sir-10.png
index ea64b9965495ecb4a61263ede3516d87d51301ce..ac02d12feadac0501ab9d59e9c400e1f2302a484 100644
GIT binary patch
delta 28768
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

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

diff --git a/reference/ggplot_sir-2.png b/reference/ggplot_sir-2.png
index 1abeca6a230ae22a94aa4670f1499515e2a1b4cb..765aa31b3a4553d7ff056cfb7b0800dafb4bbcd8 100644
GIT binary patch
literal 47092
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
F{u?R1o+$tT

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

diff --git a/reference/ggplot_sir-3.png b/reference/ggplot_sir-3.png
index c1debfedd5325616471860888132a09e523bdb75..c1201cf69029823ab4caef0d31b74b4866507571 100644
GIT binary patch
literal 46254
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

literal 47734
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
ZOuCI7+wbEY{Jj{!!QS<!QoF$4{s-Mq4>JG&

diff --git a/reference/ggplot_sir-4.png b/reference/ggplot_sir-4.png
index 0adbde7ef053d1c2fd72f6b00dad4f7b0ee66012..6a872bb803b8d2f0dcd26e3e4e5d10c68e09cf62 100644
GIT binary patch
literal 36825
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
F{|!XhqH+KL

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

diff --git a/reference/ggplot_sir-5.png b/reference/ggplot_sir-5.png
index b8b31ec6e2a839ea6a462b7659c1c50cfed2654e..2229bb053d45ac1c6d79fa0be90ddec4ba4ea618 100644
GIT binary patch
literal 49462
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

literal 50910
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
S?OEob_|?l+Cgqo0V*Up&VIhYA

diff --git a/reference/ggplot_sir-6.png b/reference/ggplot_sir-6.png
index 1bedd676f4fe2ba7d525f4ffd407e578b302fc81..8ee9b7b5576ccc1d4cc2e288740f924a2468c0dd 100644
GIT binary patch
literal 34428
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

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

diff --git a/reference/ggplot_sir-8.png b/reference/ggplot_sir-8.png
index baee36aa9ca08af21070221087005383e69742d3..fcdec8137cee4c282627b54b6ea2d066bb6e6186 100644
GIT binary patch
literal 35782
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
KQ;xRvFaHDendkHX

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

diff --git a/reference/ggplot_sir-9.png b/reference/ggplot_sir-9.png
index c1debfedd5325616471860888132a09e523bdb75..c1201cf69029823ab4caef0d31b74b4866507571 100644
GIT binary patch
literal 46254
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

literal 47734
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
ZOuCI7+wbEY{Jj{!!QS<!QoF$4{s-Mq4>JG&

diff --git a/reference/ggplot_sir.html b/reference/ggplot_sir.html
index 4a4d6582..3f5fe0ce 100644
--- a/reference/ggplot_sir.html
+++ b/reference/ggplot_sir.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -413,9 +413,9 @@
 <span class="r-in"><span>    <span class="fu"><a href="https://dplyr.tidyverse.org/reference/select.html" class="external-link">select</a></span><span class="op">(</span><span class="va">age_group</span>, <span class="va">CIP</span><span class="op">)</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
 <span class="r-in"><span>    <span class="fu">ggplot_sir</span><span class="op">(</span>x <span class="op">=</span> <span class="st">"age_group"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>Removed 9 rows containing missing values or values outside the scale range</span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>Removed 6 rows containing missing values or values outside the scale range</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> (`geom_col()`).</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>Removed 9 rows containing missing values or values outside the scale range</span>
+<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>Removed 6 rows containing missing values or values outside the scale range</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> (`geom_text()`).</span>
 <span class="r-plt img"><img src="ggplot_sir-8.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">&amp;&amp;</span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
diff --git a/reference/guess_ab_col.html b/reference/guess_ab_col.html
index abb83f90..a324224e 100644
--- a/reference/guess_ab_col.html
+++ b/reference/guess_ab_col.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 b0b5ac39..b04de14d 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 6a39559d..dc01e249 100644
--- a/reference/intrinsic_resistant.html
+++ b/reference/intrinsic_resistant.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 e779b1f4..a0615bde 100644
--- a/reference/italicise_taxonomy.html
+++ b/reference/italicise_taxonomy.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 bc2ca9dd..fee39059 100644
--- a/reference/join.html
+++ b/reference/join.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 fc975777..530275fe 100644
--- a/reference/key_antimicrobials.html
+++ b/reference/key_antimicrobials.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 2a5291cc..9af18b48 100644
--- a/reference/kurtosis.html
+++ b/reference/kurtosis.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 99224264..1e1501dc 100644
--- a/reference/like.html
+++ b/reference/like.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 476a767e..66fd212e 100644
--- a/reference/mdro.html
+++ b/reference/mdro.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 4f8b1b5d..6d1bc8cd 100644
--- a/reference/mean_amr_distance.html
+++ b/reference/mean_amr_distance.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 a893f4d3..af05fa6c 100644
--- a/reference/microorganisms.codes.html
+++ b/reference/microorganisms.codes.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 4b610a23..700e57f6 100644
--- a/reference/microorganisms.groups.html
+++ b/reference/microorganisms.groups.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 42954add..34ef9a9a 100644
--- a/reference/microorganisms.html
+++ b/reference/microorganisms.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 30b6a952..da004281 100644
--- a/reference/mo_matching_score.html
+++ b/reference/mo_matching_score.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 abad18c4..f6744e42 100644
--- a/reference/mo_property.html
+++ b/reference/mo_property.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 8462f2b8..e852e76e 100644
--- a/reference/mo_source.html
+++ b/reference/mo_source.html
@@ -12,7 +12,7 @@ This is the fastest way to have your organisation (or analysis) specific codes p
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 85055448..5d310bf8 100644
--- a/reference/pca.html
+++ b/reference/pca.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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
deleted file mode 100644
index 594601a7906cbd350a3c4ec41150fe955436ab92..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 27064
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
LsiZ&8U;Ezxv?8lL

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

literal 64884
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%0AB`
zFReQHOHY+S?&YiY4Pk00R&9{UW>_VC_wD76ZcI#_m-d|c{%!@=s*`I)M0eF0OpVR$
z&I>3vGq5#8gR=yO&vEv1wq0ZP72U5J76uF@^$&kB5pD-iK%mi%ueQClt~q27Sn>Xi
zMuW^k#ri((?kC_=f|z^s{rmTSK=RjTSVi5kKX8u2){o=FxNo$j!IiprZGd2_wr^Zx
zuiIO@GDXa<@@3_%UvKYHM|j3UMa<c4hnkK2AFG`&zv<_rVNYU-SzWY<b2zrl=rCUT
zC5co|&yAEX80&GMV!h>_f?X1BU#=f%@C!Jy=0*bw>JLAL>**wVo6em(XUi-l(HS14
zs1z#c)z+r>`ux7A4gHWs|AQC2l7e}9Ea3dzJw20S>(Gw5N>x?$^5^SMs*b1hL_5YU
zhKZQoaIK7CE)<)%F+VgZVlFC9D>lh2q~c2BhEFSV%8p}}SU3|~I&Tqj@yDO-p}Sp!
zPfz?+4;_irX*N<XFaLgm`WSbJ*{Z$HQhyF=BszWz9lYR?*EaQj;J&@tChM$sV!0-+
zUsEkR<$PbgB665(jvF;rjI<nPni&;iJ{yv~v^FKTN1<UUXf{lIVzZ~q&JR-z@0yuK
z?~Ay*pvRQhd45M`gdv(@9i5#t6qSn?pJO_3d9Zj^3MC`t@yBy~TIp^B116LSj?a;-
z(;1kg-1SDU(l$;b<rL_78}s4x;P%{NYYDF+ZH*Gmvq@ay);)i0-;m@Vpv8TNe~it-
z)y&r1r-9=O2OP*AOE^ycLCmLI)n%8fq-E%wHIFa8w3ahrtG;mH2r*_GE!|?IYji>`
zE<0j;^Oh|Zn5>?BtEPD9P6RCtX35gP+U7Joga$^HBj4F*X|R@bBTRlwgI4cBlTDuj
zi&~4CC0yh_um@V!UV+%<c)#|!7~@_pWo$ZgUZa%HcH8nk>m2WGDn8mwtq8!BJem)h
zRh12o+c;e38Bb7mDpm@J$tfun0>epkp0n-f=ty_wv{RibpY>=-W}ADdk#npzI-!mB
z_^^4)FR|s9TD)jE(sm}V#v^1gOx2+HsFQujn5^r?N-H{>0$t}HfesdF+D5^TBj{;w
z+4LFdR*kuQVGb%7;&x4w-Rt^e_*?_+T=UKkwx@08e=pvP{`84~au~bSA>rIhPZ&V+
zxUxH;o4tef{-ewj*&-Xy<Ytzy_Gp>ncvsJy!#x)&uWOyAvx2I$a)zDDcTR6wC&gvW
z#x*PP@E|uj+|k|Ljz0Krgx~|^)dsh_eB{rEvC){AnBF2<+;FJ8U!}Eh_I(~(9T)F`
z1C+mcnpMf{hxeJ*<v7~q7Z#Qn_og?t2xu2N`}I2Pe93<~P7Ts@M#`@wL#4DSejc6`
zl&Cb8n|^_owrLvn2e_5k9f~iB%?!4}PWoAJu<6vhGZ_iiT$YE-xh0IK)kD;*CN}f-
zA6}hXZsBbbiL(QTrxu&PVDYHM<0LVgs7>;PT&B!hw>|`+Ncq6>^P;$Lr-^V%!0f5D
zS?2syZb!qBgZ*a?y2Q2nR=%pd-5vDDv*uO-Qc0RGopExNSJRR<<c`0I8vJ&Jn$^cY
z^giz6#S{mNj~8|G`9~u2?B)7dd+K$o56o@&)9PSRqnlh@s@pB9J0&6%GP(6h-mIs{
zM4MSwr5L?D2b~zk#V06A3>rJM(BCOh9SB)3?YL^5BX9o=jsYv<U5%S+M%3pvtiBbx
z+V3STs}#qh`~SY8^zzk#v9oJya(g^J(|70goXc7DIdsjeg!F-_Gjx9+t-b%%4cYlt
zypbOO|J~5;9HyS2Q=jK5g*Sf}+$Ld->eI|ayO@Si310>0$LETEyj5?_Ow&PZ=^;0<
z+zH9&XyZE^Rx2q)9;BmFJXl#(b?xx>X8{4x#*T&7esl2}DaCx+O8TP@NkjLC4<Alg
zT7GV74GWfVRCB2sHu-IlV!7qiPvdPVu$<Ac{}91xp&FUvF!2qtibR;q*yl+)&))p8
zM?zHNN=vcjtJ+TEsz@)VY$V5Dp?mMxVgr7;FZe23laIJ>XZt{{i%@xAb+GU}Ax~Ot
zE5$yeJN<cI;$VH^O3JgKphK?8YV1|y!?C%J8rN=gTm0-ls_dcLKxdxOxh-lWw)1&N
zh?&1kYp%1+aCa#>X21!-B~0U(vzREwJ|`S3-?_0BJQAJ<xw(tN&0SLZbYhqd7Yc%t
zBlMk7`&{ZTNL0-6(rr_49rKN~dRwjg{;rFxitF=NOCyFk>3#gSZtTl>K0aYz&at4t
zYpYc8ZnNve4)gvq=2@1u>@BILESM$l4t6_JC)lB~ZakOc@1u}<2}bwHwX62IC>2Y-
z?yfzN%o5X{Fv)CUZ*Tu5bag~iWSK$Ie4cWUz=ypI!<$a~iPU9WwVGJmT|E~Tb%SHb
z`FEAWx=T`<Y8~B`2R&H-Y=T0N@vOZ3cXYR-iRcz!merWNP#CYB^%u27JI1C=@L;6k
z;?&{o8!=ty;ON*`=i^t}*>@O0gPk!o<;}G2y$3^snx-Le<g&K5!bp7>?Zu<Vc&ePy
z^87qF*bD7YGU}O?x#G41C-5C8Z0RtNQ>!l5I}!duKjKEyoo0>{my~cmaAR1Z9<TNF
z+rtg$)Um|*N_0&v>!OmAiF5Z?<gf#^xp6Tu-*A10UFPplzCilGDRou>%8;!nVOXOS
zgFlN;#%ZRt!9wf{CfMDcpSFNh`Wo`EiQ+3<H3e|4=~&9(se+60RgAlFfAZum!wQVj
z{0e!*{yIN>7E$}r_d!FT)DsOW*va#Nw%gsy%g<aWR6zfcQ})cvOnt7iIL6p-z~;dS
zAyHF9@50W@lAApW?x7*<4{-k<K;IbI*y6-){{<(nhlB#>|7f~IFAI^(lo|-aG4UYU
zPs8vKZ?<HM9@@46-Xr%wN6}E=-ea3Jszx^y84+;}QnQI-Nhv9gf`S6ejVcW&-v%MV
zyWdRbH)43>#x*2Sls@*hDIm8oKk}@5RiI;C3wMey*vK6OLZD;Xy0syt6LuT@JRIuu
z_h*o?ucm+${8TmQmPxBDmzJye=IA;!n!L=T#^cFiy%GQEenlk@eJarXl8LYZ{#%9n
zCeB1FvQ^M~FBnY?Q7L^b&2kf5HPNxheHW-#=0j?|bXtN|()__0D6OT%3c_mxUWb-W
zVP#^T=MKRi!xNa%ss<wkS?`9#ykn7Z14%<6-M#`~TK8Kz-RkTzavhswjqy*I^-Snn
z{i`+Jm;O7YFZ3}6`(7!dr}Zv$#=!>flT~<SFB5z!t6sD9kApRvh)-*=+;1y8G_G%6
zzU1vJuze&p`0@DPuI9dh^p%X_8C?o<8w@KQ|J-Jq-dOGUUAd#zhL0iJeu<IJ`8UT6
zjy~t#fe!1Wr8adfZ-_Pjq<`7{@Z;#H<v>dgi>x>6SGY9vs%oH%IUlK@s;<18+&8ea
z?may>sZBFSw9Ti4wr?CAq${SAG;2PVwSRk~NvcDCAWuM<0p>`_PiQ8;c(K`YyTCW2
zQe<gF5}d<5gMN4G*l_VzR%p(BM8~$C^FdvjptQ7feZ+2fw9SlNP*G`9V~dE4gw<Eb
z7nDfq6q|{whqoWqKY#wbw2n@Q_8iT)pHG9y59kYjVL>}2IHM;UpPt#}qG7``qRz6$
z4R4$jwO{ag&tJWIg!RydSNo#w`jPD$5AXEK>=WkZUI*@<iOenQFK?}y_A_muTHOnW
zPLrTR6gO1s^a26`d}I9F++P8`DQjrNWRwwj6pcR)=Fi?Qa$T5o?402g5n&z~8Br{e
z?%(tsLMF0xGZZI+II2JRg(fWyDbAPo{RlqNN6iwU442=10o(dr5J9$BZhV1@)c^bE
zD_>JgULSH$*13=3-J*6SWiJ=I21SqlayEcLiexnNlNQ^E_qOb{ZM_o~v*W!eFCSB9
zbc<fP^qd<g7Nf^W=!T)m#_V>x+NXS_yv3Ch=blCl3Rc@!Eq)8IZnm(nAdS<XzK^(z
z3~#z$*0k7B^q*D0=lr|w2FHio?VeNH-InHzKDC~Hpr^Yr&VH`r5{9vZTb8m9SYiGi
zTM>-Y<s^ems3IRCpWH1fx&!#XEKY|`@A%Z<GK14N8=m?5s}Fw<OkMymdPu62XYbxK
z>X}7FMLi8k`}uUT-Qkp4JotK#w{gRPr36FmKxDmKf`VIi?AY-pSX5Gy9hSNI2yM#B
z%5Gs{TwrqFK@LhRfSx^neiuJEI^@IV&6_`6{kp;lc<3~o?Jr!q^q{y{?x<-a)4rGM
zIy*blZ3o}<CC0M(Z$oqfO;B=U7OB=B==Kz=o-b}YRqvOSobdbRgPL1@w4COdz5BA-
zC7frIgI*nVR4YM)nW_|nkzWO(r#rqm9JxSGOHNi-99^)u-48I__aTLCLqU7e#zqJs
z(4!^CQ9SPA6A@?fK=2C(`xltek#zZ}QROOpmyDX)HjPx1C*%!v4aRuw+_+}X{{8x(
zyetph8U&30=m0OTAMIc5f;_8kMPFavU1DMyI{uomy#2f!yqKXtt86D88}e2AZG0Xt
zA^=X2FL-VM_N3m1g{^?Z>9mH%PS}dJa^i7YxyBu_IWBeV)sxu8wnI884jCg8ySUJA
z%lhS<^vO#<SQwGcfr|YDpTe8J-qL^r?5~ODZ?j7?8}It3Z~H{h%DqpXJb`|T8^h-G
zVW*~$l1G^!3p4_!5FW5uilJSFRq=M%@@|<43V8jxCyA_9rnM%aBQ`lbrs^76!H-jB
zHBgu^?%44J`#){&UOttqRk@)_ee;T?_-Sz$rJ45hm0Pp;?VBV|2WJiX+$(9Cdi1qR
z!F6;}teZdg&JxW7TiuN{pX+x28WwQ-GFf#s`|;X>$uB#y5h(ui>)KP}zi@~A&##Bv
zbpQANZKkN`<^F3&0<InjfThCSPz4>PI}aZ|v|I?0bZ(4I)=Kd^(RD`pU9UrL)`o3|
z+={M$BQ`h#%HL{H?cw`=#j5kK<-Es6$N1aEV<qm@TAPQT-(M<QP6|g<RZ7C>{e*EV
z$jKd=)^T1<yo}#YY%a=UVPeI?zAs<4*Jb-o^bgYBR5#uG%pM9tX}<3;in`-hSD|WT
z#0}-4H%jn#IJ6H3mbrU)kP7ZE_||r0I3n11+XfCN82|Ijo9Z><kRFM(cy*vY@zdo)
zcOc!p$L8G%)@CiX864jImbyLqFFQDhksJ-2%Vy9`Q>y9G(jEKAYxr#=Kl_(wfoM`P
zCp94k%yI6W-BXiSb8D0Bfonzn_lu-NfFgW{xZu(B^c@m#QMIq5<B;@x`gFZkmhC3T
zsi6YoK_q_y|EQ0?Qf#fYw)J%pw{I5y!=V2*2a2pu8gbKAp^Fay#IF%&&BH8<AK+Z^
zP;P_pXvpdE=&uLoMMFV)|ESDhj7N=&YxMm6tF$MirI}0&l6H_wzySeawe``PZ=LOv
zHR47Gn2n@(fjiL5?PB|xeIPqg`%x~e7TJOHC0tNbi!^qOt$7M$@rz#KADA-zwX(LB
zn9i7@!j~%>ekv3<FlwtscP<@71xGoGeiUS5llHR!qnQ!AZqJSzk)jQRkx#|gE-tR_
zWB2{t-QyjhMBI+V2)%5d5C)=}ToB+!dA+ofeB7M|k*4=lN57>0F;i5eLwI?NA69Q7
zjNj<vX+y4d2lU}@+~qEr^Gq)2zS)X@vL0;Q%8jFou5cKt8zenKx0pO-TIp%Fd&$5P
zWhLb>Fz3(-|CQ3x@18ENHEI^bM$ZESH&B3ShE$o3jgC?%Ad6)6^uk*8cZc;qW>|qX
zjaU8}XB89*l%y6OAUwYV19B5cFiKtgh7IF$U*88r9IERwvzLzjxH~K|*UYSSKc#DG
z8kgNQ1Y3c7tX@kECc@dE5Gih`vF3O~q1dFMcyma3Bh}7xDS7PfUTxuq2ebAIL_+&1
zUovg_l~q*2G8G_QfLMAZ<qMdFz9S0iN}T+M4*BXzInN%Y{DDaAwU`Z$ii!%umM!<a
z*~CeC_C~<|WgW;UH_SvazgZKrwXLn~SCkS5j6PyoX6+*)BJQB9{|jN{PAmzeDP*-P
z>*x#}jYN|C(>_z9DFNre;ehj&5{SOKBRAN@N7XeiSWW-E*3s2PNUFOHCNfA1K?ghe
z(@#|v_v3}(>u+K>@q8ZMSDoXXe@OmR1^2ga$jX1gNAh)<0XZQcz4`(O)Ej9>lt6UN
zxeFH<(Qp40-?V$*zBSmX4;fbAE#lLN)XK)M3g3?C!obY@xUcV)_S^wfq#OP{B@Wu0
zJV~RGeDj@gD>Q4Hu<@-ky`nn15^N#(cmnx>KAKO`J6~xs;0(ymmu`mZ)*URf&g^7}
zWv*f{Bl_JLz*g+b&(Gf_B(xR8`B$ht2Ca2<(ULrP*?jII4=-;4lq$~x13f|{9Jx3-
zX^<kFJ$LTwhYR7Kkm8o@co{M&WLLf=cgQDKO!n5yXbC^~i<K0xsG*vPtNR*vKlp-^
zl^7T9!grI-k}r2x675n^T@@;9z<~ciP<#7L?Yq;Dl`mYN3IFZRr=8hT+`47mx^*bk
zR#M<F_se{Sf${m8lL(M(&_`{dtfGv}k5z2od_bN#Wfz?KKW0`SHC#pc9iw`X^8o`2
zM9ZBBcQI)TD5E;+0PO1yPvkgG6(@v>*~op=&C^+I8rd%_tmXua>`h_2nGVvNx>92t
z)M4<iT+5k{68Ma@b#k9Az^bjF41as}A{%_3=2ux&nPRL?bAp61PR1<uV&S96hHFfn
zR13e}I=Ejcgb9gFb!jYOFUcJ&#1k;7;#OqzJX%*?XgjFIs-Ay+_-n7^^XJd?&}#KY
zK$JbSI>AqhP}>g}CQYXiquv;;=R_~8S91##hCSAryqIP1HmDV##h(j1Z)Nj}=%z{)
zLE*GVPhVd<^)9?_Vutd7DEiMC8W=#VwLXsxudqINa{mK{nwpx-(Vp74Kx7^h=R8lP
zODe7XXKt}4Hnp=DQhrW~`}_BMqMBCsH(pd#-HUc1ow95IFnjQ%&&bF;qU?f}N$Qw_
zIoh{ZxDoEWKPR$VtjinChU+Nbt{+(!ThnLbAT9l#!;l=w3$7O<&(l!Q4RmqB#>iPT
z?#e^rHF+gxzve**(EdOMb_%hf&K^w@3{bt*IXNSFfF4prSxd{4UBUtAn4C=({A)P{
z1*`h+G&7bb&c%4IY*5p2U9cg7qBjZtetz#zOdjCln-t@hkn!5NS8Dq?j{?1~Fhuad
z($6|?4)e8`B%O$cJLtH3Q5UO~Y7$VDjA=-R($W(33o}bKc`MLFw&H_kMdcN?tP=mu
zE{{oKy2*L)puEo0Z`!E9PZ}6RmMql8X+DPAer=$3?}2B|az(0hR)ql5h_l;j>%oh<
zQ-vpLzJnvArI<;qJ)~U6&bjLI=g)tkzBe|zc=@t>Y3cd0<E*@wKfz8^FMq9elVdmr
zj#1p+yxAFa%;MYd3?t+7Q=epCKXG@zchYo?xxIbHd>(dly{YSX&xM&3q*R;_%nkpp
zuu0;Ct-l27B`y=;K%CQhNXNtAgf}W2C~T@C!EQGuclIm;j%H>Au&u&@3OFvF;%RIM
z|9zmsx34n7gR%>)0|$XG@A{|~i%$sq^hueRms@H)rejm_D&i2lgEWnOsQk}Fr1$*>
z9H3nJZ3P~k*^sRkAOc8hXuP2g2q}%uVlG-|9TX*+h6TJx)o(D@q43RzuR~|%0z@Zg
z)YM+hXBJ)G3~rathadZl5V~#1%fA^U)ik+)u3X`Ev-16usvSlEr<o|y!!0?%?2lhz
z>--eJt|$pVT0I@s?9{M`W5Uc|&DJ&*FkK$B{Y<zqfC*2rK%Rj3)q(}o`<9I@1fOaV
zk(AWIxU}=A6lE?S+BW0#$!=K3-gY;I^aVIrOpm^9HYyxSh2r`aFn4bFQ=TTddqxl*
z=mCCy<}AD6Z3q&ts^-v8mF<0DZJl$S?gEPDU*YfHODlGxP`I6GdN^Jp)O9f<TjBck
z_tXq1pk!E&-%%dNMf33)3f}QsIAi)KEy3_FPm@<tKogQAN7g@kxx)HiG*S{6PT_i`
zDHG<2A&3T)U1+X9uvFo{GJD_4b3p(Hg=&#*6*YP75R|cDu^WBr<+T+B^d*IE@E=KY
zf2ILZMVr~-EV2)T`a!{l#dYJ~H9WQw&1}oBtVWIE4#wp}ByjiLV%9yo%<V=y&ZUjv
zkIzbI=$}}AF~bQG(}aX!1cbd<oNi&exXXNcm6PlAKeYBus9<8u!dazf5MF~LqdF0+
zEq9Vx&Bx_Vd+`^S`45_-f*lnGz+^Rd2gdl<XsS1*>t<M<u@aB1;hCKp=BKy|n>JQE
zQvC}%6vb`R7J9FxXq@q3mk6Sp%-9mn5I+|$H5;Bb@wO1DfVR%=YP}8BDY7xLahA+s
z@ws#3z2U}gcHr)@GryhoN}#<1l~TtzBn8|FRlB*k7Sg3xV#9nxe<BS9dToF6l^Env
zfC_XY<!4#hgnTXt{1p%s>wd@umMaLzXeH&7d8=e-M-66|)YM^bcC@0U<Vh=re8e<G
zynp`|ftun5(PwS{>+$td_0AUx@0uLMd>i-qU#zl-(r}+moS#B7Mw^X`21(g&lx(A%
zz=9Prw-DaG@n=cNOMlfnup0@EglVaV?n0lsVp;~0;os30k<4H*UP^mj{0^C7PgRsp
z)p+s&j^f()=eGD%-tO?R9E)54E8ULBMN4T0;5CiZBxdQVvR&2^nCO)hV)Vqw!I6*=
z_xol(>}xhrj#+lNSJAFm^I3_z*T~fY2_96~bd*mP?J@~fRt35X0t^$k7w7F~rf}?2
z=T^5hS`9V|4Ip!%9JcOJw(j|LQiu%)EdaRQr<#rB4JzWfOk1|>t`qUUxr=N4q2<bo
zn<SI~I$+}SBGe#HzmN_E`d1U--4YU1{+Y?)*4EzsO3F+AS}`D~30=m;^q<N@N=*-M
zCq|7lpO(H1nE%6?mC$$WnQ1}I8!zal9?#FYF3ssCj8$27mF}3Cf}iBK-c*C6E9|$$
zZvSzsnmA9pY3KWcOXyizNrCa22TtUs95qeNgY@%g1xRvtcmL%V8UEqJfte}fPyhYt
zakm3=xcl|$?KiK&LGp>lBQ^ex3*EO*X7S0>r>8DmVmiNX%lUmTsaNNK^$AsNx*n=h
z*|bRcgNg&~&oo#PzmPT{4f<JVbR?i-;u_W*n5*`xV{9|AQftE4<Fzulme{v!33tpp
zq2=h?ISaX>s8<wXFR)UZOa)Y1>({TRP>|l;&Wz(fcfTGXe$(X;3@xD1K@b&}31{50
z?>r{#1&cFN{-PUY%L%I6gQ)u=@n<>Qlci;4K_#fg*4aZ_qC6&K)U}DSXV0Ev3bH$&
zjdt8U5wgC!-dUBbO0?W3Rn>XP?0)g`B@G2d;+U8eFEgLkGgotr4k;OoxVwvj7+KvM
zkC&S{I^3F<cl`Bdy@K^wbx6$jRnVzAUVWtlaKhhps^<I!SKmO9!C|DYqr=FA`Pwbs
zv(_hFK1BEmRaL)v1d;nVrVvT-J8N;!<d+~$z;otvfs)Q*D7_xxNt3>)13WyZ@bykX
z-i5bNqV9~^?K)9-wdOwi-So)=c@NIY$yvVfw)}M2V|?!f1lk|7;?USW-A3WZPF`u$
zRf-go1ZpTuXiiWE`xe`V&ZnN}*!uJJI9>81y#a?Ao=9cmgYPca7Sk{rj=Nj~g!BZJ
z_eu&_n`?DCNY2(#wo5u4+bLo;VDNq^JZN<~)@xqHw@cws&DqiBoDbA{r;V@jUpBq0
zG>1`^0om2k>6J|!D=*L&cPa&K5*A;dpCa2J<@CG`-ea36cQCR+VpGv>9A1=xykxw<
zrS|2Ey$>j+SkN1s7cJ!`Jg_xVZf!07^v!$pdsHk<Gt67(#92qb;L?I~&0rFX^PBS5
zcuBeZDT%QqgMNZnsTrG^0?2$AN}pL=OOheITc+l-h?KKHv3pc!u}n~Ltx*<vmSI%2
zFQIbfsqkiB-~L#3QOo?ng+L+WeM`Auhukx1W%_4-3sxPiMj*F0r2?QO<<&8ZwpCyj
z5OA+0HFUJYAVA?u+xisSPP!W`qZ2P!T2#=XWyMdyi7)ad0d^}tP2131kTdnQ_tKRs
z+`7Zyf?m0Gl9{hKu((u&ZWJ?7PMkaUgxdN()H2eyJu^ZMN%i^+`o>Fz7NRR;Y3W#>
zxvIB38eC_nyW)U3zYC_S21O!`eCQ)NyO#3o)vHLy$+ri|daFzHeP#OG;3o(#nXzlu
zL-4HoI6nt@OR(hj^FGQ4MB?t~xXj#0Gdu(ZO`fl7MMcHb6|LNkk{h}NO9V(w`2v4f
z0n3iFd-m?-<m0203I9DLf7B?h=0yJXTZ6@H#ljs${u>wHJM}an&j>bi9H<wF>Za|L
zKakWg@Z0i0h)O(fGjhNG;RbEcK~ujF=OicG8}1}Fk4~NsnO+Rv%#=M&l|V9a8|Q3I
z9Y8a3Ru;QvIh=U0v-9-5Ac?<x$Y@-y)`DAyAH7<c>3)Sbds>T!`}Y?r1qyGX5ORr$
znVGPOl*K6qVe^QnsO7A$k9|!|mYsPNJ?+I=q)Gjo)<2ZXI2RTcb{i%A$`34V4tO=x
zMk#=TA)VPkK7q)5?-p=4WiD>(Z^^4|v~WcTtj~)&&$_mf?Wg0kGj;<=MVQ7qeY<`&
zu-~4_hz*oK;GGLV@kC_;s<oQAouwM92Etu~=h^)}^frahqph=*{gV@NP67o;$DoWD
zG#mEv@YrB`_S$|Ri#qz?Dnj$oBCM>cy85lz?Z4n3NKM*FAI9{Cz(Di!PWGv<!2shN
zM;xFZpk^_jpl<2XmS8&TWl3#-U`RZ;cL9k+NuJ^L>sK+Jcyyy9=PJdJ<4*vCUc=uh
zeYIt50(uXc1VpRw2{YS<(f#`F<HwCaosh+hpPPk-0kzGeqU$RtOxw1#G3QOM2Kw^|
z+V6(A9f&ogWPleKF&(}Mg0#;~^?+~Si=zkV2nh58aO>@!U!3-bFRr}{424Vp04#DT
z=gLzkw4S>TS4GiVT3X)j_{j)oy^^Igjkp6qP*4MV;o`Gc=f_`(57x6mLxl&1m5Q}P
zm$7Lr=k4Cgy@zzNx08^`@v*Ca`8}MTeQ^!!`bqEik~cDJ`>NLgcJ-ZeD>L{GQJ@cs
zNqyu@Z;Y^C39&;teElcG(wc#*z@#XBeVQ|S5esKHXz$>S{N#sP+6_`G4oaWoZ8|nF
zCKTNuB%ykd26LZ?$Us`-rIE7VW95y;;dfF&VH1X0oy;#N_<Hs5Tc9f_{qH+%xGgQc
z3Z@Qy7iMwF>NH-(_1(lYHvl)w2jUh$4?N~g03p%bc4^TOa!sV<>+sK>IAC797%=#R
zTAayir_ksDK3>G8isNI*vXc6Vz<f9S0u1f<?AwPLf&oa%3GLPZ0sS=)9zMpfNsyTt
zp3p)NWedb?=LK`H!y~}G*O+~==`8jm!4oGk>qT4=h-W@}74E%z_ZG?PQ%>mUutO39
zK9Sd70kzvNBuXR|fl1mA&^q(B$K4$9Qjji(MBC#<00fdXTZxMUUT_DK{|Idz6cpt4
zV>u?MG{ZP*^sV&=01_NWjvS#>$AybSpE1+S!pL|RiRvG87@rQ6bS4-L1UGtiSPb^c
zm)|gcEQC0cD~(oNO5;7h$zyts_&Ls3$mLm<LnBvSz%h$3r-KP^@Md>QNwxM47BU?d
z6%|D?Sml(1^<AH3#}6W)*Mc2PNz9a#N5Kk@0<P9ZUV8uzosSib@TR{&>3kSh<D+kB
z0J9BSS09jv-S)}Gb#%xdY9!i!-#n@Z!0!&)@h<7oKeW79Tvm3*#YK{9_il+s*N&gh
z>$B~XsA8>OyO3%VL%g8)VOBOaFXy?*e@J)S7yXSXwh`(M4w=W#a!c$HxP<qDQ}%1`
z3lYM518VIQ`p8CG9wFqDl$1nW96fi7KHjBTE7$3Y%iECHy?d}4r;dHWfgtTd4qeQJ
zyb1~etvOOaFA+4J`}sWt*v5bZ&Gi=+-qpwFz<8{L#iY--Z>Lbr?-Ze0!~37>SB8}#
z@gT@Yc9-MwOfk)jdK>W>I-j@NS+<I_=(ys-uxKY%2?r*;Y8eDMSo_??Qo4Tq`X6*j
z{&={7`7fO99k#v{#ELwH+Lxx9`X=7#k1s#y;%g9gr(5@Kh7|oCx<cL};9<W!D7t<M
zbO|BpvjJR?-3^3T$p6K<hn7}Hu?1)9QGmHWc(4k0NB}B`I=&+v0?)Lk;<{~hnz=5D
zvTgAB{Q}o)qNCursG_o&U?gC7X;-ga4KGvXd6(lu$@+H4AKzjxfHD91^XCZ@lS9~K
z;P37OHT?&lc@ukAS#M*3ZG<f9#`!<hh%vOHZ)Sm^!t7Ya2`%nF%gbfp6~KTu2yE;R
z;HIxY9`ILQ{-VlE8{@16=0le$Z-+ddozMU|NBPqgXl`rVbr_-J(aH3=X$?F?)R{=s
z3F>(@MI#ZF3Ylc~mF|gq^Cb-p9x0PS7#y4hu52kiB<eK%>G&r&+c-1>zn~C>9QN}H
zikzI>FEF5P`TEFVAe;XOfYdZjK&MnbQAWnz!vC-`V(9*s2PTgc_za4n`=BxG-@>*T
z3Rf=59PQM@`;CnnWKO_nD>ci`-_@U;wGKjPw@pJUmPs>IC`1^+ZnBRn?8|a8h;(oR
z^aq6UcQT#=JvYO^8FqNz#6L)8|H0w^l}<L*evEL<8-Vz;p%mM-ETTxzDFDbwh+q7m
zl@yZCqt>%;g(7YPg)knpN4u8uMS>uOFh6m>_dxzAmKP(V5z*=1Q`fPNXjximKPSjI
zQ;1f{r??9uHXv5<xGl;bLYRC`O42riv(8;8)_$A!yY;64xgQ^*vOrF85>V{MHK&!^
zIk_@*Mxys&HAzdG5lrh?y8O7{VcUVrq&K4eT6!E%Gcx7&7p)!5E(r;?AVC>vCMT`1
zyQps5f38MVh8f}4AoV8WbO|%Ga2_6f3|MJsYFY0v-g6fO3MxK4IZT0Q=NQ4{g+F*w
z2&mehP6K6N__lW^`K*6`ePde2<o=&Tn*E=-mgpr~j=s>CY4J5bi1Eg`Gm6sjr>@@n
EZxb|+=Kufz

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

literal 56797
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
VZ8tt+9w6K0cN>`K-_x@X{~uIV>bC#@

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

literal 27111
zcmeHw2UM0>mMx~T)KUrqD6zzd3X~#2qNOM*5)?(rB?yQl$vIS6DoRpOP?4ypNRpiS
z4Ft(KNBKpNoO5{le%ReLuh-1<n|ZTV&syzT-B5q{(mnT_efHVsa9dGcX6<U$)eH;_
zYfqk#KFh$c!j^$ynfCYJ;gv?;kU{+TPFq$+8b9%G>S($PeyqB7LdAlCf#VkW-xBYR
zAzcQBpBPR`|8mauX>YT`)APESQiB667P`mT6%Q(wogKY=v*DiN(VugEHeES(P2@#Q
zVTNzA(&HT=fdy-nHN67&3G!>~D_XNUuTVkuXxX6ZV}nzif-BA}Pi6d2)SKzza_wUA
z+aCnpa|#)bIMXyo>?Is(;seJt;%oFCm5Pr<o(@smy_~wfa35Z)CDd<`Tub=LFNaU9
zvZY=*d+O~P^1|J-OEt+)*9Yqdmy%zeKX7FsKYt2ao<V*x@a$+?L4Ka#`3Da1erH>R
z*4))|7cR(HSy_n>f7}+vw`<H%0_SusKBgPKhJo8WRXrggL0VcGmuV*WwX<gx4sOI(
z^!I1EwBcG`V(sw|MYkg%Kd$6*ycS+auKlMS|G|~X?hY!=^VlNL-eghg=`>!yYkIto
zO;Av<JVuK)nY~MrDUZv=vFX}}wL=AaV{i#wHIMdQi1y%7dXar{SHQ;f-Z<IO?&`fs
z4Ob&3d-bK*T4!1&+M|+Nx@$ykv74Xxc4M<sr7m7>ZZ$PEj}GXbdg?fwA4~TVJ07E%
zsofc1<0VikE}&`uHEdnpV?je@b=yxj_FHz9)oHu)hHBBA&8p7G<Ty<<vrIW=IcU8S
z%uSzccc<Syy6$#VQo|nmvF=Uj{b`0z?YqN=K5p}tHZ<&6$!T$P6J6AKEJ8~ztHoP<
z_{7V+?%p)<$+qie<MsM^Ch2|5V`F1yG&DG10H@1Kh9>FW3SJH)#lkMZPK=^m!IxWc
zhn5ZecsTK;l58xRwwFBE4;^4-Wev^Bl9Zeu^3Ef-KhbQXbx=^yxGQ}7>KjMSUceeg
zUW^Sbbn@lbYB34w-}A+(al?WMF$W&y;O&}DW7Y51iS;VFxtTaMndNb4cpcI$cyPqn
z*w{}e;M)6DH#!RaVk{z;F^d2Ebzyd-l%>VKC+hv%-<H)L>YwTi()!pra^pyd;uRAU
zzNfbBw|jbNrIIrnefcyRqGD>F9<o?H)0eE}*O@do-pCT@GCyVFsq#ZknwNf%lXXR>
zFl|ciWuDqdTE<W=+l{{D)~pXY5>uajj)|4-3bf_kGO>+o>O}H{18&M^F0S6_QqG-C
zhGPcC#=NuL7iit1;tkGKwY4lSPCu^bFiRg9E9xBS%QZ1F>NRiDE%Z%ne7QF#%haL0
zbuF>E=At&<-&U+)&gOLJWirj0(ksu+X#0JQcG08#%}+krHX0}AkX3MJ;qR}hqfHf?
zwg=6B4bmR(t?%iznd<P%D;92LPgUph5@~mv{HoxRRx+<3F?NpKdGeD6=fVVS!RZIq
zgS+)gp4RKO9<un79q7=%#anXvil3A4IR*7R#`fP<a=K~QGz)$ydR+Nw{0Ni2X+Ksn
zw!>HLxO8?;42?5hueiI$Il0x@p+a&fd&9G&B<m<ipIr)Gu*~Snkt>E%!yWteiXNqm
z)u^Sb*nQnNlf^qWM;x2cljRvZel}~*zG7tL;pWzo>5#|oGFA9U!om8Wu&|6|khh~G
z*IwmFHym7y)9&-V$$|@6>tP!KUK3?U8FRw?G@oR&IM4La=Vu1IcgXrm<11gje6huS
z(=CE#)GIo1_Z}bCiAAbyZL6itkC797`fw|+QbCHt)6?@_Y3H->a2`&V*`duM*M6;-
z@DM0*tCSbx<;3H86%*qfG}o)Y-(`OGV~6>@!Va<@@07aCkDOfiTKO_hNkO9eYpi~0
zAjh`j9w&S)x*C&Bo6HM&_uKS0T`@NH#Kjl-@q3exV)5?v3fqr%*)GgYq>Cr7J=5DW
z`HLr)l;jhCe;q#!>)W@uoJE-VHQA>eC9wlGuD(%c)9U1I9eL-@9g&G93!hryW=kc%
z8NBgG#7uj5Ix@aQRe!<TsaMC0*Z`Yp29une9J!&yM8Ou9g*n@<kXza@nd7IX1I-I~
zVt;-2`<RH2=d)e?jb~d;@$ld7eEodnmar1n)JK{7QX%srK?@nb=m-i6vrLcm_<1Bx
zv^d0!C=|!g=BKS)-p{pNXSA-1={w87bVj5nGX8!COU*&kmW;&tgN|=qm)w|Wb)kKj
zhhw=m`RUd!Czx23{LES|N%5}};R;Sy13G;RJ67xDdC5%&Syr4380WpIt(iBb61tUp
z^(_wTiy>iQy4Ss$HCz^ET7Brs7cQ{ixzyG#V6Q4no2K_A1++*J_j9Qs!63jyi`TDk
zlf1~MKQ0#yI8UVGXdUa<N?5frk2o*GofX{LlCk5B<=2YmnT34mMr9Wj#D}Ddf~2JE
zoLZeGj=@=q_PI=deVKRZ7Kd-fe7_B?v19-A!~oX?EhnqX2Oh6WHjOV9GHbuRD`}<)
zroYK)X1wo>%TAx$vV5uA?Ii4mKd+m~94^=kYga%#Ie-2<@rXU*$woqKQVUb1KDrDh
zsU5zdk`D~!ax%Pnp1pp(XQ$kgjSn9_Wb3dM>wR<dKx0B`>LF~3*pm5LEf=Q>Nq8x-
zOqX?VnIdhj%S4;ARE7LKxfUk#@_V@Ex@4Mpot|}v&m>h%u;C8h7_1-kef!Hwjt2=Y
zvve-gGSzU}bal-A@lKq+tCi;BH>2)6)p61Rn>O}x{(Y<Qh3Q&ai>{l<)v8y|n_nsf
z)tS=fYU*jmhZA8KFjkF-QnK})JGIz#?l62CEsLkro=_<-tGO`b?b2%=G<LqICq+{J
zP{#ukC%HRc)mo>OE3)tm#QKuWI|@?Z34LnwIBe9<c+qm0)w1Qq`Zh8#4P=bSN2;gB
z?WQv;DKsaCWwqksUFCdSlb7>l48DIpml)&3YmHM9n--txjn}vtWvD8l^fPyR>%v@X
zdSYpR`any+)dfZcHX);nemZb<Nhck$-Iz2=a@8%4>&VI$syY$R@Vwc&#_U2vw8YGC
zA-|0Sjq&xPS~Dkh^N(94oIM0N@QIT%#FO1v!(v@GkW8C1{%oG==C)bV(blo+C|9?6
z@58+pa*r}fY}A@*sMY@b@!n7fqtouISFeVqrKL6J8OCJ#_EuK*?2GXZOf!{rq7gvg
zzjKM{Dn~4U_bpEQ-Q7Js+qm1uYPGygoqE)U@)ew^FlXADWk!rG!Jty~X?>b1P=%kS
zJ&#?cy`IhmL<h&wXIyfc3v&Z5TKWt9MTd*@7R>gJ_0-0wSy^^`eHkR*u#&@45dlNS
z$;pX81QMtLEb?U<83zB@Ab(=Kr@Ki=IyRa<-2hkUE~$5+ySuwVV*3D|UH_ZbiL8mt
z=Mv7dlU80TyEnGqWHWK&O>R0MIa6PnTYW)`LqM;{&2Hq&F$)U|z@vnjD-o%wcFRg$
z=#N%8sddkgAXIm7m96aM(XMjhMN&pe#OQ+`7)@F3@~I~5HbD>+8GO4;rza}e%V8ih
z`NRI2*$sWXNp+!(d98Z>#`mptbm*cp)`Dy{M`vud2bJy;IJ`}Hg&o{)d0pLRIIZ%k
zs*T0P#pH&5#@jPvpII}Qa#Fo|BJk*6(XDFh^@9Qu_yLg;lS=)C`Bj3FLqoaONlvy|
zdD(or!IJBjH5w*&AaX9)emaY{<8PtmoRZQ8_#Drf{&ap-RaFuc&ES9YSZI?uuU@@!
zb8|z?$S#-R;()O&WY)|ZeiyE>BGH)l;+vlgYOAZGI=75I)&3)!t?;I1UP3+Y&Szy;
z=KOTee#4qb>qcy$@#juhTN&KMOP#qsQx|tx{>+1R66T*j+P3|+vYkX9g!E&4e(nec
zH;!zb+I-;hiF>85X3|tAtaX}_{Tr#Pjr4c5*>JB|PY1BW8{ujnaUU0BwU4Qr<!s6y
zw<tNZ3$dZeB<S?cN|W##@EDnDc?EzCzSebcVnT1G+Y2ur=&M=n-0|>2!wtvgxhpe=
zQ#~&^Me8(Nj<28mB20Unk@fY3|9xwi-|Y>%cE-?VJNSW+NPs&zlS21$H>iA(6LO1_
z_4;>f?@Uimf7FXNyzzqE;?2M#x6($+;-dBbFzubOwn(8ivDJn_lhD_%UsHHDbD~9T
zstM>bUYRyG(JEzNlf>Emq{h*;l0dHbf<UXXUsmquLnQQjbAPP1x#y9PaqXwfFHa2b
zCz@#irrH9%a%)$!zB808GnF%r>6sj&r$1eiex*FrI=)m`8osxoq2cpbMVM@QQ|H4A
znqT7-cm^8HGpTDSS!FA1=Fl4}QxPa^+M?PhHIZ7nqtD+YEnMwW?F|;qM+vvqvN5k+
zyO!;uZs}w@3++)to;Md4@b|t;f^07$a5;#f8b7cJ?c-LC5=gf%ZU(TC{8}0CHmR?-
zqCb+y5&1y0LTbQO2aWmBmr_>sw7%ZYB}S_!j8mIQFg@J4JcF&i;Nf2S?`!zFlz&Xu
z&bgD)8R&4omV-C!XYFjaI^a*ATAf@EmCg^Zi5Gh$Zf8E6W?YvZUJu_w0`(m?x2ciN
zJlbp_&2lEhAYQ-J%hZw1CZVhr8>7QYu!4b>UB|=Nzqs2{4&1VaSGkazQF_%;8RrrI
z)@+ygPM2tzumG{y!4E#;cAWvW{YwlC(*V}m0g(pGivm+j7cW>J(CgaQFu&t8=Q-`B
z6tf|0>AduTEVihqD5lt}9A#u{kmyP!FYe5|xI8SuW>L#7RUJgUM76xp+q(kYnynjo
zIh{t!KZh6sy0qBRJw^HwDjVhu=H6WT(6B<?|H<i{8<bwkdm33+8&8vyxGq`Np4JoX
zF5F`KOyh2IQxm(zm!jL@N-uM_-eO-*%uj2!okc=bYd>z=X*@niF1i>%{>Kfw<WDcH
zxXvh<(#+2(Dqzx-@_g<(*X&PO<B2gjYNnZ+aDHxX?DO^xKP@jG1<6Cly*V{TEkycL
z==aCh@Mln|Tn1uRz8xH0Hn!@<pqZx5_Rl^F{WXt(A58kG=vo$AaF*rGp>*QtO2h_w
zm0OV)MKs%o7;^v?n)Ro4=E4HEFfn1#R6SS)uLjW9ZvOcvPRGG_d<%bMReiUXb)$fO
zi3iyU#O;)a9y6;^(a%xQ4>;dlu^xGZfs&dU+pYl1vj;}T#agH2<N7j2N_uKG6Dah<
zmIK>0u_fHxQl`5j=-m-9{Rs<x*shNxo$ND^v9T#mN&UbnE+Pq}u`8q-aiu{b<(gcr
zri1ZQcnS@#MxTkkFZNV~;t;rQvn?V#{5IL{W<~q+EF)ZkB%Rtn-Qwyuf6=$;f;y8;
zi=BRQ&3+DH6ZN7ef>Z)(QmuIP!_BqsBp-ORUnecIl;`Es^$JpRmfqD>O11lqOT<Tt
z5+yGn?OVxd`)l%e44f%2?!KEpY^l&~9RP|mYqqLAcK&?z%4iD>ldP#Pd@(v28XDqb
zRZ3<RCwEynG-<aa_X}g^1PkZ^${<v60`J-ol*S3yX*>9Cr4GQ$P>q@?0c`EhxaO|(
zA`Kvk#3Xhg$HRxs>8FWv-{vL4jjv}t61BQ|I!IDN4|p6Y!hWN=HzY365hC3<Y?@+k
zmA;uws@L;R0kGBSZ%Q>Qm6*uZ@s?m#kes?)^jKgQoSAlVv$cE3(ObD)<<E3Tyu-#B
zx0REy;;6igk9*9|&E$y<WcWDt1Ab2*-fGmE<wRF-nO2$|Po{ao1_g0>OctFbo>@*a
zxr3iR&?|%HE!nY8_y79VHBjWntJkmZ;9A83?Y=xtfj@3X@bQE@mq<e5KwYleHZM0b
zdhRg<`+Ztjv&%d+ie_r4AYr*(Y4^s}VSE%@;>uXEo`mNAm?kOI`;^0?<#Bpv{5!6h
z0h&v=LYSIR@(7_->eT;^ka>)Zc()Z3byUY|djCIYnSYeoIq#e1TAUxJTgdHK_%Q8<
z0%;fvkhq)M#Vkj=+Yw9dM1d{f=0;|8P)Nu(g*Eumfybw-s;iGlOCz?vc=2NWh2<NS
zjvYHzRa0|Z8q|d$ft}f#mgJmMQP~2t#KcryQL!E<V@I@`d3jmco0gf?w!)$6d@Q`Y
zykUIT4<PzJ1FGPD@3cbqRh)Ts@|9Mx;8_IE&k~xuH)iC8{1D~rot%_p?|t;K!HiQz
zYHGd1Q@P)Fuu_lfe~8ukM<3tcE#-g8t({ltUV3MTUtx|GG6P#+7&`J=iwy7`XYjya
z;}(RbS%+NYRdlpw=VlTB@_lyY!L4pt!@}qB?)u6+eaVr>Bv}a!4b|QjK-e^f!xNXW
zMj=(lHhv)3k~Y&kAlj^{rNvdNZXsucu*YHILXvY(GRW;|HA&<+*|#@5d+|c=`c?G|
zTQhiOqq5C!RI#&sw8Y^LXxY^aIW=I>+%Ar-DFS|{mLI^`D6v|3aalor@R=PuydPod
z*wLd$rKLe7<-nLusWT~_CLCP4&48O5$^CP4bJt&xPQ5rM&^Eo>e@jNAQM{bvS6Qt)
z5)(}V#5<4;3Zo#wmur6T76E!9NX_V9{7t<G_-YN4^~(h~*#<(ZE>=eek@E~t=0Mhr
ziMn;Y?hxE{?)eKEo9KDo{N?o&;~5!cRMRH$>5mQVZ$7MZ2VErjIwE45PrkISuCC+c
z2QDvy8F4?v_rc}G*JP1!iHiWM;KuLxY0Vh~i^r#Tk_^>P%h~SSxpUd@S2`^jb~{7_
z$WwRqdMNicoey`q|61GI#Z8lL47k}3V1^_|*rZ8yrlz`@!goweK>S^wPEpsEW*Yy!
zt(vOp{m1DDyjPQr5vvHmaC6(fT(eSgrgsAq6QPS3m8s<&eD|Q3HG_j^<LV)}++0uL
zmd&7+=Et-a1WC>@rt;?3U!)^dKiZBhi>NsWm*?hY3*=;<^ec6ljKRH2TM+iQWg%H5
z^eR9xQ-t0Z=T5QK+nM7HhEemfzWZ*wx%`pB@wGbQ0u~Z95T9Sq!S78>OuUGx26zbo
zT(7m~=1iy_zw}$gz!_}P16u~nb_*EOZt2IXP`|loMn*=Ca^5<iq@q$E-6v7<f}GjS
zO`Wf{e=NgpghB|-Hmwp^iAG~X1B2Uc=X*x2U-SugIZCz~ylq5ALM-+ry*H`Rgix&3
zDpHP$pgP0&mUL~cH>z=9FSvN@*o_I12eAbO1=g2-RMf<=Y6~6*Z!G8+E50Q)`-uc3
z>B!agt;os<_oY+u{3PK=^Ac+{(`!u6ZR1wCmAuV(8Qmyp)|Z#ltkf6>7g7`Ok_@TZ
zL7o?nvh@;EwN0Bg?Y~kMoHF=+4IL=KT_s*Ghwd%Kxsv_b;fj|bAzQh*kw6E?=cyoH
z!1=C=`Dd~*5u0IAzxK<^#u=DRp)c=D@XI9+_Al%#dyLeKn_GFV<Ajcm4soqKKKa|@
ztu0d3hh5}?#bI6BUE-Q6D&k7=r4LV^Q&v6>Ruzl-IzBZuHG9(;KIMfUQX~sR+cbE6
z^0S#_*qJV9Se+-yd*9L)5M-jb9%M@LwY8v{ZMJc1zYMTe?KH#Fp}%_O)onS`p5qSE
z&A>^1$!?{2xnO|^S}M!x6%(r-JWi60`8;ArRuDV+<Xiv34*1=os;a8(OH2(7BPK+S
z#cy3=Iu#{ccDtHUT}=r{=Kk1OLIAFt5uY2aWMYcNMjStFMxGu+&n4LQnj1&r_y+Q%
z=7+2s5i;081TZm~A=`*f9JsS-FG0oLZf-zov|D?rYC~66-1oLDeCnG41=KRIY<)G7
z1~3p}wtQ(_p~Rj;lahpvd$Fh1%*$|CokN^LI-`2}$w8hiI`gwr`!Bu!gV2A#5yuzi
z=Y$&$QCrP2Y+p@VafdnBYMX2Tl5&F}q*;^m6SSbn8&%5iTk7WdJII$G9W*$LqlGt*
z<74}?hCEF-W>VC*>)JESOH2XS+oyYCymtjT9w0cvc5bXz2NZK`u~1_+UwZHQ54RY-
z@$7~7>=l!0-g@+AHdcj|5VDU2^m73NxUR2c^eTTQllSV(Gf~G$DuNy6(Oq=hMtp>Y
zq=KRjuT1Hr3uTlO9+O7lvcGPqUi8Bk_8<oAGZQ?#UpKzK?rKC7a<}{1|3x?KF1T13
z5|a5(qt^dRMd*JncK+)s{%bY5f33*>fPtSwZL{tve55qoba)|y(AG?c2|lY;M(uI+
zku%E+PVe+N*?<_*LRZv_t9K~^7yWveM8-2`?j=MZ{AJ!e%QR>rU2l}sEbPFruq9Zm
zX_sQwfyW+*ZI6>^*+ZPShAYP<_~@6Ewzf69DMwypqP)Yhx<B@*CcLWJ@#c1SZH$(*
zG+Z}v;^4s5j1$jGOD7~H<-*s?5)cM|4$%E06B7`4tWkX&1=qov9T1?Q{=&+}hEH{9
zkCnRie2Dp9im3moyh8iO`>+0@1^9>R=l|N9{{wsTzolsSZ?DMfeO60y;=rKV&QEpH
zQ#%9QQ2>pJz4qz-l`B`=2reLe8*(zW<Xpl=ilc;0-rX#2d(H8SK+x@F>qLIqvuBUc
zdld>#S!$^)&mj1m<Rpep^T;jSWw@LU683L1sxuy3QdyP3<Ai)0DV35Mo^l*cWzlln
zujx3HlLB0(-JX3Lxl*N0Cv~{NUmhNN>z{vFdvfrT8OZWnP;Kl^)1$ZHK;R{YdgDuT
z2|q<>rzSu=v)Q4%n8XDzz&f*&Lnw6W^w!1h2MhQL^cJ`yVL+ca+p+2k^w$y5cZTSB
zer>(fiA0r|4F|{jo5iwF9nS?TsZB~1sH=Xwe1PO`1TL-NOZkbL8$_WOD!qn%QdZqn
z_+>wc+sXGVSwAKwCf>`x9O|+#Z-(qu20TO2(?bGZiv5#g6(|-aSV@;@&{}tq#f4}@
z){oCPIZAPNHXafi6B9kxQ_Zjy)eMo*vZH{+xgJ|2)OpC&9iA`-q-(UYs#TY<`D^k;
ziqW@b22f{bVj8MaQW#UbLEQ?Mx=Q4`#)rrP4{<B6NXfJxL(2B<_Z3Kk0nFsN-U|IS
z=c=)L3YCa0$V$`_QBoj`N^;M41zK>$1j+g3UxuHjLPG2yT)dLXls8v=e0?P4_UrFW
zi1^=$W3=`6_ov_48;w#4s73v#zQ5*YDjchY|C*d3vnJ$!rCBtp#h{3<Bpa?Q&;q2T
z&Qz?|yh|~6&)&V6c_AL>7Zo~)RQ4wjvB1~(rv0#cU<WJgg=Emg0!1L-p@Z@3Qgs4<
z%B|fO#@29^tt&~RpF+~X4+^ZmGe!EiH#&tINxD=vVcH%j$$x#*+AS5NlDW=Q24bHI
zlbKyshOeWe`v-q9ju`t|x$DW3Cuw^)>O3Zee=CU$T&1{sW6hMr>JzA{_?+g0B&58l
zNxl7!t9F52e12rJI-lR^JxdFYVzuM;9R;O?faaURU66CL=sW&G*JP|N$@IOY=50yk
z0Op$ki{cp9nA>GW3ZF0OQ5R#8Y2A1iz+3ubZ1)k6`K?`4{-aYLr`vpJ#jgUNT9=E)
zPy0Ja2H6B1ew?ot|JSVN-1+l6mYB-Qx|8+5g>P>&Mhg6mzo@(Gn%wJq<swJF<anJ9
z(fDkZa-J2{Z#KystAWWN0Za4`Z>%AFJ`<BzUxL!m8X~x0xTv7JX)tN6jnvR>h3r38
zZKyd!7t*edTNUAwK0V%OYE##ViX#L@NFS0@R*+&kgOO|8Dw0O2qxLXVr{kSN6e27d
zmS_AvnPk5fEc1fc3S2eF^4f+hQubJwpMi;^&c<(2P7c7p7QAn1OZBJz(XW*{AMb7*
zLY*vK?Nk5N|0{X2E6bUk8qs<G$Exy%2G*mu)_H<%ov5O=34`OW-`GjEtE7sTyG36*
z`}LO89#xBp2E!Q7U#@=_H8urx(bk=(AC-NQ6zfmXnQdDsRTrG&wM|*#vayom@7?7B
z^IGAuuEjMH+a%Sx*Vjp-%F55JEa7VK>HUoz(ckTU@fYk8Y0pskC+L#@A;bU46Y<My
z3r+*GjKY<0a|5$TT=ooAAxzS%ecBxUe;f%Z`}(0m*>nK+c(fhFwI?CWz|_!@UV0Ov
zi?GU7ug-8?IsP+wE^l)cnU@TpLZ;JQ70xDJg0FDA479&W6j;Yz5iKA?u>Qjw)<rp-
z|F(ZX2KV0%8vkF!c>m5-oF8>f28U30lzPAHx6qXtbJJt)t2XS+hUDsw#6fb$48|KJ
z+KjJWy#wjSzVFttZzk1m!t297#4=JA`KEra{aXikw&URWrKM*f;BY6gN^&%WF~_P_
zg9T2CXZ#a&G$FNPjJCVvpKgXn_FR|>TDX1b!_8yT*|0P^IQ%;|Z{8#Y!Oi@cqi16o
zDP`iDdLH|?U{FxqkYP8ICN+y8(0{orSk!;S39-FE>L0X*l%x*ZgpTbnq$osA<~mlj
z4TKG;V7c>WQEDDWiBUz5&HK5zxrr=K<jW(SP%t)xM|dP=W1`?kJqbl+d+|1nsJOTT
zC|Ge+zEtogg_j+E>gxgJy+CfKpz5Q8K<$2X-J$J7tc2La7O{^yXH~-$oRgF<Pe1y3
zt6uSwO<Xf|dG|}DPyr<Ii-?j=KNTrIT2DQXnoG}CW`G$CghY`P#<U^c>Elch!Y5Jj
zjfH4tvL-o;C|*2KKQ++t`<{I5?rJvPHjRWUXJ)%(r0(=3HS$SL<tyYqKk38GO+{0b
zFol>wnvjb}!8^w$Yb3zU4KCHJJN#uXs&{W<3n*#m2~W<owj)!H1Z<Fclr*WJ6bY1i
zpbWK(oBOyY>n3lB@ry+$^Ot~r?7{)1rHSf+dS=i(9w@N^s~os*1G%oB9`13_E+gtV
zqRL7ct&r70G|caWv!?sE&gwmNp8iTIFIHY=P($tP(+{+JvFqD~B*Oeqk0pgi$b5*p
z4q(NM-M%a24C+=<W)0(oog>GhsB%a!JB-o^H7TEQQi-EvXs8MH*n5tJ@jHcI)TQFm
zg8&?oT7AB>-ML;IY~Tyo4%T=>qQiZjB9|1M?{E%gp{xfqaYuq$KnBB)%npY?@sZnk
zn|o$-O9m4YByT4g5Zw2uYLS;2=0my!Y&(k{Z-Duofi?;%Lv6pgQW3hx^M%%h`3Y@5
zYF{WO;pp;@59}}q!hLIuOW_&&jDODeao1Q!4s*DE5B3cl^R7OStr3OuRLR^K*z3-p
zJ}?8aY`=l<!Go6dG@F5zlQX2g6-x<V8FrK11afTB`(3;SV^IEO(I!f>>uQA^2?K51
z*#{Yobv-RCY=^-F%Kdd6<irdQqVQy(!Z57}gf7)@ZehY@LD;~hTPbLd^&#pLx)EJV
z2KMK%`y}vZO}6vRXaNeGbb!b)hi@hMK(Ns!i8cw~0>}%6fYeYxp8Uk<vKhsO4_Q($
zMr`6qRD%#Ub7*sov`y*k<ZG^R#OXvw^AQQ_ju?nMdkIvX9rmMnpghk<p$C|;Hg>Zo
z5&nI(0XWR{RWniPH75sPC{Wf__`!a(Tqe(DuGS^zLe}s@klGNxlEPwF0#Q)TiOf&Z
z9YQyfkCPK_$%vTCbD5QyMW8cG-Z}8Z>(G}+woqoYlPYic0rEK<*Sn}q!+5amof&9S
z86_npQiJ?b62OMtNvM7p(y5wm%50!5D|fX?MESiAOs@{u%a+Zzu;eE)d$-6uOj}-a
zl#jc`bR;cr-pH5p;X-*PIJ@9R#~8{g|33YDoktOo`;8kC2rh4DbeTLl?3x%&uD2)r
z{^I4G@?M?+W#=8NekBn!25#mgZ@6~-=4vz4o-<UsFk2eyI5qs)0%WgEFK{lfv{LT}
z>YPTz5;bj_txl$-<EiFsP!MNAEaxA;L>*kn;h4+Eh8UN*p65=r8aAtJs4v-{C|}kB
zc6&!3a+8e?(7)r~yaHbQZQ075eE{s*jEv;9w+nF4V%EKN&okk#{`{f?aKZLIh_PPP
zeW13)pbIW!9R#k6l@KCLXvd}Q9p6e0#Ng&upv@?PyCX)S4i8P}SE8tCUnw>D3rhQY
zAXMh|$&a*HShDQ9jp^ITmt5n{jk?-^#r5#@_5EyxyM791+T20|p8VS<z7+=RMD9pl
zpMX$e_xN4%Wd_S&82T<)tTy9f#cbuiMU?b6LHwTS^=ml@n@=i21OQVUdc)>hlrii!
zlwclYUVS44`-$GzI&V!h0fxqEeNPOdZ>L&xLX}HG2c(8OEGW!(B9rr^67Y*Q3flYO
z@%UzhgoJX5EDWU~F>9kAI7Ab6ouVSqZZV0t?*?M?IQ{=fCzXA1pv!y3){Y>GkMHP%
zLTF6-+jb4dU09S#uqeGaecR3L-Zq(BQ<s^>&4<h{qkv#p=YnOGYxtH@_mgm4$eX;q
zFCseab>-vq2;<ls=94oJ9LoOLv2Y=ge4dHh+SP|r+ogph#`CbPiGSmqa@kC`_W=$w
zCJaDr<E~C+Ux%mQ*czc~d>&BPF>e+u?|T)>Zutg+0{?u12}rh{HwWxsX(*ZGfb#Fp
z?|Ea7KA(f`-LifG8o3h<&@&kQn-54%cfE>=@}x2$BFD<;KFqPNd~l|9K{7h6`?VVt
zYGE_4|LpV-0?Z)ll9A4Se`AdfcKc9#(A+*O>U~K#jsZHdT$AMOA5ayX|Bb7FTCX>U
zB6@HCf?k3R!cEtXQXvcqWD$r>8;!LrqMCzdKkwQPDRJO#*hAYwyv=}_^24$Dw=@U6
zM{C?%e>{br1*W6>JdY?<WxrvwD~?-Jb28&|_(la57t2GPS9GUN6<QoLwJpAW{P9oL
zUe>3oeB4exKk?~I`Om+Yy#HB5;En#k+|2d5bq6Nu1srOMX6EdRdlL0x^rd>zC&Uel
zix5Pa84kysAKa3WP6Q{h5F}0(=}T4``9l#cNVF>=s0O9K{(;!Lt7e3(-e7+mvI1<G
zCMKfw5j3pH-W!v#9!1S@RN<%^GHA)Yi`%;_!ph)nx~!d@od>6cC?HWY2XS@`3|$-2
zjBZnph#}4QTeC>W>MZFGhdQ5bczpWBhtePcefcF3lsD<hT+KO1RR8znUy98-e#6d<
z8^zn4P;J}-F<5bbDG(13Q(cOg&U~y*2A$)Krlw}sS^KBXbJNFERFa!&*PU=9vJk(+
zjDDxWJT`Rco((_eoc{cI_96NBB$jlBt`F+|2J&?EmywZ07ei!r+cr$1^cN!6hk`X1
zslP$VM010z^dR9DG`XC8{rqH5PKrhPdl%^qOZsyAl>7JB)0f-FR#cqr6e(Umcw{I=
zsFIl=V_e3j^dELRzHL+{Bt_7|Y$xTkd!o~|dupOcs@$x1a8w8yZTpwLF%0%Wa{fY_
zaL88_$R(<|Vt-+lRMz0Tr%s*H4ssgDUbPhEsD^MN+AXkvBR0f#_NlxDNFMFBx4$tl
z5pV&n18=ry*ABRHoT&=hf;)!6N#UEM{%VFmxhZ}zwo3C%bKS`EWb<pyLY>V00tFQh
zzbE)TqrV?Qt&7>G$htAy59?ZD3PFpr7<AjQ>&Z*5m*K-3ZJV1XG6$TFMN-)CCzS$K
z(+Wv2(Q?K@rY-Cvou%IJF~SSBbYt=z236%j*JQxtim#UGK{lkDCH!TeYS&_*wvP(s
zFIPN!c75wqiA_6{jCbze4_yRCcQ>yHdgnm*6h6Mw#~@Y?&!32_2-qggJ)_Xtmg!O_
z7`0!)Xj>}U6M4jD(K&C3yiL7vSMi%K`{P@JwEZvKUdU=^pTtt<@p$mtid`l|S+rtc
z5uD}|3q*<l3tZD2wP>(ya(I!`s_G10)Pbyg2;#FZTmvA`34F)1M%xQFLfgI838Xb*
zAWhb2P?_N27~K2>xvjp&<h=Y{LF|xMI}JGKlsr8&bxoKX!kHYc`C-3Dhb;7n+um<G
z*mg1HTF6}rpapZ_w0Z{~i%fStqvOjS1Vj%J*M;J>)agAB?-27RZ9mxnVH;@BveL0I
zru#I~4x%04Lf0ZHun)U`#AdQkYyJT3;0HP3<^-9P#*28IO_2Se`06-i-qTA3l7yr0
zmbHKo5uiyRqAE9XS(g1W)d$G1u+MTaf@CV=6UW?{JCfC&WTwmFAkH&TrSbjw?Oeky
zljgL<>hZ=T<3dwEKR=eVMa$ESXj?K+6|OYWIP#^~FmVncz45aJwePQ};JAc;q!B4Q
zQGq-$o<V|<Ej3S<`XWU`@676NXcsQbbpnirC+VVKVge>_hd$9;!Kqtm=<PDbY$E4`
z^w_g?_KPqHoJ6Glyz;A?+a#EU&7_|zWDyp3C92ZasEUQ14SytTs`(V{7DGK+3n+vW
zI0rSD@%W)#Pp=(mLNvQ~D(p|E2iO-g^-aP)rn)tTKj#-G`J?)a6Vh(OHh;#>O#22b
zanAy_HYdZ*nxWx|QUKtoxD!{JX4M0T02*}&shc2j=DPE@DA3$BmbS0W*od%_kd)=5
zn9<Yd*C=~-I^y>Yb{wwl@!gVv#3B|SIq?!TbRx0q7on1q!!b3wOH84#B9=A8zc9=n
z3x-Exyl>biXm)!|v<BEEG_R;UcxWa2g>v_IZ8h${sHv?ba(5zbGfo7_XH2LVP>ATd
zkw70r)utWPQjLmg0BsN~<d`ypI=B?+y4lTRFs%pyOtC3Hs!Mwd7M=M+m@gk}@k?nC
z7ZXz+yTxgk(yRizMbZ8<s;Ui_XK?Wy$txC_65|V4S7huZrbI7WT+-A`h}i;DsgWXq
z8{g82+C8>!XVP2e_$ULNwchjaYMc|@|Fv=5n~<`OMQ5N2XP^a8IBN|GFg-9GN%7JP
zR3s{M*d*S@0iN7h%qKs?ELhL?D#SoC&JJLA{(J_9&-Y}$Bsa!=K0@C@BXrka4F>lU
z2%2ZAuXTPrIVuUXY0pR_iR^3sY@FaUZ$n-Ji$lV~4!14FSe3ngEy<7x9f!5L{P8Z)
znf&><>!3v?`H`DjU51^72Zxvt(HmoFr-aBCiQK8d_~cDW(<-dH7+DJo(n2eJ<VAT1
zflK<0bU;}TrItFGB+r>@8cqOqc>w-d9b07MuzB?d`^`%Zb!K;0N6-a=rcTEj%cJK9
zv7e<Kn5O^r0qPmrNAW#=mtF{!1(!{enG8vBY9duO#AFPgf^34cIMH2~ts^luT3nob
zW6{l_xyzGi&^yeB&`yc8?r&f~qiZq67*)aQ1c3!Yn-;%iGIh3$lkaNV(9m$23N&dB
z)Qj`c@D*@*Pg`5ktPDfash!a_fCX^=v_|WrX)AiAZuBoEH?*GnJ6NH?g6fF~cp*Vz
znf{SFiZn~pW#hhv#G!YL&Ogt$F3h+L!9Vg7zJfH2kX9LYrftWiRa6RZvG3QG4w0q&
zU>7l5FXRywUq?;6=fG8a5LubAeHL3hW!VXG@BFS%X9#xK==j|L(a!!g_~5%)oe~2)
zmVVSH4!-*)`CL^Uz9nPXcRze=RW#1?f(+dB$`xDsVciu$`>0J=_R?yPl^hn_HJJx#
zSLr}$hk3vuDnDf~)n0^9u74lNzIC^*`b#Bq_czdV<eR*3{p(0Y4h_rlV`t9BIcPqW
zf2r2g`hYYi-Pl7#%is%pFTS0jb1kGO&Dbz4%10ACza>KJUn>dN3LDiaz7nNw=E_U?
z6@)C=bB=@h?*yN}eDE&~!vB8A{ZB9SpX?C2Iefv2s7Rpjy#sV%Dnx(tKa#zO>PIfJ
zO=jW*8msbrdDYtS{%wR7aRPvdyqVFlZJAkbY~FE1NERApRIcM+1(ysEB_<k)zH)l&
z$JYx<xO5aegi^>+CwZK7Om5n%Ofn8SLcB9FvW=08&DJH|f=f(sBz7Q>{pe#8LEoBA
z_3QIPXg{LKl}4eIMta<!MkIL$MYF^AMXDw9Azd8EL0sj!plPQ|lu8=2d#HtLh^}3p
zf$l|H(o#BAs)g2EAt@WsaEPbc1rK;g<ea6Gep=F!HiQ;bQKB#c=<-G<CQHJivdOD^
zL|CN|>L?_9$Y8hVKaI_sCvxjsV0A&bfPhI)Tx3~&N2gqEplFMQKSl<Nl+(v}r$Qj`
z5P09ONomwosa6{LUg>%TJPfiIHNQ~kO7n$?qSDRne1vjh-37GQL9@s_;rC#4>NLld
zY{B1Zo}c9b5PvKjR9Rx?8km>(_{;ON;mt{&o9us=<QfDN5#(<9-pv2(`SY7lRk7}M
zLz-&zV}@~K(&XEfl4V9x$a*!1a%)5N(#&FTO-jA%p|m`83YkL=U{ojjOO=>S-?9dG
zI6X(b<vCTI3q^P3UvA@uj5f4h$a7h<kx*lY;G%ap78LYOO*v_Vw=Qv=sS*Ti&go&{
z6A+FLMcZUX)X$-qH+6W+Pu%Jot|&tn#;x61e3*@u^^W>l#S`J@_ACgzvS9Cir&IJ7
zEkLmTu!U$b4-Zei!t$ca2X-z!`*XVU%3e3z9$`s9Q)Bt`8i}$xyM!S*wPOo6HzA`)
z^J)AH<RWV7&se$~aJmvaRPNBRvF6`C8)S^0I(qcF#Z$epDVO9wxXq1U93rYkqD8Gc
zr1B;yDe2>;a<$%RjyKz;XG?z|r5!i7wQNGYLQ2W8Ry{RXBGP6MMUkMcHDrB}DI*!<
zWMYB<*C4K#5J*hW8k$KbS5quV*%Msy3ji)OMMz77E;jX^1BfB*UC6ZoJes2t7a!sC
z(v_f8A(k`8VqOG?T@)ZD41|s2u?d@a)W_?~pioKFdnka>xGzv>d+?^Fg-;?vkO(lt
zNYFr<`zO+iDbn#kY1q3IZ4zkSj%&17iB1oKe~JPn#J*v@X5$60CGCb<Gpa1g6kS#3
zoVl~j(@oFxe$C_%6sVW|(SVhU9=!F4vkLn(Gek5U`Vt8fbJ|~s_l0}_YgkyA##u_)
zdst@d36=6N@4HwQE_rhu2P+9o5b`m<qPCxFw9eYat^Hr{=l^7G^50Fd{<r!2f8EIX
ze{$10rxLrSOZJqk?6!xeK(Pd`<l*P%w_Y`RE&N=8$Zwi2o`3c{#9U&gTA|pxG?>u>
z4oz3rRN4R=Gk3Mb@2<&g=arTFt+z7NA*FNISSq1@^5ku^rI{C1R35_(W-5RC7BBKQ
z;@0bQU0svK2<>w8I_<+UQv%FmWrJ_Aq8n6N8cil>vfwipJiPVcg9q8czg*|$CS^i2
zAKy`DVle&EY57D6&Jc*t%`M=N0+^J0dqb1!#>9S=`QA4D3?kX-ol3n2TscV)`)q!Q
z1Tl5K<i;e6r(aSot={NuC{PS-!IW`p-dCPk1Oxp04;YPqZMVO%JOB8z0LTNa<+bI_
zd?@(BmDQQkx#O<w4}aN}Avp^Mk%8eyrf)4(+y6>l{^LjgmrMC)bt!xHS}&2v|IeU%
zY$26s*Lk{53@AsdZ)u&(73TIY{=%h(IuGIeNcEi5a?ykq>b8l(`MqfIV<HMQKXvny
za1tVDaiC+ugB__0nWTKWxmm*AQXJh$W~ePPr=KR<+O_$6+ilwa7Ja{pjPy9SXVYIG
zI0zF~NcFv-eql*JM|~*+VCsu`Drt?x2m=g3sndbhZH|7FYg$oSS{$TdvnrW8!Eji1
z+VO2VD*Sa>P7c!2=n;#{7b2|%R4cuung;n0L)6!iB?B+y{J~1qy}3jYH2x$xhGge_
z#9v|FgH7qK+KtG`r8Ah?g~Bi+gPSm)Okncse@c1rVkemnB-~gEK_MqfdRKP6USaQ#
zO54l29c3RL`uei&I%t^Qxa@GbWnQA4tRL5sD_%jgEAo3D7MNZ@BN#w3Q^aopxL*JN
z8(kZb))H+n9L3|6P$lo!;pAL#u*}VHsqv+!45Q-F#bxP-@(kS1?MYN?Ta#1KxvV8F
zF2M9%w3V&@{rt<rjZqq((N)vhn^jR!0gj?C@=cF~`S42w0*<mt{}T%A7ZN;UIEu}@
zDw!XyY}G^(@KdMluvK2I@yBM9;iu<HhCYv2J=>99Vn+YtNOuv}8eF6pdVG-QK)>j3
ztOOdKN$f-07rlYw(xkLXh}nbbw6ru)+82Jy8t99L>E$WEx9H>XGR2N~djS9bC4PKf
z7!wYVCsVNQ?OnP$9CM$hS_OJ~dUQY+9*h2d_j43diM~*}x5)jfp`p7vQ)W(d>k_fh
z(uLA@Wg$eKh~D4y;wodK<}|2X2pwn=K`CQ`1)U@*+Uo(T7}D8K1Pz}UjZiaCNFPwS
z@#4&{gcm^ENIqUD1OdN;pl#G~f%vcqJPTTHkjU8>F4FnDFcVYhY{F&Z<IKFO8%gIZ
zhnO`CCD)Tp2SP6*8u!^LcL#lmF&`gNyCP%jLyJP%Vv`$icY40lv*VtSD5h|OEElu#
zKvD;;E1-LswSl8gq9>a$GwL5@O_$f&^9!q7Zz-0m3AQoBI}Hu0!Ya>x6$Q?ZTUvAP
z3fjv()J#%$Kvxua5sio$=ttWRd!%}M0z?J5o>Te6=*Fcj$N!AO(--Uh$|~0>rv0ao
z|E*4)I5MYvppQEmOEW)W$W<|{>*xa@5~2Zs#$;n1#_@2~8ws@x`zB}W`e`Wln!7G-
z0G4?QQUjKPAtNbWq3!@JiYH2?791V>47J?d+@5)f?tu}V`FzLqh-%#BlTD5z#jphQ
zf#;AuIqnO~mujAfL|JhsXb{@5leceAma*}I?F9`%JWO2}!wO%NOTJcwp+tq+>F2Ai
zM_|or^XwB&>{QXKqjZQAw2wu9XMO(%YMuUp5dILUc(9J-c&v90-1i-g@5+vm#&#n7
zMe#)2Z|TO1$gdrtQn|C(BKEPG;l{Xca>fo9FD^`$!P#~vppUAvbO;)@jj614JP$!(
z<b3PU9*>u%eE#9T@@Ibsipe8C+^BotF=mkMB69*r?<LjGRTlgUF+LHfxag#9lu#w<
zr@Jgf?M+CEJ_LreZyaz_1!SuvsRoO51z*=jhhZ!VtukP<$0u)euk4acFKLW%?AS|c
z29U%AZ+J2-`Ses6RSHCbPJ|3mBAR3;#+%EpIywhIg+=Bb3DuiazL29vydgK;M5tRE
z-|v~Ww%y3CgTq#bqB|CJNHb?EECh}ATM47X#6(6AkOkYk<491|V+#TFxbF0+r^hB5
z*5)=O8tOndVn*aOgbpTRD~!u~k<Yrinz78uIv_b!JsK+=P*pYY$;}PHDG!VZ9VH<z
zG7trNvH|Inw_QSSY&URpZndnG8zL2hg2KXyD}IF?PcoSg+x$3qWGSZlknv%Ju_D|o
zDZyr-nB_e@JPdu?5c=lw$lM3CGanFONIMf!QjEb6KYK~dPdWy{vXe}jS;-{3ChJDy
zAxsj=!}O5Nt<yEh?Ggia3VsvI7!q3jX^gcfa1f@JOlTll-XVz1UewpS94__6!$nz-
z8Z(2T31@rFe`TC^{C?FN)R`wy6k<hK!c3P7+2|oA{pP6nJ@EC-g<zM1#5l*PLM^Z4
z%s%5BK9*^ZBLV)NA6hj^IglothOUdm{8|3%WHewXWPyb<OBfmkid%0*U<?ZxbD-eZ
z4(6H+HrN<(FxZC}GnBdTozJ49qd!)^4P2gamjQ$dYPm32(tms}Vu|%vFN^r+&$pLI
zEzA-^9-YbAF_24zj^k!ap&mm(0P*ds``aI^m=S?f1cCRWdkc=9z_xYOcvp@G`uWz8
zu3yr6n)dPV+$P0P6a!JzTE`WkI0w+6Wzk^p@))TTq8d8S=EW)VcFn3cJvUDvBO-$$
za-gI~9Qv_5v-1l?$;f`t?N4G;3nN3B5G6S$Lu=BszT18g7Y$X|HmbI!_WA0sHsm58
z&dG+`Mm1^yy~vyN1FV!CG0@E0FgkT7DJos0IU{BIBP(32v>4%3j5Y_+@TN>IhG1RD
zBfU|E%z+MpgNf;7kh49)rf3ft;YS*+!J*1!gv#(x8`bgiHm=*Gk_Nd3Cuxf|YDnOr
z##KN=2e1S3$(yw2O3i+d+L(H_ON~5{y$*CWYtaBcdntyu{X{52j0V>a@aJ~~A<La;
zMKR0pjkfQ~jfYX_AZjABV!_&MLJ>iNwa5A-Nga-avSToY8Ai6`l9^<1oQ%|jj1rqH
z0q}O<R*CP`#<0C((d(xJ`$dF71P(VsN3fTiIuPU`N-oVcsjziA9b+bTYo9;7l?+Ra
z#lFo6J?1_u%qwxzm1X@aU_au^3AaW>QKVh=%ZKNM{In)dpWqW|!%a<a0?rQ56Yx-X
zMP_+jMC<oH%uOOfE0`&pHgw!W7#cUdg~R?HaFPfl@!Z^G{M2r9!8bmxEcU-a*7apU
z@cD}uxoJ<zj&2-onjHyRU`Iu?zl`Rx5Q@##8$GnPibxkQhRB`h?>tG{%KaU(?Enq?
zw5<+r<$z|06v2oCC0*To)`xy-yU`Ll<mr=S+Nzm-$~AYjnTcL}J>(ZqZBuhZZVkNE
zc;(FCnuMg^o0vKzy{KA<;0Y1P6oSow5sLFX+}zRW{h|V+JfchZN7qLvM-`aPBpY@e
z5_K>kV3~~Xz>ova`}gk?UQqO$Ovp4gq&{w(U?$R*BExC-9BQBy2Mj8nZ$?!J6FtO9
zyNtHqQLbHWH<n*aHP<CIF-*DS#9m0B>!1Pm5@$+k&fBy*X?M_o%^Y#AODV0psYoxL
zh>}Ue!BfnnBs&b-`}2KSBHl2Ljv;%E13DFJwV29%nq3@3tHL}0Th;u0wX3J#js`<n
z8q^;|R)Il7$#o`Zpc#4?;~3`udg*E_6HTk?^Jc)GGT9}H<HZZ@V@b)GyhKn;lwj_8
zJm;hs4qqZ;h={b6gm-ZS4zu^Gc0u(P%&_jz=ewIRS-@l=ab*scV7bWWyGPq!O3fLN
zn?`(P=Fb>BLN*L8i%6o$7swD(=pNoZc~a)N+Rmi^NwE@=6T%OZ_GGw7(lfswGwXzc
z8WGMIc1NPkfPa1}XyFhwcMPJM(8!_~`dv!^NWPS|--%M%U1PPA`X2oqR9VecI_^7u
zl9T)gQTXp99sdx5E4zd8pbYjaz%ZF7snKiB9jaebrGnB#A?*dqBw<QUR<$#gY_xTw
zYjgP+Mmdqh2RD)#LQ}tff^zEXI9&=tsVVCJqmodhgD7NMfV|C7E91%yhTW05F+32=
zM8-s)bEBif^K%~k7>mZax0tNeGNdrGsYk-3)Xae{xSU~n4@z}qQKZxAVv>=H<i$r2
zLV?7$GF*G(hxH*pT6^Z9RMC-lU_M<lwnaxvjiJk**aJgZGBH1HZp2X(n>a88g&L)a
z+sXX+P|y_RYze-7UvCSJZExYa^4MZIgFT~w?GjfLk~WdHe`#q)GP?n#VQ~0FQ=;t)
zdj9T3>Q2cNUNVP(nmFP1ZKJ^=c;+#TkU9P!vQ=sF?3=$3wWYLl2Bw905h)=Ah-{dZ
zh)@RAV8Zk)^34v@pGL{xTxm);M#gi%4`aa4`3wL94>G4J7N3#`qyd)f#<oU$`^@G4
z^Q9wMr5arLcuSvMRI_nbcp91JO6lnlMJUHd^e#}UUO<A~9H@r<MeZvDW!Kvzs=x;6
zt@C}YB;MvsgeE>=MG?du^YU^Y>j!RmCgV*S$!vSnT3NZK%Wkz3k;$-N^7s?76a<J6
zRSyb1?eK&xbUSF9wH@(cYLp71mNr^N2;R!YNC-AK0N$GV2V@Rmq)I%c)`WB&V_Ubi
zW2%T38Tyvfnb<KG9vw}M!q|^UZVN2HLPj;=92oPVj?O$SH-xjXM=qBJdh5KqCMR3N
zpqTE5@|cKUA@gT~yq%0E@#c3PavvgUwdS$pgMm-3wwA}1mB%*St8IKdks?5k-Iixu
zD)?NW(`qY>x9ko(!(m~fl;h(zXSz3&!|#00Wfp+O9{){B(SipLCe-DjJ8#4(V|KVO
z6@yy7NV$y2fJU%@Hb2P5VLl=ztHEd{my77gY#dqu8y>Vypt~(mwU%H8y%{n-b|hv5
zqOJn)s{o;0Wg)3hxE!3(Oi-@mgX1b48)&6f*OHQ(o>nEa2NoF9(8yV8H`CY}XbM5P
zxz=3w1vPOp)y$k|gDPun#=5Ih*-TPG>a)fHv&fXX%1;ye0BOdoYd~F;pd-y@x~J@Z
zlv?tanaK*jtg6fYC0=vt(R8{Lpe30trJPre<|PYA<DzO>eTU9{j4f-?vH3D)Ju1=P
zYuo$Ltnq;L8YfK~OQ@fC1&|1KF(Z{NHg!Rzx5N~2vK}FZV9$m5frX@0TBAuiujF*O
zw@^9_i{k~IDq1qT4kvQhd{`@-P3G$8O-NyQ71e1%WHtySmoWlTn8M}z(IqKgZB8Hp
zW+y+;Vt)1vfhvuRWgWN87&7`y8Z-&WOsG>34e%oU2m3LqRoUAPvnz5TmaOcZ$IVie
zXT#cP<HVSfi%84Z0rMsFcA830c+dHpW*tKQ-qJ0SMmjgqpX5+<)+Ij4<7MvZL(C24
zy+>#*N4oomE_RKiz0^!z^3%|rfS;E!WNHcd7kk3FvoNKSjtqxhDWoOC0`005wmUD*
zI(=yY%nE3X)0O1|{DF+GpEMWrLu^%)YzGWA-ldO07E^PmU|&g`A1^}LtO<2Sb4;5k
z!jkj)73*1m*ht0x>i{emj<158=z+UilehEev!<JC*~}p+^^<>TL3}XBwYN*AvLIZd
zS-yIKns1+SB@p?22Xv&ElY<xu`5Ruj@)0U{o(ZA^n!v=)xEzRDuVw)&n1fO&!E}q}
z20qOU+vFrt<}(49nyMXjLHj}~5zEkM85!cqC}1kL<^kd~p^Ir)s}=gZ&Ol7&Zo*un
z5o3Arq3m^;Qh=GIa_C~3z?AYm6UZz&Tm5hW7|oW?s}i?e7}KjAxfmrUf4v3Ls4w7M
z<Kx(%!bH>A1!(dMlZn)*ACqVbqg3L_{f+22AQ?_2y$4g)#Cb)0+rp1y%K~*+y2p|x
zSe0H4)dkX%gsjuMGy03_Rxmu-iAm>aO;E%Q(^B{~(k#8_$k1lz1vKx}7)g0v{~bwE
z6WOGf({WE7jZQ=ET1`3&MEj+@tSYx*!{GQpt5h-^@6MT2%x<(^BkGKOhkXj|!ITgg
zm~-o@DBVL~cm@KW0%a{7*%%&fa{#BSNyhXyhF~S-l2C_8Mar6<Q#<xWM-q&t+;}2F
zPZN}lPfU{`C6;K|$ZcDE`9SJ6Z}9`LBWQ{f^M!K0w-pl@w@4lLTqt$ww@7vSxE2!5
zWEg@T$)B4bH-lRegSDwf(h`TN&dro~+!$w1SBy!{tbLSprO?)>)J%;nUBgV%#u~d+
zjwI)09rKv`DZ$MR%VEasy*kbr41@bTJ5Fp@Xv~g`&(50ZZ~UA^W=7wW;l#{8P$5AL
zY9=p<n1M82?wkm~K;x-CqGKg3%Gjcq2^9+_6$}|B%rt0x81HKw8K9@Pj75_nK8?*X
zI;61zGidwd`XityC&Od8xyd;2-njJuGR~MND|0fxgiDGHUuO26!q9igo$^oXK4(D@
zoI|WEND9J@sH~e_yOD75JAIXfe`&=KQw?(uude9WAT*z%nvKaegctjck+aFD5ioUf
z{QX6Vo%p)}I^=HzB-4=apd-e}U0Bl4KwL2Fu1-jpj!ktB?}L7JZw)KWiK-qUhV20m
zu6CWphB3obcifXO2GX1eJL{0J1tj8ANJJ2(>vjDS4V>};0}@kQF5GRZHcZH>hd$H4
zxmILy4%6?;jnctDlR@^<(ve!UtY$%kxSceo@?$K5Q-R5O1}_6@Ug)5&#g2De08!6T
zadfm&AvwkRD>wqx-X7>OOHIinVxw4NSs|mkABoc9DIPq9v@x>_raPM#J@x>dUj)c-
zNXl=us;$#Xw>F+Pv_$_qnL3GarF$06oH@e;al+I@_ahyzd?_1>1#Yacy?SbE-Vxcn
z{@1mQoD#a?*41{+N->QLcP$B&k%ilGn(8AwSaDK1(kx^W=yy=_*Nf_Z@~Pn|rO`w4
zuQ5;juS9>@o23!o#BE)oXL1tq8R>&A^l)E7Nzlj~UTdj^;+FBGWWjV(MDD3R(j8Zw
z#ah}H9T8!e)VyRRdzrS>jvYG){{u!CiaJ#Z6D7XP(F!uHm_q&-!)rT~!}1JiGMwoA
zv!NNRxR~YBBR$cvts<9YUse*_h2DcHZ_ugPUL0ai9Ai{hbE&Z^$nku>c;#!I#+ZHM
z>s_9C(V{U9-BxT2_vP_t87#v|(<P0JuWi<QCOA*j!XtgrXckkR>FbTGims?hON*P&
z6$oBq_7o0Jej-+uem8xGad^5w47$He3K!g+DlBX3243Hd%A|)=2E`(9?)0#&$L?Oc
zwG0VC#F!4C@kdJsiRx6Tz~ds5_;Oa4gX=C3<ss4X9na4^LKoyCL6c8Hnf~}A@gIp!
z^h80>98Zjii(sCC7g<yW65)udM8AJfx*=~RmVpe~qGK-n9rTD`K>%pCC6DN36HX){
zVxZ+RRI*cjWY+pZU_!?;-gwEz*L(Ah=;YXEN|=#FU&~;*mSAaJleDid)=BXD7h5;V
zMTy2OKcY}O*;?iT;cJ3{9Q_D;L}H8$3bCXV!_7@LXL}?Kg6H_0tUxHIX04Tk`wjEK
zVq>!1PHt|%n;<g(a}(jJ@jUk;dRhDHPJ%qgWj!}AnDxfEJ(>hsk@|PPJgISrnY9O&
z*dX{KB3DO0+8DcW8H2_L8!g!4!Gj00srjQ~`q$z5l=a_bLOnWltqnoU#IL#rx$~^G
zjEQzl<#`Yoc?&KM6C>+$xbn<q1?Bh}>lm4nk1F<ttlRnMkGm&g-_-MVF+W&iugLw&
z-LLnRJFl{AYE=5kfGKruMftm<zcM}0D+}S~?qWF}>87Z-dqzT<s~{#!C+N(|K<`R@
zYip^XiJ~n1b*4A%xTN?_vT|{0#l_Fj2E|Jc`m=IyRHJ`&ezF<x`^m0Eg#gj9TDz4i
zSB{~x`q%_UJcMUvHXHF*rx=82wQ5X{1O&O;P4ovqbhEUWV?|-{f~~m86E4k6`|}u7
z7Lu3r=x2*h7lgcpKT724Nj9V<->}kH#^8EQ5mAjHB*kSR3*K?hNl`q)xWMjVaRum(
z?>leYiD~Fur;Ly(=shj$I4B{(Q6OrF;3=!uR9+rpBoxtE8sx8iHdVc*w>Oeg+%_11
z%xP*^H^)#T!?xT*;IYT*8^7!6=@p4$koS2Z|MMY=cemrgzQV-%e7m0R?sNN?<%~u~
zM(oFXAEPN;aR2_TCsDaSyXWERjRSD~#VLu2<PKi!KbNYm9Dc3>Z0I=+jZ72Pi29A&
z7e=Nsw!Ew~n97Rr<Jam2O!zV~HDy;^RMdqL76l#VAscf(6x_IB#9?~Z!bpJ2xTW!Z
zTJ#bISEr4bnss=$dFs<G(EsT!M90ThdYCq)ToQZ{1Xk(1n%drzX$}+7NDMxUco|Gu
zV=|dyjfNaXA<jn)9z1X$^vM&}9PRywyq-acbp>=fCi~t+JM_Fk6y}3<gZR@+kBE@H
zE&V>y=TsQJpgqpW$Y_YZ6PJL>2`8t8c@3-~*#CI;ymA<NqG_w7r?<E4botMQwzeYI
zGGZ^DMoX6O_J^l-gjE{Y1?soU?ew{7YFgXW^whDHQGCIkW&46s_=9LInn}{i@4mxB
ziLw>v%QGulxPM~1W!u{&RyH<0$W)Z+YXw-C<E%1%DTyt1Ot3RuLr+5+(5GPXmt-RS
z0|SKy$^aN>g8ZtdjE$r07IY+o7^C9n+S=L{B-J86sXYidWN|!4`waYkNQ~9U7rDya
z-3scp)d0c1=LaX8w3aPf=F&vdEo7EEefmmmw8n2b51-G^J1c#!c3PaX7Cp#T@Ee<o
zX)P=A7iwyhJ-xj4+&dAeY)e}u_HQmM-sx{9S<{^5)ac=0Z@+Y|#*AGf<=QXz4~mIJ
z++yTX_3V3j^X7M%&U30+0}+^fdHznY;U}QQJr7Tz->@Q9C-1@OogHb>_w%27u^%F2
zXr|rBab&~`30^&Edp53y4}6%Go}TEk;G7!0w{+w|{$<OKf=y2Ivnp7V!Y8F>><HKf
z=H_QPI5-+&b#AHGo_BJ}w0CeA`}AQY63r-)7Dyw>2k=-PpFSSg$;0f<6CfW!qiJEP
zUIqRX#|5%L2N%#dh-sQ(VmAG-_+t*^z55qT_dKisKl8A(bF8a;n?{yn{nf}zo$s}c
z*#ByyMq0Iy9J0$FDoQFK?8}d3$h6LBY4LxRv4{;2vxzp7#;ZLn3X3XX&@<9!$UY|j
zT-`z!|3naeXFB#9RaL{U+;^5zL=JwHexStXS7^vVbq(Rae-a7&fB5po6_j8O-*el&
wda+{w7kGy3C+go%p}YTUSM{d@zgl2mJm9(K%JIQB<d`Rq$xBBc`Sthz1B71a_W%F@

diff --git a/reference/plot-4.png b/reference/plot-4.png
index 6e3a2e15ea7ffe6c1d489449fb845a1522100481..61ac5bd052b62573eebe20255346604f0a0cda10 100644
GIT binary patch
literal 25157
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

literal 40277
zcmeFZcT`hb`!$M+l_S`YBMPWA1q2N$QX>jN06}^Q#R4cLAe~SG;!&_55So#u(rcu5
zf|U{=(o2Adln_E_A)%yj7oPY1e)o=X$N0wm_l_?^5=eITUVA;yGoLx<+S?a*40R43
z5I(@e!*dX(t7XE&vpbN7XV?9Gd%!!yqz_BrWzT(m9WC$*9ve67!@$e_$GX-&JUk+i
z+dn&Erk9;~cuw=cv^32EQ|HH!sYe-{mgRt}!8NDw(eHOgL`8U8f7_LKv*46#rObOX
z?G0nNX1<N<1;NFj$>QDc9RhiGJSzfE%OszT2tNS+d7pckD$7^D!C6kbbf&`q-R53~
zZ%U8R5q;7T5`#$#!L><~Hc*m(M)ZH4{?81683=Dj6l5KVY&khxbd33#w4aB^%%*m@
zWP5HtiQy9y$V+v-ZmptRLmr;@J?(A&yZ<|D+(W<q^Lx17OCE*)ylrN}8@S`&-`}I}
z$6W!xzGttt|M}XdF!5$S9v+$aPgz~)AUzd(6Iobv@nE&y$T^BW%t3e4tjC191vix=
z-+?`}a`H>^jmnBm+|ohM=m&MSL(xB$ukDAaX!lH`4HM1mdd|X*O5TpG7?Zqh3A-ub
zmu#lfqX+Ai<iLA=U!L>%l+}cOQ!aYjscTIIRxZ(*u!_zS>php*U|!)fr*i>A<!ZrN
zbX9Cj4#H9-Lr+s~!xZ#wGA4o&t7Eh3Ad3ufr#CEJ%$lP(tWuH|SIgB%+^BCj?^2SL
zW}W9Ll}HX&G(}wabE0`SHu1bNXEj8}&~lmOS<~mI>WxhnkG;9~{Lj1&Fy{s|Jf;Qp
zRg~okd(g)v^2o<vyU+KTqDS;>-kv56wK!r<JLZ_L`lwvd<Q#E1OMh^qEG$yU5%vC@
zLiBWqnk3{&vm?7-k|TxTxnG2zT2vQ{^DWH!B0;^}DH#)B%M_?Rb@N45%8>*{s(#%t
zY@o7%l!AHW_9qP21r<%WPu1FZMZ6`|F}Jv$=W4I_$R)2X>Z)9KHgkbYi?~e>UU%kw
z2yq#=^rk9I=?48IBZto9>mPCA&HtFuYql%0DmDuzX&tk!1B+<ry+X_$-4Dw;*v9Lf
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

diff --git a/reference/plot-5.png b/reference/plot-5.png
index 0ade0f658a6bd9447a29ca36c7a45905e86455da..150d49508a505ef27d7d8b3f0002a2fcfe640be5 100644
GIT binary patch
literal 26567
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

literal 40137
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
Y`DsNC31=lmKY~2(>FVdQ&MBb@0Jxaz>Hq)$

diff --git a/reference/plot-6.png b/reference/plot-6.png
index cce314be8894f0b26435e4f5774e21100be5c356..d77d841a44a14a12e45ea72bd1f5d3319bcc71c5 100644
GIT binary patch
literal 29775
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
bvh<|R+0$z;ditq`o|5$)``g0RTMzvO5Qy-$

literal 38447
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
B_Ei7?

diff --git a/reference/plot-7.png b/reference/plot-7.png
index 61ac5bd052b62573eebe20255346604f0a0cda10..594601a7906cbd350a3c4ec41150fe955436ab92 100644
GIT binary patch
literal 27064
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
LsiZ&8U;Ezxv?8lL

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

diff --git a/reference/plot-8.png b/reference/plot-8.png
index 150d49508a505ef27d7d8b3f0002a2fcfe640be5..a56f3acf2c21c9bc42e94bc286e48d279af3cab1 100644
GIT binary patch
literal 64884
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%0AB`
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
EZxb|+=Kufz

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

diff --git a/reference/plot-9.png b/reference/plot-9.png
index d77d841a44a14a12e45ea72bd1f5d3319bcc71c5..53732c2cf06cdfac324e821aba71818cda7f60d0 100644
GIT binary patch
literal 27111
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

literal 29775
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
bvh<|R+0$z;ditq`o|5$)``g0RTMzvO5Qy-$

diff --git a/reference/plot.html b/reference/plot.html
index 6ac7692e..973bdf27 100644
--- a/reference/plot.html
+++ b/reference/plot.html
@@ -12,7 +12,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -368,11 +368,11 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="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-4.png" alt="" width="700" height="433"></span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 23, 1</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-5.png" alt="" width="700" height="433"></span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 15, 1</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-6.png" alt="" width="700" height="433"></span>
+<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 15, 1</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># Plotting using scale_x_mic()</span></span></span>
@@ -385,38 +385,38 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"without scale_x_mic()"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-7.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-4.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_mic</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"with scale_x_mic()"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-8.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-5.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_mic</span><span class="op">(</span>keep_operators <span class="op">=</span> <span class="st">"all"</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/labs.html" class="external-link">labs</a></span><span class="op">(</span>title <span class="op">=</span> <span class="st">"with scale_x_mic() keeping all operators"</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="plot-9.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="plot-6.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">mic_plot</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_x_mic</span><span class="op">(</span>mic_range <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="fl">1</span>, <span class="fl">128</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 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-10.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></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">some_mic_values</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-8.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">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-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-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE):</span> arguments imply differing number of rows: 15, 1</span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">some_sir_values</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-13.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="co"># }</span></span></span>
 </code></pre></div>
     </div>
diff --git a/reference/proportion.html b/reference/proportion.html
index 933df950..a1bdc042 100644
--- a/reference/proportion.html
+++ b/reference/proportion.html
@@ -12,7 +12,7 @@ resistance() should be used to calculate resistance, susceptibility() should be
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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">
@@ -517,27 +517,21 @@ A microorganism is categorised as "Resistant" when there is a high likelihood of
 <span class="r-in"><span>    <span class="fu"><a href="https://dplyr.tidyverse.org/reference/group_by.html" class="external-link">group_by</a></span><span class="op">(</span><span class="va">ward</span><span class="op">)</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
 <span class="r-in"><span>    <span class="fu">sir_df</span><span class="op">(</span>translate <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 18 × 7</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>    ward       antibiotic interpretation value ci_min  ci_max isolates</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span>  <span style="color: #BCBCBC;">*</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;ord&gt;</span>          <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;int&gt;</span></span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> Clinical   AMX        SI             0.423 0.389  0.457        357</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 2</span> Clinical   AMX        R              0.577 0.543  0.611        487</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> Clinical   AMX        <span style="color: #BB0000;">NA</span>             0     0      0.004<span style="text-decoration: underline;">36</span>        0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> Clinical   CIP        SI             0.853 0.827  0.876        741</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> Clinical   CIP        R              0.147 0.124  0.173        128</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> Clinical   CIP        <span style="color: #BB0000;">NA</span>             0     0      0.004<span style="text-decoration: underline;">24</span>        0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> ICU        AMX        SI             0.369 0.323  0.417        158</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> ICU        AMX        R              0.631 0.583  0.677        270</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> ICU        AMX        <span style="color: #BB0000;">NA</span>             0     0      0.008<span style="text-decoration: underline;">58</span>        0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> ICU        CIP        SI             0.810 0.770  0.845        362</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">11</span> ICU        CIP        R              0.190 0.155  0.230         85</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">12</span> ICU        CIP        <span style="color: #BB0000;">NA</span>             0     0      0.008<span style="text-decoration: underline;">22</span>        0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">13</span> Outpatient AMX        SI             0.397 0.288  0.515         31</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">14</span> Outpatient AMX        R              0.603 0.485  0.712         47</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">15</span> Outpatient AMX        <span style="color: #BB0000;">NA</span>             0     0      0.046<span style="text-decoration: underline;">2</span>         0</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">16</span> Outpatient CIP        SI             0.839 0.748  0.907         78</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">17</span> Outpatient CIP        R              0.161 0.093<span style="text-decoration: underline;">2</span> 0.252         15</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">18</span> Outpatient CIP        <span style="color: #BB0000;">NA</span>             0     0      0.038<span style="text-decoration: underline;">9</span>         0</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 12 × 7</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>    ward       antibiotic interpretation value ci_min ci_max isolates</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span>  <span style="color: #BCBCBC;">*</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;ord&gt;</span>          <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;dbl&gt;</span>    <span style="color: #949494; font-style: italic;">&lt;int&gt;</span></span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 1</span> Clinical   AMX        SI             0.423 0.389   0.457      357</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 2</span> Clinical   AMX        R              0.577 0.543   0.611      487</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 3</span> Clinical   CIP        SI             0.853 0.827   0.876      741</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 4</span> Clinical   CIP        R              0.147 0.124   0.173      128</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 5</span> ICU        AMX        SI             0.369 0.323   0.417      158</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 6</span> ICU        AMX        R              0.631 0.583   0.677      270</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 7</span> ICU        CIP        SI             0.810 0.770   0.845      362</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 8</span> ICU        CIP        R              0.190 0.155   0.230       85</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;"> 9</span> Outpatient AMX        SI             0.397 0.288   0.515       31</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">10</span> Outpatient AMX        R              0.603 0.485   0.712       47</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">11</span> Outpatient CIP        SI             0.839 0.748   0.907       78</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">12</span> Outpatient CIP        R              0.161 0.093<span style="text-decoration: underline;">2</span>  0.252       15</span>
 <span class="r-in"><span><span class="co"># }</span></span></span>
 </code></pre></div>
     </div>
diff --git a/reference/random.html b/reference/random.html
index 5d9a201f..fa412b92 100644
--- a/reference/random.html
+++ b/reference/random.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/resistance_predict.html b/reference/resistance_predict.html
index d2d566c7..00e13d64 100644
--- a/reference/resistance_predict.html
+++ b/reference/resistance_predict.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 9852e10f..e289de5c 100644
--- a/reference/skewness.html
+++ b/reference/skewness.html
@@ -12,7 +12,7 @@ When negative ('left-skewed'): the left tail is longer; the mass of the distribu
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 e9223c07..8d4728b4 100644
--- a/reference/translate.html
+++ b/reference/translate.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9031</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9032</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 4dec9178..bce1b018 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to conduct AMR data analysis","text":"Conducting AMR data analysis unfortunately requires -depth knowledge different scientific fields, makes hard right. least, requires: Good questions (always start !) reliable data thorough understanding (clinical) epidemiology, understand clinical epidemiological relevance possible bias results thorough understanding (clinical) microbiology/infectious diseases, understand microorganisms causal infections implications pharmaceutical treatment, well understanding intrinsic acquired microbial resistance Experience data analysis microbiological tests results, understand determination limitations MIC values interpretations SIR values Availability biological taxonomy microorganisms probably normalisation factors pharmaceuticals, defined daily doses (DDD) Available (inter-)national guidelines, profound methods apply course, instantly provide knowledge experience. AMR package, aimed providing (1) tools simplify antimicrobial resistance data cleaning, transformation analysis, (2) methods easily incorporate international guidelines (3) scientifically reliable reference data, including requirements mentioned . AMR package enables standardised reproducible AMR data analysis, application evidence-based rules, determination first isolates, translation various codes microorganisms antimicrobial agents, determination (multi-drug) resistant microorganisms, calculation antimicrobial resistance, prevalence future trends.","code":""},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to conduct AMR data analysis","text":"tutorial, create fake demonstration data work . can skip Cleaning data already data ready. start analysis, try make structure data generally look like :","code":""},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"needed-r-packages","dir":"Articles","previous_headings":"Preparation","what":"Needed R packages","title":"How to conduct AMR data analysis","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2 RStudio. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. also use cleaner package, can used cleaning data creating frequency tables. AMR package contains data set example_isolates_unclean, might look data users extracted laboratory systems: AMR data analysis, like microorganism column contain valid, --date taxonomy, antibiotic columns cleaned SIR values well.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"dplyr\", \"ggplot2\", \"AMR\")) example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows # we will use 'our_data' as the data set name for this tutorial our_data <- example_isolates_unclean"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"taxonomy-of-microorganisms","dir":"Articles","previous_headings":"Preparation","what":"Taxonomy of microorganisms","title":"How to conduct AMR data analysis","text":".mo(), users can transform arbitrary microorganism names codes current taxonomy. AMR package contains --date taxonomic data. specific, currently included data retrieved 11 Dec 2022. 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) #> ℹ 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. #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterobacter cowanii (0.600), Eubacterium combesii #>               (0.600), Eggerthia catenaformis (0.591), Eubacterium callanderi #>               (0.591), Enterocloster citroniae (0.587), Eubacterium cylindroides #>               (0.583), Enterococcus casseliflavus (0.577), Enterobacter cloacae #>               cloacae (0.571), Enterobacter cloacae complex (0.571), and Ehrlichia #>               canis (0.567) #> -------------------------------------------------------------------------------- #> \"K. pneumoniae\" -> Klebsiella pneumoniae (B_KLBSL_PNMN, 0.786) #> Also matched: 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), Kosakonia pseudosacchari (0.361), Kaistella #>               palustris (0.333), Kocuria palustris (0.333), and Kocuria pelophila #>               (0.333) #> -------------------------------------------------------------------------------- #> \"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), Salmonella #>               Aurelianis (0.595), Salmonella Aarhus (0.588), Salmonella Amounderness #>               (0.587), Selenomonas artemidis (0.571), Salmonella choleraesuis #>               arizonae (0.562), Streptococcus anginosus anginosus (0.561), and #>               Salmonella Abaetetuba (0.548) #> -------------------------------------------------------------------------------- #> \"S. pneumoniae\" -> Streptococcus pneumoniae (B_STRPT_PNMN, 0.750) #> Also matched: Streptococcus pseudopneumoniae (0.700), Serratia #>               proteamaculans quinovora (0.545), Streptococcus pseudoporcinus (0.536), #>               Staphylococcus pseudintermedius (0.532), Serratia proteamaculans #>               proteamaculans (0.526), Salmonella Portanigra (0.524), Sphingomonas #>               paucimobilis (0.520), Streptococcus pluranimalium (0.519), #>               Streptococcus constellatus pharyngis (0.514), and Salmonella Pakistan #>               (0.500) #>  #> 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://msberends.github.io/AMR/articles/AMR.html","id":"antibiotic-results","dir":"Articles","previous_headings":"Preparation","what":"Antibiotic results","title":"How to conduct AMR data analysis","text":"column antibiotic test results must also cleaned. AMR package comes three new data types work test results: mic minimal inhibitory concentrations (MIC), disk disk diffusion diameters, sir SIR data interpreted already. package can also determine SIR values based MIC disk diffusion values, read .sir() page. now, just clean SIR columns data using dplyr: basically cleaning, time start data inclusion.","code":"# method 1, be explicit about the columns: our_data <- our_data %>%   mutate_at(vars(AMX:GEN), as.sir)  # method 2, let the AMR package determine the eligible columns our_data <- our_data %>%   mutate_if(is_sir_eligible, as.sir)  # result: our_data #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> #>  1 J3         A        2012-11-21 B_ESCHR_COLI R     I     S     S     #>  2 R7         A        2018-04-03 B_KLBSL_PNMN R     I     S     S     #>  3 P3         A        2014-09-19 B_ESCHR_COLI R     S     S     S     #>  4 P10        A        2015-12-10 B_ESCHR_COLI S     I     S     S     #>  5 B7         A        2015-03-02 B_ESCHR_COLI S     S     S     S     #>  6 W3         A        2018-03-31 B_STPHY_AURS R     S     R     S     #>  7 J8         A        2016-06-14 B_ESCHR_COLI R     S     S     S     #>  8 M3         A        2015-10-25 B_ESCHR_COLI R     S     S     S     #>  9 J3         A        2019-06-19 B_ESCHR_COLI S     S     S     S     #> 10 G6         A        2015-04-27 B_STPHY_AURS S     S     S     S     #> # ℹ 2,990 more rows"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"first-isolates","dir":"Articles","previous_headings":"Preparation","what":"First isolates","title":"How to conduct AMR data analysis","text":"need know isolates can actually use analysis without repetition bias. conduct analysis antimicrobial resistance, must include first isolate every patient per episode (Hindler et al., Clin Infect Dis. 2007). , easily get overestimate underestimate resistance antibiotic. Imagine patient admitted MRSA found 5 different blood cultures following weeks (yes, countries like Netherlands blood drawing policies). resistance percentage oxacillin isolates overestimated, included MRSA . clearly selection bias. Clinical Laboratory Standards Institute (CLSI) appoints follows: (…) preparing cumulative antibiogram guide clinical decisions empirical antimicrobial therapy initial infections, first isolate given species per patient, per analysis period (eg, one year) included, irrespective body site, antimicrobial susceptibility profile, phenotypical characteristics (eg, biotype). first isolate easily identified, cumulative antimicrobial susceptibility test data prepared using first isolate generally comparable cumulative antimicrobial susceptibility test data calculated methods, providing duplicate isolates excluded. M39-A4 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 4th Edition. CLSI, 2014. Chapter 6.4 AMR package includes methodology first_isolate() function able apply four different methods defined Hindler et al. 2007: phenotype-based, episode-based, patient-based, isolate-based. right method depends goals analysis, default phenotype-based method case method properly correct duplicate isolates. Read methods first_isolate() page. outcome function can easily added data: 90% suitable resistance analysis! can now filter filter() function, also dplyr package: future use, two syntaxes can shortened: end 2 712 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,712 'phenotype-based' first isolates (90.4% 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,712 × 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 P10        A        2015-12-10 B_ESCHR_COLI S     I     S     S     TRUE  #>  4 B7         A        2015-03-02 B_ESCHR_COLI S     S     S     S     TRUE  #>  5 W3         A        2018-03-31 B_STPHY_AURS R     S     R     S     TRUE  #>  6 M3         A        2015-10-25 B_ESCHR_COLI R     S     S     S     TRUE  #>  7 J3         A        2019-06-19 B_ESCHR_COLI S     S     S     S     TRUE  #>  8 G6         A        2015-04-27 B_STPHY_AURS S     S     S     S     TRUE  #>  9 P4         A        2011-06-21 B_ESCHR_COLI S     S     S     S     TRUE  #> 10 Z1         A        2014-09-05 B_ESCHR_COLI S     S     S     S     TRUE  #> # ℹ 2,702 more rows"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"analysing-the-data","dir":"Articles","previous_headings":"","what":"Analysing the data","title":"How to conduct AMR data analysis","text":"base R summary() function gives good first impression, comes support new mo sir classes now data set:","code":"summary(our_data_1st) #>   patient_id          hospital              date            #>  Length:2712        Length:2712        Min.   :2011-01-01   #>  Class :character   Class :character   1st Qu.:2013-05-03   #>  Mode  :character   Mode  :character   Median :2015-06-16   #>                                        Mean   :2015-06-21   #>                                        3rd Qu.:2017-08-24   #>                                        Max.   :2019-12-27   #>    bacteria               AMX                    AMC                 #>  Class :mo             Class:sir              Class:sir              #>  <NA>  :0              %R   :42.9% (n=1163)   %R   :36.1% (n=978)    #>  Unique:4              %SI  :57.1% (n=1549)   %SI  :63.9% (n=1734)   #>  #1    :B_ESCHR_COLI   - %S :41.0% (n=1112)   - %S :52.0% (n=1409)   #>  #2    :B_STPHY_AURS   - %I :16.1% (n=437)    - %I :12.0% (n=325)    #>  #3    :B_STRPT_PNMN                                                 #>     CIP                    GEN                  first         #>  Class:sir              Class:sir              Mode:logical   #>  %R   :42.0% (n=1138)   %R   :37.3% (n=1011)   TRUE:2712      #>  %SI  :58.0% (n=1574)   %SI  :62.7% (n=1701)                  #>  - %S :51.5% (n=1396)   - %S :59.6% (n=1616)                  #>  - %I : 6.6% (n=178)    - %I : 3.1% (n=85)                    #> glimpse(our_data_1st) #> Rows: 2,712 #> Columns: 9 #> $ patient_id <chr> \"J3\", \"R7\", \"P10\", \"B7\", \"W3\", \"M3\", \"J3\", \"G6\", \"P4\", \"Z1\"… #> $ hospital   <chr> \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\",… #> $ date       <date> 2012-11-21, 2018-04-03, 2015-12-10, 2015-03-02, 2018-03-31… #> $ bacteria   <mo> \"B_ESCHR_COLI\", \"B_KLBSL_PNMN\", \"B_ESCHR_COLI\", \"B_ESCHR_COL… #> $ AMX        <sir> R, R, S, S, R, R, S, S, S, S, R, S, S, S, R, R, R, R, S, R,… #> $ AMC        <sir> I, I, I, S, S, S, S, S, S, S, S, S, I, S, S, S, S, R, S, S,… #> $ CIP        <sir> S, S, S, S, R, S, 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, R, S, 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       1852          4          3          3          3  #>        GEN      first  #>          3          1"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"availability-of-species","dir":"Articles","previous_headings":"Analysing the data","what":"Availability of species","title":"How to conduct AMR data analysis","text":"just get idea species distributed, create frequency table count() based name microorganisms:","code":"our_data %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1518 #> 2 Staphylococcus aureus      730 #> 3 Streptococcus pneumoniae   426 #> 4 Klebsiella pneumoniae      326 our_data_1st %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1319 #> 2 Staphylococcus aureus      676 #> 3 Streptococcus pneumoniae   400 #> 4 Klebsiella pneumoniae      317"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"select-and-filter-with-antibiotic-selectors","dir":"Articles","previous_headings":"Analysing the data","what":"Select and filter with antibiotic selectors","title":"How to conduct AMR data analysis","text":"Using -called antibiotic class selectors, can select filter columns based antibiotic class antibiotic results :","code":"our_data_1st %>%   select(date, aminoglycosides()) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 2,712 × 2 #>    date       GEN   #>    <date>     <sir> #>  1 2012-11-21 S     #>  2 2018-04-03 S     #>  3 2015-12-10 S     #>  4 2015-03-02 S     #>  5 2018-03-31 S     #>  6 2015-10-25 S     #>  7 2019-06-19 S     #>  8 2015-04-27 S     #>  9 2011-06-21 S     #> 10 2014-09-05 S     #> # ℹ 2,702 more rows our_data_1st %>%   select(bacteria, betalactams()) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 2,712 × 3 #>    bacteria     AMX   AMC   #>    <mo>         <sir> <sir> #>  1 B_ESCHR_COLI R     I     #>  2 B_KLBSL_PNMN R     I     #>  3 B_ESCHR_COLI S     I     #>  4 B_ESCHR_COLI S     S     #>  5 B_STPHY_AURS R     S     #>  6 B_ESCHR_COLI R     S     #>  7 B_ESCHR_COLI S     S     #>  8 B_STPHY_AURS S     S     #>  9 B_ESCHR_COLI S     S     #> 10 B_ESCHR_COLI S     S     #> # ℹ 2,702 more rows our_data_1st %>%   select(bacteria, where(is.sir)) #> # A tibble: 2,712 × 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 S     I     S     S     #>  4 B_ESCHR_COLI S     S     S     S     #>  5 B_STPHY_AURS R     S     R     S     #>  6 B_ESCHR_COLI R     S     S     S     #>  7 B_ESCHR_COLI S     S     S     S     #>  8 B_STPHY_AURS S     S     S     S     #>  9 B_ESCHR_COLI S     S     S     S     #> 10 B_ESCHR_COLI S     S     S     S     #> # ℹ 2,702 more rows # filtering using AB selectors is also possible: our_data_1st %>%   filter(any(aminoglycosides() == \"R\")) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 1,011 × 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  #> # ℹ 1,001 more rows our_data_1st %>%   filter(all(betalactams() == \"R\")) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 483 × 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  #> # ℹ 473 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: 483 × 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  #> # ℹ 473 more rows"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"generate-antibiograms","dir":"Articles","previous_headings":"Analysing the data","what":"Generate antibiograms","title":"How to conduct AMR data analysis","text":"Since AMR v2.0 (March 2023), easy create different types antibiograms, support 20 different languages. four antibiogram types, proposed Klinker et al. (2021, DOI 10.1177/20499361211011373), supported new antibiogram() function: Traditional Antibiogram (TA) e.g, susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Combination Antibiogram (CA) e.g, sdditional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Syndromic Antibiogram (SA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Weighted-Incidence Syndromic Combination Antibiogram (WISCA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure section, show use antibiogram() function create antibiogram types. starters, included example_isolates data set looks like:","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"traditional-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Traditional Antibiogram","title":"How to conduct AMR data analysis","text":"create traditional antibiogram, simply state antibiotics used. antibiotics argument antibiogram() function supports (combination) previously mentioned antibiotic class selectors: Notice antibiogram() function automatically prints right format using Quarto R Markdown (page), even applies italics taxonomic names (using italicise_taxonomy() internally). also uses language OS either English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. next example, force language Spanish using language argument:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             mo_transform = \"gramstain\",             antibiotics = aminoglycosides(),             ab_transform = \"name\",             language = \"es\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin)"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"combined-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Combined Antibiogram","title":"How to conduct AMR data analysis","text":"create combined antibiogram, use antibiotic codes names plus + character like :","code":"antibiogram(example_isolates,             antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"syndromic-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Syndromic Antibiogram","title":"How to conduct AMR data analysis","text":"create syndromic antibiogram, syndromic_group argument must used. can column data, e.g. ifelse() calculations based certain columns:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems()),             syndromic_group = \"ward\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem)"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"weighted-incidence-syndromic-combination-antibiogram-wisca","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Weighted-Incidence Syndromic Combination Antibiogram (WISCA)","title":"How to conduct AMR data analysis","text":"create WISCA, must state combination therapy antibiotics argument (similar Combination Antibiogram), define syndromic group syndromic_group argument (similar Syndromic Antibiogram) cases predefined based clinical demographic characteristics (e.g., endocarditis 75+ females). next example simplification without clinical characteristics, just gives idea WISCA can created:","code":"wisca <- antibiogram(example_isolates,                      antibiotics = c(\"AMC\", \"AMC+CIP\", \"TZP\", \"TZP+TOB\"),                      mo_transform = \"gramstain\",                      minimum = 10, # this should be >= 30, but now just as example                      syndromic_group = ifelse(example_isolates$age >= 65 &                                                 example_isolates$gender == \"M\",                                               \"WISCA Group 1\", \"WISCA Group 2\")) wisca"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"plotting-antibiograms","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Plotting antibiograms","title":"How to conduct AMR data analysis","text":"Antibiograms can plotted using autoplot() ggplot2 packages, since AMR package provides extension function:  calculate antimicrobial resistance sensible way, also correcting results, use resistance() susceptibility() functions.","code":"autoplot(wisca)"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"resistance-percentages","dir":"Articles","previous_headings":"Analysing the data","what":"Resistance percentages","title":"How to conduct AMR data analysis","text":"functions resistance() susceptibility() can used calculate antimicrobial resistance susceptibility. specific analyses, functions proportion_S(), proportion_SI(), proportion_I(), proportion_IR() proportion_R() can used determine proportion specific antimicrobial outcome. functions contain minimum argument, denoting minimum required number test results returning value. functions otherwise return NA. default minimum = 30, following CLSI M39-A4 guideline applying microbial epidemiology. per EUCAST guideline 2019, calculate resistance proportion R (proportion_R(), equal resistance()) susceptibility proportion S (proportion_SI(), equal susceptibility()). functions can used : can used conjunction group_by() summarise(), dplyr package: Author: Dr. Matthijs Berends, 26th Feb 2023","code":"our_data_1st %>% resistance(AMX) #> [1] 0.4288348 our_data_1st %>%   group_by(hospital) %>%   summarise(amoxicillin = resistance(AMX)) #> # A tibble: 3 × 2 #>   hospital amoxicillin #>   <chr>          <dbl> #> 1 A              0.342 #> 2 B              0.564 #> 3 C              0.372"},{"path":"https://msberends.github.io/AMR/articles/EUCAST.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to apply EUCAST rules","text":"EUCAST rules? European Committee Antimicrobial Susceptibility Testing (EUCAST) states website: EUCAST expert rules tabulated collection expert knowledge intrinsic resistances, exceptional resistance phenotypes interpretive rules may applied antimicrobial susceptibility testing order reduce errors make appropriate recommendations reporting particular resistances. Europe, lot medical microbiological laboratories already apply rules (Brown et al., 2015). package features latest insights intrinsic resistance unusual phenotypes (v3.1, 2016). Moreover, eucast_rules() function use purpose can also apply additional rules, like forcing ampicillin = R isolates amoxicillin/clavulanic acid = R.","code":""},{"path":"https://msberends.github.io/AMR/articles/EUCAST.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to apply EUCAST rules","text":"rules can used discard impossible 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 ampicillin susceptible ampicillin. antibiogram available identification available, antibiogram re-interpreted based identification (namely, Klebsiella). EUCAST expert rules solve , can applied using eucast_rules(): convenient function mo_is_intrinsic_resistant() uses guideline, allows check one specific microorganisms antibiotics: EUCAST rules can used correction, can also used filling known resistance susceptibility based results antimicrobials drugs. process called interpretive reading, basically form imputation, part eucast_rules() function well:","code":"oops <- data.frame(   mo = c(     \"Klebsiella\",     \"Escherichia\"   ),   ampicillin = \"S\" ) oops #>            mo ampicillin #> 1  Klebsiella          S #> 2 Escherichia          S eucast_rules(oops, info = FALSE) #>            mo ampicillin #> 1  Klebsiella          R #> 2 Escherichia          S mo_is_intrinsic_resistant(   c(\"Klebsiella\", \"Escherichia\"),   \"ampicillin\" ) #> [1]  TRUE FALSE mo_is_intrinsic_resistant(   \"Klebsiella\",   c(\"ampicillin\", \"kanamycin\") ) #> [1]  TRUE FALSE data <- 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\", # Benzylenicillin   FOX = \"S\", # Cefoxitin   stringsAsFactors = FALSE ) data eucast_rules(data)"},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"type-of-input","dir":"Articles","previous_headings":"","what":"Type of input","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function takes data set input, regular data.frame. tries automatically determine right columns info isolates, name species columns results antimicrobial agents. See help page info set right settings data command ?mdro. WHONET data (data), settings automatically set correctly.","code":""},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"guidelines","dir":"Articles","previous_headings":"","what":"Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function support multiple guidelines. can select guideline guideline parameter. Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. “Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.” Clinical Microbiology Infection (2012) (link) guideline = \"EUCAST3.2\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.2 “Intrinsic Resistance Unusual Phenotypes” (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 “Intrinsic Resistance Exceptional Phenotypes Tables” (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization “Companion handbook guidelines programmatic management drug-resistant tuberculosis” (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7. DOI: 10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Rijksinstituut voor Volksgezondheid en Milieu “WIP-richtlijn BRMO (Bijzonder Resistente Micro-Organismen) (ZKH)” (link) Please suggest (country-specific) guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"custom-guidelines","dir":"Articles","previous_headings":"Guidelines","what":"Custom Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"can also use custom guideline. Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() dplyr package, recognise input method set rules. Rules must set using R considers ‘formula notation’: row/isolate matches first rule, value first ~ (case ‘Elderly Type ’) set MDRO value. Otherwise, second rule tried . maximum number rules unlimited. can print rules set console overview. Colours help reading console supports colours. outcome function can used guideline argument mdro() function: rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) custom #> A set of custom MDRO rules: #>   1. If CIP is \"R\" and age is higher than 60 then: Elderly Type A #>   2. If ERY is \"R\" and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B x <- mdro(example_isolates, guideline = custom) table(x) #> x #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732"},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function always returns ordered factor predefined guidelines. example, output default guideline Magiorakos et al. returns factor levels ‘Negative’, ‘MDR’, ‘XDR’ ‘PDR’ order. next example uses example_isolates data set. data set included package contains full antibiograms 2,000 microbial isolates. reflects reality can used practise AMR data analysis. test MDR/XDR/PDR guideline data set, get: Frequency table Class: factor > ordered (numeric) Length: 2,000 Levels: 4: Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant … Available: 1,729 (86.45%, NA: 271 = 13.55%) Unique: 2 another example, create data set determine multi-drug resistant TB: column names automatically verified valid drug names codes, worked exactly way: data set now looks like : can now add interpretation MDR-TB data set. can use: shortcut mdr_tb(): Create frequency table results: Frequency table Class: factor > ordered (numeric) Length: 5,000 Levels: 5: Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant <… Available: 5,000 (100%, NA: 0 = 0%) Unique: 5","code":"library(dplyr) # to support pipes: %>% library(cleaner) # to create frequency tables example_isolates %>%   mdro() %>%   freq() # show frequency table of the result #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) # random_sir() is a helper function to generate # a random vector with values S, I and R my_TB_data <- data.frame(   rifampicin = random_sir(5000),   isoniazid = random_sir(5000),   gatifloxacin = random_sir(5000),   ethambutol = random_sir(5000),   pyrazinamide = random_sir(5000),   moxifloxacin = random_sir(5000),   kanamycin = random_sir(5000) ) my_TB_data <- data.frame(   RIF = random_sir(5000),   INH = random_sir(5000),   GAT = random_sir(5000),   ETH = random_sir(5000),   PZA = random_sir(5000),   MFX = random_sir(5000),   KAN = random_sir(5000) ) head(my_TB_data) #>   rifampicin isoniazid gatifloxacin ethambutol pyrazinamide moxifloxacin #> 1          I         R            S          S            S            S #> 2          S         S            I          R            R            S #> 3          R         I            I          I            R            I #> 4          I         S            S          S            S            S #> 5          I         I            I          S            I            S #> 6          R         S            R          S            I            I #>   kanamycin #> 1         R #> 2         I #> 3         S #> 4         I #> 5         I #> 6         I mdro(my_TB_data, guideline = \"TB\") my_TB_data$mdr <- mdr_tb(my_TB_data) #> ℹ No column found as input for col_mo, assuming all rows contain #>   Mycobacterium tuberculosis. freq(my_TB_data$mdr)"},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"How to conduct principal component analysis (PCA) for AMR","text":"PCA, need transform AMR data first. example_isolates data set package looks like: Now transform data set resistance percentages per taxonomic order genus:","code":"library(AMR) library(dplyr) glimpse(example_isolates) #> Rows: 2,000 #> Columns: 46 #> $ date    <date> 2002-01-02, 2002-01-03, 2002-01-07, 2002-01-07, 2002-01-13, 2… #> $ patient <chr> \"A77334\", \"A77334\", \"067927\", \"067927\", \"067927\", \"067927\", \"4… #> $ age     <dbl> 65, 65, 45, 45, 45, 45, 78, 78, 45, 79, 67, 67, 71, 71, 75, 50… #> $ gender  <chr> \"F\", \"F\", \"F\", \"F\", \"F\", \"F\", \"M\", \"M\", \"F\", \"F\", \"M\", \"M\", \"M… #> $ ward    <chr> \"Clinical\", \"Clinical\", \"ICU\", \"ICU\", \"ICU\", \"ICU\", \"Clinical\"… #> $ mo      <mo> \"B_ESCHR_COLI\", \"B_ESCHR_COLI\", \"B_STPHY_EPDR\", \"B_STPHY_EPDR\",… #> $ PEN     <sir> R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, S,… #> $ OXA     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ FLC     <sir> NA, NA, R, R, R, R, S, S, R, S, S, S, NA, NA, NA, NA, NA, R, R… #> $ AMX     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ AMC     <sir> I, I, NA, NA, NA, NA, S, S, NA, NA, S, S, I, I, R, I, I, NA, N… #> $ AMP     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ TZP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CZO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ FEP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CXM     <sir> I, I, R, R, R, R, S, S, R, S, S, S, S, S, NA, S, S, R, R, S, S… #> $ FOX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ CTX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ CAZ     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, S, S, R, R, … #> $ CRO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ GEN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TOB     <sir> NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, S, S, NA, NA, NA… #> $ AMK     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ KAN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TMP     <sir> R, R, S, S, R, R, R, R, S, S, NA, NA, S, S, S, S, S, R, R, R, … #> $ SXT     <sir> R, R, S, S, NA, NA, NA, NA, S, S, NA, NA, S, S, S, S, S, NA, N… #> $ NIT     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R,… #> $ FOS     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ LNZ     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ CIP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, NA, S, S… #> $ MFX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ VAN     <sir> R, R, S, S, S, S, S, S, S, S, NA, NA, R, R, R, R, R, S, S, S, … #> $ TEC     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ TCY     <sir> R, R, S, S, S, S, S, S, S, I, S, S, NA, NA, I, R, R, S, I, R, … #> $ TGC     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ DOX     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ ERY     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ CLI     <sir> R, R, NA, NA, NA, R, NA, NA, NA, NA, NA, NA, R, R, R, R, R, NA… #> $ AZM     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ IPM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ MEM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ MTR     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CHL     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ COL     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, R, R, R, R, … #> $ MUP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ RIF     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… resistance_data <- example_isolates %>%   group_by(     order = mo_order(mo), # group on anything, like order     genus = mo_genus(mo)   ) %>% #  and genus as we do here   summarise_if(is.sir, resistance) %>% # then get resistance of all drugs   select(     order, genus, AMC, CXM, CTX,     CAZ, GEN, TOB, TMP, SXT   ) # and select only relevant columns  head(resistance_data) #> # A tibble: 6 × 10 #> # Groups:   order [5] #>   order             genus          AMC   CXM   CTX   CAZ   GEN   TOB   TMP   SXT #>   <chr>             <chr>        <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 (unknown order)   (unknown ge…    NA    NA    NA    NA    NA    NA    NA    NA #> 2 Actinomycetales   Schaalia        NA    NA    NA    NA    NA    NA    NA    NA #> 3 Bacteroidales     Bacteroides     NA    NA    NA    NA    NA    NA    NA    NA #> 4 Campylobacterales Campylobact…    NA    NA    NA    NA    NA    NA    NA    NA #> 5 Caryophanales     Gemella         NA    NA    NA    NA    NA    NA    NA    NA #> 6 Caryophanales     Listeria        NA    NA    NA    NA    NA    NA    NA    NA"},{"path":"https://msberends.github.io/AMR/articles/PCA.html","id":"perform-principal-component-analysis","dir":"Articles","previous_headings":"","what":"Perform principal component analysis","title":"How to conduct principal component analysis (PCA) for AMR","text":"new pca() function automatically filter rows contain numeric values selected variables, now need : result can reviewed good old summary() function: Good news. first two components explain total 93.3% variance (see PC1 PC2 values Proportion Variance. can create -called biplot base R biplot() function, see antimicrobial resistance per drug explain difference per microorganism.","code":"pca_result <- pca(resistance_data) #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. summary(pca_result) #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\" #> Importance of components: #>                           PC1    PC2    PC3     PC4     PC5     PC6       PC7 #> Standard deviation     2.1539 1.6807 0.6138 0.33879 0.20808 0.03140 1.232e-16 #> Proportion of Variance 0.5799 0.3531 0.0471 0.01435 0.00541 0.00012 0.000e+00 #> Cumulative Proportion  0.5799 0.9330 0.9801 0.99446 0.99988 1.00000 1.000e+00 #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\""},{"path":"https://msberends.github.io/AMR/articles/PCA.html","id":"plotting-the-results","dir":"Articles","previous_headings":"","what":"Plotting the results","title":"How to conduct principal component analysis (PCA) for AMR","text":"can’t see explanation points. Perhaps works better new ggplot_pca() function, automatically adds right labels even groups:  can also print ellipse per group, edit appearance:","code":"biplot(pca_result) ggplot_pca(pca_result) ggplot_pca(pca_result, ellipse = TRUE) +   ggplot2::labs(title = \"An AMR/PCA biplot!\")"},{"path":"https://msberends.github.io/AMR/articles/WHONET.html","id":"import-of-data","dir":"Articles","previous_headings":"","what":"Import of data","title":"How to work with WHONET data","text":"tutorial assumes already imported WHONET data e.g. readxl package. RStudio, can done using menu button ‘Import Dataset’ tab ‘Environment’. Choose option ‘Excel’ select exported file. Make sure date fields imported correctly. example syntax look like : package comes example data set WHONET. use analysis.","code":"library(readxl) data <- read_excel(path = \"path/to/your/file.xlsx\")"},{"path":"https://msberends.github.io/AMR/articles/WHONET.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to work with WHONET data","text":"First, load relevant packages yet . use tidyverse analyses. . don’t know yet, suggest read website: https://www.tidyverse.org/. transform variables simplify automate analysis: Microorganisms transformed microorganism codes (called mo) using Catalogue Life reference data set, contains ~70,000 microorganisms taxonomic kingdoms Bacteria, Fungi Protozoa. tranformation .mo(). function also recognises almost WHONET abbreviations microorganisms. Antimicrobial results interpretations clean valid. words, contain values \"S\", \"\" \"R\". exactly .sir() function . errors warnings, values transformed succesfully. also created package dedicated data cleaning checking, called cleaner package. freq() function can used create frequency tables. let’s check data, couple frequency tables: Frequency table Class: character Length: 500 Available: 500 (100%, NA: 0 = 0%) Unique: 38 Shortest: 11 Longest: 40 (omitted 28 entries, n = 57 [11.4%]) Frequency table Class: factor > ordered > sir (numeric) Length: 500 Levels: 5: S < SDD < < R < N Available: 481 (96.2%, NA: 19 = 3.8%) Unique: 3 Drug: Amoxicillin/clavulanic acid (AMC, J01CR02) Drug group: Beta-lactams/penicillins %SI: 78.59%","code":"library(dplyr) # part of tidyverse library(ggplot2) # part of tidyverse library(AMR) # this package library(cleaner) # to create frequency tables # transform variables data <- WHONET %>%   # get microbial ID based on given organism   mutate(mo = as.mo(Organism)) %>%   # transform everything from \"AMP_ND10\" to \"CIP_EE\" to the new `sir` class   mutate_at(vars(AMP_ND10:CIP_EE), as.sir) # our newly created `mo` variable, put in the mo_name() function data %>% freq(mo_name(mo), nmax = 10) # our transformed antibiotic columns # amoxicillin/clavulanic acid (J01CR02) as an example data %>% freq(AMC_ND2)"},{"path":"https://msberends.github.io/AMR/articles/WHONET.html","id":"a-first-glimpse-at-results","dir":"Articles","previous_headings":"","what":"A first glimpse at results","title":"How to work with WHONET data","text":"easy ggplot already give lot information, using included ggplot_sir() function:","code":"data %>%   group_by(Country) %>%   select(Country, AMP_ND2, AMC_ED20, CAZ_ED10, CIP_ED5) %>%   ggplot_sir(translate_ab = \"ab\", facet = \"Country\", datalabels = FALSE)"},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Data sets for download / own use","text":"data set 52 171 rows 23 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, gbif, gbif_parent, gbif_renamed_to, prevalence, snomed. data set R available microorganisms, load AMR package. last updated 14 July 2023 08:49:06 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (1.2 MB) Download tab-separated text file (11.7 MB) Download Microsoft Excel workbook (5.2 MB) Download Apache Feather file (5.5 MB) Download Apache Parquet file (2.6 MB) Download SAS transport (XPT) file (48.6 MB) Download IBM SPSS Statistics data file (17.8 MB) Download Stata DTA file (48.6 MB) NOTE: exported files SAS, 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.","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source","dir":"Articles","previous_headings":"microorganisms: Full Microbial Taxonomy","what":"Source","title":"Data sets for download / own use","text":"data set contains full microbial taxonomy five kingdoms List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF): Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; . Accessed https://lpsn.dsmz.de December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset . Accessed https://www.gbif.org January 8th, 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://phinvads.cdc.gov","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example-content","dir":"Articles","previous_headings":"microorganisms: Full Microbial Taxonomy","what":"Example content","title":"Data sets for download / own use","text":"Included (sub)species per taxonomic kingdom: Example rows filtering genus Escherichia:","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"antibiotics-antibiotic-antifungal-drugs","dir":"Articles","previous_headings":"","what":"antibiotics: Antibiotic (+Antifungal) Drugs","title":"Data sets for download / own use","text":"data set 483 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 antibiotics, load AMR package. last updated 24 February 2024 14:16:52 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (44 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (73 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download SAS transport (XPT) file (1.5 MB) Download IBM SPSS Statistics data file (0.4 MB) Download Stata DTA file (0.5 MB) tab-separated text file Microsoft Excel workbook, SAS, SPSS Stata files contain ATC codes, common abbreviations, trade names LOINC codes comma separated values.","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-1","dir":"Articles","previous_headings":"antibiotics: Antibiotic (+Antifungal) Drugs","what":"Source","title":"Data sets for download / own use","text":"data set contains EARS-Net ATC codes gathered WHONET, compound IDs PubChem. also contains brand names (synonyms) found PubChem Defined Daily Doses (DDDs) oral parenteral administration. ATC/DDD index Collaborating Centre Drug Statistics Methodology (note: may used commercial purposes, freely available CC website personal use) PubChem US National Library Medicine WHONET software 2019 LOINC (Logical Observation Identifiers Names Codes)","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"antivirals-antiviral-drugs","dir":"Articles","previous_headings":"","what":"antivirals: Antiviral Drugs","title":"Data sets for download / own use","text":"data set 120 rows 11 columns, containing following column names:av, name, atc, cid, atc_group, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antivirals, load AMR package. last updated 20 October 2023 12:51:48 UTC. Find info 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 SAS transport (XPT) file (73 kB) Download IBM SPSS Statistics data file (32 kB) Download Stata DTA file (78 kB) tab-separated text file Microsoft Excel workbook, SAS, SPSS Stata files contain trade names LOINC codes comma separated values.","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-2","dir":"Articles","previous_headings":"antivirals: Antiviral Drugs","what":"Source","title":"Data sets for download / own use","text":"data set contains ATC codes gathered compound IDs PubChem. also contains brand names (synonyms) found PubChem Defined Daily Doses (DDDs) oral parenteral administration. ATC/DDD index Collaborating Centre Drug Statistics Methodology (note: may used commercial purposes, freely available CC website personal use) PubChem US National Library Medicine LOINC (Logical Observation Identifiers Names Codes)","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"clinical_breakpoints-interpretation-from-mic-values-disk-diameters-to-sir","dir":"Articles","previous_headings":"","what":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","title":"Data sets for download / own use","text":"data set 29 883 rows 13 columns, containing following column names:guideline, type, host, method, site, mo, rank_index, ab, ref_tbl, disk_dose, breakpoint_S, breakpoint_R, uti. data set R available clinical_breakpoints, load AMR package. last updated 24 February 2024 14:16:52 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (61 kB) Download tab-separated text file (2.5 MB) Download Microsoft Excel workbook (1.4 MB) Download Apache Feather file (1.3 MB) Download Apache Parquet file (91 kB) Download SAS transport (XPT) file (8.2 MB) Download IBM SPSS Statistics data file (4.9 MB) Download Stata DTA file (8.1 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-3","dir":"Articles","previous_headings":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","what":"Source","title":"Data sets for download / own use","text":"data set contains interpretation rules MIC values disk diffusion diameters. Included guidelines CLSI (2011-2023) EUCAST (2011-2023). 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 development WHONET software. 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 AMR package. NOTE: AMR package (WHONET software well) contains internal methods apply guidelines, rather complex. example, breakpoints must applied certain species groups (case package available microorganisms.groups data set). important considered using breakpoints use.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"intrinsic_resistant-intrinsic-bacterial-resistance","dir":"Articles","previous_headings":"","what":"intrinsic_resistant: Intrinsic Bacterial Resistance","title":"Data sets for download / own use","text":"data set 134 634 rows 2 columns, containing following column names:mo ab. data set R available intrinsic_resistant, load AMR package. last updated 16 December 2022 15:10:43 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (78 kB) Download tab-separated text file (5.1 MB) Download Microsoft Excel workbook (1.3 MB) Download Apache Feather file (1.2 MB) Download Apache Parquet file (0.2 MB) Download SAS transport (XPT) file (9.5 MB) Download IBM SPSS Statistics data file (7.4 MB) Download Stata DTA file (9.5 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-4","dir":"Articles","previous_headings":"intrinsic_resistant: Intrinsic Bacterial Resistance","what":"Source","title":"Data sets for download / own use","text":"data set contains defined intrinsic resistance EUCAST bug-drug combinations, based ‘EUCAST Expert Rules’ ‘EUCAST Intrinsic Resistance Unusual Phenotypes’ v3.3 (2021).","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example-content-4","dir":"Articles","previous_headings":"intrinsic_resistant: Intrinsic Bacterial Resistance","what":"Example content","title":"Data sets for download / own use","text":"Example rows filtering Enterobacter cloacae:","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"dosage-dosage-guidelines-from-eucast","dir":"Articles","previous_headings":"","what":"dosage: Dosage Guidelines from EUCAST","title":"Data sets for download / own use","text":"data set 503 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 22 June 2023 13:10:59 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (3 kB) Download tab-separated text file (43 kB) Download Microsoft Excel workbook (25 kB) Download Apache Feather file (21 kB) Download Apache Parquet file (9 kB) Download SAS transport (XPT) file (0.1 MB) Download IBM SPSS Statistics data file (64 kB) Download Stata DTA file (0.1 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-5","dir":"Articles","previous_headings":"dosage: Dosage Guidelines from EUCAST","what":"Source","title":"Data sets for download / own use","text":"EUCAST breakpoints used package based dosages data set. Currently included dosages data set meant :  (), ‘EUCAST Clinical Breakpoint Tables’ v11.0 (2021), ‘EUCAST Clinical Breakpoint Tables’ v12.0 (2022).","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example_isolates-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates: Example Data for Practice","title":"Data sets for download / own use","text":"data set 2 000 rows 46 columns, containing following column names:date, patient, age, gender, ward, mo, PEN, OXA, FLC, AMX, AMC, AMP, TZP, CZO, FEP, CXM, FOX, CTX, CAZ, CRO, GEN, TOB, AMK, KAN, TMP, SXT, NIT, FOS, LNZ, CIP, MFX, VAN, TEC, TCY, TGC, DOX, ERY, CLI, AZM, IPM, MEM, MTR, CHL, COL, MUP, RIF. data set R available example_isolates, load AMR package. last updated 21 January 2023 22:47:20 UTC. Find info structure data set .","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-6","dir":"Articles","previous_headings":"example_isolates: Example Data for Practice","what":"Source","title":"Data sets for download / own use","text":"data set contains randomised fictitious data, reflects reality can used practise AMR data analysis.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example_isolates_unclean-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates_unclean: Example Data for Practice","title":"Data sets for download / own use","text":"data set 3 000 rows 8 columns, containing following column names:patient_id, hospital, date, bacteria, AMX, AMC, CIP, GEN. data set R available example_isolates_unclean, load AMR package. last updated 27 August 2022 18:49:37 UTC. Find info structure data set .","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-7","dir":"Articles","previous_headings":"example_isolates_unclean: Example Data for Practice","what":"Source","title":"Data sets for download / own use","text":"data set contains randomised fictitious data, reflects reality can used practise AMR data analysis.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"microorganisms-groups-species-groups-and-microbiological-complexes","dir":"Articles","previous_headings":"","what":"microorganisms.groups: Species Groups and Microbiological Complexes","title":"Data sets for download / own use","text":"data set 521 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 14 July 2023 08:49:06 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (49 kB) Download Microsoft Excel workbook (20 kB) Download Apache Feather file (19 kB) Download Apache Parquet file (13 kB) Download SAS transport (XPT) file (0 kB) Download IBM SPSS Statistics data file (64 kB) Download Stata DTA file (81 kB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-8","dir":"Articles","previous_headings":"microorganisms.groups: Species Groups and Microbiological Complexes","what":"Source","title":"Data sets for download / own use","text":"data set contains species groups microbiological complexes, used clinical_breakpoints data set.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"microorganisms-codes-common-laboratory-codes","dir":"Articles","previous_headings":"","what":"microorganisms.codes: Common Laboratory Codes","title":"Data sets for download / own use","text":"data set 4 957 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 8 July 2023 15:30:05 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (22 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (91 kB) Download Apache Feather file (85 kB) Download Apache Parquet file (57 kB) Download SAS transport (XPT) file (0 kB) Download IBM SPSS Statistics data file (0.1 MB) Download Stata DTA file (0.1 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-9","dir":"Articles","previous_headings":"microorganisms.codes: Common Laboratory Codes","what":"Source","title":"Data sets for download / own use","text":"data set contains commonly used codes microorganisms, laboratory systems WHONET.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/resistance_predict.html","id":"needed-r-packages","dir":"Articles","previous_headings":"","what":"Needed R packages","title":"How to predict antimicrobial resistance","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. AMR package depends packages even extends use functions.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"tidyverse\", \"AMR\"))"},{"path":"https://msberends.github.io/AMR/articles/resistance_predict.html","id":"prediction-analysis","dir":"Articles","previous_headings":"","what":"Prediction analysis","title":"How to predict antimicrobial resistance","text":"package contains function resistance_predict(), takes input functions AMR data analysis. Based date column, calculates cases per year uses regression model predict antimicrobial resistance. basically easy : function look date column col_date set. running commands, summary regression model printed unless using resistance_predict(..., info = FALSE). text printed summary - actual result (output) function data.frame containing year: number observations, actual observed resistance, estimated resistance standard error estimation: function plot available base R, can extended packages depend output based type input. extended function cope resistance predictions:  fastest way plot result. automatically adds right axes, error bars, titles, number available observations type model. also support ggplot2 package custom function ggplot_sir_predict() create appealing plots:","code":"# resistance prediction of piperacillin/tazobactam (TZP): resistance_predict(tbl = example_isolates, col_date = \"date\", col_ab = \"TZP\", model = \"binomial\")  # or: example_isolates %>%   resistance_predict(     col_ab = \"TZP\",     model = \"binomial\"   )  # to bind it to object 'predict_TZP' for example: predict_TZP <- example_isolates %>%   resistance_predict(     col_ab = \"TZP\",     model = \"binomial\"   ) predict_TZP #> # A tibble: 33 × 7 #>     year  value se_min se_max observations observed estimated #>  * <dbl>  <dbl>  <dbl>  <dbl>        <int>    <dbl>     <dbl> #>  1  2002 0.2        NA     NA           15   0.2       0.0562 #>  2  2003 0.0625     NA     NA           32   0.0625    0.0616 #>  3  2004 0.0854     NA     NA           82   0.0854    0.0676 #>  4  2005 0.05       NA     NA           60   0.05      0.0741 #>  5  2006 0.0508     NA     NA           59   0.0508    0.0812 #>  6  2007 0.121      NA     NA           66   0.121     0.0889 #>  7  2008 0.0417     NA     NA           72   0.0417    0.0972 #>  8  2009 0.0164     NA     NA           61   0.0164    0.106  #>  9  2010 0.0566     NA     NA           53   0.0566    0.116  #> 10  2011 0.183      NA     NA           93   0.183     0.127  #> # ℹ 23 more rows plot(predict_TZP) ggplot_sir_predict(predict_TZP) # choose for error bars instead of a ribbon ggplot_sir_predict(predict_TZP, ribbon = FALSE)"},{"path":"https://msberends.github.io/AMR/articles/resistance_predict.html","id":"choosing-the-right-model","dir":"Articles","previous_headings":"Prediction analysis","what":"Choosing the right model","title":"How to predict antimicrobial resistance","text":"Resistance easily predicted; look vancomycin resistance Gram-positive bacteria, spread (.e. standard error) enormous:  Vancomycin resistance 100% ten years, might remain low. can define model model parameter. model chosen generalised linear regression model using binomial distribution, assuming period zero resistance followed period increasing resistance leading slowly resistance. Valid values : vancomycin resistance Gram-positive bacteria, linear model might appropriate:  model also available object, attribute:","code":"example_isolates %>%   filter(mo_gramstain(mo, language = NULL) == \"Gram-positive\") %>%   resistance_predict(col_ab = \"VAN\", year_min = 2010, info = FALSE, model = \"binomial\") %>%   ggplot_sir_predict() example_isolates %>%   filter(mo_gramstain(mo, language = NULL) == \"Gram-positive\") %>%   resistance_predict(col_ab = \"VAN\", year_min = 2010, info = FALSE, model = \"linear\") %>%   ggplot_sir_predict() model <- attributes(predict_TZP)$model  summary(model)$family #>  #> Family: binomial  #> Link function: logit summary(model)$coefficients #>                  Estimate  Std. Error   z value     Pr(>|z|) #> (Intercept) -200.67944891 46.17315349 -4.346237 1.384932e-05 #> year           0.09883005  0.02295317  4.305725 1.664395e-05"},{"path":"https://msberends.github.io/AMR/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. Casper J. Albers. Thesis advisor. Peter Dutey-Magni. Contributor. Judith M. Fonville. Contributor. Alex W. Friedrich. Thesis advisor. Corinna Glasner. Thesis advisor. Eric H. L. C. M. Hazenberg. Contributor. Gwen Knight. Contributor. Annick Lenglet. Contributor. Christian F. Luz. Contributor. Bart C. Meijer. Contributor. Dmytro Mykhailenko. Contributor. Anton Mymrikov. Contributor. Andrew P. Norgan. Contributor. Sofia Ny. Contributor. Matthew Saab. Contributor. Jonas Salm. Contributor. Javier Sanchez. Contributor. Rogier P. Schade. Contributor. Bhanu N. M. Sinha. Thesis advisor. Jason Stull. Contributor. Anthony Underwood. Contributor. Anita Williams. Contributor.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 AMR data analysis One Health approach Generates antibiograms - traditional, combined, syndromic, even WISCA Provides full microbiological taxonomy data antimicrobial drugs Applies recent CLSI EUCAST clinical veterinary breakpoints MICs disk zones Corrects duplicate isolates, calculates predicts AMR per antibiotic class Integrates WHONET, ATC, EARS-Net, PubChem, LOINC, SNOMED CT Works Windows, macOS Linux versions R since R-3.0 completely dependency-free, highly suitable places limited resources https://msberends.github.io/AMR https://doi.org/10.18637/jss.v104.i03","code":""},{"path":"https://msberends.github.io/AMR/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Antimicrobial Resistance Data Analysis","text":"AMR package free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. Many different researchers around globe continually helping us make successful durable project! work published Journal Statistical Software (Volume 104(3); DOI 10.18637/jss.v104.i03) formed basis two PhD theses (DOI 10.33612/diss.177417131 DOI 10.33612/diss.192486375). installing package, R knows ~52,000 distinct microbial species (updated December 2022) ~600 antibiotic, antimycotic antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI EUCAST included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen, collaboration non-profit organisations Certe Medical Diagnostics Advice Foundation University Medical Center Groningen.","code":""},{"path":"https://msberends.github.io/AMR/index.html","id":"used-in-over-175-countries-translated-into-20-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, translated into 20 languages","title":"Antimicrobial Resistance Data Analysis","text":"Since first public release early 2018, R package used almost countries world. Click map enlarge see country names. help contributors corners world, AMR package available  English,  Czech,  Chinese,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Italian,  Japanese,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swedish,  Turkish,  Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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 antibiotic columns. can done using -called antibiotic class 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 antibiotics AMR package make sure get meant: base R equivalent : base R code work version R since April 2013 (R-3.0). Moreover, code works identically data.table package, starting :","code":"# AMR works great with dplyr, but it's not required or neccesary library(AMR) library(dplyr)  example_isolates %>%   mutate(bacteria = mo_fullname()) %>%   # filtering functions for microorganisms:   filter(mo_is_gram_negative(),          mo_is_intrinsic_resistant(ab = \"cefotax\")) %>%   # antibiotic selectors:   select(bacteria,          aminoglycosides(),          carbapenems()) library(AMR) example_isolates$bacteria <- mo_fullname(example_isolates$mo) example_isolates[which(mo_is_gram_negative() &                          mo_is_intrinsic_resistant(ab = \"cefotax\")),                  c(\"bacteria\", aminoglycosides(), carbapenems())] example_isolates <- data.table::as.data.table(example_isolates)"},{"path":"https://msberends.github.io/AMR/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 antibiotics yield higher empiric coverage: Like many functions package, antibiogram() comes support 20 languages often detected automatically based system language:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) antibiogram(example_isolates,             antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") antibiogram(example_isolates,             antibiotics = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian"},{"path":"https://msberends.github.io/AMR/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 antibiotic class 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 = \"-\")))) 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)) out # transform the antibiotic columns to names: out %>% set_ab_names() # transform the antibiotic column to ATC codes: out %>% set_ab_names(property = \"atc\")"},{"path":"https://msberends.github.io/AMR/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) Predicting future antimicrobial resistance using regression models (tutorial) Getting properties microorganism (like Gram stain, species, genus family) (manual) Getting properties antibiotic (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://msberends.github.io/AMR/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 development version.","code":"install.packages(\"AMR\")"},{"path":"https://msberends.github.io/AMR/index.html","id":"latest-development-version","dir":"","previous_headings":"Get this package","what":"Latest development version","title":"Antimicrobial Resistance Data Analysis","text":"Please read Developer Guideline . latest unpublished development version can installed GitHub two ways: Manually, using: Automatically, using rOpenSci R-universe platform, adding R-universe address list repositories (‘repos’): , can install update AMR package like official release (e.g., using install.packages(\"AMR\") RStudio via Tools > Check Package Updates…).","code":"install.packages(\"remotes\") # if you haven't already remotes::install_github(\"msberends/AMR\") options(repos = c(getOption(\"repos\"),                   msberends = \"https://msberends.r-universe.dev\"))"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/index.html","id":"partners","dir":"","previous_headings":"","what":"Partners","title":"Antimicrobial Resistance Data Analysis","text":"development package part , related , made possible following non-profit organisations initiatives:","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/AMR-options.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Options for the AMR package — AMR-options","text":"AMR_breakpoint_type  character use .sir(), indicate breakpoint type use. must either \"ECOFF\", \"animal\", \"human\". 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 2023\". Supported guideline currently EUCAST (2011-2023) CLSI (2011-2023). 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_include_screening  logical use .sir(), indicate clinical breakpoints screening allowed - default FALSE. AMR_keep_synonyms  logical use .mo() mo_* functions, indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE. AMR_locale  character set language AMR package, can one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). default current system language (supported, English otherwise). AMR_mo_source  file location manual code list used .mo() mo_* functions. explained set_mo_source().","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics, allow PK/PD rules interpreting MIC values .sir().","code":"utils::file.edit(\"~/.Rprofile\") options(AMR_locale = \"pt\")  options(AMR_include_PKPD = TRUE)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. Many different researchers around globe continually helping us make successful durable project! work published Journal Statistical Software (Volume 104(3); doi:10.18637/jss.v104.i03 ) formed basis two PhD theses (doi:10.33612/diss.177417131  doi:10.33612/diss.192486375 ). installing package, R knows ~52 000 microorganisms (updated January 2024) ~600 antibiotic, antimycotic antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI EUCAST included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences public University Groningen, collaboration non-profit organisations Certe Medical Diagnostics Advice Foundation University Medical Center Groningen. AMR package available English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/AMR.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"The AMR Package — AMR","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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: Casper J. Albers (ORCID) [thesis advisor] Peter Dutey-Magni (ORCID) [contributor] Judith M. Fonville [contributor] Alex W. Friedrich (ORCID) [thesis advisor] Corinna Glasner (ORCID) [thesis advisor] Eric H. L. C. M. Hazenberg [contributor] Gwen Knight (ORCID) [contributor] Annick Lenglet (ORCID) [contributor] Christian F. Luz (ORCID) [contributor] Bart C. Meijer [contributor] Dmytro Mykhailenko [contributor] Anton Mymrikov [contributor] Andrew P. Norgan (ORCID) [contributor] Sofia Ny (ORCID) [contributor] Matthew Saab [contributor] Jonas Salm [contributor] Javier Sanchez (ORCID) [contributor] Rogier P. Schade [contributor] Bhanu N. M. Sinha (ORCID) [thesis advisor] Jason Stull (ORCID) [contributor] Anthony Underwood (ORCID) [contributor] Anita Williams (ORCID) [contributor]","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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] \"culpen\"               \"floxacillin\"          \"floxacillin sodium\"   #>  [4] \"floxapen\"             \"floxapen sodium salt\" \"fluclox\"              #>  [7] \"flucloxacilina\"       \"flucloxacillin\"       \"flucloxacilline\"      #> [10] \"flucloxacillinum\"     \"fluorochloroxacillin\" \"staphylex\""},{"path":"https://msberends.github.io/AMR/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. antibiotic results example_isolates data set. patient names created using online surname generators place practice purposes.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics. can lookup abbreviations antibiotics data set, use e.g. ab_name(\"AMP\") get official name immediately. analysis, transform valid antibiotic class, using .sir().","code":""},{"path":"https://msberends.github.io/AMR/reference/WHONET.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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\" \"Quinolones\"                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://msberends.github.io/AMR/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 antibiotics data set. input values evaluated internally .ab().","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics data set: vector_or(colnames(antibiotics), 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/ab_property.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Get Properties of an Antibiotic — ab_property","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/ab_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"# all properties: ab_name(\"AMX\") #> [1] \"Amoxicillin\" ab_atc(\"AMX\") #> [1] \"J01CA04\" ab_cid(\"AMX\") #> [1] 33613 ab_synonyms(\"AMX\") #>  [1] \"actimoxi\"            \"amoclen\"             \"amolin\"              #>  [4] \"amopen\"              \"amopenixin\"          \"amoxibiotic\"         #>  [7] \"amoxicaps\"           \"amoxicilina\"         \"amoxicillin\"         #> [10] \"amoxicillin hydrate\" \"amoxicilline\"        \"amoxicillinum\"       #> [13] \"amoxiden\"            \"amoxil\"              \"amoxivet\"            #> [16] \"amoxy\"               \"amoxycillin\"         \"amoxyke\"             #> [19] \"anemolin\"            \"aspenil\"             \"atoksilin\"           #> [22] \"biomox\"              \"bristamox\"           \"cemoxin\"             #> [25] \"clamoxyl\"            \"damoxy\"              \"delacillin\"          #> [28] \"demoksil\"            \"dispermox\"           \"efpenix\"             #> [31] \"flemoxin\"            \"hiconcil\"            \"histocillin\"         #> [34] \"hydroxyampicillin\"   \"ibiamox\"             \"imacillin\"           #> [37] \"lamoxy\"              \"largopen\"            \"metafarma capsules\"  #> [40] \"metifarma capsules\"  \"moksilin\"            \"moxacin\"             #> [43] \"moxatag\"             \"ospamox\"             \"pamoxicillin\"        #> [46] \"piramox\"             \"promoxil\"            \"remoxil\"             #> [49] \"robamox\"             \"sawamox pm\"          \"tolodina\"            #> [52] \"topramoxin\"          \"unicillin\"           \"utimox\"              #> [55] \"vetramox\"            ab_tradenames(\"AMX\") #>  [1] \"actimoxi\"            \"amoclen\"             \"amolin\"              #>  [4] \"amopen\"              \"amopenixin\"          \"amoxibiotic\"         #>  [7] \"amoxicaps\"           \"amoxicilina\"         \"amoxicillin\"         #> [10] \"amoxicillin hydrate\" \"amoxicilline\"        \"amoxicillinum\"       #> [13] \"amoxiden\"            \"amoxil\"              \"amoxivet\"            #> [16] \"amoxy\"               \"amoxycillin\"         \"amoxyke\"             #> [19] \"anemolin\"            \"aspenil\"             \"atoksilin\"           #> [22] \"biomox\"              \"bristamox\"           \"cemoxin\"             #> [25] \"clamoxyl\"            \"damoxy\"              \"delacillin\"          #> [28] \"demoksil\"            \"dispermox\"           \"efpenix\"             #> [31] \"flemoxin\"            \"hiconcil\"            \"histocillin\"         #> [34] \"hydroxyampicillin\"   \"ibiamox\"             \"imacillin\"           #> [37] \"lamoxy\"              \"largopen\"            \"metafarma capsules\"  #> [40] \"metifarma capsules\"  \"moksilin\"            \"moxacin\"             #> [43] \"moxatag\"             \"ospamox\"             \"pamoxicillin\"        #> [46] \"piramox\"             \"promoxil\"            \"remoxil\"             #> [49] \"robamox\"             \"sawamox pm\"          \"tolodina\"            #> [52] \"topramoxin\"          \"unicillin\"           \"utimox\"              #> [55] \"vetramox\"            ab_group(\"AMX\") #> [1] \"Beta-lactams/penicillins\" ab_atc_group1(\"AMX\") #> [1] \"Beta-lactam antibacterials, penicillins\" ab_atc_group2(\"AMX\") #> [1] \"Penicillins with extended spectrum\" ab_url(\"AMX\") #>                                                             Amoxicillin  #> \"https://atcddd.fhi.no/atc_ddd_index//?code=J01CA04&showdescription=no\"   # smart lowercase transformation ab_name(x = c(\"AMC\", \"PLB\")) #> [1] \"Amoxicillin/clavulanic acid\" \"Polymyxin B\"                 ab_name(x = c(\"AMC\", \"PLB\"), tolower = TRUE) #> [1] \"amoxicillin/clavulanic acid\" \"polymyxin B\"                  # defined daily doses (DDD) ab_ddd(\"AMX\", \"oral\") #> [1] 1.5 ab_ddd_units(\"AMX\", \"oral\") #> [1] \"g\" ab_ddd(\"AMX\", \"iv\") #> [1] 3 ab_ddd_units(\"AMX\", \"iv\") #> [1] \"g\"  ab_info(\"AMX\") # all properties as a list #> $ab #> [1] \"AMX\" #>  #> $cid #> [1] 33613 #>  #> $name #> [1] \"Amoxicillin\" #>  #> $group #> [1] \"Beta-lactams/penicillins\" #>  #> $atc #> [1] \"J01CA04\" #>  #> $atc_group1 #> [1] \"Beta-lactam antibacterials, penicillins\" #>  #> $atc_group2 #> [1] \"Penicillins with extended spectrum\" #>  #> $tradenames #>  [1] \"actimoxi\"            \"amoclen\"             \"amolin\"              #>  [4] \"amopen\"              \"amopenixin\"          \"amoxibiotic\"         #>  [7] \"amoxicaps\"           \"amoxicilina\"         \"amoxicillin\"         #> [10] \"amoxicillin hydrate\" \"amoxicilline\"        \"amoxicillinum\"       #> [13] \"amoxiden\"            \"amoxil\"              \"amoxivet\"            #> [16] \"amoxy\"               \"amoxycillin\"         \"amoxyke\"             #> [19] \"anemolin\"            \"aspenil\"             \"atoksilin\"           #> [22] \"biomox\"              \"bristamox\"           \"cemoxin\"             #> [25] \"clamoxyl\"            \"damoxy\"              \"delacillin\"          #> [28] \"demoksil\"            \"dispermox\"           \"efpenix\"             #> [31] \"flemoxin\"            \"hiconcil\"            \"histocillin\"         #> [34] \"hydroxyampicillin\"   \"ibiamox\"             \"imacillin\"           #> [37] \"lamoxy\"              \"largopen\"            \"metafarma capsules\"  #> [40] \"metifarma capsules\"  \"moksilin\"            \"moxacin\"             #> [43] \"moxatag\"             \"ospamox\"             \"pamoxicillin\"        #> [46] \"piramox\"             \"promoxil\"            \"remoxil\"             #> [49] \"robamox\"             \"sawamox pm\"          \"tolodina\"            #> [52] \"topramoxin\"          \"unicillin\"           \"utimox\"              #> [55] \"vetramox\"            #>  #> $loinc #>  [1] \"101498-4\" \"15-8\"     \"16-6\"     \"16365-9\"  \"17-4\"     \"18-2\"     #>  [7] \"18861-5\"  \"18862-3\"  \"19-0\"     \"20-8\"     \"21-6\"     \"22-4\"     #> [13] \"25274-2\"  \"25310-4\"  \"3344-9\"   \"55614-2\"  \"55615-9\"  \"55616-7\"  #> [19] \"6976-5\"   \"6977-3\"   \"80133-2\"  #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 1.5 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 3 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all ab_* functions use as.ab() internally, so you can go from 'any' to 'any': ab_atc(\"AMP\") #> [1] \"J01CA01\" \"S01AA19\" ab_group(\"J01CA01\") #> [1] \"Beta-lactams/penicillins\" ab_loinc(\"ampicillin\") #>  [1] \"101477-8\" \"101478-6\" \"18864-9\"  \"18865-6\"  \"20374-5\"  \"21066-6\"  #>  [7] \"23618-2\"  \"27-3\"     \"28-1\"     \"29-9\"     \"30-7\"     \"31-5\"     #> [13] \"32-3\"     \"33-1\"     \"3355-5\"   \"33562-0\"  \"33919-2\"  \"34-9\"     #> [19] \"43883-8\"  \"43884-6\"  \"6979-9\"   \"6980-7\"   \"87604-5\"  ab_name(\"21066-6\") #> [1] \"Ampicillin\" ab_name(6249) #> [1] \"Ampicillin\" ab_name(\"J01CA01\") #> [1] \"Ampicillin\"  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  # use set_ab_names() for renaming columns colnames(example_isolates) #>  [1] \"date\"    \"patient\" \"age\"     \"gender\"  \"ward\"    \"mo\"      \"PEN\"     #>  [8] \"OXA\"     \"FLC\"     \"AMX\"     \"AMC\"     \"AMP\"     \"TZP\"     \"CZO\"     #> [15] \"FEP\"     \"CXM\"     \"FOX\"     \"CTX\"     \"CAZ\"     \"CRO\"     \"GEN\"     #> [22] \"TOB\"     \"AMK\"     \"KAN\"     \"TMP\"     \"SXT\"     \"NIT\"     \"FOS\"     #> [29] \"LNZ\"     \"CIP\"     \"MFX\"     \"VAN\"     \"TEC\"     \"TCY\"     \"TGC\"     #> [36] \"DOX\"     \"ERY\"     \"CLI\"     \"AZM\"     \"IPM\"     \"MEM\"     \"MTR\"     #> [43] \"CHL\"     \"COL\"     \"MUP\"     \"RIF\"     colnames(set_ab_names(example_isolates)) #>  [1] \"date\"                          \"patient\"                       #>  [3] \"age\"                           \"gender\"                        #>  [5] \"ward\"                          \"mo\"                            #>  [7] \"benzylpenicillin\"              \"oxacillin\"                     #>  [9] \"flucloxacillin\"                \"amoxicillin\"                   #> [11] \"amoxicillin_clavulanic_acid\"   \"ampicillin\"                    #> [13] \"piperacillin_tazobactam\"       \"cefazolin\"                     #> [15] \"cefepime\"                      \"cefuroxime\"                    #> [17] \"cefoxitin\"                     \"cefotaxime\"                    #> [19] \"ceftazidime\"                   \"ceftriaxone\"                   #> [21] \"gentamicin\"                    \"tobramycin\"                    #> [23] \"amikacin\"                      \"kanamycin\"                     #> [25] \"trimethoprim\"                  \"trimethoprim_sulfamethoxazole\" #> [27] \"nitrofurantoin\"                \"fosfomycin\"                    #> [29] \"linezolid\"                     \"ciprofloxacin\"                 #> [31] \"moxifloxacin\"                  \"vancomycin\"                    #> [33] \"teicoplanin\"                   \"tetracycline\"                  #> [35] \"tigecycline\"                   \"doxycycline\"                   #> [37] \"erythromycin\"                  \"clindamycin\"                   #> [39] \"azithromycin\"                  \"imipenem\"                      #> [41] \"meropenem\"                     \"metronidazole\"                 #> [43] \"chloramphenicol\"               \"colistin\"                      #> [45] \"mupirocin\"                     \"rifampicin\"                    colnames(set_ab_names(example_isolates, NIT:VAN)) #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     set_ab_names()    # this does the same:   example_isolates %>%     rename_with(set_ab_names)    # set_ab_names() works with any AB property:   example_isolates %>%     set_ab_names(property = \"atc\")    example_isolates %>%     set_ab_names(where(is.sir)) %>%     colnames()    example_isolates %>%     set_ab_names(NIT:VAN) %>%     colnames() } #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics data set, least containing columns \"ab\" \"name\"","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics 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://msberends.github.io/AMR/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 NA and throws a warning (which is suppressed here): suppressWarnings(   as.ab(\"testab\") ) #> Class 'ab' #> [1] FUS  # 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     # 'antibiotics' data set, such as 'group':     group = \"Test Group\"   ) ) #> ℹ Added one record to the internal antibiotics 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 antibiotics data set. ab_atc(\"Co-fluampicil\") #> [1] \"J01CR50\" ab_name(\"J01CR50\") #> [1] \"Co-fluampicil\"  # even antibiotic selectors work 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 cloacae cloacae\"  # 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/\" #>  #> $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, 2024\" #>  #> $snomed #> [1] NA #>  #> $lpsn #> [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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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  1965-12-05  58  58.45628         34 #> 2  1980-03-01  44  44.21858         19 #> 3  1949-11-01  74  74.54918         50 #> 4  1947-02-14  77  77.26230         52 #> 5  1940-02-19  84  84.24863         59 #> 6  1988-01-10  36  36.35792         11 #> 7  1997-08-27  26  26.72951          2 #> 8  1978-01-26  46  46.31421         21 #> 9  1972-06-17  51  51.92350         27 #> 10 1986-08-10  37  37.77596         13"},{"path":"https://msberends.github.io/AMR/reference/age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Split Ages into Age Groups — age_groups","title":"Split Ages into Age Groups — age_groups","text":"Split ages age groups defined split argument. allows easier demographic (antimicrobial resistance) analysis.","code":""},{"path":"https://msberends.github.io/AMR/reference/age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split Ages into Age Groups — age_groups","text":"","code":"age_groups(x, split_at = c(12, 25, 55, 75), na.rm = FALSE)"},{"path":"https://msberends.github.io/AMR/reference/age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split Ages into Age Groups — age_groups","text":"x age, e.g. calculated age() split_at values split x - default age groups 0-11, 12-24, 25-54, 55-74 75+. See Details. na.rm logical indicate whether missing values removed","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/age_groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split Ages into Age Groups — age_groups","text":"","code":"ages <- c(3, 8, 16, 54, 31, 76, 101, 43, 21)  # split into 0-49 and 50+ age_groups(ages, 50) #> [1] 0-49 0-49 0-49 50+  0-49 50+  50+  0-49 0-49 #> Levels: 0-49 < 50+  # split into 0-19, 20-49 and 50+ age_groups(ages, c(20, 50)) #> [1] 0-19  0-19  0-19  50+   20-49 50+   50+   20-49 20-49 #> Levels: 0-19 < 20-49 < 50+  # split into groups of ten years age_groups(ages, 1:10 * 10) #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+ age_groups(ages, split_at = \"tens\") #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+  # split into groups of five years age_groups(ages, 1:20 * 5) #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+ age_groups(ages, split_at = \"fives\") #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+  # split specifically for children age_groups(ages, c(1, 2, 4, 6, 13, 18)) #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+ age_groups(ages, \"children\") #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+  # \\donttest{ # resistance of ciprofloxacin per age group if (require(\"dplyr\") && require(\"ggplot2\")) {   example_isolates %>%     filter_first_isolate() %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(       x = \"age_group\",       minimum = 0,       x.title = \"Age Group\",       title = \"Ciprofloxacin resistance per age group\"     ) } #> Loading required package: ggplot2  # }"},{"path":"https://msberends.github.io/AMR/reference/antibiogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"Generate antibiogram, communicate results plots tables. functions follow logic Klinker et al. Barbieri et al. (see Source), allow reporting e.g. R Markdown Quarto well.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"","code":"antibiogram(   x,   antibiotics = where(is.sir),   mo_transform = \"shortname\",   ab_transform = NULL,   syndromic_group = NULL,   add_total_n = TRUE,   only_all_tested = FALSE,   digits = 0,   col_mo = NULL,   language = get_AMR_locale(),   minimum = 30,   combine_SI = TRUE,   sep = \" + \",   info = interactive() )  # S3 method for antibiogram plot(x, ...)  # S3 method for antibiogram autoplot(object, ...)  # S3 method for antibiogram knit_print(   x,   italicise = TRUE,   na = getOption(\"knitr.kable.NA\", default = \"\"),   ... )"},{"path":"https://msberends.github.io/AMR/reference/antibiogram.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"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://msberends.github.io/AMR/reference/antibiogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"x data.frame containing least column microorganisms columns antibiotic results (class 'sir', see .sir()) antibiotics vector antibiotic name code (evaluated .ab(), column name x, (combinations ) antibiotic selectors aminoglycosides() carbapenems(). combination antibiograms, can also set values separated \"+\", \"TZP+TOB\" \"cipro + genta\", given columns resembling antibiotics exist x. See Examples. mo_transform character transform microorganism input - must \"name\", \"shortname\", \"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\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Can also NULL transform input. ab_transform character transform antibiotic input - must one column names antibiotics data set: \"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 logical indicate whether total available numbers per pathogen added table (default TRUE). add lowest highest number available isolate per antibiotic (e.g, E. coli 200 isolates available ciprofloxacin 150 amoxicillin, returned number \"150-200\"). only_all_tested (combination antibiograms): logical indicate isolates must tested antibiotics, see Details digits number digits use rounding 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 , instead S (default TRUE) sep separating character antibiotic columns combination antibiograms info logical indicate info printed - default TRUE interactive mode ... used R Markdown Quarto: arguments passed knitr::kable() (otherwise, use) 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://msberends.github.io/AMR/reference/antibiogram.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"function returns table values 0 100 susceptibility, resistance. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine data set one four available algorithms. types antibiograms listed can plotted (using ggplot2::autoplot() base R plot()/barplot()). antibiogram object 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://msberends.github.io/AMR/reference/antibiogram.html","id":"antibiogram-types","dir":"Reference","previous_headings":"","what":"Antibiogram Types","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"four antibiogram types, proposed Klinker et al. (2021, doi:10.1177/20499361211011373 ), supported antibiogram(): 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) Case example: Susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure Code example:   Note combination antibiograms, important realise susceptibility can calculated two ways, can set only_all_tested argument (default FALSE). See example two antibiotics, Drug Drug B, antibiogram() works calculate %SI:","code":"antibiogram(your_data,             antibiotics = \"TZP\") antibiogram(your_data,             antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\")) antibiogram(your_data,             antibiotics = penicillins(),             syndromic_group = \"ward\") library(dplyr) your_data %>%   filter(ward == \"ICU\" & specimen_type == \"Respiratory\") %>%   antibiogram(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),               syndromic_group = ifelse(.$age >= 65 &                                          .$gender == \"Male\" &                                          .$condition == \"Heart Disease\",                                        \"Study Group\", \"Control Group\")) --------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   include as  include as   include as  include as                     numerator   denominator  numerator   denominator --------  --------  ----------  -----------  ----------  -----------  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://msberends.github.io/AMR/reference/antibiogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — 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,   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) #> # A tibble: 10 × 7 #>    `Pathogen (N min-max)`   AMK   GEN   IPM   KAN   MEM   TOB #>  * <chr>                  <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #>  1 CoNS (43-309)              0    86    52     0    52    22 #>  2 E. coli (0-462)          100    98   100    NA   100    97 #>  3 E. faecalis (0-39)         0     0   100     0    NA     0 #>  4 K. pneumoniae (0-58)      NA    90   100    NA   100    90 #>  5 P. aeruginosa (17-30)     NA   100    NA     0    NA   100 #>  6 P. mirabilis (0-34)       NA    94    94    NA    NA    94 #>  7 S. aureus (2-233)         NA    99    NA    NA    NA    98 #>  8 S. epidermidis (8-163)     0    79    NA     0    NA    51 #>  9 S. hominis (3-80)         NA    92    NA    NA    NA    85 #> 10 S. pneumoniae (11-117)     0     0    NA     0    NA     0  antibiogram(example_isolates,   antibiotics = aminoglycosides(),   ab_transform = \"atc\",   mo_transform = \"gramstain\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 2 × 5 #>   `Pathogen (N min-max)`   J01GB01 J01GB03 J01GB04 J01GB06 #> * <chr>                      <dbl>   <dbl>   <dbl>   <dbl> #> 1 Gram-negative (35-686)        96      96       0      98 #> 2 Gram-positive (436-1170)      34      63       0       0  antibiogram(example_isolates,   antibiotics = carbapenems(),   ab_transform = \"name\",   mo_transform = \"name\" ) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 5 × 3 #>   `Pathogen (N min-max)`                           Imipenem Meropenem #> * <chr>                                               <dbl>     <dbl> #> 1 Coagulase-negative Staphylococcus (CoNS) (48-48)       52        52 #> 2 Enterococcus faecalis (0-38)                          100        NA #> 3 Escherichia coli (418-422)                            100       100 #> 4 Klebsiella pneumoniae (51-53)                         100       100 #> 5 Proteus mirabilis (27-32)                              94        NA   # Combined antibiogram -------------------------------------------------  # combined antibiotics yield higher empiric coverage antibiogram(example_isolates,   antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   mo_transform = \"gramstain\" ) #> # A tibble: 2 × 4 #>   `Pathogen (N min-max)`     TZP `TZP + GEN` `TZP + TOB` #> * <chr>                    <dbl>       <dbl>       <dbl> #> 1 Gram-negative (641-693)     88          99          98 #> 2 Gram-positive (345-1044)    86          98          95  # names of antibiotics do not need to resemble columns exactly: antibiogram(example_isolates,   antibiotics = c(\"Cipro\", \"cipro + genta\"),   mo_transform = \"gramstain\",   ab_transform = \"name\",   sep = \" & \" ) #> # A tibble: 2 × 3 #>   `Pathogen (N min-max)`  Ciprofloxacin `Ciprofloxacin & Gentamicin` #> * <chr>                           <dbl>                        <dbl> #> 1 Gram-negative (684-694)            91                           99 #> 2 Gram-positive (724-847)            77                           93   # Syndromic antibiogram ------------------------------------------------  # the data set could contain a filter for e.g. respiratory specimens 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) #> # A tibble: 14 × 8 #>    `Syndromic Group` `Pathogen (N min-max)`   AMK   GEN   IPM   KAN   MEM   TOB #>  * <chr>             <chr>                  <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #>  1 Clinical          CoNS (23-205)             NA    89    57    NA    57    26 #>  2 ICU               CoNS (10-73)              NA    79    NA    NA    NA    NA #>  3 Outpatient        CoNS (3-31)               NA    84    NA    NA    NA    NA #>  4 Clinical          E. coli (0-299)          100    98   100    NA   100    98 #>  5 ICU               E. coli (0-137)          100    99   100    NA   100    96 #>  6 Clinical          K. pneumoniae (0-51)      NA    92   100    NA   100    92 #>  7 Clinical          P. mirabilis (0-30)       NA   100    NA    NA    NA   100 #>  8 Clinical          S. aureus (2-150)         NA    99    NA    NA    NA    97 #>  9 ICU               S. aureus (0-66)          NA   100    NA    NA    NA    NA #> 10 Clinical          S. epidermidis (4-79)     NA    82    NA    NA    NA    55 #> 11 ICU               S. epidermidis (4-75)     NA    72    NA    NA    NA    41 #> 12 Clinical          S. hominis (1-45)         NA    96    NA    NA    NA    94 #> 13 Clinical          S. pneumoniae (5-78)       0     0    NA     0    NA     0 #> 14 ICU               S. pneumoniae (5-30)       0     0    NA     0    NA     0  # 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,   antibiotics = 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) #> # A tibble: 2 × 5 #>   `Grupo sindrómico` `Patógeno (N min-max)` Amikacina Gentamicina Tobramicina #> * <chr>              <chr>                      <dbl>       <dbl>       <dbl> #> 1 No UCI             E. coli (0-325)              100          98          98 #> 2 UCI                E. coli (0-137)              100          99          96   # Weighted-incidence syndromic combination antibiogram (WISCA) ---------  # the data set could contain a filter for e.g. respiratory specimens/ICU antibiogram(example_isolates,   antibiotics = c(\"AMC\", \"AMC+CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\",   minimum = 10, # this should be >=30, but now just as example   syndromic_group = ifelse(example_isolates$age >= 65 &     example_isolates$gender == \"M\",   \"WISCA Group 1\", \"WISCA Group 2\"   ) ) #> # A tibble: 4 × 6 #>   `Syndromic Group` `Pathogen (N min-max)`    AMC `AMC + CIP`   TZP `TZP + TOB` #> * <chr>             <chr>                   <dbl>       <dbl> <dbl>       <dbl> #> 1 WISCA Group 1     Gram-negative (261-285)    76          95    89          99 #> 2 WISCA Group 2     Gram-negative (380-442)    76          98    88          98 #> 3 WISCA Group 1     Gram-positive (123-406)    76          89    81          95 #> 4 WISCA Group 2     Gram-positive (222-732)    76          89    88          95   # Print the output for R Markdown / Quarto -----------------------------  ureido <- antibiogram(example_isolates,   antibiotics = ureidopenicillins(),   ab_transform = \"name\" ) #> ℹ 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)) } #>  #>  #> |Pathogen (N)          | Piperacillin/tazobactam| #> |:---------------------|-----------------------:| #> |CoNS (33)             |                      30| #> |*E. coli* (416)       |                      94| #> |*K. pneumoniae* (53)  |                      89| #> |*S. pneumoniae* (112) |                     100|   # Generate plots with ggplot2 or base R --------------------------------  ab1 <- antibiogram(example_isolates,   antibiotics = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\" ) ab2 <- antibiogram(example_isolates,   antibiotics = 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://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":null,"dir":"Reference","previous_headings":"","what":"Antibiotic Selectors — antibiotic_class_selectors","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"functions allow filtering rows selecting columns based antibiotic test results specific antibiotic class group (according antibiotics data set), without need define columns antibiotic abbreviations. short, column name resembles antimicrobial drug, picked functions matches pharmaceutical class: \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" picked cephalosporins().","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"","code":"ab_class(ab_class, only_sir_columns = FALSE, only_treatable = TRUE, ...)  ab_selector(filter, only_sir_columns = FALSE, only_treatable = TRUE, ...)  aminoglycosides(only_sir_columns = FALSE, only_treatable = TRUE, ...)  aminopenicillins(only_sir_columns = FALSE, ...)  antifungals(only_sir_columns = FALSE, ...)  antimycobacterials(only_sir_columns = FALSE, ...)  betalactams(only_sir_columns = FALSE, only_treatable = TRUE, ...)  carbapenems(only_sir_columns = FALSE, only_treatable = TRUE, ...)  cephalosporins(only_sir_columns = FALSE, ...)  cephalosporins_1st(only_sir_columns = FALSE, ...)  cephalosporins_2nd(only_sir_columns = FALSE, ...)  cephalosporins_3rd(only_sir_columns = FALSE, ...)  cephalosporins_4th(only_sir_columns = FALSE, ...)  cephalosporins_5th(only_sir_columns = FALSE, ...)  fluoroquinolones(only_sir_columns = FALSE, ...)  glycopeptides(only_sir_columns = FALSE, ...)  lincosamides(only_sir_columns = FALSE, ...)  lipoglycopeptides(only_sir_columns = FALSE, ...)  macrolides(only_sir_columns = FALSE, ...)  oxazolidinones(only_sir_columns = FALSE, ...)  penicillins(only_sir_columns = FALSE, ...)  polymyxins(only_sir_columns = FALSE, only_treatable = TRUE, ...)  streptogramins(only_sir_columns = FALSE, ...)  quinolones(only_sir_columns = FALSE, ...)  tetracyclines(only_sir_columns = FALSE, ...)  trimethoprims(only_sir_columns = FALSE, ...)  ureidopenicillins(only_sir_columns = FALSE, ...)  administrable_per_os(only_sir_columns = FALSE, ...)  administrable_iv(only_sir_columns = FALSE, ...)  not_intrinsic_resistant(   only_sir_columns = FALSE,   col_mo = NULL,   version_expertrules = 3.3,   ... )"},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"ab_class antimicrobial class part , \"carba\" \"carbapenems\". columns group, atc_group1 atc_group2 antibiotics data set searched (case-insensitive) value. only_sir_columns logical indicate whether columns class sir must selected (default FALSE), see .sir() only_treatable logical indicate whether antimicrobial drugs excluded laboratory tests (default TRUE), gentamicin-high (GEH) imipenem/EDTA (IPE) ... ignored, place allow future extensions filter expression evaluated antibiotics data set, name %like% \"trim\" col_mo column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\".","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"(internally) character vector column names, additional class \"ab_selector\"","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Antibiotic Selectors — antibiotic_class_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. columns data functions called searched known antibiotic names, abbreviations, brand names, codes (ATC, EARS-Net, , etc.) according antibiotics data set. means selector aminoglycosides() pick column names like 'gen', 'genta', 'J01GB03', 'tobra', 'Tobracin', etc. ab_class() function can used filter/select manually defined antibiotic class. searches results antibiotics data set within columns group, atc_group1 atc_group2. ab_selector() function can used internally filter antibiotics 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. administrable_per_os() administrable_iv() functions also rely antibiotics data set - antibiotic columns matched DDD (defined daily dose) resp. oral IV treatment available antibiotics data set. not_intrinsic_resistant() function can used select antibiotic columns 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 Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021) determine intrinsic resistance, using eucast_rules() function internally. determination, function quite slow terms performance.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"full-list-of-supported-antibiotic-classes","dir":"Reference","previous_headings":"","what":"Full list of supported (antibiotic) classes","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"aminoglycosides() can select:  amikacin (AMK), amikacin/fosfomycin (AKF), amphotericin B-high (AMH), 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:  amphotericin B (AMB), anidulafungin (ANI), butoconazole (), caspofungin (CAS), ciclopirox (CIX), clotrimazole (CTR), econazole (ECO), fluconazole (FLU), flucytosine (FCT), fosfluconazole (FFL), griseofulvin (GRI), hachimycin (HCH), ibrexafungerp (IBX), isavuconazole (ISV), isoconazole (ISO), itraconazole (ITR), ketoconazole (KET), manogepix (MGX), micafungin (MIF), miconazole (MCZ), nystatin (NYS), oteseconazole (OTE), pimaricin (PMR), posaconazole (POS), rezafungin (RZF), ribociclib (RBC), sulconazole (SUC), terbinafine (TRB), terconazole (TRC), voriconazole (VOR) antimycobacterials() can select:  4-aminosalicylic acid (AMA), calcium aminosalicylate (CLA), capreomycin (CAP), clofazimine (CLF), delamanid (DLM), enviomycin (ENV), ethambutol (ETH), ethambutol/isoniazid (ETI), ethionamide (ETI1), isoniazid (INH), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), morinamide (MRN), p-aminosalicylic acid (PAS), pretomanid (PMD), protionamide (PTH), pyrazinamide (PZA), rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP), simvastatin/fenofibrate (SMF), sodium aminosalicylate (SDA), streptomycin/isoniazid (STI), terizidone (TRZ), thioacetazone (TAT), thioacetazone/isoniazid (THI1), tiocarlide (TCR), viomycin (VIO) betalactams() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), avibactam (AVB), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), biapenem (BIA), carbenicillin (CRB), carindacillin (CRN), 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/clavulanic acid (CPC), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening (FOX1), 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), nacubactam (NAC), nafcillin (NAF), oxacillin (OXA), 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), sulbactam (SUL), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tazobactam (TAZ), tebipenem (TBP), temocillin (TEM), ticarcillin (TIC), 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/clavulanic acid (CPC), cefepime/tazobactam (FPT), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening (FOX1), 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 (FOX1), 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/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/clavulanic acid (CPC), cefepime/tazobactam (FPT), 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), 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), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nifuroquine (NIF), norfloxacin (), ofloxacin (OFX), orbifloxacin (ORB), pazufloxacin (PAZ), pefloxacin (PEF), 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), dalbavancin (DAL), norvancomycin (NVA), oritavancin (ORI), ramoplanin (RAM), teicoplanin (TEC), teicoplanin-macromethod (TCM), telavancin (TLV), vancomycin (VAN), vancomycin-macromethod (VAM) lincosamides() can select:  acetylmidecamycin (ACM), acetylspiramycin (ASP), clindamycin (CLI), gamithromycin (GAM), kitasamycin (KIT), lincomycin (LIN), meleumycin (MEL), nafithromycin (ZWK), pirlimycin (PRL), primycin (PRM), solithromycin (SOL), tildipirosin (TIP), tilmicosin (TIL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) 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), pirlimycin (PRL), primycin (PRM), rokitamycin (ROK), roxithromycin (RXT), solithromycin (SOL), spiramycin (SPI), telithromycin (TLT), tildipirosin (TIP), tilmicosin (TIL), troleandomycin (TRL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) 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), avibactam (AVB), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), carbenicillin (CRB), carindacillin (CRN), cefepime/nacubactam (FNC), 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), nacubactam (NAC), nafcillin (NAF), oxacillin (OXA), 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), sulbactam (SUL), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tazobactam (TAZ), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC) polymyxins() can select:  colistin (COL), polymyxin B (PLB), polymyxin B/polysorbate 80 (POP) quinolones() can select:  besifloxacin (BES), cinoxacin (CIN), ciprofloxacin (CIP), 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), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nalidixic acid (NAL), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), ofloxacin (OFX), orbifloxacin (ORB), oxolinic acid (OXO), pazufloxacin (PAZ), pefloxacin (PEF), 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) streptogramins() can select:  pristinamycin (PRI) quinupristin/dalfopristin (QDA) 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), 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://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Antibiotic Selectors — antibiotic_class_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>, …   # Examples sections below are split into 'base R', 'dplyr', and 'data.table':   # 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 antibiotic columns 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 antibiotic 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  # ab_selector() applies a filter in the `antibiotics` data set and is thus # very flexible. For instance, to select antibiotic columns with an oral DDD # of at least 1 gram: example_isolates[, ab_selector(oral_ddd > 1 & oral_units == \"g\")] #> ℹ For ab_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  # \\donttest{ # dplyr -------------------------------------------------------------------  if (require(\"dplyr\")) {   tibble(kefzol = random_sir(5)) %>%     select(cephalosporins()) } #> ℹ For cephalosporins() using column 'kefzol' (cefazolin) #> # A tibble: 5 × 1 #>   kefzol #>   <sir>  #> 1 S      #> 2 R      #> 3 S      #> 4 S      #> 5 I       if (require(\"dplyr\")) {   # get AMR for all aminoglycosides e.g., per ward:   example_isolates %>%     group_by(ward) %>%     summarise(across(aminoglycosides(), resistance)) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `across(aminoglycosides(), resistance)`. #> ℹ 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 × 5 #>   ward         GEN   TOB   AMK   KAN #>   <chr>      <dbl> <dbl> <dbl> <dbl> #> 1 Clinical   0.229 0.315 0.626     1 #> 2 ICU        0.290 0.400 0.662     1 #> 3 Outpatient 0.2   0.368 0.605    NA if (require(\"dplyr\")) {   # You can combine selectors with '&' to be more specific:   example_isolates %>%     select(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 if (require(\"dplyr\")) {   # get AMR for only drugs that matter - no intrinsic resistance:   example_isolates %>%     filter(mo_genus() %in% c(\"Escherichia\", \"Klebsiella\")) %>%     group_by(ward) %>%     summarise(across(not_intrinsic_resistant(), resistance)) } #> ℹ Using column 'mo' as input for mo_genus() #> ℹ For not_intrinsic_resistant() removing columns 'PEN' #>   (benzylpenicillin), 'LNZ' (linezolid), 'VAN' (vancomycin), 'TEC' #>   (teicoplanin), 'ERY' (erythromycin), 'CLI' (clindamycin), 'AZM' #>   (azithromycin), and 'RIF' (rifampicin) #> Warning: There were 52 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `across(not_intrinsic_resistant(), resistance)`. #> ℹ In group 1: `ward = \"Clinical\"`. #> Caused by warning: #> ! Introducing NA: no results available for OXA in group: ward = \"Clinical\" #> (minimum = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 51 remaining warnings. #> # A tibble: 3 × 33 #>   ward    OXA   FLC    AMX    AMC    AMP     TZP     CZO     FEP     CXM     FOX #>   <chr> <dbl> <dbl>  <dbl>  <dbl>  <dbl>   <dbl>   <dbl>   <dbl>   <dbl>   <dbl> #> 1 Clin…    NA    NA  0.606  0.121  0.606  0.0504  0.0656  0.0159  0.0622  0.0648 #> 2 ICU      NA    NA  0.535  0.172  0.535  0.119  NA       0.0722  0.0828  0.0992 #> 3 Outp…    NA    NA NA     NA     NA     NA      NA      NA      NA      NA      #> # ℹ 22 more variables: CTX <dbl>, CAZ <dbl>, CRO <dbl>, GEN <dbl>, TOB <dbl>, #> #   AMK <dbl>, KAN <dbl>, TMP <dbl>, SXT <dbl>, NIT <dbl>, FOS <dbl>, #> #   CIP <dbl>, MFX <dbl>, TCY <dbl>, TGC <dbl>, DOX <dbl>, IPM <dbl>, #> #   MEM <dbl>, MTR <dbl>, CHL <dbl>, COL <dbl>, MUP <dbl> if (require(\"dplyr\")) {   # get susceptibility for antibiotics whose name contains \"trim\":   example_isolates %>%     filter(first_isolate()) %>%     group_by(ward) %>%     summarise(across(ab_selector(name %like% \"trim\"), susceptibility)) } #> ℹ For ab_selector(name %like% \"trim\") using columns 'TMP' (trimethoprim) #>   and 'SXT' (trimethoprim/sulfamethoxazole) #> # A tibble: 3 × 3 #>   ward         TMP   SXT #>   <chr>      <dbl> <dbl> #> 1 Clinical   0.627 0.807 #> 2 ICU        0.551 0.780 #> 3 Outpatient 0.667 0.821 if (require(\"dplyr\")) {   # this will select columns 'IPM' (imipenem) and 'MEM' (meropenem):   example_isolates %>%     select(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 if (require(\"dplyr\")) {   # this will select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB':   example_isolates %>%     select(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 if (require(\"dplyr\")) {   # any() and all() work in dplyr's filter() too:   example_isolates %>%     filter(       any(aminoglycosides() == \"R\"),       all(cephalosporins_2nd() == \"R\")     ) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For cephalosporins_2nd() using columns 'CXM' (cefuroxime) and 'FOX' #>   (cefoxitin) #> # A tibble: 112 × 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-03-16 4FC193     69 M      Clinical B_PSDMN_AERG R     NA    NA    R     #>  3 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS NA    NA    NA    NA    #>  4 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS NA    NA    NA    NA    #>  5 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS NA    NA    NA    NA    #>  6 2002-07-21 955940     82 F      Clinical B_PSDMN_AERG R     NA    NA    R     #>  7 2002-07-21 955940     82 F      Clinical B_PSDMN_AERG 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_FCLS NA    NA    NA    NA    #> 10 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM NA    NA    NA    NA    #> # ℹ 102 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\")) {   # also works with c():   example_isolates %>%     filter(any(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: 531 × 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-03-16 4FC193     69 M      Clinical B_PSDMN_AERG R     NA    NA    R     #>  3 2002-03-17 B30560     78 M      Clinical B_STPHY_CONS R     NA    R     R     #>  4 2002-04-04 E61143     67 M      Clinical B_STRPT_SNGN S     NA    NA    S     #>  5 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS NA    NA    NA    NA    #>  6 2002-04-14 F30196     73 M      Outpati… B_STRPT_GRPB S     NA    S     S     #>  7 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  8 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  9 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #> 10 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #> # ℹ 521 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\")) {   # not setting any/all will automatically apply all():   example_isolates %>%     filter(aminoglycosides() == \"R\") } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ Assuming a filter on all 4 aminoglycosides. Wrap around all() or #>   any() to prevent this note. #> # A tibble: 427 × 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-03-17 B30560     78 M      Clinical B_STPHY_CONS R     NA    R     R     #>  3 2002-04-04 E61143     67 M      Clinical B_STRPT_SNGN S     NA    NA    S     #>  4 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS NA    NA    NA    NA    #>  5 2002-04-14 F30196     73 M      Outpati… B_STRPT_GRPB S     NA    S     S     #>  6 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  7 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  8 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #>  9 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #> 10 2002-05-16 D25302     65 F      ICU      B_STRPT_ANGN S     NA    NA    S     #> # ℹ 417 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\")) {   # this will select columns 'mo' and all antimycobacterial drugs ('RIF'):   example_isolates %>%     select(mo, ab_class(\"mycobact\")) } #> ℹ For ab_class(\"mycobact\") using column 'RIF' (rifampicin) #> # A tibble: 2,000 × 2 #>    mo           RIF   #>    <mo>         <sir> #>  1 B_ESCHR_COLI R     #>  2 B_ESCHR_COLI R     #>  3 B_STPHY_EPDR NA    #>  4 B_STPHY_EPDR NA    #>  5 B_STPHY_EPDR NA    #>  6 B_STPHY_EPDR NA    #>  7 B_STPHY_AURS NA    #>  8 B_STPHY_AURS NA    #>  9 B_STPHY_EPDR NA    #> 10 B_STPHY_EPDR NA    #> # ℹ 1,990 more rows if (require(\"dplyr\")) {   # get bug/drug combinations for only glycopeptides in Gram-positives:   example_isolates %>%     filter(mo_is_gram_positive()) %>%     select(mo, glycopeptides()) %>%     bug_drug_combinations() %>%     format() } #> ℹ Using column 'mo' as input for mo_is_gram_positive() #> ℹ For glycopeptides() using columns 'VAN' (vancomycin) and 'TEC' #>   (teicoplanin) #> # A tibble: 2 × 8 #>   Group      Drug  CoNS  `E. faecalis` `S. aureus` `S. epidermidis` `S. hominis` #>   <chr>      <chr> <chr> <chr>         <chr>       <chr>            <chr>        #> 1 \"Glycopep… Teic… \"\"    \"\"            \" 0.0% (0/… \"64.1% (25/39)\"  \" 6.8% (4/5… #> 2 \"\"         Vanc… \" 0.… \" 0.0% (0/39… \" 0.0% (0/… \" 0.0% (0/171)\"  \" 0.0% (0/8… #> # ℹ 1 more variable: `S. pneumoniae` <chr> if (require(\"dplyr\")) {   data.frame(     some_column = \"some_value\",     J01CA01 = \"S\"   ) %>% # ATC code of ampicillin     select(penicillins()) # only the 'J01CA01' column will be selected } #> ℹ For penicillins() using column 'J01CA01' (ampicillin) #>   J01CA01 #> 1       S if (require(\"dplyr\")) {   # 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) } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Assuming a filter on all 2 carbapenems. Wrap around all() or any() to #>   prevent this note. #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Assuming a filter on all 2 carbapenems. Wrap around all() or any() to #>   prevent this note. #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> [1] TRUE   # 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) #> [1] \"IPM\" \"MEM\" #> attr(,\"class\") #> [1] \"ab_selector\" \"character\"   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://msberends.github.io/AMR/reference/antibiotics.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Sets with 603 Antimicrobial Drugs — antibiotics","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"Two data sets containing antibiotics/antimycotics antivirals. Use .ab() one ab_* functions retrieve values antibiotics data set. Three identifiers included data set: antibiotic ID (ab, primarily used package) defined WHONET/EARS-Net, ATC code (atc) defined , Compound ID (cid) found PubChem. properties data set derived one codes. Note drugs multiple ATC codes.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"","code":"antibiotics  antivirals"},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"object class tbl_df (inherits tbl, data.frame) 120 rows 11 columns.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"for-the-antibiotics-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antibiotics data set: a tibble with 483 observations and 14 variables:","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"ab Antibiotic ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. cid Compound ID found PubChem. unique identifier. name Official name used WHONET/EARS-Net . unique identifier. group short concise group name, based WHONET WHOCC definitions atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, like J01CR02 atc_group1 Official pharmacological subgroup (3rd level ATC code) defined WHOCC, like \"Macrolides, lincosamides streptogramins\" atc_group2 Official chemical subgroup (4th level ATC code) defined WHOCC, like \"Macrolides\" abbr List abbreviations used many countries, also antibiotic susceptibility testing (AST) synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 179 drugs oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral (intravenous) treatment, currently available 153 drugs iv_units Units iv_ddd loinc codes associated name antimicrobial drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use ab_loinc() retrieve quickly, see ab_property().","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.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 603 Antimicrobial Drugs — antibiotics","text":"av Antiviral ID used package (ACI), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. Combinations codes contain + indicate , ATA+COBI atazanavir/cobicistat. name Official name used WHONET/EARS-Net . unique identifier. atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC cid Compound ID found PubChem. unique identifier. atc_group Official pharmacological subgroup (3rd level ATC code) defined WHOCC synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral treatment iv_units Units iv_ddd loinc codes associated name antiviral drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use av_loinc() retrieve quickly, see av_property().","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology (WHOCC): https://atcddd.fhi./atc_ddd_index/ Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Accessed https://loinc.org October 19th, 2023. European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"direct-download","dir":"Reference","previous_headings":"","what":"Direct download","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"Like data sets package, data sets publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","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://msberends.github.io/AMR/reference/antibiotics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"","code":"antibiotics #> # A tibble: 483 × 14 #>    ab        cid name   group atc   atc_group1 atc_group2 abbreviations synonyms #>    <ab>    <dbl> <chr>  <chr> <lis> <chr>      <chr>      <list>        <named > #>  1 AMA      4649 4-ami… Anti… <chr> Drugs for… Aminosali… <chr [1]>     <chr>    #>  2 ACM   6450012 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  3 ASP  49787020 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  4 ALS      8954 Aldes… Othe… <chr> Drugs for… Drugs for… <chr [1]>     <chr>    #>  5 AMK     37768 Amika… Amin… <chr> Aminoglyc… Other ami… <chr [5]>     <chr>    #>  6 AKF        NA Amika… Amin… <chr> NA         NA         <chr [1]>     <chr>    #>  7 AMX     33613 Amoxi… Beta… <chr> Beta-lact… Penicilli… <chr [3]>     <chr>    #>  8 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [5]>     <chr>    #>  9 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> 10 AMB   5280965 Ampho… Anti… <chr> Antimycot… Antibioti… <chr [3]>     <chr>    #> # ℹ 473 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://msberends.github.io/AMR/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 antibiotic drug code one antibiotics. data set antibiotics searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://msberends.github.io/AMR/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, info = interactive(), ...)  is.ab(x)"},{"path":"https://msberends.github.io/AMR/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. info logical indicate whether progress bar printed - default TRUE interactive mode ... arguments passed internal functions","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/as.ab.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antibiotic ID — as.ab","text":"entries antibiotics 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/as.ab.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Transform Input to an Antibiotic ID — as.ab","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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 123\") #> Class 'ab' #> [1] ERY as.ab(\"ERYT\") #> Class 'ab' #> [1] ERY as.ab(\"ERY\") #> Class 'ab' #> [1] ERY as.ab(\"eritromicine\") # spelled wrong, yet works #> Class 'ab' #> [1] ERY as.ab(\"Erythrocin\") # trade name #> Class 'ab' #> [1] ERY as.ab(\"Romycin\") # trade name #> Class 'ab' #> [1] ERY  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  # use ab_* functions to get a specific properties (see ?ab_property); # they use as.ab() internally: ab_name(\"J01FA01\") #> [1] \"Erythromycin\" ab_name(\"eryt\") #> [1] \"Erythromycin\"  # \\donttest{ if (require(\"dplyr\")) {   # you can quickly rename 'sir' columns using set_ab_names() with dplyr:   example_isolates %>%     set_ab_names(where(is.sir), property = \"atc\") } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           J01CE01 J01CF04 J01CF05 #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir>   <sir>   <sir>   #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R       NA      NA      #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R       NA      NA      #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R       NA      S       #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R       NA      S       #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R       NA      S       #> # ℹ 1,990 more rows #> # ℹ 37 more variables: J01CA04 <sir>, J01CR02 <sir>, J01CA01 <sir>, #> #   J01CR05 <sir>, J01DB04 <sir>, J01DE01 <sir>, J01DC02 <sir>, J01DC01 <sir>, #> #   J01DD01 <sir>, J01DD02 <sir>, J01DD04 <sir>, J01GB03 <sir>, J01GB01 <sir>, #> #   J01GB06 <sir>, J01GB04 <sir>, J01EA01 <sir>, J01EE01 <sir>, J01XE01 <sir>, #> #   J01XX01 <sir>, J01XX08 <sir>, J01MA02 <sir>, J01MA14 <sir>, J01XA01 <sir>, #> #   J01XA02 <sir>, J01AA07 <sir>, J01AA12 <sir>, J01AA02 <sir>, … # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/as.av.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Transform Input to an Antiviral Drug ID — as.av","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 6 50.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 6 50 millimetres. Values higher 50 lower 100 maximised 50. others input values outside 6-50 range return NA. NA_disk_ missing value new disk class.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/as.disk.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"# transform existing disk zones to the `disk` class (using base R) df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = 20,   CIP = 14,   GEN = 18,   TOB = 16 ) df[, 2:5] <- lapply(df[, 2:5], as.disk) str(df) #> 'data.frame':\t1 obs. of  5 variables: #>  $ microorganism: chr \"Escherichia coli\" #>  $ AMP          : 'disk' int 20 #>  $ CIP          : 'disk' int 14 #>  $ GEN          : 'disk' int 18 #>  $ TOB          : 'disk' int 16  # \\donttest{ # transforming is easier with dplyr: if (require(\"dplyr\")) {   df %>% mutate(across(AMP:TOB, as.disk)) } #>      microorganism AMP CIP GEN TOB #> 1 Escherichia coli  20  14  18  16 # }  # interpret disk values, see ?as.sir as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting disk diffusion zones: 'ampicillin' (AMP), EUCAST 2023... #>  OK  #> Class 'sir' #> [1] R  # interpret whole data set, pretend to be all from urinary tract infections: as.sir(df, uti = TRUE) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting disk diffusion zones: column 'AMP' (ampicillin), EUCAST #> 2023... #>  OK  #> Interpreting disk diffusion zones: column 'CIP' (ciprofloxacin), EUCAST #> 2023... #>  OK  #> Interpreting disk diffusion zones: column 'GEN' (gentamicin), EUCAST #> 2023... #>  OK  #> Interpreting disk diffusion zones: column 'TOB' (tobramycin), EUCAST #> 2023... #>  OK  #>      microorganism AMP  CIP GEN TOB #> 1 Escherichia coli   S <NA>   S   S"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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_  limit_mic_range(x, mic_range, keep_operators = \"edges\", as.mic = TRUE)  # S3 method for mic droplevels(x, as.mic = FALSE, ...)"},{"path":"https://msberends.github.io/AMR/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 limit MIC values, e.g., mic_range = c(0.001, 32). Use NA set limit one side, e.g., mic_range = c(NA, 32). .mic logical indicate whether mic class kept - default FALSE ... arguments passed methods","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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-2023) CLSI (2011-2023). 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()). functions stats package 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). Use droplevels() drop unused levels. default, return plain factor. Use droplevels(..., .mic = TRUE) maintain mic class. limit_mic_range(), 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_.","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://msberends.github.io/AMR/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  # limit MICs using limit_mic_range() limit_mic_range(mic_data, mic_range = c(4, 16)) #> Class 'mic' #> [1] >=16 <=4  <=4  <=4  8    <=4  8    >=16 >=16  # interpret MIC values as.sir(   x = as.mic(2),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMX' (amoxicillin), EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for amoxicillin (AMX) in Streptococcus #>      pneumoniae - assuming body site 'Meningitis'. #> Class 'sir' #> [1] R as.sir(   x = as.mic(c(0.01, 2, 4, 8)),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMX' (amoxicillin), EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for amoxicillin (AMX) in Streptococcus #>      pneumoniae - assuming body site 'Meningitis'. #> 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://msberends.github.io/AMR/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, 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://msberends.github.io/AMR/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()),   language = get_AMR_locale(),   info = interactive(),   ... )  is.mo(x)  mo_uncertainties()  mo_renamed()  mo_failures()  mo_reset_session()  mo_cleaning_regex()"},{"path":"https://msberends.github.io/AMR/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. language language translate text like \"growth\", defaults system language (see get_AMR_locale()) info logical indicate progress bar printed 25 items coerced - default TRUE interactive mode ... arguments passed functions","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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' returned MO code UNKNOWN warning. Use mo_* functions get properties based returned code, see Examples. .mo() function uses novel matching score algorithm (see Matching Score Microorganisms ) match input available microbial taxonomy package. lead effect e.g. \"E. coli\" (microorganism highly prevalent humans) return microbial ID Escherichia coli Entamoeba coli (microorganism less prevalent humans), although latter alphabetically come first. Becker = TRUE, following 85 staphylococci converted coagulase-negative group: S. argensis, S. arlettae, S. auricularis, S. borealis, 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. 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. 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. following 16 staphylococci converted coagulase-positive group: 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. Lancefield = TRUE, following streptococci converted corresponding Lancefield group: S. agalactiae (Group B), S. anginosus anginosus (Group F), S. anginosus whileyi (Group F), S. anginosus (Group F), S. canis (Group G), S. dysgalactiae dysgalactiae (Group C), S. dysgalactiae equisimilis (Group C), S. dysgalactiae (Group C), S. equi equi (Group C), S. equi ruminatorum (Group C), S. equi zooepidemicus (Group C), S. equi (Group C), S. pyogenes (Group ), S. salivarius salivarius (Group K), S. salivarius thermophilus (Group K), S. salivarius (Group K), S. sanguinis (Group H).","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   \\----> taxonomic kingdom: A (Archaea), AN (Animalia), B (Bacteria),                             F (Fungi), PL (Plantae), P (Protozoa)"},{"path":"https://msberends.github.io/AMR/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 evaluate results mo_uncertainties(), returns data.frame specifications. increase quality matching, cleaning_regex argument can used clean input (.e., x). 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://msberends.github.io/AMR/reference/as.mo.html","id":"microbial-prevalence-of-pathogens-in-humans","dir":"Reference","previous_headings":"","what":"Microbial Prevalence of Pathogens in Humans","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"coercion rules consider prevalence microorganisms humans, available prevalence column microorganisms data set. grouping human pathogenic prevalence explained section Matching Score Microorganisms .","code":""},{"path":"https://msberends.github.io/AMR/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 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 Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571 Berends MS et al. (2022). Trends Occurrence Phenotypic Resistance Coagulase-Negative Staphylococci (CoNS) Found Human Blood Northern Netherlands 2013 2019/ Micro.rganisms 10(9), 1801; doi:10.3390/microorganisms10091801 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 December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org January 8th, 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 May 12th, 2023. 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://phinvads.cdc.gov Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://msberends.github.io/AMR/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 :  : \\(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, 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.0 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, genus present established list also prevalence = 1.0 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, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Conidiobolus, Contracaecum, Cordylobia, Cryptococcus, Curvularia, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Haloarcula, Halobacterium, Halococcus, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kodamaea, Leishmania, Lichtheimia, Lodderomyces, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Pediculus, Penicillium, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoterranova, Pulex, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saprochaete, Sarcoptes, Scedosporium, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporotrichum, Stachybotrys, Strongyloides, Syngamus, Taenia, Talaromyces, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Verticillium, Wuchereria; 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://msberends.github.io/AMR/reference/as.mo.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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- \\(\\)\\[\\]{}]+|([({]|\\[).+([})]|\\])|(^| )(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 Expert Rules' and #>   'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3 (2021). This note #>   will be shown once per session. #> [1] TRUE # }"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":null,"dir":"Reference","previous_headings":"","what":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","title":"Translate MIC and Disk Diffusion to 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. breakpoints currently available: clinical microbiology EUCAST 2011-2023 CLSI 2011-2023; veterinary microbiology EUCAST 2021-2023 CLSI 2019-2023; ECOFFs (Epidemiological cut-values) EUCAST 2020-2023 CLSI 2022-2023. breakpoints used interpretation available clinical_breakpoints data set.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Translate MIC and Disk Diffusion to 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)  # S3 method for default as.sir(   x,   S = \"^(S|U)+$\",   I = \"^(I|H)+$\",   R = \"^(R)+$\",   N = \"^(N|V)+$\",   SDD = \"^(SDD|D)+$\",   ... )  # S3 method for mic as.sir(   x,   mo = NULL,   ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   uti = NULL,   conserve_capped_values = FALSE,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   host = NULL,   ... )  # S3 method for 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,   include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   host = NULL,   ... )  # S3 method for data.frame as.sir(   x,   ...,   col_mo = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   uti = NULL,   conserve_capped_values = FALSE,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   host = NULL )  sir_interpretation_history(clean = FALSE)"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Translate MIC and Disk Diffusion to 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-2023, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. CLSI M100: Performance Standard Antimicrobial Susceptibility Testing, 2011-2023, 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-2023, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/veterinary-medicine/documents/vet01//. EUCAST Breakpoint tables interpretation MICs zone diameters, 2011-2023, European Committee Antimicrobial Susceptibility Testing (EUCAST). https://www.eucast.org/clinical_breakpoints.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"x vector values (class mic: MIC values mg/L, class disk: disk diffusion radius millimetres) ... using data.frame: names columns apply .sir() (supports tidy selection column1:column4). Otherwise: arguments passed methods. threshold maximum fraction invalid antimicrobial interpretations x, see Examples S, , R, N, SDD case-indepdendent regular expression translate input result. regular expression run non-letters removed input. mo (vector ) text can coerced valid microorganism codes .mo(), can left empty determine automatically ab (vector ) text can coerced valid antimicrobial drug code .ab() guideline defaults EUCAST 2023 (latest implemented EUCAST guideline clinical_breakpoints data set), can set package option AMR_guideline. Currently supports EUCAST (2011-2023) CLSI (2011-2023), see Details. uti (Urinary Tract Infection) vector 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. conserve_capped_values logical indicate MIC values starting \">\" (\">=\") must always return \"R\" , MIC values starting \"<\" (\"<=\") must always return \"S\" 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. include_screening logical indicate clinical breakpoints screening allowed - default FALSE. Can also set package option AMR_include_screening. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". host vector (column name) characters indicate host. useful veterinary breakpoints, requires breakpoint_type = \"animal\". values can text resembling animal species, even 20 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). col_mo column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). clean logical indicate whether previously stored results forgotten returning 'logbook' results","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"Ordered factor new class sir","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate MIC and Disk Diffusion to 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://msberends.github.io/AMR/reference/as.sir.html","id":"how-it-works","dir":"Reference","previous_headings":"","what":"How it Works","title":"Translate MIC and Disk Diffusion to 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, N 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. Using dplyr, SIR interpretation can done easily either:   Operators like \"<=\" stripped interpretation. using conserve_capped_values = TRUE, MIC value e.g. \">2\" always return \"R\", even breakpoint according chosen guideline \">=4\". prevent capped values raw laboratory data treated conservatively. default behaviour (conserve_capped_values = FALSE) considers \">2\" lower \">=4\" might case return \"S\" \"\". 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. Using dplyr, SIR interpretation can done easily either:   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 (tibble tibble package installed) results last .sir() call.","code":"your_data %>% mutate_if(is.mic, as.sir) your_data %>% mutate(across(where(is.mic), as.sir))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.mic, as.sir, host = \"column_with_animal_hosts\", guideline = \"CLSI\") your_data %>% mutate_if(is.disk, as.sir) your_data %>% mutate(across(where(is.disk), as.sir))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.disk, as.sir, host = \"column_with_animal_hosts\", guideline = \"CLSI\")"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"supported-guidelines","dir":"Reference","previous_headings":"","what":"Supported Guidelines","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"interpreting MIC values well disk diffusion diameters, currently implemented guidelines clinical microbiology: EUCAST 2011-2023 CLSI 2011-2023, veterinary microbiology: EUCAST 2021-2023 CLSI 2019-2023. Thus, guideline argument must set e.g., \"EUCAST 2023\" \"CLSI 2023\". simply using \"EUCAST\" (default) \"CLSI\" input, latest included version guideline automatically selected. can set data set using reference_data argument. guideline argument ignored. can set default guideline package option AMR_guideline (e.g. .Rprofile file), :   veterinary guidelines, might best options:","code":"options(AMR_guideline = \"CLSI\")   options(AMR_guideline = \"CLSI 2018\")   options(AMR_guideline = \"EUCAST 2020\")   # or to reset:   options(AMR_guideline = NULL) options(AMR_guideline = \"CLSI\")   options(AMR_breakpoint_type = \"animal\")"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"after-interpretation","dir":"Reference","previous_headings":"","what":"After Interpretation","title":"Translate MIC and Disk Diffusion to 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.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"machine-readable-clinical-breakpoints","dir":"Reference","previous_headings":"","what":"Machine-Readable Clinical Breakpoints","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"repository package contains machine-readable version guidelines. CSV file consisting 29 883 rows 13 columns. file machine-readable, since contains one row every unique combination test method (MIC disk diffusion), antimicrobial drug microorganism. allows easy implementation rules laboratory information systems (LIS). Note contains interpretation guidelines humans - interpretation guidelines CLSI animals removed.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"function .sir() detects input contains class sir. input data.frame, iterates columns returns logical vector. function is_sir_eligible() returns TRUE columns contains 5% invalid antimicrobial interpretations (S //R /N /SDD), FALSE otherwise. threshold 5% can set threshold argument. input data.frame, iterates columns returns logical vector.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … summary(example_isolates) # see all SIR results at a glance #>       date              patient               age           gender          #>  Min.   :2002-01-02   Length:2000        Min.   : 0.00   Length:2000        #>  1st Qu.:2005-07-31   Class :character   1st Qu.:63.00   Class :character   #>  Median :2009-07-31   Mode  :character   Median :74.00   Mode  :character   #>  Mean   :2009-11-20                      Mean   :70.69                      #>  3rd Qu.:2014-05-30                      3rd Qu.:82.00                      #>  Max.   :2017-12-28                      Max.   :97.00                      #>      ward                mo                  PEN                 #>  Length:2000        Class :mo             Class:sir              #>  Class :character   <NA>  :0              %R   :73.7% (n=1201)   #>  Mode  :character   Unique:90             %SI  :26.3% (n=428)    #>                     #1    :B_ESCHR_COLI   - %S :25.6% (n=417)    #>                     #2    :B_STPHY_CONS   - %I : 0.7% (n=11)     #>                     #3    :B_STPHY_AURS                          #>     OXA                   FLC                   AMX                #>  Class:sir             Class:sir             Class:sir             #>  %R   :31.2% (n=114)   %R   :29.5% (n=278)   %R   :59.6% (n=804)   #>  %SI  :68.8% (n=251)   %SI  :70.5% (n=665)   %SI  :40.4% (n=546)   #>  - %S :68.8% (n=251)   - %S :70.5% (n=665)   - %S :40.2% (n=543)   #>  - %I : 0.0% (n=0)     - %I : 0.0% (n=0)     - %I : 0.2% (n=3)     #>                                                                    #>     AMC                    AMP                   TZP                #>  Class:sir              Class:sir             Class:sir             #>  %R   :23.7% (n=446)    %R   :59.6% (n=804)   %R   :12.6% (n=126)   #>  %SI  :76.3% (n=1433)   %SI  :40.4% (n=546)   %SI  :87.4% (n=875)   #>  - %S :71.4% (n=1342)   - %S :40.2% (n=543)   - %S :86.1% (n=862)   #>  - %I : 4.8% (n=91)     - %I : 0.2% (n=3)     - %I : 1.3% (n=13)    #>                                                                     #>     CZO                   FEP                   CXM                 #>  Class:sir             Class:sir             Class:sir              #>  %R   :44.6% (n=199)   %R   :14.2% (n=103)   %R   :26.3% (n=470)    #>  %SI  :55.4% (n=247)   %SI  :85.8% (n=621)   %SI  :73.7% (n=1319)   #>  - %S :54.9% (n=245)   - %S :85.6% (n=620)   - %S :72.5% (n=1297)   #>  - %I : 0.4% (n=2)     - %I : 0.1% (n=1)     - %I : 1.2% (n=22)     #>                                                                     #>     FOX                   CTX                   CAZ                 #>  Class:sir             Class:sir             Class:sir              #>  %R   :27.4% (n=224)   %R   :15.5% (n=146)   %R   :66.5% (n=1204)   #>  %SI  :72.6% (n=594)   %SI  :84.5% (n=797)   %SI  :33.5% (n=607)    #>  - %S :71.6% (n=586)   - %S :84.4% (n=796)   - %S :33.5% (n=607)    #>  - %I : 1.0% (n=8)     - %I : 0.1% (n=1)     - %I : 0.0% (n=0)      #>                                                                     #>     CRO                   GEN                    TOB                #>  Class:sir             Class:sir              Class:sir             #>  %R   :15.5% (n=146)   %R   :24.6% (n=456)    %R   :34.4% (n=465)   #>  %SI  :84.5% (n=797)   %SI  :75.4% (n=1399)   %SI  :65.6% (n=886)   #>  - %S :84.4% (n=796)   - %S :74.0% (n=1372)   - %S :65.1% (n=879)   #>  - %I : 0.1% (n=1)     - %I : 1.5% (n=27)     - %I : 0.5% (n=7)     #>                                                                     #>     AMK                   KAN                    TMP                #>  Class:sir             Class:sir              Class:sir             #>  %R   :63.7% (n=441)   %R   :100.0% (n=471)   %R   :38.1% (n=571)   #>  %SI  :36.3% (n=251)   %SI  : 0.0% (n=0)      %SI  :61.9% (n=928)   #>  - %S :36.3% (n=251)   - %S : 0.0% (n=0)      - %S :61.2% (n=918)   #>  - %I : 0.0% (n=0)     - %I : 0.0% (n=0)      - %I : 0.7% (n=10)    #>                                                                     #>     SXT                    NIT                   FOS                #>  Class:sir              Class:sir             Class:sir             #>  %R   :20.5% (n=361)    %R   :17.1% (n=127)   %R   :42.2% (n=148)   #>  %SI  :79.5% (n=1398)   %SI  :82.9% (n=616)   %SI  :57.8% (n=203)   #>  - %S :79.1% (n=1392)   - %S :76.0% (n=565)   - %S :57.8% (n=203)   #>  - %I : 0.3% (n=6)      - %I : 6.9% (n=51)    - %I : 0.0% (n=0)     #>                                                                     #>     LNZ                   CIP                    MFX                #>  Class:sir             Class:sir              Class:sir             #>  %R   :69.3% (n=709)   %R   :16.2% (n=228)    %R   :33.6% (n=71)    #>  %SI  :30.7% (n=314)   %SI  :83.8% (n=1181)   %SI  :66.4% (n=140)   #>  - %S :30.7% (n=314)   - %S :78.9% (n=1112)   - %S :64.5% (n=136)   #>  - %I : 0.0% (n=0)     - %I : 4.9% (n=69)     - %I : 1.9% (n=4)     #>                                                                     #>     VAN                    TEC                   TCY                #>  Class:sir              Class:sir             Class:sir             #>  %R   :38.3% (n=712)    %R   :75.7% (n=739)   %R   :29.8% (n=357)   #>  %SI  :61.7% (n=1149)   %SI  :24.3% (n=237)   %SI  :70.3% (n=843)   #>  - %S :61.7% (n=1149)   - %S :24.3% (n=237)   - %S :68.3% (n=820)   #>  - %I : 0.0% (n=0)      - %I : 0.0% (n=0)     - %I : 1.9% (n=23)    #>                                                                     #>     TGC                   DOX                   ERY                 #>  Class:sir             Class:sir             Class:sir              #>  %R   :12.7% (n=101)   %R   :27.7% (n=315)   %R   :57.2% (n=1084)   #>  %SI  :87.3% (n=697)   %SI  :72.3% (n=821)   %SI  :42.8% (n=810)    #>  - %S :87.3% (n=697)   - %S :71.7% (n=814)   - %S :42.3% (n=801)    #>  - %I : 0.0% (n=0)     - %I : 0.6% (n=7)     - %I : 0.5% (n=9)      #>                                                                     #>     CLI                   AZM                    IPM                #>  Class:sir             Class:sir              Class:sir             #>  %R   :61.2% (n=930)   %R   :57.2% (n=1084)   %R   : 6.2% (n=55)    #>  %SI  :38.8% (n=590)   %SI  :42.8% (n=810)    %SI  :93.8% (n=834)   #>  - %S :38.6% (n=586)   - %S :42.3% (n=801)    - %S :92.7% (n=824)   #>  - %I : 0.3% (n=4)     - %I : 0.5% (n=9)      - %I : 1.1% (n=10)    #>                                                                     #>     MEM                   MTR                  CHL                #>  Class:sir             Class:sir            Class:sir             #>  %R   : 5.9% (n=49)    %R   :14.7% (n=5)    %R   :21.4% (n=33)    #>  %SI  :94.1% (n=780)   %SI  :85.3% (n=29)   %SI  :78.6% (n=121)   #>  - %S :94.1% (n=780)   - %S :85.3% (n=29)   - %S :78.6% (n=121)   #>  - %I : 0.0% (n=0)     - %I : 0.0% (n=0)    - %I : 0.0% (n=0)     #>                                                                   #>     COL                    MUP                   RIF                #>  Class:sir              Class:sir             Class:sir             #>  %R   :81.2% (n=1331)   %R   : 5.9% (n=16)    %R   :69.6% (n=698)   #>  %SI  :18.8% (n=309)    %SI  :94.1% (n=254)   %SI  :30.4% (n=305)   #>  - %S :18.8% (n=309)    - %S :93.0% (n=251)   - %S :30.2% (n=303)   #>  - %I : 0.0% (n=0)      - %I : 1.1% (n=3)     - %I : 0.2% (n=2)     #>                                                                      # For INTERPRETING disk diffusion and MIC values -----------------------  # a whole data set, even with combined MIC values and disk zones df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = as.mic(8),   CIP = as.mic(0.256),   GEN = as.disk(18),   TOB = as.disk(16),   ERY = \"R\" ) as.sir(df) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: column 'AMP' (ampicillin), EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: column 'CIP' (ciprofloxacin), EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: column 'GEN' (gentamicin), EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: column 'TOB' (tobramycin), EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Assigning class 'sir' to already clean column 'ERY' (erythromycin)... #>  OK  #>      microorganism AMP CIP GEN TOB ERY #> 1 Escherichia coli   S   I   S   S   R  # return a 'logbook' about the results: sir_interpretation_history() #> # A tibble: 13 × 14 #>    datetime            index ab_user    mo_user    ab   mo                input #>    <dttm>              <int> <chr>      <chr>      <ab> <mo>              <dbl> #>  1 2024-05-20 17:02:01     1 TOB        Escherich… TOB  B_[ORD]_ENTRBCTR 16     #>  2 2024-05-20 17:02:00     1 GEN        Escherich… GEN  B_[ORD]_ENTRBCTR 18     #>  3 2024-05-20 17:02:00     1 CIP        Escherich… CIP  B_[ORD]_ENTRBCTR  0.256 #>  4 2024-05-20 17:02:00     1 AMP        Escherich… AMP  B_[ORD]_ENTRBCTR  8     #>  5 2024-05-20 17:01:56     1 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      0.01  #>  6 2024-05-20 17:01:56     2 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      2     #>  7 2024-05-20 17:01:56     3 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      4     #>  8 2024-05-20 17:01:56     4 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      8     #>  9 2024-05-20 17:01:55     1 AMX        B_STRPT_P… AMX  B_STRPT_PNMN      2     #> 10 2024-05-20 17:01:55     1 TOB        Escherich… TOB  B_[ORD]_ENTRBCTR 16     #> 11 2024-05-20 17:01:55     1 GEN        Escherich… GEN  B_[ORD]_ENTRBCTR 18     #> 12 2024-05-20 17:01:55     1 AMP        Escherich… AMP  B_[ORD]_ENTRBCTR 20     #> 13 2024-05-20 17:01:55     1 ampicillin Strep pneu AMP  B_STRPT_PNMN     18     #> # ℹ 7 more variables: outcome <sir>, method <chr>, breakpoint_S_R <chr>, #> #   guideline <chr>, host <chr>, ref_table <chr>, uti <lgl>  # for single values as.sir(   x = as.mic(2),   mo = as.mo(\"S. pneumoniae\"),   ab = \"AMP\",   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin), EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ampicillin (AMP) in Streptococcus #>      pneumoniae - assuming body site 'Non-meningitis'. #> 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\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting disk diffusion zones: 'ampicillin' (AMP), EUCAST 2023... #>  OK  #> Class 'sir' #> [1] R  # \\donttest{ # the dplyr way if (require(\"dplyr\")) {   df %>% mutate_if(is.mic, as.sir)   df %>% mutate_if(function(x) is.mic(x) | is.disk(x), as.sir)   df %>% mutate(across(where(is.mic), as.sir))   df %>% mutate_at(vars(AMP:TOB), as.sir)   df %>% mutate(across(AMP:TOB, as.sir))    df %>%     mutate_at(vars(AMP:TOB), as.sir, mo = .$microorganism)    # to include information about urinary tract infections (UTI)   data.frame(     mo = \"E. coli\",     NIT = c(\"<= 2\", 32),     from_the_bladder = c(TRUE, FALSE)   ) %>%     as.sir(uti = \"from_the_bladder\")    data.frame(     mo = \"E. coli\",     NIT = c(\"<= 2\", 32),     specimen = c(\"urine\", \"blood\")   ) %>%     as.sir() # automatically determines urine isolates    df %>%     mutate_at(vars(AMP:TOB), as.sir, mo = \"E. coli\", uti = TRUE) } #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' (gentamicin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' (tobramycin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' (gentamicin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' (tobramycin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' (ciprofloxacin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' (gentamicin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' (tobramycin) based on column #> 'microorganism', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin), EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' (ciprofloxacin), EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' (gentamicin), EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' (tobramycin), EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: column 'NIT' (nitrofurantoin), EUCAST 2023... #>  OK  #> ℹ Assuming value \"urine\" in column 'specimen' reflects a urinary tract #>   infection. #>   Use as.sir(uti = FALSE) to prevent this. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: column 'NIT' (nitrofurantoin), EUCAST 2023... #>  OK  #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' (ampicillin), EUCAST 2023... #>  OK  #> Interpreting MIC values: 'CIP' (ciprofloxacin), EUCAST 2023... #>  OK  #> Interpreting disk diffusion zones: 'GEN' (gentamicin), EUCAST 2023... #>  OK  #> Interpreting disk diffusion zones: 'TOB' (tobramycin), EUCAST 2023... #>  OK  #>      microorganism AMP  CIP GEN TOB ERY #> 1 Escherichia coli   S <NA>   S   S   R  # For CLEANING existing SIR values ------------------------------------  as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"N\", \"A\", \"B\", \"C\")) #> Warning: in as.sir(): 3 results in column '24' truncated (38%) that were invalid #> antimicrobial interpretations: \"A\", \"B\", and \"C\" #> Class 'sir' #> [1] S    SDD  I    R    N    <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   # the dplyr way if (require(\"dplyr\")) {   example_isolates %>%     mutate_at(vars(PEN:RIF), as.sir)   # same:   example_isolates %>%     as.sir(PEN:RIF)    # fastest way to transform all columns with already valid AMR results to class `sir`:   example_isolates %>%     mutate_if(is_sir_eligible, as.sir)    # since dplyr 1.0.0, this can also be:   # example_isolates %>%   #   mutate(across(where(is_sir_eligible), as.sir)) } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://msberends.github.io/AMR/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. antibiotic), name, defined daily dose (DDD) standard unit.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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) antibiotics, 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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/atc_online.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"# \\donttest{ if (requireNamespace(\"curl\") && requireNamespace(\"rvest\") && requireNamespace(\"xml2\")) {   # oral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"O\")   atc_online_ddd(ab_atc(\"amox\"))    # parenteral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"P\")    atc_online_property(\"J01CA04\", property = \"groups\") # search hierarchical groups of amoxicillin } #> Loading required namespace: rvest #> [1] \"ANTIINFECTIVES FOR SYSTEMIC USE\"         #> [2] \"ANTIBACTERIALS FOR SYSTEMIC USE\"         #> [3] \"BETA-LACTAM ANTIBACTERIALS, PENICILLINS\" #> [4] \"Penicillins with extended spectrum\"      # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/av_property.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Get Properties of an Antiviral Drug — av_property","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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, ...)  # S3 method for 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://msberends.github.io/AMR/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 antibiotic 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() ... arguments passed FUN translate_ab character length 1 containing column names antibiotics 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 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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     N 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 \"Ampheni… Chlo… \"\"    \"\"        \"\"            \"\"              \"100.0% (30/30… #>  6 \"Antimyc… Rifa… \"\"    \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  7 \"Beta-la… Amox… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  8 \"\"        Amox… \" 42… \" 13.1% … \"\"            \" 10.3% (6/58)\" \"100.0% (30/30… #>  9 \"\"        Ampi… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> 10 \"\"        Benz… \" 77… \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> # ℹ 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     N 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     N 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://msberends.github.io/AMR/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. Currently available breakpoint guidelines clinical microbiology EUCAST 2011-2023 CLSI 2011-2023. Currently available breakpoint guidelines veterinary microbiology EUCAST 2021-2023 CLSI 2019-2023. Use .sir() transform MICs disks measurements SIR values.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 29 883 observations 13 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 Antibiotic 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\" uti logical value (TRUE/FALSE) indicate whether rule applies urinary tract infection (UTI)","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 development WHONET software.","code":""},{"path":"https://msberends.github.io/AMR/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 AMR package.","code":""},{"path":"https://msberends.github.io/AMR/reference/clinical_breakpoints.html","id":"download","dir":"Reference","previous_headings":"","what":"Download","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository. allow machine reading EUCAST CLSI guidelines, almost impossible MS Excel PDF files distributed EUCAST CLSI, though initiatives started overcome burdens. NOTE: 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 using breakpoints use.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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: 29,883 × 13 #>    guideline   type  host  method site    mo            rank_index ab   ref_tbl  #>    <chr>       <chr> <chr> <chr>  <chr>   <mo>               <dbl> <ab> <chr>    #>  1 EUCAST 2023 human human DISK   NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  2 EUCAST 2023 human human MIC    NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  3 EUCAST 2023 human human DISK   NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  4 EUCAST 2023 human human MIC    NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  5 EUCAST 2023 human human DISK   NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  6 EUCAST 2023 human human MIC    NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  7 EUCAST 2023 human human DISK   NA      B_ACNTB                3 AMK  Acineto… #>  8 EUCAST 2023 human human DISK   Uncomp… B_ACNTB                3 AMK  Acineto… #>  9 EUCAST 2023 human human MIC    NA      B_ACNTB                3 AMK  Acineto… #> 10 EUCAST 2023 human human MIC    Uncomp… B_ACNTB                3 AMK  Acineto… #> # ℹ 29,873 more rows #> # ℹ 4 more variables: disk_dose <chr>, breakpoint_S <dbl>, breakpoint_R <dbl>, #> #   uti <lgl>"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics, see section Combination Therapy data data.frame containing columns class sir (see .sir()) translate_ab column name antibiotics 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 must merged one, output consists S+vs. R (susceptible vs. resistant) - default TRUE","code":""},{"path":"https://msberends.github.io/AMR/reference/count.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count Available Isolates — count","text":"integer","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics 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://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics/variables test . See example two antibiotics, 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   include as  include as   include as  include as                     numerator   denominator  numerator   denominator --------  --------  ----------  -----------  ----------  -----------  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://msberends.github.io/AMR/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) #> Using count_S() is discouraged; use count_susceptible() instead to also #> consider \"I\" and \"SDD\" being susceptible. This note will be shown once for #> this session. #> [1] 543 count_SI(example_isolates$AMX) #> Note that count_SI() will also count dose-dependent susceptibility, #> 'SDD'. This note will be shown once for this session. #> [1] 546 count_I(example_isolates$AMX) #> Note that count_I() will also count dose-dependent susceptibility, 'SDD'. #> This note will be shown once for this session. #> [1] 3 count_IR(example_isolates$AMX) #> Using count_IR() is discouraged; use count_resistant() instead to not #> consider \"I\" and \"SDD\" being resistant. This note will be shown once for #> this session. #> [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: 18 × 4 #>    ward       antibiotic interpretation value #>  * <chr>      <chr>      <ord>          <int> #>  1 Clinical   AMX        SI               357 #>  2 Clinical   AMX        R                487 #>  3 Clinical   AMX        NA                 0 #>  4 Clinical   CIP        SI               741 #>  5 Clinical   CIP        R                128 #>  6 Clinical   CIP        NA                 0 #>  7 ICU        AMX        SI               158 #>  8 ICU        AMX        R                270 #>  9 ICU        AMX        NA                 0 #> 10 ICU        CIP        SI               362 #> 11 ICU        CIP        R                 85 #> 12 ICU        CIP        NA                 0 #> 13 Outpatient AMX        SI                31 #> 14 Outpatient AMX        R                 47 #> 15 Outpatient AMX        NA                 0 #> 16 Outpatient CIP        SI                78 #> 17 Outpatient CIP        R                 15 #> 18 Outpatient CIP        NA                 0 # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 Examples","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/custom_eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"organisations adoption EUCAST rules. function can used define custom EUCAST rules used eucast_rules() function.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    R     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://msberends.github.io/AMR/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\", \"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) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://msberends.github.io/AMR/reference/custom_eucast_rules.html","id":"usage-of-antibiotic-group-names","dir":"Reference","previous_headings":"","what":"Usage of antibiotic group names","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"possible define antibiotic groups instead single antibiotics rule consequence, part tilde. examples, antibiotic group aminopenicillins used include ampicillin amoxicillin. following groups allowed (case-insensitive). Within parentheses drugs matched running rule. \"aminoglycosides\"(amikacin, amikacin/fosfomycin, amphotericin B-high, 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\"(amphotericin B, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole) \"antimycobacterials\"(4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin) \"betalactams\"(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, avibactam, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, biapenem, carbenicillin, carindacillin, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/clavulanic acid, cefepime/nacubactam, cefepime/tazobactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening, 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, nacubactam, nafcillin, oxacillin, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbactam, sulbenicillin, sultamicillin, talampicillin, tazobactam, tebipenem, temocillin, ticarcillin, 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/clavulanic acid, cefepime/tazobactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening, 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, 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/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/clavulanic acid, cefepime/tazobactam, 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/clavulanic acid, cefepime/tazobactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening, 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, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nifuroquine, norfloxacin, ofloxacin, orbifloxacin, pazufloxacin, pefloxacin, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) \"glycopeptides\"(avoparcin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod) \"glycopeptides_except_lipo\"(avoparcin, norvancomycin, ramoplanin, teicoplanin, teicoplanin-macromethod, vancomycin, vancomycin-macromethod) \"lincosamides\"(acetylmidecamycin, acetylspiramycin, clindamycin, gamithromycin, kitasamycin, lincomycin, meleumycin, nafithromycin, pirlimycin, primycin, solithromycin, tildipirosin, tilmicosin, tulathromycin, tylosin, tylvalosin) \"lipoglycopeptides\"(dalbavancin, oritavancin, telavancin) \"macrolides\"(acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, pirlimycin, primycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin) \"oxazolidinones\"(cadazolid, cycloserine, linezolid, tedizolid, thiacetazone) \"penicillins\"(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, avibactam, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, carbenicillin, carindacillin, cefepime/nacubactam, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nacubactam, nafcillin, oxacillin, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbactam, sulbenicillin, sultamicillin, talampicillin, tazobactam, temocillin, ticarcillin, ticarcillin/clavulanic acid) \"polymyxins\"(colistin, polymyxin B, polymyxin B/polysorbate 80) \"quinolones\"(besifloxacin, cinoxacin, ciprofloxacin, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, ofloxacin, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) \"streptogramins\"(pristinamycin quinupristin/dalfopristin) \"tetracyclines\"(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tigecycline) \"tetracyclines_except_tgc\"(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline) \"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":""},{"path":"https://msberends.github.io/AMR/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,   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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/dosage.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"tibble 503 observations 9 variables: ab Antibiotic 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 13, 12, 11","code":""},{"path":"https://msberends.github.io/AMR/reference/dosage.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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: 503 × 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/kg… #>  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 iv #>  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 o… #>  6 AMX  Amoxicillin     unco… 0.5 g          3 oral           \"\"    0.5 g x 3 o… #>  7 AMC  Amoxicillin/cl… high… 2 g …          3 iv             \"\"    (2 g amoxic… #>  8 AMC  Amoxicillin/cl… stan… 1 g …          3 iv             \"\"    (1 g amoxic… #>  9 AMC  Amoxicillin/cl… high… 0.87…          3 oral           \"\"    (0.875 g am… #> 10 AMC  Amoxicillin/cl… stan… 0.5 …          3 oral           \"\"    (0.5 g amox… #> # ℹ 493 more rows #> # ℹ 1 more variable: eucast_version <dbl>"},{"path":"https://msberends.github.io/AMR/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 intrinsic resistance 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://msberends.github.io/AMR/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\", \"expert\")),   verbose = FALSE,   version_breakpoints = 12,   version_expertrules = 3.3,   ampc_cephalosporin_resistance = NA,   only_sir_columns = FALSE,   custom_rules = NULL,   ... )  eucast_dosage(ab, administration = \"iv\", version_breakpoints = 12)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply EUCAST Rules — eucast_rules","text":"x data set antibiotic 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\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expert\"). 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 \"12.0\", \"11.0\", \"10.0\". version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\". ampc_cephalosporin_resistance character value applied cefotaxime, ceftriaxone ceftazidime AmpC de-repressed cephalosporin-resistant mutants - default NA. Currently works version_expertrules 3.2 higher; version '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 antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE) custom_rules custom rules apply, created custom_eucast_rules() ... column name antibiotic, see section Antibiotics ab (vector ) text can coerced valid antibiotic drug code .ab() administration route administration, either \"im\", \"iv\", \"oral\"","code":""},{"path":"https://msberends.github.io/AMR/reference/eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply EUCAST Rules — eucast_rules","text":"input x, possibly edited values antibiotics. , verbose = TRUE, data.frame original new values affected bug-drug combinations.","code":""},{"path":"https://msberends.github.io/AMR/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 January 8th, 2024, see microorganisms.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/eucast_rules.html","id":"antibiotics","dir":"Reference","previous_headings":"","what":"Antibiotics","title":"Apply EUCAST Rules — eucast_rules","text":"define antibiotics column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antibiotics eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefetamet (CAT, J01DD10), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), ciprofloxacin (CIP, J01MA02), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), norfloxacin (, J01MA06), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), oleandomycin (OLE, J01FA05), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbactam (SUL, J01CG01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tazobactam (TAZ, J01CG02), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://msberends.github.io/AMR/reference/eucast_rules.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Apply EUCAST Rules — eucast_rules","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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) #> 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   S   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, 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   S      Expert Rules #> 4   1 CAZ Staphylococcus aureus   -   R      Expert Rules #> 5   1 COL Staphylococcus aureus   -   R      Expert Rules #> 6   2 CAZ Enterococcus faecalis   -   R      Expert Rules #>                                                 rule_name #> 1                                          Staphylococcus #> 2                                          Staphylococcus #> 3                          Expert Rules on Staphylococcus #> 4 Table 4: Intrinsic resistance in gram-positive bacteria #> 5 Table 4: Intrinsic resistance in gram-positive bacteria #> 6 Table 4: Intrinsic resistance in gram-positive bacteria #>                                                                                 rule_source #> 1                                           'EUCAST Clinical Breakpoint Tables' v12.0, 2022 #> 2                                           'EUCAST Clinical Breakpoint Tables' v12.0, 2022 #> 3 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 #> 4 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 #> 5 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 #> 6 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 # }  # Dosage guidelines:  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\") #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v12.0 (2022). This note will be shown once per session. #> # A tibble: 3 × 4 #>   ab   name          standard_dosage  high_dosage  #>   <ab> <chr>         <chr>            <chr>        #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA           #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA           #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\", version_breakpoints = 10) #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v10.0 (2020). This note will be shown once per session. #> # A tibble: 3 × 4 #>   ab   name          standard_dosage  high_dosage  #>   <ab> <chr>         <chr>            <chr>        #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA           #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA           #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics class sir (see .sir()); column names occur antibiotics data set can translated set_ab_names() ab_name()","code":""},{"path":"https://msberends.github.io/AMR/reference/example_isolates.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics transformed .sir()","code":""},{"path":"https://msberends.github.io/AMR/reference/example_isolates_unclean.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with Unclean Data — example_isolates_unclean","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/first_isolate.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine First Isolates — first_isolate","text":"Methodology function 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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/first_isolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine First Isolates — first_isolate","text":"logical vector","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine First Isolates — first_isolate","text":"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://msberends.github.io/AMR/reference/first_isolate.html","id":"different-methods","dir":"Reference","previous_headings":"","what":"Different methods","title":"Determine First Isolates — first_isolate","text":"According Hindler et al. (2007, doi:10.1086/511864 ), different methods (algorithms) select first isolates increasing reliability: isolate-based, patient-based, episode-based phenotype-based. methods select combination taxonomic genus species (subspecies). mentioned methods covered first_isolate() function:","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"isolate-based","dir":"Reference","previous_headings":"","what":"Isolate-based","title":"Determine First Isolates — first_isolate","text":"method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID.","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"patient-based","dir":"Reference","previous_headings":"","what":"Patient-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient , set episode_days Inf. Although often inappropriate, method makes sure duplicate isolates selected patient. large longitudinal data set, mean isolates excluded found years initial isolate.","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"episode-based","dir":"Reference","previous_headings":"","what":"Episode-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, 14, 30, 60 365. Short episodes common analysing specific hospital ward data, long episodes common analysing regional national data. common method correct duplicate isolates. Patients categorised episodes based ID dates (e.g., date specimen receipt laboratory result). common method, take account antimicrobial test results. means e.g. methicillin-resistant Staphylococcus aureus (MRSA) isolate differentiated wildtype Staphylococcus aureus isolate.","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"phenotype-based","dir":"Reference","previous_headings":"","what":"Phenotype-based","title":"Determine First Isolates — first_isolate","text":"reliable method, since also weighs antibiogram (antimicrobial test results) yielding -called 'first weighted isolates'. two different methods weigh antibiogram: Using type = \"points\" argument points_threshold (default) method weighs antimicrobial drugs available data set. difference S R (vice versa) counts 0.5 points, difference S R (vice versa) counts 1 point. sum points exceeds points_threshold, defaults 2, isolate selected first weighted isolate. antimicrobials internally selected using all_antimicrobials() function. output function need passed first_isolate() function. Using type = \"keyantimicrobials\" argument ignore_I method weighs specific antimicrobial drugs, called key antimicrobials. difference S R (vice versa) key antimicrobials select isolate first weighted isolate. ignore_I = FALSE, also differences S R (vice versa) lead . Key antimicrobials internally selected using key_antimicrobials() function, can also added manually variable data set col_keyantimicrobials argument. Another option pass output key_antimicrobials() function directly col_keyantimicrobials argument. default method phenotype-based (using type = \"points\") episode-based (using episode_days = 365). makes sure every genus-species combination selected per patient per year, taking account antimicrobial test results. antimicrobial test results available data set, episode-based method applied default.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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,373 'phenotype-based' first isolates (68.7% of total where a #>    microbial ID was available) #> # A tibble: 1,373 × 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-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #>  5 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR R     NA    S     NA    #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  7 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND R     NA    NA    R     #>  8 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL R     NA    NA    NA    #>  9 2002-02-03 481442     76 M      ICU      B_STPHY_CONS R     NA    S     NA    #> 10 2002-02-05 023456     50 M      Clinical B_STPHY_HMNS S     NA    S     NA    #> # ℹ 1,363 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: 434 × 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    #> # ℹ 424 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,373 'phenotype-based' first isolates (68.7% of total where a #>    microbial ID was available) #> # A tibble: 1,373 × 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-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #>  5 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR R     NA    S     NA    #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  7 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND R     NA    NA    R     #>  8 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL R     NA    NA    NA    #>  9 2002-02-03 481442     76 M      ICU      B_STPHY_CONS R     NA    S     NA    #> 10 2002-02-05 023456     50 M      Clinical B_STPHY_HMNS S     NA    S     NA    #> # ℹ 1,363 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,373 × 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-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #>  5 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR R     NA    S     NA    #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  7 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND R     NA    NA    R     #>  8 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL R     NA    NA    NA    #>  9 2002-02-03 481442     76 M      ICU      B_STPHY_CONS R     NA    S     NA    #> 10 2002-02-05 023456     50 M      Clinical B_STPHY_HMNS S     NA    S     NA    #> # ℹ 1,363 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 857 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #>  #> Group: ward = \"ICU\" #> ℹ Excluding 6 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 447 'phenotype-based' first isolates (69.2% of total where a #>    microbial ID was available) #>  #> Group: ward = \"Outpatient\" #> ℹ Excluding 1 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 98 'phenotype-based' first isolates (81.7% 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 FALSE #> 10 ICU      2002-01-17 858515  B_STPHY_EPDR TRUE  #> # ℹ 1,990 more rows # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/g.test.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"G-test for Count Data — g.test","text":"McDonald, J.H. 2014. Handbook Biological Statistics (3rd ed.). Sparky House Publishing, Baltimore, Maryland. http://www.biostathandbook.com/gtestgof.html.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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] 29 45 31 14 41 39 26 40 18 36 15 39 18 45 32 27 10  2 13 24 43 12  8  5  3 #>  [26] 12 31  9 16  4  1 26 32 27 21 45 42 17 16 21  8  4 30  1 17 25 34  5 10  1 #>  [51] 18 44 33  4  6 12 43  2 43 45 37 33 18 38 45 36 46  4 35 40 12  7 11 23 10 #>  [76] 35 20  4  5 29 27 41 12 30 45 18 46 22 28 39 19 27 45 16  4 21 40 39 39 10 is_new_episode(df$date, episode_days = 60) # TRUE/FALSE #>   [1]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE FALSE #>  [13] FALSE FALSE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [25]  TRUE FALSE FALSE  TRUE  TRUE  TRUE  TRUE FALSE FALSE FALSE  TRUE FALSE #>  [37]  TRUE  TRUE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE  TRUE  TRUE FALSE #>  [49] FALSE FALSE FALSE  TRUE  TRUE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE #>  [61]  TRUE FALSE FALSE  TRUE FALSE FALSE  TRUE FALSE  TRUE FALSE FALSE  TRUE #>  [73]  TRUE  TRUE FALSE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE FALSE #>  [85] FALSE FALSE FALSE  TRUE  TRUE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE #>  [97] FALSE 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: 1 × 46 #>   date       patient   age gender ward  mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr> <mo>         <sir> <sir> <sir> <sir> #> 1 2002-12-13 285137     78 F      ICU   B_ESCHR_COLI R     NA    NA    NA    #> # ℹ 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 [99] #>    patient date       condition new_episode #>    <chr>   <date>     <chr>     <lgl>       #>  1 036063  2010-01-28 A         TRUE        #>  2 077922  2009-08-18 A         TRUE        #>  3 080086  2010-08-08 B         TRUE        #>  4 0DBF93  2015-10-12 A         TRUE        #>  5 105248  2005-06-16 B         TRUE        #>  6 114570  2003-04-08 C         TRUE        #>  7 119392  2010-11-01 B         TRUE        #>  8 161740  2005-06-21 B         TRUE        #>  9 174209  2011-10-03 A         TRUE        #> 10 210105  2009-06-13 B         TRUE        #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward, patient) %>%     transmute(date,       patient,       new_index = get_episode(date, 60),       new_logical = is_new_episode(date, 60)     ) %>%     arrange(patient, ward, date) } #> # A tibble: 100 × 5 #> # Groups:   ward, patient [96] #>    ward       date       patient new_index new_logical #>    <chr>      <date>     <chr>       <int> <lgl>       #>  1 Clinical   2010-01-28 036063          1 TRUE        #>  2 Clinical   2009-08-18 077922          1 TRUE        #>  3 Clinical   2010-08-08 080086          1 TRUE        #>  4 Clinical   2015-10-12 0DBF93          1 TRUE        #>  5 Clinical   2005-06-16 105248          1 TRUE        #>  6 ICU        2003-04-08 114570          1 TRUE        #>  7 Clinical   2010-11-01 119392          1 TRUE        #>  8 Clinical   2005-06-21 161740          1 TRUE        #>  9 Outpatient 2011-10-03 174209          1 TRUE        #> 10 Clinical   2009-06-13 210105          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           63             12            35            45 #> 2 ICU                24              9            17            21 #> 3 Outpatient          9              7             7             9  # 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 [96] #>    patient mo           ward     flag_episode #>    <chr>   <mo>         <chr>    <lgl>        #>  1 686445  B_STPHY_CONS Clinical TRUE         #>  2 D39422  B_KLBSL_PNMN Clinical TRUE         #>  3 298662  B_ESCHR_COLI Clinical TRUE         #>  4 5B78D5  B_STPHY_AURS Clinical TRUE         #>  5 E52625  B_STRPT_PNMN Clinical TRUE         #>  6 645121  B_SERRT_MRCS Clinical TRUE         #>  7 807228  B_STRPT_PNMN Clinical TRUE         #>  8 D41749  B_ESCHR_COLI ICU      TRUE         #>  9 210105  B_ENTRC      Clinical TRUE         #> 10 789292  B_STRPT_SLVR Clinical TRUE         #> # ℹ 90 more rows # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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\"` and `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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/ggplot_sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"ggplot_sir(   data,   position = NULL,   x = \"antibiotic\",   fill = \"interpretation\",   facet = NULL,   breaks = seq(0, 1, 0.1),   limits = NULL,   translate_ab = \"name\",   combine_SI = TRUE,   minimum = 30,   language = get_AMR_locale(),   nrow = NULL,   colours = c(S = \"#3CAEA3\", SI = \"#3CAEA3\", I = \"#F6D55C\", IR = \"#ED553B\", R =     \"#ED553B\"),   datalabels = TRUE,   datalabels.size = 2.5,   datalabels.colour = \"grey15\",   title = NULL,   subtitle = NULL,   caption = NULL,   x.title = \"Antimicrobial\",   y.title = \"Proportion\",   ... )  geom_sir(   position = NULL,   x = c(\"antibiotic\", \"interpretation\"),   fill = \"interpretation\",   translate_ab = \"name\",   minimum = 30,   language = get_AMR_locale(),   combine_SI = TRUE,   ... )  facet_sir(facet = c(\"interpretation\", \"antibiotic\"), nrow = NULL)  scale_y_percent(breaks = seq(0, 1, 0.1), limits = NULL)  scale_sir_colours(..., aesthetics = \"fill\")  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://msberends.github.io/AMR/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 antibiotics data set translate antibiotic abbreviations , using ab_property() combine_SI logical indicate whether values S must merged one, output consists S+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. aesthetics aesthetics apply colours - default \"fill\" can also (combination ) \"alpha\", \"colour\", \"fill\", \"linetype\", \"shape\" \"size\"","code":""},{"path":"https://msberends.github.io/AMR/reference/ggplot_sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Plots with ggplot2 — ggplot_sir","text":"default, names antibiotics shown plots using ab_name(). can set translate_ab argument. See count_df().","code":""},{"path":"https://msberends.github.io/AMR/reference/ggplot_sir.html","id":"the-functions","dir":"Reference","previous_headings":"","what":"The Functions","title":"AMR Plots with ggplot2 — ggplot_sir","text":"geom_sir() take variable data sir class (created .sir()) using sir_df() plot bars percentage S, , R. default behaviour bars stacked different antibiotics x axis. 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][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://msberends.github.io/AMR/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() +     labels_sir_count() +     theme_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # or better yet, simplify this using the wrapper function - a single command:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # get only proportions and no counts:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(datalabels = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # add other ggplot2 arguments as you like:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(       width = 0.5,       colour = \"black\",       size = 1,       linetype = 2,       alpha = 0.25     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # you can alter the colours with colour names:   example_isolates %>%     select(AMX) %>%     ggplot_sir(colours = c(SI = \"yellow\")) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # but you can also use the built-in colour-blind friendly colours for   # your plots, where \"S\" is green, \"I\" is yellow and \"R\" is red:   data.frame(     x = c(\"Value1\", \"Value2\", \"Value3\"),     y = c(1, 2, 3),     z = c(\"Value4\", \"Value5\", \"Value6\")   ) %>%     ggplot() +     geom_col(aes(x = x, y = y, fill = z)) +     scale_sir_colours(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 9 rows containing missing values or values outside the scale range #> (`geom_col()`). #> Warning: Removed 9 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://msberends.github.io/AMR/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 antibiotics data set. Also supports WHONET abbreviations.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/guess_ab_col.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Guess Antibiotic Column — guess_ab_col","text":"x data.frame search_string text search x , checked .ab() value column x verbose logical indicate whether additional info printed only_sir_columns logical indicate whether antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE)","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics data set column containing name code antibiotic.","code":""},{"path":"https://msberends.github.io/AMR/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\" # NOTE: Using column 'tetr' as input for J01AA07 (tetracycline).  # 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, as.ab(\"augmentin\")) #> [1] \"AMC_ED20\""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Data set containing defined intrinsic resistance EUCAST bug-drug combinations.","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant"},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"tibble 134 634 observations 2 variables: mo Microorganism ID ab Antibiotic ID","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"data set based 'EUCAST Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021).","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"direct-download","dir":"Reference","previous_headings":"","what":"Direct download","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository. allow machine reading EUCAST CLSI guidelines, almost impossible MS Excel PDF files distributed EUCAST CLSI.","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant #> # A tibble: 134,634 × 2 #>    mo      ab    #>    <mo>    <chr> #>  1 B_GRAMP ATM   #>  2 B_GRAMP COL   #>  3 B_GRAMP NAL   #>  4 B_GRAMP PLB   #>  5 B_GRAMP TEM   #>  6 B_ABTRP ATM   #>  7 B_ABTRP COL   #>  8 B_ABTRP NAL   #>  9 B_ABTRP PLB   #> 10 B_ABTRP TEM   #> # ℹ 134,624 more rows"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 × 23 #>   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… #> # ℹ 13 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_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 × 23 #>   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… #> # ℹ 13 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_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\"         \"status\"           #>  [5] \"kingdom\"          \"phylum\"           \"class\"            \"order\"            #>  [9] \"family\"           \"genus\"            \"species\"          \"subspecies\"       #> [13] \"rank\"             \"ref\"              \"oxygen_tolerance\" \"source\"           #> [17] \"lpsn\"             \"lpsn_parent\"      \"lpsn_renamed_to\"  \"gbif\"             #> [21] \"gbif_parent\"      \"gbif_renamed_to\"  \"prevalence\"       \"snomed\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     left_join_microorganisms() %>%     colnames() } #> Joining, by = \"mo\" #>  [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\"              \"NIT\"              \"FOS\"              #> [29] \"LNZ\"              \"CIP\"              \"MFX\"              \"VAN\"              #> [33] \"TEC\"              \"TCY\"              \"TGC\"              \"DOX\"              #> [37] \"ERY\"              \"CLI\"              \"AZM\"              \"IPM\"              #> [41] \"MEM\"              \"MTR\"              \"CHL\"              \"COL\"              #> [45] \"MUP\"              \"RIF\"              \"fullname\"         \"status\"           #> [49] \"kingdom\"          \"phylum\"           \"class\"            \"order\"            #> [53] \"family\"           \"genus\"            \"species\"          \"subspecies\"       #> [57] \"rank\"             \"ref\"              \"oxygen_tolerance\" \"source\"           #> [61] \"lpsn\"             \"lpsn_parent\"      \"lpsn_renamed_to\"  \"gbif\"             #> [65] \"gbif_parent\"      \"gbif_renamed_to\"  \"prevalence\"       \"snomed\"           # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/key_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"key_antimicrobials(   x = NULL,   col_mo = NULL,   universal = c(\"ampicillin\", \"amoxicillin/clavulanic acid\", \"cefuroxime\",     \"piperacillin/tazobactam\", \"ciprofloxacin\", \"trimethoprim/sulfamethoxazole\"),   gram_negative = c(\"gentamicin\", \"tobramycin\", \"colistin\", \"cefotaxime\", \"ceftazidime\",     \"meropenem\"),   gram_positive = c(\"vancomycin\", \"teicoplanin\", \"tetracycline\", \"erythromycin\",     \"oxacillin\", \"rifampin\"),   antifungal = c(\"anidulafungin\", \"caspofungin\", \"fluconazole\", \"miconazole\", \"nystatin\",     \"voriconazole\"),   only_sir_columns = FALSE,   ... )  all_antimicrobials(x = NULL, only_sir_columns = FALSE, ...)  antimicrobials_equal(   y,   z,   type = c(\"points\", \"keyantimicrobials\"),   ignore_I = TRUE,   points_threshold = 2,   ... )"},{"path":"https://msberends.github.io/AMR/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 antibiotics columns, like AMX amox. Can left blank determine automatically col_mo column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). universal names broad-spectrum antimicrobial drugs, case-insensitive. Set NULL ignore. See Details default antimicrobial drugs gram_negative names antibiotic drugs Gram-positives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs gram_positive names antibiotic drugs Gram-negatives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs antifungal names antifungal drugs fungi, case-insensitive. Set NULL ignore. See Details default antifungal drugs only_sir_columns logical indicate whether columns must included transformed class sir (see .sir()) beforehand (default FALSE) ... ignored, place allow future extensions y, z character vectors compare type type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details points_threshold minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics 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] 1376 # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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)  # S3 method for default kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for matrix kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for data.frame kurtosis(x, na.rm = FALSE, excess = FALSE)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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.021297 kurtosis(rnorm(10000), excess = TRUE) #> [1] 0.08143396"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/mdro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"mdro(   x = NULL,   guideline = \"CMI2012\",   col_mo = NULL,   info = interactive(),   pct_required_classes = 0.5,   combine_SI = TRUE,   verbose = FALSE,   only_sir_columns = FALSE,   ... )  custom_mdro_guideline(..., as_factor = TRUE)  brmo(x = NULL, only_sir_columns = FALSE, ...)  mrgn(x = NULL, only_sir_columns = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = FALSE, ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = FALSE, ...)"},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"See supported guidelines list publications used function.","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"x data.frame antibiotics 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(). info logical indicate whether progress printed console - default print interactive sessions pct_required_classes minimal required percentage antimicrobial classes must available per isolate, rounded . example, default guideline, 17 antimicrobial classes must available S. aureus. Setting pct_required_classes argument 0.5 (default) means every S. aureus isolate least 8 different classes must available. lower number available classes return NA isolate. combine_SI logical indicate whether values S must merged one, resistance considered isolates R, . default behaviour mdro() function, follows redefinition EUCAST interpretation (increased exposure) 2019, see section 'Interpretation S, R' . using combine_SI = FALSE, resistance considered isolates R . verbose logical turn Verbose mode (default ). Verbose mode, function return MDRO results, instead returns data set logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE) ... case custom_mdro_guideline(): set rules, see section Using Custom Guidelines . Otherwise: column name antibiotic, see section Antibiotics . as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"CMI 2012 paper - function mdr_cmi2012() mdro(): Ordered factor levels Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant (XDR) < Pandrug-resistant (PDR) TB guideline - function mdr_tb() mdro(..., guideline = \"TB\"): Ordered factor levels Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant < Extensively drug-resistant German guideline - function mrgn() mdro(..., guideline = \"MRGN\"): Ordered factor levels Negative < 3MRGN < 4MRGN Everything else, except custom guidelines: Ordered factor levels Negative < Positive, unconfirmed < Positive. value \"Positive, unconfirmed\" means , according guideline, entirely sure isolate multi-drug resistant confirmed additional (e.g. molecular) tests","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/mdro.html","id":"supported-international-national-guidelines","dir":"Reference","previous_headings":"","what":"Supported International / National Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. \"Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.\" Clinical Microbiology Infection (2012) (doi:10.1111/j.1469-0691.2011.03570.x ) guideline = \"EUCAST3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.2\" European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 \"Intrinsic Resistance Exceptional Phenotypes Tables\" (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization \"Companion handbook guidelines programmatic management drug-resistant tuberculosis\" (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7; doi:10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Rijksinstituut voor Volksgezondheid en Milieu \"WIP-richtlijn BRMO (Bijzonder Resistente Micro-Organismen) (ZKH)\" (link) Please suggest (country-specific) guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"using-custom-guidelines","dir":"Reference","previous_headings":"","what":"Using Custom Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   row/isolate matches first rule, value first ~ (case 'Elderly Type ') set MDRO value. Otherwise, second rule tried . number rules unlimited. can print rules set console overview. Colours help reading console supports colours.   outcome function can used guideline argument mdro() function:   Rules can also combined custom rules using c():   rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(CIP == \"R\" & age > 60 ~ \"Elderly Type A\",                                 ERY == \"R\" & age > 60 ~ \"Elderly Type B\") custom #> A set of custom MDRO rules: #>   1. CIP is \"R\" and age is higher than 60 -> Elderly Type A #>   2. ERY is \"R\" and age is higher than 60 -> Elderly Type B #>   3. Otherwise -> Negative #> #> Unmatched rows will return NA. x <- mdro(example_isolates,           guideline = custom) table(x) #>       Negative Elderly Type A Elderly Type B #>           1070            198            732 x <- mdro(example_isolates,           guideline = c(custom,                         custom_mdro_guideline(ERY == \"R\" & age > 50 ~ \"Elderly Type C\"))) table(x) #>       Negative Elderly Type A Elderly Type B Elderly Type C #>            961            198            732            109"},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"antibiotics","dir":"Reference","previous_headings":"","what":"Antibiotics","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"define antibiotics column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antibiotics eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefetamet (CAT, J01DD10), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), ciprofloxacin (CIP, J01MA02), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), norfloxacin (, J01MA06), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), oleandomycin (OLE, J01FA05), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbactam (SUL, J01CG01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tazobactam (TAZ, J01CG02), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"out <- mdro(example_isolates, guideline = \"EUCAST\") str(out) #>  Ord.factor w/ 3 levels \"Negative\"<\"Positive, unconfirmed\"<..: 1 1 1 1 1 1 1 1 1 1 ... table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1978                     0                     6   out <- mdro(example_isolates,   guideline = custom_mdro_guideline(     AMX == \"R\" ~ \"Custom MDRO 1\",     VAN == \"R\" ~ \"Custom MDRO 2\"   ) ) table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>           870           804           326   # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     mdro() %>%     table()    # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     pull(MDRO) %>%     table() } #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `MDRO = mdro()`. #> Caused by warning: #> ! in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> . #>                         Negative       Multi-drug-resistant (MDR)  #>                             1601                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 sir mean_amr_distance(x, ..., combine_SI = TRUE)  # S3 method for data.frame mean_amr_distance(x, ..., combine_SI = TRUE)  amr_distance_from_row(amr_distance, row)"},{"path":"https://msberends.github.io/AMR/reference/mean_amr_distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"x vector class sir, mic disk, data.frame containing columns classes ... variables select (supports tidyselect language column1:column4 (.mic), can thus also antibiotic selectors combine_SI logical indicate whether values S 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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] R R S I I S I I R I mean_amr_distance(sir) #>  [1]  1.449138  1.449138 -0.621059 -0.621059 -0.621059 -0.621059 -0.621059 #>  [8] -0.621059  1.449138 -0.621059  mic <- random_mic(10) mic #> Class 'mic' #>  [1] 0.002 0.5   0.125 128   0.25  0.5   256   0.125 0.125 64    mean_amr_distance(mic) #>  [1] -1.6429088 -0.1673475 -0.5378223  1.3145519 -0.3525849 -0.1673475 #>  [7]  1.4997893 -0.5378223 -0.5378223  1.1293145 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1] -1.6429088 -0.1673475 -0.5378223  1.3145519 -0.3525849 -0.1673475 #>  [7]  1.4997893 -0.5378223 -0.5378223  1.1293145  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 40 45 43 14 42 40 37 15 42 11 mean_amr_distance(disk) #>  [1]  0.5182957  0.8832927  0.7372939 -1.3796886  0.6642945  0.5182957 #>  [7]  0.2992975 -1.3066892  0.6642945 -1.5986868  y <- data.frame(   id = LETTERS[1:10],   amox = random_sir(10, ab = \"amox\", mo = \"Escherichia coli\"),   cipr = random_disk(10, ab = \"cipr\", mo = \"Escherichia coli\"),   gent = random_mic(10, ab = \"gent\", mo = \"Escherichia coli\"),   tobr = random_mic(10, ab = \"tobr\", mo = \"Escherichia coli\") ) y #>    id amox cipr  gent  tobr #> 1   A    R   17 <=0.5   >=8 #> 2   B    I   26 <=0.5     4 #> 3   C    R   18     4   >=8 #> 4   D    R   22 <=0.5 <=0.5 #> 5   E    I   30 <=0.5     1 #> 6   F    S   18     4     2 #> 7   G    I   26     8     2 #> 8   H    S   29     8     1 #> 9   I    I   22    16     1 #> 10  J    S   31     1     4 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.12957466 -0.14083442  0.55230568 -0.36152662 -0.31478853 -0.33012168 #>  [7]  0.17672648  0.13748045 -0.07163669  0.22282068 y$amr_distance <- mean_amr_distance(y, where(is.mic)) #> Error in .subset(x, j): invalid subscript type 'list' y[order(y$amr_distance), ] #> Error in order(y$amr_distance): argument 1 is not a vector  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   18     4   >=8   0.55230568  0.0000000 #> 2   J    S   31     1     4   0.22282068  0.3294850 #> 3   G    I   26     8     2   0.17672648  0.3755792 #> 4   H    S   29     8     1   0.13748045  0.4148252 #> 5   A    R   17 <=0.5   >=8   0.12957466  0.4227310 #> 6   I    I   22    16     1  -0.07163669  0.6239424 #> 7   B    I   26 <=0.5     4  -0.14083442  0.6931401 #> 8   E    I   30 <=0.5     1  -0.31478853  0.8670942 #> 9   F    S   18     4     2  -0.33012168  0.8824274 #> 10  D    R   22 <=0.5 <=0.5  -0.36152662  0.9138323 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://msberends.github.io/AMR/reference/microorganisms.codes.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 4 957 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://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"tibble 4 957 observations 2 variables: code Commonly used code microorganism. unique identifier. mo ID microorganism microorganisms data set","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 4,957 × 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      #> # ℹ 4,947 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\" #>  #> $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\" #>  #> $gbif #> [1] \"11286021\" #>  #> $group_members #> character(0) #>   # works for all AMR functions: mo_is_intrinsic_resistant(\"eco\", ab = \"vancomycin\") #> [1] TRUE"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"data set containing species groups microbiological complexes, used clinical breakpoints table.","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"tibble 521 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://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups #> # A tibble: 521 × 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_DJKS 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_BCTRD_VLGT Bacteroides fragilis complex    Bacteroides vulg… #> # ℹ 511 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_BCTRD_VLGT Bacteroides fragilis complex Bacteroides vulgatus  #> 5 B_BCTRD_FRGL-C B_PRBCT_DSTS Bacteroides fragilis complex Parabacteroides dist…"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 52 171 Microorganisms — microorganisms","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"data set containing full microbial taxonomy (last updated: January 8th, 2024) five kingdoms List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF). data set backbone AMR package. MO codes can looked using .mo().","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"","code":"microorganisms"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"tibble 52 171 observations 23 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\" \"synonym\" kingdom, phylum, class, order, family, genus, species, subspecies Taxonomic rank microorganism 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. 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. 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 73.4% ~37 000 bacteria data set contain oxygen tolerance. lpsn_parent LPSN identifier parent taxon lpsn_renamed_to LPSN identifier currently valid taxon gbif Identifier ('taxonID') Global Biodiversity Information Facility (GBIF) gbif_parent GBIF identifier parent taxon gbif_renamed_to GBIF identifier currently valid taxon source Either \"GBIF\", \"LPSN\", \"manually added\" (see Source) 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 1st, 2021 (see Source). Use mo_snomed() retrieve quickly, see mo_property().","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"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 December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org January 8th, 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 May 12th, 2023. 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://phinvads.cdc.gov 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://msberends.github.io/AMR/reference/microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"Please note entries based List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (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://msberends.github.io/AMR/reference/microorganisms.html","id":"included-taxa","dir":"Reference","previous_headings":"","what":"Included Taxa","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"Included taxonomic data : ~37 000 (sub)species kingdoms Archaea Bacteria ~7 900 (sub)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). ~5 100 (sub)species kingdom Protozoa ~1 400 (sub)species 43 relevant genera kingdom Animalia (Strongyloides Taenia) ~9 800 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://msberends.github.io/AMR/reference/microorganisms.html","id":"manual-additions","dir":"Reference","previous_headings":"","what":"Manual additions","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"convenience, entries added manually: ~1 500 entries Salmonella, city-like serovars groups H 36 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 : https://github.com/msberends/AMR/blob/main/data-raw/reproduction_of_microorganisms.R.","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"direct-download","dir":"Reference","previous_headings":"","what":"Direct download","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"about-the-records-from-lpsn-see-source-","dir":"Reference","previous_headings":"","what":"About the Records from LPSN (see Source)","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"LPSN main source bacteriological taxonomy AMR package. List Prokaryotic names Standing Nomenclature (LPSN) provides comprehensive information nomenclature prokaryotes. LPSN free use service founded Jean P. Euzeby 1997 later maintained Aidan C. Parte.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"","code":"microorganisms #> # A tibble: 52,171 × 23 #>    mo               fullname      status kingdom phylum class order family genus #>    <mo>             <chr>         <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> #>  1 B_GRAMN          (unknown Gra… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  2 B_GRAMP          (unknown Gra… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  3 B_ANAER-NEG      (unknown ana… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  4 B_ANAER-POS      (unknown ana… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  5 B_ANAER          (unknown ana… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  6 F_FUNGUS         (unknown fun… accep… Fungi   (unkn… (unk… (unk… \"(unk… \"(un… #>  7   UNKNOWN        (unknown nam… accep… (unkno… (unkn… (unk… (unk… \"(unk… \"(un… #>  8 F_YEAST          (unknown yea… accep… Fungi   (unkn… (unk… (unk… \"(unk… \"(un… #>  9 B_[FAM]_ABDTBCTR Abditibacter… accep… Bacter… Abdit… Abdi… Abdi… \"Abdi… \"\"    #> 10 B_[ORD]_ABDTBCTR Abditibacter… accep… Bacter… Abdit… Abdi… Abdi… \"\"     \"\"    #> # ℹ 52,161 more rows #> # ℹ 14 more variables: species <chr>, subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 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.","code":""},{"path":"https://msberends.github.io/AMR/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 :  : \\(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, 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.0 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, genus present established list also prevalence = 1.0 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, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Conidiobolus, Contracaecum, Cordylobia, Cryptococcus, Curvularia, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Haloarcula, Halobacterium, Halococcus, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kodamaea, Leishmania, Lichtheimia, Lodderomyces, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Pediculus, Penicillium, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoterranova, Pulex, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saprochaete, Sarcoptes, Scedosporium, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporotrichum, Stachybotrys, Strongyloides, Syngamus, Taenia, Talaromyces, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Verticillium, Wuchereria; 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://msberends.github.io/AMR/reference/mo_matching_score.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/mo_matching_score.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"Dr. Matthijs Berends, 2018","code":""},{"path":"https://msberends.github.io/AMR/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. #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterobacter cowanii (0.600), Eubacterium combesii #>               (0.600), Eggerthia catenaformis (0.591), Eubacterium callanderi #>               (0.591), Enterocloster citroniae (0.587), Eubacterium cylindroides #>               (0.583), Enterococcus casseliflavus (0.577), Enterobacter cloacae #>               cloacae (0.571), Enterobacter cloacae complex (0.571), and Ehrlichia #>               canis (0.567) #>  #> 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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_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://msberends.github.io/AMR/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\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\", must \"shortname\"","code":""},{"path":"https://msberends.github.io/AMR/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() named character case mo_url() character cases","code":""},{"path":"https://msberends.github.io/AMR/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) mo_ref(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Hormaeche et al., 1960\" (warning) 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 fungi phylum Ascomycota, class Saccharomycetes (also called Hemiascomycetes). True yeasts aggregated underlying order Saccharomycetales. Thus, microorganisms member taxonomic class Saccharomycetes, 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 Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021). mo_is_intrinsic_resistant() function can vectorised argument x (input microorganisms) ab (input antibiotics). 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. SNOMED codes (mo_snomed()) version July 1st, 2021. 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 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 Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571 Berends MS et al. (2022). Trends Occurrence Phenotypic Resistance Coagulase-Negative Staphylococci (CoNS) Found Human Blood Northern Netherlands 2013 2019/ Micro.rganisms 10(9), 1801; doi:10.3390/microorganisms10091801 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 December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org January 8th, 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 May 12th, 2023. 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://phinvads.cdc.gov Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://msberends.github.io/AMR/reference/mo_property.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Get Properties of a Microorganism — mo_property","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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(\"Streptococcus group A\") #> [1] \"Streptococcus pyogenes\" mo_group_members(c(\"Streptococcus group C\",                    \"Streptococcus group G\",                    \"Streptococcus group L\")) #> $`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_lpsn(\"Klebsiella aerogenes\") #> [1] \"777146\" mo_gbif(\"Klebsiella aerogenes\") #> [1] \"9281703\" mo_synonyms(\"Klebsiella aerogenes\") #>   Hormaeche et al., 1960     Bascomb et al., 1971  #> \"Enterobacter aerogenes\"     \"Klebsiella mobilis\"    # 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: 20 × 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          8 #>  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 Lactobacillus        1 #> 19 Leuconostoc          1 #> 20 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\" #>  #> $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] \"aerobe\" #>  #> $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\" #>  #> $gbif #> [1] \"3221874\" #>  #> $group_members #> character(0) #>  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 \"home//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(\"home/me/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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)   # new ggplot2 plotting method using this package:   if (require(\"ggplot2\")) {     ggplot_pca(pca_result)      ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"Title here\")   } } #> 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\"` and `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://msberends.github.io/AMR/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Plotting for Classes sir, mic and disk — plot","title":"Plotting for Classes sir, mic and disk — 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://msberends.github.io/AMR/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plotting for Classes sir, mic and disk — plot","text":"","code":"scale_x_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  scale_y_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  scale_colour_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  scale_fill_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  # S3 method for mic plot(   x,   mo = NULL,   ab = NULL,   guideline = \"EUCAST\",   main = deparse(substitute(x)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for mic autoplot(   object,   mo = NULL,   ab = NULL,   guideline = \"EUCAST\",   title = deparse(substitute(object)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for mic fortify(object, ...)  # S3 method for 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 = \"EUCAST\",   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for 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 = \"EUCAST\",   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for disk fortify(object, ...)  # S3 method for 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 sir autoplot(   object,   title = deparse(substitute(object)),   xlab = translate_AMR(\"Antimicrobial Interpretation\", language = language),   ylab = translate_AMR(\"Frequency\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   ... )  # S3 method for sir fortify(object, ...)"},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plotting for Classes sir, mic and disk — 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 limit MIC values, e.g., mic_range = c(0.001, 32). Use NA set limit one side, e.g., mic_range = c(NA, 32). drop logical remove intermediate MIC values, defaults FALSE ... arguments passed methods 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 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 language = \"\" prevent translation. 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\".","code":""},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Plotting for Classes sir, mic and disk — plot","text":"autoplot() functions return ggplot model extendible ggplot2 function. fortify() functions return data.frame extension usage ggplot2::ggplot() function.","code":""},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Plotting for Classes sir, mic and disk — plot","text":"interpretation \"\" named \"Increased exposure\" EUCAST guidelines since 2019, named \"Intermediate\" cases. interpreting MIC values well disk diffusion diameters, supported guidelines used input guideline argument : \"EUCAST 2023\", \"EUCAST 2022\", \"EUCAST 2021\", \"EUCAST 2020\", \"EUCAST 2019\", \"EUCAST 2018\", \"EUCAST 2017\", \"EUCAST 2016\", \"EUCAST 2015\", \"EUCAST 2014\", \"EUCAST 2013\", \"EUCAST 2012\", \"EUCAST 2011\", \"CLSI 2023\", \"CLSI 2022\", \"CLSI 2021\", \"CLSI 2020\", \"CLSI 2019\", \"CLSI 2018\", \"CLSI 2017\", \"CLSI 2016\", \"CLSI 2015\", \"CLSI 2014\", \"CLSI 2013\", \"CLSI 2012\", \"CLSI 2011\". Simply using \"CLSI\" \"EUCAST\" input automatically select latest version guideline.","code":""},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plotting for Classes sir, mic and disk — 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))  plot(some_mic_values)  plot(some_disk_values)  plot(some_sir_values)   # when providing the microorganism and antibiotic, colours will show interpretations: plot(some_mic_values, mo = \"S. aureus\", ab = \"ampicillin\")  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\")  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\", language = \"nl\")    # Plotting using scale_x_mic() # \\donttest{ if (require(\"ggplot2\")) {   mic_plot <- ggplot(data.frame(mics = as.mic(c(0.125, \"<=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, 128)) +     labs(title = \"with scale_x_mic() using a manual range\") }   if (require(\"ggplot2\")) {   autoplot(some_mic_values) }  if (require(\"ggplot2\")) {   autoplot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\") }  if (require(\"ggplot2\")) {   autoplot(some_sir_values) }  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics, see section Combination Therapy ab_result antibiotic results test , must one values \"S\", \"\", \"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 antibiotics 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 must merged one, output consists S+vs. R (susceptible vs. resistant) - default TRUE","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/proportion.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate Antimicrobial Resistance — proportion","text":"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://msberends.github.io/AMR/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 antibiotics/variables test . See example two antibiotics, 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   include as  include as   include as  include as                     numerator   denominator  numerator   denominator --------  --------  ----------  -----------  ----------  -----------  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://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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) #> Note that proportion_SI() will also include dose-dependent #> susceptibility, 'SDD'. This note will be shown once for this session. #> [1] 0.4044444 proportion_I(example_isolates$AMX) #> Note that proportion_I() will also include dose-dependent susceptibility, #> 'SDD'. This note will be shown once for this session. #> [1] 0.002222222 proportion_IR(example_isolates$AMX) #> Note that proportion_IR() will also include dose-dependent #> susceptibility, 'SDD'. This note will be shown once for this session. #> [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 antibiotic 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: 18 × 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   AMX        NA             0     0      0.00436        0 #>  4 Clinical   CIP        SI             0.853 0.827  0.876        741 #>  5 Clinical   CIP        R              0.147 0.124  0.173        128 #>  6 Clinical   CIP        NA             0     0      0.00424        0 #>  7 ICU        AMX        SI             0.369 0.323  0.417        158 #>  8 ICU        AMX        R              0.631 0.583  0.677        270 #>  9 ICU        AMX        NA             0     0      0.00858        0 #> 10 ICU        CIP        SI             0.810 0.770  0.845        362 #> 11 ICU        CIP        R              0.190 0.155  0.230         85 #> 12 ICU        CIP        NA             0     0      0.00822        0 #> 13 Outpatient AMX        SI             0.397 0.288  0.515         31 #> 14 Outpatient AMX        R              0.603 0.485  0.712         47 #> 15 Outpatient AMX        NA             0     0      0.0462         0 #> 16 Outpatient CIP        SI             0.839 0.748  0.907         78 #> 17 Outpatient CIP        R              0.161 0.0932 0.252         15 #> 18 Outpatient CIP        NA             0     0      0.0389         0 # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/random.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(size = NULL, mo = NULL, ab = NULL, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, ...)  random_sir(size = NULL, prob_SIR = c(0.33, 0.33, 0.33), ...)"},{"path":"https://msberends.github.io/AMR/reference/random.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"size desired size returned vector. used data.frame call dplyr verb, get current (group) size left blank. mo character can coerced valid microorganism code .mo() ab character can coerced valid antimicrobial drug code .ab() ... ignored, place allow future extensions prob_SIR vector length 3: probabilities \"S\" (1st value), \"\" (2nd value) \"R\" (3rd value)","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/random.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"base R function sample() used generating values. Generated values based EUCAST 2023 guideline implemented clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument.","code":""},{"path":"https://msberends.github.io/AMR/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] 16     64     256    0.002  1      0.001  64     0.25   1      16     #> [11] 0.5    8      8      0.0625 1      0.5    0.025  256    256    1      #> [21] 0.01   1      64     32     4      random_disk(25) #> Class 'disk' #>  [1] 49 47 14 33 49 43 41 41 43 31 20 43 42 11 18 42  8 42 16 25 42  8 15 30 29 random_sir(25) #> Class 'sir' #>  [1] I S S I S I I S R S S I I S S I I S I R S S R I S  # \\donttest{ # make the random generation more realistic by setting a bug and/or drug: random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 64     0.025  2      0.25   32     64     0.002  32     0.01   0.001  #> [11] 0.25   0.125  0.0625 64     128    0.002  128    128    1      0.002  #> [21] 1      0.005  0.001  4      0.001  random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] 1    2    1    >=16 8    1    >=16 >=16 2    1    2    1    1    8    4    #> [16] 1    1    4    2    >=16 >=16 2    4    2    1    random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] 2     0.25  >=8   >=8   0.5   1     1     0.125 0.25  1     2     1     #> [13] 0.25  >=8   0.25  2     1     1     >=8   0.125 0.5   >=8   0.125 0.25  #> [25] 0.25   random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 45 49 24 46 23 18 15 17 17 28 40 20 21 43 39  9 33 17  8 20 30 21 44 48 41 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 13 15 11 14 16 16 11 15 11 17 14 15 17 17 16 16 16 12 14 12 15 13 13 13 16 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 22 23 19 19 23 15 23 18 21 24 22 25 19 19 16 17 17 16 27 21 27 25 15 21 27 # }"},{"path":"https://msberends.github.io/AMR/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 statistical solid ground. Standard errors (SE) returned columns se_min se_max. See Examples real live example.","code":""},{"path":"https://msberends.github.io/AMR/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 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 resistance_predict autoplot(   object,   main = paste(\"Resistance Prediction of\", x_name),   ribbon = TRUE,   ... )"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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\" ) plot(x)  # \\donttest{ if (require(\"ggplot2\")) {   ggplot_sir_predict(x) }   # using dplyr: if (require(\"dplyr\")) {   x <- example_isolates %>%     filter_first_isolate() %>%     filter(mo_genus(mo) == \"Staphylococcus\") %>%     resistance_predict(\"PEN\", model = \"binomial\")   print(plot(x))    # get the model from the object   mymodel <- attributes(x)$model   summary(mymodel) }  #> NULL #>  #> Call: #> glm(formula = df_matrix ~ year, family = binomial) #>  #> Coefficients: #>             Estimate Std. Error z value Pr(>|z|) #> (Intercept) 27.05312   72.24652   0.374    0.708 #> year        -0.01286    0.03601  -0.357    0.721 #>  #> (Dispersion parameter for binomial family taken to be 1) #>  #>     Null deviance: 5.7883  on 11  degrees of freedom #> Residual deviance: 5.6608  on 10  degrees of freedom #> AIC: 50.745 #>  #> Number of Fisher Scoring iterations: 4 #>   # create nice plots with ggplot2 yourself if (require(\"dplyr\") && require(\"ggplot2\")) {   data <- example_isolates %>%     filter(mo == as.mo(\"E. coli\")) %>%     resistance_predict(       col_ab = \"AMX\",       col_date = \"date\",       model = \"binomial\",       info = FALSE,       minimum = 15     )   head(data)   autoplot(data) }  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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)  # S3 method for default skewness(x, na.rm = FALSE)  # S3 method for matrix skewness(x, na.rm = FALSE)  # S3 method for data.frame skewness(x, na.rm = FALSE)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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.03310027"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/translate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate Strings from the AMR Package — translate","text":"language language choose. Use one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). x text translate","code":""},{"path":"https://msberends.github.io/AMR/reference/translate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate Strings from the AMR Package — translate","text":"currently 20 supported languages English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). languages translations available antimicrobial drugs colloquial microorganism names. permanently silence -per-session language note non-English operating system, can set package option AMR_locale .Rprofile file like :   save file. Please read adding updating language Wiki.","code":"# Open .Rprofile file utils::file.edit(\"~/.Rprofile\")  # Then add e.g. Italian support to that file using: options(AMR_locale = \"Italian\")"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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\") #> ℹ More than one result was found for item 1: amoxicillin and clavulansäure #> [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://msberends.github.io/AMR/news/index.html","id":"amr-2119031","dir":"Changelog","previous_headings":"","what":"AMR 2.1.1.9031","title":"AMR 2.1.1.9031","text":"(beta version eventually become v3.0. ’re happy reach new major milestone soon, new One Health support!)","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"a-new-milestone-one-health-support--human--veterinary--environmental-2-1-1-9031","dir":"Changelog","previous_headings":"","what":"A New Milestone: One Health Support (= Human + Veterinary + Environmental)","title":"AMR 2.1.1.9031","text":"package now supports tools AMR data analysis clinical settings, also veterinary environmental microbiology. made possible collaboration University Prince Edward Island, Canada. celebrate great improvement package, also updated package logo reflect change.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"breaking-2-1-1-9031","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 2.1.1.9031","text":"Removed functions references used deprecated rsi class, replaced sir equivalents year ago","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"new-2-1-1-9031","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 2.1.1.9031","text":"Function .sir() now extensive support animal breakpoints CLSI. Use breakpoint_type = \"animal\" set host argument variable contains animal species names. clinical_breakpoints data set contains breakpoints, can downloaded download page. antibiotics data set contains veterinary antibiotics, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antibiotics (start “Q”) ab_url() now supports retrieving WHOCC url ATCvet pages .sir() now returns additional factor levels “N” non-interpretable “SDD” susceptible dose-dependent. Users can now set criteria (using regular expressions) considered S, , R, SDD, N. function group scale_*_mic(), namely: scale_x_mic(), scale_y_mic(), scale_colour_mic() scale_fill_mic(). advanced ggplot2 extensions allow easy plotting MIC values. allow manual range definition plotting missing intermediate log2 levels. Function limit_mic_range(), allows limit MIC values manually set range. powerhouse behind scale_*_mic() functions, can used users directly e.g. compare equality MIC distributions rescaling range first. Function mo_group_members() retrieve member microorganisms. example, mo_group_members(\"Strep group C\") returns vector microorganisms group.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"changed-2-1-1-9031","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 2.1.1.9031","text":"Added valid levels: 4096, 6 powers 0.0625, 5 powers 192 (192, 384, 576, 768, 960) Added new argument keep_operators .mic(). can \"\" (default), \"none\", \"edges\". argument also available new limit_mic_range() 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. Updated italicise_taxonomy() support HTML output mo_info() now contains extra element group_members, contents new mo_group_members() function 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. Updated ATC codes WHOCC Updated antibiotic DDDs WHOCC Fix using manual value mo_transform antibiogram() Fix mapping ‘high level’ antibiotics .ab() (amphotericin B-high, gentamicin-high, kanamycin-high, streptomycin-high, tobramycin-high) Improved overall algorithm .ab() better performance accuracy","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"other-2-1-1-9031","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 2.1.1.9031","text":"Added Jordan Stull, Matthew Saab, Javier Sanchez contributors, thank valuable input","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"amr-211","dir":"Changelog","previous_headings":"","what":"AMR 2.1.1","title":"AMR 2.1.1","text":"CRAN release: 2023-10-21 included many isolates patients altering antibiograms within bacterial species See info issue #122 Added 1,366 LOINC codes antibiotics data set updated latest version (LOINC v2.76) MICs can now used complex number calculations allow scientific number format input (e.g., .mic(\"1.28e-2\")) Fix rounding MICs latest R beta (‘R-devel’) Removed unneeded note used language option AMR_locale set Fixed non-ASCII characters documentation, according CRAN maintainers","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"amr-210","dir":"Changelog","previous_headings":"","what":"AMR 2.1.0","title":"AMR 2.1.0","text":"CRAN release: 2023-07-16","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"new-2-1-0","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 2.1.0","text":"Clinical breakpoints intrinsic resistance EUCAST 2023 CLSI 2023 added clinical_breakpoints data set usage .sir(). EUCAST 2023 (v13.0) now new default guideline MIC disks diffusion interpretations EUCAST dosage guideline v13.0 added dosage data set clinical_breakpoints data set now also contains epidemiological cut-(ECOFF) values CLSI animal breakpoints. two new breakpoint types can used MIC/disk interpretation using .sir(..., breakpoint_type = \"ECOFF\") oras.sir(..., breakpoint_type = \"animal\"), important new addition veterinary microbiology. Added support 30 species groups / complexes. gathered new data set microorganisms.groups used clinical breakpoint interpretation. example, CLSI 2023 contains breakpoints RGM group (Rapidly Growing Mycobacterium, containing 80 species) now supported package. Added mo_oxygen_tolerance() retrieve values Added mo_is_anaerobic() determine genera/species obligate anaerobic bacteria Added LPSN GBIF identifiers, oxygen tolerance mo_info() Added SAS Transport files (file extension .xpt) download page use SAS software Added microbial codes Gram-negative/positive anaerobic bacteria","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"changed-2-1-0","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 2.1.0","text":"Updated algorithm .mo() giving weight fungi Fixed clinical breakpoints errors introduced source import rules mo_rank() now returns NA ‘unknown’ microorganisms (B_ANAER, B_ANAER-NEG, B_ANAER-POS, B_GRAMN, B_GRAMP, F_FUNGUS, F_YEAST, UNKNOWN) printing microorganism antibiotic codes tibble, mouse-hover now shows full name code Now settable arguments breakpoint type PK/PD, like .sir() now contain name guideline table subtitle plot Fixed formatting sir_interpretation_history() Fixed WHONET codes microorganisms consequently couple entries clinical_breakpoints Fixed bug .mo() led coercion NA values using custom microorganism codes Fixed usage icu_exclude first_isolates() Now allows searching species names Fix using keep_synonyms argument using MO codes input Fix using minimum_matching_score argument Updated code table microorganisms.codes Fixed endless loop using reference_df .mo() Fixed bug indicating UTIs .sir() Greatly improved speed .sir()","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"amr-200","dir":"Changelog","previous_headings":"","what":"AMR 2.0.0","title":"AMR 2.0.0","text":"CRAN release: 2023-03-12 new major release AMR package, great new additions also breaking changes current users. listed . TL;DR functions arguments ‘rsi’ replaced ‘sir’, interpretation MIC values (now .sir() instead .rsi()) - old functions still work now Many new interesting functions, antibiogram() (generating traditional/combined/syndromic/WISCA antibiograms), sir_confidence_interval() mean_amr_distance(), add_custom_microorganisms() add custom microorganisms package Clinical breakpoints added EUCAST 2022 CLSI 2022 Microbiological taxonomy (microorganisms data set) updated 2022 now based LPSN GBIF Much increased algorithms translate user input valid taxonomy, e.g. using recent scientific work per-species human pathogenicity 20 new antibiotics added updated DDDs ATC codes Extended support antiviral agents (antivirals data set), many new functions Now available 20 languages Many small bug fixes","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/news/index.html","id":"sir-vs-rsi-2-0-0","dir":"Changelog","previous_headings":"New","what":"SIR vs. RSI","title":"AMR 2.0.0","text":"milestone version, replaced mentions RSI SIR, comply actually commonly used field clinical microbiology comes tri-form regarding AMR. existing functions .rsi(), rsi_df() ggplot_rsi() still work, replacements .sir(), sir_df(), ggplot_sir() now current functions AMR data analysis. warning thrown session remind users . data set rsi_translation now called clinical_breakpoints better reflect content. ‘RSI functions’ removed future version, late 2023 / early 2024.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"new-antibiogram-function-2-0-0","dir":"Changelog","previous_headings":"New","what":"New antibiogram function","title":"AMR 2.0.0","text":"new antibiogram() function, users can now generate traditional, combined, syndromic, even weighted-incidence syndromic combination antibiograms (WISCA). , follow logic previously described work Klinker et al. (2021, DOI 10.1177/20499361211011373) Barbieri et al. (2021, DOI 10.1186/s13756-021-00939-2). help page antibiogram() extensively elaborates use cases, antibiogram() also supports printing R Markdown Quarto, support 20 languages. Furthermore, different plotting methods implemented allow graphical visualisations well.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"interpretation-of-mic-and-disk-diffusion-values-2-0-0","dir":"Changelog","previous_headings":"New","what":"Interpretation of MIC and disk diffusion values","title":"AMR 2.0.0","text":"clinical breakpoints intrinsic resistance EUCAST 2022 CLSI 2022 added .sir(). EUCAST 2022 (v12.0) now new default guideline MIC disks diffusion interpretations, eucast_rules() apply EUCAST Expert Rules. default guideline (EUCAST) can now changed new AMR_guideline option, : options(AMR_guideline = \"CLSI 2020\"). new arguments include_PKPD (default: TRUE) include_screening (default: FALSE), users can now specify whether breakpoints screening PK/PD table included interpreting MICs disks diffusion values. options can set globally, can read new manual. Interpretation guidelines older 10 years removed, oldest now included guidelines EUCAST CLSI 2013.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"supported-languages-2-0-0","dir":"Changelog","previous_headings":"New","what":"Supported languages","title":"AMR 2.0.0","text":"added support following ten languages: Chinese (simplified), Czech, Finnish, Greek, Japanese, Norwegian (bokmål), Polish, Romanian, Turkish Ukrainian. antibiotic names now available languages, AMR package automatically determine supported language based user’s system language. grateful valuable input colleagues countries. AMR package now available 20 languages total, according download stats used almost countries world!","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"outbreak-management-2-0-0","dir":"Changelog","previous_headings":"New","what":"Outbreak management","title":"AMR 2.0.0","text":"analysis outbreak management, updated get_episode() is_new_episode() functions: now contain argument case_free_days. argument can used quantify duration case-free days (inter-epidemic interval), new episode start. common requirement outbreak management, e.g. determining number norovirus outbreaks hospital. case-free period 14 28 days, new norovirus cases time considered different (new) episode.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"microbiological-taxonomy-2-0-0","dir":"Changelog","previous_headings":"New","what":"Microbiological taxonomy","title":"AMR 2.0.0","text":"microorganisms data set longer relies Catalogue Life, List Prokaryotic names Standing Nomenclature (LPSN) supplemented ‘backbone taxonomy’ Global Biodiversity Information Facility (GBIF). structure data set changed include separate LPSN GBIF identifiers. Almost previous MO codes retained. contains 1,400 taxonomic names 2022. previously relied experience categorise species pathogenic groups, happy encounter recent work Bartlett et al. (2022, DOI 10.1099/mic.0.001269) extensively studied medical-scientific literature categorise bacterial species groups. See mo_matching_score() work incorporated prevalence column microorganisms data set. Using results, .mo() mo_*() functions now much better capable converting user input valid taxonomic records. new function add_custom_microorganisms() allows users add custom microorganisms AMR package. also made following changes regarding included taxonomy microorganisms functions: Updated full microbiological taxonomy according latest daily LPSN data set (December 2022) latest yearly GBIF taxonomy backbone (November 2022) Added function mo_current() get currently valid taxonomic name microorganism Support 1,516 city-like serovars Salmonella, Salmonella Goldcoast. Formally, serovars belonging S. enterica species, reported name genus city. reason, serovars subspecies column microorganisms data set “enterica” species column, full name contain species name (enterica). new argument keep_synonyms allows correct updated taxonomy, favour now deleted argument allow_uncertain increased tremendously speed returns generally consequent results Sequential coercion now extremely fast results stored package environment, although coercion unknown values must run per session. Previous results can reset/removed new mo_reset_session() function. Support microorganism codes ASIan Antimicrobial Resistance Surveillance Network (ASIARS-Net) MO matching score algorithm (mo_matching_score()) now counts deletions substitutions 2 instead 1, impacts outcome .mo() mo_*() function CRAN allows packages around 5 MB maximum, packages exempted package one Chromista relevant comes antimicrobial resistance, thus lacking primary scope package Chromista almost never clinically relevant, thus lacking secondary scope package microorganisms.old data set removed, previously accepted names now included microorganisms data set. new column status contains \"accepted\" currently accepted names \"synonym\" taxonomic synonyms; currently invalid names. previously accepted names now microorganisms ID - available - LPSN, GBIF SNOMED CT identifier.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"antibiotic-agents-and-selectors-2-0-0","dir":"Changelog","previous_headings":"New","what":"Antibiotic agents and selectors","title":"AMR 2.0.0","text":"new function add_custom_antimicrobials() allows users add custom antimicrobial codes names AMR package. antibiotics data set greatly updated: following 20 antibiotics added (also includes new J01RA ATC group): azithromycin/fluconazole/secnidazole (AFC), cefepime/amikacin (CFA), cefixime/ornidazole (CEO), ceftriaxone/beta-lactamase inhibitor (CEB), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), furazidin (FUR), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), lascufloxacin (LSC), levofloxacin/ornidazole (LEO), nemonoxacin (NEM), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin/ornidazole (OOR), oteseconazole (OTE), rifampicin/ethambutol/isoniazid (REI), sarecycline (SRC), tetracycline/oleandomycin (TOL), thioacetazone (TAT) Added missing ATC codes Updated DDDs PubChem Compound IDs Updated antibiotic name spelling, now used WHOCC (cephalexin -> cefalexin, phenethicillin -> pheneticillin) Antibiotic code “CEI” ceftolozane/tazobactam replaced “CZT” comply EARS-Net WHONET 2022. old code still work cases using .ab() ab_*() functions. Support antimicrobial interpretation anaerobic bacteria, adding ‘placeholder’ code B_ANAER microorganisms data set adding breakpoints anaerobics clinical_breakpoints data set, used .sir() interpretion MIC disk diffusion values Also, added support using antibiotic selectors scoped dplyr verbs (without using vars()), : ... %>% summarise_at(aminoglycosides(), resistance), please see resistance() examples.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"antiviral-agents-2-0-0","dir":"Changelog","previous_headings":"New","what":"Antiviral agents","title":"AMR 2.0.0","text":"now added extensive support antiviral agents! first time, AMR package extensive support antiviral drugs work names, codes data way. antivirals data set extended 18 new drugs (also new J05AJ ATC group) now also contains antiviral identifiers LOINC codes new data type av (antivirals) added, functionally similar ab antibiotics Functions .av(), av_name(), av_atc(), av_synonyms(), av_from_text() added siblings ab_*() equivalents","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"other-new-functions-2-0-0","dir":"Changelog","previous_headings":"New","what":"Other new functions","title":"AMR 2.0.0","text":"Function sir_confidence_interval() add confidence intervals AMR calculation. now also included sir_df() proportion_df(). Function mean_amr_distance() calculate mean AMR distance. mean AMR distance normalised numeric value compare AMR test results can help identify similar isolates, without comparing antibiograms hand. Function sir_interpretation_history() view history previous runs .sir() (previously .rsi()). returns ‘logbook’ selected guideline, reference table specific interpretation row data set .sir() run.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"changes-2-0-0","dir":"Changelog","previous_headings":"","what":"Changes","title":"AMR 2.0.0","text":"Fix working NA values Fix unsorted dates length 2 Now returns class integer instead numeric since always whole numbers Argument combine_IR removed package (affecting functions count_df(), proportion_df(), sir_df() plotting functions), since replaced combine_SI three years ago Using units ab_ddd(..., units = \"...\") deprecated time now supported anymore. Use ab_ddd_units() instead. Support data.frame-enhancing R packages, specifically: data.table::data.table, janitor::tabyl, tibble::tibble, tsibble::tsibble. AMR package functions data set output (sir_df() bug_drug_combinations()), now return data type input. data sets package now tibble, instead base R data.frames. Older R versions still supported, even support tibbles. data sets now also continually exported Apache Feather Apache Parquet formats. can find info article website. Fixed certain EUCAST breakpoints MIC values Allow NA values (e.g. .sir(.disk(NA), ...)) Fix bug-drug combinations multiple breakpoints different body sites Interpretation MIC disk zones now informative availability breakpoints robust Removed .integer() method MIC values, since MIC integer values running table() MIC values consequently failed able retrieve level position (’s normally .integer() factors work) Fixed determination Gram stains (mo_gramstain()), since taxonomic phyla Actinobacteria, Chloroflexi, Firmicutes, Tenericutes renamed respectively Actinomycetota, Chloroflexota, Bacillota, Mycoplasmatota 2021 droplevels() MIC now return common factor default lose mic class. Use droplevels(..., .mic = TRUE) keep mic class. Small fix using ab_from_text() Fixes reading text files using set_mo_source(), now also allows source file contain valid taxonomic names instead valid microorganism ID package Fixed bug mdro() using similar column names Magiorakos guideline Using random_*() function (random_mic()) now possible directly calling package without loading first: AMR::random_mic(10) Extended support vctrs package, used internally tidyverse. allows change values class mic, disk, sir, mo ab tibbles, use antibiotic selectors selecting/filtering, e.g. df[carbapenems() == \"R\", ] Fix using info = FALSE mdro() interpretation guidelines using .sir() amoxicillin, rules ampicillin used amoxicillin rules available Fix using ab_atc() non-existing ATC codes Black white message texts now reversed colour using RStudio dark theme mo_snomed() now returns class character, numeric anymore (make long SNOMED codes readable) Fix using .ab() NA values Updated support WHONET 2022 microorganism codes Antimicrobial interpretation ‘SDD’ (susceptible dose-dependent, coined CLSI) interpreted ‘’ comply EUCAST’s ‘’ .sir() Fix mo_shortname() case higher taxonomic ranks (order, class, phylum) Cleaning columns .sir(), .mic(), .disk() now show column name warning invalid results Fix using g.test() zeroes 2x2 table mo_synonyns() now contains scientific reference names","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"other-2-0-0","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 2.0.0","text":"Added Peter Dutey-Magni, Dmytro Mykhailenko, Anton Mymrikov, Andrew Norgan, Jonas Salm, Anita Williams contributors, thank valuable input New website make use new Bootstrap 5 pkgdown 2.0. website now contains results examples automatically regenerated every change repository, using GitHub Actions R Rmd files project now styled using styler package Set scalar conditional expressions (&& ||) possible comply upcoming R 4.3 enormous lot code cleaning, fixing small bugs along way changelog contains changes AMR v2.0 (January 2023) later. prior versions, please see archive.","code":""}]
+[{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to conduct AMR data analysis","text":"Conducting AMR data analysis unfortunately requires -depth knowledge different scientific fields, makes hard right. least, requires: Good questions (always start !) reliable data thorough understanding (clinical) epidemiology, understand clinical epidemiological relevance possible bias results thorough understanding (clinical) microbiology/infectious diseases, understand microorganisms causal infections implications pharmaceutical treatment, well understanding intrinsic acquired microbial resistance Experience data analysis microbiological tests results, understand determination limitations MIC values interpretations SIR values Availability biological taxonomy microorganisms probably normalisation factors pharmaceuticals, defined daily doses (DDD) Available (inter-)national guidelines, profound methods apply course, instantly provide knowledge experience. AMR package, aimed providing (1) tools simplify antimicrobial resistance data cleaning, transformation analysis, (2) methods easily incorporate international guidelines (3) scientifically reliable reference data, including requirements mentioned . AMR package enables standardised reproducible AMR data analysis, application evidence-based rules, determination first isolates, translation various codes microorganisms antimicrobial agents, determination (multi-drug) resistant microorganisms, calculation antimicrobial resistance, prevalence future trends.","code":""},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to conduct AMR data analysis","text":"tutorial, create fake demonstration data work . can skip Cleaning data already data ready. start analysis, try make structure data generally look like :","code":""},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"needed-r-packages","dir":"Articles","previous_headings":"Preparation","what":"Needed R packages","title":"How to conduct AMR data analysis","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2 RStudio. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. also use cleaner package, can used cleaning data creating frequency tables. AMR package contains data set example_isolates_unclean, might look data users extracted laboratory systems: AMR data analysis, like microorganism column contain valid, --date taxonomy, antibiotic columns cleaned SIR values well.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"dplyr\", \"ggplot2\", \"AMR\")) example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows # we will use 'our_data' as the data set name for this tutorial our_data <- example_isolates_unclean"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"taxonomy-of-microorganisms","dir":"Articles","previous_headings":"Preparation","what":"Taxonomy of microorganisms","title":"How to conduct AMR data analysis","text":".mo(), users can transform arbitrary microorganism names codes current taxonomy. AMR package contains --date taxonomic data. specific, currently included data retrieved 11 Dec 2022. 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) #> ℹ 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. #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterobacter cowanii (0.600), Eubacterium combesii #>               (0.600), Eggerthia catenaformis (0.591), Eubacterium callanderi #>               (0.591), Enterocloster citroniae (0.587), Eubacterium cylindroides #>               (0.583), Enterococcus casseliflavus (0.577), Enterobacter cloacae #>               cloacae (0.571), Enterobacter cloacae complex (0.571), and Ehrlichia #>               canis (0.567) #> -------------------------------------------------------------------------------- #> \"K. pneumoniae\" -> Klebsiella pneumoniae (B_KLBSL_PNMN, 0.786) #> Also matched: 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), Kosakonia pseudosacchari (0.361), Kaistella #>               palustris (0.333), Kocuria palustris (0.333), and Kocuria pelophila #>               (0.333) #> -------------------------------------------------------------------------------- #> \"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), Salmonella #>               Aurelianis (0.595), Salmonella Aarhus (0.588), Salmonella Amounderness #>               (0.587), Selenomonas artemidis (0.571), Salmonella choleraesuis #>               arizonae (0.562), Streptococcus anginosus anginosus (0.561), and #>               Salmonella Abaetetuba (0.548) #> -------------------------------------------------------------------------------- #> \"S. pneumoniae\" -> Streptococcus pneumoniae (B_STRPT_PNMN, 0.750) #> Also matched: Streptococcus pseudopneumoniae (0.700), Serratia #>               proteamaculans quinovora (0.545), Streptococcus pseudoporcinus (0.536), #>               Staphylococcus pseudintermedius (0.532), Serratia proteamaculans #>               proteamaculans (0.526), Salmonella Portanigra (0.524), Sphingomonas #>               paucimobilis (0.520), Streptococcus pluranimalium (0.519), #>               Streptococcus constellatus pharyngis (0.514), and Salmonella Pakistan #>               (0.500) #>  #> 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://msberends.github.io/AMR/articles/AMR.html","id":"antibiotic-results","dir":"Articles","previous_headings":"Preparation","what":"Antibiotic results","title":"How to conduct AMR data analysis","text":"column antibiotic test results must also cleaned. AMR package comes three new data types work test results: mic minimal inhibitory concentrations (MIC), disk disk diffusion diameters, sir SIR data interpreted already. package can also determine SIR values based MIC disk diffusion values, read .sir() page. now, just clean SIR columns data using dplyr: basically cleaning, time start data inclusion.","code":"# method 1, be explicit about the columns: our_data <- our_data %>%   mutate_at(vars(AMX:GEN), as.sir)  # method 2, let the AMR package determine the eligible columns our_data <- our_data %>%   mutate_if(is_sir_eligible, as.sir)  # result: our_data #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> #>  1 J3         A        2012-11-21 B_ESCHR_COLI R     I     S     S     #>  2 R7         A        2018-04-03 B_KLBSL_PNMN R     I     S     S     #>  3 P3         A        2014-09-19 B_ESCHR_COLI R     S     S     S     #>  4 P10        A        2015-12-10 B_ESCHR_COLI S     I     S     S     #>  5 B7         A        2015-03-02 B_ESCHR_COLI S     S     S     S     #>  6 W3         A        2018-03-31 B_STPHY_AURS R     S     R     S     #>  7 J8         A        2016-06-14 B_ESCHR_COLI R     S     S     S     #>  8 M3         A        2015-10-25 B_ESCHR_COLI R     S     S     S     #>  9 J3         A        2019-06-19 B_ESCHR_COLI S     S     S     S     #> 10 G6         A        2015-04-27 B_STPHY_AURS S     S     S     S     #> # ℹ 2,990 more rows"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"first-isolates","dir":"Articles","previous_headings":"Preparation","what":"First isolates","title":"How to conduct AMR data analysis","text":"need know isolates can actually use analysis without repetition bias. conduct analysis antimicrobial resistance, must include first isolate every patient per episode (Hindler et al., Clin Infect Dis. 2007). , easily get overestimate underestimate resistance antibiotic. Imagine patient admitted MRSA found 5 different blood cultures following weeks (yes, countries like Netherlands blood drawing policies). resistance percentage oxacillin isolates overestimated, included MRSA . clearly selection bias. Clinical Laboratory Standards Institute (CLSI) appoints follows: (…) preparing cumulative antibiogram guide clinical decisions empirical antimicrobial therapy initial infections, first isolate given species per patient, per analysis period (eg, one year) included, irrespective body site, antimicrobial susceptibility profile, phenotypical characteristics (eg, biotype). first isolate easily identified, cumulative antimicrobial susceptibility test data prepared using first isolate generally comparable cumulative antimicrobial susceptibility test data calculated methods, providing duplicate isolates excluded. M39-A4 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 4th Edition. CLSI, 2014. Chapter 6.4 AMR package includes methodology first_isolate() function able apply four different methods defined Hindler et al. 2007: phenotype-based, episode-based, patient-based, isolate-based. right method depends goals analysis, default phenotype-based method case method properly correct duplicate isolates. Read methods first_isolate() page. outcome function can easily added data: 90% suitable resistance analysis! can now filter filter() function, also dplyr package: future use, two syntaxes can shortened: end 2 712 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,712 'phenotype-based' first isolates (90.4% 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,712 × 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 P10        A        2015-12-10 B_ESCHR_COLI S     I     S     S     TRUE  #>  4 B7         A        2015-03-02 B_ESCHR_COLI S     S     S     S     TRUE  #>  5 W3         A        2018-03-31 B_STPHY_AURS R     S     R     S     TRUE  #>  6 M3         A        2015-10-25 B_ESCHR_COLI R     S     S     S     TRUE  #>  7 J3         A        2019-06-19 B_ESCHR_COLI S     S     S     S     TRUE  #>  8 G6         A        2015-04-27 B_STPHY_AURS S     S     S     S     TRUE  #>  9 P4         A        2011-06-21 B_ESCHR_COLI S     S     S     S     TRUE  #> 10 Z1         A        2014-09-05 B_ESCHR_COLI S     S     S     S     TRUE  #> # ℹ 2,702 more rows"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"analysing-the-data","dir":"Articles","previous_headings":"","what":"Analysing the data","title":"How to conduct AMR data analysis","text":"base R summary() function gives good first impression, comes support new mo sir classes now data set:","code":"summary(our_data_1st) #>   patient_id          hospital              date            #>  Length:2712        Length:2712        Min.   :2011-01-01   #>  Class :character   Class :character   1st Qu.:2013-05-03   #>  Mode  :character   Mode  :character   Median :2015-06-16   #>                                        Mean   :2015-06-21   #>                                        3rd Qu.:2017-08-24   #>                                        Max.   :2019-12-27   #>    bacteria               AMX                    AMC                 #>  Class :mo             Class:sir              Class:sir              #>  <NA>  :0              %R   :42.9% (n=1163)   %R   :36.1% (n=978)    #>  Unique:4              %SI  :57.1% (n=1549)   %SI  :63.9% (n=1734)   #>  #1    :B_ESCHR_COLI   - %S :41.0% (n=1112)   - %S :52.0% (n=1409)   #>  #2    :B_STPHY_AURS   - %I :16.1% (n=437)    - %I :12.0% (n=325)    #>  #3    :B_STRPT_PNMN                                                 #>     CIP                    GEN                  first         #>  Class:sir              Class:sir              Mode:logical   #>  %R   :42.0% (n=1138)   %R   :37.3% (n=1011)   TRUE:2712      #>  %SI  :58.0% (n=1574)   %SI  :62.7% (n=1701)                  #>  - %S :51.5% (n=1396)   - %S :59.6% (n=1616)                  #>  - %I : 6.6% (n=178)    - %I : 3.1% (n=85)                    #> glimpse(our_data_1st) #> Rows: 2,712 #> Columns: 9 #> $ patient_id <chr> \"J3\", \"R7\", \"P10\", \"B7\", \"W3\", \"M3\", \"J3\", \"G6\", \"P4\", \"Z1\"… #> $ hospital   <chr> \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\",… #> $ date       <date> 2012-11-21, 2018-04-03, 2015-12-10, 2015-03-02, 2018-03-31… #> $ bacteria   <mo> \"B_ESCHR_COLI\", \"B_KLBSL_PNMN\", \"B_ESCHR_COLI\", \"B_ESCHR_COL… #> $ AMX        <sir> R, R, S, S, R, R, S, S, S, S, R, S, S, S, R, R, R, R, S, R,… #> $ AMC        <sir> I, I, I, S, S, S, S, S, S, S, S, S, I, S, S, S, S, R, S, S,… #> $ CIP        <sir> S, S, S, S, R, S, 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, R, S, 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       1852          4          3          3          3  #>        GEN      first  #>          3          1"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"availability-of-species","dir":"Articles","previous_headings":"Analysing the data","what":"Availability of species","title":"How to conduct AMR data analysis","text":"just get idea species distributed, create frequency table count() based name microorganisms:","code":"our_data %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1518 #> 2 Staphylococcus aureus      730 #> 3 Streptococcus pneumoniae   426 #> 4 Klebsiella pneumoniae      326 our_data_1st %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1319 #> 2 Staphylococcus aureus      676 #> 3 Streptococcus pneumoniae   400 #> 4 Klebsiella pneumoniae      317"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"select-and-filter-with-antibiotic-selectors","dir":"Articles","previous_headings":"Analysing the data","what":"Select and filter with antibiotic selectors","title":"How to conduct AMR data analysis","text":"Using -called antibiotic class selectors, can select filter columns based antibiotic class antibiotic results :","code":"our_data_1st %>%   select(date, aminoglycosides()) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 2,712 × 2 #>    date       GEN   #>    <date>     <sir> #>  1 2012-11-21 S     #>  2 2018-04-03 S     #>  3 2015-12-10 S     #>  4 2015-03-02 S     #>  5 2018-03-31 S     #>  6 2015-10-25 S     #>  7 2019-06-19 S     #>  8 2015-04-27 S     #>  9 2011-06-21 S     #> 10 2014-09-05 S     #> # ℹ 2,702 more rows our_data_1st %>%   select(bacteria, betalactams()) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 2,712 × 3 #>    bacteria     AMX   AMC   #>    <mo>         <sir> <sir> #>  1 B_ESCHR_COLI R     I     #>  2 B_KLBSL_PNMN R     I     #>  3 B_ESCHR_COLI S     I     #>  4 B_ESCHR_COLI S     S     #>  5 B_STPHY_AURS R     S     #>  6 B_ESCHR_COLI R     S     #>  7 B_ESCHR_COLI S     S     #>  8 B_STPHY_AURS S     S     #>  9 B_ESCHR_COLI S     S     #> 10 B_ESCHR_COLI S     S     #> # ℹ 2,702 more rows our_data_1st %>%   select(bacteria, where(is.sir)) #> # A tibble: 2,712 × 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 S     I     S     S     #>  4 B_ESCHR_COLI S     S     S     S     #>  5 B_STPHY_AURS R     S     R     S     #>  6 B_ESCHR_COLI R     S     S     S     #>  7 B_ESCHR_COLI S     S     S     S     #>  8 B_STPHY_AURS S     S     S     S     #>  9 B_ESCHR_COLI S     S     S     S     #> 10 B_ESCHR_COLI S     S     S     S     #> # ℹ 2,702 more rows # filtering using AB selectors is also possible: our_data_1st %>%   filter(any(aminoglycosides() == \"R\")) #> ℹ For aminoglycosides() using column 'GEN' (gentamicin) #> # A tibble: 1,011 × 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  #> # ℹ 1,001 more rows our_data_1st %>%   filter(all(betalactams() == \"R\")) #> ℹ For betalactams() using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 483 × 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  #> # ℹ 473 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: 483 × 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  #> # ℹ 473 more rows"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"generate-antibiograms","dir":"Articles","previous_headings":"Analysing the data","what":"Generate antibiograms","title":"How to conduct AMR data analysis","text":"Since AMR v2.0 (March 2023), easy create different types antibiograms, support 20 different languages. four antibiogram types, proposed Klinker et al. (2021, DOI 10.1177/20499361211011373), supported new antibiogram() function: Traditional Antibiogram (TA) e.g, susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Combination Antibiogram (CA) e.g, sdditional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Syndromic Antibiogram (SA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Weighted-Incidence Syndromic Combination Antibiogram (WISCA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure section, show use antibiogram() function create antibiogram types. starters, included example_isolates data set looks like:","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"traditional-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Traditional Antibiogram","title":"How to conduct AMR data analysis","text":"create traditional antibiogram, simply state antibiotics used. antibiotics argument antibiogram() function supports (combination) previously mentioned antibiotic class selectors: Notice antibiogram() function automatically prints right format using Quarto R Markdown (page), even applies italics taxonomic names (using italicise_taxonomy() internally). also uses language OS either English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. next example, force language Spanish using language argument:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             mo_transform = \"gramstain\",             antibiotics = aminoglycosides(),             ab_transform = \"name\",             language = \"es\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin)"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"combined-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Combined Antibiogram","title":"How to conduct AMR data analysis","text":"create combined antibiogram, use antibiotic codes names plus + character like :","code":"antibiogram(example_isolates,             antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"syndromic-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Syndromic Antibiogram","title":"How to conduct AMR data analysis","text":"create syndromic antibiogram, syndromic_group argument must used. can column data, e.g. ifelse() calculations based certain columns:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems()),             syndromic_group = \"ward\") #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem)"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"weighted-incidence-syndromic-combination-antibiogram-wisca","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Weighted-Incidence Syndromic Combination Antibiogram (WISCA)","title":"How to conduct AMR data analysis","text":"create WISCA, must state combination therapy antibiotics argument (similar Combination Antibiogram), define syndromic group syndromic_group argument (similar Syndromic Antibiogram) cases predefined based clinical demographic characteristics (e.g., endocarditis 75+ females). next example simplification without clinical characteristics, just gives idea WISCA can created:","code":"wisca <- antibiogram(example_isolates,                      antibiotics = c(\"AMC\", \"AMC+CIP\", \"TZP\", \"TZP+TOB\"),                      mo_transform = \"gramstain\",                      minimum = 10, # this should be >= 30, but now just as example                      syndromic_group = ifelse(example_isolates$age >= 65 &                                                 example_isolates$gender == \"M\",                                               \"WISCA Group 1\", \"WISCA Group 2\")) wisca"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"plotting-antibiograms","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Plotting antibiograms","title":"How to conduct AMR data analysis","text":"Antibiograms can plotted using autoplot() ggplot2 packages, since AMR package provides extension function:  calculate antimicrobial resistance sensible way, also correcting results, use resistance() susceptibility() functions.","code":"autoplot(wisca)"},{"path":"https://msberends.github.io/AMR/articles/AMR.html","id":"resistance-percentages","dir":"Articles","previous_headings":"Analysing the data","what":"Resistance percentages","title":"How to conduct AMR data analysis","text":"functions resistance() susceptibility() can used calculate antimicrobial resistance susceptibility. specific analyses, functions proportion_S(), proportion_SI(), proportion_I(), proportion_IR() proportion_R() can used determine proportion specific antimicrobial outcome. functions contain minimum argument, denoting minimum required number test results returning value. functions otherwise return NA. default minimum = 30, following CLSI M39-A4 guideline applying microbial epidemiology. per EUCAST guideline 2019, calculate resistance proportion R (proportion_R(), equal resistance()) susceptibility proportion S (proportion_SI(), equal susceptibility()). functions can used : can used conjunction group_by() summarise(), dplyr package: Author: Dr. Matthijs Berends, 26th Feb 2023","code":"our_data_1st %>% resistance(AMX) #> [1] 0.4288348 our_data_1st %>%   group_by(hospital) %>%   summarise(amoxicillin = resistance(AMX)) #> # A tibble: 3 × 2 #>   hospital amoxicillin #>   <chr>          <dbl> #> 1 A              0.342 #> 2 B              0.564 #> 3 C              0.372"},{"path":"https://msberends.github.io/AMR/articles/EUCAST.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"How to apply EUCAST rules","text":"EUCAST rules? European Committee Antimicrobial Susceptibility Testing (EUCAST) states website: EUCAST expert rules tabulated collection expert knowledge intrinsic resistances, exceptional resistance phenotypes interpretive rules may applied antimicrobial susceptibility testing order reduce errors make appropriate recommendations reporting particular resistances. Europe, lot medical microbiological laboratories already apply rules (Brown et al., 2015). package features latest insights intrinsic resistance unusual phenotypes (v3.1, 2016). Moreover, eucast_rules() function use purpose can also apply additional rules, like forcing ampicillin = R isolates amoxicillin/clavulanic acid = R.","code":""},{"path":"https://msberends.github.io/AMR/articles/EUCAST.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to apply EUCAST rules","text":"rules can used discard impossible 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 ampicillin susceptible ampicillin. antibiogram available identification available, antibiogram re-interpreted based identification (namely, Klebsiella). EUCAST expert rules solve , can applied using eucast_rules(): convenient function mo_is_intrinsic_resistant() uses guideline, allows check one specific microorganisms antibiotics: EUCAST rules can used correction, can also used filling known resistance susceptibility based results antimicrobials drugs. process called interpretive reading, basically form imputation, part eucast_rules() function well:","code":"oops <- data.frame(   mo = c(     \"Klebsiella\",     \"Escherichia\"   ),   ampicillin = \"S\" ) oops #>            mo ampicillin #> 1  Klebsiella          S #> 2 Escherichia          S eucast_rules(oops, info = FALSE) #>            mo ampicillin #> 1  Klebsiella          R #> 2 Escherichia          S mo_is_intrinsic_resistant(   c(\"Klebsiella\", \"Escherichia\"),   \"ampicillin\" ) #> [1]  TRUE FALSE mo_is_intrinsic_resistant(   \"Klebsiella\",   c(\"ampicillin\", \"kanamycin\") ) #> [1]  TRUE FALSE data <- 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\", # Benzylenicillin   FOX = \"S\", # Cefoxitin   stringsAsFactors = FALSE ) data eucast_rules(data)"},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"type-of-input","dir":"Articles","previous_headings":"","what":"Type of input","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function takes data set input, regular data.frame. tries automatically determine right columns info isolates, name species columns results antimicrobial agents. See help page info set right settings data command ?mdro. WHONET data (data), settings automatically set correctly.","code":""},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"guidelines","dir":"Articles","previous_headings":"","what":"Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function support multiple guidelines. can select guideline guideline parameter. Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. “Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.” Clinical Microbiology Infection (2012) (link) guideline = \"EUCAST3.2\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.2 “Intrinsic Resistance Unusual Phenotypes” (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 “Intrinsic Resistance Exceptional Phenotypes Tables” (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization “Companion handbook guidelines programmatic management drug-resistant tuberculosis” (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7. DOI: 10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Rijksinstituut voor Volksgezondheid en Milieu “WIP-richtlijn BRMO (Bijzonder Resistente Micro-Organismen) (ZKH)” (link) Please suggest (country-specific) guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"custom-guidelines","dir":"Articles","previous_headings":"Guidelines","what":"Custom Guidelines","title":"How to determine multi-drug resistance (MDR)","text":"can also use custom guideline. Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() dplyr package, recognise input method set rules. Rules must set using R considers ‘formula notation’: row/isolate matches first rule, value first ~ (case ‘Elderly Type ’) set MDRO value. Otherwise, second rule tried . maximum number rules unlimited. can print rules set console overview. Colours help reading console supports colours. outcome function can used guideline argument mdro() function: rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) custom #> A set of custom MDRO rules: #>   1. If CIP is \"R\" and age is higher than 60 then: Elderly Type A #>   2. If ERY is \"R\" and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B x <- mdro(example_isolates, guideline = custom) table(x) #> x #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732"},{"path":"https://msberends.github.io/AMR/articles/MDR.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"How to determine multi-drug resistance (MDR)","text":"mdro() function always returns ordered factor predefined guidelines. example, output default guideline Magiorakos et al. returns factor levels ‘Negative’, ‘MDR’, ‘XDR’ ‘PDR’ order. next example uses example_isolates data set. data set included package contains full antibiograms 2,000 microbial isolates. reflects reality can used practise AMR data analysis. test MDR/XDR/PDR guideline data set, get: Frequency table Class: factor > ordered (numeric) Length: 2,000 Levels: 4: Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant … Available: 1,729 (86.45%, NA: 271 = 13.55%) Unique: 2 another example, create data set determine multi-drug resistant TB: column names automatically verified valid drug names codes, worked exactly way: data set now looks like : can now add interpretation MDR-TB data set. can use: shortcut mdr_tb(): Create frequency table results: Frequency table Class: factor > ordered (numeric) Length: 5,000 Levels: 5: Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant <… Available: 5,000 (100%, NA: 0 = 0%) Unique: 5","code":"library(dplyr) # to support pipes: %>% library(cleaner) # to create frequency tables example_isolates %>%   mdro() %>%   freq() # show frequency table of the result #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) # random_sir() is a helper function to generate # a random vector with values S, I and R my_TB_data <- data.frame(   rifampicin = random_sir(5000),   isoniazid = random_sir(5000),   gatifloxacin = random_sir(5000),   ethambutol = random_sir(5000),   pyrazinamide = random_sir(5000),   moxifloxacin = random_sir(5000),   kanamycin = random_sir(5000) ) my_TB_data <- data.frame(   RIF = random_sir(5000),   INH = random_sir(5000),   GAT = random_sir(5000),   ETH = random_sir(5000),   PZA = random_sir(5000),   MFX = random_sir(5000),   KAN = random_sir(5000) ) head(my_TB_data) #>   rifampicin isoniazid gatifloxacin ethambutol pyrazinamide moxifloxacin #> 1          I         R            S          S            S            S #> 2          S         S            I          R            R            S #> 3          R         I            I          I            R            I #> 4          I         S            S          S            S            S #> 5          I         I            I          S            I            S #> 6          R         S            R          S            I            I #>   kanamycin #> 1         R #> 2         I #> 3         S #> 4         I #> 5         I #> 6         I mdro(my_TB_data, guideline = \"TB\") my_TB_data$mdr <- mdr_tb(my_TB_data) #> ℹ No column found as input for col_mo, assuming all rows contain #>   Mycobacterium tuberculosis. freq(my_TB_data$mdr)"},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"How to conduct principal component analysis (PCA) for AMR","text":"PCA, need transform AMR data first. example_isolates data set package looks like: Now transform data set resistance percentages per taxonomic order genus:","code":"library(AMR) library(dplyr) glimpse(example_isolates) #> Rows: 2,000 #> Columns: 46 #> $ date    <date> 2002-01-02, 2002-01-03, 2002-01-07, 2002-01-07, 2002-01-13, 2… #> $ patient <chr> \"A77334\", \"A77334\", \"067927\", \"067927\", \"067927\", \"067927\", \"4… #> $ age     <dbl> 65, 65, 45, 45, 45, 45, 78, 78, 45, 79, 67, 67, 71, 71, 75, 50… #> $ gender  <chr> \"F\", \"F\", \"F\", \"F\", \"F\", \"F\", \"M\", \"M\", \"F\", \"F\", \"M\", \"M\", \"M… #> $ ward    <chr> \"Clinical\", \"Clinical\", \"ICU\", \"ICU\", \"ICU\", \"ICU\", \"Clinical\"… #> $ mo      <mo> \"B_ESCHR_COLI\", \"B_ESCHR_COLI\", \"B_STPHY_EPDR\", \"B_STPHY_EPDR\",… #> $ PEN     <sir> R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, S,… #> $ OXA     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ FLC     <sir> NA, NA, R, R, R, R, S, S, R, S, S, S, NA, NA, NA, NA, NA, R, R… #> $ AMX     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ AMC     <sir> I, I, NA, NA, NA, NA, S, S, NA, NA, S, S, I, I, R, I, I, NA, N… #> $ AMP     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ TZP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CZO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ FEP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CXM     <sir> I, I, R, R, R, R, S, S, R, S, S, S, S, S, NA, S, S, R, R, S, S… #> $ FOX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ CTX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ CAZ     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, S, S, R, R, … #> $ CRO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ GEN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TOB     <sir> NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, S, S, NA, NA, NA… #> $ AMK     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ KAN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TMP     <sir> R, R, S, S, R, R, R, R, S, S, NA, NA, S, S, S, S, S, R, R, R, … #> $ SXT     <sir> R, R, S, S, NA, NA, NA, NA, S, S, NA, NA, S, S, S, S, S, NA, N… #> $ NIT     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R,… #> $ FOS     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ LNZ     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ CIP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, NA, S, S… #> $ MFX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ VAN     <sir> R, R, S, S, S, S, S, S, S, S, NA, NA, R, R, R, R, R, S, S, S, … #> $ TEC     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ TCY     <sir> R, R, S, S, S, S, S, S, S, I, S, S, NA, NA, I, R, R, S, I, R, … #> $ TGC     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ DOX     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ ERY     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ CLI     <sir> R, R, NA, NA, NA, R, NA, NA, NA, NA, NA, NA, R, R, R, R, R, NA… #> $ AZM     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ IPM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ MEM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ MTR     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CHL     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ COL     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, R, R, R, R, … #> $ MUP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ RIF     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… resistance_data <- example_isolates %>%   group_by(     order = mo_order(mo), # group on anything, like order     genus = mo_genus(mo)   ) %>% #  and genus as we do here   summarise_if(is.sir, resistance) %>% # then get resistance of all drugs   select(     order, genus, AMC, CXM, CTX,     CAZ, GEN, TOB, TMP, SXT   ) # and select only relevant columns  head(resistance_data) #> # A tibble: 6 × 10 #> # Groups:   order [5] #>   order             genus          AMC   CXM   CTX   CAZ   GEN   TOB   TMP   SXT #>   <chr>             <chr>        <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 (unknown order)   (unknown ge…    NA    NA    NA    NA    NA    NA    NA    NA #> 2 Actinomycetales   Schaalia        NA    NA    NA    NA    NA    NA    NA    NA #> 3 Bacteroidales     Bacteroides     NA    NA    NA    NA    NA    NA    NA    NA #> 4 Campylobacterales Campylobact…    NA    NA    NA    NA    NA    NA    NA    NA #> 5 Caryophanales     Gemella         NA    NA    NA    NA    NA    NA    NA    NA #> 6 Caryophanales     Listeria        NA    NA    NA    NA    NA    NA    NA    NA"},{"path":"https://msberends.github.io/AMR/articles/PCA.html","id":"perform-principal-component-analysis","dir":"Articles","previous_headings":"","what":"Perform principal component analysis","title":"How to conduct principal component analysis (PCA) for AMR","text":"new pca() function automatically filter rows contain numeric values selected variables, now need : result can reviewed good old summary() function: Good news. first two components explain total 93.3% variance (see PC1 PC2 values Proportion Variance. can create -called biplot base R biplot() function, see antimicrobial resistance per drug explain difference per microorganism.","code":"pca_result <- pca(resistance_data) #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. summary(pca_result) #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\" #> Importance of components: #>                           PC1    PC2    PC3     PC4     PC5     PC6       PC7 #> Standard deviation     2.1539 1.6807 0.6138 0.33879 0.20808 0.03140 1.232e-16 #> Proportion of Variance 0.5799 0.3531 0.0471 0.01435 0.00541 0.00012 0.000e+00 #> Cumulative Proportion  0.5799 0.9330 0.9801 0.99446 0.99988 1.00000 1.000e+00 #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\""},{"path":"https://msberends.github.io/AMR/articles/PCA.html","id":"plotting-the-results","dir":"Articles","previous_headings":"","what":"Plotting the results","title":"How to conduct principal component analysis (PCA) for AMR","text":"can’t see explanation points. Perhaps works better new ggplot_pca() function, automatically adds right labels even groups:  can also print ellipse per group, edit appearance:","code":"biplot(pca_result) ggplot_pca(pca_result) ggplot_pca(pca_result, ellipse = TRUE) +   ggplot2::labs(title = \"An AMR/PCA biplot!\")"},{"path":"https://msberends.github.io/AMR/articles/WHONET.html","id":"import-of-data","dir":"Articles","previous_headings":"","what":"Import of data","title":"How to work with WHONET data","text":"tutorial assumes already imported WHONET data e.g. readxl package. RStudio, can done using menu button ‘Import Dataset’ tab ‘Environment’. Choose option ‘Excel’ select exported file. Make sure date fields imported correctly. example syntax look like : package comes example data set WHONET. use analysis.","code":"library(readxl) data <- read_excel(path = \"path/to/your/file.xlsx\")"},{"path":"https://msberends.github.io/AMR/articles/WHONET.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"How to work with WHONET data","text":"First, load relevant packages yet . use tidyverse analyses. . don’t know yet, suggest read website: https://www.tidyverse.org/. transform variables simplify automate analysis: Microorganisms transformed microorganism codes (called mo) using Catalogue Life reference data set, contains ~70,000 microorganisms taxonomic kingdoms Bacteria, Fungi Protozoa. tranformation .mo(). function also recognises almost WHONET abbreviations microorganisms. Antimicrobial results interpretations clean valid. words, contain values \"S\", \"\" \"R\". exactly .sir() function . errors warnings, values transformed succesfully. also created package dedicated data cleaning checking, called cleaner package. freq() function can used create frequency tables. let’s check data, couple frequency tables: Frequency table Class: character Length: 500 Available: 500 (100%, NA: 0 = 0%) Unique: 38 Shortest: 11 Longest: 40 (omitted 28 entries, n = 57 [11.4%]) Frequency table Class: factor > ordered > sir (numeric) Length: 500 Levels: 5: S < SDD < < R < N Available: 481 (96.2%, NA: 19 = 3.8%) Unique: 3 Drug: Amoxicillin/clavulanic acid (AMC, J01CR02) Drug group: Beta-lactams/penicillins %SI: 78.59%","code":"library(dplyr) # part of tidyverse library(ggplot2) # part of tidyverse library(AMR) # this package library(cleaner) # to create frequency tables # transform variables data <- WHONET %>%   # get microbial ID based on given organism   mutate(mo = as.mo(Organism)) %>%   # transform everything from \"AMP_ND10\" to \"CIP_EE\" to the new `sir` class   mutate_at(vars(AMP_ND10:CIP_EE), as.sir) # our newly created `mo` variable, put in the mo_name() function data %>% freq(mo_name(mo), nmax = 10) # our transformed antibiotic columns # amoxicillin/clavulanic acid (J01CR02) as an example data %>% freq(AMC_ND2)"},{"path":"https://msberends.github.io/AMR/articles/WHONET.html","id":"a-first-glimpse-at-results","dir":"Articles","previous_headings":"","what":"A first glimpse at results","title":"How to work with WHONET data","text":"easy ggplot already give lot information, using included ggplot_sir() function:","code":"data %>%   group_by(Country) %>%   select(Country, AMP_ND2, AMC_ED20, CAZ_ED10, CIP_ED5) %>%   ggplot_sir(translate_ab = \"ab\", facet = \"Country\", datalabels = FALSE)"},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Data sets for download / own use","text":"data set 52 171 rows 23 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, gbif, gbif_parent, gbif_renamed_to, prevalence, snomed. data set R available microorganisms, load AMR package. last updated 14 July 2023 08:49:06 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (1.2 MB) Download tab-separated text file (11.7 MB) Download Microsoft Excel workbook (5.2 MB) Download Apache Feather file (5.5 MB) Download Apache Parquet file (2.6 MB) Download SAS transport (XPT) file (48.6 MB) Download IBM SPSS Statistics data file (17.8 MB) Download Stata DTA file (48.6 MB) NOTE: exported files SAS, 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.","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source","dir":"Articles","previous_headings":"microorganisms: Full Microbial Taxonomy","what":"Source","title":"Data sets for download / own use","text":"data set contains full microbial taxonomy five kingdoms List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF): Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; . Accessed https://lpsn.dsmz.de December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset . Accessed https://www.gbif.org January 8th, 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://phinvads.cdc.gov","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example-content","dir":"Articles","previous_headings":"microorganisms: Full Microbial Taxonomy","what":"Example content","title":"Data sets for download / own use","text":"Included (sub)species per taxonomic kingdom: Example rows filtering genus Escherichia:","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"antibiotics-antibiotic-antifungal-drugs","dir":"Articles","previous_headings":"","what":"antibiotics: Antibiotic (+Antifungal) Drugs","title":"Data sets for download / own use","text":"data set 483 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 antibiotics, load AMR package. last updated 24 February 2024 14:16:52 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (44 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (73 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download SAS transport (XPT) file (1.5 MB) Download IBM SPSS Statistics data file (0.4 MB) Download Stata DTA file (0.5 MB) tab-separated text file Microsoft Excel workbook, SAS, SPSS Stata files contain ATC codes, common abbreviations, trade names LOINC codes comma separated values.","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-1","dir":"Articles","previous_headings":"antibiotics: Antibiotic (+Antifungal) Drugs","what":"Source","title":"Data sets for download / own use","text":"data set contains EARS-Net ATC codes gathered WHONET, compound IDs PubChem. also contains brand names (synonyms) found PubChem Defined Daily Doses (DDDs) oral parenteral administration. ATC/DDD index Collaborating Centre Drug Statistics Methodology (note: may used commercial purposes, freely available CC website personal use) PubChem US National Library Medicine WHONET software 2019 LOINC (Logical Observation Identifiers Names Codes)","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"antivirals-antiviral-drugs","dir":"Articles","previous_headings":"","what":"antivirals: Antiviral Drugs","title":"Data sets for download / own use","text":"data set 120 rows 11 columns, containing following column names:av, name, atc, cid, atc_group, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antivirals, load AMR package. last updated 20 October 2023 12:51:48 UTC. Find info 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 SAS transport (XPT) file (73 kB) Download IBM SPSS Statistics data file (32 kB) Download Stata DTA file (78 kB) tab-separated text file Microsoft Excel workbook, SAS, SPSS Stata files contain trade names LOINC codes comma separated values.","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-2","dir":"Articles","previous_headings":"antivirals: Antiviral Drugs","what":"Source","title":"Data sets for download / own use","text":"data set contains ATC codes gathered compound IDs PubChem. also contains brand names (synonyms) found PubChem Defined Daily Doses (DDDs) oral parenteral administration. ATC/DDD index Collaborating Centre Drug Statistics Methodology (note: may used commercial purposes, freely available CC website personal use) PubChem US National Library Medicine LOINC (Logical Observation Identifiers Names Codes)","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"clinical_breakpoints-interpretation-from-mic-values-disk-diameters-to-sir","dir":"Articles","previous_headings":"","what":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","title":"Data sets for download / own use","text":"data set 29 883 rows 13 columns, containing following column names:guideline, type, host, method, site, mo, rank_index, ab, ref_tbl, disk_dose, breakpoint_S, breakpoint_R, uti. data set R available clinical_breakpoints, load AMR package. last updated 24 February 2024 14:16:52 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (61 kB) Download tab-separated text file (2.5 MB) Download Microsoft Excel workbook (1.4 MB) Download Apache Feather file (1.3 MB) Download Apache Parquet file (91 kB) Download SAS transport (XPT) file (8.2 MB) Download IBM SPSS Statistics data file (4.9 MB) Download Stata DTA file (8.1 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-3","dir":"Articles","previous_headings":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","what":"Source","title":"Data sets for download / own use","text":"data set contains interpretation rules MIC values disk diffusion diameters. Included guidelines CLSI (2011-2023) EUCAST (2011-2023). 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 development WHONET software. 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 AMR package. NOTE: AMR package (WHONET software well) contains internal methods apply guidelines, rather complex. example, breakpoints must applied certain species groups (case package available microorganisms.groups data set). important considered using breakpoints use.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"intrinsic_resistant-intrinsic-bacterial-resistance","dir":"Articles","previous_headings":"","what":"intrinsic_resistant: Intrinsic Bacterial Resistance","title":"Data sets for download / own use","text":"data set 134 634 rows 2 columns, containing following column names:mo ab. data set R available intrinsic_resistant, load AMR package. last updated 16 December 2022 15:10:43 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (78 kB) Download tab-separated text file (5.1 MB) Download Microsoft Excel workbook (1.3 MB) Download Apache Feather file (1.2 MB) Download Apache Parquet file (0.2 MB) Download SAS transport (XPT) file (9.5 MB) Download IBM SPSS Statistics data file (7.4 MB) Download Stata DTA file (9.5 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-4","dir":"Articles","previous_headings":"intrinsic_resistant: Intrinsic Bacterial Resistance","what":"Source","title":"Data sets for download / own use","text":"data set contains defined intrinsic resistance EUCAST bug-drug combinations, based ‘EUCAST Expert Rules’ ‘EUCAST Intrinsic Resistance Unusual Phenotypes’ v3.3 (2021).","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example-content-4","dir":"Articles","previous_headings":"intrinsic_resistant: Intrinsic Bacterial Resistance","what":"Example content","title":"Data sets for download / own use","text":"Example rows filtering Enterobacter cloacae:","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"dosage-dosage-guidelines-from-eucast","dir":"Articles","previous_headings":"","what":"dosage: Dosage Guidelines from EUCAST","title":"Data sets for download / own use","text":"data set 503 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 22 June 2023 13:10:59 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (3 kB) Download tab-separated text file (43 kB) Download Microsoft Excel workbook (25 kB) Download Apache Feather file (21 kB) Download Apache Parquet file (9 kB) Download SAS transport (XPT) file (0.1 MB) Download IBM SPSS Statistics data file (64 kB) Download Stata DTA file (0.1 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-5","dir":"Articles","previous_headings":"dosage: Dosage Guidelines from EUCAST","what":"Source","title":"Data sets for download / own use","text":"EUCAST breakpoints used package based dosages data set. Currently included dosages data set meant :  (), ‘EUCAST Clinical Breakpoint Tables’ v11.0 (2021), ‘EUCAST Clinical Breakpoint Tables’ v12.0 (2022).","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example_isolates-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates: Example Data for Practice","title":"Data sets for download / own use","text":"data set 2 000 rows 46 columns, containing following column names:date, patient, age, gender, ward, mo, PEN, OXA, FLC, AMX, AMC, AMP, TZP, CZO, FEP, CXM, FOX, CTX, CAZ, CRO, GEN, TOB, AMK, KAN, TMP, SXT, NIT, FOS, LNZ, CIP, MFX, VAN, TEC, TCY, TGC, DOX, ERY, CLI, AZM, IPM, MEM, MTR, CHL, COL, MUP, RIF. data set R available example_isolates, load AMR package. last updated 21 January 2023 22:47:20 UTC. Find info structure data set .","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-6","dir":"Articles","previous_headings":"example_isolates: Example Data for Practice","what":"Source","title":"Data sets for download / own use","text":"data set contains randomised fictitious data, reflects reality can used practise AMR data analysis.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"example_isolates_unclean-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates_unclean: Example Data for Practice","title":"Data sets for download / own use","text":"data set 3 000 rows 8 columns, containing following column names:patient_id, hospital, date, bacteria, AMX, AMC, CIP, GEN. data set R available example_isolates_unclean, load AMR package. last updated 27 August 2022 18:49:37 UTC. Find info structure data set .","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-7","dir":"Articles","previous_headings":"example_isolates_unclean: Example Data for Practice","what":"Source","title":"Data sets for download / own use","text":"data set contains randomised fictitious data, reflects reality can used practise AMR data analysis.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"microorganisms-groups-species-groups-and-microbiological-complexes","dir":"Articles","previous_headings":"","what":"microorganisms.groups: Species Groups and Microbiological Complexes","title":"Data sets for download / own use","text":"data set 521 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 14 July 2023 08:49:06 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (49 kB) Download Microsoft Excel workbook (20 kB) Download Apache Feather file (19 kB) Download Apache Parquet file (13 kB) Download SAS transport (XPT) file (0 kB) Download IBM SPSS Statistics data file (64 kB) Download Stata DTA file (81 kB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-8","dir":"Articles","previous_headings":"microorganisms.groups: Species Groups and Microbiological Complexes","what":"Source","title":"Data sets for download / own use","text":"data set contains species groups microbiological complexes, used clinical_breakpoints data set.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"microorganisms-codes-common-laboratory-codes","dir":"Articles","previous_headings":"","what":"microorganisms.codes: Common Laboratory Codes","title":"Data sets for download / own use","text":"data set 4 957 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 8 July 2023 15:30:05 UTC. Find info structure data set . Direct download links: Download original R Data Structure (RDS) file (22 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (91 kB) Download Apache Feather file (85 kB) Download Apache Parquet file (57 kB) Download SAS transport (XPT) file (0 kB) Download IBM SPSS Statistics data file (0.1 MB) Download Stata DTA file (0.1 MB)","code":""},{"path":"https://msberends.github.io/AMR/articles/datasets.html","id":"source-9","dir":"Articles","previous_headings":"microorganisms.codes: Common Laboratory Codes","what":"Source","title":"Data sets for download / own use","text":"data set contains commonly used codes microorganisms, laboratory systems WHONET.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/articles/resistance_predict.html","id":"needed-r-packages","dir":"Articles","previous_headings":"","what":"Needed R packages","title":"How to predict antimicrobial resistance","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. AMR package depends packages even extends use functions.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"tidyverse\", \"AMR\"))"},{"path":"https://msberends.github.io/AMR/articles/resistance_predict.html","id":"prediction-analysis","dir":"Articles","previous_headings":"","what":"Prediction analysis","title":"How to predict antimicrobial resistance","text":"package contains function resistance_predict(), takes input functions AMR data analysis. Based date column, calculates cases per year uses regression model predict antimicrobial resistance. basically easy : function look date column col_date set. running commands, summary regression model printed unless using resistance_predict(..., info = FALSE). text printed summary - actual result (output) function data.frame containing year: number observations, actual observed resistance, estimated resistance standard error estimation: function plot available base R, can extended packages depend output based type input. extended function cope resistance predictions:  fastest way plot result. automatically adds right axes, error bars, titles, number available observations type model. also support ggplot2 package custom function ggplot_sir_predict() create appealing plots:","code":"# resistance prediction of piperacillin/tazobactam (TZP): resistance_predict(tbl = example_isolates, col_date = \"date\", col_ab = \"TZP\", model = \"binomial\")  # or: example_isolates %>%   resistance_predict(     col_ab = \"TZP\",     model = \"binomial\"   )  # to bind it to object 'predict_TZP' for example: predict_TZP <- example_isolates %>%   resistance_predict(     col_ab = \"TZP\",     model = \"binomial\"   ) predict_TZP #> # A tibble: 33 × 7 #>     year  value se_min se_max observations observed estimated #>  * <dbl>  <dbl>  <dbl>  <dbl>        <int>    <dbl>     <dbl> #>  1  2002 0.2        NA     NA           15   0.2       0.0562 #>  2  2003 0.0625     NA     NA           32   0.0625    0.0616 #>  3  2004 0.0854     NA     NA           82   0.0854    0.0676 #>  4  2005 0.05       NA     NA           60   0.05      0.0741 #>  5  2006 0.0508     NA     NA           59   0.0508    0.0812 #>  6  2007 0.121      NA     NA           66   0.121     0.0889 #>  7  2008 0.0417     NA     NA           72   0.0417    0.0972 #>  8  2009 0.0164     NA     NA           61   0.0164    0.106  #>  9  2010 0.0566     NA     NA           53   0.0566    0.116  #> 10  2011 0.183      NA     NA           93   0.183     0.127  #> # ℹ 23 more rows plot(predict_TZP) ggplot_sir_predict(predict_TZP) # choose for error bars instead of a ribbon ggplot_sir_predict(predict_TZP, ribbon = FALSE)"},{"path":"https://msberends.github.io/AMR/articles/resistance_predict.html","id":"choosing-the-right-model","dir":"Articles","previous_headings":"Prediction analysis","what":"Choosing the right model","title":"How to predict antimicrobial resistance","text":"Resistance easily predicted; look vancomycin resistance Gram-positive bacteria, spread (.e. standard error) enormous:  Vancomycin resistance 100% ten years, might remain low. can define model model parameter. model chosen generalised linear regression model using binomial distribution, assuming period zero resistance followed period increasing resistance leading slowly resistance. Valid values : vancomycin resistance Gram-positive bacteria, linear model might appropriate:  model also available object, attribute:","code":"example_isolates %>%   filter(mo_gramstain(mo, language = NULL) == \"Gram-positive\") %>%   resistance_predict(col_ab = \"VAN\", year_min = 2010, info = FALSE, model = \"binomial\") %>%   ggplot_sir_predict() example_isolates %>%   filter(mo_gramstain(mo, language = NULL) == \"Gram-positive\") %>%   resistance_predict(col_ab = \"VAN\", year_min = 2010, info = FALSE, model = \"linear\") %>%   ggplot_sir_predict() model <- attributes(predict_TZP)$model  summary(model)$family #>  #> Family: binomial  #> Link function: logit summary(model)$coefficients #>                  Estimate  Std. Error   z value     Pr(>|z|) #> (Intercept) -200.67944891 46.17315349 -4.346237 1.384932e-05 #> year           0.09883005  0.02295317  4.305725 1.664395e-05"},{"path":"https://msberends.github.io/AMR/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. Casper J. Albers. Thesis advisor. Peter Dutey-Magni. Contributor. Judith M. Fonville. Contributor. Alex W. Friedrich. Thesis advisor. Corinna Glasner. Thesis advisor. Eric H. L. C. M. Hazenberg. Contributor. Gwen Knight. Contributor. Annick Lenglet. Contributor. Christian F. Luz. Contributor. Bart C. Meijer. Contributor. Dmytro Mykhailenko. Contributor. Anton Mymrikov. Contributor. Andrew P. Norgan. Contributor. Sofia Ny. Contributor. Matthew Saab. Contributor. Jonas Salm. Contributor. Javier Sanchez. Contributor. Rogier P. Schade. Contributor. Bhanu N. M. Sinha. Thesis advisor. Jason Stull. Contributor. Anthony Underwood. Contributor. Anita Williams. Contributor.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 AMR data analysis One Health approach Generates antibiograms - traditional, combined, syndromic, even WISCA Provides full microbiological taxonomy data antimicrobial drugs Applies recent CLSI EUCAST clinical veterinary breakpoints MICs disk zones Corrects duplicate isolates, calculates predicts AMR per antibiotic class Integrates WHONET, ATC, EARS-Net, PubChem, LOINC, SNOMED CT Works Windows, macOS Linux versions R since R-3.0 completely dependency-free, highly suitable places limited resources https://msberends.github.io/AMR https://doi.org/10.18637/jss.v104.i03","code":""},{"path":"https://msberends.github.io/AMR/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Antimicrobial Resistance Data Analysis","text":"AMR package free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. Many different researchers around globe continually helping us make successful durable project! work published Journal Statistical Software (Volume 104(3); DOI 10.18637/jss.v104.i03) formed basis two PhD theses (DOI 10.33612/diss.177417131 DOI 10.33612/diss.192486375). installing package, R knows ~52,000 distinct microbial species (updated December 2022) ~600 antibiotic, antimycotic antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI EUCAST included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen, collaboration non-profit organisations Certe Medical Diagnostics Advice Foundation University Medical Center Groningen.","code":""},{"path":"https://msberends.github.io/AMR/index.html","id":"used-in-over-175-countries-translated-into-20-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, translated into 20 languages","title":"Antimicrobial Resistance Data Analysis","text":"Since first public release early 2018, R package used almost countries world. Click map enlarge see country names. help contributors corners world, AMR package available  English,  Czech,  Chinese,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Italian,  Japanese,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swedish,  Turkish,  Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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 antibiotic columns. can done using -called antibiotic class 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 antibiotics AMR package make sure get meant: base R equivalent : base R code work version R since April 2013 (R-3.0). Moreover, code works identically data.table package, starting :","code":"# AMR works great with dplyr, but it's not required or neccesary library(AMR) library(dplyr)  example_isolates %>%   mutate(bacteria = mo_fullname()) %>%   # filtering functions for microorganisms:   filter(mo_is_gram_negative(),          mo_is_intrinsic_resistant(ab = \"cefotax\")) %>%   # antibiotic selectors:   select(bacteria,          aminoglycosides(),          carbapenems()) library(AMR) example_isolates$bacteria <- mo_fullname(example_isolates$mo) example_isolates[which(mo_is_gram_negative() &                          mo_is_intrinsic_resistant(ab = \"cefotax\")),                  c(\"bacteria\", aminoglycosides(), carbapenems())] example_isolates <- data.table::as.data.table(example_isolates)"},{"path":"https://msberends.github.io/AMR/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 antibiotics yield higher empiric coverage: Like many functions package, antibiogram() comes support 20 languages often detected automatically based system language:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) antibiogram(example_isolates,             antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") antibiogram(example_isolates,             antibiotics = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian"},{"path":"https://msberends.github.io/AMR/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 antibiotic class 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 = \"-\")))) 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)) out # transform the antibiotic columns to names: out %>% set_ab_names() # transform the antibiotic column to ATC codes: out %>% set_ab_names(property = \"atc\")"},{"path":"https://msberends.github.io/AMR/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) Predicting future antimicrobial resistance using regression models (tutorial) Getting properties microorganism (like Gram stain, species, genus family) (manual) Getting properties antibiotic (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://msberends.github.io/AMR/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 development version.","code":"install.packages(\"AMR\")"},{"path":"https://msberends.github.io/AMR/index.html","id":"latest-development-version","dir":"","previous_headings":"Get this package","what":"Latest development version","title":"Antimicrobial Resistance Data Analysis","text":"Please read Developer Guideline . latest unpublished development version can installed GitHub two ways: Manually, using: Automatically, using rOpenSci R-universe platform, adding R-universe address list repositories (‘repos’): , can install update AMR package like official release (e.g., using install.packages(\"AMR\") RStudio via Tools > Check Package Updates…).","code":"install.packages(\"remotes\") # if you haven't already remotes::install_github(\"msberends/AMR\") options(repos = c(getOption(\"repos\"),                   msberends = \"https://msberends.r-universe.dev\"))"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/index.html","id":"partners","dir":"","previous_headings":"","what":"Partners","title":"Antimicrobial Resistance Data Analysis","text":"development package part , related , made possible following non-profit organisations initiatives:","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/AMR-options.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Options for the AMR package — AMR-options","text":"AMR_breakpoint_type  character use .sir(), indicate breakpoint type use. must either \"ECOFF\", \"animal\", \"human\". 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 2023\". Supported guideline currently EUCAST (2011-2023) CLSI (2011-2023). 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_include_screening  logical use .sir(), indicate clinical breakpoints screening allowed - default FALSE. AMR_keep_synonyms  logical use .mo() mo_* functions, indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE. AMR_locale  character set language AMR package, can one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). default current system language (supported, English otherwise). AMR_mo_source  file location manual code list used .mo() mo_* functions. explained set_mo_source().","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics, allow PK/PD rules interpreting MIC values .sir().","code":"utils::file.edit(\"~/.Rprofile\") options(AMR_locale = \"pt\")  options(AMR_include_PKPD = TRUE)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. Many different researchers around globe continually helping us make successful durable project! work published Journal Statistical Software (Volume 104(3); doi:10.18637/jss.v104.i03 ) formed basis two PhD theses (doi:10.33612/diss.177417131  doi:10.33612/diss.192486375 ). installing package, R knows ~52 000 microorganisms (updated January 2024) ~600 antibiotic, antimycotic antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI EUCAST included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences public University Groningen, collaboration non-profit organisations Certe Medical Diagnostics Advice Foundation University Medical Center Groningen. AMR package available English, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/AMR.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"The AMR Package — AMR","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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: Casper J. Albers (ORCID) [thesis advisor] Peter Dutey-Magni (ORCID) [contributor] Judith M. Fonville [contributor] Alex W. Friedrich (ORCID) [thesis advisor] Corinna Glasner (ORCID) [thesis advisor] Eric H. L. C. M. Hazenberg [contributor] Gwen Knight (ORCID) [contributor] Annick Lenglet (ORCID) [contributor] Christian F. Luz (ORCID) [contributor] Bart C. Meijer [contributor] Dmytro Mykhailenko [contributor] Anton Mymrikov [contributor] Andrew P. Norgan (ORCID) [contributor] Sofia Ny (ORCID) [contributor] Matthew Saab [contributor] Jonas Salm [contributor] Javier Sanchez (ORCID) [contributor] Rogier P. Schade [contributor] Bhanu N. M. Sinha (ORCID) [thesis advisor] Jason Stull (ORCID) [contributor] Anthony Underwood (ORCID) [contributor] Anita Williams (ORCID) [contributor]","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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] \"culpen\"               \"floxacillin\"          \"floxacillin sodium\"   #>  [4] \"floxapen\"             \"floxapen sodium salt\" \"fluclox\"              #>  [7] \"flucloxacilina\"       \"flucloxacillin\"       \"flucloxacilline\"      #> [10] \"flucloxacillinum\"     \"fluorochloroxacillin\" \"staphylex\""},{"path":"https://msberends.github.io/AMR/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. antibiotic results example_isolates data set. patient names created using online surname generators place practice purposes.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics. can lookup abbreviations antibiotics data set, use e.g. ab_name(\"AMP\") get official name immediately. analysis, transform valid antibiotic class, using .sir().","code":""},{"path":"https://msberends.github.io/AMR/reference/WHONET.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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\" \"Quinolones\"                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://msberends.github.io/AMR/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 antibiotics data set. input values evaluated internally .ab().","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics data set: vector_or(colnames(antibiotics), 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/ab_property.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Get Properties of an Antibiotic — ab_property","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/ab_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"# all properties: ab_name(\"AMX\") #> [1] \"Amoxicillin\" ab_atc(\"AMX\") #> [1] \"J01CA04\" ab_cid(\"AMX\") #> [1] 33613 ab_synonyms(\"AMX\") #>  [1] \"actimoxi\"            \"amoclen\"             \"amolin\"              #>  [4] \"amopen\"              \"amopenixin\"          \"amoxibiotic\"         #>  [7] \"amoxicaps\"           \"amoxicilina\"         \"amoxicillin\"         #> [10] \"amoxicillin hydrate\" \"amoxicilline\"        \"amoxicillinum\"       #> [13] \"amoxiden\"            \"amoxil\"              \"amoxivet\"            #> [16] \"amoxy\"               \"amoxycillin\"         \"amoxyke\"             #> [19] \"anemolin\"            \"aspenil\"             \"atoksilin\"           #> [22] \"biomox\"              \"bristamox\"           \"cemoxin\"             #> [25] \"clamoxyl\"            \"damoxy\"              \"delacillin\"          #> [28] \"demoksil\"            \"dispermox\"           \"efpenix\"             #> [31] \"flemoxin\"            \"hiconcil\"            \"histocillin\"         #> [34] \"hydroxyampicillin\"   \"ibiamox\"             \"imacillin\"           #> [37] \"lamoxy\"              \"largopen\"            \"metafarma capsules\"  #> [40] \"metifarma capsules\"  \"moksilin\"            \"moxacin\"             #> [43] \"moxatag\"             \"ospamox\"             \"pamoxicillin\"        #> [46] \"piramox\"             \"promoxil\"            \"remoxil\"             #> [49] \"robamox\"             \"sawamox pm\"          \"tolodina\"            #> [52] \"topramoxin\"          \"unicillin\"           \"utimox\"              #> [55] \"vetramox\"            ab_tradenames(\"AMX\") #>  [1] \"actimoxi\"            \"amoclen\"             \"amolin\"              #>  [4] \"amopen\"              \"amopenixin\"          \"amoxibiotic\"         #>  [7] \"amoxicaps\"           \"amoxicilina\"         \"amoxicillin\"         #> [10] \"amoxicillin hydrate\" \"amoxicilline\"        \"amoxicillinum\"       #> [13] \"amoxiden\"            \"amoxil\"              \"amoxivet\"            #> [16] \"amoxy\"               \"amoxycillin\"         \"amoxyke\"             #> [19] \"anemolin\"            \"aspenil\"             \"atoksilin\"           #> [22] \"biomox\"              \"bristamox\"           \"cemoxin\"             #> [25] \"clamoxyl\"            \"damoxy\"              \"delacillin\"          #> [28] \"demoksil\"            \"dispermox\"           \"efpenix\"             #> [31] \"flemoxin\"            \"hiconcil\"            \"histocillin\"         #> [34] \"hydroxyampicillin\"   \"ibiamox\"             \"imacillin\"           #> [37] \"lamoxy\"              \"largopen\"            \"metafarma capsules\"  #> [40] \"metifarma capsules\"  \"moksilin\"            \"moxacin\"             #> [43] \"moxatag\"             \"ospamox\"             \"pamoxicillin\"        #> [46] \"piramox\"             \"promoxil\"            \"remoxil\"             #> [49] \"robamox\"             \"sawamox pm\"          \"tolodina\"            #> [52] \"topramoxin\"          \"unicillin\"           \"utimox\"              #> [55] \"vetramox\"            ab_group(\"AMX\") #> [1] \"Beta-lactams/penicillins\" ab_atc_group1(\"AMX\") #> [1] \"Beta-lactam antibacterials, penicillins\" ab_atc_group2(\"AMX\") #> [1] \"Penicillins with extended spectrum\" ab_url(\"AMX\") #>                                                             Amoxicillin  #> \"https://atcddd.fhi.no/atc_ddd_index//?code=J01CA04&showdescription=no\"   # smart lowercase transformation ab_name(x = c(\"AMC\", \"PLB\")) #> [1] \"Amoxicillin/clavulanic acid\" \"Polymyxin B\"                 ab_name(x = c(\"AMC\", \"PLB\"), tolower = TRUE) #> [1] \"amoxicillin/clavulanic acid\" \"polymyxin B\"                  # defined daily doses (DDD) ab_ddd(\"AMX\", \"oral\") #> [1] 1.5 ab_ddd_units(\"AMX\", \"oral\") #> [1] \"g\" ab_ddd(\"AMX\", \"iv\") #> [1] 3 ab_ddd_units(\"AMX\", \"iv\") #> [1] \"g\"  ab_info(\"AMX\") # all properties as a list #> $ab #> [1] \"AMX\" #>  #> $cid #> [1] 33613 #>  #> $name #> [1] \"Amoxicillin\" #>  #> $group #> [1] \"Beta-lactams/penicillins\" #>  #> $atc #> [1] \"J01CA04\" #>  #> $atc_group1 #> [1] \"Beta-lactam antibacterials, penicillins\" #>  #> $atc_group2 #> [1] \"Penicillins with extended spectrum\" #>  #> $tradenames #>  [1] \"actimoxi\"            \"amoclen\"             \"amolin\"              #>  [4] \"amopen\"              \"amopenixin\"          \"amoxibiotic\"         #>  [7] \"amoxicaps\"           \"amoxicilina\"         \"amoxicillin\"         #> [10] \"amoxicillin hydrate\" \"amoxicilline\"        \"amoxicillinum\"       #> [13] \"amoxiden\"            \"amoxil\"              \"amoxivet\"            #> [16] \"amoxy\"               \"amoxycillin\"         \"amoxyke\"             #> [19] \"anemolin\"            \"aspenil\"             \"atoksilin\"           #> [22] \"biomox\"              \"bristamox\"           \"cemoxin\"             #> [25] \"clamoxyl\"            \"damoxy\"              \"delacillin\"          #> [28] \"demoksil\"            \"dispermox\"           \"efpenix\"             #> [31] \"flemoxin\"            \"hiconcil\"            \"histocillin\"         #> [34] \"hydroxyampicillin\"   \"ibiamox\"             \"imacillin\"           #> [37] \"lamoxy\"              \"largopen\"            \"metafarma capsules\"  #> [40] \"metifarma capsules\"  \"moksilin\"            \"moxacin\"             #> [43] \"moxatag\"             \"ospamox\"             \"pamoxicillin\"        #> [46] \"piramox\"             \"promoxil\"            \"remoxil\"             #> [49] \"robamox\"             \"sawamox pm\"          \"tolodina\"            #> [52] \"topramoxin\"          \"unicillin\"           \"utimox\"              #> [55] \"vetramox\"            #>  #> $loinc #>  [1] \"101498-4\" \"15-8\"     \"16-6\"     \"16365-9\"  \"17-4\"     \"18-2\"     #>  [7] \"18861-5\"  \"18862-3\"  \"19-0\"     \"20-8\"     \"21-6\"     \"22-4\"     #> [13] \"25274-2\"  \"25310-4\"  \"3344-9\"   \"55614-2\"  \"55615-9\"  \"55616-7\"  #> [19] \"6976-5\"   \"6977-3\"   \"80133-2\"  #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 1.5 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 3 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all ab_* functions use as.ab() internally, so you can go from 'any' to 'any': ab_atc(\"AMP\") #> [1] \"J01CA01\" \"S01AA19\" ab_group(\"J01CA01\") #> [1] \"Beta-lactams/penicillins\" ab_loinc(\"ampicillin\") #>  [1] \"101477-8\" \"101478-6\" \"18864-9\"  \"18865-6\"  \"20374-5\"  \"21066-6\"  #>  [7] \"23618-2\"  \"27-3\"     \"28-1\"     \"29-9\"     \"30-7\"     \"31-5\"     #> [13] \"32-3\"     \"33-1\"     \"3355-5\"   \"33562-0\"  \"33919-2\"  \"34-9\"     #> [19] \"43883-8\"  \"43884-6\"  \"6979-9\"   \"6980-7\"   \"87604-5\"  ab_name(\"21066-6\") #> [1] \"Ampicillin\" ab_name(6249) #> [1] \"Ampicillin\" ab_name(\"J01CA01\") #> [1] \"Ampicillin\"  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  # use set_ab_names() for renaming columns colnames(example_isolates) #>  [1] \"date\"    \"patient\" \"age\"     \"gender\"  \"ward\"    \"mo\"      \"PEN\"     #>  [8] \"OXA\"     \"FLC\"     \"AMX\"     \"AMC\"     \"AMP\"     \"TZP\"     \"CZO\"     #> [15] \"FEP\"     \"CXM\"     \"FOX\"     \"CTX\"     \"CAZ\"     \"CRO\"     \"GEN\"     #> [22] \"TOB\"     \"AMK\"     \"KAN\"     \"TMP\"     \"SXT\"     \"NIT\"     \"FOS\"     #> [29] \"LNZ\"     \"CIP\"     \"MFX\"     \"VAN\"     \"TEC\"     \"TCY\"     \"TGC\"     #> [36] \"DOX\"     \"ERY\"     \"CLI\"     \"AZM\"     \"IPM\"     \"MEM\"     \"MTR\"     #> [43] \"CHL\"     \"COL\"     \"MUP\"     \"RIF\"     colnames(set_ab_names(example_isolates)) #>  [1] \"date\"                          \"patient\"                       #>  [3] \"age\"                           \"gender\"                        #>  [5] \"ward\"                          \"mo\"                            #>  [7] \"benzylpenicillin\"              \"oxacillin\"                     #>  [9] \"flucloxacillin\"                \"amoxicillin\"                   #> [11] \"amoxicillin_clavulanic_acid\"   \"ampicillin\"                    #> [13] \"piperacillin_tazobactam\"       \"cefazolin\"                     #> [15] \"cefepime\"                      \"cefuroxime\"                    #> [17] \"cefoxitin\"                     \"cefotaxime\"                    #> [19] \"ceftazidime\"                   \"ceftriaxone\"                   #> [21] \"gentamicin\"                    \"tobramycin\"                    #> [23] \"amikacin\"                      \"kanamycin\"                     #> [25] \"trimethoprim\"                  \"trimethoprim_sulfamethoxazole\" #> [27] \"nitrofurantoin\"                \"fosfomycin\"                    #> [29] \"linezolid\"                     \"ciprofloxacin\"                 #> [31] \"moxifloxacin\"                  \"vancomycin\"                    #> [33] \"teicoplanin\"                   \"tetracycline\"                  #> [35] \"tigecycline\"                   \"doxycycline\"                   #> [37] \"erythromycin\"                  \"clindamycin\"                   #> [39] \"azithromycin\"                  \"imipenem\"                      #> [41] \"meropenem\"                     \"metronidazole\"                 #> [43] \"chloramphenicol\"               \"colistin\"                      #> [45] \"mupirocin\"                     \"rifampicin\"                    colnames(set_ab_names(example_isolates, NIT:VAN)) #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     set_ab_names()    # this does the same:   example_isolates %>%     rename_with(set_ab_names)    # set_ab_names() works with any AB property:   example_isolates %>%     set_ab_names(property = \"atc\")    example_isolates %>%     set_ab_names(where(is.sir)) %>%     colnames()    example_isolates %>%     set_ab_names(NIT:VAN) %>%     colnames() } #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics data set, least containing columns \"ab\" \"name\"","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics 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://msberends.github.io/AMR/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 NA and throws a warning (which is suppressed here): suppressWarnings(   as.ab(\"testab\") ) #> Class 'ab' #> [1] <NA>  # 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     # 'antibiotics' data set, such as 'group':     group = \"Test Group\"   ) ) #> ℹ Added one record to the internal antibiotics 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 antibiotics data set. ab_atc(\"Co-fluampicil\") #> [1] \"J01CR50\" ab_name(\"J01CR50\") #> [1] \"Co-fluampicil\"  # even antibiotic selectors work 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 cloacae cloacae\"  # 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/\" #>  #> $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, 2024\" #>  #> $snomed #> [1] NA #>  #> $lpsn #> [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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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  1965-12-05  58  58.45628         34 #> 2  1980-03-01  44  44.21858         19 #> 3  1949-11-01  74  74.54918         50 #> 4  1947-02-14  77  77.26230         52 #> 5  1940-02-19  84  84.24863         59 #> 6  1988-01-10  36  36.35792         11 #> 7  1997-08-27  26  26.72951          2 #> 8  1978-01-26  46  46.31421         21 #> 9  1972-06-17  51  51.92350         27 #> 10 1986-08-10  37  37.77596         13"},{"path":"https://msberends.github.io/AMR/reference/age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Split Ages into Age Groups — age_groups","title":"Split Ages into Age Groups — age_groups","text":"Split ages age groups defined split argument. allows easier demographic (antimicrobial resistance) analysis.","code":""},{"path":"https://msberends.github.io/AMR/reference/age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split Ages into Age Groups — age_groups","text":"","code":"age_groups(x, split_at = c(12, 25, 55, 75), na.rm = FALSE)"},{"path":"https://msberends.github.io/AMR/reference/age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split Ages into Age Groups — age_groups","text":"x age, e.g. calculated age() split_at values split x - default age groups 0-11, 12-24, 25-54, 55-74 75+. See Details. na.rm logical indicate whether missing values removed","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/age_groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split Ages into Age Groups — age_groups","text":"","code":"ages <- c(3, 8, 16, 54, 31, 76, 101, 43, 21)  # split into 0-49 and 50+ age_groups(ages, 50) #> [1] 0-49 0-49 0-49 50+  0-49 50+  50+  0-49 0-49 #> Levels: 0-49 < 50+  # split into 0-19, 20-49 and 50+ age_groups(ages, c(20, 50)) #> [1] 0-19  0-19  0-19  50+   20-49 50+   50+   20-49 20-49 #> Levels: 0-19 < 20-49 < 50+  # split into groups of ten years age_groups(ages, 1:10 * 10) #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+ age_groups(ages, split_at = \"tens\") #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+  # split into groups of five years age_groups(ages, 1:20 * 5) #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+ age_groups(ages, split_at = \"fives\") #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+  # split specifically for children age_groups(ages, c(1, 2, 4, 6, 13, 18)) #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+ age_groups(ages, \"children\") #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+  # \\donttest{ # resistance of ciprofloxacin per age group if (require(\"dplyr\") && require(\"ggplot2\")) {   example_isolates %>%     filter_first_isolate() %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(       x = \"age_group\",       minimum = 0,       x.title = \"Age Group\",       title = \"Ciprofloxacin resistance per age group\"     ) } #> Loading required package: ggplot2  # }"},{"path":"https://msberends.github.io/AMR/reference/antibiogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"Generate antibiogram, communicate results plots tables. functions follow logic Klinker et al. Barbieri et al. (see Source), allow reporting e.g. R Markdown Quarto well.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"","code":"antibiogram(   x,   antibiotics = where(is.sir),   mo_transform = \"shortname\",   ab_transform = NULL,   syndromic_group = NULL,   add_total_n = TRUE,   only_all_tested = FALSE,   digits = 0,   col_mo = NULL,   language = get_AMR_locale(),   minimum = 30,   combine_SI = TRUE,   sep = \" + \",   info = interactive() )  # S3 method for antibiogram plot(x, ...)  # S3 method for antibiogram autoplot(object, ...)  # S3 method for antibiogram knit_print(   x,   italicise = TRUE,   na = getOption(\"knitr.kable.NA\", default = \"\"),   ... )"},{"path":"https://msberends.github.io/AMR/reference/antibiogram.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"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://msberends.github.io/AMR/reference/antibiogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"x data.frame containing least column microorganisms columns antibiotic results (class 'sir', see .sir()) antibiotics vector antibiotic name code (evaluated .ab(), column name x, (combinations ) antibiotic selectors aminoglycosides() carbapenems(). combination antibiograms, can also set values separated \"+\", \"TZP+TOB\" \"cipro + genta\", given columns resembling antibiotics exist x. See Examples. mo_transform character transform microorganism input - must \"name\", \"shortname\", \"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\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Can also NULL transform input. ab_transform character transform antibiotic input - must one column names antibiotics data set: \"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 logical indicate whether total available numbers per pathogen added table (default TRUE). add lowest highest number available isolate per antibiotic (e.g, E. coli 200 isolates available ciprofloxacin 150 amoxicillin, returned number \"150-200\"). only_all_tested (combination antibiograms): logical indicate isolates must tested antibiotics, see Details digits number digits use rounding 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 , instead S (default TRUE) sep separating character antibiotic columns combination antibiograms info logical indicate info printed - default TRUE interactive mode ... used R Markdown Quarto: arguments passed knitr::kable() (otherwise, use) 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://msberends.github.io/AMR/reference/antibiogram.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"function returns table values 0 100 susceptibility, resistance. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine data set one four available algorithms. types antibiograms listed can plotted (using ggplot2::autoplot() base R plot()/barplot()). antibiogram object 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://msberends.github.io/AMR/reference/antibiogram.html","id":"antibiogram-types","dir":"Reference","previous_headings":"","what":"Antibiogram Types","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — antibiogram","text":"four antibiogram types, proposed Klinker et al. (2021, doi:10.1177/20499361211011373 ), supported antibiogram(): 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) Case example: Susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure Code example:   Note combination antibiograms, important realise susceptibility can calculated two ways, can set only_all_tested argument (default FALSE). See example two antibiotics, Drug Drug B, antibiogram() works calculate %SI:","code":"antibiogram(your_data,             antibiotics = \"TZP\") antibiogram(your_data,             antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\")) antibiogram(your_data,             antibiotics = penicillins(),             syndromic_group = \"ward\") library(dplyr) your_data %>%   filter(ward == \"ICU\" & specimen_type == \"Respiratory\") %>%   antibiogram(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),               syndromic_group = ifelse(.$age >= 65 &                                          .$gender == \"Male\" &                                          .$condition == \"Heart Disease\",                                        \"Study Group\", \"Control Group\")) --------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   include as  include as   include as  include as                     numerator   denominator  numerator   denominator --------  --------  ----------  -----------  ----------  -----------  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://msberends.github.io/AMR/reference/antibiogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate Antibiogram: Traditional, Combined, Syndromic, or Weighted-Incidence Syndromic Combination (WISCA) — 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,   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) #> # A tibble: 10 × 7 #>    `Pathogen (N min-max)`   AMK   GEN   IPM   KAN   MEM   TOB #>  * <chr>                  <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #>  1 CoNS (43-309)              0    86    52     0    52    22 #>  2 E. coli (0-462)          100    98   100    NA   100    97 #>  3 E. faecalis (0-39)         0     0   100     0    NA     0 #>  4 K. pneumoniae (0-58)      NA    90   100    NA   100    90 #>  5 P. aeruginosa (17-30)     NA   100    NA     0    NA   100 #>  6 P. mirabilis (0-34)       NA    94    94    NA    NA    94 #>  7 S. aureus (2-233)         NA    99    NA    NA    NA    98 #>  8 S. epidermidis (8-163)     0    79    NA     0    NA    51 #>  9 S. hominis (3-80)         NA    92    NA    NA    NA    85 #> 10 S. pneumoniae (11-117)     0     0    NA     0    NA     0  antibiogram(example_isolates,   antibiotics = aminoglycosides(),   ab_transform = \"atc\",   mo_transform = \"gramstain\" ) #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 2 × 5 #>   `Pathogen (N min-max)`   J01GB01 J01GB03 J01GB04 J01GB06 #> * <chr>                      <dbl>   <dbl>   <dbl>   <dbl> #> 1 Gram-negative (35-686)        96      96       0      98 #> 2 Gram-positive (436-1170)      34      63       0       0  antibiogram(example_isolates,   antibiotics = carbapenems(),   ab_transform = \"name\",   mo_transform = \"name\" ) #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 5 × 3 #>   `Pathogen (N min-max)`                           Imipenem Meropenem #> * <chr>                                               <dbl>     <dbl> #> 1 Coagulase-negative Staphylococcus (CoNS) (48-48)       52        52 #> 2 Enterococcus faecalis (0-38)                          100        NA #> 3 Escherichia coli (418-422)                            100       100 #> 4 Klebsiella pneumoniae (51-53)                         100       100 #> 5 Proteus mirabilis (27-32)                              94        NA   # Combined antibiogram -------------------------------------------------  # combined antibiotics yield higher empiric coverage antibiogram(example_isolates,   antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   mo_transform = \"gramstain\" ) #> # A tibble: 2 × 4 #>   `Pathogen (N min-max)`     TZP `TZP + GEN` `TZP + TOB` #> * <chr>                    <dbl>       <dbl>       <dbl> #> 1 Gram-negative (641-693)     88          99          98 #> 2 Gram-positive (345-1044)    86          98          95  # names of antibiotics do not need to resemble columns exactly: antibiogram(example_isolates,   antibiotics = c(\"Cipro\", \"cipro + genta\"),   mo_transform = \"gramstain\",   ab_transform = \"name\",   sep = \" & \" ) #> # A tibble: 2 × 3 #>   `Pathogen (N min-max)`  Ciprofloxacin `Ciprofloxacin & Gentamicin` #> * <chr>                           <dbl>                        <dbl> #> 1 Gram-negative (684-694)            91                           99 #> 2 Gram-positive (724-847)            77                           93   # Syndromic antibiogram ------------------------------------------------  # the data set could contain a filter for e.g. respiratory specimens 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) #> # A tibble: 14 × 8 #>    `Syndromic Group` `Pathogen (N min-max)`   AMK   GEN   IPM   KAN   MEM   TOB #>  * <chr>             <chr>                  <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #>  1 Clinical          CoNS (23-205)             NA    89    57    NA    57    26 #>  2 ICU               CoNS (10-73)              NA    79    NA    NA    NA    NA #>  3 Outpatient        CoNS (3-31)               NA    84    NA    NA    NA    NA #>  4 Clinical          E. coli (0-299)          100    98   100    NA   100    98 #>  5 ICU               E. coli (0-137)          100    99   100    NA   100    96 #>  6 Clinical          K. pneumoniae (0-51)      NA    92   100    NA   100    92 #>  7 Clinical          P. mirabilis (0-30)       NA   100    NA    NA    NA   100 #>  8 Clinical          S. aureus (2-150)         NA    99    NA    NA    NA    97 #>  9 ICU               S. aureus (0-66)          NA   100    NA    NA    NA    NA #> 10 Clinical          S. epidermidis (4-79)     NA    82    NA    NA    NA    55 #> 11 ICU               S. epidermidis (4-75)     NA    72    NA    NA    NA    41 #> 12 Clinical          S. hominis (1-45)         NA    96    NA    NA    NA    94 #> 13 Clinical          S. pneumoniae (5-78)       0     0    NA     0    NA     0 #> 14 ICU               S. pneumoniae (5-30)       0     0    NA     0    NA     0  # 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,   antibiotics = 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) #> # A tibble: 2 × 5 #>   `Grupo sindrómico` `Patógeno (N min-max)` Amikacina Gentamicina Tobramicina #> * <chr>              <chr>                      <dbl>       <dbl>       <dbl> #> 1 No UCI             E. coli (0-325)              100          98          98 #> 2 UCI                E. coli (0-137)              100          99          96   # Weighted-incidence syndromic combination antibiogram (WISCA) ---------  # the data set could contain a filter for e.g. respiratory specimens/ICU antibiogram(example_isolates,   antibiotics = c(\"AMC\", \"AMC+CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\",   minimum = 10, # this should be >=30, but now just as example   syndromic_group = ifelse(example_isolates$age >= 65 &     example_isolates$gender == \"M\",   \"WISCA Group 1\", \"WISCA Group 2\"   ) ) #> # A tibble: 4 × 6 #>   `Syndromic Group` `Pathogen (N min-max)`    AMC `AMC + CIP`   TZP `TZP + TOB` #> * <chr>             <chr>                   <dbl>       <dbl> <dbl>       <dbl> #> 1 WISCA Group 1     Gram-negative (261-285)    76          95    89          99 #> 2 WISCA Group 2     Gram-negative (380-442)    76          98    88          98 #> 3 WISCA Group 1     Gram-positive (123-406)    76          89    81          95 #> 4 WISCA Group 2     Gram-positive (222-732)    76          89    88          95   # Print the output for R Markdown / Quarto -----------------------------  ureido <- antibiogram(example_isolates,   antibiotics = ureidopenicillins(),   ab_transform = \"name\" ) #> ℹ 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)) } #>  #>  #> |Pathogen (N)          | Piperacillin/tazobactam| #> |:---------------------|-----------------------:| #> |CoNS (33)             |                      30| #> |*E. coli* (416)       |                      94| #> |*K. pneumoniae* (53)  |                      89| #> |*S. pneumoniae* (112) |                     100|   # Generate plots with ggplot2 or base R --------------------------------  ab1 <- antibiogram(example_isolates,   antibiotics = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\" ) ab2 <- antibiogram(example_isolates,   antibiotics = 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://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":null,"dir":"Reference","previous_headings":"","what":"Antibiotic Selectors — antibiotic_class_selectors","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"functions allow filtering rows selecting columns based antibiotic test results specific antibiotic class group (according antibiotics data set), without need define columns antibiotic abbreviations. short, column name resembles antimicrobial drug, picked functions matches pharmaceutical class: \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" picked cephalosporins().","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"","code":"ab_class(ab_class, only_sir_columns = FALSE, only_treatable = TRUE, ...)  ab_selector(filter, only_sir_columns = FALSE, only_treatable = TRUE, ...)  aminoglycosides(only_sir_columns = FALSE, only_treatable = TRUE, ...)  aminopenicillins(only_sir_columns = FALSE, ...)  antifungals(only_sir_columns = FALSE, ...)  antimycobacterials(only_sir_columns = FALSE, ...)  betalactams(only_sir_columns = FALSE, only_treatable = TRUE, ...)  carbapenems(only_sir_columns = FALSE, only_treatable = TRUE, ...)  cephalosporins(only_sir_columns = FALSE, ...)  cephalosporins_1st(only_sir_columns = FALSE, ...)  cephalosporins_2nd(only_sir_columns = FALSE, ...)  cephalosporins_3rd(only_sir_columns = FALSE, ...)  cephalosporins_4th(only_sir_columns = FALSE, ...)  cephalosporins_5th(only_sir_columns = FALSE, ...)  fluoroquinolones(only_sir_columns = FALSE, ...)  glycopeptides(only_sir_columns = FALSE, ...)  lincosamides(only_sir_columns = FALSE, ...)  lipoglycopeptides(only_sir_columns = FALSE, ...)  macrolides(only_sir_columns = FALSE, ...)  oxazolidinones(only_sir_columns = FALSE, ...)  penicillins(only_sir_columns = FALSE, ...)  polymyxins(only_sir_columns = FALSE, only_treatable = TRUE, ...)  streptogramins(only_sir_columns = FALSE, ...)  quinolones(only_sir_columns = FALSE, ...)  tetracyclines(only_sir_columns = FALSE, ...)  trimethoprims(only_sir_columns = FALSE, ...)  ureidopenicillins(only_sir_columns = FALSE, ...)  administrable_per_os(only_sir_columns = FALSE, ...)  administrable_iv(only_sir_columns = FALSE, ...)  not_intrinsic_resistant(   only_sir_columns = FALSE,   col_mo = NULL,   version_expertrules = 3.3,   ... )"},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"ab_class antimicrobial class part , \"carba\" \"carbapenems\". columns group, atc_group1 atc_group2 antibiotics data set searched (case-insensitive) value. only_sir_columns logical indicate whether columns class sir must selected (default FALSE), see .sir() only_treatable logical indicate whether antimicrobial drugs excluded laboratory tests (default TRUE), gentamicin-high (GEH) imipenem/EDTA (IPE) ... ignored, place allow future extensions filter expression evaluated antibiotics data set, name %like% \"trim\" col_mo column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\".","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"(internally) character vector column names, additional class \"ab_selector\"","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Antibiotic Selectors — antibiotic_class_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. columns data functions called searched known antibiotic names, abbreviations, brand names, codes (ATC, EARS-Net, , etc.) according antibiotics data set. means selector aminoglycosides() pick column names like 'gen', 'genta', 'J01GB03', 'tobra', 'Tobracin', etc. ab_class() function can used filter/select manually defined antibiotic class. searches results antibiotics data set within columns group, atc_group1 atc_group2. ab_selector() function can used internally filter antibiotics 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. administrable_per_os() administrable_iv() functions also rely antibiotics data set - antibiotic columns matched DDD (defined daily dose) resp. oral IV treatment available antibiotics data set. not_intrinsic_resistant() function can used select antibiotic columns 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 Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021) determine intrinsic resistance, using eucast_rules() function internally. determination, function quite slow terms performance.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"full-list-of-supported-antibiotic-classes","dir":"Reference","previous_headings":"","what":"Full list of supported (antibiotic) classes","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"aminoglycosides() can select:  amikacin (AMK), amikacin/fosfomycin (AKF), amphotericin B-high (AMH), 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:  amphotericin B (AMB), anidulafungin (ANI), butoconazole (), caspofungin (CAS), ciclopirox (CIX), clotrimazole (CTR), econazole (ECO), fluconazole (FLU), flucytosine (FCT), fosfluconazole (FFL), griseofulvin (GRI), hachimycin (HCH), ibrexafungerp (IBX), isavuconazole (ISV), isoconazole (ISO), itraconazole (ITR), ketoconazole (KET), manogepix (MGX), micafungin (MIF), miconazole (MCZ), nystatin (NYS), oteseconazole (OTE), pimaricin (PMR), posaconazole (POS), rezafungin (RZF), ribociclib (RBC), sulconazole (SUC), terbinafine (TRB), terconazole (TRC), voriconazole (VOR) antimycobacterials() can select:  4-aminosalicylic acid (AMA), calcium aminosalicylate (CLA), capreomycin (CAP), clofazimine (CLF), delamanid (DLM), enviomycin (ENV), ethambutol (ETH), ethambutol/isoniazid (ETI), ethionamide (ETI1), isoniazid (INH), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), morinamide (MRN), p-aminosalicylic acid (PAS), pretomanid (PMD), protionamide (PTH), pyrazinamide (PZA), rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP), simvastatin/fenofibrate (SMF), sodium aminosalicylate (SDA), streptomycin/isoniazid (STI), terizidone (TRZ), thioacetazone (TAT), thioacetazone/isoniazid (THI1), tiocarlide (TCR), viomycin (VIO) betalactams() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), avibactam (AVB), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), biapenem (BIA), carbenicillin (CRB), carindacillin (CRN), 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/clavulanic acid (CPC), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening (FOX1), 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), nacubactam (NAC), nafcillin (NAF), oxacillin (OXA), 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), sulbactam (SUL), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tazobactam (TAZ), tebipenem (TBP), temocillin (TEM), ticarcillin (TIC), 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/clavulanic acid (CPC), cefepime/tazobactam (FPT), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening (FOX1), 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 (FOX1), 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/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/clavulanic acid (CPC), cefepime/tazobactam (FPT), 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), 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), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nifuroquine (NIF), norfloxacin (), ofloxacin (OFX), orbifloxacin (ORB), pazufloxacin (PAZ), pefloxacin (PEF), 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), dalbavancin (DAL), norvancomycin (NVA), oritavancin (ORI), ramoplanin (RAM), teicoplanin (TEC), teicoplanin-macromethod (TCM), telavancin (TLV), vancomycin (VAN), vancomycin-macromethod (VAM) lincosamides() can select:  acetylmidecamycin (ACM), acetylspiramycin (ASP), clindamycin (CLI), gamithromycin (GAM), kitasamycin (KIT), lincomycin (LIN), meleumycin (MEL), nafithromycin (ZWK), pirlimycin (PRL), primycin (PRM), solithromycin (SOL), tildipirosin (TIP), tilmicosin (TIL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) 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), pirlimycin (PRL), primycin (PRM), rokitamycin (ROK), roxithromycin (RXT), solithromycin (SOL), spiramycin (SPI), telithromycin (TLT), tildipirosin (TIP), tilmicosin (TIL), troleandomycin (TRL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) 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), avibactam (AVB), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), carbenicillin (CRB), carindacillin (CRN), cefepime/nacubactam (FNC), 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), nacubactam (NAC), nafcillin (NAF), oxacillin (OXA), 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), sulbactam (SUL), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tazobactam (TAZ), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC) polymyxins() can select:  colistin (COL), polymyxin B (PLB), polymyxin B/polysorbate 80 (POP) quinolones() can select:  besifloxacin (BES), cinoxacin (CIN), ciprofloxacin (CIP), 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), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nalidixic acid (NAL), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), ofloxacin (OFX), orbifloxacin (ORB), oxolinic acid (OXO), pazufloxacin (PAZ), pefloxacin (PEF), 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) streptogramins() can select:  pristinamycin (PRI) quinupristin/dalfopristin (QDA) 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), 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://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Antibiotic Selectors — antibiotic_class_selectors","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotic_class_selectors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Antibiotic Selectors — antibiotic_class_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>, …   # Examples sections below are split into 'base R', 'dplyr', and 'data.table':   # 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 antibiotic columns 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 antibiotic 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  # ab_selector() applies a filter in the `antibiotics` data set and is thus # very flexible. For instance, to select antibiotic columns with an oral DDD # of at least 1 gram: example_isolates[, ab_selector(oral_ddd > 1 & oral_units == \"g\")] #> ℹ For ab_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  # \\donttest{ # dplyr -------------------------------------------------------------------  if (require(\"dplyr\")) {   tibble(kefzol = random_sir(5)) %>%     select(cephalosporins()) } #> ℹ For cephalosporins() using column 'kefzol' (cefazolin) #> # A tibble: 5 × 1 #>   kefzol #>   <sir>  #> 1 S      #> 2 R      #> 3 S      #> 4 S      #> 5 I       if (require(\"dplyr\")) {   # get AMR for all aminoglycosides e.g., per ward:   example_isolates %>%     group_by(ward) %>%     summarise(across(aminoglycosides(), resistance)) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `across(aminoglycosides(), resistance)`. #> ℹ 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 × 5 #>   ward         GEN   TOB   AMK   KAN #>   <chr>      <dbl> <dbl> <dbl> <dbl> #> 1 Clinical   0.229 0.315 0.626     1 #> 2 ICU        0.290 0.400 0.662     1 #> 3 Outpatient 0.2   0.368 0.605    NA if (require(\"dplyr\")) {   # You can combine selectors with '&' to be more specific:   example_isolates %>%     select(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 if (require(\"dplyr\")) {   # get AMR for only drugs that matter - no intrinsic resistance:   example_isolates %>%     filter(mo_genus() %in% c(\"Escherichia\", \"Klebsiella\")) %>%     group_by(ward) %>%     summarise(across(not_intrinsic_resistant(), resistance)) } #> ℹ Using column 'mo' as input for mo_genus() #> ℹ For not_intrinsic_resistant() removing columns 'PEN' #>   (benzylpenicillin), 'LNZ' (linezolid), 'VAN' (vancomycin), 'TEC' #>   (teicoplanin), 'ERY' (erythromycin), 'CLI' (clindamycin), 'AZM' #>   (azithromycin), and 'RIF' (rifampicin) #> Warning: There were 52 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `across(not_intrinsic_resistant(), resistance)`. #> ℹ In group 1: `ward = \"Clinical\"`. #> Caused by warning: #> ! Introducing NA: no results available for OXA in group: ward = \"Clinical\" #> (minimum = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 51 remaining warnings. #> # A tibble: 3 × 33 #>   ward    OXA   FLC    AMX    AMC    AMP     TZP     CZO     FEP     CXM     FOX #>   <chr> <dbl> <dbl>  <dbl>  <dbl>  <dbl>   <dbl>   <dbl>   <dbl>   <dbl>   <dbl> #> 1 Clin…    NA    NA  0.606  0.121  0.606  0.0504  0.0656  0.0159  0.0622  0.0648 #> 2 ICU      NA    NA  0.535  0.172  0.535  0.119  NA       0.0722  0.0828  0.0992 #> 3 Outp…    NA    NA NA     NA     NA     NA      NA      NA      NA      NA      #> # ℹ 22 more variables: CTX <dbl>, CAZ <dbl>, CRO <dbl>, GEN <dbl>, TOB <dbl>, #> #   AMK <dbl>, KAN <dbl>, TMP <dbl>, SXT <dbl>, NIT <dbl>, FOS <dbl>, #> #   CIP <dbl>, MFX <dbl>, TCY <dbl>, TGC <dbl>, DOX <dbl>, IPM <dbl>, #> #   MEM <dbl>, MTR <dbl>, CHL <dbl>, COL <dbl>, MUP <dbl> if (require(\"dplyr\")) {   # get susceptibility for antibiotics whose name contains \"trim\":   example_isolates %>%     filter(first_isolate()) %>%     group_by(ward) %>%     summarise(across(ab_selector(name %like% \"trim\"), susceptibility)) } #> ℹ For ab_selector(name %like% \"trim\") using columns 'TMP' (trimethoprim) #>   and 'SXT' (trimethoprim/sulfamethoxazole) #> # A tibble: 3 × 3 #>   ward         TMP   SXT #>   <chr>      <dbl> <dbl> #> 1 Clinical   0.627 0.807 #> 2 ICU        0.551 0.780 #> 3 Outpatient 0.667 0.821 if (require(\"dplyr\")) {   # this will select columns 'IPM' (imipenem) and 'MEM' (meropenem):   example_isolates %>%     select(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 if (require(\"dplyr\")) {   # this will select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB':   example_isolates %>%     select(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 if (require(\"dplyr\")) {   # any() and all() work in dplyr's filter() too:   example_isolates %>%     filter(       any(aminoglycosides() == \"R\"),       all(cephalosporins_2nd() == \"R\")     ) } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For cephalosporins_2nd() using columns 'CXM' (cefuroxime) and 'FOX' #>   (cefoxitin) #> # A tibble: 112 × 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-03-16 4FC193     69 M      Clinical B_PSDMN_AERG R     NA    NA    R     #>  3 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS NA    NA    NA    NA    #>  4 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS NA    NA    NA    NA    #>  5 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS NA    NA    NA    NA    #>  6 2002-07-21 955940     82 F      Clinical B_PSDMN_AERG R     NA    NA    R     #>  7 2002-07-21 955940     82 F      Clinical B_PSDMN_AERG 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_FCLS NA    NA    NA    NA    #> 10 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM NA    NA    NA    NA    #> # ℹ 102 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\")) {   # also works with c():   example_isolates %>%     filter(any(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: 531 × 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-03-16 4FC193     69 M      Clinical B_PSDMN_AERG R     NA    NA    R     #>  3 2002-03-17 B30560     78 M      Clinical B_STPHY_CONS R     NA    R     R     #>  4 2002-04-04 E61143     67 M      Clinical B_STRPT_SNGN S     NA    NA    S     #>  5 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS NA    NA    NA    NA    #>  6 2002-04-14 F30196     73 M      Outpati… B_STRPT_GRPB S     NA    S     S     #>  7 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  8 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  9 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #> 10 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #> # ℹ 521 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\")) {   # not setting any/all will automatically apply all():   example_isolates %>%     filter(aminoglycosides() == \"R\") } #> ℹ For aminoglycosides() using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ Assuming a filter on all 4 aminoglycosides. Wrap around all() or #>   any() to prevent this note. #> # A tibble: 427 × 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-03-17 B30560     78 M      Clinical B_STPHY_CONS R     NA    R     R     #>  3 2002-04-04 E61143     67 M      Clinical B_STRPT_SNGN S     NA    NA    S     #>  4 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS NA    NA    NA    NA    #>  5 2002-04-14 F30196     73 M      Outpati… B_STRPT_GRPB S     NA    S     S     #>  6 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  7 2002-05-07 D91570     83 M      Clinical B_STPHY_CONS R     NA    R     R     #>  8 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #>  9 2002-05-14 077552     86 F      Clinical B_STRPT_PNMN S     NA    NA    S     #> 10 2002-05-16 D25302     65 F      ICU      B_STRPT_ANGN S     NA    NA    S     #> # ℹ 417 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\")) {   # this will select columns 'mo' and all antimycobacterial drugs ('RIF'):   example_isolates %>%     select(mo, ab_class(\"mycobact\")) } #> ℹ For ab_class(\"mycobact\") using column 'RIF' (rifampicin) #> # A tibble: 2,000 × 2 #>    mo           RIF   #>    <mo>         <sir> #>  1 B_ESCHR_COLI R     #>  2 B_ESCHR_COLI R     #>  3 B_STPHY_EPDR NA    #>  4 B_STPHY_EPDR NA    #>  5 B_STPHY_EPDR NA    #>  6 B_STPHY_EPDR NA    #>  7 B_STPHY_AURS NA    #>  8 B_STPHY_AURS NA    #>  9 B_STPHY_EPDR NA    #> 10 B_STPHY_EPDR NA    #> # ℹ 1,990 more rows if (require(\"dplyr\")) {   # get bug/drug combinations for only glycopeptides in Gram-positives:   example_isolates %>%     filter(mo_is_gram_positive()) %>%     select(mo, glycopeptides()) %>%     bug_drug_combinations() %>%     format() } #> ℹ Using column 'mo' as input for mo_is_gram_positive() #> ℹ For glycopeptides() using columns 'VAN' (vancomycin) and 'TEC' #>   (teicoplanin) #> # A tibble: 2 × 8 #>   Group      Drug  CoNS  `E. faecalis` `S. aureus` `S. epidermidis` `S. hominis` #>   <chr>      <chr> <chr> <chr>         <chr>       <chr>            <chr>        #> 1 \"Glycopep… Teic… \"\"    \"\"            \" 0.0% (0/… \"64.1% (25/39)\"  \" 6.8% (4/5… #> 2 \"\"         Vanc… \" 0.… \" 0.0% (0/39… \" 0.0% (0/… \" 0.0% (0/171)\"  \" 0.0% (0/8… #> # ℹ 1 more variable: `S. pneumoniae` <chr> if (require(\"dplyr\")) {   data.frame(     some_column = \"some_value\",     J01CA01 = \"S\"   ) %>% # ATC code of ampicillin     select(penicillins()) # only the 'J01CA01' column will be selected } #> ℹ For penicillins() using column 'J01CA01' (ampicillin) #>   J01CA01 #> 1       S if (require(\"dplyr\")) {   # 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) } #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Assuming a filter on all 2 carbapenems. Wrap around all() or any() to #>   prevent this note. #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Assuming a filter on all 2 carbapenems. Wrap around all() or any() to #>   prevent this note. #> ℹ For carbapenems() using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> [1] TRUE   # 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) #> [1] \"IPM\" \"MEM\" #> attr(,\"class\") #> [1] \"ab_selector\" \"character\"   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://msberends.github.io/AMR/reference/antibiotics.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Sets with 603 Antimicrobial Drugs — antibiotics","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"Two data sets containing antibiotics/antimycotics antivirals. Use .ab() one ab_* functions retrieve values antibiotics data set. Three identifiers included data set: antibiotic ID (ab, primarily used package) defined WHONET/EARS-Net, ATC code (atc) defined , Compound ID (cid) found PubChem. properties data set derived one codes. Note drugs multiple ATC codes.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"","code":"antibiotics  antivirals"},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"object class tbl_df (inherits tbl, data.frame) 120 rows 11 columns.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"for-the-antibiotics-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antibiotics data set: a tibble with 483 observations and 14 variables:","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"ab Antibiotic ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. cid Compound ID found PubChem. unique identifier. name Official name used WHONET/EARS-Net . unique identifier. group short concise group name, based WHONET WHOCC definitions atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, like J01CR02 atc_group1 Official pharmacological subgroup (3rd level ATC code) defined WHOCC, like \"Macrolides, lincosamides streptogramins\" atc_group2 Official chemical subgroup (4th level ATC code) defined WHOCC, like \"Macrolides\" abbr List abbreviations used many countries, also antibiotic susceptibility testing (AST) synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 179 drugs oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral (intravenous) treatment, currently available 153 drugs iv_units Units iv_ddd loinc codes associated name antimicrobial drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use ab_loinc() retrieve quickly, see ab_property().","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.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 603 Antimicrobial Drugs — antibiotics","text":"av Antiviral ID used package (ACI), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. Combinations codes contain + indicate , ATA+COBI atazanavir/cobicistat. name Official name used WHONET/EARS-Net . unique identifier. atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC cid Compound ID found PubChem. unique identifier. atc_group Official pharmacological subgroup (3rd level ATC code) defined WHOCC synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral treatment iv_units Units iv_ddd loinc codes associated name antiviral drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use av_loinc() retrieve quickly, see av_property().","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology (WHOCC): https://atcddd.fhi./atc_ddd_index/ Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Accessed https://loinc.org October 19th, 2023. European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"direct-download","dir":"Reference","previous_headings":"","what":"Direct download","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"Like data sets package, data sets publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/antibiotics.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","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://msberends.github.io/AMR/reference/antibiotics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Sets with 603 Antimicrobial Drugs — antibiotics","text":"","code":"antibiotics #> # A tibble: 483 × 14 #>    ab        cid name   group atc   atc_group1 atc_group2 abbreviations synonyms #>    <ab>    <dbl> <chr>  <chr> <lis> <chr>      <chr>      <list>        <named > #>  1 AMA      4649 4-ami… Anti… <chr> Drugs for… Aminosali… <chr [1]>     <chr>    #>  2 ACM   6450012 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  3 ASP  49787020 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  4 ALS      8954 Aldes… Othe… <chr> Drugs for… Drugs for… <chr [1]>     <chr>    #>  5 AMK     37768 Amika… Amin… <chr> Aminoglyc… Other ami… <chr [5]>     <chr>    #>  6 AKF        NA Amika… Amin… <chr> NA         NA         <chr [1]>     <chr>    #>  7 AMX     33613 Amoxi… Beta… <chr> Beta-lact… Penicilli… <chr [3]>     <chr>    #>  8 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [5]>     <chr>    #>  9 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> 10 AMB   5280965 Ampho… Anti… <chr> Antimycot… Antibioti… <chr [3]>     <chr>    #> # ℹ 473 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://msberends.github.io/AMR/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 antibiotic drug code one antibiotics. data set antibiotics searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://msberends.github.io/AMR/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, info = interactive(), ...)  is.ab(x)"},{"path":"https://msberends.github.io/AMR/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. info logical indicate whether progress bar printed - default TRUE interactive mode ... arguments passed internal functions","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/as.ab.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antibiotic ID — as.ab","text":"entries antibiotics 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/as.ab.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Transform Input to an Antibiotic ID — as.ab","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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 123\") #> Class 'ab' #> [1] ERY as.ab(\"ERYT\") #> Class 'ab' #> [1] ERY as.ab(\"ERY\") #> Class 'ab' #> [1] ERY as.ab(\"eritromicine\") # spelled wrong, yet works #> Class 'ab' #> [1] ERY as.ab(\"Erythrocin\") # trade name #> Class 'ab' #> [1] ERY as.ab(\"Romycin\") # trade name #> Class 'ab' #> [1] ERY  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  # use ab_* functions to get a specific properties (see ?ab_property); # they use as.ab() internally: ab_name(\"J01FA01\") #> [1] \"Erythromycin\" ab_name(\"eryt\") #> [1] \"Erythromycin\"  # \\donttest{ if (require(\"dplyr\")) {   # you can quickly rename 'sir' columns using set_ab_names() with dplyr:   example_isolates %>%     set_ab_names(where(is.sir), property = \"atc\") } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           J01CE01 J01CF04 J01CF05 #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir>   <sir>   <sir>   #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R       NA      NA      #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R       NA      NA      #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R       NA      S       #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R       NA      S       #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R       NA      R       #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R       NA      S       #> # ℹ 1,990 more rows #> # ℹ 37 more variables: J01CA04 <sir>, J01CR02 <sir>, J01CA01 <sir>, #> #   J01CR05 <sir>, J01DB04 <sir>, J01DE01 <sir>, J01DC02 <sir>, J01DC01 <sir>, #> #   J01DD01 <sir>, J01DD02 <sir>, J01DD04 <sir>, J01GB03 <sir>, J01GB01 <sir>, #> #   J01GB06 <sir>, J01GB04 <sir>, J01EA01 <sir>, J01EE01 <sir>, J01XE01 <sir>, #> #   J01XX01 <sir>, J01XX08 <sir>, J01MA02 <sir>, J01MA14 <sir>, J01XA01 <sir>, #> #   J01XA02 <sir>, J01AA07 <sir>, J01AA12 <sir>, J01AA02 <sir>, … # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/as.av.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Transform Input to an Antiviral Drug ID — as.av","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 6 50.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 6 50 millimetres. Values higher 50 lower 100 maximised 50. others input values outside 6-50 range return NA. NA_disk_ missing value new disk class.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/as.disk.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"# transform existing disk zones to the `disk` class (using base R) df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = 20,   CIP = 14,   GEN = 18,   TOB = 16 ) df[, 2:5] <- lapply(df[, 2:5], as.disk) str(df) #> 'data.frame':\t1 obs. of  5 variables: #>  $ microorganism: chr \"Escherichia coli\" #>  $ AMP          : 'disk' int 20 #>  $ CIP          : 'disk' int 14 #>  $ GEN          : 'disk' int 18 #>  $ TOB          : 'disk' int 16  # \\donttest{ # transforming is easier with dplyr: if (require(\"dplyr\")) {   df %>% mutate(across(AMP:TOB, as.disk)) } #>      microorganism AMP CIP GEN TOB #> 1 Escherichia coli  20  14  18  16 # }  # interpret disk values, see ?as.sir as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting disk diffusion zones: 'ampicillin' (AMP) (AMP, ampicillin), #> EUCAST 2023... #>  OK  #> Class 'sir' #> [1] R  # interpret whole data set, pretend to be all from urinary tract infections: as.sir(df, uti = TRUE) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting disk diffusion zones: column 'AMP', EUCAST 2023... #>  OK  #> Interpreting disk diffusion zones: column 'CIP', EUCAST 2023... #>  OK  #> Interpreting disk diffusion zones: column 'GEN', EUCAST 2023... #>  OK  #> Interpreting disk diffusion zones: column 'TOB', EUCAST 2023... #>  OK  #>      microorganism AMP  CIP GEN TOB #> 1 Escherichia coli   S <NA>   S   S"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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_  limit_mic_range(x, mic_range, keep_operators = \"edges\", as.mic = TRUE)  # S3 method for mic droplevels(x, as.mic = FALSE, ...)"},{"path":"https://msberends.github.io/AMR/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 limit MIC values, e.g., mic_range = c(0.001, 32). Use NA set limit one side, e.g., mic_range = c(NA, 32). .mic logical indicate whether mic class kept - default FALSE ... arguments passed methods","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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-2023) CLSI (2011-2023). 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()). functions stats package 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). Use droplevels() drop unused levels. default, return plain factor. Use droplevels(..., .mic = TRUE) maintain mic class. limit_mic_range(), 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_.","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://msberends.github.io/AMR/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  # limit MICs using limit_mic_range() limit_mic_range(mic_data, mic_range = c(4, 16)) #> Class 'mic' #> [1] >=16 <=4  <=4  <=4  8    <=4  8    >=16 >=16  # interpret MIC values as.sir(   x = as.mic(2),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMX', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for amoxicillin (AMX) in Streptococcus #>      pneumoniae - assuming body site 'Meningitis'. #> Class 'sir' #> [1] R as.sir(   x = as.mic(c(0.01, 2, 4, 8)),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMX', EUCAST 2023... #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 4, 1  # plot MIC values, see ?plot plot(mic_data)  plot(mic_data, mo = \"E. coli\", ab = \"cipro\") #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 9, 1  if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\") } #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 9, 1 if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\", language = \"nl\") # Dutch } #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 9, 1"},{"path":"https://msberends.github.io/AMR/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, 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://msberends.github.io/AMR/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()),   language = get_AMR_locale(),   info = interactive(),   ... )  is.mo(x)  mo_uncertainties()  mo_renamed()  mo_failures()  mo_reset_session()  mo_cleaning_regex()"},{"path":"https://msberends.github.io/AMR/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. language language translate text like \"growth\", defaults system language (see get_AMR_locale()) info logical indicate progress bar printed 25 items coerced - default TRUE interactive mode ... arguments passed functions","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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' returned MO code UNKNOWN warning. Use mo_* functions get properties based returned code, see Examples. .mo() function uses novel matching score algorithm (see Matching Score Microorganisms ) match input available microbial taxonomy package. lead effect e.g. \"E. coli\" (microorganism highly prevalent humans) return microbial ID Escherichia coli Entamoeba coli (microorganism less prevalent humans), although latter alphabetically come first. Becker = TRUE, following 85 staphylococci converted coagulase-negative group: S. argensis, S. arlettae, S. auricularis, S. borealis, 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. 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. 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. following 16 staphylococci converted coagulase-positive group: 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. Lancefield = TRUE, following streptococci converted corresponding Lancefield group: S. agalactiae (Group B), S. anginosus anginosus (Group F), S. anginosus whileyi (Group F), S. anginosus (Group F), S. canis (Group G), S. dysgalactiae dysgalactiae (Group C), S. dysgalactiae equisimilis (Group C), S. dysgalactiae (Group C), S. equi equi (Group C), S. equi ruminatorum (Group C), S. equi zooepidemicus (Group C), S. equi (Group C), S. pyogenes (Group ), S. salivarius salivarius (Group K), S. salivarius thermophilus (Group K), S. salivarius (Group K), S. sanguinis (Group H).","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   \\----> taxonomic kingdom: A (Archaea), AN (Animalia), B (Bacteria),                             F (Fungi), PL (Plantae), P (Protozoa)"},{"path":"https://msberends.github.io/AMR/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 evaluate results mo_uncertainties(), returns data.frame specifications. increase quality matching, cleaning_regex argument can used clean input (.e., x). 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://msberends.github.io/AMR/reference/as.mo.html","id":"microbial-prevalence-of-pathogens-in-humans","dir":"Reference","previous_headings":"","what":"Microbial Prevalence of Pathogens in Humans","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"coercion rules consider prevalence microorganisms humans, available prevalence column microorganisms data set. grouping human pathogenic prevalence explained section Matching Score Microorganisms .","code":""},{"path":"https://msberends.github.io/AMR/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 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 Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571 Berends MS et al. (2022). Trends Occurrence Phenotypic Resistance Coagulase-Negative Staphylococci (CoNS) Found Human Blood Northern Netherlands 2013 2019/ Micro.rganisms 10(9), 1801; doi:10.3390/microorganisms10091801 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 December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org January 8th, 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 May 12th, 2023. 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://phinvads.cdc.gov Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://msberends.github.io/AMR/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 :  : \\(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, 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.0 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, genus present established list also prevalence = 1.0 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, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Conidiobolus, Contracaecum, Cordylobia, Cryptococcus, Curvularia, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Haloarcula, Halobacterium, Halococcus, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kodamaea, Leishmania, Lichtheimia, Lodderomyces, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Pediculus, Penicillium, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoterranova, Pulex, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saprochaete, Sarcoptes, Scedosporium, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporotrichum, Stachybotrys, Strongyloides, Syngamus, Taenia, Talaromyces, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Verticillium, Wuchereria; 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://msberends.github.io/AMR/reference/as.mo.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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- \\(\\)\\[\\]{}]+|([({]|\\[).+([})]|\\])|(^| )(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 Expert Rules' and #>   'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3 (2021). This note #>   will be shown once per session. #> [1] TRUE # }"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":null,"dir":"Reference","previous_headings":"","what":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","title":"Translate MIC and Disk Diffusion to 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. breakpoints currently available: clinical microbiology EUCAST 2011-2023 CLSI 2011-2023; veterinary microbiology EUCAST 2021-2023 CLSI 2019-2023; ECOFFs (Epidemiological cut-values) EUCAST 2020-2023 CLSI 2022-2023. breakpoints used interpretation available clinical_breakpoints data set.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Translate MIC and Disk Diffusion to 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)  # S3 method for default as.sir(   x,   S = \"^(S|U)+$\",   I = \"^(I|H)+$\",   R = \"^(R)+$\",   N = \"^(N|V)+$\",   SDD = \"^(SDD|D)+$\",   ... )  # S3 method for mic as.sir(   x,   mo = NULL,   ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   uti = NULL,   conserve_capped_values = FALSE,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   host = NULL,   ... )  # S3 method for 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,   include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   host = NULL,   ... )  # S3 method for data.frame as.sir(   x,   ...,   col_mo = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   uti = NULL,   conserve_capped_values = FALSE,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   host = NULL )  sir_interpretation_history(clean = FALSE)"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Translate MIC and Disk Diffusion to 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-2023, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. CLSI M100: Performance Standard Antimicrobial Susceptibility Testing, 2011-2023, 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-2023, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/veterinary-medicine/documents/vet01//. EUCAST Breakpoint tables interpretation MICs zone diameters, 2011-2023, European Committee Antimicrobial Susceptibility Testing (EUCAST). https://www.eucast.org/clinical_breakpoints.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"x vector values (class mic: MIC values mg/L, class disk: disk diffusion radius millimetres) ... using data.frame: names columns apply .sir() (supports tidy selection column1:column4). Otherwise: arguments passed methods. threshold maximum fraction invalid antimicrobial interpretations x, see Examples S, , R, N, SDD case-indepdendent regular expression translate input result. regular expression run non-letters removed input. 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 defaults EUCAST 2023 (latest implemented EUCAST guideline clinical_breakpoints data set), can set package option AMR_guideline. Currently supports EUCAST (2011-2023) CLSI (2011-2023), see Details. uti (Urinary Tract Infection) vector 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. conserve_capped_values logical indicate MIC values starting \">\" (\">=\") must always return \"R\" , MIC values starting \"<\" (\"<=\") must always return \"S\" 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. include_screening logical indicate clinical breakpoints screening allowed - default FALSE. Can also set package option AMR_include_screening. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". host vector (column name) characters indicate host. useful veterinary breakpoints, requires breakpoint_type = \"animal\". values can text resembling animal species, even 20 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). col_mo column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). clean logical indicate whether previously stored results forgotten returning 'logbook' results","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"Ordered factor new class sir","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate MIC and Disk Diffusion to 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://msberends.github.io/AMR/reference/as.sir.html","id":"how-it-works","dir":"Reference","previous_headings":"","what":"How it Works","title":"Translate MIC and Disk Diffusion to 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, N 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. Using dplyr, SIR interpretation can done easily either:   Operators like \"<=\" stripped interpretation. using conserve_capped_values = TRUE, MIC value e.g. \">2\" always return \"R\", even breakpoint according chosen guideline \">=4\". prevent capped values raw laboratory data treated conservatively. default behaviour (conserve_capped_values = FALSE) considers \">2\" lower \">=4\" might case return \"S\" \"\". 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. Using dplyr, SIR interpretation can done easily either:   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 (tibble tibble package installed) results last .sir() call.","code":"your_data %>% mutate_if(is.mic, as.sir) your_data %>% mutate(across(where(is.mic), as.sir))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.mic, as.sir, host = \"column_with_animal_hosts\", guideline = \"CLSI\") your_data %>% mutate_if(is.disk, as.sir) your_data %>% mutate(across(where(is.disk), as.sir))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.disk, as.sir, host = \"column_with_animal_hosts\", guideline = \"CLSI\")"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"supported-guidelines","dir":"Reference","previous_headings":"","what":"Supported Guidelines","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"interpreting MIC values well disk diffusion diameters, currently implemented guidelines clinical microbiology: EUCAST 2011-2023 CLSI 2011-2023, veterinary microbiology: EUCAST 2021-2023 CLSI 2019-2023. Thus, guideline argument must set e.g., \"EUCAST 2023\" \"CLSI 2023\". simply using \"EUCAST\" (default) \"CLSI\" input, latest included version guideline automatically selected. can set data set using reference_data argument. guideline argument ignored. can set default guideline package option AMR_guideline (e.g. .Rprofile file), :   veterinary guidelines, might best options:","code":"options(AMR_guideline = \"CLSI\")   options(AMR_guideline = \"CLSI 2018\")   options(AMR_guideline = \"EUCAST 2020\")   # or to reset:   options(AMR_guideline = NULL) options(AMR_guideline = \"CLSI\")   options(AMR_breakpoint_type = \"animal\")"},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"after-interpretation","dir":"Reference","previous_headings":"","what":"After Interpretation","title":"Translate MIC and Disk Diffusion to 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.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"machine-readable-clinical-breakpoints","dir":"Reference","previous_headings":"","what":"Machine-Readable Clinical Breakpoints","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"repository package contains machine-readable version guidelines. CSV file consisting 29 883 rows 13 columns. file machine-readable, since contains one row every unique combination test method (MIC disk diffusion), antimicrobial drug microorganism. allows easy implementation rules laboratory information systems (LIS). Note contains interpretation guidelines humans - interpretation guidelines CLSI animals removed.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"function .sir() detects input contains class sir. input data.frame, iterates columns returns logical vector. function is_sir_eligible() returns TRUE columns contains 5% invalid antimicrobial interpretations (S //R /N /SDD), FALSE otherwise. threshold 5% can set threshold argument. input data.frame, iterates columns returns logical vector.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/as.sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Translate MIC and Disk Diffusion to SIR, or Clean Existing SIR Data — as.sir","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … summary(example_isolates) # see all SIR results at a glance #>       date              patient               age           gender          #>  Min.   :2002-01-02   Length:2000        Min.   : 0.00   Length:2000        #>  1st Qu.:2005-07-31   Class :character   1st Qu.:63.00   Class :character   #>  Median :2009-07-31   Mode  :character   Median :74.00   Mode  :character   #>  Mean   :2009-11-20                      Mean   :70.69                      #>  3rd Qu.:2014-05-30                      3rd Qu.:82.00                      #>  Max.   :2017-12-28                      Max.   :97.00                      #>      ward                mo                  PEN                 #>  Length:2000        Class :mo             Class:sir              #>  Class :character   <NA>  :0              %R   :73.7% (n=1201)   #>  Mode  :character   Unique:90             %SI  :26.3% (n=428)    #>                     #1    :B_ESCHR_COLI   - %S :25.6% (n=417)    #>                     #2    :B_STPHY_CONS   - %I : 0.7% (n=11)     #>                     #3    :B_STPHY_AURS                          #>     OXA                   FLC                   AMX                #>  Class:sir             Class:sir             Class:sir             #>  %R   :31.2% (n=114)   %R   :29.5% (n=278)   %R   :59.6% (n=804)   #>  %SI  :68.8% (n=251)   %SI  :70.5% (n=665)   %SI  :40.4% (n=546)   #>  - %S :68.8% (n=251)   - %S :70.5% (n=665)   - %S :40.2% (n=543)   #>  - %I : 0.0% (n=0)     - %I : 0.0% (n=0)     - %I : 0.2% (n=3)     #>                                                                    #>     AMC                    AMP                   TZP                #>  Class:sir              Class:sir             Class:sir             #>  %R   :23.7% (n=446)    %R   :59.6% (n=804)   %R   :12.6% (n=126)   #>  %SI  :76.3% (n=1433)   %SI  :40.4% (n=546)   %SI  :87.4% (n=875)   #>  - %S :71.4% (n=1342)   - %S :40.2% (n=543)   - %S :86.1% (n=862)   #>  - %I : 4.8% (n=91)     - %I : 0.2% (n=3)     - %I : 1.3% (n=13)    #>                                                                     #>     CZO                   FEP                   CXM                 #>  Class:sir             Class:sir             Class:sir              #>  %R   :44.6% (n=199)   %R   :14.2% (n=103)   %R   :26.3% (n=470)    #>  %SI  :55.4% (n=247)   %SI  :85.8% (n=621)   %SI  :73.7% (n=1319)   #>  - %S :54.9% (n=245)   - %S :85.6% (n=620)   - %S :72.5% (n=1297)   #>  - %I : 0.4% (n=2)     - %I : 0.1% (n=1)     - %I : 1.2% (n=22)     #>                                                                     #>     FOX                   CTX                   CAZ                 #>  Class:sir             Class:sir             Class:sir              #>  %R   :27.4% (n=224)   %R   :15.5% (n=146)   %R   :66.5% (n=1204)   #>  %SI  :72.6% (n=594)   %SI  :84.5% (n=797)   %SI  :33.5% (n=607)    #>  - %S :71.6% (n=586)   - %S :84.4% (n=796)   - %S :33.5% (n=607)    #>  - %I : 1.0% (n=8)     - %I : 0.1% (n=1)     - %I : 0.0% (n=0)      #>                                                                     #>     CRO                   GEN                    TOB                #>  Class:sir             Class:sir              Class:sir             #>  %R   :15.5% (n=146)   %R   :24.6% (n=456)    %R   :34.4% (n=465)   #>  %SI  :84.5% (n=797)   %SI  :75.4% (n=1399)   %SI  :65.6% (n=886)   #>  - %S :84.4% (n=796)   - %S :74.0% (n=1372)   - %S :65.1% (n=879)   #>  - %I : 0.1% (n=1)     - %I : 1.5% (n=27)     - %I : 0.5% (n=7)     #>                                                                     #>     AMK                   KAN                    TMP                #>  Class:sir             Class:sir              Class:sir             #>  %R   :63.7% (n=441)   %R   :100.0% (n=471)   %R   :38.1% (n=571)   #>  %SI  :36.3% (n=251)   %SI  : 0.0% (n=0)      %SI  :61.9% (n=928)   #>  - %S :36.3% (n=251)   - %S : 0.0% (n=0)      - %S :61.2% (n=918)   #>  - %I : 0.0% (n=0)     - %I : 0.0% (n=0)      - %I : 0.7% (n=10)    #>                                                                     #>     SXT                    NIT                   FOS                #>  Class:sir              Class:sir             Class:sir             #>  %R   :20.5% (n=361)    %R   :17.1% (n=127)   %R   :42.2% (n=148)   #>  %SI  :79.5% (n=1398)   %SI  :82.9% (n=616)   %SI  :57.8% (n=203)   #>  - %S :79.1% (n=1392)   - %S :76.0% (n=565)   - %S :57.8% (n=203)   #>  - %I : 0.3% (n=6)      - %I : 6.9% (n=51)    - %I : 0.0% (n=0)     #>                                                                     #>     LNZ                   CIP                    MFX                #>  Class:sir             Class:sir              Class:sir             #>  %R   :69.3% (n=709)   %R   :16.2% (n=228)    %R   :33.6% (n=71)    #>  %SI  :30.7% (n=314)   %SI  :83.8% (n=1181)   %SI  :66.4% (n=140)   #>  - %S :30.7% (n=314)   - %S :78.9% (n=1112)   - %S :64.5% (n=136)   #>  - %I : 0.0% (n=0)     - %I : 4.9% (n=69)     - %I : 1.9% (n=4)     #>                                                                     #>     VAN                    TEC                   TCY                #>  Class:sir              Class:sir             Class:sir             #>  %R   :38.3% (n=712)    %R   :75.7% (n=739)   %R   :29.8% (n=357)   #>  %SI  :61.7% (n=1149)   %SI  :24.3% (n=237)   %SI  :70.3% (n=843)   #>  - %S :61.7% (n=1149)   - %S :24.3% (n=237)   - %S :68.3% (n=820)   #>  - %I : 0.0% (n=0)      - %I : 0.0% (n=0)     - %I : 1.9% (n=23)    #>                                                                     #>     TGC                   DOX                   ERY                 #>  Class:sir             Class:sir             Class:sir              #>  %R   :12.7% (n=101)   %R   :27.7% (n=315)   %R   :57.2% (n=1084)   #>  %SI  :87.3% (n=697)   %SI  :72.3% (n=821)   %SI  :42.8% (n=810)    #>  - %S :87.3% (n=697)   - %S :71.7% (n=814)   - %S :42.3% (n=801)    #>  - %I : 0.0% (n=0)     - %I : 0.6% (n=7)     - %I : 0.5% (n=9)      #>                                                                     #>     CLI                   AZM                    IPM                #>  Class:sir             Class:sir              Class:sir             #>  %R   :61.2% (n=930)   %R   :57.2% (n=1084)   %R   : 6.2% (n=55)    #>  %SI  :38.8% (n=590)   %SI  :42.8% (n=810)    %SI  :93.8% (n=834)   #>  - %S :38.6% (n=586)   - %S :42.3% (n=801)    - %S :92.7% (n=824)   #>  - %I : 0.3% (n=4)     - %I : 0.5% (n=9)      - %I : 1.1% (n=10)    #>                                                                     #>     MEM                   MTR                  CHL                #>  Class:sir             Class:sir            Class:sir             #>  %R   : 5.9% (n=49)    %R   :14.7% (n=5)    %R   :21.4% (n=33)    #>  %SI  :94.1% (n=780)   %SI  :85.3% (n=29)   %SI  :78.6% (n=121)   #>  - %S :94.1% (n=780)   - %S :85.3% (n=29)   - %S :78.6% (n=121)   #>  - %I : 0.0% (n=0)     - %I : 0.0% (n=0)    - %I : 0.0% (n=0)     #>                                                                   #>     COL                    MUP                   RIF                #>  Class:sir              Class:sir             Class:sir             #>  %R   :81.2% (n=1331)   %R   : 5.9% (n=16)    %R   :69.6% (n=698)   #>  %SI  :18.8% (n=309)    %SI  :94.1% (n=254)   %SI  :30.4% (n=305)   #>  - %S :18.8% (n=309)    - %S :93.0% (n=251)   - %S :30.2% (n=303)   #>  - %I : 0.0% (n=0)      - %I : 1.1% (n=3)     - %I : 0.2% (n=2)     #>                                                                      # For INTERPRETING disk diffusion and MIC values -----------------------  # a whole data set, even with combined MIC values and disk zones df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = as.mic(8),   CIP = as.mic(0.256),   GEN = as.disk(18),   TOB = as.disk(16),   ERY = \"R\" ) as.sir(df) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: column 'AMP', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: column 'CIP', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: column 'GEN', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: column 'TOB', EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Assigning class 'sir' to already clean column 'ERY' (erythromycin)... #>  OK  #>      microorganism AMP CIP GEN TOB ERY #> 1 Escherichia coli   S   I   S   S   R  # return a 'logbook' about the results: sir_interpretation_history() #> # A tibble: 4 × 14 #>   datetime            index ab_user mo_user        ab   mo                input #>   <dttm>              <int> <chr>   <chr>          <ab> <mo>              <dbl> #> 1 2024-05-20 19:33:13     1 TOB     Escherichia c… TOB  B_[ORD]_ENTRBCTR 16     #> 2 2024-05-20 19:33:13     1 GEN     Escherichia c… GEN  B_[ORD]_ENTRBCTR 18     #> 3 2024-05-20 19:33:12     1 CIP     Escherichia c… CIP  B_[ORD]_ENTRBCTR  0.256 #> 4 2024-05-20 19:33:12     1 AMP     Escherichia c… AMP  B_[ORD]_ENTRBCTR  8     #> # ℹ 7 more variables: outcome <sir>, method <chr>, breakpoint_S_R <chr>, #> #   guideline <chr>, host <chr>, ref_table <chr>, uti <lgl>  # for single values as.sir(   x = as.mic(2),   mo = as.mo(\"S. pneumoniae\"),   ab = \"AMP\",   guideline = \"EUCAST\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP', EUCAST 2023... #>  NOTE  #>   • Multiple breakpoints available for ampicillin (AMP) in Streptococcus #>      pneumoniae - assuming body site 'Non-meningitis'. #> 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\" ) #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting disk diffusion zones: 'ampicillin' (AMP) (AMP, ampicillin), #> EUCAST 2023... #>  OK  #> Class 'sir' #> [1] R  # \\donttest{ # the dplyr way if (require(\"dplyr\")) {   df %>% mutate_if(is.mic, as.sir)   df %>% mutate_if(function(x) is.mic(x) | is.disk(x), as.sir)   df %>% mutate(across(where(is.mic), as.sir))   df %>% mutate_at(vars(AMP:TOB), as.sir)   df %>% mutate(across(AMP:TOB, as.sir))    df %>%     mutate_at(vars(AMP:TOB), as.sir, mo = \"microorganism\")    # to include information about urinary tract infections (UTI)   data.frame(     mo = \"E. coli\",     NIT = c(\"<= 2\", 32),     from_the_bladder = c(TRUE, FALSE)   ) %>%     as.sir(uti = \"from_the_bladder\")    data.frame(     mo = \"E. coli\",     NIT = c(\"<= 2\", 32),     specimen = c(\"urine\", \"blood\")   ) %>%     as.sir() # automatically determines urine isolates    df %>%     mutate_at(vars(AMP:TOB), as.sir, mo = \"E. coli\", uti = TRUE) } #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: 'AMP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for ampicillin (AMP) in #>      Escherichia coli - assuming body site 'Intravenous'. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting MIC values: 'CIP' based on column 'microorganism', EUCAST #> 2023... #>  NOTE  #>   • Multiple breakpoints available for ciprofloxacin (CIP) in Escherichia coli #>      - assuming body site 'Non-meningitis'. #> Interpreting disk diffusion zones: 'GEN' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for gentamicin (GEN) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> Interpreting disk diffusion zones: 'TOB' based on column 'microorganism', #> EUCAST 2023... #>  NOTE  #>   • Breakpoints for UTI and non-UTI available for tobramycin (TOB) in #>      Escherichia coli - assuming an unspecified body site. Use argument uti to #>      set which isolates are from urine. See ?as.sir. #> ℹ Run sir_interpretation_history() afterwards to retrieve a logbook with #>   all the details of the breakpoint interpretations. Note that some #>   microorganisms might not have breakpoints for each antimicrobial drug in #>   EUCAST 2023. #> Interpreting MIC values: column 'NIT', EUCAST 2023... #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 2, 1  # For CLEANING existing SIR values ------------------------------------  as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"N\", \"A\", \"B\", \"C\")) #> Warning: in as.sir(): 3 results in column '24' truncated (38%) that were invalid #> antimicrobial interpretations: \"A\", \"B\", and \"C\" #> Class 'sir' #> [1] S    SDD  I    R    N    <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   # the dplyr way if (require(\"dplyr\")) {   example_isolates %>%     mutate_at(vars(PEN:RIF), as.sir)   # same:   example_isolates %>%     as.sir(PEN:RIF)    # fastest way to transform all columns with already valid AMR results to class `sir`:   example_isolates %>%     mutate_if(is_sir_eligible, as.sir)    # since dplyr 1.0.0, this can also be:   # example_isolates %>%   #   mutate(across(where(is_sir_eligible), as.sir)) } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS R     NA    S     R     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR R     NA    R     NA    #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://msberends.github.io/AMR/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. antibiotic), name, defined daily dose (DDD) standard unit.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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) antibiotics, 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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/atc_online.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"# \\donttest{ if (requireNamespace(\"curl\") && requireNamespace(\"rvest\") && requireNamespace(\"xml2\")) {   # oral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"O\")   atc_online_ddd(ab_atc(\"amox\"))    # parenteral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"P\")    atc_online_property(\"J01CA04\", property = \"groups\") # search hierarchical groups of amoxicillin } #> Loading required namespace: rvest #> [1] \"ANTIINFECTIVES FOR SYSTEMIC USE\"         #> [2] \"ANTIBACTERIALS FOR SYSTEMIC USE\"         #> [3] \"BETA-LACTAM ANTIBACTERIALS, PENICILLINS\" #> [4] \"Penicillins with extended spectrum\"      # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/av_property.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Get Properties of an Antiviral Drug — av_property","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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, ...)  # S3 method for 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://msberends.github.io/AMR/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 antibiotic 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() ... arguments passed FUN translate_ab character length 1 containing column names antibiotics 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 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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     N 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 \"Ampheni… Chlo… \"\"    \"\"        \"\"            \"\"              \"100.0% (30/30… #>  6 \"Antimyc… Rifa… \"\"    \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  7 \"Beta-la… Amox… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  8 \"\"        Amox… \" 42… \" 13.1% … \"\"            \" 10.3% (6/58)\" \"100.0% (30/30… #>  9 \"\"        Ampi… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> 10 \"\"        Benz… \" 77… \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> # ℹ 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     N 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     N 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://msberends.github.io/AMR/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. Currently available breakpoint guidelines clinical microbiology EUCAST 2011-2023 CLSI 2011-2023. Currently available breakpoint guidelines veterinary microbiology EUCAST 2021-2023 CLSI 2019-2023. Use .sir() transform MICs disks measurements SIR values.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 29 883 observations 13 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 Antibiotic 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\" uti logical value (TRUE/FALSE) indicate whether rule applies urinary tract infection (UTI)","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 development WHONET software.","code":""},{"path":"https://msberends.github.io/AMR/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 AMR package.","code":""},{"path":"https://msberends.github.io/AMR/reference/clinical_breakpoints.html","id":"download","dir":"Reference","previous_headings":"","what":"Download","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository. allow machine reading EUCAST CLSI guidelines, almost impossible MS Excel PDF files distributed EUCAST CLSI, though initiatives started overcome burdens. NOTE: 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 using breakpoints use.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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: 29,883 × 13 #>    guideline   type  host  method site    mo            rank_index ab   ref_tbl  #>    <chr>       <chr> <chr> <chr>  <chr>   <mo>               <dbl> <ab> <chr>    #>  1 EUCAST 2023 human human DISK   NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  2 EUCAST 2023 human human MIC    NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  3 EUCAST 2023 human human DISK   NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  4 EUCAST 2023 human human MIC    NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  5 EUCAST 2023 human human DISK   NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  6 EUCAST 2023 human human MIC    NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  7 EUCAST 2023 human human DISK   NA      B_ACNTB                3 AMK  Acineto… #>  8 EUCAST 2023 human human DISK   Uncomp… B_ACNTB                3 AMK  Acineto… #>  9 EUCAST 2023 human human MIC    NA      B_ACNTB                3 AMK  Acineto… #> 10 EUCAST 2023 human human MIC    Uncomp… B_ACNTB                3 AMK  Acineto… #> # ℹ 29,873 more rows #> # ℹ 4 more variables: disk_dose <chr>, breakpoint_S <dbl>, breakpoint_R <dbl>, #> #   uti <lgl>"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics, see section Combination Therapy data data.frame containing columns class sir (see .sir()) translate_ab column name antibiotics 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 must merged one, output consists S+vs. R (susceptible vs. resistant) - default TRUE","code":""},{"path":"https://msberends.github.io/AMR/reference/count.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count Available Isolates — count","text":"integer","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics 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://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://msberends.github.io/AMR/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 antibiotics/variables test . See example two antibiotics, 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   include as  include as   include as  include as                     numerator   denominator  numerator   denominator --------  --------  ----------  -----------  ----------  -----------  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://msberends.github.io/AMR/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) #> Using count_S() is discouraged; use count_susceptible() instead to also #> consider \"I\" and \"SDD\" being susceptible. This note will be shown once for #> this session. #> [1] 543 count_SI(example_isolates$AMX) #> Note that count_SI() will also count dose-dependent susceptibility, #> 'SDD'. This note will be shown once for this session. #> [1] 546 count_I(example_isolates$AMX) #> Note that count_I() will also count dose-dependent susceptibility, 'SDD'. #> This note will be shown once for this session. #> [1] 3 count_IR(example_isolates$AMX) #> Using count_IR() is discouraged; use count_resistant() instead to not #> consider \"I\" and \"SDD\" being resistant. This note will be shown once for #> this session. #> [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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 Examples","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/custom_eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"organisations adoption EUCAST rules. function can used define custom EUCAST rules used eucast_rules() function.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    R     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://msberends.github.io/AMR/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\", \"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) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://msberends.github.io/AMR/reference/custom_eucast_rules.html","id":"usage-of-antibiotic-group-names","dir":"Reference","previous_headings":"","what":"Usage of antibiotic group names","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"possible define antibiotic groups instead single antibiotics rule consequence, part tilde. examples, antibiotic group aminopenicillins used include ampicillin amoxicillin. following groups allowed (case-insensitive). Within parentheses drugs matched running rule. \"aminoglycosides\"(amikacin, amikacin/fosfomycin, amphotericin B-high, 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\"(amphotericin B, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole) \"antimycobacterials\"(4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin) \"betalactams\"(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, avibactam, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, biapenem, carbenicillin, carindacillin, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/clavulanic acid, cefepime/nacubactam, cefepime/tazobactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening, 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, nacubactam, nafcillin, oxacillin, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbactam, sulbenicillin, sultamicillin, talampicillin, tazobactam, tebipenem, temocillin, ticarcillin, 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/clavulanic acid, cefepime/tazobactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening, 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, 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/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/clavulanic acid, cefepime/tazobactam, 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/clavulanic acid, cefepime/tazobactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening, 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, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nifuroquine, norfloxacin, ofloxacin, orbifloxacin, pazufloxacin, pefloxacin, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) \"glycopeptides\"(avoparcin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod) \"glycopeptides_except_lipo\"(avoparcin, norvancomycin, ramoplanin, teicoplanin, teicoplanin-macromethod, vancomycin, vancomycin-macromethod) \"lincosamides\"(acetylmidecamycin, acetylspiramycin, clindamycin, gamithromycin, kitasamycin, lincomycin, meleumycin, nafithromycin, pirlimycin, primycin, solithromycin, tildipirosin, tilmicosin, tulathromycin, tylosin, tylvalosin) \"lipoglycopeptides\"(dalbavancin, oritavancin, telavancin) \"macrolides\"(acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, pirlimycin, primycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin) \"oxazolidinones\"(cadazolid, cycloserine, linezolid, tedizolid, thiacetazone) \"penicillins\"(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, avibactam, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, carbenicillin, carindacillin, cefepime/nacubactam, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nacubactam, nafcillin, oxacillin, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbactam, sulbenicillin, sultamicillin, talampicillin, tazobactam, temocillin, ticarcillin, ticarcillin/clavulanic acid) \"polymyxins\"(colistin, polymyxin B, polymyxin B/polysorbate 80) \"quinolones\"(besifloxacin, cinoxacin, ciprofloxacin, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, ofloxacin, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) \"streptogramins\"(pristinamycin quinupristin/dalfopristin) \"tetracyclines\"(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tigecycline) \"tetracyclines_except_tgc\"(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline) \"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":""},{"path":"https://msberends.github.io/AMR/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,   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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/dosage.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"tibble 503 observations 9 variables: ab Antibiotic 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 13, 12, 11","code":""},{"path":"https://msberends.github.io/AMR/reference/dosage.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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: 503 × 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/kg… #>  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 iv #>  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 o… #>  6 AMX  Amoxicillin     unco… 0.5 g          3 oral           \"\"    0.5 g x 3 o… #>  7 AMC  Amoxicillin/cl… high… 2 g …          3 iv             \"\"    (2 g amoxic… #>  8 AMC  Amoxicillin/cl… stan… 1 g …          3 iv             \"\"    (1 g amoxic… #>  9 AMC  Amoxicillin/cl… high… 0.87…          3 oral           \"\"    (0.875 g am… #> 10 AMC  Amoxicillin/cl… stan… 0.5 …          3 oral           \"\"    (0.5 g amox… #> # ℹ 493 more rows #> # ℹ 1 more variable: eucast_version <dbl>"},{"path":"https://msberends.github.io/AMR/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 intrinsic resistance 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://msberends.github.io/AMR/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\", \"expert\")),   verbose = FALSE,   version_breakpoints = 12,   version_expertrules = 3.3,   ampc_cephalosporin_resistance = NA,   only_sir_columns = FALSE,   custom_rules = NULL,   ... )  eucast_dosage(ab, administration = \"iv\", version_breakpoints = 12)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply EUCAST Rules — eucast_rules","text":"x data set antibiotic 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\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expert\"). 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 \"12.0\", \"11.0\", \"10.0\". version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\". ampc_cephalosporin_resistance character value applied cefotaxime, ceftriaxone ceftazidime AmpC de-repressed cephalosporin-resistant mutants - default NA. Currently works version_expertrules 3.2 higher; version '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 antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE) custom_rules custom rules apply, created custom_eucast_rules() ... column name antibiotic, see section Antibiotics ab (vector ) text can coerced valid antibiotic drug code .ab() administration route administration, either \"im\", \"iv\", \"oral\"","code":""},{"path":"https://msberends.github.io/AMR/reference/eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply EUCAST Rules — eucast_rules","text":"input x, possibly edited values antibiotics. , verbose = TRUE, data.frame original new values affected bug-drug combinations.","code":""},{"path":"https://msberends.github.io/AMR/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 January 8th, 2024, see microorganisms.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/eucast_rules.html","id":"antibiotics","dir":"Reference","previous_headings":"","what":"Antibiotics","title":"Apply EUCAST Rules — eucast_rules","text":"define antibiotics column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antibiotics eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefetamet (CAT, J01DD10), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), ciprofloxacin (CIP, J01MA02), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), norfloxacin (, J01MA06), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), oleandomycin (OLE, J01FA05), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbactam (SUL, J01CG01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tazobactam (TAZ, J01CG02), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://msberends.github.io/AMR/reference/eucast_rules.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Apply EUCAST Rules — eucast_rules","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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) #> 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   S   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, 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   S      Expert Rules #> 4   1 CAZ Staphylococcus aureus   -   R      Expert Rules #> 5   1 COL Staphylococcus aureus   -   R      Expert Rules #> 6   2 CAZ Enterococcus faecalis   -   R      Expert Rules #>                                                 rule_name #> 1                                          Staphylococcus #> 2                                          Staphylococcus #> 3                          Expert Rules on Staphylococcus #> 4 Table 4: Intrinsic resistance in gram-positive bacteria #> 5 Table 4: Intrinsic resistance in gram-positive bacteria #> 6 Table 4: Intrinsic resistance in gram-positive bacteria #>                                                                                 rule_source #> 1                                           'EUCAST Clinical Breakpoint Tables' v12.0, 2022 #> 2                                           'EUCAST Clinical Breakpoint Tables' v12.0, 2022 #> 3 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 #> 4 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 #> 5 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 #> 6 'EUCAST Expert Rules' and 'EUCAST Intrinsic Resistance and Unusual Phenotypes' v3.3, 2021 # }  # Dosage guidelines:  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\") #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v12.0 (2022). This note will be shown once per session. #> # A tibble: 3 × 4 #>   ab   name          standard_dosage  high_dosage  #>   <ab> <chr>         <chr>            <chr>        #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA           #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA           #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\", version_breakpoints = 10) #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v10.0 (2020). This note will be shown once per session. #> # A tibble: 3 × 4 #>   ab   name          standard_dosage  high_dosage  #>   <ab> <chr>         <chr>            <chr>        #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA           #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA           #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics class sir (see .sir()); column names occur antibiotics data set can translated set_ab_names() ab_name()","code":""},{"path":"https://msberends.github.io/AMR/reference/example_isolates.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics transformed .sir()","code":""},{"path":"https://msberends.github.io/AMR/reference/example_isolates_unclean.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with Unclean Data — example_isolates_unclean","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/first_isolate.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine First Isolates — first_isolate","text":"Methodology function 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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/first_isolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine First Isolates — first_isolate","text":"logical vector","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine First Isolates — first_isolate","text":"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://msberends.github.io/AMR/reference/first_isolate.html","id":"different-methods","dir":"Reference","previous_headings":"","what":"Different methods","title":"Determine First Isolates — first_isolate","text":"According Hindler et al. (2007, doi:10.1086/511864 ), different methods (algorithms) select first isolates increasing reliability: isolate-based, patient-based, episode-based phenotype-based. methods select combination taxonomic genus species (subspecies). mentioned methods covered first_isolate() function:","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"isolate-based","dir":"Reference","previous_headings":"","what":"Isolate-based","title":"Determine First Isolates — first_isolate","text":"method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID.","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"patient-based","dir":"Reference","previous_headings":"","what":"Patient-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient , set episode_days Inf. Although often inappropriate, method makes sure duplicate isolates selected patient. large longitudinal data set, mean isolates excluded found years initial isolate.","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"episode-based","dir":"Reference","previous_headings":"","what":"Episode-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, 14, 30, 60 365. Short episodes common analysing specific hospital ward data, long episodes common analysing regional national data. common method correct duplicate isolates. Patients categorised episodes based ID dates (e.g., date specimen receipt laboratory result). common method, take account antimicrobial test results. means e.g. methicillin-resistant Staphylococcus aureus (MRSA) isolate differentiated wildtype Staphylococcus aureus isolate.","code":""},{"path":"https://msberends.github.io/AMR/reference/first_isolate.html","id":"phenotype-based","dir":"Reference","previous_headings":"","what":"Phenotype-based","title":"Determine First Isolates — first_isolate","text":"reliable method, since also weighs antibiogram (antimicrobial test results) yielding -called 'first weighted isolates'. two different methods weigh antibiogram: Using type = \"points\" argument points_threshold (default) method weighs antimicrobial drugs available data set. difference S R (vice versa) counts 0.5 points, difference S R (vice versa) counts 1 point. sum points exceeds points_threshold, defaults 2, isolate selected first weighted isolate. antimicrobials internally selected using all_antimicrobials() function. output function need passed first_isolate() function. Using type = \"keyantimicrobials\" argument ignore_I method weighs specific antimicrobial drugs, called key antimicrobials. difference S R (vice versa) key antimicrobials select isolate first weighted isolate. ignore_I = FALSE, also differences S R (vice versa) lead . Key antimicrobials internally selected using key_antimicrobials() function, can also added manually variable data set col_keyantimicrobials argument. Another option pass output key_antimicrobials() function directly col_keyantimicrobials argument. default method phenotype-based (using type = \"points\") episode-based (using episode_days = 365). makes sure every genus-species combination selected per patient per year, taking account antimicrobial test results. antimicrobial test results available data set, episode-based method applied default.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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,373 'phenotype-based' first isolates (68.7% of total where a #>    microbial ID was available) #> # A tibble: 1,373 × 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-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #>  5 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR R     NA    S     NA    #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  7 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND R     NA    NA    R     #>  8 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL R     NA    NA    NA    #>  9 2002-02-03 481442     76 M      ICU      B_STPHY_CONS R     NA    S     NA    #> 10 2002-02-05 023456     50 M      Clinical B_STPHY_HMNS S     NA    S     NA    #> # ℹ 1,363 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: 434 × 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    #> # ℹ 424 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,373 'phenotype-based' first isolates (68.7% of total where a #>    microbial ID was available) #> # A tibble: 1,373 × 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-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #>  5 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR R     NA    S     NA    #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  7 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND R     NA    NA    R     #>  8 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL R     NA    NA    NA    #>  9 2002-02-03 481442     76 M      ICU      B_STPHY_CONS R     NA    S     NA    #> 10 2002-02-05 023456     50 M      Clinical B_STPHY_HMNS S     NA    S     NA    #> # ℹ 1,363 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,373 × 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-17 858515     79 F      ICU      B_STPHY_EPDR R     NA    S     NA    #>  5 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR R     NA    S     NA    #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI R     NA    NA    NA    #>  7 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND R     NA    NA    R     #>  8 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL R     NA    NA    NA    #>  9 2002-02-03 481442     76 M      ICU      B_STPHY_CONS R     NA    S     NA    #> 10 2002-02-05 023456     50 M      Clinical B_STPHY_HMNS S     NA    S     NA    #> # ℹ 1,363 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 857 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #>  #> Group: ward = \"ICU\" #> ℹ Excluding 6 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 447 'phenotype-based' first isolates (69.2% of total where a #>    microbial ID was available) #>  #> Group: ward = \"Outpatient\" #> ℹ Excluding 1 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 98 'phenotype-based' first isolates (81.7% 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 FALSE #> 10 ICU      2002-01-17 858515  B_STPHY_EPDR TRUE  #> # ℹ 1,990 more rows # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/g.test.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"G-test for Count Data — g.test","text":"McDonald, J.H. 2014. Handbook Biological Statistics (3rd ed.). Sparky House Publishing, Baltimore, Maryland. http://www.biostathandbook.com/gtestgof.html.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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] 29 45 31 14 41 39 26 40 18 36 15 39 18 45 32 27 10  2 13 24 43 12  8  5  3 #>  [26] 12 31  9 16  4  1 26 32 27 21 45 42 17 16 21  8  4 30  1 17 25 34  5 10  1 #>  [51] 18 44 33  4  6 12 43  2 43 45 37 33 18 38 45 36 46  4 35 40 12  7 11 23 10 #>  [76] 35 20  4  5 29 27 41 12 30 45 18 46 22 28 39 19 27 45 16  4 21 40 39 39 10 is_new_episode(df$date, episode_days = 60) # TRUE/FALSE #>   [1]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE FALSE #>  [13] FALSE FALSE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [25]  TRUE FALSE FALSE  TRUE  TRUE  TRUE  TRUE FALSE FALSE FALSE  TRUE FALSE #>  [37]  TRUE  TRUE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE  TRUE  TRUE FALSE #>  [49] FALSE FALSE FALSE  TRUE  TRUE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE #>  [61]  TRUE FALSE FALSE  TRUE FALSE FALSE  TRUE FALSE  TRUE FALSE FALSE  TRUE #>  [73]  TRUE  TRUE FALSE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE FALSE #>  [85] FALSE FALSE FALSE  TRUE  TRUE FALSE  TRUE FALSE FALSE FALSE FALSE FALSE #>  [97] FALSE 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: 1 × 46 #>   date       patient   age gender ward  mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr> <mo>         <sir> <sir> <sir> <sir> #> 1 2002-12-13 285137     78 F      ICU   B_ESCHR_COLI R     NA    NA    NA    #> # ℹ 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 [99] #>    patient date       condition new_episode #>    <chr>   <date>     <chr>     <lgl>       #>  1 036063  2010-01-28 A         TRUE        #>  2 077922  2009-08-18 A         TRUE        #>  3 080086  2010-08-08 B         TRUE        #>  4 0DBF93  2015-10-12 A         TRUE        #>  5 105248  2005-06-16 B         TRUE        #>  6 114570  2003-04-08 C         TRUE        #>  7 119392  2010-11-01 B         TRUE        #>  8 161740  2005-06-21 B         TRUE        #>  9 174209  2011-10-03 A         TRUE        #> 10 210105  2009-06-13 B         TRUE        #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward, patient) %>%     transmute(date,       patient,       new_index = get_episode(date, 60),       new_logical = is_new_episode(date, 60)     ) %>%     arrange(patient, ward, date) } #> # A tibble: 100 × 5 #> # Groups:   ward, patient [96] #>    ward       date       patient new_index new_logical #>    <chr>      <date>     <chr>       <int> <lgl>       #>  1 Clinical   2010-01-28 036063          1 TRUE        #>  2 Clinical   2009-08-18 077922          1 TRUE        #>  3 Clinical   2010-08-08 080086          1 TRUE        #>  4 Clinical   2015-10-12 0DBF93          1 TRUE        #>  5 Clinical   2005-06-16 105248          1 TRUE        #>  6 ICU        2003-04-08 114570          1 TRUE        #>  7 Clinical   2010-11-01 119392          1 TRUE        #>  8 Clinical   2005-06-21 161740          1 TRUE        #>  9 Outpatient 2011-10-03 174209          1 TRUE        #> 10 Clinical   2009-06-13 210105          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           63             12            35            45 #> 2 ICU                24              9            17            21 #> 3 Outpatient          9              7             7             9  # 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 [96] #>    patient mo           ward     flag_episode #>    <chr>   <mo>         <chr>    <lgl>        #>  1 686445  B_STPHY_CONS Clinical TRUE         #>  2 D39422  B_KLBSL_PNMN Clinical TRUE         #>  3 298662  B_ESCHR_COLI Clinical TRUE         #>  4 5B78D5  B_STPHY_AURS Clinical TRUE         #>  5 E52625  B_STRPT_PNMN Clinical TRUE         #>  6 645121  B_SERRT_MRCS Clinical TRUE         #>  7 807228  B_STRPT_PNMN Clinical TRUE         #>  8 D41749  B_ESCHR_COLI ICU      TRUE         #>  9 210105  B_ENTRC      Clinical TRUE         #> 10 789292  B_STRPT_SLVR Clinical TRUE         #> # ℹ 90 more rows # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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\"` and `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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/ggplot_sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"ggplot_sir(   data,   position = NULL,   x = \"antibiotic\",   fill = \"interpretation\",   facet = NULL,   breaks = seq(0, 1, 0.1),   limits = NULL,   translate_ab = \"name\",   combine_SI = TRUE,   minimum = 30,   language = get_AMR_locale(),   nrow = NULL,   colours = c(S = \"#3CAEA3\", SI = \"#3CAEA3\", I = \"#F6D55C\", IR = \"#ED553B\", R =     \"#ED553B\"),   datalabels = TRUE,   datalabels.size = 2.5,   datalabels.colour = \"grey15\",   title = NULL,   subtitle = NULL,   caption = NULL,   x.title = \"Antimicrobial\",   y.title = \"Proportion\",   ... )  geom_sir(   position = NULL,   x = c(\"antibiotic\", \"interpretation\"),   fill = \"interpretation\",   translate_ab = \"name\",   minimum = 30,   language = get_AMR_locale(),   combine_SI = TRUE,   ... )  facet_sir(facet = c(\"interpretation\", \"antibiotic\"), nrow = NULL)  scale_y_percent(breaks = seq(0, 1, 0.1), limits = NULL)  scale_sir_colours(..., aesthetics = \"fill\")  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://msberends.github.io/AMR/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 antibiotics data set translate antibiotic abbreviations , using ab_property() combine_SI logical indicate whether values S must merged one, output consists S+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. aesthetics aesthetics apply colours - default \"fill\" can also (combination ) \"alpha\", \"colour\", \"fill\", \"linetype\", \"shape\" \"size\"","code":""},{"path":"https://msberends.github.io/AMR/reference/ggplot_sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Plots with ggplot2 — ggplot_sir","text":"default, names antibiotics shown plots using ab_name(). can set translate_ab argument. See count_df().","code":""},{"path":"https://msberends.github.io/AMR/reference/ggplot_sir.html","id":"the-functions","dir":"Reference","previous_headings":"","what":"The Functions","title":"AMR Plots with ggplot2 — ggplot_sir","text":"geom_sir() take variable data sir class (created .sir()) using sir_df() plot bars percentage S, , R. default behaviour bars stacked different antibiotics x axis. 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][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://msberends.github.io/AMR/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() +     labels_sir_count() +     theme_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # or better yet, simplify this using the wrapper function - a single command:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # get only proportions and no counts:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(datalabels = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # add other ggplot2 arguments as you like:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(       width = 0.5,       colour = \"black\",       size = 1,       linetype = 2,       alpha = 0.25     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # you can alter the colours with colour names:   example_isolates %>%     select(AMX) %>%     ggplot_sir(colours = c(SI = \"yellow\")) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # but you can also use the built-in colour-blind friendly colours for   # your plots, where \"S\" is green, \"I\" is yellow and \"R\" is red:   data.frame(     x = c(\"Value1\", \"Value2\", \"Value3\"),     y = c(1, 2, 3),     z = c(\"Value4\", \"Value5\", \"Value6\")   ) %>%     ggplot() +     geom_col(aes(x = x, y = y, fill = z)) +     scale_sir_colours(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://msberends.github.io/AMR/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 antibiotics data set. Also supports WHONET abbreviations.","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/guess_ab_col.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Guess Antibiotic Column — guess_ab_col","text":"x data.frame search_string text search x , checked .ab() value column x verbose logical indicate whether additional info printed only_sir_columns logical indicate whether antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE)","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics data set column containing name code antibiotic.","code":""},{"path":"https://msberends.github.io/AMR/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\" # NOTE: Using column 'tetr' as input for J01AA07 (tetracycline).  # 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, as.ab(\"augmentin\")) #> [1] \"AMC_ED20\""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Data set containing defined intrinsic resistance EUCAST bug-drug combinations.","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant"},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"tibble 134 634 observations 2 variables: mo Microorganism ID ab Antibiotic ID","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"data set based 'EUCAST Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021).","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"direct-download","dir":"Reference","previous_headings":"","what":"Direct download","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository. allow machine reading EUCAST CLSI guidelines, almost impossible MS Excel PDF files distributed EUCAST CLSI.","code":""},{"path":"https://msberends.github.io/AMR/reference/intrinsic_resistant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant #> # A tibble: 134,634 × 2 #>    mo      ab    #>    <mo>    <chr> #>  1 B_GRAMP ATM   #>  2 B_GRAMP COL   #>  3 B_GRAMP NAL   #>  4 B_GRAMP PLB   #>  5 B_GRAMP TEM   #>  6 B_ABTRP ATM   #>  7 B_ABTRP COL   #>  8 B_ABTRP NAL   #>  9 B_ABTRP PLB   #> 10 B_ABTRP TEM   #> # ℹ 134,624 more rows"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 × 23 #>   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… #> # ℹ 13 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_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 × 23 #>   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… #> # ℹ 13 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_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\"         \"status\"           #>  [5] \"kingdom\"          \"phylum\"           \"class\"            \"order\"            #>  [9] \"family\"           \"genus\"            \"species\"          \"subspecies\"       #> [13] \"rank\"             \"ref\"              \"oxygen_tolerance\" \"source\"           #> [17] \"lpsn\"             \"lpsn_parent\"      \"lpsn_renamed_to\"  \"gbif\"             #> [21] \"gbif_parent\"      \"gbif_renamed_to\"  \"prevalence\"       \"snomed\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     left_join_microorganisms() %>%     colnames() } #> Joining, by = \"mo\" #>  [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\"              \"NIT\"              \"FOS\"              #> [29] \"LNZ\"              \"CIP\"              \"MFX\"              \"VAN\"              #> [33] \"TEC\"              \"TCY\"              \"TGC\"              \"DOX\"              #> [37] \"ERY\"              \"CLI\"              \"AZM\"              \"IPM\"              #> [41] \"MEM\"              \"MTR\"              \"CHL\"              \"COL\"              #> [45] \"MUP\"              \"RIF\"              \"fullname\"         \"status\"           #> [49] \"kingdom\"          \"phylum\"           \"class\"            \"order\"            #> [53] \"family\"           \"genus\"            \"species\"          \"subspecies\"       #> [57] \"rank\"             \"ref\"              \"oxygen_tolerance\" \"source\"           #> [61] \"lpsn\"             \"lpsn_parent\"      \"lpsn_renamed_to\"  \"gbif\"             #> [65] \"gbif_parent\"      \"gbif_renamed_to\"  \"prevalence\"       \"snomed\"           # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/key_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"key_antimicrobials(   x = NULL,   col_mo = NULL,   universal = c(\"ampicillin\", \"amoxicillin/clavulanic acid\", \"cefuroxime\",     \"piperacillin/tazobactam\", \"ciprofloxacin\", \"trimethoprim/sulfamethoxazole\"),   gram_negative = c(\"gentamicin\", \"tobramycin\", \"colistin\", \"cefotaxime\", \"ceftazidime\",     \"meropenem\"),   gram_positive = c(\"vancomycin\", \"teicoplanin\", \"tetracycline\", \"erythromycin\",     \"oxacillin\", \"rifampin\"),   antifungal = c(\"anidulafungin\", \"caspofungin\", \"fluconazole\", \"miconazole\", \"nystatin\",     \"voriconazole\"),   only_sir_columns = FALSE,   ... )  all_antimicrobials(x = NULL, only_sir_columns = FALSE, ...)  antimicrobials_equal(   y,   z,   type = c(\"points\", \"keyantimicrobials\"),   ignore_I = TRUE,   points_threshold = 2,   ... )"},{"path":"https://msberends.github.io/AMR/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 antibiotics columns, like AMX amox. Can left blank determine automatically col_mo column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). universal names broad-spectrum antimicrobial drugs, case-insensitive. Set NULL ignore. See Details default antimicrobial drugs gram_negative names antibiotic drugs Gram-positives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs gram_positive names antibiotic drugs Gram-negatives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs antifungal names antifungal drugs fungi, case-insensitive. Set NULL ignore. See Details default antifungal drugs only_sir_columns logical indicate whether columns must included transformed class sir (see .sir()) beforehand (default FALSE) ... ignored, place allow future extensions y, z character vectors compare type type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details points_threshold minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics 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] 1376 # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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)  # S3 method for default kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for matrix kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for data.frame kurtosis(x, na.rm = FALSE, excess = FALSE)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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.021297 kurtosis(rnorm(10000), excess = TRUE) #> [1] 0.08143396"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/mdro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"mdro(   x = NULL,   guideline = \"CMI2012\",   col_mo = NULL,   info = interactive(),   pct_required_classes = 0.5,   combine_SI = TRUE,   verbose = FALSE,   only_sir_columns = FALSE,   ... )  custom_mdro_guideline(..., as_factor = TRUE)  brmo(x = NULL, only_sir_columns = FALSE, ...)  mrgn(x = NULL, only_sir_columns = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = FALSE, ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = FALSE, ...)"},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"See supported guidelines list publications used function.","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"x data.frame antibiotics 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(). info logical indicate whether progress printed console - default print interactive sessions pct_required_classes minimal required percentage antimicrobial classes must available per isolate, rounded . example, default guideline, 17 antimicrobial classes must available S. aureus. Setting pct_required_classes argument 0.5 (default) means every S. aureus isolate least 8 different classes must available. lower number available classes return NA isolate. combine_SI logical indicate whether values S must merged one, resistance considered isolates R, . default behaviour mdro() function, follows redefinition EUCAST interpretation (increased exposure) 2019, see section 'Interpretation S, R' . using combine_SI = FALSE, resistance considered isolates R . verbose logical turn Verbose mode (default ). Verbose mode, function return MDRO results, instead returns data set logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antibiotic columns must detected transformed class sir (see .sir()) beforehand (default FALSE) ... case custom_mdro_guideline(): set rules, see section Using Custom Guidelines . Otherwise: column name antibiotic, see section Antibiotics . as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"CMI 2012 paper - function mdr_cmi2012() mdro(): Ordered factor levels Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant (XDR) < Pandrug-resistant (PDR) TB guideline - function mdr_tb() mdro(..., guideline = \"TB\"): Ordered factor levels Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant < Extensively drug-resistant German guideline - function mrgn() mdro(..., guideline = \"MRGN\"): Ordered factor levels Negative < 3MRGN < 4MRGN Everything else, except custom guidelines: Ordered factor levels Negative < Positive, unconfirmed < Positive. value \"Positive, unconfirmed\" means , according guideline, entirely sure isolate multi-drug resistant confirmed additional (e.g. molecular) tests","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/mdro.html","id":"supported-international-national-guidelines","dir":"Reference","previous_headings":"","what":"Supported International / National Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Currently supported guidelines (case-insensitive): guideline = \"CMI2012\" (default) Magiorakos AP, Srinivasan et al. \"Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.\" Clinical Microbiology Infection (2012) (doi:10.1111/j.1469-0691.2011.03570.x ) guideline = \"EUCAST3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.2\" European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST3.1\" European international guideline - EUCAST Expert Rules Version 3.1 \"Intrinsic Resistance Exceptional Phenotypes Tables\" (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization \"Companion handbook guidelines programmatic management drug-resistant tuberculosis\" (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7; doi:10.1186/s13756-015-0047-6 guideline = \"BRMO\" Dutch national guideline - Rijksinstituut voor Volksgezondheid en Milieu \"WIP-richtlijn BRMO (Bijzonder Resistente Micro-Organismen) (ZKH)\" (link) Please suggest (country-specific) guidelines letting us know: https://github.com/msberends/AMR/issues/new.","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"using-custom-guidelines","dir":"Reference","previous_headings":"","what":"Using Custom Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Custom guidelines can set custom_mdro_guideline() function. great importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   row/isolate matches first rule, value first ~ (case 'Elderly Type ') set MDRO value. Otherwise, second rule tried . number rules unlimited. can print rules set console overview. Colours help reading console supports colours.   outcome function can used guideline argument mdro() function:   Rules can also combined custom rules using c():   rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":"custom <- custom_mdro_guideline(CIP == \"R\" & age > 60 ~ \"Elderly Type A\",                                 ERY == \"R\" & age > 60 ~ \"Elderly Type B\") custom #> A set of custom MDRO rules: #>   1. CIP is \"R\" and age is higher than 60 -> Elderly Type A #>   2. ERY is \"R\" and age is higher than 60 -> Elderly Type B #>   3. Otherwise -> Negative #> #> Unmatched rows will return NA. x <- mdro(example_isolates,           guideline = custom) table(x) #>       Negative Elderly Type A Elderly Type B #>           1070            198            732 x <- mdro(example_isolates,           guideline = c(custom,                         custom_mdro_guideline(ERY == \"R\" & age > 50 ~ \"Elderly Type C\"))) table(x) #>       Negative Elderly Type A Elderly Type B Elderly Type C #>            961            198            732            109"},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"antibiotics","dir":"Reference","previous_headings":"","what":"Antibiotics","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"define antibiotics column names, leave determine automatically guess_ab_col() input text (case-insensitive), use NULL skip column (e.g. TIC = NULL skip ticarcillin). Manually defined non-existing columns skipped warning. following antibiotics eligible functions eucast_rules() mdro(). shown format 'name (antimicrobial ID, ATC code)', sorted alphabetically: Amikacin (AMK, J01GB06), amoxicillin (AMX, J01CA04), amoxicillin/clavulanic acid (AMC, J01CR02), ampicillin (AMP, J01CA01), ampicillin/sulbactam (SAM, J01CR01), apramycin (APR, QA07AA92), arbekacin (ARB, J01GB12), aspoxicillin (APX, J01CA19), azidocillin (AZD, J01CE04), azithromycin (AZM, J01FA10), azlocillin (AZL, J01CA09), aztreonam (ATM, J01DF01), bacampicillin (BAM, J01CA06), bekanamycin (BEK, J01GB13), benzathine benzylpenicillin (BNB, J01CE08), benzathine phenoxymethylpenicillin (BNP, J01CE10), benzylpenicillin (PEN, J01CE01), besifloxacin (BES, S01AE08), biapenem (BIA, J01DH05), carbenicillin (CRB, J01CA03), carindacillin (CRN, J01CA05), cefacetrile (CAC, J01DB10), cefaclor (CEC, J01DC04), cefadroxil (CFR, J01DB05), cefalexin (LEX, J01DB01), cefaloridine (RID, J01DB02), cefalotin (CEP, J01DB03), cefamandole (MAN, J01DC03), cefapirin (HAP, J01DB08), cefatrizine (CTZ, J01DB07), cefazedone (CZD, J01DB06), cefazolin (CZO, J01DB04), cefcapene (CCP, J01DD17), cefdinir (CDR, J01DD15), cefditoren (DIT, J01DD16), cefepime (FEP, J01DE01), cefetamet (CAT, J01DD10), cefixime (CFM, J01DD08), cefmenoxime (CMX, J01DD05), cefmetazole (CMZ, J01DC09), cefodizime (DIZ, J01DD09), cefonicid (CID, J01DC06), cefoperazone (CFP, J01DD12), cefoperazone/sulbactam (CSL, J01DD62), ceforanide (CND, J01DC11), cefotaxime (CTX, J01DD01), cefotaxime/clavulanic acid (CTC, J01DD51), cefotetan (CTT, J01DC05), cefotiam (CTF, J01DC07), cefovecin (FOV, QJ01DD91), cefoxitin (FOX, J01DC01), cefozopran (ZOP, J01DE03), cefpiramide (CPM, J01DD11), cefpirome (CPO, J01DE02), cefpodoxime (CPD, J01DD13), cefprozil (CPR, J01DC10), cefquinome (CEQ, QG51AA07), cefroxadine (CRD, J01DB11), cefsulodin (CFS, J01DD03), ceftaroline (CPT, J01DI02), ceftazidime (CAZ, J01DD02), ceftazidime/clavulanic acid (CCV, J01DD52), cefteram (CEM, J01DD18), ceftezole (CTL, J01DB12), ceftibuten (CTB, J01DD14), ceftiofur (TIO, QJ01DD90), ceftizoxime (CZX, J01DD07), ceftobiprole medocaril (CFM1, J01DI01), ceftolozane/tazobactam (CZT, J01DI54), ceftriaxone (CRO, J01DD04), ceftriaxone/beta-lactamase inhibitor (CEB, J01DD63), cefuroxime (CXM, J01DC02), cephradine (CED, J01DB09), chloramphenicol (CHL, J01BA01), ciprofloxacin (CIP, J01MA02), clarithromycin (CLR, J01FA09), clindamycin (CLI, J01FF01), clometocillin (CLM, J01CE07), cloxacillin (CLO, J01CF02), colistin (COL, J01XB01), cycloserine (CYC, J04AB01), dalbavancin (DAL, J01XA04), danofloxacin (DAN, QJ01MA92), daptomycin (DAP, J01XX09), delafloxacin (DFX, J01MA23), dibekacin (DKB, J01GB09), dicloxacillin (DIC, J01CF01), difloxacin (DIF, QJ01MA94), dirithromycin (DIR, J01FA13), doripenem (DOR, J01DH04), doxycycline (DOX, J01AA02), enoxacin (ENX, J01MA04), enrofloxacin (ENR, QJ01MA90), epicillin (EPC, J01CA07), ertapenem (ETP, J01DH03), erythromycin (ERY, J01FA01), fleroxacin (FLE, J01MA08), flucloxacillin (FLC, J01CF05), flurithromycin (FLR1, J01FA14), fosfomycin (FOS, J01XX01), framycetin (FRM, D09AA01), fusidic acid (FUS, J01XC01), gamithromycin (GAM, QJ01FA95), garenoxacin (GRN, J01MA19), gatifloxacin (GAT, J01MA16), gemifloxacin (GEM, J01MA15), gentamicin (GEN, J01GB03), grepafloxacin (GRX, J01MA11), hetacillin (HET, J01CA18), imipenem (IPM, J01DH51), imipenem/relebactam (IMR, J01DH56), isepamicin (ISE, J01GB11), josamycin (JOS, J01FA07), kanamycin (KAN, J01GB04), kitasamycin (KIT, QJ01FA93), lascufloxacin (LSC, J01MA25), latamoxef (LTM, J01DD06), levofloxacin (LVX, J01MA12), levonadifloxacin (LND, J01MA24), lincomycin (LIN, J01FF02), linezolid (LNZ, J01XX08), lomefloxacin (LOM, J01MA07), loracarbef (LOR, J01DC08), marbofloxacin (MAR, QJ01MA93), mecillinam (MEC, J01CA11), meropenem (MEM, J01DH02), meropenem/vaborbactam (MEV, J01DH52), metampicillin (MTM, J01CA14), meticillin (MET, J01CF03), mezlocillin (MEZ, J01CA10), micronomicin (MCR, S01AA22), midecamycin (MID, J01FA03), minocycline (MNO, J01AA08), miocamycin (MCM, J01FA11), moxifloxacin (MFX, J01MA14), nadifloxacin (NAD, D10AF05), nafcillin (NAF, J01CF06), nalidixic acid (NAL, J01MB02), neomycin (NEO, J01GB05), netilmicin (NET, J01GB07), nitrofurantoin (NIT, J01XE01), norfloxacin (, J01MA06), novobiocin (NOV, QJ01XX95), ofloxacin (OFX, J01MA01), oleandomycin (OLE, J01FA05), orbifloxacin (ORB, QJ01MA95), oritavancin (ORI, J01XA05), oxacillin (OXA, J01CF04), panipenem (PAN, J01DH55), pazufloxacin (PAZ, J01MA18), pefloxacin (PEF, J01MA03), penamecillin (PNM, J01CE06), pheneticillin (PHE, J01CE05), phenoxymethylpenicillin (PHN, J01CE02), piperacillin (PIP, J01CA12), piperacillin/tazobactam (TZP, J01CR05), pirlimycin (PRL, QJ51FF90), pivampicillin (PVM, J01CA02), pivmecillinam (PME, J01CA08), plazomicin (PLZ, J01GB14), polymyxin B (PLB, J01XB02), pradofloxacin (PRA, QJ01MA97), pristinamycin (PRI, J01FG01), procaine benzylpenicillin (PRB, J01CE09), propicillin (PRP, J01CE03), prulifloxacin (PRU, J01MA17), quinupristin/dalfopristin (QDA, QJ01FG02), ribostamycin (RST, J01GB10), rifampicin (RIF, J04AB02), rokitamycin (ROK, J01FA12), roxithromycin (RXT, J01FA06), rufloxacin (RFL, J01MA10), sarafloxacin (SAR, QJ01MA98), sisomicin (SIS, J01GB08), sitafloxacin (SIT, J01MA21), solithromycin (SOL, J01FA16), sparfloxacin (SPX, J01MA09), spiramycin (SPI, J01FA02), streptoduocin (STR, J01GA02), streptomycin (STR1, J01GA01), sulbactam (SUL, J01CG01), sulbenicillin (SBC, J01CA16), sulfadiazine (SDI, J01EC02), sulfadiazine/trimethoprim (SLT1, J01EE02), sulfadimethoxine (SUD, J01ED01), sulfadimidine (SDM, J01EB03), sulfadimidine/trimethoprim (SLT2, J01EE05), sulfafurazole (SLF, J01EB05), sulfaisodimidine (SLF1, J01EB01), sulfalene (SLF2, J01ED02), sulfamazone (SZO, J01ED09), sulfamerazine (SLF3, J01ED07), sulfamerazine/trimethoprim (SLT3, J01EE07), sulfamethizole (SLF4, J01EB02), sulfamethoxazole (SMX, J01EC01), sulfamethoxypyridazine (SLF5, J01ED05), sulfametomidine (SLF6, J01ED03), sulfametoxydiazine (SLF7, J01ED04), sulfametrole/trimethoprim (SLT4, J01EE03), sulfamoxole (SLF8, J01EC03), sulfamoxole/trimethoprim (SLT5, J01EE04), sulfanilamide (SLF9, J01EB06), sulfaperin (SLF10, J01ED06), sulfaphenazole (SLF11, J01ED08), sulfapyridine (SLF12, J01EB04), sulfathiazole (SUT, J01EB07), sulfathiourea (SLF13, J01EB08), sultamicillin (SLT6, J01CR04), talampicillin (TAL, J01CA15), tazobactam (TAZ, J01CG02), tebipenem (TBP, J01DH06), tedizolid (TZD, J01XX11), teicoplanin (TEC, J01XA02), telavancin (TLV, J01XA03), telithromycin (TLT, J01FA15), temafloxacin (TMX, J01MA05), temocillin (TEM, J01CA17), tetracycline (TCY, J01AA07), ticarcillin (TIC, J01CA13), ticarcillin/clavulanic acid (TCC, J01CR03), tigecycline (TGC, J01AA12), tilbroquinol (TBQ, P01AA05), tildipirosin (TIP, QJ01FA96), tilmicosin (TIL, QJ01FA91), tobramycin (TOB, J01GB01), tosufloxacin (TFX, J01MA22), trimethoprim (TMP, J01EA01), trimethoprim/sulfamethoxazole (SXT, J01EE01), troleandomycin (TRL, J01FA08), trovafloxacin (TVA, J01MA13), tulathromycin (TUL, QJ01FA94), tylosin (TYL, QJ01FA90), tylvalosin (TYL1, QJ01FA92), vancomycin (VAN, J01XA01)","code":""},{"path":"https://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://msberends.github.io/AMR/reference/mdro.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"out <- mdro(example_isolates, guideline = \"EUCAST\") str(out) #>  Ord.factor w/ 3 levels \"Negative\"<\"Positive, unconfirmed\"<..: 1 1 1 1 1 1 1 1 1 1 ... table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1978                     0                     6   out <- mdro(example_isolates,   guideline = custom_mdro_guideline(     AMX == \"R\" ~ \"Custom MDRO 1\",     VAN == \"R\" ~ \"Custom MDRO 2\"   ) ) table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>           870           804           326   # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     mdro() %>%     table()    # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     pull(MDRO) %>%     table() } #> Warning: in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `MDRO = mdro()`. #> Caused by warning: #> ! in mdro(): NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with pct_required_classes) #> . #>                         Negative       Multi-drug-resistant (MDR)  #>                             1601                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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 sir mean_amr_distance(x, ..., combine_SI = TRUE)  # S3 method for data.frame mean_amr_distance(x, ..., combine_SI = TRUE)  amr_distance_from_row(amr_distance, row)"},{"path":"https://msberends.github.io/AMR/reference/mean_amr_distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"x vector class sir, mic disk, data.frame containing columns classes ... variables select (supports tidyselect language column1:column4 (.mic), can thus also antibiotic selectors combine_SI logical indicate whether values S 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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] R R S I I S I I R I mean_amr_distance(sir) #>  [1]  1.449138  1.449138 -0.621059 -0.621059 -0.621059 -0.621059 -0.621059 #>  [8] -0.621059  1.449138 -0.621059  mic <- random_mic(10) mic #> Class 'mic' #>  [1] 0.002 0.5   0.125 128   0.25  0.5   256   0.125 0.125 64    mean_amr_distance(mic) #>  [1] -1.6429088 -0.1673475 -0.5378223  1.3145519 -0.3525849 -0.1673475 #>  [7]  1.4997893 -0.5378223 -0.5378223  1.1293145 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1] -1.6429088 -0.1673475 -0.5378223  1.3145519 -0.3525849 -0.1673475 #>  [7]  1.4997893 -0.5378223 -0.5378223  1.1293145  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 40 45 43 14 42 40 37 15 42 11 mean_amr_distance(disk) #>  [1]  0.5182957  0.8832927  0.7372939 -1.3796886  0.6642945  0.5182957 #>  [7]  0.2992975 -1.3066892  0.6642945 -1.5986868  y <- data.frame(   id = LETTERS[1:10],   amox = random_sir(10, ab = \"amox\", mo = \"Escherichia coli\"),   cipr = random_disk(10, ab = \"cipr\", mo = \"Escherichia coli\"),   gent = random_mic(10, ab = \"gent\", mo = \"Escherichia coli\"),   tobr = random_mic(10, ab = \"tobr\", mo = \"Escherichia coli\") ) y #>    id amox cipr  gent  tobr #> 1   A    R   17 <=0.5   >=8 #> 2   B    I   26 <=0.5     4 #> 3   C    R   18     4   >=8 #> 4   D    R   22 <=0.5 <=0.5 #> 5   E    I   30 <=0.5     1 #> 6   F    S   18     4     2 #> 7   G    I   26     8     2 #> 8   H    S   29     8     1 #> 9   I    I   22    16     1 #> 10  J    S   31     1     4 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.12957466 -0.14083442  0.55230568 -0.36152662 -0.31478853 -0.33012168 #>  [7]  0.17672648  0.13748045 -0.07163669  0.22282068 y$amr_distance <- mean_amr_distance(y, where(is.mic)) #> Error in .subset(x, j): invalid subscript type 'list' y[order(y$amr_distance), ] #> Error in order(y$amr_distance): argument 1 is not a vector  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   18     4   >=8   0.55230568  0.0000000 #> 2   J    S   31     1     4   0.22282068  0.3294850 #> 3   G    I   26     8     2   0.17672648  0.3755792 #> 4   H    S   29     8     1   0.13748045  0.4148252 #> 5   A    R   17 <=0.5   >=8   0.12957466  0.4227310 #> 6   I    I   22    16     1  -0.07163669  0.6239424 #> 7   B    I   26 <=0.5     4  -0.14083442  0.6931401 #> 8   E    I   30 <=0.5     1  -0.31478853  0.8670942 #> 9   F    S   18     4     2  -0.33012168  0.8824274 #> 10  D    R   22 <=0.5 <=0.5  -0.36152662  0.9138323 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://msberends.github.io/AMR/reference/microorganisms.codes.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 4 957 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://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"tibble 4 957 observations 2 variables: code Commonly used code microorganism. unique identifier. mo ID microorganism microorganisms data set","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/microorganisms.codes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 4 957 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 4,957 × 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      #> # ℹ 4,947 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\" #>  #> $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\" #>  #> $gbif #> [1] \"11286021\" #>  #> $group_members #> character(0) #>   # works for all AMR functions: mo_is_intrinsic_resistant(\"eco\", ab = \"vancomycin\") #> [1] TRUE"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"data set containing species groups microbiological complexes, used clinical breakpoints table.","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"tibble 521 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://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/microorganisms.groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 521 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups #> # A tibble: 521 × 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_DJKS 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_BCTRD_VLGT Bacteroides fragilis complex    Bacteroides vulg… #> # ℹ 511 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_BCTRD_VLGT Bacteroides fragilis complex Bacteroides vulgatus  #> 5 B_BCTRD_FRGL-C B_PRBCT_DSTS Bacteroides fragilis complex Parabacteroides dist…"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 52 171 Microorganisms — microorganisms","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"data set containing full microbial taxonomy (last updated: January 8th, 2024) five kingdoms List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF). data set backbone AMR package. MO codes can looked using .mo().","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"","code":"microorganisms"},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"tibble 52 171 observations 23 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\" \"synonym\" kingdom, phylum, class, order, family, genus, species, subspecies Taxonomic rank microorganism 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. 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. 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 73.4% ~37 000 bacteria data set contain oxygen tolerance. lpsn_parent LPSN identifier parent taxon lpsn_renamed_to LPSN identifier currently valid taxon gbif Identifier ('taxonID') Global Biodiversity Information Facility (GBIF) gbif_parent GBIF identifier parent taxon gbif_renamed_to GBIF identifier currently valid taxon source Either \"GBIF\", \"LPSN\", \"manually added\" (see Source) 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 1st, 2021 (see Source). Use mo_snomed() retrieve quickly, see mo_property().","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"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 December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org January 8th, 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 May 12th, 2023. 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://phinvads.cdc.gov 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://msberends.github.io/AMR/reference/microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"Please note entries based List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (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://msberends.github.io/AMR/reference/microorganisms.html","id":"included-taxa","dir":"Reference","previous_headings":"","what":"Included Taxa","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"Included taxonomic data : ~37 000 (sub)species kingdoms Archaea Bacteria ~7 900 (sub)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). ~5 100 (sub)species kingdom Protozoa ~1 400 (sub)species 43 relevant genera kingdom Animalia (Strongyloides Taenia) ~9 800 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://msberends.github.io/AMR/reference/microorganisms.html","id":"manual-additions","dir":"Reference","previous_headings":"","what":"Manual additions","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"convenience, entries added manually: ~1 500 entries Salmonella, city-like serovars groups H 36 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 : https://github.com/msberends/AMR/blob/main/data-raw/reproduction_of_microorganisms.R.","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"direct-download","dir":"Reference","previous_headings":"","what":"Direct download","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"Like data sets package, data set publicly available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"about-the-records-from-lpsn-see-source-","dir":"Reference","previous_headings":"","what":"About the Records from LPSN (see Source)","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"LPSN main source bacteriological taxonomy AMR package. List Prokaryotic names Standing Nomenclature (LPSN) provides comprehensive information nomenclature prokaryotes. LPSN free use service founded Jean P. Euzeby 1997 later maintained Aidan C. Parte.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/reference/microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 52 171 Microorganisms — microorganisms","text":"","code":"microorganisms #> # A tibble: 52,171 × 23 #>    mo               fullname      status kingdom phylum class order family genus #>    <mo>             <chr>         <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> #>  1 B_GRAMN          (unknown Gra… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  2 B_GRAMP          (unknown Gra… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  3 B_ANAER-NEG      (unknown ana… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  4 B_ANAER-POS      (unknown ana… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  5 B_ANAER          (unknown ana… accep… Bacter… (unkn… (unk… (unk… \"(unk… \"(un… #>  6 F_FUNGUS         (unknown fun… accep… Fungi   (unkn… (unk… (unk… \"(unk… \"(un… #>  7   UNKNOWN        (unknown nam… accep… (unkno… (unkn… (unk… (unk… \"(unk… \"(un… #>  8 F_YEAST          (unknown yea… accep… Fungi   (unkn… (unk… (unk… \"(unk… \"(un… #>  9 B_[FAM]_ABDTBCTR Abditibacter… accep… Bacter… Abdit… Abdi… Abdi… \"Abdi… \"\"    #> 10 B_[ORD]_ABDTBCTR Abditibacter… accep… Bacter… Abdit… Abdi… Abdi… \"\"     \"\"    #> # ℹ 52,161 more rows #> # ℹ 14 more variables: species <chr>, subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 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.","code":""},{"path":"https://msberends.github.io/AMR/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 :  : \\(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, 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.0 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, genus present established list also prevalence = 1.0 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, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Conidiobolus, Contracaecum, Cordylobia, Cryptococcus, Curvularia, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Haloarcula, Halobacterium, Halococcus, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kodamaea, Leishmania, Lichtheimia, Lodderomyces, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Pediculus, Penicillium, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoterranova, Pulex, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saprochaete, Sarcoptes, Scedosporium, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporotrichum, Stachybotrys, Strongyloides, Syngamus, Taenia, Talaromyces, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Verticillium, Wuchereria; 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://msberends.github.io/AMR/reference/mo_matching_score.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":"https://msberends.github.io/AMR/reference/mo_matching_score.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"Dr. Matthijs Berends, 2018","code":""},{"path":"https://msberends.github.io/AMR/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. #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterobacter cowanii (0.600), Eubacterium combesii #>               (0.600), Eggerthia catenaformis (0.591), Eubacterium callanderi #>               (0.591), Enterocloster citroniae (0.587), Eubacterium cylindroides #>               (0.583), Enterococcus casseliflavus (0.577), Enterobacter cloacae #>               cloacae (0.571), Enterobacter cloacae complex (0.571), and Ehrlichia #>               canis (0.567) #>  #> 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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_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://msberends.github.io/AMR/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\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\", must \"shortname\"","code":""},{"path":"https://msberends.github.io/AMR/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() named character case mo_url() character cases","code":""},{"path":"https://msberends.github.io/AMR/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) mo_ref(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Hormaeche et al., 1960\" (warning) 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 fungi phylum Ascomycota, class Saccharomycetes (also called Hemiascomycetes). True yeasts aggregated underlying order Saccharomycetales. Thus, microorganisms member taxonomic class Saccharomycetes, 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 Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021). mo_is_intrinsic_resistant() function can vectorised argument x (input microorganisms) ab (input antibiotics). 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. SNOMED codes (mo_snomed()) version July 1st, 2021. 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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 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 Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571 Berends MS et al. (2022). Trends Occurrence Phenotypic Resistance Coagulase-Negative Staphylococci (CoNS) Found Human Blood Northern Netherlands 2013 2019/ Micro.rganisms 10(9), 1801; doi:10.3390/microorganisms10091801 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 December 11th, 2022. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org January 8th, 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 May 12th, 2023. 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://phinvads.cdc.gov Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://msberends.github.io/AMR/reference/mo_property.html","id":"reference-data-publicly-available","dir":"Reference","previous_headings":"","what":"Reference Data Publicly Available","title":"Get Properties of a Microorganism — mo_property","text":"data sets AMR package (microorganisms, antibiotics, SIR interpretation, EUCAST rules, etc.) publicly freely available download following formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, SAS, Stata. also provide tab-separated plain text files machine-readable suitable input software program, laboratory information systems. Please visit website download links. actual files course available GitHub repository.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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(\"Streptococcus group A\") #> [1] \"Streptococcus pyogenes\" mo_group_members(c(\"Streptococcus group C\",                    \"Streptococcus group G\",                    \"Streptococcus group L\")) #> $`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_lpsn(\"Klebsiella aerogenes\") #> [1] \"777146\" mo_gbif(\"Klebsiella aerogenes\") #> [1] \"9281703\" mo_synonyms(\"Klebsiella aerogenes\") #>   Hormaeche et al., 1960     Bascomb et al., 1971  #> \"Enterobacter aerogenes\"     \"Klebsiella mobilis\"    # 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: 20 × 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          8 #>  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 Lactobacillus        1 #> 19 Leuconostoc          1 #> 20 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\" #>  #> $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] \"aerobe\" #>  #> $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\" #>  #> $gbif #> [1] \"3221874\" #>  #> $group_members #> character(0) #>  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 \"home//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(\"home/me/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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)   # new ggplot2 plotting method using this package:   if (require(\"ggplot2\")) {     ggplot_pca(pca_result)      ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"Title here\")   } } #> 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\"` and `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://msberends.github.io/AMR/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Plotting for Classes sir, mic and disk — plot","title":"Plotting for Classes sir, mic and disk — 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://msberends.github.io/AMR/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plotting for Classes sir, mic and disk — plot","text":"","code":"scale_x_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  scale_y_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  scale_colour_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  scale_fill_mic(keep_operators = \"edges\", mic_range = NULL, drop = FALSE, ...)  # S3 method for mic plot(   x,   mo = NULL,   ab = NULL,   guideline = \"EUCAST\",   main = deparse(substitute(x)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for mic autoplot(   object,   mo = NULL,   ab = NULL,   guideline = \"EUCAST\",   title = deparse(substitute(object)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for mic fortify(object, ...)  # S3 method for 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 = \"EUCAST\",   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for 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 = \"EUCAST\",   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"),   ... )  # S3 method for disk fortify(object, ...)  # S3 method for 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 sir autoplot(   object,   title = deparse(substitute(object)),   xlab = translate_AMR(\"Antimicrobial Interpretation\", language = language),   ylab = translate_AMR(\"Frequency\", language = language),   colours_SIR = c(\"#3CAEA3\", \"#F6D55C\", \"#ED553B\"),   language = get_AMR_locale(),   ... )  # S3 method for sir fortify(object, ...)"},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plotting for Classes sir, mic and disk — 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 limit MIC values, e.g., mic_range = c(0.001, 32). Use NA set limit one side, e.g., mic_range = c(NA, 32). drop logical remove intermediate MIC values, defaults FALSE ... arguments passed methods 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 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 language = \"\" prevent translation. 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\".","code":""},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Plotting for Classes sir, mic and disk — plot","text":"autoplot() functions return ggplot model extendible ggplot2 function. fortify() functions return data.frame extension usage ggplot2::ggplot() function.","code":""},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Plotting for Classes sir, mic and disk — plot","text":"interpretation \"\" named \"Increased exposure\" EUCAST guidelines since 2019, named \"Intermediate\" cases. interpreting MIC values well disk diffusion diameters, supported guidelines used input guideline argument : \"EUCAST 2023\", \"EUCAST 2022\", \"EUCAST 2021\", \"EUCAST 2020\", \"EUCAST 2019\", \"EUCAST 2018\", \"EUCAST 2017\", \"EUCAST 2016\", \"EUCAST 2015\", \"EUCAST 2014\", \"EUCAST 2013\", \"EUCAST 2012\", \"EUCAST 2011\", \"CLSI 2023\", \"CLSI 2022\", \"CLSI 2021\", \"CLSI 2020\", \"CLSI 2019\", \"CLSI 2018\", \"CLSI 2017\", \"CLSI 2016\", \"CLSI 2015\", \"CLSI 2014\", \"CLSI 2013\", \"CLSI 2012\", \"CLSI 2011\". Simply using \"CLSI\" \"EUCAST\" input automatically select latest version guideline.","code":""},{"path":"https://msberends.github.io/AMR/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plotting for Classes sir, mic and disk — 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))  plot(some_mic_values)  plot(some_disk_values)  plot(some_sir_values)   # when providing the microorganism and antibiotic, colours will show interpretations: plot(some_mic_values, mo = \"S. aureus\", ab = \"ampicillin\") #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 23, 1 plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\") #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 15, 1 plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\", language = \"nl\") #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 15, 1   # Plotting using scale_x_mic() # \\donttest{ if (require(\"ggplot2\")) {   mic_plot <- ggplot(data.frame(mics = as.mic(c(0.125, \"<=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, 128)) +     labs(title = \"with scale_x_mic() using a manual range\") }   if (require(\"ggplot2\")) {   autoplot(some_mic_values) }  if (require(\"ggplot2\")) {   autoplot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\") } #> Error in data.frame(values = x, mo = mo, ab = ab, result = NA_sir_, uti = uti,     host = host, stringsAsFactors = FALSE): arguments imply differing number of rows: 15, 1 if (require(\"ggplot2\")) {   autoplot(some_sir_values) }  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 antibiotics, see section Combination Therapy ab_result antibiotic results test , must one values \"S\", \"\", \"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 antibiotics 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 must merged one, output consists S+vs. R (susceptible vs. resistant) - default TRUE","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/proportion.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate Antimicrobial Resistance — proportion","text":"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://msberends.github.io/AMR/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 antibiotics/variables test . See example two antibiotics, 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   include as  include as   include as  include as                     numerator   denominator  numerator   denominator --------  --------  ----------  -----------  ----------  -----------  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://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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) #> Note that proportion_SI() will also include dose-dependent #> susceptibility, 'SDD'. This note will be shown once for this session. #> [1] 0.4044444 proportion_I(example_isolates$AMX) #> Note that proportion_I() will also include dose-dependent susceptibility, #> 'SDD'. This note will be shown once for this session. #> [1] 0.002222222 proportion_IR(example_isolates$AMX) #> Note that proportion_IR() will also include dose-dependent #> susceptibility, 'SDD'. This note will be shown once for this session. #> [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 antibiotic 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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/random.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(size = NULL, mo = NULL, ab = NULL, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, ...)  random_sir(size = NULL, prob_SIR = c(0.33, 0.33, 0.33), ...)"},{"path":"https://msberends.github.io/AMR/reference/random.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"size desired size returned vector. used data.frame call dplyr verb, get current (group) size left blank. mo character can coerced valid microorganism code .mo() ab character can coerced valid antimicrobial drug code .ab() ... ignored, place allow future extensions prob_SIR vector length 3: probabilities \"S\" (1st value), \"\" (2nd value) \"R\" (3rd value)","code":""},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/random.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"base R function sample() used generating values. Generated values based EUCAST 2023 guideline implemented clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument.","code":""},{"path":"https://msberends.github.io/AMR/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] 16     64     256    0.002  1      0.001  64     0.25   1      16     #> [11] 0.5    8      8      0.0625 1      0.5    0.025  256    256    1      #> [21] 0.01   1      64     32     4      random_disk(25) #> Class 'disk' #>  [1] 49 47 14 33 49 43 41 41 43 31 20 43 42 11 18 42  8 42 16 25 42  8 15 30 29 random_sir(25) #> Class 'sir' #>  [1] I S S I S I I S R S S I I S S I I S I R S S R I S  # \\donttest{ # make the random generation more realistic by setting a bug and/or drug: random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 64     0.025  2      0.25   32     64     0.002  32     0.01   0.001  #> [11] 0.25   0.125  0.0625 64     128    0.002  128    128    1      0.002  #> [21] 1      0.005  0.001  4      0.001  random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] 1    2    1    >=16 8    1    >=16 >=16 2    1    2    1    1    8    4    #> [16] 1    1    4    2    >=16 >=16 2    4    2    1    random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] 2     0.25  >=8   >=8   0.5   1     1     0.125 0.25  1     2     1     #> [13] 0.25  >=8   0.25  2     1     1     >=8   0.125 0.5   >=8   0.125 0.25  #> [25] 0.25   random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 45 49 24 46 23 18 15 17 17 28 40 20 21 43 39  9 33 17  8 20 30 21 44 48 41 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 13 15 11 14 16 16 11 15 11 17 14 15 17 17 16 16 16 12 14 12 15 13 13 13 16 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 22 23 19 19 23 15 23 18 21 24 22 25 19 19 16 17 17 16 27 21 27 25 15 21 27 # }"},{"path":"https://msberends.github.io/AMR/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 statistical solid ground. Standard errors (SE) returned columns se_min se_max. See Examples real live example.","code":""},{"path":"https://msberends.github.io/AMR/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 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 resistance_predict autoplot(   object,   main = paste(\"Resistance Prediction of\", x_name),   ribbon = TRUE,   ... )"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/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 shown (https://www.eucast.org/newsiandr): S - Susceptible, standard dosing regimen microorganism categorised \"Susceptible, standard dosing regimen\", high likelihood therapeutic success using standard dosing regimen agent. - Susceptible, increased exposure  microorganism categorised \"Susceptible, Increased exposure\" high likelihood therapeutic success exposure agent increased adjusting dosing regimen concentration site infection. R = Resistant microorganism categorised \"Resistant\" high likelihood therapeutic failure even increased exposure. Exposure function mode administration, dose, dosing interval, infusion time, well distribution excretion antimicrobial agent influence infecting organism site infection. AMR package honours insight. Use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/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\" ) plot(x)  # \\donttest{ if (require(\"ggplot2\")) {   ggplot_sir_predict(x) }   # using dplyr: if (require(\"dplyr\")) {   x <- example_isolates %>%     filter_first_isolate() %>%     filter(mo_genus(mo) == \"Staphylococcus\") %>%     resistance_predict(\"PEN\", model = \"binomial\")   print(plot(x))    # get the model from the object   mymodel <- attributes(x)$model   summary(mymodel) }  #> NULL #>  #> Call: #> glm(formula = df_matrix ~ year, family = binomial) #>  #> Coefficients: #>             Estimate Std. Error z value Pr(>|z|) #> (Intercept) 27.05312   72.24652   0.374    0.708 #> year        -0.01286    0.03601  -0.357    0.721 #>  #> (Dispersion parameter for binomial family taken to be 1) #>  #>     Null deviance: 5.7883  on 11  degrees of freedom #> Residual deviance: 5.6608  on 10  degrees of freedom #> AIC: 50.745 #>  #> Number of Fisher Scoring iterations: 4 #>   # create nice plots with ggplot2 yourself if (require(\"dplyr\") && require(\"ggplot2\")) {   data <- example_isolates %>%     filter(mo == as.mo(\"E. coli\")) %>%     resistance_predict(       col_ab = \"AMX\",       col_date = \"date\",       model = \"binomial\",       info = FALSE,       minimum = 15     )   head(data)   autoplot(data) }  # }"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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)  # S3 method for default skewness(x, na.rm = FALSE)  # S3 method for matrix skewness(x, na.rm = FALSE)  # S3 method for data.frame skewness(x, na.rm = FALSE)"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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.03310027"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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://msberends.github.io/AMR/reference/translate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate Strings from the AMR Package — translate","text":"language language choose. Use one supported language names ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). x text translate","code":""},{"path":"https://msberends.github.io/AMR/reference/translate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate Strings from the AMR Package — translate","text":"currently 20 supported languages English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (), Japanese (ja), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk). languages translations available antimicrobial drugs colloquial microorganism names. permanently silence -per-session language note non-English operating system, can set package option AMR_locale .Rprofile file like :   save file. Please read adding updating language Wiki.","code":"# Open .Rprofile file utils::file.edit(\"~/.Rprofile\")  # Then add e.g. Italian support to that file using: options(AMR_locale = \"Italian\")"},{"path":"https://msberends.github.io/AMR/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://msberends.github.io/AMR/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\") #> ℹ More than one result was found for item 1: amoxicillin and clavulansäure #> [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://msberends.github.io/AMR/news/index.html","id":"amr-2119032","dir":"Changelog","previous_headings":"","what":"AMR 2.1.1.9032","title":"AMR 2.1.1.9032","text":"(beta version eventually become v3.0. ’re happy reach new major milestone soon, new One Health support!)","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"a-new-milestone-one-health-support--human--veterinary--environmental-2-1-1-9032","dir":"Changelog","previous_headings":"","what":"A New Milestone: One Health Support (= Human + Veterinary + Environmental)","title":"AMR 2.1.1.9032","text":"package now supports tools AMR data analysis clinical settings, also veterinary environmental microbiology. made possible collaboration University Prince Edward Island, Canada. celebrate great improvement package, also updated package logo reflect change.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"breaking-2-1-1-9032","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 2.1.1.9032","text":"Removed functions references used deprecated rsi class, replaced sir equivalents year ago","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"new-2-1-1-9032","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 2.1.1.9032","text":"Function .sir() now extensive support animal breakpoints CLSI. Use breakpoint_type = \"animal\" set host argument variable contains animal species names. clinical_breakpoints data set contains breakpoints, can downloaded download page. antibiotics data set contains veterinary antibiotics, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antibiotics (start “Q”) ab_url() now supports retrieving WHOCC url ATCvet pages .sir() now returns additional factor levels “N” non-interpretable “SDD” susceptible dose-dependent. Users can now set criteria (using regular expressions) considered S, , R, SDD, N. function group scale_*_mic(), namely: scale_x_mic(), scale_y_mic(), scale_colour_mic() scale_fill_mic(). advanced ggplot2 extensions allow easy plotting MIC values. allow manual range definition plotting missing intermediate log2 levels. Function limit_mic_range(), allows limit MIC values manually set range. powerhouse behind scale_*_mic() functions, can used users directly e.g. compare equality MIC distributions rescaling range first. Function mo_group_members() retrieve member microorganisms. example, mo_group_members(\"Strep group C\") returns vector microorganisms group.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"changed-2-1-1-9032","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 2.1.1.9032","text":"SIR interpretation, now possible use column names argument ab mo: .sir(..., ab = \"column1\", mo = \"column2\"). greatly improves flexibility users. Added valid levels: 4096, 6 powers 0.0625, 5 powers 192 (192, 384, 576, 768, 960) Added new argument keep_operators .mic(). can \"\" (default), \"none\", \"edges\". argument also available new limit_mic_range() 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. Updated italicise_taxonomy() support HTML output mo_info() now contains extra element group_members, contents new mo_group_members() function 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. Updated ATC codes WHOCC Updated antibiotic DDDs WHOCC Fix using manual value mo_transform antibiogram() Fix mapping ‘high level’ antibiotics .ab() (amphotericin B-high, gentamicin-high, kanamycin-high, streptomycin-high, tobramycin-high) Improved overall algorithm .ab() better performance accuracy","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"other-2-1-1-9032","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 2.1.1.9032","text":"Added Jordan Stull, Matthew Saab, Javier Sanchez contributors, thank valuable input","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"amr-211","dir":"Changelog","previous_headings":"","what":"AMR 2.1.1","title":"AMR 2.1.1","text":"CRAN release: 2023-10-21 included many isolates patients altering antibiograms within bacterial species See info issue #122 Added 1,366 LOINC codes antibiotics data set updated latest version (LOINC v2.76) MICs can now used complex number calculations allow scientific number format input (e.g., .mic(\"1.28e-2\")) Fix rounding MICs latest R beta (‘R-devel’) Removed unneeded note used language option AMR_locale set Fixed non-ASCII characters documentation, according CRAN maintainers","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"amr-210","dir":"Changelog","previous_headings":"","what":"AMR 2.1.0","title":"AMR 2.1.0","text":"CRAN release: 2023-07-16","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"new-2-1-0","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 2.1.0","text":"Clinical breakpoints intrinsic resistance EUCAST 2023 CLSI 2023 added clinical_breakpoints data set usage .sir(). EUCAST 2023 (v13.0) now new default guideline MIC disks diffusion interpretations EUCAST dosage guideline v13.0 added dosage data set clinical_breakpoints data set now also contains epidemiological cut-(ECOFF) values CLSI animal breakpoints. two new breakpoint types can used MIC/disk interpretation using .sir(..., breakpoint_type = \"ECOFF\") oras.sir(..., breakpoint_type = \"animal\"), important new addition veterinary microbiology. Added support 30 species groups / complexes. gathered new data set microorganisms.groups used clinical breakpoint interpretation. example, CLSI 2023 contains breakpoints RGM group (Rapidly Growing Mycobacterium, containing 80 species) now supported package. Added mo_oxygen_tolerance() retrieve values Added mo_is_anaerobic() determine genera/species obligate anaerobic bacteria Added LPSN GBIF identifiers, oxygen tolerance mo_info() Added SAS Transport files (file extension .xpt) download page use SAS software Added microbial codes Gram-negative/positive anaerobic bacteria","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"changed-2-1-0","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 2.1.0","text":"Updated algorithm .mo() giving weight fungi Fixed clinical breakpoints errors introduced source import rules mo_rank() now returns NA ‘unknown’ microorganisms (B_ANAER, B_ANAER-NEG, B_ANAER-POS, B_GRAMN, B_GRAMP, F_FUNGUS, F_YEAST, UNKNOWN) printing microorganism antibiotic codes tibble, mouse-hover now shows full name code Now settable arguments breakpoint type PK/PD, like .sir() now contain name guideline table subtitle plot Fixed formatting sir_interpretation_history() Fixed WHONET codes microorganisms consequently couple entries clinical_breakpoints Fixed bug .mo() led coercion NA values using custom microorganism codes Fixed usage icu_exclude first_isolates() Now allows searching species names Fix using keep_synonyms argument using MO codes input Fix using minimum_matching_score argument Updated code table microorganisms.codes Fixed endless loop using reference_df .mo() Fixed bug indicating UTIs .sir() Greatly improved speed .sir()","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"amr-200","dir":"Changelog","previous_headings":"","what":"AMR 2.0.0","title":"AMR 2.0.0","text":"CRAN release: 2023-03-12 new major release AMR package, great new additions also breaking changes current users. listed . TL;DR functions arguments ‘rsi’ replaced ‘sir’, interpretation MIC values (now .sir() instead .rsi()) - old functions still work now Many new interesting functions, antibiogram() (generating traditional/combined/syndromic/WISCA antibiograms), sir_confidence_interval() mean_amr_distance(), add_custom_microorganisms() add custom microorganisms package Clinical breakpoints added EUCAST 2022 CLSI 2022 Microbiological taxonomy (microorganisms data set) updated 2022 now based LPSN GBIF Much increased algorithms translate user input valid taxonomy, e.g. using recent scientific work per-species human pathogenicity 20 new antibiotics added updated DDDs ATC codes Extended support antiviral agents (antivirals data set), many new functions Now available 20 languages Many small bug fixes","code":""},{"path":[]},{"path":"https://msberends.github.io/AMR/news/index.html","id":"sir-vs-rsi-2-0-0","dir":"Changelog","previous_headings":"New","what":"SIR vs. RSI","title":"AMR 2.0.0","text":"milestone version, replaced mentions RSI SIR, comply actually commonly used field clinical microbiology comes tri-form regarding AMR. existing functions .rsi(), rsi_df() ggplot_rsi() still work, replacements .sir(), sir_df(), ggplot_sir() now current functions AMR data analysis. warning thrown session remind users . data set rsi_translation now called clinical_breakpoints better reflect content. ‘RSI functions’ removed future version, late 2023 / early 2024.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"new-antibiogram-function-2-0-0","dir":"Changelog","previous_headings":"New","what":"New antibiogram function","title":"AMR 2.0.0","text":"new antibiogram() function, users can now generate traditional, combined, syndromic, even weighted-incidence syndromic combination antibiograms (WISCA). , follow logic previously described work Klinker et al. (2021, DOI 10.1177/20499361211011373) Barbieri et al. (2021, DOI 10.1186/s13756-021-00939-2). help page antibiogram() extensively elaborates use cases, antibiogram() also supports printing R Markdown Quarto, support 20 languages. Furthermore, different plotting methods implemented allow graphical visualisations well.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"interpretation-of-mic-and-disk-diffusion-values-2-0-0","dir":"Changelog","previous_headings":"New","what":"Interpretation of MIC and disk diffusion values","title":"AMR 2.0.0","text":"clinical breakpoints intrinsic resistance EUCAST 2022 CLSI 2022 added .sir(). EUCAST 2022 (v12.0) now new default guideline MIC disks diffusion interpretations, eucast_rules() apply EUCAST Expert Rules. default guideline (EUCAST) can now changed new AMR_guideline option, : options(AMR_guideline = \"CLSI 2020\"). new arguments include_PKPD (default: TRUE) include_screening (default: FALSE), users can now specify whether breakpoints screening PK/PD table included interpreting MICs disks diffusion values. options can set globally, can read new manual. Interpretation guidelines older 10 years removed, oldest now included guidelines EUCAST CLSI 2013.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"supported-languages-2-0-0","dir":"Changelog","previous_headings":"New","what":"Supported languages","title":"AMR 2.0.0","text":"added support following ten languages: Chinese (simplified), Czech, Finnish, Greek, Japanese, Norwegian (bokmål), Polish, Romanian, Turkish Ukrainian. antibiotic names now available languages, AMR package automatically determine supported language based user’s system language. grateful valuable input colleagues countries. AMR package now available 20 languages total, according download stats used almost countries world!","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"outbreak-management-2-0-0","dir":"Changelog","previous_headings":"New","what":"Outbreak management","title":"AMR 2.0.0","text":"analysis outbreak management, updated get_episode() is_new_episode() functions: now contain argument case_free_days. argument can used quantify duration case-free days (inter-epidemic interval), new episode start. common requirement outbreak management, e.g. determining number norovirus outbreaks hospital. case-free period 14 28 days, new norovirus cases time considered different (new) episode.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"microbiological-taxonomy-2-0-0","dir":"Changelog","previous_headings":"New","what":"Microbiological taxonomy","title":"AMR 2.0.0","text":"microorganisms data set longer relies Catalogue Life, List Prokaryotic names Standing Nomenclature (LPSN) supplemented ‘backbone taxonomy’ Global Biodiversity Information Facility (GBIF). structure data set changed include separate LPSN GBIF identifiers. Almost previous MO codes retained. contains 1,400 taxonomic names 2022. previously relied experience categorise species pathogenic groups, happy encounter recent work Bartlett et al. (2022, DOI 10.1099/mic.0.001269) extensively studied medical-scientific literature categorise bacterial species groups. See mo_matching_score() work incorporated prevalence column microorganisms data set. Using results, .mo() mo_*() functions now much better capable converting user input valid taxonomic records. new function add_custom_microorganisms() allows users add custom microorganisms AMR package. also made following changes regarding included taxonomy microorganisms functions: Updated full microbiological taxonomy according latest daily LPSN data set (December 2022) latest yearly GBIF taxonomy backbone (November 2022) Added function mo_current() get currently valid taxonomic name microorganism Support 1,516 city-like serovars Salmonella, Salmonella Goldcoast. Formally, serovars belonging S. enterica species, reported name genus city. reason, serovars subspecies column microorganisms data set “enterica” species column, full name contain species name (enterica). new argument keep_synonyms allows correct updated taxonomy, favour now deleted argument allow_uncertain increased tremendously speed returns generally consequent results Sequential coercion now extremely fast results stored package environment, although coercion unknown values must run per session. Previous results can reset/removed new mo_reset_session() function. Support microorganism codes ASIan Antimicrobial Resistance Surveillance Network (ASIARS-Net) MO matching score algorithm (mo_matching_score()) now counts deletions substitutions 2 instead 1, impacts outcome .mo() mo_*() function CRAN allows packages around 5 MB maximum, packages exempted package one Chromista relevant comes antimicrobial resistance, thus lacking primary scope package Chromista almost never clinically relevant, thus lacking secondary scope package microorganisms.old data set removed, previously accepted names now included microorganisms data set. new column status contains \"accepted\" currently accepted names \"synonym\" taxonomic synonyms; currently invalid names. previously accepted names now microorganisms ID - available - LPSN, GBIF SNOMED CT identifier.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"antibiotic-agents-and-selectors-2-0-0","dir":"Changelog","previous_headings":"New","what":"Antibiotic agents and selectors","title":"AMR 2.0.0","text":"new function add_custom_antimicrobials() allows users add custom antimicrobial codes names AMR package. antibiotics data set greatly updated: following 20 antibiotics added (also includes new J01RA ATC group): azithromycin/fluconazole/secnidazole (AFC), cefepime/amikacin (CFA), cefixime/ornidazole (CEO), ceftriaxone/beta-lactamase inhibitor (CEB), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), furazidin (FUR), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), lascufloxacin (LSC), levofloxacin/ornidazole (LEO), nemonoxacin (NEM), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin/ornidazole (OOR), oteseconazole (OTE), rifampicin/ethambutol/isoniazid (REI), sarecycline (SRC), tetracycline/oleandomycin (TOL), thioacetazone (TAT) Added missing ATC codes Updated DDDs PubChem Compound IDs Updated antibiotic name spelling, now used WHOCC (cephalexin -> cefalexin, phenethicillin -> pheneticillin) Antibiotic code “CEI” ceftolozane/tazobactam replaced “CZT” comply EARS-Net WHONET 2022. old code still work cases using .ab() ab_*() functions. Support antimicrobial interpretation anaerobic bacteria, adding ‘placeholder’ code B_ANAER microorganisms data set adding breakpoints anaerobics clinical_breakpoints data set, used .sir() interpretion MIC disk diffusion values Also, added support using antibiotic selectors scoped dplyr verbs (without using vars()), : ... %>% summarise_at(aminoglycosides(), resistance), please see resistance() examples.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"antiviral-agents-2-0-0","dir":"Changelog","previous_headings":"New","what":"Antiviral agents","title":"AMR 2.0.0","text":"now added extensive support antiviral agents! first time, AMR package extensive support antiviral drugs work names, codes data way. antivirals data set extended 18 new drugs (also new J05AJ ATC group) now also contains antiviral identifiers LOINC codes new data type av (antivirals) added, functionally similar ab antibiotics Functions .av(), av_name(), av_atc(), av_synonyms(), av_from_text() added siblings ab_*() equivalents","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"other-new-functions-2-0-0","dir":"Changelog","previous_headings":"New","what":"Other new functions","title":"AMR 2.0.0","text":"Function sir_confidence_interval() add confidence intervals AMR calculation. now also included sir_df() proportion_df(). Function mean_amr_distance() calculate mean AMR distance. mean AMR distance normalised numeric value compare AMR test results can help identify similar isolates, without comparing antibiograms hand. Function sir_interpretation_history() view history previous runs .sir() (previously .rsi()). returns ‘logbook’ selected guideline, reference table specific interpretation row data set .sir() run.","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"changes-2-0-0","dir":"Changelog","previous_headings":"","what":"Changes","title":"AMR 2.0.0","text":"Fix working NA values Fix unsorted dates length 2 Now returns class integer instead numeric since always whole numbers Argument combine_IR removed package (affecting functions count_df(), proportion_df(), sir_df() plotting functions), since replaced combine_SI three years ago Using units ab_ddd(..., units = \"...\") deprecated time now supported anymore. Use ab_ddd_units() instead. Support data.frame-enhancing R packages, specifically: data.table::data.table, janitor::tabyl, tibble::tibble, tsibble::tsibble. AMR package functions data set output (sir_df() bug_drug_combinations()), now return data type input. data sets package now tibble, instead base R data.frames. Older R versions still supported, even support tibbles. data sets now also continually exported Apache Feather Apache Parquet formats. can find info article website. Fixed certain EUCAST breakpoints MIC values Allow NA values (e.g. .sir(.disk(NA), ...)) Fix bug-drug combinations multiple breakpoints different body sites Interpretation MIC disk zones now informative availability breakpoints robust Removed .integer() method MIC values, since MIC integer values running table() MIC values consequently failed able retrieve level position (’s normally .integer() factors work) Fixed determination Gram stains (mo_gramstain()), since taxonomic phyla Actinobacteria, Chloroflexi, Firmicutes, Tenericutes renamed respectively Actinomycetota, Chloroflexota, Bacillota, Mycoplasmatota 2021 droplevels() MIC now return common factor default lose mic class. Use droplevels(..., .mic = TRUE) keep mic class. Small fix using ab_from_text() Fixes reading text files using set_mo_source(), now also allows source file contain valid taxonomic names instead valid microorganism ID package Fixed bug mdro() using similar column names Magiorakos guideline Using random_*() function (random_mic()) now possible directly calling package without loading first: AMR::random_mic(10) Extended support vctrs package, used internally tidyverse. allows change values class mic, disk, sir, mo ab tibbles, use antibiotic selectors selecting/filtering, e.g. df[carbapenems() == \"R\", ] Fix using info = FALSE mdro() interpretation guidelines using .sir() amoxicillin, rules ampicillin used amoxicillin rules available Fix using ab_atc() non-existing ATC codes Black white message texts now reversed colour using RStudio dark theme mo_snomed() now returns class character, numeric anymore (make long SNOMED codes readable) Fix using .ab() NA values Updated support WHONET 2022 microorganism codes Antimicrobial interpretation ‘SDD’ (susceptible dose-dependent, coined CLSI) interpreted ‘’ comply EUCAST’s ‘’ .sir() Fix mo_shortname() case higher taxonomic ranks (order, class, phylum) Cleaning columns .sir(), .mic(), .disk() now show column name warning invalid results Fix using g.test() zeroes 2x2 table mo_synonyns() now contains scientific reference names","code":""},{"path":"https://msberends.github.io/AMR/news/index.html","id":"other-2-0-0","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 2.0.0","text":"Added Peter Dutey-Magni, Dmytro Mykhailenko, Anton Mymrikov, Andrew Norgan, Jonas Salm, Anita Williams contributors, thank valuable input New website make use new Bootstrap 5 pkgdown 2.0. website now contains results examples automatically regenerated every change repository, using GitHub Actions R Rmd files project now styled using styler package Set scalar conditional expressions (&& ||) possible comply upcoming R 4.3 enormous lot code cleaning, fixing small bugs along way changelog contains changes AMR v2.0 (January 2023) later. prior versions, please see archive.","code":""}]