1
0
mirror of https://github.com/msberends/AMR.git synced 2025-07-08 11:51:59 +02:00

cli-147-2111

This commit is contained in:
github-actions
2024-06-14 20:48:53 +00:00
parent 122d0c536c
commit 8e108a2243
87 changed files with 319 additions and 313 deletions

View File

@ -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.9048</small>
<small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9049</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.9048" id="amr-2119048">AMR 2.1.1.9048<a class="anchor" aria-label="anchor" href="#amr-2119048"></a></h2>
<h2 class="pkg-version" data-toc-text="2.1.1.9049" id="amr-2119049">AMR 2.1.1.9049<a class="anchor" aria-label="anchor" href="#amr-2119049"></a></h2>
<p><em>(this beta version will eventually become v3.0. Were 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-9048">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-9048"></a></h5>
<h5 id="a-new-milestone-one-health-support--human--veterinary--environmental-2-1-1-9049">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-9049"></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-9048">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9048"></a></h3>
<h3 id="breaking-2-1-1-9049">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9049"></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-9048">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9048"></a></h3>
<h3 id="new-2-1-1-9049">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9049"></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>
@ -181,17 +181,22 @@
<code><a href="../reference/ab_property.html">ab_url()</a></code> now supports retrieving the WHOCC url of their ATCvet pages</li>
</ul></li>
<li>
<code><a href="../reference/as.sir.html">as.sir()</a></code> now brings additional factor levels: “N” for non-interpretable and “SDD” for susceptible dose-dependent. Users can now set their own criteria (using regular expressions) as to what should be considered S, I, R, SDD, and N. Also, to get quantitative values, <code><a href="https://rdrr.io/r/base/double.html" class="external-link">as.double()</a></code> or a <code>sir</code> object will return 1 for S, 2 for SDD/I, and 3 for R (N will become <code>NA</code>). Other functions using <code>sir</code> classes (e.g., <code><a href="https://rdrr.io/r/base/summary.html" class="external-link">summary()</a></code>) are updated to reflect the change to contain N and SDD.</li>
<code><a href="../reference/as.sir.html">as.sir()</a></code> now brings additional factor levels: “NI” for non-interpretable and “SDD” for susceptible dose-dependent. Users can now set their own criteria (using regular expressions) as to what should be considered S, I, R, SDD, and NI. Also, to get quantitative values, <code><a href="https://rdrr.io/r/base/double.html" class="external-link">as.double()</a></code> or a <code>sir</code> object will return 1 for S, 2 for SDD/I, and 3 for R (NI will become <code>NA</code>). Other functions using <code>sir</code> classes (e.g., <code><a href="https://rdrr.io/r/base/summary.html" class="external-link">summary()</a></code>) are updated to reflect the change to contain NI and SDD.</li>
<li>The function group <code>scale_*_mic()</code>, namely: <code><a href="../reference/plot.html">scale_x_mic()</a></code>, <code><a href="../reference/plot.html">scale_y_mic()</a></code>, <code><a href="../reference/plot.html">scale_colour_mic()</a></code> and <code><a href="../reference/plot.html">scale_fill_mic()</a></code>. They are advanced ggplot2 extensions to allow easy plotting of MIC values. They allow for manual range definition and plotting missing intermediate log2 levels.</li>
<li>Function <code><a href="../reference/as.mic.html">rescale_mic()</a></code>, which allows to rescale MIC values to a manually set range. This is the powerhouse behind the <code>scale_*_mic()</code> functions, but it can be used by users directly to e.g. compare equality in MIC distributions by rescaling them to the same range first.</li>
<li>Function <code><a href="../reference/mo_property.html">mo_group_members()</a></code> to retrieve the member microorganisms of a microorganism group. For example, <code>mo_group_members("Strep group C")</code> returns a vector of all microorganisms that are in that group.</li>
<li>Clinical breakpoints and intrinsic resistance of EUCAST 2024 and CLSI 2024 have been added to the <code>clinical_breakpoints</code> data set for usage in <code><a href="../reference/as.sir.html">as.sir()</a></code>. EUCAST 2024 (v14.0) is now the new default guideline for all MIC and disks diffusion interpretations.</li>
</ul></div>
<div class="section level3">
<h3 id="changed-2-1-1-9048">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9048"></a></h3>
<h3 id="changed-2-1-1-9049">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9049"></a></h3>
<ul><li>For SIR interpretation, it is now possible to use column names for argument <code>ab</code>, <code>mo</code>, and <code>uti</code>: <code>as.sir(..., ab = "column1", mo = "column2", uti = "column3")</code>. This greatly improves the flexibility for users.</li>
<li>Extended the antibiotic selectors with <code><a href="../reference/antibiotic_class_selectors.html">nitrofurans()</a></code> and <code><a href="../reference/antibiotic_class_selectors.html">rifamycins()</a></code>
</li>
<li>Added “clindamycin inducible screening” as <code>CLI1</code> to the <code>antibiotics</code> data set. Since clindamycin is a lincosamide, the antibiotic selector <code><a href="../reference/antibiotic_class_selectors.html">lincosamides()</a></code> now contains the argument <code>only_treatable = TRUE</code> (similar to other antibiotic selectors that contain non-treatable drugs)</li>
<li>
<code>antibiotics</code> data set:
<ul><li>Added “clindamycin inducible screening” as <code>CLI1</code>. Since clindamycin is a lincosamide, the antibiotic selector <code><a href="../reference/antibiotic_class_selectors.html">lincosamides()</a></code> now contains the argument <code>only_treatable = TRUE</code> (similar to other antibiotic selectors that contain non-treatable drugs)</li>
<li>Added Amorolfine (<code>AMO</code>, D01AE16), which is now also part of the <code><a href="../reference/antibiotic_class_selectors.html">antifungals()</a></code> selector</li>
</ul></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">rescale_mic()</a></code> and <code>scale_*_mic()</code> functions.</li>
@ -210,12 +215,13 @@
</li>
<li>Fix for mapping high level antibiotics in <code><a href="../reference/as.ab.html">as.ab()</a></code> (amphotericin B-high, gentamicin-high, kanamycin-high, streptomycin-high, tobramycin-high)</li>
<li>Improved overall algorithm of <code><a href="../reference/as.ab.html">as.ab()</a></code> for better performance and accuracy</li>
<li>Improved overall algorithm of <code><a href="../reference/as.mo.html">as.mo()</a></code> for better performance and accuracy. Specifically, more weight is given to genus and species combinations in cases where the subspecies is miswritten, so that the result will be the correct genus and species.</li>
<li>When using antibiotic selectors such as <code><a href="../reference/antibiotic_class_selectors.html">aminoglycosides()</a></code> that exclude non-treatable drugs like gentamicin-high, the function now always returns a warning that these can be included using <code>only_treatable = FALSE</code>
</li>
<li>Intermediate log2 levels used for MIC plotting are now more common values instead of following a strict dilution range</li>
</ul></div>
<div class="section level3">
<h3 id="other-2-1-1-9048">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9048"></a></h3>
<h3 id="other-2-1-1-9049">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9049"></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>