mirror of
https://github.com/msberends/AMR.git
synced 2026-10-01 04:13:33 +02:00
(v1.3.0.9035) mdro() for EUCAST 3.2, examples cleanup
This commit is contained in:
dr. M.S. (Matthijs) Berends committed
1 parent
68e6e1e329
commit
4e0374af29
94 files changed
+1143
-1165
No files matched your search
+19
-16
@@ -82,7 +82,7 @@
|
||||
</button>
|
||||
<span class="navbar-brand">
|
||||
<a class="navbar-link" href="../index.html">AMR (for R)</a>
|
||||
<span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Latest development version">1.3.0.9028</span>
|
||||
<span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Latest development version">1.3.0.9035</span>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
@@ -288,7 +288,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<th>combine_SI</th>
|
||||
<td><p>a logical to indicate whether all values of S and I must be merged into one, so resistance is only considered when isolates are R, not I. As this is the default behaviour of the <code>mdro()</code> function, it follows the redefinition by EUCAST about the interpretion of I (increased exposure) in 2019, see section 'Interpretation of S, I and R' below. When using <code>combine_SI = FALSE</code>, resistance is considered when isolates are R or I.</p></td>
|
||||
<td><p>a <a href='https://rdrr.io/r/base/logical.html'>logical</a> to indicate whether all values of S and I must be merged into one, so resistance is only considered when isolates are R, not I. As this is the default behaviour of the <code>mdro()</code> function, it follows the redefinition by EUCAST about the interpretation of I (increased exposure) in 2019, see section 'Interpretation of S, I and R' below. When using <code>combine_SI = FALSE</code>, resistance is considered when isolates are R or I.</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th>verbose</th>
|
||||
@@ -323,8 +323,10 @@ Ordered <a href='https://rdrr.io/r/base/factor.html'>factor</a> with levels <cod
|
||||
<p>Currently supported guidelines are (case-insensitive):</p><ul>
|
||||
<li><p><code>guideline = "CMI2012"</code><br />
|
||||
Magiorakos AP, Srinivasan A <em>et al.</em> "Multidrug-resistant, extensively drug-resistant and pandrug-resistant bacteria: an international expert proposal for interim standard definitions for acquired resistance." Clinical Microbiology and Infection (2012) (<a href='https://www.clinicalmicrobiologyandinfection.com/article/S1198-743X(14)61632-3/fulltext'>link</a>)</p></li>
|
||||
<li><p><code>guideline = "EUCAST"</code><br />
|
||||
The European international guideline - EUCAST Expert Rules Version 3.1 "Intrinsic Resistance and Exceptional Phenotypes Tables" (<a href='http://www.eucast.org/fileadmin/src/media/PDFs/EUCAST_files/Expert_Rules/Expert_rules_intrinsic_exceptional_V3.1.pdf'>link</a>)</p></li>
|
||||
<li><p><code>guideline = "EUCAST3.2"</code> (or simply <code>guideline = "EUCAST"</code>)<br />
|
||||
The European international guideline - EUCAST Expert Rules Version 3.2 "Intrinsic Resistance and Unusual Phenotypes" (<a href='https://www.eucast.org/fileadmin/src/media/PDFs/EUCAST_files/Expert_Rules/2020/Intrinsic_Resistance_and_Unusual_Phenotypes_Tables_v3.2_20200225.pdf'>link</a>)</p></li>
|
||||
<li><p><code>guideline = "EUCAST3.1"</code><br />
|
||||
The European international guideline - EUCAST Expert Rules Version 3.1 "Intrinsic Resistance and Exceptional Phenotypes Tables" (<a href='https://www.eucast.org/fileadmin/src/media/PDFs/EUCAST_files/Expert_Rules/Expert_rules_intrinsic_exceptional_V3.1.pdf'>link</a>)</p></li>
|
||||
<li><p><code>guideline = "TB"</code><br />
|
||||
The international guideline for multi-drug resistant tuberculosis - World Health Organization "Companion handbook to the WHO guidelines for the programmatic management of drug-resistant tuberculosis" (<a href='https://www.who.int/tb/publications/pmdt_companionhandbook/en/'>link</a>)</p></li>
|
||||
<li><p><code>guideline = "MRGN"</code><br />
|
||||
@@ -334,7 +336,7 @@ The Dutch national guideline - Rijksinstituut voor Volksgezondheid en Milieu "WI
|
||||
</ul>
|
||||
|
||||
<p>Please suggest your own (country-specific) guidelines by letting us know: <a href='https://github.com/msberends/AMR/issues/new'>https://github.com/msberends/AMR/issues/new</a>.</p>
|
||||
<p><strong>Note:</strong> Every test that involves the Enterobacteriaceae family, will internally be performed using its newly named order Enterobacterales, since the Enterobacteriaceae family has been taxonomically reclassified by Adeolu <em>et al.</em> in 2016. Before that, Enterobacteriaceae was the only family under the Enterobacteriales (with an i) order. All species under the old Enterobacteriaceae family are still under the new Enterobacterales (without an i) order, but divided into multiple families. The way tests are performed now by this <code>mdro()</code> function makes sure that results from before 2016 and after 2016 are identical.</p>
|
||||
<p><strong>Note:</strong> Every test that involves the Enterobacteriaceae family, will internally be performed using its newly named <em>order</em> Enterobacterales, since the Enterobacteriaceae family has been taxonomically reclassified by Adeolu <em>et al.</em> in 2016. Before that, Enterobacteriaceae was the only family under the Enterobacteriales (with an i) order. All species under the old Enterobacteriaceae family are still under the new Enterobacterales (without an i) order, but divided into multiple families. The way tests are performed now by this <code>mdro()</code> function makes sure that results from before 2016 and after 2016 are identical.</p>
|
||||
<h2 class="hasAnchor" id="maturing-lifecycle"><a class="anchor" href="#maturing-lifecycle"></a>Maturing lifecycle</h2>
|
||||
|
||||
|
||||
@@ -347,7 +349,7 @@ The <a href='lifecycle.html'>lifecycle</a> of this function is <strong>maturing<
|
||||
|
||||
<p>To define antibiotics column names, leave as it is to determine it automatically with <code><a href='guess_ab_col.html'>guess_ab_col()</a></code> or input a text (case-insensitive), or use <code>NULL</code> to skip a column (e.g. <code>TIC = NULL</code> to skip ticarcillin). Manually defined but non-existing columns will be skipped with a warning.</p>
|
||||
<p>The following antibiotics are used for the functions <code><a href='eucast_rules.html'>eucast_rules()</a></code> and <code>mdro()</code>. These are shown below in the format 'name (<code>antimicrobial ID</code>, <a href='https://www.whocc.no/atc/structure_and_principles/'>ATC code</a>)', sorted alphabetically:</p>
|
||||
<p>Amikacin (<code>AMK</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01GB06&showdescription=no'>J01GB06</a>), amoxicillin (<code>AMX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA04&showdescription=no'>J01CA04</a>), amoxicillin/clavulanic acid (<code>AMC</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CR02&showdescription=no'>J01CR02</a>), ampicillin (<code>AMP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA01&showdescription=no'>J01CA01</a>), ampicillin/sulbactam (<code>SAM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CR01&showdescription=no'>J01CR01</a>), avoparcin (<code>AVO</code>, no ATC code), azithromycin (<code>AZM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01FA10&showdescription=no'>J01FA10</a>), azlocillin (<code>AZL</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA09&showdescription=no'>J01CA09</a>), aztreonam (<code>ATM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DF01&showdescription=no'>J01DF01</a>), bacampicillin (<code>BAM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA06&showdescription=no'>J01CA06</a>), benzylpenicillin (<code>PEN</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CE01&showdescription=no'>J01CE01</a>), cadazolid (<code>CDZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD09&showdescription=no'>J01DD09</a>), capreomycin (<code>CAP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J04AB30&showdescription=no'>J04AB30</a>), carbenicillin (<code>CRB</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA03&showdescription=no'>J01CA03</a>), carindacillin (<code>CRN</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA05&showdescription=no'>J01CA05</a>), cefacetrile (<code>CAC</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB10&showdescription=no'>J01DB10</a>), cefaclor (<code>CEC</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC04&showdescription=no'>J01DC04</a>), cefadroxil (<code>CFR</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB05&showdescription=no'>J01DB05</a>), cefaloridine (<code>RID</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB02&showdescription=no'>J01DB02</a>), cefamandole (<code>MAN</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC03&showdescription=no'>J01DC03</a>), cefatrizine (<code>CTZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB07&showdescription=no'>J01DB07</a>), cefazedone (<code>CZD</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB06&showdescription=no'>J01DB06</a>), cefazolin (<code>CZO</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB04&showdescription=no'>J01DB04</a>), cefdinir (<code>CDR</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD15&showdescription=no'>J01DD15</a>), cefditoren (<code>DIT</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD16&showdescription=no'>J01DD16</a>), cefepime (<code>FEP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DE01&showdescription=no'>J01DE01</a>), cefetamet (<code>CAT</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD10&showdescription=no'>J01DD10</a>), cefixime (<code>CFM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD08&showdescription=no'>J01DD08</a>), cefmenoxime (<code>CMX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD05&showdescription=no'>J01DD05</a>), cefmetazole (<code>CMZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC09&showdescription=no'>J01DC09</a>), cefodizime (<code>DIZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD09&showdescription=no'>J01DD09</a>), cefonicid (<code>CID</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC06&showdescription=no'>J01DC06</a>), cefoperazone (<code>CFP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD12&showdescription=no'>J01DD12</a>), cefoperazone/sulbactam (<code>CSL</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD62&showdescription=no'>J01DD62</a>), ceforanide (<code>CND</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC11&showdescription=no'>J01DC11</a>), cefotaxime (<code>CTX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD01&showdescription=no'>J01DD01</a>), cefotetan (<code>CTT</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC05&showdescription=no'>J01DC05</a>), cefotiam (<code>CTF</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC07&showdescription=no'>J01DC07</a>), cefoxitin (<code>FOX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC01&showdescription=no'>J01DC01</a>), cefoxitin screening (<code>FOX1</code>, no ATC code), cefpiramide (<code>CPM</code>, <a href='https://www.whocc.no/atLine truncated
|
||||
<p>Amikacin (<code>AMK</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01GB06&showdescription=no'>J01GB06</a>), amoxicillin (<code>AMX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA04&showdescription=no'>J01CA04</a>), amoxicillin/clavulanic acid (<code>AMC</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CR02&showdescription=no'>J01CR02</a>), ampicillin (<code>AMP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA01&showdescription=no'>J01CA01</a>), ampicillin/sulbactam (<code>SAM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CR01&showdescription=no'>J01CR01</a>), avoparcin (<code>AVO</code>, no ATC code), azithromycin (<code>AZM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01FA10&showdescription=no'>J01FA10</a>), azlocillin (<code>AZL</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA09&showdescription=no'>J01CA09</a>), aztreonam (<code>ATM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DF01&showdescription=no'>J01DF01</a>), bacampicillin (<code>BAM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA06&showdescription=no'>J01CA06</a>), benzylpenicillin (<code>PEN</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CE01&showdescription=no'>J01CE01</a>), cadazolid (<code>CDZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD09&showdescription=no'>J01DD09</a>), capreomycin (<code>CAP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J04AB30&showdescription=no'>J04AB30</a>), carbenicillin (<code>CRB</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA03&showdescription=no'>J01CA03</a>), carindacillin (<code>CRN</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01CA05&showdescription=no'>J01CA05</a>), cefacetrile (<code>CAC</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB10&showdescription=no'>J01DB10</a>), cefaclor (<code>CEC</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC04&showdescription=no'>J01DC04</a>), cefadroxil (<code>CFR</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB05&showdescription=no'>J01DB05</a>), cefaloridine (<code>RID</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB02&showdescription=no'>J01DB02</a>), cefamandole (<code>MAN</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC03&showdescription=no'>J01DC03</a>), cefatrizine (<code>CTZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB07&showdescription=no'>J01DB07</a>), cefazedone (<code>CZD</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB06&showdescription=no'>J01DB06</a>), cefazolin (<code>CZO</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DB04&showdescription=no'>J01DB04</a>), cefdinir (<code>CDR</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD15&showdescription=no'>J01DD15</a>), cefditoren (<code>DIT</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD16&showdescription=no'>J01DD16</a>), cefepime (<code>FEP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DE01&showdescription=no'>J01DE01</a>), cefetamet (<code>CAT</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD10&showdescription=no'>J01DD10</a>), cefixime (<code>CFM</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD08&showdescription=no'>J01DD08</a>), cefmenoxime (<code>CMX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD05&showdescription=no'>J01DD05</a>), cefmetazole (<code>CMZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC09&showdescription=no'>J01DC09</a>), cefodizime (<code>DIZ</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD09&showdescription=no'>J01DD09</a>), cefonicid (<code>CID</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC06&showdescription=no'>J01DC06</a>), cefoperazone (<code>CFP</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD12&showdescription=no'>J01DD12</a>), cefoperazone/sulbactam (<code>CSL</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD62&showdescription=no'>J01DD62</a>), ceforanide (<code>CND</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC11&showdescription=no'>J01DC11</a>), cefotaxime (<code>CTX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DD01&showdescription=no'>J01DD01</a>), cefotetan (<code>CTT</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC05&showdescription=no'>J01DC05</a>), cefotiam (<code>CTF</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC07&showdescription=no'>J01DC07</a>), cefoxitin (<code>FOX</code>, <a href='https://www.whocc.no/atc_ddd_index/?code=J01DC01&showdescription=no'>J01DC01</a>), cefoxitin screening (<code>FOX1</code>, no ATC code), cefpiramide (<code>CPM</code>, <a href='https://www.whocc.no/atLine truncated
|
||||
<h2 class="hasAnchor" id="interpretation-of-r-and-s-i"><a class="anchor" href="#interpretation-of-r-and-s-i"></a>Interpretation of R and S/I</h2>
|
||||
|
||||
|
||||
@@ -369,19 +371,20 @@ A microorganism is categorised as <em>Susceptible, Increased exposure</em> when
|
||||
<p>On our website <a href='https://msberends.github.io/AMR'>https://msberends.github.io/AMR</a> you can find <a href='https://msberends.github.io/AMR/articles/AMR.html'>a comprehensive tutorial</a> about how to conduct AMR analysis, the <a href='https://msberends.github.io/AMR/reference'>complete documentation of all functions</a> (which reads a lot easier than here in R) and <a href='https://msberends.github.io/AMR/articles/WHONET.html'>an example analysis using WHONET data</a>. As we would like to better understand the backgrounds and needs of our users, please <a href='https://msberends.github.io/AMR/survey.html'>participate in our survey</a>!</p>
|
||||
|
||||
<h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
|
||||
<pre class="examples"><span class='co'>if</span> (<span class='fl'>FALSE</span>) {
|
||||
<span class='fu'><a href='https://rdrr.io/r/base/library.html'>library</a></span>(<span class='kw'><a href='https://dplyr.tidyverse.org'>dplyr</a></span>)
|
||||
<span class='fu'><a href='https://rdrr.io/r/base/library.html'>library</a></span>(<span class='kw'><a href='https://github.com/msberends/cleaner'>cleaner</a></span>)
|
||||
<pre class="examples"><span class='fu'>mdro</span>(<span class='kw'>example_isolates</span>, guideline = <span class='st'>"EUCAST"</span>)
|
||||
|
||||
<span class='kw'>example_isolates</span> <span class='op'>%>%</span>
|
||||
<span class='fu'>mdro</span>() <span class='op'>%>%</span>
|
||||
<span class='fu'><a href='https://rdrr.io/pkg/cleaner/man/freq.html'>freq</a></span>()
|
||||
<span class='co'># \donttest{</span>
|
||||
<span class='co'>if</span> (<span class='fu'><a href='https://rdrr.io/r/base/library.html'>require</a></span>(<span class='st'><a href='https://dplyr.tidyverse.org'>"dplyr"</a></span>)) {
|
||||
<span class='kw'>example_isolates</span> <span class='op'>%>%</span>
|
||||
<span class='fu'>mdro</span>() <span class='op'>%>%</span>
|
||||
<span class='fu'><a href='https://rdrr.io/r/base/table.html'>table</a></span>()
|
||||
|
||||
<span class='kw'>example_isolates</span> <span class='op'>%>%</span>
|
||||
<span class='fu'><a href='https://dplyr.tidyverse.org/reference/mutate.html'>mutate</a></span>(EUCAST = <span class='fu'>eucast_exceptional_phenotypes</span>(<span class='kw'>.</span>),
|
||||
BRMO = <span class='fu'>brmo</span>(<span class='kw'>.</span>),
|
||||
MRGN = <span class='fu'>mrgn</span>(<span class='kw'>.</span>))
|
||||
<span class='kw'>example_isolates</span> <span class='op'>%>%</span>
|
||||
<span class='fu'><a href='https://dplyr.tidyverse.org/reference/mutate.html'>mutate</a></span>(EUCAST = <span class='fu'>eucast_exceptional_phenotypes</span>(<span class='kw'>.</span>),
|
||||
BRMO = <span class='fu'>brmo</span>(<span class='kw'>.</span>),
|
||||
MRGN = <span class='fu'>mrgn</span>(<span class='kw'>.</span>))
|
||||
}
|
||||
<span class='co'># }</span>
|
||||
</pre>
|
||||
</div>
|
||||
<div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
|
||||
|
||||
Reference in new issue
Block a user