mirror of
https://github.com/msberends/AMR.git
synced 2024-12-26 18:06:11 +01:00
402 lines
32 KiB
HTML
402 lines
32 KiB
HTML
<!DOCTYPE html>
|
|
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><meta name="description" content="Create a prediction model to predict antimicrobial resistance for the next years on statistical solid ground. Standard errors (SE) will be returned as columns se_min and se_max. See Examples for a real live example."><title>Predict Antimicrobial Resistance — resistance_predict • AMR (for R)</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/Lato-0.4.9/font.css" rel="stylesheet"><link href="../deps/Fira_Code-0.4.9/font.css" rel="stylesheet"><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous"><!-- bootstrap-toc --><script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@v1.0.1/dist/bootstrap-toc.min.js" integrity="sha256-4veVQbu7//Lk5TSmc7YV48MxtMy98e26cf5MrgZYnwo=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- search --><script src="https://cdnjs.cloudflare.com/ajax/libs/fuse.js/6.4.6/fuse.js" integrity="sha512-zv6Ywkjyktsohkbp9bb45V6tEMoWhzFzXis+LrMehmJZZSys19Yxf1dopHx7WzIKxr5tK2dVcYmaCk2uqdjF4A==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/autocomplete.js/0.38.0/autocomplete.jquery.min.js" integrity="sha512-GU9ayf+66Xx2TmpxqJpliWbT5PiGYxpaG8rfnBEk1LL8l1KGkRShhngwdXK1UgqhAzWpZHSiYPc09/NwDQIGyg==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/mark.min.js" integrity="sha512-5CYOlHXGh6QpOFA/TeTylKLWfB3ftPsde7AnmhuitiTX4K5SqCLBeKro6sPS8ilsz1Q4NRx3v8Ko2IBiszzdww==" crossorigin="anonymous"></script><!-- pkgdown --><script src="../pkgdown.js"></script><link href="../extra.css" rel="stylesheet"><script src="../extra.js"></script><meta property="og:title" content="Predict Antimicrobial Resistance — resistance_predict"><meta property="og:description" content="Create a prediction model to predict antimicrobial resistance for the next years on statistical solid ground. Standard errors (SE) will be returned as columns se_min and se_max. See Examples for a real live example."><meta property="og:image" content="https://msberends.github.io/AMR/logo.svg"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:creator" content="@msberends"><meta name="twitter:site" content="@msberends"><!-- mathjax --><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script><!--[if lt IE 9]>
|
|
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
|
|
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
|
|
<![endif]--></head><body>
|
|
<a href="#main" class="visually-hidden-focusable">Skip to contents</a>
|
|
|
|
|
|
<nav class="navbar fixed-top navbar-dark navbar-expand-lg bg-primary"><div class="container">
|
|
|
|
<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.9018</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">
|
|
<span class="navbar-toggler-icon"></span>
|
|
</button>
|
|
|
|
<div id="navbar" class="collapse navbar-collapse ms-3">
|
|
<ul class="navbar-nav me-auto"><li class="nav-item dropdown">
|
|
<a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown" role="button" aria-expanded="false" aria-haspopup="true" id="dropdown--how-to">
|
|
<span class="fa fa-question-circle"></span>
|
|
|
|
How to
|
|
</a>
|
|
<div class="dropdown-menu" aria-labelledby="dropdown--how-to">
|
|
<a class="dropdown-item" href="../articles/AMR.html">
|
|
<span class="fa fa-directions"></span>
|
|
|
|
Conduct AMR Analysis
|
|
</a>
|
|
<a class="dropdown-item" href="../reference/antibiogram.html">
|
|
<span class="fa fa-file-prescription"></span>
|
|
|
|
Generate Antibiogram (Trad./Syndromic/WISCA)
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/resistance_predict.html">
|
|
<span class="fa fa-dice"></span>
|
|
|
|
Predict Antimicrobial Resistance
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/datasets.html">
|
|
<span class="fa fa-database"></span>
|
|
|
|
Download Data Sets for Own Use
|
|
</a>
|
|
<a class="dropdown-item" href="../reference/AMR-options.html">
|
|
<span class="fa fa-gear"></span>
|
|
|
|
Set User- Or Team-specific Package Settings
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/PCA.html">
|
|
<span class="fa fa-compress"></span>
|
|
|
|
Conduct Principal Component Analysis for AMR
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/MDR.html">
|
|
<span class="fa fa-skull-crossbones"></span>
|
|
|
|
Determine Multi-Drug Resistance (MDR)
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/WHONET.html">
|
|
<span class="fa fa-globe-americas"></span>
|
|
|
|
Work with WHONET Data
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/EUCAST.html">
|
|
<span class="fa fa-exchange-alt"></span>
|
|
|
|
Apply Eucast Rules
|
|
</a>
|
|
<a class="dropdown-item" href="../reference/mo_property.html">
|
|
<span class="fa fa-bug"></span>
|
|
|
|
Get Taxonomy of a Microorganism
|
|
</a>
|
|
<a class="dropdown-item" href="../reference/ab_property.html">
|
|
<span class="fa fa-capsules"></span>
|
|
|
|
Get Properties of an Antibiotic Drug
|
|
</a>
|
|
<a class="dropdown-item" href="../reference/av_property.html">
|
|
<span class="fa fa-capsules"></span>
|
|
|
|
Get Properties of an Antiviral Drug
|
|
</a>
|
|
</div>
|
|
</li>
|
|
<li class="nav-item dropdown">
|
|
<a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown" role="button" aria-expanded="false" aria-haspopup="true" id="dropdown--with-other-pkgs">
|
|
<span class="fa fa-layer-group"></span>
|
|
|
|
With other pkgs
|
|
</a>
|
|
<div class="dropdown-menu" aria-labelledby="dropdown--with-other-pkgs">
|
|
<a class="dropdown-item" href="../articles/other_pkg.html">
|
|
<span class="fa fa-layer-group"></span>
|
|
|
|
AMR & dplyr/tidyverse
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/other_pkg.html">
|
|
<span class="fa fa-layer-group"></span>
|
|
|
|
AMR & data.table
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/other_pkg.html">
|
|
<span class="fa fa-layer-group"></span>
|
|
|
|
AMR & tidymodels
|
|
</a>
|
|
<a class="dropdown-item" href="../articles/other_pkg.html">
|
|
<span class="fa fa-layer-group"></span>
|
|
|
|
AMR & base R
|
|
</a>
|
|
</div>
|
|
</li>
|
|
<li class="active nav-item">
|
|
<a class="nav-link" href="../reference/index.html">
|
|
<span class="fa fa-book-open"></span>
|
|
|
|
Manual
|
|
</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="../authors.html">
|
|
<span class="fa fa-users"></span>
|
|
|
|
Authors
|
|
</a>
|
|
</li>
|
|
</ul><form class="form-inline my-2 my-lg-0" role="search">
|
|
<input type="search" class="form-control me-sm-2" aria-label="Toggle navigation" name="search-input" data-search-index="../search.json" id="search-input" placeholder="Search for" autocomplete="off"></form>
|
|
|
|
<ul class="navbar-nav"><li class="nav-item">
|
|
<a class="nav-link" href="../news/index.html">
|
|
<span class="far fa far fa-newspaper"></span>
|
|
|
|
Changelog
|
|
</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="external-link nav-link" href="https://github.com/msberends/AMR">
|
|
<span class="fab fa fab fa-github"></span>
|
|
|
|
Source Code
|
|
</a>
|
|
</li>
|
|
</ul></div>
|
|
|
|
|
|
</div>
|
|
</nav><div class="container template-reference-topic">
|
|
<div class="row">
|
|
<main id="main" class="col-md-9"><div class="page-header">
|
|
<img src="../logo.svg" class="logo" alt=""><h1>Predict Antimicrobial Resistance</h1>
|
|
<small class="dont-index">Source: <a href="https://github.com/msberends/AMR/blob/HEAD/R/resistance_predict.R" class="external-link"><code>R/resistance_predict.R</code></a></small>
|
|
<div class="d-none name"><code>resistance_predict.Rd</code></div>
|
|
</div>
|
|
|
|
<div class="ref-description section level2">
|
|
<p>Create a prediction model to predict antimicrobial resistance for the next years on statistical solid ground. Standard errors (SE) will be returned as columns <code>se_min</code> and <code>se_max</code>. See <em>Examples</em> for a real live example.</p>
|
|
</div>
|
|
|
|
<div class="section level2">
|
|
<h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
|
|
<div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">resistance_predict</span><span class="op">(</span></span>
|
|
<span> <span class="va">x</span>,</span>
|
|
<span> <span class="va">col_ab</span>,</span>
|
|
<span> col_date <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> year_min <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> year_max <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> year_every <span class="op">=</span> <span class="fl">1</span>,</span>
|
|
<span> minimum <span class="op">=</span> <span class="fl">30</span>,</span>
|
|
<span> model <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> I_as_S <span class="op">=</span> <span class="cn">TRUE</span>,</span>
|
|
<span> preserve_measurements <span class="op">=</span> <span class="cn">TRUE</span>,</span>
|
|
<span> info <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/interactive.html" class="external-link">interactive</a></span><span class="op">(</span><span class="op">)</span>,</span>
|
|
<span> <span class="va">...</span></span>
|
|
<span><span class="op">)</span></span>
|
|
<span></span>
|
|
<span><span class="fu">sir_predict</span><span class="op">(</span></span>
|
|
<span> <span class="va">x</span>,</span>
|
|
<span> <span class="va">col_ab</span>,</span>
|
|
<span> col_date <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> year_min <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> year_max <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> year_every <span class="op">=</span> <span class="fl">1</span>,</span>
|
|
<span> minimum <span class="op">=</span> <span class="fl">30</span>,</span>
|
|
<span> model <span class="op">=</span> <span class="cn">NULL</span>,</span>
|
|
<span> I_as_S <span class="op">=</span> <span class="cn">TRUE</span>,</span>
|
|
<span> preserve_measurements <span class="op">=</span> <span class="cn">TRUE</span>,</span>
|
|
<span> info <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/interactive.html" class="external-link">interactive</a></span><span class="op">(</span><span class="op">)</span>,</span>
|
|
<span> <span class="va">...</span></span>
|
|
<span><span class="op">)</span></span>
|
|
<span></span>
|
|
<span><span class="co"># S3 method for resistance_predict</span></span>
|
|
<span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">x</span>, main <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/paste.html" class="external-link">paste</a></span><span class="op">(</span><span class="st">"Resistance Prediction of"</span>, <span class="va">x_name</span><span class="op">)</span>, <span class="va">...</span><span class="op">)</span></span>
|
|
<span></span>
|
|
<span><span class="fu">ggplot_sir_predict</span><span class="op">(</span></span>
|
|
<span> <span class="va">x</span>,</span>
|
|
<span> main <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/paste.html" class="external-link">paste</a></span><span class="op">(</span><span class="st">"Resistance Prediction of"</span>, <span class="va">x_name</span><span class="op">)</span>,</span>
|
|
<span> ribbon <span class="op">=</span> <span class="cn">TRUE</span>,</span>
|
|
<span> <span class="va">...</span></span>
|
|
<span><span class="op">)</span></span>
|
|
<span></span>
|
|
<span><span class="co"># S3 method for resistance_predict</span></span>
|
|
<span><span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span></span>
|
|
<span> <span class="va">object</span>,</span>
|
|
<span> main <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/paste.html" class="external-link">paste</a></span><span class="op">(</span><span class="st">"Resistance Prediction of"</span>, <span class="va">x_name</span><span class="op">)</span>,</span>
|
|
<span> ribbon <span class="op">=</span> <span class="cn">TRUE</span>,</span>
|
|
<span> <span class="va">...</span></span>
|
|
<span><span class="op">)</span></span></code></pre></div>
|
|
</div>
|
|
|
|
<div class="section level2">
|
|
<h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>
|
|
<dl><dt>x</dt>
|
|
<dd><p>a <a href="https://rdrr.io/r/base/data.frame.html" class="external-link">data.frame</a> containing isolates. Can be left blank for automatic determination, see <em>Examples</em>.</p></dd>
|
|
|
|
|
|
<dt>col_ab</dt>
|
|
<dd><p>column name of <code>x</code> containing antimicrobial interpretations (<code>"R"</code>, <code>"I"</code> and <code>"S"</code>)</p></dd>
|
|
|
|
|
|
<dt>col_date</dt>
|
|
<dd><p>column name of the date, will be used to calculate years if this column doesn't consist of years already - the default is the first column of with a date class</p></dd>
|
|
|
|
|
|
<dt>year_min</dt>
|
|
<dd><p>lowest year to use in the prediction model, dafaults to the lowest year in <code>col_date</code></p></dd>
|
|
|
|
|
|
<dt>year_max</dt>
|
|
<dd><p>highest year to use in the prediction model - the default is 10 years after today</p></dd>
|
|
|
|
|
|
<dt>year_every</dt>
|
|
<dd><p>unit of sequence between lowest year found in the data and <code>year_max</code></p></dd>
|
|
|
|
|
|
<dt>minimum</dt>
|
|
<dd><p>minimal amount of available isolates per year to include. Years containing less observations will be estimated by the model.</p></dd>
|
|
|
|
|
|
<dt>model</dt>
|
|
<dd><p>the statistical model of choice. This could be a generalised linear regression model with binomial distribution (i.e. using <code>glm(..., family = binomial)</code>, assuming that a period of zero resistance was followed by a period of increasing resistance leading slowly to more and more resistance. See <em>Details</em> for all valid options.</p></dd>
|
|
|
|
|
|
<dt>I_as_S</dt>
|
|
<dd><p>a <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to indicate whether values <code>"I"</code> should be treated as <code>"S"</code> (will otherwise be treated as <code>"R"</code>). The default, <code>TRUE</code>, follows the redefinition by EUCAST about the interpretation of I (increased exposure) in 2019, see section <em>Interpretation of S, I and R</em> below.</p></dd>
|
|
|
|
|
|
<dt>preserve_measurements</dt>
|
|
<dd><p>a <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to indicate whether predictions of years that are actually available in the data should be overwritten by the original data. The standard errors of those years will be <code>NA</code>.</p></dd>
|
|
|
|
|
|
<dt>info</dt>
|
|
<dd><p>a <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to indicate whether textual analysis should be printed with the name and <code><a href="https://rdrr.io/r/base/summary.html" class="external-link">summary()</a></code> of the statistical model.</p></dd>
|
|
|
|
|
|
<dt>...</dt>
|
|
<dd><p>arguments passed on to functions</p></dd>
|
|
|
|
|
|
<dt>main</dt>
|
|
<dd><p>title of the plot</p></dd>
|
|
|
|
|
|
<dt>ribbon</dt>
|
|
<dd><p>a <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to indicate whether a ribbon should be shown (default) or error bars</p></dd>
|
|
|
|
|
|
<dt>object</dt>
|
|
<dd><p>model data to be plotted</p></dd>
|
|
|
|
</dl></div>
|
|
<div class="section level2">
|
|
<h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
|
|
|
|
|
|
<p>A <a href="https://rdrr.io/r/base/data.frame.html" class="external-link">data.frame</a> with extra class <code>resistance_predict</code> with columns:</p><ul><li><p><code>year</code></p></li>
|
|
<li><p><code>value</code>, the same as <code>estimated</code> when <code>preserve_measurements = FALSE</code>, and a combination of <code>observed</code> and <code>estimated</code> otherwise</p></li>
|
|
<li><p><code>se_min</code>, the lower bound of the standard error with a minimum of <code>0</code> (so the standard error will never go below 0%)</p></li>
|
|
<li><p><code>se_max</code> the upper bound of the standard error with a maximum of <code>1</code> (so the standard error will never go above 100%)</p></li>
|
|
<li><p><code>observations</code>, the total number of available observations in that year, i.e. \(S + I + R\)</p></li>
|
|
<li><p><code>observed</code>, the original observed resistant percentages</p></li>
|
|
<li><p><code>estimated</code>, the estimated resistant percentages, calculated by the model</p></li>
|
|
</ul><p>Furthermore, the model itself is available as an attribute: <code>attributes(x)$model</code>, see <em>Examples</em>.</p>
|
|
</div>
|
|
<div class="section level2">
|
|
<h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></a></h2>
|
|
<p>Valid options for the statistical model (argument <code>model</code>) are:</p><ul><li><p><code>"binomial"</code> or <code>"binom"</code> or <code>"logit"</code>: a generalised linear regression model with binomial distribution</p></li>
|
|
<li><p><code>"loglin"</code> or <code>"poisson"</code>: a generalised log-linear regression model with poisson distribution</p></li>
|
|
<li><p><code>"lin"</code> or <code>"linear"</code>: a linear regression model</p></li>
|
|
</ul></div>
|
|
<div class="section level2">
|
|
<h2 id="interpretation-of-sir">Interpretation of SIR<a class="anchor" aria-label="anchor" href="#interpretation-of-sir"></a></h2>
|
|
|
|
|
|
<p>In 2019, the European Committee on Antimicrobial Susceptibility Testing (EUCAST) has decided to change the definitions of susceptibility testing categories S, I, and R as shown below (<a href="https://www.eucast.org/newsiandr" class="external-link">https://www.eucast.org/newsiandr</a>):</p><ul><li><p><strong>S - Susceptible, standard dosing regimen</strong><br>
|
|
A microorganism is categorised as "Susceptible, standard dosing regimen", when there is a high likelihood of therapeutic success using a standard dosing regimen of the agent.</p></li>
|
|
<li><p><strong>I - Susceptible, increased exposure</strong> <em><br>
|
|
A microorganism is categorised as "Susceptible, Increased exposure</em>" when there is a high likelihood of therapeutic success because exposure to the agent is increased by adjusting the dosing regimen or by its concentration at the site of infection.</p></li>
|
|
<li><p><strong>R = Resistant</strong><br>
|
|
A microorganism is categorised as "Resistant" when there is a high likelihood of therapeutic failure even when there is increased exposure.</p><ul><li><p><em>Exposure</em> is a function of how the mode of administration, dose, dosing interval, infusion time, as well as distribution and excretion of the antimicrobial agent will influence the infecting organism at the site of infection.</p></li>
|
|
</ul></li>
|
|
</ul><p>This AMR package honours this insight. Use <code><a href="proportion.html">susceptibility()</a></code> (equal to <code><a href="proportion.html">proportion_SI()</a></code>) to determine antimicrobial susceptibility and <code><a href="count.html">count_susceptible()</a></code> (equal to <code><a href="count.html">count_SI()</a></code>) to count susceptible isolates.</p>
|
|
</div>
|
|
<div class="section level2">
|
|
<h2 id="see-also">See also<a class="anchor" aria-label="anchor" href="#see-also"></a></h2>
|
|
<div class="dont-index"><p>The <code><a href="proportion.html">proportion()</a></code> functions to calculate resistance</p>
|
|
<p>Models: <code><a href="https://rdrr.io/r/stats/lm.html" class="external-link">lm()</a></code> <code><a href="https://rdrr.io/r/stats/glm.html" class="external-link">glm()</a></code></p></div>
|
|
</div>
|
|
|
|
<div class="section level2">
|
|
<h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
|
|
<div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="va">x</span> <span class="op"><-</span> <span class="fu">resistance_predict</span><span class="op">(</span><span class="va">example_isolates</span>,</span></span>
|
|
<span class="r-in"><span> col_ab <span class="op">=</span> <span class="st">"AMX"</span>,</span></span>
|
|
<span class="r-in"><span> year_min <span class="op">=</span> <span class="fl">2010</span>,</span></span>
|
|
<span class="r-in"><span> model <span class="op">=</span> <span class="st">"binomial"</span></span></span>
|
|
<span class="r-in"><span><span class="op">)</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">x</span><span class="op">)</span></span></span>
|
|
<span class="r-plt img"><img src="resistance_predict-1.png" alt="" width="700" height="433"></span>
|
|
<span class="r-in"><span><span class="co"># \donttest{</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">ggplot_sir_predict</span><span class="op">(</span><span class="va">x</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="resistance_predict-2.png" alt="" width="700" height="433"></span>
|
|
<span class="r-in"><span></span></span>
|
|
<span class="r-in"><span><span class="co"># using dplyr:</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://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
|
|
<span class="r-in"><span> <span class="va">x</span> <span class="op"><-</span> <span class="va">example_isolates</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%>%</a></span></span></span>
|
|
<span class="r-in"><span> <span class="fu"><a href="first_isolate.html">filter_first_isolate</a></span><span class="op">(</span><span class="op">)</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%>%</a></span></span></span>
|
|
<span class="r-in"><span> <span class="fu"><a href="https://dplyr.tidyverse.org/reference/filter.html" class="external-link">filter</a></span><span class="op">(</span><span class="fu"><a href="mo_property.html">mo_genus</a></span><span class="op">(</span><span class="va">mo</span><span class="op">)</span> <span class="op">==</span> <span class="st">"Staphylococcus"</span><span class="op">)</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%>%</a></span></span></span>
|
|
<span class="r-in"><span> <span class="fu">resistance_predict</span><span class="op">(</span><span class="st">"PEN"</span>, model <span class="op">=</span> <span class="st">"binomial"</span><span class="op">)</span></span></span>
|
|
<span class="r-in"><span> <span class="fu"><a href="https://rdrr.io/r/base/print.html" class="external-link">print</a></span><span class="op">(</span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">x</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="co"># get the model from the object</span></span></span>
|
|
<span class="r-in"><span> <span class="va">mymodel</span> <span class="op"><-</span> <span class="fu"><a href="https://rdrr.io/r/base/attributes.html" class="external-link">attributes</a></span><span class="op">(</span><span class="va">x</span><span class="op">)</span><span class="op">$</span><span class="va">model</span></span></span>
|
|
<span class="r-in"><span> <span class="fu"><a href="https://rdrr.io/r/base/summary.html" class="external-link">summary</a></span><span class="op">(</span><span class="va">mymodel</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="resistance_predict-3.png" alt="" width="700" height="433"></span>
|
|
<span class="r-out co"><span class="r-pr">#></span> NULL</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> </span>
|
|
<span class="r-out co"><span class="r-pr">#></span> Call:</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> glm(formula = df_matrix ~ year, family = binomial)</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> </span>
|
|
<span class="r-out co"><span class="r-pr">#></span> Coefficients:</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> Estimate Std. Error z value Pr(>|z|)</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> (Intercept) 27.05312 72.24652 0.374 0.708</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> year -0.01286 0.03601 -0.357 0.721</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> </span>
|
|
<span class="r-out co"><span class="r-pr">#></span> (Dispersion parameter for binomial family taken to be 1)</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> </span>
|
|
<span class="r-out co"><span class="r-pr">#></span> Null deviance: 5.7883 on 11 degrees of freedom</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> Residual deviance: 5.6608 on 10 degrees of freedom</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> AIC: 50.745</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> </span>
|
|
<span class="r-out co"><span class="r-pr">#></span> Number of Fisher Scoring iterations: 4</span>
|
|
<span class="r-out co"><span class="r-pr">#></span> </span>
|
|
<span class="r-in"><span></span></span>
|
|
<span class="r-in"><span><span class="co"># create nice plots with ggplot2 yourself</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://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</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">data</span> <span class="op"><-</span> <span class="va">example_isolates</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%>%</a></span></span></span>
|
|
<span class="r-in"><span> <span class="fu"><a href="https://dplyr.tidyverse.org/reference/filter.html" class="external-link">filter</a></span><span class="op">(</span><span class="va">mo</span> <span class="op">==</span> <span class="fu"><a href="as.mo.html">as.mo</a></span><span class="op">(</span><span class="st">"E. coli"</span><span class="op">)</span><span class="op">)</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%>%</a></span></span></span>
|
|
<span class="r-in"><span> <span class="fu">resistance_predict</span><span class="op">(</span></span></span>
|
|
<span class="r-in"><span> col_ab <span class="op">=</span> <span class="st">"AMX"</span>,</span></span>
|
|
<span class="r-in"><span> col_date <span class="op">=</span> <span class="st">"date"</span>,</span></span>
|
|
<span class="r-in"><span> model <span class="op">=</span> <span class="st">"binomial"</span>,</span></span>
|
|
<span class="r-in"><span> info <span class="op">=</span> <span class="cn">FALSE</span>,</span></span>
|
|
<span class="r-in"><span> minimum <span class="op">=</span> <span class="fl">15</span></span></span>
|
|
<span class="r-in"><span> <span class="op">)</span></span></span>
|
|
<span class="r-in"><span> <span class="fu"><a href="https://rdrr.io/r/utils/head.html" class="external-link">head</a></span><span class="op">(</span><span class="va">data</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">data</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="resistance_predict-4.png" alt="" width="700" height="433"></span>
|
|
<span class="r-in"><span><span class="co"># }</span></span></span>
|
|
</code></pre></div>
|
|
</div>
|
|
</main><aside class="col-md-3"><nav id="toc"><h2>On this page</h2>
|
|
</nav></aside></div>
|
|
|
|
|
|
<footer><div class="pkgdown-footer-left">
|
|
<p></p><p><code>AMR</code> (for R). Free and open-source, licenced under the <a target="_blank" href="https://github.com/msberends/AMR/blob/main/LICENSE" class="external-link">GNU General Public License version 2.0 (GPL-2)</a>.<br>Developed at the <a target="_blank" href="https://www.rug.nl" class="external-link">University of Groningen</a> and <a target="_blank" href="https://www.umcg.nl" class="external-link">University Medical Center Groningen</a> in The Netherlands.</p>
|
|
</div>
|
|
|
|
<div class="pkgdown-footer-right">
|
|
<p></p><p><a target="_blank" href="https://www.rug.nl" class="external-link"><img src="https://github.com/msberends/AMR/raw/main/pkgdown/logos/logo_rug.svg" style="max-width: 150px;"></a><a target="_blank" href="https://www.umcg.nl" class="external-link"><img src="https://github.com/msberends/AMR/raw/main/pkgdown/logos/logo_umcg.svg" style="max-width: 150px;"></a></p>
|
|
</div>
|
|
|
|
</footer></div>
|
|
|
|
|
|
|
|
|
|
|
|
</body></html>
|
|
|