nmode's Git Repositories - Rnaught/blob - reference/idea.html

   1 <!DOCTYPE html>
   2 <!-- 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"><title>Incidence Decay and Exponential Adjustment (IDEA) — idea • Rnaught</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/font-awesome-6.5.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.5.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="Incidence Decay and Exponential Adjustment (IDEA) — idea"><meta name="description" content="This function implements a least squares estimation method of R0 due to
   3 Fisman et al. (PloS One, 2013). See details for implementation notes."><meta property="og:description" content="This function implements a least squares estimation method of R0 due to
   4 Fisman et al. (PloS One, 2013). See details for implementation notes."><meta property="og:image" content="https://MI2YorkU.github.io/Rnaught/logo.svg"></head><body>
   5     <a href="#main" class="visually-hidden-focusable">Skip to contents</a>
   6
   7
   8     <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">
   9
  10     <a class="navbar-brand me-2" href="../index.html">Rnaught</a>
  11
  12     <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.1.0</small>
  13
  14
  15     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
  16       <span class="navbar-toggler-icon"></span>
  17     </button>
  18
  19     <div id="navbar" class="collapse navbar-collapse ms-3">
  20       <ul class="navbar-nav me-auto"><li class="nav-item"><a class="nav-link" href="../articles/Rnaught.html">Get started</a></li>
  21 <li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
  22 <li class="nav-item dropdown">
  23   <button class="nav-link dropdown-toggle" type="button" id="dropdown-articles" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Articles</button>
  24   <ul class="dropdown-menu" aria-labelledby="dropdown-articles"><li><a class="dropdown-item" href="../articles/seq_bayes_post.html">Sequential Bayes: Utilizing the Posterior Distribution</a></li>
  25     <li><a class="dropdown-item" href="../articles/wp_serial.html">White and Pagano: Utilizing the Serial Distribution</a></li>
  26   </ul></li>
  27       </ul><ul class="navbar-nav"><li class="nav-item"><form class="form-inline" role="search">
  28  <input class="form-control" type="search" name="search-input" id="search-input" autocomplete="off" aria-label="Search site" placeholder="Search for" data-search-index="../search.json"></form></li>
  29 <li class="nav-item"><a class="external-link nav-link" href="https://github.com/MI2YorkU/Rnaught/" aria-label="GitHub"><span class="fa fab fa-github fa-lg"></span></a></li>
  30       </ul></div>
  31
  32
  33   </div>
  34 </nav><div class="container template-reference-topic">
  35 <div class="row">
  36   <main id="main" class="col-md-9"><div class="page-header">
  37       <img src="../logo.svg" class="logo" alt=""><h1>Incidence Decay and Exponential Adjustment (IDEA)</h1>
  38       <small class="dont-index">Source: <a href="https://github.com/MI2YorkU/Rnaught/blob/master/R/idea.R" class="external-link"><code>R/idea.R</code></a></small>
  39       <div class="d-none name"><code>idea.Rd</code></div>
  40     </div>
  41
  42     <div class="ref-description section level2">
  43     <p>This function implements a least squares estimation method of R0 due to
  44 Fisman et al. (PloS One, 2013). See details for implementation notes.</p>
  45     </div>
  46
  47     <div class="section level2">
  48     <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
  49     <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">idea</span><span class="op">(</span><span class="va">cases</span>, <span class="va">mu</span><span class="op">)</span></span></code></pre></div>
  50     </div>
  51
  52     <div class="section level2">
  53     <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>
  54
  55
  56 <dl><dt id="arg-cases">cases<a class="anchor" aria-label="anchor" href="#arg-cases"></a></dt>
  57 <dd><p>Vector of case counts. The vector must be of length at least two
  58 and only contain positive integers.</p></dd>
  59
  60
  61 <dt id="arg-mu">mu<a class="anchor" aria-label="anchor" href="#arg-mu"></a></dt>
  62 <dd><p>Mean of the serial distribution. This must be a positive number.
  63 The value should match the case counts in time units. For example, if case
  64 counts are weekly and the serial distribution has a mean of seven days,
  65 then <code>mu</code> should be set to <code>1</code>. If case counts are daily and the serial
  66 distribution has a mean of seven days, then <code>mu</code> should be set to <code>7</code>.</p></dd>
  67
  68 </dl></div>
  69     <div class="section level2">
  70     <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
  71     <p>An estimate of the basic reproduction number (R0).</p>
  72     </div>
  73     <div class="section level2">
  74     <h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></a></h2>
  75     <p>This method is closely related to that implemented in <code><a href="id.html">id()</a></code>. The method is
  76 based on an incidence decay model. The estimate of R0 is the value which
  77 minimizes the sum of squares between observed case counts and case counts
  78 expected under the model.</p>
  79 <p>This method is based on an approximation of the SIR model, which is most
  80 valid at the beginning of an epidemic. The method assumes that the mean of
  81 the serial distribution (sometimes called the serial interval) is known. The
  82 final estimate can be quite sensitive to this value, so sensitivity testing
  83 is strongly recommended. Users should be careful about units of time (e.g.,
  84 are counts observed daily or weekly?) when implementing.</p>
  85     </div>
  86     <div class="section level2">
  87     <h2 id="references">References<a class="anchor" aria-label="anchor" href="#references"></a></h2>
  88     <p><a href="https://doi.org/10.1371/journal.pone.0083622" class="external-link">Fisman et al. (PloS One, 2013)</a></p>
  89     </div>
  90     <div class="section level2">
  91     <h2 id="see-also">See also<a class="anchor" aria-label="anchor" href="#see-also"></a></h2>
  92     <div class="dont-index"><p><code><a href="id.html">id()</a></code> for a similar method.</p></div>
  93     </div>
  94
  95     <div class="section level2">
  96     <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
  97     <div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="co"># Weekly data.</span></span></span>
  98 <span class="r-in"><span><span class="va">cases</span> <span class="op">&lt;-</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">4</span>, <span class="fl">10</span>, <span class="fl">5</span>, <span class="fl">3</span>, <span class="fl">4</span>, <span class="fl">19</span>, <span class="fl">3</span>, <span class="fl">3</span>, <span class="fl">14</span>, <span class="fl">4</span><span class="op">)</span></span></span>
  99 <span class="r-in"><span></span></span>
 100 <span class="r-in"><span><span class="co"># Obtain R0 when the serial distribution has a mean of five days.</span></span></span>
 101 <span class="r-in"><span><span class="fu">idea</span><span class="op">(</span><span class="va">cases</span>, mu <span class="op">=</span> <span class="fl">5</span> <span class="op">/</span> <span class="fl">7</span><span class="op">)</span></span></span>
 102 <span class="r-out co"><span class="r-pr">#&gt;</span> [1] 1.419546</span>
 103 <span class="r-in"><span></span></span>
 104 <span class="r-in"><span><span class="co"># Obtain R0 when the serial distribution has a mean of three days.</span></span></span>
 105 <span class="r-in"><span><span class="fu">idea</span><span class="op">(</span><span class="va">cases</span>, mu <span class="op">=</span> <span class="fl">3</span> <span class="op">/</span> <span class="fl">7</span><span class="op">)</span></span></span>
 106 <span class="r-out co"><span class="r-pr">#&gt;</span> [1] 1.233927</span>
 107 </code></pre></div>
 108     </div>
 109   </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
 110     </nav></aside></div>
 111
 112
 113     <footer><div class="pkgdown-footer-left">
 114   <p>Developed by Naeem Model, Sawitree Boonpatcharanon, Jane Heffernan, Hanna Jankowski.</p>
 115 </div>
 116
 117 <div class="pkgdown-footer-right">
 118   <p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.1.1.</p>
 119 </div>
 120
 121     </footer></div>
 122
 123
 124
 125
 126
 127   </body></html>
 128