P281424/AMR
1
0
Fork 0
mirror of https://github.com/msberends/AMR.git synced 2025-07-10 01:42:41 +02:00
Code Releases Activity

Built site for AMR@2.1.1.9133: 9520977

Browse Source
This commit is contained in:
github-actions
2025-01-27 21:16:06 +00:00
parent 322b29a823
commit 20d0d4d3e5
93 changed files with 1017 additions and 1320 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
news/index.html
View File

@ -7,7 +7,7 @@
<a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
<small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9125</small>
<small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9133</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">
@ -48,18 +48,18 @@
</div>
<div class="section level2">
<h2 class="pkg-version" data-toc-text="2.1.1.9125" id="amr-2119125">AMR 2.1.1.9125<a class="anchor" aria-label="anchor" href="#amr-2119125"></a></h2>
<h2 class="pkg-version" data-toc-text="2.1.1.9133" id="amr-2119133">AMR 2.1.1.9133<a class="anchor" aria-label="anchor" href="#amr-2119133"></a></h2>
<p><em>(this beta version will eventually become v3.0. We’re happy to reach a new major milestone soon, which will be all about the new One Health support! Install this beta using <a href="https://msberends.github.io/AMR/#latest-development-version">the instructions here</a>.)</em></p>
<div class="section level5">
<h5 id="a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9125">A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)<a class="anchor" aria-label="anchor" href="#a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9125"></a></h5>
<h5 id="a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9133">A New Milestone: AMR v3.0 with One Health Support (= Human + Veterinary + Environmental)<a class="anchor" aria-label="anchor" href="#a-new-milestone-amr-v30-with-one-health-support--human--veterinary--environmental-2-1-1-9133"></a></h5>
<p>This package now supports not only tools for AMR data analysis in clinical settings, but also for veterinary and environmental microbiology. This was made possible through a collaboration with the <a href="https://www.upei.ca/avc" class="external-link">University of Prince Edward Island’s Atlantic Veterinary College</a>, Canada. To celebrate this great improvement of the package, we also updated the package logo to reflect this change.</p>
</div>
<div class="section level3">
<h3 id="breaking-2-1-1-9125">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9125"></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>
<h3 id="breaking-2-1-1-9133">Breaking<a class="anchor" aria-label="anchor" href="#breaking-2-1-1-9133"></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 two years ago</li>
</ul></div>
<div class="section level3">
<h3 id="new-2-1-1-9125">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9125"></a></h3>
<h3 id="new-2-1-1-9133">New<a class="anchor" aria-label="anchor" href="#new-2-1-1-9133"></a></h3>
<ul><li>
<strong>One Health implementation</strong>
<ul><li>Function <code><a href="../reference/as.sir.html">as.sir()</a></code> now has extensive support for veterinary breakpoints from CLSI. Use <code>breakpoint_type = "animal"</code> and set the <code>host</code> argument to a variable that contains animal species names.</li>
@ -72,6 +72,10 @@
<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>
<strong>Support for WISCA antibiograms</strong>
<ul><li>The <code><a href="../reference/antibiogram.html">antibiogram()</a></code> function now supports creating true Weighted-Incidence Syndromic Combination Antibiograms (WISCA), a powerful Bayesian method for estimating regimen coverage probabilities using pathogen incidence and antimicrobial susceptibility data. WISCA offers improved precision for syndrome-specific treatment, even in datasets with sparse data. A dedicated <code><a href="../reference/antibiogram.html">wisca()</a></code> function is also available for easy usage.</li>
</ul></li>
<li>
<strong>Major update to fungal taxonomy and tools for mycologists</strong>
<ul><li>MycoBank has now been integrated as the primary taxonomic source for fungi. The <code>microorganisms</code> data set has been enriched with new columns (<code>mycobank</code>, <code>mycobank_parent</code>, and <code>mycobank_renamed_to</code>) that provide detailed information for fungal species.</li>
<li>A remarkable addition of over 20,000 new fungal records</li>
@ -100,11 +104,12 @@
</ul></li>
<li>
<strong>Other</strong>
<ul><li>New 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 belong to that group.</li>
<ul><li>New function <code><a href="../reference/top_n_microorganisms.html">top_n_microorganisms()</a></code> to filter a data set to the top <em>n</em> of any taxonomic property, e.g., filter to the top 3 species, filter to any species in the top 5 genera, or filter to the top 3 species in each of the top 5 genera</li>
<li>New 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 belong to that group.</li>
</ul></li>
</ul></div>
<div class="section level3">
<h3 id="changed-2-1-1-9125">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9125"></a></h3>
<h3 id="changed-2-1-1-9133">Changed<a class="anchor" aria-label="anchor" href="#changed-2-1-1-9133"></a></h3>
<ul><li>SIR interpretation
<ul><li>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>Users can now set their own criteria (using regular expressions) as to what should be considered S, I, R, SDD, and NI.</li>
@ -149,13 +154,13 @@
<li>Added over 1,500 trade names for antibiotics</li>
<li>Fix for using a manual value for <code>mo_transform</code> in <code><a href="../reference/antibiogram.html">antibiogram()</a></code>
</li>
<li>Fixed a bug for when <code><a href="../reference/antibiogram.html">antibiogram()</a></code> returns an empty data set</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:
<ul><li>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>Genera from the World Health Organization’s (WHO) Priority Pathogen List now have the highest prevalence</li>
</ul></li>
<li>Fixed a bug for when <code><a href="../reference/antibiogram.html">antibiogram()</a></code> returns an empty data set</li>
<li>Fixed a bug for <code><a href="../reference/proportion.html">sir_confidence_interval()</a></code> when there are no isolates available</li>
<li>Updated the prevalence calculation to include genera from the World Health Organization’s (WHO) Priority Pathogen List</li>
<li>Improved algorithm of <code><a href="../reference/first_isolate.html">first_isolate()</a></code> when using the phenotype-based method, to prioritise records with the highest availability of SIR values</li>
@ -167,15 +172,16 @@
</ul></li>
</ul></div>
<div class="section level3">
<h3 id="other-2-1-1-9125">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9125"></a></h3>
<ul><li>Greatly improved <code>vctrs</code> integration, a Tidyverse package working in the background for many Tidyverse functions. For users, this means that functions such as <code>dplyr</code>’s <code><a href="https://dplyr.tidyverse.org/reference/bind_rows.html" class="external-link">bind_rows()</a></code>, <code><a href="https://dplyr.tidyverse.org/reference/rowwise.html" class="external-link">rowwise()</a></code> and <code><a href="https://dplyr.tidyverse.org/reference/c_across.html" class="external-link">c_across()</a></code> are now supported for e.g. columns of class <code>mic</code>. Despite this, this <code>AMR</code> package is still zero-dependent on any other package, including <code>dplyr</code> and <code>vctrs</code>.</li>
<h3 id="other-2-1-1-9133">Other<a class="anchor" aria-label="anchor" href="#other-2-1-1-9133"></a></h3>
<ul><li>Added Dr. Larisse Bolton as contributor for her fantastic implementation of WISCA in a mathematically solid way</li>
<li>Added Matthew Saab, Dr. Jordan Stull, and Prof. Javier Sanchez as contributors for their tremendous input on veterinary breakpoints and interpretations</li>
<li>Greatly improved <code>vctrs</code> integration, a Tidyverse package working in the background for many Tidyverse functions. For users, this means that functions such as <code>dplyr</code>’s <code><a href="https://dplyr.tidyverse.org/reference/bind_rows.html" class="external-link">bind_rows()</a></code>, <code><a href="https://dplyr.tidyverse.org/reference/rowwise.html" class="external-link">rowwise()</a></code> and <code><a href="https://dplyr.tidyverse.org/reference/c_across.html" class="external-link">c_across()</a></code> are now supported for e.g. columns of class <code>mic</code>. Despite this, this <code>AMR</code> package is still zero-dependent on any other package, including <code>dplyr</code> and <code>vctrs</code>.</li>
<li>Greatly updated and expanded documentation</li>
<li>Added Larisse Bolton, Jordan Stull, Matthew Saab, and Javier Sanchez as contributors, to thank them for their valuable input</li>
<li>Stopped support for SAS (<code>.xpt</code>) files, since their file structure and extremely inefficient and requires more disk space than GitHub allows in a single commit.</li>
</ul></div>
<div class="section level3">
<h3 id="older-versions-2-1-1-9125">Older Versions<a class="anchor" aria-label="anchor" href="#older-versions-2-1-1-9125"></a></h3>
<p>This changelog only contains changes from AMR v3.0 (October 2024) and later.</p>
<h3 id="older-versions-2-1-1-9133">Older Versions<a class="anchor" aria-label="anchor" href="#older-versions-2-1-1-9133"></a></h3>
<p>This changelog only contains changes from AMR v3.0 (February 2025) and later.</p>
<ul><li>For prior v2 versions, please see <a href="https://github.com/msberends/AMR/blob/v2.1.1/NEWS.md" class="external-link">our v2 archive</a>.</li>
<li>For prior v1 versions, please see <a href="https://github.com/msberends/AMR/blob/v1.8.2/NEWS.md" class="external-link">our v1 archive</a>.</li>
</ul></div>