From 3fe40a12a43a41c660ddad45061411b40aa0526b Mon Sep 17 00:00:00 2001
From: gvegayon <g.vegayon@gmail.com>
Date: Mon, 7 Oct 2024 18:09:10 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20UofUEpiB?=
 =?UTF-8?q?io/epiworldR@fd771452a9fd67153b699d8e56ec226b0d39cf88=20?=
 =?UTF-8?q?=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 404.html                                      |   2 +-
 CODE_OF_CONDUCT.html                          |   2 +-
 LICENSE-text.html                             |   2 +-
 LICENSE.html                                  |   2 +-
 articles/getting-started.html                 |  28 +--
 articles/implementation.html                  |   2 +-
 articles/index.html                           |   2 +-
 articles/mixing.html                          |   8 +-
 articles/run-multiple.html                    |  14 +-
 authors.html                                  |   6 +-
 index.html                                    | 235 +++++++++---------
 news/index.html                               |   6 +-
 paper.html                                    |   2 +-
 pkgdown.yml                                   |   2 +-
 reference/ModelDiffNet.html                   |   2 +-
 reference/ModelSEIR.html                      |   2 +-
 reference/ModelSEIRCONN.html                  |   2 +-
 reference/ModelSEIRD.html                     |   2 +-
 reference/ModelSEIRDCONN.html                 |   2 +-
 reference/ModelSEIRMixing.html                |   6 +-
 reference/ModelSIR.html                       |   2 +-
 reference/ModelSIRCONN.html                   |   2 +-
 reference/ModelSIRD.html                      |   2 +-
 reference/ModelSIRDCONN.html                  |   2 +-
 reference/ModelSIRLogit.html                  |   2 +-
 reference/ModelSIRMixing.html                 |   6 +-
 reference/ModelSIS.html                       |   2 +-
 reference/ModelSISD.html                      |   2 +-
 reference/ModelSURV.html                      |   2 +-
 reference/agents.html                         |   2 +-
 reference/agents_smallworld.html              |   2 +-
 reference/entities.html                       |   6 +-
 reference/epiworld-data.html                  |   2 +-
 reference/epiworld-methods.html               |   2 +-
 reference/epiworldR-deprecated.html           |   2 +-
 reference/epiworldR-package.html              |   2 +-
 reference/figures/README-logit-model-1.png    | Bin 27935 -> 36373 bytes
 .../figures/README-multiple-example-1.png     | Bin 9530 -> 24847 bytes
 .../figures/README-seir-conn-figures-1.png    | Bin 42302 -> 53967 bytes
 .../figures/README-seir-conn-figures-2.png    | Bin 38218 -> 44236 bytes
 .../figures/README-seir-conn-figures-3.png    | Bin 32300 -> 41484 bytes
 reference/figures/README-sir-figures-1.png    | Bin 35901 -> 45470 bytes
 reference/figures/README-sir-figures-2.png    | Bin 45528 -> 55060 bytes
 .../figures/README-transmission-net-1.png     | Bin 35433 -> 81295 bytes
 reference/global-actions.html                 |   2 +-
 reference/index.html                          |   2 +-
 reference/run_multiple.html                   |   2 +-
 reference/tool.html                           |   2 +-
 reference/virus.html                          |   2 +-
 search.json                                   |   2 +-
 50 files changed, 196 insertions(+), 185 deletions(-)

diff --git a/404.html b/404.html
index 1914d187..32b0b3c8 100644
--- a/404.html
+++ b/404.html
@@ -66,7 +66,7 @@ <h1>Page not found (404)</h1>
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/CODE_OF_CONDUCT.html b/CODE_OF_CONDUCT.html
index 82e53737..b5304911 100644
--- a/CODE_OF_CONDUCT.html
+++ b/CODE_OF_CONDUCT.html
@@ -112,7 +112,7 @@ <h2 id="attribution">Attribution<a class="anchor" aria-label="anchor" href="#att
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/LICENSE-text.html b/LICENSE-text.html
index ce3b7a91..4d8c315b 100644
--- a/LICENSE-text.html
+++ b/LICENSE-text.html
@@ -47,7 +47,7 @@ <h1>License</h1>
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/LICENSE.html b/LICENSE.html
index 3581c290..668d2b1c 100644
--- a/LICENSE.html
+++ b/LICENSE.html
@@ -51,7 +51,7 @@ <h1>MIT License</h1>
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/articles/getting-started.html b/articles/getting-started.html
index 44791d69..2e05bcfa 100644
--- a/articles/getting-started.html
+++ b/articles/getting-started.html
@@ -65,7 +65,7 @@ <h4 data-toc-skip class="author">Derek
                         <h4 data-toc-skip class="author">George Vega
 Yon</h4>
             
-            <h4 data-toc-skip class="date">2024-09-20</h4>
+            <h4 data-toc-skip class="date">2024-10-07</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/UofUEpiBio/epiworldR/blob/main/vignettes/getting-started.Rmd" class="external-link"><code>vignettes/getting-started.Rmd</code></a></small>
       <div class="d-none name"><code>getting-started.Rmd</code></div>
@@ -100,12 +100,12 @@ <h3 id="setup-and-running-the-model">Setup and running the model<a class="anchor
 <code class="sourceCode R"><span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://github.com/UofUEpiBio/epiworldR" class="external-link">epiworldR</a></span><span class="op">)</span></span>
 <span><span class="va">model_sir</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/ModelSIRCONN.html">ModelSIRCONN</a></span><span class="op">(</span></span>
 <span>  name              <span class="op">=</span> <span class="st">"COVID-19"</span>,</span>
-<span>  n                 <span class="op">=</span> <span class="fl">50000</span>, </span>
-<span>  prevalence        <span class="op">=</span> <span class="fl">0.0001</span>, </span>
+<span>  n                 <span class="op">=</span> <span class="fl">50000</span>,</span>
+<span>  prevalence        <span class="op">=</span> <span class="fl">0.0001</span>,</span>
 <span>  contact_rate      <span class="op">=</span> <span class="fl">2</span>,</span>
 <span>  transmission_rate <span class="op">=</span> <span class="fl">0.5</span>,</span>
-<span>  recovery_rate     <span class="op">=</span> <span class="fl">1</span><span class="op">/</span><span class="fl">3</span></span>
-<span>  <span class="op">)</span></span>
+<span>  recovery_rate     <span class="op">=</span> <span class="fl">1</span> <span class="op">/</span> <span class="fl">3</span></span>
+<span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># Printing the model</span></span>
 <span><span class="va">model_sir</span></span>
@@ -175,8 +175,8 @@ <h3 id="setup-and-running-the-model">Setup and running the model<a class="anchor
 <span><span class="co">#&gt; Number of entities  : 0</span></span>
 <span><span class="co">#&gt; Days (duration)     : 50 (of 50)</span></span>
 <span><span class="co">#&gt; Number of viruses   : 1</span></span>
-<span><span class="co">#&gt; Last run elapsed t  : 96.00ms</span></span>
-<span><span class="co">#&gt; Last run speed      : 25.78 million agents x day / second</span></span>
+<span><span class="co">#&gt; Last run elapsed t  : 98.00ms</span></span>
+<span><span class="co">#&gt; Last run speed      : 25.45 million agents x day / second</span></span>
 <span><span class="co">#&gt; Rewiring            : off</span></span>
 <span><span class="co">#&gt; </span></span>
 <span><span class="co">#&gt; Global events:</span></span>
@@ -317,7 +317,7 @@ <h3 id="adding-more-virusesviruses">Adding more viruses/viruses<a class="anchor"
 <span><span class="va">flu</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/virus.html">virus</a></span><span class="op">(</span></span>
 <span>  name <span class="op">=</span> <span class="st">"Flu"</span>, prob_infecting <span class="op">=</span> <span class="fl">.3</span>,</span>
 <span>  prevalence <span class="op">=</span> <span class="fl">.0001</span>, as_proportion <span class="op">=</span> <span class="cn">TRUE</span></span>
-<span>  <span class="op">)</span></span>
+<span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># Adding the virus to the model</span></span>
 <span><span class="fu"><a href="../reference/virus.html">add_virus</a></span><span class="op">(</span><span class="va">model_sir</span>, <span class="va">flu</span><span class="op">)</span></span></code></pre></div>
@@ -344,9 +344,9 @@ <h3 id="adding-more-virusesviruses">Adding more viruses/viruses<a class="anchor"
 <div class="sourceCode" id="cb13"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">repnum2</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/epiworld-data.html">get_reproductive_number</a></span><span class="op">(</span><span class="va">model_sir</span><span class="op">)</span></span>
 <span></span>
-<span><span class="va">op</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/graphics/par.html" class="external-link">par</a></span><span class="op">(</span>mfrow <span class="op">=</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">2</span>,<span class="fl">1</span><span class="op">)</span><span class="op">)</span></span>
+<span><span class="va">op</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/graphics/par.html" class="external-link">par</a></span><span class="op">(</span>mfrow <span class="op">=</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">2</span>, <span class="fl">1</span><span class="op">)</span><span class="op">)</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">model_sir</span><span class="op">)</span></span>
-<span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">repnum2</span>, type<span class="op">=</span><span class="st">"b"</span><span class="op">)</span></span></code></pre></div>
+<span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">repnum2</span>, type <span class="op">=</span> <span class="st">"b"</span><span class="op">)</span></span></code></pre></div>
 <p><img src="getting-started_files/figure-html/unnamed-chunk-6-1.png" width="80%" style="display: block; margin: auto;"></p>
 <div class="sourceCode" id="cb14"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/graphics/par.html" class="external-link">par</a></span><span class="op">(</span><span class="va">op</span><span class="op">)</span></span></code></pre></div>
@@ -375,7 +375,7 @@ <h3 id="tools">Tools<a class="anchor" aria-label="anchor" href="#tools"></a>
 <span>  as_proportion <span class="op">=</span> <span class="cn">TRUE</span>,</span>
 <span>  susceptibility_reduction <span class="op">=</span> <span class="fl">.9</span>,</span>
 <span>  transmission_reduction <span class="op">=</span> <span class="fl">.5</span>,</span>
-<span>  recovery_enhancer <span class="op">=</span> <span class="fl">.5</span>, </span>
+<span>  recovery_enhancer <span class="op">=</span> <span class="fl">.5</span>,</span>
 <span>  death_reduction <span class="op">=</span> <span class="fl">.9</span></span>
 <span><span class="op">)</span></span>
 <span></span>
@@ -388,9 +388,9 @@ <h3 id="tools">Tools<a class="anchor" aria-label="anchor" href="#tools"></a>
 <div class="sourceCode" id="cb16"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">repnum3</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/epiworld-data.html">get_reproductive_number</a></span><span class="op">(</span><span class="va">model_sir</span><span class="op">)</span></span>
 <span></span>
-<span><span class="va">op</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/graphics/par.html" class="external-link">par</a></span><span class="op">(</span>mfrow <span class="op">=</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">2</span>,<span class="fl">1</span><span class="op">)</span><span class="op">)</span></span>
+<span><span class="va">op</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/graphics/par.html" class="external-link">par</a></span><span class="op">(</span>mfrow <span class="op">=</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">2</span>, <span class="fl">1</span><span class="op">)</span><span class="op">)</span></span>
 <span><span class="fu"><a href="../reference/epiworld-data.html">plot_incidence</a></span><span class="op">(</span><span class="va">model_sir</span><span class="op">)</span></span>
-<span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">repnum3</span>, type<span class="op">=</span><span class="st">"b"</span><span class="op">)</span></span></code></pre></div>
+<span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">repnum3</span>, type <span class="op">=</span> <span class="st">"b"</span><span class="op">)</span></span></code></pre></div>
 <p><img src="getting-started_files/figure-html/curves-including-vaccine-1.png" width="80%" style="display: block; margin: auto;"></p>
 <div class="sourceCode" id="cb17"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/graphics/par.html" class="external-link">par</a></span><span class="op">(</span><span class="va">op</span><span class="op">)</span></span></code></pre></div>
@@ -403,7 +403,7 @@ <h3 id="tools">Tools<a class="anchor" aria-label="anchor" href="#tools"></a>
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/articles/implementation.html b/articles/implementation.html
index 58ee098c..87249598 100644
--- a/articles/implementation.html
+++ b/articles/implementation.html
@@ -250,7 +250,7 @@ <h3 id="transmission-in-connected-modelsmodels">Transmission in connected models
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/articles/index.html b/articles/index.html
index 20f27728..a75dee0e 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -55,7 +55,7 @@ <h3>All vignettes</h3>
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/articles/mixing.html b/articles/mixing.html
index 1a9df7ec..c9823939 100644
--- a/articles/mixing.html
+++ b/articles/mixing.html
@@ -63,7 +63,7 @@ <h1>Mixing models</h1>
                         <h4 data-toc-skip class="author">George Vega
 Yon</h4>
             
-            <h4 data-toc-skip class="date">2024-09-20</h4>
+            <h4 data-toc-skip class="date">2024-10-07</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/UofUEpiBio/epiworldR/blob/main/vignettes/mixing.Rmd" class="external-link"><code>vignettes/mixing.Rmd</code></a></small>
       <div class="d-none name"><code>mixing.Rmd</code></div>
@@ -134,7 +134,7 @@ <h2 id="an-seir-model-with-mixing">An SEIR model with mixing<a class="anchor" ar
 <span>  contact_matrix    <span class="op">=</span> <span class="va">cmatrix</span></span>
 <span><span class="op">)</span></span>
 <span></span>
-<span><span class="co"># Adding the entities </span></span>
+<span><span class="co"># Adding the entities</span></span>
 <span><span class="va">flu_model</span> <span class="op">|&gt;</span></span>
 <span>  <span class="fu"><a href="../reference/entities.html">add_entity</a></span><span class="op">(</span><span class="va">e1</span><span class="op">)</span> <span class="op">|&gt;</span></span>
 <span>  <span class="fu"><a href="../reference/entities.html">add_entity</a></span><span class="op">(</span><span class="va">e2</span><span class="op">)</span> <span class="op">|&gt;</span></span>
@@ -163,7 +163,7 @@ <h2 id="an-seir-model-with-mixing">An SEIR model with mixing<a class="anchor" ar
 <span><span class="co">#&gt; Days (duration)     : 100 (of 100)</span></span>
 <span><span class="co">#&gt; Number of viruses   : 1</span></span>
 <span><span class="co">#&gt; Last run elapsed t  : 126.00ms</span></span>
-<span><span class="co">#&gt; Last run speed      : 7.12 million agents x day / second</span></span>
+<span><span class="co">#&gt; Last run speed      : 7.11 million agents x day / second</span></span>
 <span><span class="co">#&gt; Rewiring            : off</span></span>
 <span><span class="co">#&gt; </span></span>
 <span><span class="co">#&gt; Global events:</span></span>
@@ -282,7 +282,7 @@ <h2 id="investigating-the-history">Investigating the history<a class="anchor" ar
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/articles/run-multiple.html b/articles/run-multiple.html
index 324bfedb..fab3d365 100644
--- a/articles/run-multiple.html
+++ b/articles/run-multiple.html
@@ -65,7 +65,7 @@ <h4 data-toc-skip class="author">Derek
                         <h4 data-toc-skip class="author">George Vega
 Yon</h4>
             
-            <h4 data-toc-skip class="date">2024-09-20</h4>
+            <h4 data-toc-skip class="date">2024-10-07</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/UofUEpiBio/epiworldR/blob/main/vignettes/run-multiple.Rmd" class="external-link"><code>vignettes/run-multiple.Rmd</code></a></small>
       <div class="d-none name"><code>run-multiple.Rmd</code></div>
@@ -97,13 +97,13 @@ <h3 id="setup-and-running-model">Setup and Running Model<a class="anchor" aria-l
 <code class="sourceCode R"><span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://github.com/UofUEpiBio/epiworldR" class="external-link">epiworldR</a></span><span class="op">)</span></span>
 <span><span class="va">model_seirconn</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/ModelSEIRCONN.html">ModelSEIRCONN</a></span><span class="op">(</span></span>
 <span>  name              <span class="op">=</span> <span class="st">"COVID-19"</span>,</span>
-<span>  n                 <span class="op">=</span> <span class="fl">10000</span>, </span>
-<span>  prevalence        <span class="op">=</span> <span class="fl">0.0001</span>, </span>
+<span>  n                 <span class="op">=</span> <span class="fl">10000</span>,</span>
+<span>  prevalence        <span class="op">=</span> <span class="fl">0.0001</span>,</span>
 <span>  contact_rate      <span class="op">=</span> <span class="fl">2</span>,</span>
 <span>  transmission_rate <span class="op">=</span> <span class="fl">0.5</span>,</span>
 <span>  incubation_days   <span class="op">=</span> <span class="fl">7</span>,</span>
-<span>  recovery_rate     <span class="op">=</span> <span class="fl">1</span><span class="op">/</span><span class="fl">3</span></span>
-<span>  <span class="op">)</span></span></code></pre></div>
+<span>  recovery_rate     <span class="op">=</span> <span class="fl">1</span> <span class="op">/</span> <span class="fl">3</span></span>
+<span><span class="op">)</span></span></code></pre></div>
 </div>
 <div class="section level3">
 <h3 id="generating-a-saver">Generating a Saver<a class="anchor" aria-label="anchor" href="#generating-a-saver"></a>
@@ -157,7 +157,7 @@ <h3 id="plotting">Plotting<a class="anchor" aria-label="anchor" href="#plotting"
 values from each of the 50 simulations for each date.</p>
 <div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">seirconn_50</span> <span class="op">&lt;-</span> <span class="fu"><a href="../reference/run_multiple.html">run_multiple_get_results</a></span><span class="op">(</span><span class="va">model_seirconn</span><span class="op">)</span><span class="op">$</span><span class="va">total_hist</span></span>
-<span><span class="va">seirconn_50</span> <span class="op">&lt;-</span> <span class="va">seirconn_50</span><span class="op">[</span><span class="va">seirconn_50</span><span class="op">$</span><span class="va">date</span> <span class="op">&lt;=</span> <span class="fl">20</span>,<span class="op">]</span></span>
+<span><span class="va">seirconn_50</span> <span class="op">&lt;-</span> <span class="va">seirconn_50</span><span class="op">[</span><span class="va">seirconn_50</span><span class="op">$</span><span class="va">date</span> <span class="op">&lt;=</span> <span class="fl">20</span>, <span class="op">]</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">seirconn_50</span><span class="op">)</span></span></code></pre></div>
 <p><img src="run-multiple_files/figure-html/plotting%20seirconn%20epicurves-1.png" width="80%" style="display: block; margin: auto;"></p>
 <p>To view the a plot of the reproductive number over all 50 days for
@@ -187,7 +187,7 @@ <h3 id="plotting">Plotting<a class="anchor" aria-label="anchor" href="#plotting"
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/authors.html b/authors.html
index 7fb1708b..7cf190dc 100644
--- a/authors.html
+++ b/authors.html
@@ -42,11 +42,11 @@ <h1>Authors and Citation</h1>
       <h2>Authors</h2>
 
       <ul class="list-unstyled"><li>
-          <p><strong>Derek Meyer</strong>. Author, maintainer. <a href="https://orcid.org/0009-0005-1350-6988" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a>
+          <p><strong>George Vega Yon</strong>. Author, maintainer. <a href="https://orcid.org/0000-0002-3171-0844" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a>
           </p>
         </li>
         <li>
-          <p><strong>George Vega Yon</strong>. Author. <a href="https://orcid.org/0000-0002-3171-0844" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a>
+          <p><strong>Derek Meyer</strong>. Author. <a href="https://orcid.org/0009-0005-1350-6988" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a>
           </p>
         </li>
         <li>
@@ -101,7 +101,7 @@ <h2 id="citation">Citation</h2>
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/index.html b/index.html
index 68689d82..3b00da41 100644
--- a/index.html
+++ b/index.html
@@ -118,16 +118,17 @@ <h2 id="sir-model-using-a-random-graph">SIR model using a random graph<a class="
 <span>  prevalence        <span class="op">=</span> <span class="fl">.01</span>,</span>
 <span>  transmission_rate <span class="op">=</span> <span class="fl">.7</span>,</span>
 <span>  recovery          <span class="op">=</span> <span class="fl">.3</span></span>
-<span>  <span class="op">)</span> <span class="op">|&gt;</span></span>
-<span>  <span class="co"># Adding a Small world population </span></span>
+<span><span class="op">)</span> <span class="op">|&gt;</span></span>
+<span>  <span class="co"># Adding a Small world population</span></span>
 <span>  <span class="fu"><a href="reference/agents_smallworld.html">agents_smallworld</a></span><span class="op">(</span>n <span class="op">=</span> <span class="fl">100000</span>, k <span class="op">=</span> <span class="fl">10</span>, d <span class="op">=</span> <span class="cn">FALSE</span>, p <span class="op">=</span> <span class="fl">.01</span><span class="op">)</span> <span class="op">|&gt;</span></span>
 <span>  <span class="co"># Running the model for 50 days</span></span>
 <span>  <span class="fu"><a href="reference/epiworld-methods.html">run</a></span><span class="op">(</span>ndays <span class="op">=</span> <span class="fl">50</span>, seed <span class="op">=</span> <span class="fl">1912</span><span class="op">)</span></span>
 <span><span class="co">#&gt; _________________________________________________________________________</span></span>
 <span><span class="co">#&gt; |Running the model...</span></span>
 <span><span class="co">#&gt; |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done.</span></span>
-<span><span class="co">#&gt; | done.</span></span>
-<span></span>
+<span><span class="co">#&gt; | done.</span></span></code></pre></div>
+<div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span></span>
 <span><span class="va">sir</span></span>
 <span><span class="co">#&gt; ________________________________________________________________________________</span></span>
 <span><span class="co">#&gt; Susceptible-Infected-Recovered (SIR)</span></span>
@@ -135,47 +136,48 @@ <h2 id="sir-model-using-a-random-graph">SIR model using a random graph<a class="
 <span><span class="co">#&gt; The model has 3 states.</span></span>
 <span><span class="co">#&gt; The final distribution is: 822 Susceptible, 415 Infected, and 98763 Recovered.</span></span></code></pre></div>
 <p>Visualizing the outputs</p>
-<div class="sourceCode" id="cb4"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb5"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><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">sir</span><span class="op">)</span></span>
 <span><span class="co">#&gt; ________________________________________________________________________________</span></span>
 <span><span class="co">#&gt; ________________________________________________________________________________</span></span>
 <span><span class="co">#&gt; SIMULATION STUDY</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Name of the model   : Susceptible-Infected-Recovered (SIR)</span></span>
 <span><span class="co">#&gt; Population size     : 100000</span></span>
 <span><span class="co">#&gt; Agents' data        : (none)</span></span>
 <span><span class="co">#&gt; Number of entities  : 0</span></span>
 <span><span class="co">#&gt; Days (duration)     : 50 (of 50)</span></span>
 <span><span class="co">#&gt; Number of viruses   : 1</span></span>
-<span><span class="co">#&gt; Last run elapsed t  : 134.00ms</span></span>
-<span><span class="co">#&gt; Last run speed      : 37.07 million agents x day / second</span></span>
+<span><span class="co">#&gt; Last run elapsed t  : 62.00ms</span></span>
+<span><span class="co">#&gt; Last run speed      : 79.47 million agents x day / second</span></span>
 <span><span class="co">#&gt; Rewiring            : off</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Global events:</span></span>
 <span><span class="co">#&gt;  (none)</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Virus(es):</span></span>
 <span><span class="co">#&gt;  - COVID-19</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Tool(s):</span></span>
 <span><span class="co">#&gt;  (none)</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Model parameters:</span></span>
 <span><span class="co">#&gt;  - Recovery rate     : 0.3000</span></span>
 <span><span class="co">#&gt;  - Transmission rate : 0.7000</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Distribution of the population at time 50:</span></span>
 <span><span class="co">#&gt;   - (0) Susceptible :  99000 -&gt; 822</span></span>
 <span><span class="co">#&gt;   - (1) Infected    :   1000 -&gt; 415</span></span>
 <span><span class="co">#&gt;   - (2) Recovered   :      0 -&gt; 98763</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Transition Probabilities:</span></span>
 <span><span class="co">#&gt;  - Susceptible  0.91  0.09  0.00</span></span>
 <span><span class="co">#&gt;  - Infected     0.00  0.70  0.30</span></span>
-<span><span class="co">#&gt;  - Recovered    0.00  0.00  1.00</span></span>
-<span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">sir</span><span class="op">)</span></span></code></pre></div>
+<span><span class="co">#&gt;  - Recovered    0.00  0.00  1.00</span></span></code></pre></div>
+<div class="sourceCode" id="cb6"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">sir</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-sir-figures-1.png" width="100%"></p>
-<div class="sourceCode" id="cb5"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb7"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu"><a href="reference/epiworld-data.html">plot_incidence</a></span><span class="op">(</span><span class="va">sir</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-sir-figures-2.png" width="100%"></p>
 </div>
@@ -183,107 +185,109 @@ <h2 id="sir-model-using-a-random-graph">SIR model using a random graph<a class="
 <h2 id="seir-model-with-a-fully-connected-graph">SEIR model with a fully connected graph<a class="anchor" aria-label="anchor" href="#seir-model-with-a-fully-connected-graph"></a>
 </h2>
 <p>The SEIR model is similar to the SIR model but includes an exposed state. Here, we simulate a population of 10,000 agents with a 0.01 prevalence, a 0.6 transmission rate, a 0.5 recovery rate, and 7 days-incubation period. The population is fully connected, meaning agents can transmit the disease to any other agent:</p>
-<div class="sourceCode" id="cb6"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb8"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">model_seirconn</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/ModelSEIRCONN.html">ModelSEIRCONN</a></span><span class="op">(</span></span>
 <span>  name                <span class="op">=</span> <span class="st">"COVID-19"</span>,</span>
-<span>  prevalence          <span class="op">=</span> <span class="fl">0.01</span>, </span>
+<span>  prevalence          <span class="op">=</span> <span class="fl">0.01</span>,</span>
 <span>  n                   <span class="op">=</span> <span class="fl">10000</span>,</span>
-<span>  contact_rate        <span class="op">=</span> <span class="fl">10</span>, </span>
-<span>  incubation_days     <span class="op">=</span> <span class="fl">7</span>, </span>
+<span>  contact_rate        <span class="op">=</span> <span class="fl">10</span>,</span>
+<span>  incubation_days     <span class="op">=</span> <span class="fl">7</span>,</span>
 <span>  transmission_rate   <span class="op">=</span> <span class="fl">0.1</span>,</span>
-<span>  recovery_rate       <span class="op">=</span> <span class="fl">1</span><span class="op">/</span><span class="fl">7</span></span>
+<span>  recovery_rate       <span class="op">=</span> <span class="fl">1</span> <span class="op">/</span> <span class="fl">7</span></span>
 <span><span class="op">)</span> <span class="op">|&gt;</span> <span class="fu"><a href="reference/virus.html">add_virus</a></span><span class="op">(</span></span>
-<span>    <span class="fu"><a href="reference/virus.html">virus</a></span><span class="op">(</span></span>
-<span>      name <span class="op">=</span> <span class="st">"COVID-19"</span>,</span>
-<span>      prevalence <span class="op">=</span> <span class="fl">0.01</span>,</span>
-<span>      as_proportion <span class="op">=</span> <span class="cn">TRUE</span>,</span>
-<span>      prob_infecting <span class="op">=</span> <span class="fl">0.01</span>,</span>
-<span>      recovery_rate <span class="op">=</span> <span class="fl">0.6</span>,</span>
-<span>      prob_death <span class="op">=</span> <span class="fl">0.5</span>,</span>
-<span>      incubation <span class="op">=</span> <span class="fl">7</span></span>
-<span>    <span class="op">)</span><span class="op">)</span></span>
+<span>  <span class="fu"><a href="reference/virus.html">virus</a></span><span class="op">(</span></span>
+<span>    name <span class="op">=</span> <span class="st">"COVID-19"</span>,</span>
+<span>    prevalence <span class="op">=</span> <span class="fl">0.01</span>,</span>
+<span>    as_proportion <span class="op">=</span> <span class="cn">TRUE</span>,</span>
+<span>    prob_infecting <span class="op">=</span> <span class="fl">0.01</span>,</span>
+<span>    recovery_rate <span class="op">=</span> <span class="fl">0.6</span>,</span>
+<span>    prob_death <span class="op">=</span> <span class="fl">0.5</span>,</span>
+<span>    incubation <span class="op">=</span> <span class="fl">7</span></span>
+<span><span class="op">)</span><span class="op">)</span></span>
 <span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/Random.html" class="external-link">set.seed</a></span><span class="op">(</span><span class="fl">132</span><span class="op">)</span></span>
 <span><span class="fu"><a href="reference/epiworld-methods.html">run</a></span><span class="op">(</span><span class="va">model_seirconn</span>, ndays <span class="op">=</span> <span class="fl">100</span><span class="op">)</span></span>
 <span><span class="co">#&gt; _________________________________________________________________________</span></span>
 <span><span class="co">#&gt; Running the model...</span></span>
 <span><span class="co">#&gt; ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done.</span></span>
-<span><span class="co">#&gt;  done.</span></span>
-<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">model_seirconn</span><span class="op">)</span></span>
+<span><span class="co">#&gt;  done.</span></span></code></pre></div>
+<div class="sourceCode" id="cb9"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><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">model_seirconn</span><span class="op">)</span></span>
 <span><span class="co">#&gt; ________________________________________________________________________________</span></span>
 <span><span class="co">#&gt; ________________________________________________________________________________</span></span>
 <span><span class="co">#&gt; SIMULATION STUDY</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Name of the model   : Susceptible-Exposed-Infected-Removed (SEIR) (connected)</span></span>
 <span><span class="co">#&gt; Population size     : 10000</span></span>
 <span><span class="co">#&gt; Agents' data        : (none)</span></span>
 <span><span class="co">#&gt; Number of entities  : 0</span></span>
 <span><span class="co">#&gt; Days (duration)     : 100 (of 100)</span></span>
 <span><span class="co">#&gt; Number of viruses   : 2</span></span>
-<span><span class="co">#&gt; Last run elapsed t  : 81.00ms</span></span>
-<span><span class="co">#&gt; Last run speed      : 12.21 million agents x day / second</span></span>
+<span><span class="co">#&gt; Last run elapsed t  : 15.00ms</span></span>
+<span><span class="co">#&gt; Last run speed      : 64.01 million agents x day / second</span></span>
 <span><span class="co">#&gt; Rewiring            : off</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Global events:</span></span>
 <span><span class="co">#&gt;  - Update infected individuals (runs daily)</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Virus(es):</span></span>
 <span><span class="co">#&gt;  - COVID-19</span></span>
 <span><span class="co">#&gt;  - COVID-19</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Tool(s):</span></span>
 <span><span class="co">#&gt;  (none)</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Model parameters:</span></span>
 <span><span class="co">#&gt;  - Avg. Incubation days : 7.0000</span></span>
 <span><span class="co">#&gt;  - Contact rate         : 10.0000</span></span>
 <span><span class="co">#&gt;  - Prob. Recovery       : 0.1429</span></span>
 <span><span class="co">#&gt;  - Prob. Transmission   : 0.1000</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Distribution of the population at time 100:</span></span>
-<span><span class="co">#&gt;   - (0) Susceptible :  9800 -&gt; 13</span></span>
+<span><span class="co">#&gt;   - (0) Susceptible :  9800 -&gt; 11</span></span>
 <span><span class="co">#&gt;   - (1) Exposed     :   200 -&gt; 0</span></span>
-<span><span class="co">#&gt;   - (2) Infected    :     0 -&gt; 1</span></span>
+<span><span class="co">#&gt;   - (2) Infected    :     0 -&gt; 3</span></span>
 <span><span class="co">#&gt;   - (3) Recovered   :     0 -&gt; 9986</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; Transition Probabilities:</span></span>
 <span><span class="co">#&gt;  - Susceptible  0.94  0.06  0.00  0.00</span></span>
-<span><span class="co">#&gt;  - Exposed      0.00  0.86  0.14  0.00</span></span>
-<span><span class="co">#&gt;  - Infected     0.00  0.00  0.85  0.15</span></span>
+<span><span class="co">#&gt;  - Exposed      0.00  0.85  0.15  0.00</span></span>
+<span><span class="co">#&gt;  - Infected     0.00  0.00  0.86  0.14</span></span>
 <span><span class="co">#&gt;  - Recovered    0.00  0.00  0.00  1.00</span></span></code></pre></div>
 <p>Computing some key statistics</p>
-<div class="sourceCode" id="cb7"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb10"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">model_seirconn</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-seir-conn-figures-1.png" width="100%"></p>
-<div class="sourceCode" id="cb8"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb11"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span></span>
 <span><span class="va">repnum</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/epiworld-data.html">get_reproductive_number</a></span><span class="op">(</span><span class="va">model_seirconn</span><span class="op">)</span></span>
 <span></span>
 <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="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">repnum</span><span class="op">)</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-seir-conn-figures-2.png" width="100%"></p>
-<div class="sourceCode" id="cb9"><pre class="sourceCode R"><code class="sourceCode r"><span id="cb9-1"><a href="#cb9-1" tabindex="-1"></a><span class="co">#&gt;   virus_id    virus date      avg  n       sd  lb   ub</span></span>
-<span id="cb9-2"><a href="#cb9-2" tabindex="-1"></a><span class="co">#&gt; 1        0 COVID-19    0 5.615385 91 4.832228 1.0 17.0</span></span>
-<span id="cb9-3"><a href="#cb9-3" tabindex="-1"></a><span class="co">#&gt; 2        0 COVID-19    2 5.000000  9 3.605551 0.2 10.4</span></span>
-<span id="cb9-4"><a href="#cb9-4" tabindex="-1"></a><span class="co">#&gt; 3        0 COVID-19    3 6.000000 13 5.049752 0.0 13.0</span></span>
-<span id="cb9-5"><a href="#cb9-5" tabindex="-1"></a><span class="co">#&gt; 4        0 COVID-19    4 4.592593 27 3.885469 0.0 12.7</span></span>
-<span id="cb9-6"><a href="#cb9-6" tabindex="-1"></a><span class="co">#&gt; 5        0 COVID-19    5 4.846154 26 4.920913 0.0 14.5</span></span>
-<span id="cb9-7"><a href="#cb9-7" tabindex="-1"></a><span class="co">#&gt; 6        0 COVID-19    6 4.236842 38 3.241906 0.0 12.0</span></span>
-<span id="cb9-8"><a href="#cb9-8" tabindex="-1"></a></span>
-<span id="cb9-9"><a href="#cb9-9" tabindex="-1"></a><span class="fu">head</span>(<span class="fu">plot_generation_time</span>(model_seirconn))</span></code></pre></div>
+<div class="sourceCode" id="cb12"><pre class="sourceCode R"><code class="sourceCode r"><span id="cb12-1"><a href="#cb12-1" tabindex="-1"></a><span class="co">#&gt;   virus_id    virus date      avg  n       sd    lb     ub</span></span>
+<span id="cb12-2"><a href="#cb12-2" tabindex="-1"></a><span class="co">#&gt; 1        0 COVID-19    0 5.769231 91 5.455022 1.000 20.750</span></span>
+<span id="cb12-3"><a href="#cb12-3" tabindex="-1"></a><span class="co">#&gt; 2        0 COVID-19    2 6.400000 10 4.880801 0.450 14.875</span></span>
+<span id="cb12-4"><a href="#cb12-4" tabindex="-1"></a><span class="co">#&gt; 3        0 COVID-19    3 5.166667 18 4.422536 0.425 13.000</span></span>
+<span id="cb12-5"><a href="#cb12-5" tabindex="-1"></a><span class="co">#&gt; 4        0 COVID-19    4 4.659091 44 3.784566 0.000 12.850</span></span>
+<span id="cb12-6"><a href="#cb12-6" tabindex="-1"></a><span class="co">#&gt; 5        0 COVID-19    5 5.205882 34 3.273210 0.000 12.175</span></span>
+<span id="cb12-7"><a href="#cb12-7" tabindex="-1"></a><span class="co">#&gt; 6        0 COVID-19    6 3.137255 51 2.713077 0.000  8.750</span></span></code></pre></div>
+<div class="sourceCode" id="cb13"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span></span>
+<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="fu"><a href="reference/epiworld-data.html">plot_generation_time</a></span><span class="op">(</span><span class="va">model_seirconn</span><span class="op">)</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-seir-conn-figures-3.png" width="100%"></p>
-<div class="sourceCode" id="cb10"><pre class="sourceCode R"><code class="sourceCode r"><span id="cb10-1"><a href="#cb10-1" tabindex="-1"></a><span class="co">#&gt;   date      avg  n       sd ci_lower ci_upper    virus virus_id</span></span>
-<span id="cb10-2"><a href="#cb10-2" tabindex="-1"></a><span class="co">#&gt; 1    2 7.125000  8 2.474874      2.7    9.825 COVID-19        0</span></span>
-<span id="cb10-3"><a href="#cb10-3" tabindex="-1"></a><span class="co">#&gt; 2    3 8.090909 11 7.203534      2.0   23.750 COVID-19        0</span></span>
-<span id="cb10-4"><a href="#cb10-4" tabindex="-1"></a><span class="co">#&gt; 3    4 6.708333 24 4.338695      2.0   16.425 COVID-19        0</span></span>
-<span id="cb10-5"><a href="#cb10-5" tabindex="-1"></a><span class="co">#&gt; 4    5 7.428571 21 4.738897      2.0   15.500 COVID-19        0</span></span>
-<span id="cb10-6"><a href="#cb10-6" tabindex="-1"></a><span class="co">#&gt; 5    6 7.628571 35 4.173345      2.0   15.300 COVID-19        0</span></span>
-<span id="cb10-7"><a href="#cb10-7" tabindex="-1"></a><span class="co">#&gt; 6    7 6.921053 38 4.675304      2.0   16.150 COVID-19        0</span></span></code></pre></div>
+<div class="sourceCode" id="cb14"><pre class="sourceCode R"><code class="sourceCode r"><span id="cb14-1"><a href="#cb14-1" tabindex="-1"></a><span class="co">#&gt;   date      avg  n       sd ci_lower ci_upper    virus virus_id</span></span>
+<span id="cb14-2"><a href="#cb14-2" tabindex="-1"></a><span class="co">#&gt; 1    2 4.444444  9 2.185813      2.2    8.000 COVID-19        0</span></span>
+<span id="cb14-3"><a href="#cb14-3" tabindex="-1"></a><span class="co">#&gt; 2    3 7.411765 17 3.922034      2.4   15.000 COVID-19        0</span></span>
+<span id="cb14-4"><a href="#cb14-4" tabindex="-1"></a><span class="co">#&gt; 3    4 8.538462 39 7.100208      2.0   22.000 COVID-19        0</span></span>
+<span id="cb14-5"><a href="#cb14-5" tabindex="-1"></a><span class="co">#&gt; 4    5 6.312500 32 3.905641      2.0   13.225 COVID-19        0</span></span>
+<span id="cb14-6"><a href="#cb14-6" tabindex="-1"></a><span class="co">#&gt; 5    6 7.200000 40 4.052223      2.0   15.100 COVID-19        0</span></span>
+<span id="cb14-7"><a href="#cb14-7" tabindex="-1"></a><span class="co">#&gt; 6    7 7.660000 50 4.461216      2.0   17.000 COVID-19        0</span></span></code></pre></div>
 </div>
 <div class="section level2">
 <h2 id="sir-logit">SIR Logit<a class="anchor" aria-label="anchor" href="#sir-logit"></a>
 </h2>
 <p>This model provides a more complex transmission and recovery pattern based on agents’ features. With it, we can reflect co-morbidities that could change the probability of infection and recovery. Here, we simulate a population including a dataset with two features: an intercept and a binary variable <code>Female</code>. The probability of infection and recovery are functions of the intercept and the <code>Female</code> variables. The following code simulates a population of 100,000 agents in a small-world network. Each agent is connected to eight other agents. One percent of the population has the virus, with an 80% chance of transmission. Infected individuals recover at a 0.3 rate:</p>
-<div class="sourceCode" id="cb11"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb15"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="co"># Simulating a population of 100,000 agents</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/base/Random.html" class="external-link">set.seed</a></span><span class="op">(</span><span class="fl">2223</span><span class="op">)</span></span>
 <span><span class="va">n</span> <span class="op">&lt;-</span> <span class="fl">100000</span></span>
@@ -292,7 +296,7 @@ <h2 id="sir-logit">SIR Logit<a class="anchor" aria-label="anchor" href="#sir-log
 <span><span class="va">X</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/cbind.html" class="external-link">cbind</a></span><span class="op">(</span></span>
 <span>  Intercept <span class="op">=</span> <span class="fl">1</span>,</span>
 <span>  Female    <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/sample.html" class="external-link">sample.int</a></span><span class="op">(</span><span class="fl">2</span>, <span class="va">n</span>, replace <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span> <span class="op">-</span> <span class="fl">1</span></span>
-<span>  <span class="op">)</span></span>
+<span><span class="op">)</span></span>
 <span></span>
 <span><span class="va">coef_infect</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="op">-</span><span class="fl">2</span>, <span class="fl">2</span><span class="op">)</span></span>
 <span><span class="va">coef_recover</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/stats/Normal.html" class="external-link">rnorm</a></span><span class="op">(</span><span class="fl">2</span><span class="op">)</span></span>
@@ -302,7 +306,7 @@ <h2 id="sir-logit">SIR Logit<a class="anchor" aria-label="anchor" href="#sir-log
 <span>  <span class="st">"covid2"</span>,</span>
 <span>  data <span class="op">=</span> <span class="va">X</span>,</span>
 <span>  coefs_infect      <span class="op">=</span> <span class="va">coef_infect</span>,</span>
-<span>  coefs_recover     <span class="op">=</span> <span class="va">coef_recover</span>, </span>
+<span>  coefs_recover     <span class="op">=</span> <span class="va">coef_recover</span>,</span>
 <span>  coef_infect_cols  <span class="op">=</span> <span class="fl">1L</span><span class="op">:</span><span class="fu"><a href="https://rdrr.io/r/base/nrow.html" class="external-link">ncol</a></span><span class="op">(</span><span class="va">X</span><span class="op">)</span>,</span>
 <span>  coef_recover_cols <span class="op">=</span> <span class="fl">1L</span><span class="op">:</span><span class="fu"><a href="https://rdrr.io/r/base/nrow.html" class="external-link">ncol</a></span><span class="op">(</span><span class="va">X</span><span class="op">)</span>,</span>
 <span>  prob_infection <span class="op">=</span> <span class="fl">.8</span>,</span>
@@ -318,10 +322,11 @@ <h2 id="sir-logit">SIR Logit<a class="anchor" aria-label="anchor" href="#sir-log
 <span><span class="co">#&gt; _________________________________________________________________________</span></span>
 <span><span class="co">#&gt; |Running the model...</span></span>
 <span><span class="co">#&gt; |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done.</span></span>
-<span><span class="co">#&gt; | done.</span></span>
-<span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">model_logit</span><span class="op">)</span></span></code></pre></div>
+<span><span class="co">#&gt; | done.</span></span></code></pre></div>
+<div class="sourceCode" id="cb16"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">model_logit</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-logit-model-1.png" width="100%"></p>
-<div class="sourceCode" id="cb12"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb17"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span></span>
 <span><span class="co"># Females are supposed to be more likely to become infected</span></span>
 <span><span class="va">rn</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/epiworld-data.html">get_reproductive_number</a></span><span class="op">(</span><span class="va">model_logit</span><span class="op">)</span></span>
@@ -329,10 +334,11 @@ <h2 id="sir-logit">SIR Logit<a class="anchor" aria-label="anchor" href="#sir-log
 <span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/table.html" class="external-link">table</a></span><span class="op">(</span></span>
 <span>  <span class="va">X</span><span class="op">[</span>, <span class="st">"Female"</span><span class="op">]</span>,</span>
 <span>  <span class="op">(</span><span class="fl">1</span><span class="op">:</span><span class="va">n</span> <span class="op"><a href="https://rdrr.io/r/base/match.html" class="external-link">%in%</a></span> <span class="va">rn</span><span class="op">$</span><span class="va">source</span><span class="op">)</span></span>
-<span><span class="op">)</span> <span class="op">|&gt;</span> <span class="fu"><a href="https://rdrr.io/r/base/proportions.html" class="external-link">prop.table</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span><span class="op">[</span>,<span class="fl">2</span><span class="op">]</span></span>
-<span><span class="co">#&gt;       0       1 </span></span>
-<span><span class="co">#&gt; 0.12984 0.14201</span></span>
-<span></span>
+<span><span class="op">)</span> <span class="op">|&gt;</span> <span class="fu"><a href="https://rdrr.io/r/base/proportions.html" class="external-link">prop.table</a></span><span class="op">(</span><span class="op">)</span><span class="op">)</span><span class="op">[</span>, <span class="fl">2</span><span class="op">]</span></span>
+<span><span class="co">#&gt;       0       1</span></span>
+<span><span class="co">#&gt; 0.12984 0.14201</span></span></code></pre></div>
+<div class="sourceCode" id="cb18"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span></span>
 <span><span class="co"># Looking into the agents</span></span>
 <span><span class="fu"><a href="reference/agents.html">get_agents</a></span><span class="op">(</span><span class="va">model_logit</span><span class="op">)</span></span>
 <span><span class="co">#&gt; Agents from the model "Susceptible-Infected-Removed (SIR) (logit)":</span></span>
@@ -352,49 +358,51 @@ <h2 id="sir-logit">SIR Logit<a class="anchor" aria-label="anchor" href="#sir-log
 <h2 id="transmission-network">Transmission network<a class="anchor" aria-label="anchor" href="#transmission-network"></a>
 </h2>
 <p>This example shows how we can draw a transmission network from a simulation. The following code simulates a population of 500 agents in a small-world network. Each agent is connected to ten other agents. One percent of the population has the virus, with a 50% chance of transmission. Infected individuals recover at a 0.5 rate:</p>
-<div class="sourceCode" id="cb13"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb19"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="co"># Creating a SIR model</span></span>
 <span><span class="va">sir</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/ModelSIR.html">ModelSIR</a></span><span class="op">(</span></span>
 <span>  name           <span class="op">=</span> <span class="st">"COVID-19"</span>,</span>
 <span>  prevalence     <span class="op">=</span> <span class="fl">.01</span>,</span>
 <span>  transmission_rate <span class="op">=</span> <span class="fl">.5</span>,</span>
 <span>  recovery       <span class="op">=</span> <span class="fl">.5</span></span>
-<span>  <span class="op">)</span> <span class="op">|&gt;</span></span>
-<span>    <span class="co"># Adding a Small world population </span></span>
-<span>    <span class="fu"><a href="reference/agents_smallworld.html">agents_smallworld</a></span><span class="op">(</span>n <span class="op">=</span> <span class="fl">500</span>, k <span class="op">=</span> <span class="fl">10</span>, d <span class="op">=</span> <span class="cn">FALSE</span>, p <span class="op">=</span> <span class="fl">.01</span><span class="op">)</span> <span class="op">|&gt;</span></span>
-<span>    <span class="co"># Running the model for 50 days</span></span>
-<span>    <span class="fu"><a href="reference/epiworld-methods.html">run</a></span><span class="op">(</span>ndays <span class="op">=</span> <span class="fl">50</span>, seed <span class="op">=</span> <span class="fl">1912</span><span class="op">)</span></span>
+<span><span class="op">)</span> <span class="op">|&gt;</span></span>
+<span>  <span class="co"># Adding a Small world population</span></span>
+<span>  <span class="fu"><a href="reference/agents_smallworld.html">agents_smallworld</a></span><span class="op">(</span>n <span class="op">=</span> <span class="fl">500</span>, k <span class="op">=</span> <span class="fl">10</span>, d <span class="op">=</span> <span class="cn">FALSE</span>, p <span class="op">=</span> <span class="fl">.01</span><span class="op">)</span> <span class="op">|&gt;</span></span>
+<span>  <span class="co"># Running the model for 50 days</span></span>
+<span>  <span class="fu"><a href="reference/epiworld-methods.html">run</a></span><span class="op">(</span>ndays <span class="op">=</span> <span class="fl">50</span>, seed <span class="op">=</span> <span class="fl">1912</span><span class="op">)</span></span>
 <span><span class="co">#&gt; _________________________________________________________________________</span></span>
 <span><span class="co">#&gt; |Running the model...</span></span>
 <span><span class="co">#&gt; |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done.</span></span>
-<span><span class="co">#&gt; | done.</span></span>
-<span></span>
+<span><span class="co">#&gt; | done.</span></span></code></pre></div>
+<div class="sourceCode" id="cb20"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span></span>
 <span><span class="co"># Transmission network</span></span>
 <span><span class="va">net</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/epiworld-data.html">get_transmissions</a></span><span class="op">(</span><span class="va">sir</span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># Plotting</span></span>
 <span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://github.com/UofUEpiBio/epiworldR" class="external-link">epiworldR</a></span><span class="op">)</span></span>
 <span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">library</a></span><span class="op">(</span><span class="va"><a href="https://github.com/USCCANA/netplot" class="external-link">netplot</a></span><span class="op">)</span></span>
-<span><span class="co">#&gt; Loading required package: grid</span></span>
-<span><span class="va">x</span> <span class="op">&lt;-</span> <span class="fu">igraph</span><span class="fu">::</span><span class="fu"><a href="https://r.igraph.org/reference/graph_from_edgelist.html" class="external-link">graph_from_edgelist</a></span><span class="op">(</span></span>
-<span>  <span class="fu"><a href="https://rdrr.io/r/base/matrix.html" class="external-link">as.matrix</a></span><span class="op">(</span><span class="va">net</span><span class="op">[</span>,<span class="fl">2</span><span class="op">:</span><span class="fl">3</span><span class="op">]</span><span class="op">)</span> <span class="op">+</span> <span class="fl">1</span></span>
-<span>  <span class="op">)</span></span>
+<span><span class="co">#&gt; Loading required package: grid</span></span></code></pre></div>
+<div class="sourceCode" id="cb21"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span><span class="va">x</span> <span class="op">&lt;-</span> <span class="fu">igraph</span><span class="fu">::</span><span class="fu"><a href="https://r.igraph.org/reference/graph_from_edgelist.html" class="external-link">graph_from_edgelist</a></span><span class="op">(</span></span>
+<span>  <span class="fu"><a href="https://rdrr.io/r/base/matrix.html" class="external-link">as.matrix</a></span><span class="op">(</span><span class="va">net</span><span class="op">[</span>, <span class="fl">2</span><span class="op">:</span><span class="fl">3</span><span class="op">]</span><span class="op">)</span> <span class="op">+</span> <span class="fl">1</span></span>
+<span><span class="op">)</span></span>
 <span></span>
-<span><span class="fu"><a href="https://rdrr.io/pkg/netplot/man/nplot.html" class="external-link">nplot</a></span><span class="op">(</span><span class="va">x</span>, edge.curvature <span class="op">=</span> <span class="fl">0</span>, edge.color <span class="op">=</span> <span class="st">"gray"</span>, skip.vertex<span class="op">=</span><span class="cn">TRUE</span><span class="op">)</span></span></code></pre></div>
+<span><span class="fu"><a href="https://rdrr.io/pkg/netplot/man/nplot.html" class="external-link">nplot</a></span><span class="op">(</span><span class="va">x</span>, edge.curvature <span class="op">=</span> <span class="fl">0</span>, edge.color <span class="op">=</span> <span class="st">"gray"</span>, skip.vertex <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-transmission-net-1.png" width="100%"></p>
 </div>
 <div class="section level2">
 <h2 id="multiple-simulations">Multiple simulations<a class="anchor" aria-label="anchor" href="#multiple-simulations"></a>
 </h2>
 <p><code>epiworldR</code> supports running multiple simulations using the <code>run_multiple</code> function. The following code simulates 50 SIR models with 1000 agents each. Each agent is connected to ten other agents. One percent of the population has the virus, with a 90% chance of transmission. Infected individuals recover at a 0.1 rate. The results are saved in a <code>data.frame</code>:</p>
-<div class="sourceCode" id="cb14"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb22"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="va">model_sir</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/ModelSIRCONN.html">ModelSIRCONN</a></span><span class="op">(</span></span>
 <span>  name <span class="op">=</span> <span class="st">"COVID-19"</span>,</span>
 <span>  prevalence <span class="op">=</span> <span class="fl">0.01</span>,</span>
 <span>  n <span class="op">=</span> <span class="fl">1000</span>,</span>
 <span>  contact_rate <span class="op">=</span> <span class="fl">2</span>,</span>
 <span>  transmission_rate <span class="op">=</span> <span class="fl">0.9</span>, recovery_rate <span class="op">=</span> <span class="fl">0.1</span></span>
-<span>  <span class="op">)</span></span>
+<span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># Generating a saver</span></span>
 <span><span class="va">saver</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/run_multiple.html">make_saver</a></span><span class="op">(</span><span class="st">"total_hist"</span>, <span class="st">"reproductive"</span><span class="op">)</span></span>
@@ -402,12 +410,13 @@ <h2 id="multiple-simulations">Multiple simulations<a class="anchor" aria-label="
 <span><span class="co"># Running and printing</span></span>
 <span><span class="co"># Notice the use of nthread = 2 to run the simulations in parallel</span></span>
 <span><span class="fu"><a href="reference/run_multiple.html">run_multiple</a></span><span class="op">(</span><span class="va">model_sir</span>, ndays <span class="op">=</span> <span class="fl">100</span>, nsims <span class="op">=</span> <span class="fl">50</span>, saver <span class="op">=</span> <span class="va">saver</span>, nthread <span class="op">=</span> <span class="fl">2</span><span class="op">)</span></span>
-<span><span class="co">#&gt; Starting multiple runs (50) using 2 thread(s)</span></span>
+<span><span class="co">#&gt; Starting multiple runs (50)</span></span>
 <span><span class="co">#&gt; _________________________________________________________________________</span></span>
 <span><span class="co">#&gt; _________________________________________________________________________</span></span>
 <span><span class="co">#&gt; ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done.</span></span>
-<span><span class="co">#&gt;  done.</span></span>
-<span></span>
+<span><span class="co">#&gt;  done.</span></span></code></pre></div>
+<div class="sourceCode" id="cb23"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span></span>
 <span><span class="co"># Retrieving the results</span></span>
 <span><span class="va">ans</span> <span class="op">&lt;-</span> <span class="fu"><a href="reference/run_multiple.html">run_multiple_get_results</a></span><span class="op">(</span><span class="va">model_sir</span><span class="op">)</span></span>
 <span></span>
@@ -416,18 +425,20 @@ <h2 id="multiple-simulations">Multiple simulations<a class="anchor" aria-label="
 <span><span class="co">#&gt; 1       1    0        1 Susceptible    990</span></span>
 <span><span class="co">#&gt; 2       1    0        1    Infected     10</span></span>
 <span><span class="co">#&gt; 3       1    0        1   Recovered      0</span></span>
-<span><span class="co">#&gt; 4       1    1        1 Susceptible    977</span></span>
-<span><span class="co">#&gt; 5       1    1        1    Infected     22</span></span>
-<span><span class="co">#&gt; 6       1    1        1   Recovered      1</span></span>
-<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">ans</span><span class="op">$</span><span class="va">reproductive</span><span class="op">)</span></span>
+<span><span class="co">#&gt; 4       1    1        1 Susceptible    971</span></span>
+<span><span class="co">#&gt; 5       1    1        1    Infected     29</span></span>
+<span><span class="co">#&gt; 6       1    1        1   Recovered      0</span></span></code></pre></div>
+<div class="sourceCode" id="cb24"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><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">ans</span><span class="op">$</span><span class="va">reproductive</span><span class="op">)</span></span>
 <span><span class="co">#&gt;   sim_num virus_id    virus source source_exposure_date rt</span></span>
-<span><span class="co">#&gt; 1       1        0 COVID-19    976                    9  0</span></span>
-<span><span class="co">#&gt; 2       1        0 COVID-19    644                    9  0</span></span>
-<span><span class="co">#&gt; 3       1        0 COVID-19    608                    9  0</span></span>
-<span><span class="co">#&gt; 4       1        0 COVID-19    314                    9  0</span></span>
-<span><span class="co">#&gt; 5       1        0 COVID-19     41                    9  0</span></span>
-<span><span class="co">#&gt; 6       1        0 COVID-19     32                    9  0</span></span>
-<span></span>
+<span><span class="co">#&gt; 1       1        0 COVID-19    943                    9  0</span></span>
+<span><span class="co">#&gt; 2       1        0 COVID-19     40                    9  0</span></span>
+<span><span class="co">#&gt; 3       1        0 COVID-19      6                    9  0</span></span>
+<span><span class="co">#&gt; 4       1        0 COVID-19    973                    8  0</span></span>
+<span><span class="co">#&gt; 5       1        0 COVID-19    495                    9  0</span></span>
+<span><span class="co">#&gt; 6       1        0 COVID-19    480                    8  0</span></span></code></pre></div>
+<div class="sourceCode" id="cb25"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/graphics/plot.default.html" class="external-link">plot</a></span><span class="op">(</span><span class="va">ans</span><span class="op">$</span><span class="va">reproductive</span><span class="op">)</span></span></code></pre></div>
 <p><img src="reference/figures/README-multiple-example-1.png" width="100%"></p>
 </div>
@@ -444,19 +455,19 @@ <h1 id="tutorials">Tutorials<a class="anchor" aria-label="anchor" href="#tutoria
 <h1 id="citation">Citation<a class="anchor" aria-label="anchor" href="#citation"></a>
 </h1>
 <p>If you use <code>epiworldR</code> in your research, please cite it as follows:</p>
-<div class="sourceCode" id="cb15"><pre class="downlit sourceCode r">
+<div class="sourceCode" id="cb26"><pre class="downlit sourceCode r">
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/utils/citation.html" class="external-link">citation</a></span><span class="op">(</span><span class="st">"epiworldR"</span><span class="op">)</span></span>
 <span><span class="co">#&gt; To cite epiworldR in publications use:</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt;   Meyer, Derek and Vega Yon, George (2023). epiworldR: Fast Agent-Based</span></span>
 <span><span class="co">#&gt;   Epi Models. Journal of Open Source Software, 8(90), 5781,</span></span>
 <span><span class="co">#&gt;   https://doi.org/10.21105/joss.05781</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; And the actual R package:</span></span>
-<span><span class="co">#&gt; </span></span>
-<span><span class="co">#&gt;   Meyer D, Vega Yon G (2024). _epiworldR: Fast Agent-Based Epi Models_.</span></span>
+<span><span class="co">#&gt;</span></span>
+<span><span class="co">#&gt;   Meyer D, Vega Yon G (????). _epiworldR: Fast Agent-Based Epi Models_.</span></span>
 <span><span class="co">#&gt;   R package version 0.3-2, &lt;https://github.com/UofUEpiBio/epiworldR&gt;.</span></span>
-<span><span class="co">#&gt; </span></span>
+<span><span class="co">#&gt;</span></span>
 <span><span class="co">#&gt; To see these entries in BibTeX format, use 'print(&lt;citation&gt;,</span></span>
 <span><span class="co">#&gt; bibtex=TRUE)', 'toBibtex(.)', or set</span></span>
 <span><span class="co">#&gt; 'options(citation.bibtex.max=999)'.</span></span></code></pre></div>
@@ -595,8 +606,8 @@ <h2 data-toc-skip>Citation</h2>
 <div class="developers">
 <h2 data-toc-skip>Developers</h2>
 <ul class="list-unstyled">
-<li>Derek Meyer <br><small class="roles"> Author, maintainer </small> <a href="https://orcid.org/0009-0005-1350-6988" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
-<li>George Vega Yon <br><small class="roles"> Author </small> <a href="https://orcid.org/0000-0002-3171-0844" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
+<li>George Vega Yon <br><small class="roles"> Author, maintainer </small> <a href="https://orcid.org/0000-0002-3171-0844" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
+<li>Derek Meyer <br><small class="roles"> Author </small> <a href="https://orcid.org/0009-0005-1350-6988" target="orcid.widget" aria-label="ORCID" class="external-link"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
 <li>Centers for Disease Control and Prevention <br><small class="roles"> Funder </small>  </li>
 <li><a href="authors.html">More about authors...</a></li>
 </ul>
@@ -618,7 +629,7 @@ <h2 data-toc-skip>Dev status</h2>
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/news/index.html b/news/index.html
index a7bd884d..0fa6e040 100644
--- a/news/index.html
+++ b/news/index.html
@@ -40,7 +40,7 @@ <h1>Changelog</h1>
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="0.3-2" id="epiworldr-03-2-dev">epiworldR 0.3-2 (dev)<a class="anchor" aria-label="anchor" href="#epiworldr-03-2-dev"></a></h2>
+<h2 class="pkg-version" data-toc-text="0.3-2" id="epiworldr-03-2">epiworldR 0.3-2<a class="anchor" aria-label="anchor" href="#epiworldr-03-2"></a></h2>
 <ul><li><p>Starting version 0.3-0, <code>epiworldR</code> is versioned using the same version as the C++ library, <code>epiworld</code>.</p></li>
 <li><p>Adds the new mixing models <code>ModelSIRMixing</code> and <code>ModelSEIRMixing</code>.</p></li>
 <li><p>Ports the <code>Entity</code> class. Entities are used to group agents within a model.</p></li>
@@ -49,7 +49,7 @@ <h2 class="pkg-version" data-toc-text="0.3-2" id="epiworldr-03-2-dev">epiworldR
 <li><p>New functions to specify how viruses, tools, and entities are distributed among agents: <code>distribute_viruses</code>, <code>distribute_tools</code>, and <code>distribute_entities</code>.</p></li>
 </ul></div>
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="0.1-0" id="epiworldr-01-0">epiworldR 0.1-0`<a class="anchor" aria-label="anchor" href="#epiworldr-01-0"></a></h2><p class="text-muted">CRAN release: 2024-04-08</p>
+<h2 class="pkg-version" data-toc-text="0.1-0" id="epiworldr-01-0">epiworldR 0.1-0<a class="anchor" aria-label="anchor" href="#epiworldr-01-0"></a></h2><p class="text-muted">CRAN release: 2024-04-08</p>
 <ul><li>Force model to update agents’ states when running a simulation. This was causing issues when calling <code><a href="../reference/run_multiple.html">run_multiple()</a></code> after a single call of <code><a href="../reference/epiworld-methods.html">run()</a></code>. Reported on <a href="https://github.com/UofUEpiBio/epiworldR/issues/14" class="external-link">14</a>.</li>
 </ul></div>
     <div class="section level2">
@@ -76,7 +76,7 @@ <h2 class="pkg-version" data-toc-text="0.0-2" id="epiworldr-00-2">epiworldR 0.0-
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/paper.html b/paper.html
index 28af2b22..b771bb00 100644
--- a/paper.html
+++ b/paper.html
@@ -131,7 +131,7 @@ <h1 id="references">References<a class="anchor" aria-label="anchor" href="#refer
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/pkgdown.yml b/pkgdown.yml
index 2d201a92..994b3c08 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -6,4 +6,4 @@ articles:
   implementation: implementation.html
   mixing: mixing.html
   run-multiple: run-multiple.html
-last_built: 2024-09-20T15:35Z
+last_built: 2024-10-07T18:08Z
diff --git a/reference/ModelDiffNet.html b/reference/ModelDiffNet.html
index 7b470b88..3c5dd926 100644
--- a/reference/ModelDiffNet.html
+++ b/reference/ModelDiffNet.html
@@ -187,7 +187,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSEIR.html b/reference/ModelSEIR.html
index dce26aa9..97ce96e0 100644
--- a/reference/ModelSEIR.html
+++ b/reference/ModelSEIR.html
@@ -161,7 +161,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSEIRCONN.html b/reference/ModelSEIRCONN.html
index 486a24ad..467a0dcb 100644
--- a/reference/ModelSEIRCONN.html
+++ b/reference/ModelSEIRCONN.html
@@ -192,7 +192,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSEIRD.html b/reference/ModelSEIRD.html
index e1bdc733..07ca5f20 100644
--- a/reference/ModelSEIRD.html
+++ b/reference/ModelSEIRD.html
@@ -174,7 +174,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSEIRDCONN.html b/reference/ModelSEIRDCONN.html
index 9e921071..8213141f 100644
--- a/reference/ModelSEIRDCONN.html
+++ b/reference/ModelSEIRDCONN.html
@@ -210,7 +210,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSEIRMixing.html b/reference/ModelSEIRMixing.html
index dc9569bc..883a630a 100644
--- a/reference/ModelSEIRMixing.html
+++ b/reference/ModelSEIRMixing.html
@@ -200,8 +200,8 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> Number of entities  : 3</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Days (duration)     : 100 (of 100)</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Number of viruses   : 1</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> Last run elapsed t  : 129.00ms</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> Last run speed      : 6.96 million agents x day / second</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Last run elapsed t  : 128.00ms</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Last run speed      : 7.01 million agents x day / second</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Rewiring            : off</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Global events:</span>
@@ -241,7 +241,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSIR.html b/reference/ModelSIR.html
index f131ed93..a1f87e18 100644
--- a/reference/ModelSIR.html
+++ b/reference/ModelSIR.html
@@ -156,7 +156,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSIRCONN.html b/reference/ModelSIRCONN.html
index dfae1da9..a09718ca 100644
--- a/reference/ModelSIRCONN.html
+++ b/reference/ModelSIRCONN.html
@@ -167,7 +167,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSIRD.html b/reference/ModelSIRD.html
index b036ce6f..06e9aac6 100644
--- a/reference/ModelSIRD.html
+++ b/reference/ModelSIRD.html
@@ -166,7 +166,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSIRDCONN.html b/reference/ModelSIRDCONN.html
index 0267547c..9627c81b 100644
--- a/reference/ModelSIRDCONN.html
+++ b/reference/ModelSIRDCONN.html
@@ -174,7 +174,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSIRLogit.html b/reference/ModelSIRLogit.html
index cfa4ea7a..61d874f5 100644
--- a/reference/ModelSIRLogit.html
+++ b/reference/ModelSIRLogit.html
@@ -198,7 +198,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSIRMixing.html b/reference/ModelSIRMixing.html
index cabf1fe1..8aa895e7 100644
--- a/reference/ModelSIRMixing.html
+++ b/reference/ModelSIRMixing.html
@@ -194,8 +194,8 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> Number of entities  : 3</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Days (duration)     : 100 (of 100)</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Number of viruses   : 1</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> Last run elapsed t  : 68.00ms</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> Last run speed      : 13.18 million agents x day / second</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Last run elapsed t  : 67.00ms</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Last run speed      : 13.32 million agents x day / second</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Rewiring            : off</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Global events:</span>
@@ -232,7 +232,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSIS.html b/reference/ModelSIS.html
index 3b973b7a..5dfcbb64 100644
--- a/reference/ModelSIS.html
+++ b/reference/ModelSIS.html
@@ -151,7 +151,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSISD.html b/reference/ModelSISD.html
index 42b34d8d..75ef17ad 100644
--- a/reference/ModelSISD.html
+++ b/reference/ModelSISD.html
@@ -160,7 +160,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/ModelSURV.html b/reference/ModelSURV.html
index fcf52539..5e56884b 100644
--- a/reference/ModelSURV.html
+++ b/reference/ModelSURV.html
@@ -220,7 +220,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/agents.html b/reference/agents.html
index d44a7134..2ea527ce 100644
--- a/reference/agents.html
+++ b/reference/agents.html
@@ -186,7 +186,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/agents_smallworld.html b/reference/agents_smallworld.html
index d3197077..97b6019f 100644
--- a/reference/agents_smallworld.html
+++ b/reference/agents_smallworld.html
@@ -224,7 +224,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/entities.html b/reference/entities.html
index f74d487d..28668917 100644
--- a/reference/entities.html
+++ b/reference/entities.html
@@ -191,8 +191,8 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 <span class="r-out co"><span class="r-pr">#&gt;</span> Number of entities  : 2</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Days (duration)     : 100 (of 100)</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Number of viruses   : 1</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> Last run elapsed t  : 67.00ms</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> Last run speed      : 14.75 million agents x day / second</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Last run elapsed t  : 69.00ms</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> Last run speed      : 14.32 million agents x day / second</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Rewiring            : off</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> Global events:</span>
@@ -226,7 +226,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/epiworld-data.html b/reference/epiworld-data.html
index 6fc0c59b..04965c47 100644
--- a/reference/epiworld-data.html
+++ b/reference/epiworld-data.html
@@ -323,7 +323,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/epiworld-methods.html b/reference/epiworld-methods.html
index 66091917..f04cbca2 100644
--- a/reference/epiworld-methods.html
+++ b/reference/epiworld-methods.html
@@ -310,7 +310,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/epiworldR-deprecated.html b/reference/epiworldR-deprecated.html
index 04951011..59d9cf36 100644
--- a/reference/epiworldR-deprecated.html
+++ b/reference/epiworldR-deprecated.html
@@ -92,7 +92,7 @@ <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#argumen
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/epiworldR-package.html b/reference/epiworldR-package.html
index d0ffa5a4..4a6826c8 100644
--- a/reference/epiworldR-package.html
+++ b/reference/epiworldR-package.html
@@ -68,7 +68,7 @@ <h2 id="author">Author<a class="anchor" aria-label="anchor" href="#author"></a><
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/figures/README-logit-model-1.png b/reference/figures/README-logit-model-1.png
index 3cd4a67d5411776445c1e8befa2b41ea8c3e29b5..d4e76bc435c8c14ea3c69f527f7ebb25302cf29a 100644
GIT binary patch
literal 36373
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
b%Fev>V<ej7(;SlEz&~km1+n5MPksLnj<sz9

literal 27935
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

diff --git a/reference/figures/README-multiple-example-1.png b/reference/figures/README-multiple-example-1.png
index 819f25830577d97629c3c6f7788c9451c486412d..1cd860cdef28236af87116b72d14d3ed0e4c99d6 100644
GIT binary patch
literal 24847
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
ECzFhf$^ZZW

literal 9530
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
LsFo`~efd8C!EaEv

diff --git a/reference/figures/README-seir-conn-figures-1.png b/reference/figures/README-seir-conn-figures-1.png
index fe7d1ac4ebc91df0544f42b9c1291a0d7ab80bc3..e2ddcad3044e1828231f3c40a73370616a0df087 100644
GIT binary patch
literal 53967
zcmeFZbySq=7dAW$gA669q;$80NDtj1DUAYB(%p?ncOxL(AstfEAPq`)cQ@a|Ilpr}
z?^@sg??3Na!&<Y(dG5Jm-+N!zzV`OBqPzqeG66CO1VWRN6jcI&z!@MA+#>V|@QG{a
z0tW~Ld1@*mqG&E6A!7B>%2wI>oq>^rk)@HXsezJ&FbMQIEKF6$gh&-fAf^5r1LaS@
z@!Z_#r}vz(RUef`{HHhXjlNmTGRAzY5{m5Iol7&NW?#9@Hl-855yEK8UyNCN&}yS0
zGb`E)VftF7_!Z(udpUe9kvWQsv{TRitudy~yt#k&YCZM9b7S6ae;y^Wj!`Rqo(jxJ
zP|CD6w*0Mo{l^a;`!<hZG>>5>hVVH0IBGb;mG+kDy#vy&`Kj~TiwEPKQbh^4pt*ow
z#jpFwmyJO8&pIo0ydgq2JxEjUFOh!meoQ4@#_FgBspEY?Kdc-|ied}W6Jw+;488v`
z6NI=yajpqLv^$&$=i|&Tp(F1X>wQ&}EKf1k?04f;BQ|ILW5!P*;v1_6&H{Yhc>=v{
z{L&|kbk)^a`=Byr({G&^4@UK-NJkVPoyMjBTjV2w9|o#!O+=ga1%+HAtqghNNyZop
ze$EbUe0^Q}qPNvA^-_@?Je5*W*U^bVi_7#(<*pYL#N~3P^g;b$>L#zckAp7j)}Ma>
zd+akAoAOKzbLV^r7Gm5FSvkg3%M<vaUhpMB_)d?h7N?7fKTtOn)xL+-;r8s>Q9UgQ
zx*W}oi$V}e#iCYyB;4brUQLsYp;u$?6|p?qBR3P%2bbQGPOzpJLlU#6E%4)6VpuP%
z&EIAB8LK|FXe24Rsk@ebRvt3Jrb*^zj!EX_#NzHkJKfbis8+@7zGr81gjG2Af#Ptu
zu>HV9m7)pN)5WC7VHoLyHO2T#DHf?{ze^(Wm{nGMvMkbQnqFnYP{R=(>8G6C@#J=f
zC-o!aE^rh|>0BXAA)8J@UH8U@iHlW3ozm%C7{7*o4Vm}FO<C&lcvz~3G>WUGH%{7Z
z*;5)5m@(P+OpmA84n4H%ZA_KxZE$I#-XnU#d+p4q)pG7|45%S{G+1f<kT~I&Hx$TW
zQvLYuTh><%PPJ<=Nk7P=-nkKK{6y<^^`ciW+PwE7nuOYGWqws)>8D+~ZMw~ZcaP2@
zv#p-3o(+jzx`f%d%K?Y^epyxp^15llo7r?>&0kD>w1xrv?H%ogG76i|0{xNRvA8;N
z6=8?r>NGy-F1Io)@+kJkEwJ0QEdDmRB&Z@D|AfXpcjbT`Ufy!WpF&CypFF^#(ba$N
zEZ5OfhJU)ur_1i>BOk(hcRhCw0UW`0Yd`#jkneAHkH&4cD*K-<hnl8URVQx;cl55V
zyhko$qkoRN)|x@P)3Dh{G?M$YI>BTORPM(1y4_0Z{tkD>CCA7v{mJWF8r}=d8gBH(
zV))@3lm1uU#w*PSpkjes=W``znjh~Mz^^C#I@;6~2!@JCcFwe%Eve=~zucR3A8zhk
zJx<`q7eI9x5AY9E&M2J*ll_2$cy07n>Vupdh#q(k1;KqX1wnv!aKIk{@b~CT!2f&#
z&d7lO=RMrw<3D2Q&CG&8Fp!j}kcu<hZW^LHPA6`+9+px*oG^-*@G}IsH!2t?!Q{T)
zw9ge=k%NMReGw3FFc7lu5E}0>8F9o^L?JlO8iRtAvM+|+q=e4}TaE-b*6aG`sOtOo
z=B$qEXXp2KV-E)Qzk9GB$c5(kvPOcC{=8s8&>w-cBp*b;l(0XqWDtU)BLs^S?w^-W
zBvuB9KxuX$6e8*U?+Z+O^M8ybiKGZZqqF=V{%0gg7+kE!pC=%aq}dQ!??4<bc8Y%o
zhXcm$6Zp^1Q(`EAabP0BDM?ZP8D9}(MDk}wa9B_}IOGhn&cT8I%m^5}68+EWKuG?v
zAcWz_<qseJyF47&Z^ZvTBrNR>Hj%VpXa8rpk5fa=*oFV^Lu6DiIF9VPB>eyE9<WX4
z|5*m<|Jx=o8I>YscD<O?hj^pjAD^*}mf8c3yGguyN_85uUC*{h%ioFMv+8?~m+1*g
zOWtY?p6yJ@{H`>j;^x*kkX2AfNU{2^VYT48Q(`+~QM<J#LF^*xd3UBRB_$QLHJ0~~
z;{A!q%G5cC;II@|*I7v5Y85+u!(nq+==ywbhh3La!ukGc!)SlDz9AUpIb&pEB3{{q
zPNQSVtizPfwX^3hBV*(KRv-AaF$KXmCaoIDz3FPBU*+#c3so7)TsAI1$J*cB>%WJe
zq{QFd!Y=n_Y86Tw_jzu%TnPt4o--AevCJCpf4{M$Q_dZrJE{};;kmFmS(0+PInu$x
zh^u2C#i&s!I$5Gc^Nc}le4|*iTDmKYFz?{R>+UQemQh1#baXV^ZsTV|It?Xd-RS%`
z<B0i#>8SoLL=tz>9GQgY3R5z=H=zAm63@%b+v9$g(F`F!ZQCIilldl>(NY~=U<)Eb
z@!6?2gzjxIt-ZSHpRO8oDC-TH^R8#%wehMV$)F-gE*>s*Ojb|nnio7jx%?a!R-G%G
zq~y&V=%loG^aESrEwGo93tkU<^t*v*gxc=0q)XFf5NNX?C+9@<&`e-0M^h)dVGCBY
z_S(s0{I7*Zrvq4YSWn$H-2Quq<JDg6ojUt1CH2|cazY;ae1;ce0t@aZa-}XC8;i@G
zAtiP{xx2TgtIa*5kDM(@Zyk4k*+@6b-R&(nY>!u{m1=LjY%y6dZL#9JT8;5sy4=i)
z;BcaP+ps*8#NMsMGOjz5WwX*XIg%xzb5v_Nx6N7FyjNZVLHGEQw?kFtp?`mS#q%Ja
z##7(7YA(`juOXMrF|u)YwUPe)tHhd()li+U_fkRGdd>@!uZ(SyegujR)wqU<JPw7P
z{i4ZoDX-#cEM}wwke^k(vhNDT2Qx_zec@jVW+)xLL18<vmNg&Gf1}C1rd#vAGg#{8
zeD7?Z{pahBJL|W1-?ws8s>COiGc%sOgYx?TCnRL7nJtM~GU8K{Z@bnf#LyFftD8So
zs$Ql$d<^ASO6D||PI+Z<YFbxjXlQ6s!e2$bZKOc#dHL?@awP&@F8*i^>RsacdD6}8
zY&)lAqT}s;(}_H{^`dtyy{dHVsE}rrNoKvl>XT_!D!x9z5FiAW7m7t{O!eD^MYB$g
zo+2rG3eaqHZO7k6Uv*_qPmq$esoq`>fQJ}=bb9O$un(Q$3ldN`yLBOii0Mwhd~4Ke
z)qn##ks01|XaA`6RTSy!dZ$dx^xhsdXK$nf508z{b~VWTX0P_^yy)D|r@J(kp4%30
z(W~Pa)a7FxC(Oap>{KaSR`F&Ng;LtusZ-9ctq&K4JPgFNy}+Ygted8JY4JOUMf@el
zYyBak^uL^3=G2nm`KzG0K7p{EWjYVkvnOuTqNJ#pPGh-p$xfCQNpW#h`kyZ2=vA?x
zck^K4d_peEaTc-q&W<a|sVXN+kDpq)_xlnvOPX({50&MGnlZK~OBlikIC<7yJ3>a!
z-7fYgQioYiu#o*ow(rs(ZfPWJ&|mOSsurnDI6MINr&`gB<catytj`Qf!fi!t`pfgt
zHvSyxIC_Bty2L>L@4f|`2+zO;h{xU4zNRprK&J%{b%kcwLfz@8%-L4U-FeE#nHo7O
zgK3O?Oltkh7k!8jS-B%h?=K$bzw@fnxCJ8*VAr5rQ*GdaAMbt}3Ld@P-eRa<3%Gf*
zOqL-(FHAZW-g3e0rdvOUxO-F{Cg9^nv5$ZLeVgt}%LQ-j?*-#LH-U90(hG7u56)pn
z4kKv4)r3B9hhc+5wrJmE6It8(1_tbNN_i@B*2muB{bUzmG?PzKZF07`!{>D@W?+6*
z+H@@4tY-?f+g0Zhm1(|eIDYe@U&$_-krS6rg6~$*YB}C@tOg4k+rgcaWk48zf+$OQ
z+4Ew~X;Q;D&8XmM=?Z;Gbj~`LW_JXMQ>QAIuDVOh<uZzlsU1@eoONgI6r2eE(a}+<
zZDFme43aPplS7Pk&dKSRLgQ#HdYfMymf6`=VnfD!dkLrcWZm-gCz{=k%b-OC9c?6+
zU*+g+Sz+!0T=UKys_F4eTAFwb!Z7aG#o~xGr+Jsj&)77@FuduLJ7DYVwF+H6BqL4Z
zG>!9dxN)F}*qiB=<W%`FpPMNEKyY${%?KQ}!pBQtr%s5-CCm_`&q(7{wIYns4R2V7
zCp(!IxY(Dvj}K1YRS~uDqtTJKzi^t(#OJh{pVh2*AAq1ni*o$tB=5|@&l%6N{p@}C
z5@8F=_sjQ0lWhw%5`+cy)A6IJ+wQH<j@-MOi`sD!SYFP0|JLc7r|zvdS4-34P)@;{
zLx$XIXXK49Zly*1vixAW9l-CD?KltdU%WkNzW9;@kxe6>)){1~9_|9h{+grfdgiJ9
zuqm<+*D(a_czRA%SLrcn3E<pzIAq;tBU*7TsHp}L=dKA;ZBR+hgv%}v+O-EeYR7N&
z(*&n+?~pH^jeWUCZDR<F2`^hOXza^fKW`ju9Y?)6B^MR`uIF(Um$Uw@@n;2k8-vhr
zwO}n85I{VyTQ3&84(My|bhiso7cE}Xy<?KV@hW|BgLFUNc-xFlYQZTuIl&d1yWqNA
zkjHrDo7G?JuYjVg#mZ-i?sNLW>q}Za|4L+8%LVxlwCu7cqv4Xg+VJyuc*v371inr>
zRdvo}Ki<s`@07Jz(lNEuaRY&L;F;HIPZW3fN@g&}A?Otxx;_PIA(yQT8rn7=2Kvp&
zXE|^05B?%VT)uvvdF|F^u~pOaI3T5!zcya!*!EJDI@e_`ySs;Ce8gp|@VY!);<=wt
z*V_v=|0(2x(S#Hs4(jwHZb$eYC;l_;sU_<=*%}iX>tP;q1F7!)Zv;iChE?-fd^b8o
z8oRW9oj{%Y$h!+3&+bUk2^wNz?hnIDu6ntE%B9*da*x(F&zFk1a7tL-ff8_+)6Psp
zvA>p}w=azi&cWQZW+om#_r}GKVYyDm)Ew+b3tv+OHLt~M*-vkdVTcar#n$x2kz9lP
z3x)(AW~+x{5f-FZvO@?YXI9qwz63TCW6&QSUjpD_Ey!S*fr2wlFaK(d+MRZ=%Ckar
zCNs4UuWR1jv$mS;{piMu5$0CLi`|d0a3S*%ZYfJXRur)mV+P&fTe!qGHa9hFW;Ssa
zlf@dP_PVZHR8yWG7Xv^WLO~oX4)<)`9Sf(%+3)rP&KoYVU}UX{J3sGj!#pi<i*5L6
zOLEVC8AO=2jg>mHKC48@aF#lBRJc0oCK;qt%K+z>33$6jn<C!aEyQJ7z}sD5;_mGd
z-_|=0aQn>uZ646!TxK&$QLB~vcUE>yveSMo9^DJZ#+E~MuzfL~^9k7Wi0*^+OfHDP
z|9P8MOFirELLIC1N~g#Ve;9(I327vC)vNWu&{`f&4#R>g{dj_Cb}23AesOK60ZYqm
z<@2D(bWEZQ4Kac`)1*(x#5}{-i%)_HOX(hVe}8jma9l#-(lL5wTJTO#MnhfGY*V58
zQ<v4o&$Q>3b&k)66PHV#wWS=IKonPt)`zy80eDgqi;!EyXx7tjPT(^xMzg$@t^?vk
z<?~?ZS5rsM|K?)iS5c{EANRX7?WsQ*)~CtQCcb=A%t-)h7I1C?mp65?^s6?8y^XR`
zhi@t0$U1e?$xq&EIHVHq%H@eh04jN?YnzlGmW$os!9j!*k@_0up4Do6`|unUYrH&q
zlIK_bsyawa6T|-EV4*DF_x@aC<FV?=NR>W3v6(>fJUSVu#YPTc^t|QazHx^NL72M~
z#l$)DjQz~#9DV9}mDY#!<l15{1{uR5*2_n0-oltXYU4Ea+VaIfZu{vEM6YQQ2Vy?w
za!W*$)?Hu1QlZ1H=5}b)uwk<P1{96EYMK>`eOfg8Zo8;#dsDL8L}R2@7DkA_Paz&U
z+z4NQC@wp2HEa(U9J=e6ll4FX$n4-^KTCYrmte2Hx7*!7F!t%WJ}yj-Php|XIC)V9
zgqDq-$PpHA-4jXnA)(u<1O2Xz__o>6TAuWR`3D!6wr<st1g6~x3Kq!Et$kM;;MgX^
zJ=$tF=nuONZyAyYU>IO2wCV4{*luRj?<^#gAFOWybIDfo5l2Q>;3Jx~VslRE4)~0b
z4+<u1kwOQ9Ey>LU3Ow<C6@i6Xp-j#u)9@Tx7*7T{Kzu~9$>%8~{)+4ajvZ)Ro0Pll
zF*>leHmMlu`q7u@f_$yA)93H#y&#IH?~*c585x`A$eB#gG5B&YC3RST_+}E`AfnSk
zfVnOSnkevjguYTs&%Q6<)?-GiF5uEd9q0!yBlKZ(+)y(?Z_o8f?#1UZki$s9WO&^V
zHwzD%GqqN=>AAI5O-JHs%*!Iqui)A%dll;AM;c#tw(a_{nxi{Mz3dJJA<N~YG1MH9
zFKzh*SM8z`H=ez^E|4O;>xX3F`#Dbe!={NfU1LhwDp{pW_IR3978^v<+1q|pYqjA%
z5o`pR^%*{N^#rgbf7{jM7$=LYB!I)Y>#m|1W!($KRe-Kj<1w||dFto>TqOJasRGHl
z?d4kYqA$vTrTK7%Q0ZNfdfDU+iR&g=GrDlRi|IuzF~+MfYSihMZml5!bbc&wr+c*v
zj-8J{d9QcVLfgtLJa4i!g=25Q?0e1*Q6mW1r+4fQax;MPO8(Tod9@ln(Kpe&dv<Kl
z^TNuAHfQIlm^VMfb`N5EAWZBti?|D>y>8;yH^kWUE-<COoN)rXIFef^{B`awdqwv(
zSp{CNJ;$I@XQTR%Gx01YL{;NSwT5jU#+B{}+)H0&+;Cc^_<U{#?n<>6l-*WTRjZd_
zB!>riftFQPZ>V}q(v!B=OK7H?wnoMB3Lu>Prkeber&p}w<%n+=XW$t>$SHQPO}}5b
zRTD9F#f~YT^Q&m(yqQ3F_sZdgj^J^5roX_O6F42?!cUPki$5S1mrEzl!38L&?fcCa
z^F&ewTTi}17Km=fJ7%pYvH`-j!!co<Ee{{4Y+`;k{4*-|Y6)G$&1I2yjQG$E;5@Fl
z?mx-B&alX&-I!P<+g`dy3Zhcz51Kcj<Ed>6F-fCrN~@VF>CBioQ8};bm#$Mch8w_7
zR%{2R7^Gv3iz20RpL-O9z8^=?2>1BnnV)GeWqAg3v?wC1HlG;_EI<#x+U}O_v7vg`
zBA_S`JD0A1j6x+?6@XOU;CVVCQN31;g?!2n*S%ORH0Z!Fa_U5C#7RTXr2Di(+#m_f
zfHDV-a|AL)?`ukO_C60ys2p7vHjeW2m4o+0jjQRfC;O7}vkSgcInE1(SaT)|XyARY
z8v$Q1X+{e{OUnJE2$J*k3iM|;=R0&CJe>9{Z=^4wY;lpy()!~hKU6zPzv}9XqVevG
z#rndC-4EM{nyfQ`C?#-5l;Uo8^AzwD_KN6Kzsx%5zYUGm7Bspw!`C~4o1K35WA=Eo
z662aC-UM#N{MxWu@WIRloI~~wU1F2<z*IA|OL1L;L{jgp_62_&i}v{&5L0WsqNW^^
zA-zRRt3?Pw;3$_KXMx_K&$lxIPP5GvMrK(jI2BW5+t@D8qeOV?Iy8y)a?gN9^c;lo
zPx_yOJj@bhNVr}QAoAyADO^7YQW!4NFbhECsPR5^eqoG?3!D(;T_Z$ayM^#ok=jrD
zNsW25@XPD&yjP$QoN>;W4tU8~%mmPUtQ?EO#9~3zK|d0tUnJ|7ds5{A*dC`X>bfps
zZtr0?S=wd-SulOE79Y;ycL5xG7U339e5kXJaQTJ-<f#YjPPt?41N*{4PdD>y-4s_X
zs;mb_x4NKXi@@wotd_ufVsBab<&qdSm>8@}PiEiF{zMyGu+&8q-|rJUF+S96l`OE>
zA3Zy-M+R*`j0wN$vf-1RaOc^3g{-!**&+^Vm#Ia%pX~VZ>e`ndGOD-dP;nvCq|*K@
zk$@W`XKjo{4I_Gql8B^ky5kH{=m|@?nQl!p6rtvYBnfL00dc*?XA0)+@SB9@`ClYG
z)dm|Io=h_{(5-3s@ZTp6f>Xq}Gy5JB%I;n_;cj=cC&wGLy(l&wb0ND#vNMT%wmU`C
zrDcvBrU5G#1x}x=8FNJXvZ>8?R9})x3O7CpqdZRnsiTVboAQL+fjc`b(J>795%?IF
zBA)K^XILnTY`X>^7x!hZZ<xSAt*+|4$=vg=T)Cs$T!z1phZC%i3Risge#Wv}q_aq-
zUxiK`eicai5&bRF4+ykxzioWZqa|-aA3?4{3Q=}2g{z8o9t?5EcAr47N&zS(`^XuW
z<>nRAuq}hg%QT23V?O&dGP+7#kq!DitIEl;=-|e9Uc19Hj#TRW`uY#b=JAK{!W31q
zW(59|`UR#4U@uQIs8+YCNTenRfdSgDk8<(OdMyBSj&Z!_F;)d1E@GFHE2OWS!4x3#
z@*-osCGB|G@BV}KR9!bq(1K4@v(C=v9e9f8(BWxeKd2l9ht+--!nuGp-t8{B1TTAe
zfS_>G>DN#*<j=%HtRBpfmD6KqRTf_Qt~{mdLNdvt?^o8|$~6yzLtI?^Yb4~XhVwE9
z&Z|hP$i5Tg;&K)jtYpldzdEcX2B4_tQP{m1I$qc@*DnvfWnGi~jXFzGee!%d6tG+#
z|Dsqc#IB61#qVsd2tCnV?)UDLH}{7J@wubpkGhb7mp3loOVeNnI@A%cmc6^4nfm+l
z7up8*0=#=H`#n>$B#{Y7-@k~|sU4606}-dCZ`E2K(La`%wp}1=1s?Xu%XC!ikik^6
z2~6$hS&7C4mWtOzMC#zIFDxeMpNwmLKjl#U?AB(%OHI^Yms!G_<tNkMr}12Ym$Af?
z*C)na$A6cOMQ_hH;J|KIqc3W(ewT!F*@L1s2R*+E+0J}V2Pc1^-cb~v#O_~j&~=A$
z%xUDUnvoQePb^=0=ZGuqNI{9m*oud6!nh|cnaC2jNEZg%{)&BcJS2dKV*y9Opg=P4
zh68Rtc|4`A6qmZC1KKnGVlrX7D>v&&ABJ68D}ia-2`JHEA0PGSt_2b>+ID_QQn-07
zsPk54Y-n*C(xxl$qq9k1z{^*N@L0r4g^T+IZfS?C&T!dC!l6xVVCPjmf`Z*N#=^jz
z5_&XIUPn*os(G#OtEp&@rzWHp5%y8Iqg}IN1HZ*}Ci;CD1P312g^*TV1%J`*1tP3`
zYhN@@f7s|ni@}=IUi+l}1RG3Olmw6Lq<s#OUqqlFc4M`8$8}jgB=<yFyC~7zyq4gV
zxFj{x=?gm&HjD6QWxHgNuB~A&M&C@cTCfJ%TcazXyW>*m*}-0NO~;BM8I*oqbY;Dh
zKq7OUr#^q@*-T*T^g@}Xs???GoI8WH=Gb2F<;?*9?ATfKlz=|6)%29-0%!N`LRTcJ
zxa&DaPc?Q=Gl~numIOAPYcY#fsJ|Ox;D~bnH@b`cJ;u%)>4rJlBlGCHqde=LNbUkT
z3((|O$BUQi;0mvfsmwWNu|ZyY9mzWVa#Siy%WWp<gIa)!&?Xa-K#-yE)WpY%b|Ko;
zZ3u<qr=?Xk6tC7`1mey=kXRWjNItdsV7iv0p}d1M9vb>HHTF|yTg|ePefMY=JQhu^
zd(Dp&5o85Xgtq6C_|xSaIm8j(ymN?HWJ2@W`O5~Fy$L>i`5yNQmgkL&ctZL_!k}E=
zNeA-q3F^c4gWJT(?dDhQ#7u(`aX3aeX>3yE*Mp1*T8rFy#M~|zg3&7$j-ZH7RMdMZ
zb`z`=m5vAo_`xgZjzYxisqHwhH^Z>$dFNPGqgwWWOv1Oxi~F{S=m+hK8#0%zcil~~
z8M<8)@<4b-uepV0ICJ|5zESvCf$p212TE^UCpvw3BlBt*Q3?HWhLgoWa%?tlpc&!D
z9Vw${4DWq|R&`NauC@`UQH|G%rt*nKl>bvlxN+j4v6`2s{UM<367&p=x{I&cJ!85x
zUebvtg1Xk23UU!WF0eb~)#;;)`2bm8I`1c=k6_FdNc-8cAXh!o_dE_=ygfj_@$d4^
zp(!@n;}WzZ6N&kR(nfq3j~1dx@wPn;)4${9pha&11OU6A9WS8)=Y+WaLQO6r>>tq0
z@_Ur9Cv;3#h_a0>t<UR**M&0J*1QoIicywqyMZ%;OwkVK;tM@%FKuK|hL(1*P#p(4
z;%F*bwP#_%-f=&*2+*Mbm-r;x>IW}#qKN{$z0{xYBZS^t*w18I1V6A&$-fqU9KV~C
zR+x~ORwM?mio)6DB{~LF)<nzghLpK#$T~UfRyOGn4G!Paa1U;8OvlBX)ksuJ_|n&?
z%ngu}(22*&Y@Qaoze}<@ruztoV{~4-_eQO*lFb)s+xvQDIv~Rsy>2}eBLZ;GPoY5c
zkpYP%WoU5h!Ci=phwNEtpa_G+xUE@)1v&PAD^fcnw4oFd5J<!-gZ(+iT6S5+&V%kJ
z;Wt{(VsutMe-Cqm>YlzK1}F!6VL<1LUAQ|$7Sr?7DC%pZW1;zT40<>m7uOy5^?5&m
zkFyoO`%M;VczL_o2Z_P;j@CfpuT&p7gI0p{kyO)+o}Pw^c;3&4U~ol#Cy?YN-?K);
zf%*Mn!_(~+3nxQ4!RTS)MUA;`p!+qXZfAE|$Wxa|UN#GM=UcWQ;1XiT*<}(SCc+E6
zpp;Dvk030;#}adg3f0HKS*`W44I9sY>GMxX#~;10=d1OopP;He@pWM=LzPR)Nb)P=
zMXld>j)6X~REthfFblqhEMIrvUtOCW%pN08Q~-p9MKn>^=hNp}Z`T!s_Oa?+N>2cw
z5Qe}mR)_=KU_ybgZJ*mYJ^EWFl-ZOePeh?<t=6*ux+lY_E)7<$ye#84VJK9g4OiG1
zctUe?c{0C-&NilB9^ExNC0({%Kg~Y4yxASt!^iDu?n(bnV8Z((#K3bb2b8Sm`^ND*
z%@SQ7#%g1OVWO44tT#kh8blxmeeVosW6KK8@$j^>JbTmixncgTZ8VuX6fzyYq<ox8
z)tg>M<RHfOKLrp*iLGeo>2Rj&w#V76raZ_#UYa$IgR+;|nI7Can2=0U+KgSN)p27d
zu!6(q(^O^9mhe?yDI288N|Z(Ytj^oFMaaFW-Z+>5&!w0ae;t!Zfx<_a9F(AKZIQd~
zZl+fhpc3kCgo0}WwVujZ=ebFH{=7_atVq<w_UML49F^Fosm9<?I`$&AdMKtT{U^KB
z-$E$qF%k^gfha!&kGa?$fSS5oR39<@(lx_K=_LJ(9PcoqSFsLqJQg0Hb*yZc2Xdvy
z-Y5Hy$_OQgdpJ83VuZv{|L4;nVn8y@$}7=O{v%>SQGm}nzT&@y{`u_x;`hRFVNCte
zfEw33-|Uu^H}UpAQ?+J=lR(bUs<n)RgMT8ashLbkNht})G?Y|SV$m@%Id8JWM*+!@
z+x@cKFC{>X=HHe3^iVC<RWEW`&eAezRy_)STeJ1w#)~zS`{J33yhKnMJnvkSUK#|#
z*c<fQzy*Lbuv$ZG{vV0@Ddpm8xYK#JgE%15qq9Dg&hq*5XW}U14<8=oo7Hv{mRK^8
zK<ChowExP%0V1t7B8M^w%yE`;4KB|Fd|nC&=(?V6k^%A_6H(zn+`lS0M6#6ut{W)>
zz^e(JA-HZOk=*6hOTq<8Il))GR)0>0)Q6Q!ky5sA$?0W-{T4Zf@YvW`j`>unYd8&R
z<a+~yYN}g6uQS{pFJLqNNyIOE;M5)}`5&bn0}C9U0*_2@K3N>~h2O1DUC)E+_wV0%
z-hf^c$9I3ZGFoZWuN-cJ_#XiqwuEJ!4Kj-~GBoVTl}mwWD&P^TmTGGhs+AP#uqC~|
z{jZ5ZS-|1XVLn*<@s0=cOg1()(=U{rmyAsRE2YmOz5WSBdX_=qdhucPKZ~<|3fFB4
z+X|ZJP79%;`uFtU6d*)2-lLe!c^_5<{%pnLx6#_hFq`doaAl<btnmx<wLB<?!c}3g
z$K%goEE0k3MGsPI-b?-Of&tfzlpOln@+ocpCqIhoqm}OdY^fMZZf<UJ9x#K@KjUHG
zL!zUjS63ng<D;o$0xbfF=)4J%1Ga*`n~vqO*>5T$XXL)Tl>7JV&mrYltLTEaq<{d0
z9CGYT@4phbxECiWDLHK3CW3-*CUGhjj1#4lBi)ODtF6z1Rr_Z?8Hz~bC0ezLCl@q!
z-S}jgO2CX2#@L?zISYT9#~r$J5ETT{;~M4qK9iAwG_LW%f9&XMjQ0v;IEq3-8n_<=
z>4JKIsKZ|~4XC|2fUwEta%_mtW*F4{dfw3z5Ut`_^!E44%^%M9W{kSSUz9G){<nDI
zFaj7$@%7h(`Q}FTCG3gth=>GYe%Bs<By8|=7@2!GG5<78GmzNtA@RB;o6>bF8LA8Y
zZ;8es%cD(qVczLD&7D~>@qJ{{u2U>jDOg^T+;4o;q}saGz0Li`$5r%3oKycSLb5gN
zaTUxu4N(8#(^LDc>FS~{D@oDO<P{Yal}-n`zsukG$)@qBt`8(-ecGDa?oa=7(lBs<
zY^x2}WTh+22q+pD{bsDdkCUF3=7HR<R-)P4<Z`kaEyK*chUfI(8W0@j$EmieHac2Z
zEa@hOZ=%%xPUQWw^RE-UDG(I>8d+bAq_E+vUJwcr$L=A1yOm@U$66MRUN)etkPM|P
zK>z-5_2b?vUGlwqF^;-TFx3yqBS>}0_n2{kCx1+rRu&wN16v9rHm?BEy*JZz9%_?<
z!h~wnz9H18Z5?+?pRuTrV=P)-66gpRG=580o?^a#|9;gumx`vca&7Tw*Q-Whx%TYg
z?qQ+J>WtgIJ(_~1a?M1%#xNC!F6uG@7JTp?LkZg;#~({xS>{<(VNQr-^{9;!)m8dl
zWv6>Ww}g#L;-Brd#js8V5%h*{mRaDr`&=2;P<>**$CQkq^*M#sJUlcTdBrcD^slc}
zp26Zj&U-1b#ez^WtITX?9|Fe6m86ggpGp7NQs|7fk<Q3b<Lp-LB>DF=>aiY&{wQ%;
zKN{@qXH)SqI@LeIOL*m74tIbevX6bp^+$edrTbr=Dvrbg1%g|jVx?6PC?eGq!KPx+
zyoZNU-B-GW33TLiodr^1-uoT&|3qz{zvc`Kj3CVEi{<0^O}7(rccjJyEf6Q2D}apJ
zL-V%X#9VWWAGRVt&L&U|Hwoj(F=&aRWKZ<pehXW8Cc{%o=ql27_wQ6aF|21}1b>BZ
z-syMIT0%&(mzCM6=J$G91ks6j=?G&<8{S#Pf1FOB6SUxA9*h4#x5S~W0H2=;8JS*N
z&XK=zz6;yqpepa`?z~Nb*8c17fT}Fu67hU>`p_c7Oh6NMSdi*0jSz11p?{%~&1i66
z_U^8&lERg+<9=fNR=H7Mv)0{ryaa<qY+MEW$7GBj_fcBn^yjWgeOyC+<qxZTh_d@G
znTW=D*}_SgK9ASg%cRpeq2C$jX}V-WKc(*;B+{IC0+e`pEMxwzkAl6$2F5^6wihLt
z^eAjaPRIycATwDuKp#%Lucr{f7cuHlNKxo97bK1zG^1T$julP>jwp-a-%0o!k}pca
zjg$IQxI(ioSw+#|Ok{^j;<E*FC-;T72>UKgQwZ9vTs5OPWMov*DGT)Igx<%YtNwYu
zoodkpuF87k<%Ko*q7?0%+iCV~`BI&G%aOlqO0~o&x>2u-CaGLBN}&j881Cyc<A0qI
zlnE%c%3K?q6_x}Qz1H#gU~?x_(-?89N2)5k)hP3{mwAnO+np*%SA|`w^mTKhE)u<e
zr-9o4&K9HkF@St=+pj;K((}5S&`;xWhz6>2E}tbtk*CAB*HBw@?v}6prrVw9II<T?
z1*x-Icu4c;K3$dUJd2r>#tY!3{j-Y2N6X{+Fo0LT->^eTK_T+wDG_Z&#k~4y0RT;`
z^IuK`k$O+0Omoqe3J%p&uXfAPte(V4tW6edDRBs_le|+w$_`_ovCbDD*G!H3dx=n7
za5y%MrD2o&>U_ouVLws+3m+X2MXc+}4Y`SAL6gUWahX^GBBk_2jJpq*;v`AU5{sgG
z=HhXz!7Ek8PSzsdHveAiJE7LbYgWeKje3mXj{+wH?2j?(H&8>gAvr4pz9O|&GyBRn
zTNyfVpres{kx!`_Cvy8T<Y|wKK}`?)$$6jc8aUYJAJ;%?1tH3V<D76`^g#rIBef=q
z+4)fl#8(I;<9lxQrC5;g{6n8?wUTn#7H^J;aIyAOd7ZsV$7P%}_qh`C6SiEb|HVbX
z4eTnjGc(I;)_hDdUvrLxASZ+TM?4eaC)3j>fMkMrnY&9PhoXQuFWtMULHy3_IxJcI
zfA3HewskRRyIGn~7@SE4qPe)#|GDWqA+hEs7~Zp3@3wZ_(777e)p_Rr<{BSOPKy=y
zZ&z!KnE~1^K7Vi85ea)Ag_qDW;?Z|?w<{RY^9|*^|K8xY?a6PdY`YaKaERNV^YwxP
zMT82ZK43~kaqgCb`Ks7^#u-Q9c@5jQnsT%BgXWaIa>fa<GG<gGIm&RyAC&&y_@9)m
zy=Ff@a>Y->K?v03V=?!XR&Njs`#P(G>5VUL*4mG>jM}+w&MGsW=7U52!DK>YFf<dz
za<(^EmkFTI=mrkD0zvBqe<N5~VwK!a<$iBRQzc=|NoMJi&6c`4vA?zx0|Al`7v?Me
z;aSHgnBO=AfAW=>r+ay!c4lZ?mzM`jlY!y-cYlOrjZuJtkOtQO!VbU)kTZn*0g%&5
z==1fc!ZwRdG1)<)kZ-;)^!8#y#P;_O3$~Suj_5c!p>aa4{lC$35Gt6+HzL&0kcmik
zQHc{0F?2x~-hXNJH2+z`c|Sickkq~Mufs!}3jG&u4*~U+uIug1lo+<)!Ev6GOUB=}
z!i4l;${i=oEQ~oi+*EX7bnyR+tfI(p0u$spR2mUMWW(8JUz=R)#9UT#k&pdGgKHAY
zRduiTy@>{U!V`Ha$^YKx5jmg^)4o>FoTLk)Uw(Rw_G~pxi@r~fmu;1tDk%KHwS|aJ
zUWg+!B~0w^>d`|#paN5n^d&M94z*9iGb}^*ykoYL8tF<?ulUKJaP2yU@@=et=JPrV
z_%clmK|fI(WVElVKmUBq@TX3JYtoR6?ksi3_g@UW=*k#jeNWq@AKj|AA5hKeV7*eY
zIU<!|wnaXju-WvbpwB2ql3{K9zIW)nuLfRY1j)bpZ-{J71e`&*IotC@$UT{2feI%6
zctbH`Q(h&GLQvGJvX2RH>AO*!jqIO;{<?v!WROW>4XQ1g8s6+G1a(>D4214zx+qvC
z2CX`uJaKbVC}Tryr3xb^4cD#Hr%>fCX?qhr+QBy2M@ZR911D4BUTgSp!DeEl=i)ht
z9gUN+dXg#`0u#)Ln*3U<Fpfp5!y!-HP*pYSs4L}SJ!xtBFzx7)DZ*W#{*ufrseJiy
z$1&s~Y~R?|Quy_Hc3&JwMI}0KMY_gtu*@hezyGR0Wal1s^t{6D!t!%SNDROo0+j^~
zG$b<=p|Nz&X{;OyXvgA-<5TA46L^2J6cA0*$V9y@EmWaJYk!>N*DtM6#UgB0Qy;JF
zyHN{ti{oc?o69&D9pqK)Y*sOD0nN>*)f+B4KAsv02}vna7~!$Rb9L3wbUZ)mbZ1K8
zDTx5l1X_PzOe<QLOwVki^4f+RO?Jo5jM2nTRN=n~F_g?lhh}tbP!2o$qB6y>zas2-
zd@F0McT7U8`S3Hfb?Os)04k1t6+;0iUDVGsUYWsU&gymSmW%y4hMlRh1bp@nJp)PX
zMs2<bN=0fV7>=AD#K22ppg`%EMzz=rFJ4A2d0>4kv{cP03DK|3L^_Hx-x6Sv`UH`e
zpZ%gvs@Q9(Tx~_Sb-8k6t7-Gf`6yf;RA}JIu<{zt9;k=WJmL1bcbAftJ$?JI)bU9M
z;FE@cn#g9@gArj<7X$hFxi!o<Au`0As+Z#1MUOE<cwgdEIxyk|>faXvK|;T1)K*^I
zcjExjE9z;SWpv}%wbV%6dxQibNX}{<*(FdkDh-rLHX)~*q+DJ)Z;fPq8c5^i@=Xp_
zCG)w(lvJG_rZdwR(i);8<D#|L%<e>7HLQti5p{X>*Ddvi9TI(W3_{g*N&m9KU9sdg
z`m!1&U`YEq5Wwi`gDL$$MW<cCsNkpP%-Xc7g(^q*5tx#s)6m)R>}*{*)1&K^(W9^z
zse}X;FTBqHT1U$Y)(W?<M*3pfY1W?|c+g*6phM?;E%XcE$~q19n9$6vt*y~&b9Mf1
z>?e`{;&*+z`5#i-#>x-e*46?DJ<UTFnuk>{89x_JY0Cba_~Rp+s#w9e=NFG45hf4D
z;LEdclZhwMCZAGic;lLPmXKZdm7C&7z4Q?eyt15q3sjp?^ShnL0@WBYjy0Mg!%S6X
z6Vkw%XcDw-KhI#^Q^H}DV|%}<GD`b;yh-DhlXgtV)8G-zA$i7EJMBsQ7kMKkKuYBP
z(mzf#bZ!>D!EXvr>%3k;0gzBJet?;mFwL^Fu^9r&6SxFO7v!q^%beGu5P@7#K80e1
zA*Rd8Ix^c%M91h}TAFQ^?ZRm*RSs1Jv^w+66#m<HfD4a+)Vx?=9IN@B6B^<fA0B5J
zuWK5icz7z=_mBo~3AwXHcpS_4#fO;iO|)m8F|c{4JztT3RlbJGm)nnJ+GoeF@N?AO
z@Z`}~XS!tdegi@)xle2Oiq@IpP4t~$e&#u0HciPiO0mWZV}JkTF-#AiYC&vrA0kM3
z>23B-zsy5_pJbUSuTjs2+uGapf-!B|)E|Gre2jMx$1lH_SxQOBBJL-Ym0}9}vc(Vj
z9pbEVY~H}td|Tnjuou<yE*Z*}Y(?>TWsDQ^!Su5<XpTl*cA9!fJB^&l+|IWdS9=!V
z&=_P8$MjzXFM7OM4j4?8k9b_()GO2LW{didGdC43y@rbo-|Q%Yui%K1$*>=JjXzeA
z>R!K|$fh(+fv%^i$y0Qd`PZeuFom2O?nWog%*R_@Fh>^A+mHJie<r7*C`o>&O7d6M
zz~k*1$#ZICDD32FWG~Ke;OpJ-HacQfMprR8U^`V9<%}`{3s+Hm#~UwPo$opW4<r)`
zosa^C7B4^mPXsXZt$Z7iWNR8|GB({si^@g)3hl+&n!rWJ?O(Zoa0(E7mQc}kpL*j)
zUpc#OtX9!kbhKFX3w89o=Z}UCQ2X)HE?eF-Q2cS~@2u!qHix`j-Uf+56efm>m-Z8@
zr;bKfQot=T)cSpFdTr0Y>glnzZ(E(bgHO2f+9P!(WzYsp`(lLm`%ne=DYatm+f>;d
z-8cKrR(Yp)*0oI;+MG6Ll!#okA@bli;`(D1XKZgYYH7Ntd+pBj;(|XHyb&jLFWh+z
zhqLLs73A3$OE=o+WR=cje|h*$qs6m%$QfYrQQ{fS!o|0>GGbfob_ugr_wp_Ub}n=T
z3VTA?)$BVW;3!d223{F~+06JY`E)v+!dW_X6%!Jv2|Gib$2`eso3*Idm>icBkXw*@
zuG_+(T1Yujq<-O=iYQ4Mjieu!oe;P9`(cHD)S*wlIa<jUD_~gC(rz*gk}9pg7p1DX
zlN7BeBtGG#qlDGRTTPFtYAGS`5}5CI$tZFqpg1`_9gp*Z>D6S^C3zwIH?{x?Qs!6U
z;sw<!L#5HAX$#Y2yy)qSP3^44k08jJ!g_ht#>J`Mob987*H+}T7;)JRQGf!Mc)-<|
z4FSN>SO)gno1{o-;F^N?U5qrYhH4SB$5MC=1CvRRLtOrXhyZn8*iB-wvhtMr$@p8b
zi{rA4vO9r!V42kl9YS=G4J5VDOL}xD6?-827Ez3d5yt%pD>Z#(=&Erz)!8(E;SB%e
z)?^BXwX?7l%KpCCPiAQGu2h8n4bXuh1#mc_NG^q|pjP~dB<T+bv6ZU$lWJy)sivB=
zjw7-UL%V=uMcVEEMe(4)r7d3UDO;-YM0_ayiaub7^#BLp5L-b418z7WxDyad-m+MG
z?!4?%XBwSwLqiEp6tyov&g=3qoUi&>D6h7y&E?p;2g{ngR@IC*r${9JfiVvu;({nh
zoG#5}zU9GcwZ4tN)36;1)j7VFdzKx<ruP1kuK4&;AFg~aTPu-ckq&$BusQZEV=0i7
z|L<$ztJ}sXNtzA`EKrSJq&PiNxac{VitRTx<4b$QH1|{><Kr?bA_l~7PbJd{;IoAa
zs2_+|;|(5@b_l=q0iG<|Uy(tH(FIxjYPx*3wsu`RYBW1_lXK8n1w&g|e?KDGiV2Z7
zOpn~sT8Iv4+~^5YwM<Z3n~~B+MI(MO;!KRZ1(4Kn`0!1#&}F~Kw6qd+8fkg?=a(mj
zz~pK9z;9n{wdl}Gc2CvH7_B820PsIR9dBJ0Ou1+RZXvnU(4A(LmS=gR*F|3|owKRd
zJF@q=ofpVg2IvA^AE(<BGL|iOjv7@an2x=hBUuPV*g|+r%DJIU$9)X0f)7A55)QGC
zZQqNr)zW81KYTro&!!Cm)G_}00ZA|-+ePoM>Y<)&G>RPK>5gMqNgk~`PbHNCQ`O42
zKZXDh{ON~1<AGv&AlJ-~&t;j4O3e4RJaio>KV=@vQ<&PRpUQtDQd+khtZY8W4<G<C
z3PpA*UETW3rey2}ncP{WH{0scP>uNk07JGWK^Xf-MfQ|yn~IC4%i?W}o0&dWeEwOC
zDzg{m4R~gt_Am0=kboA@??C;S5*F~d?wNC1V7j|Livd!@swkQ4#y?|=N*ko9<x@8+
zMrQ#+hoK4HP?3pV0xYP;$*FG=UL$ibwH{da>)_T&1H!d}xQl+=#t;3<c@a^7*ZX?7
zmH+&-tQ@dSpy`3hx>E(HOW)hrnbfkH;M|+7w+koG0}A6Sfebm(&7~hiGUE_h#hsOS
z`n^2XJ|&qMalBCKFQ=|g<6S+oFmoNqSFx;Xs(a3c@7YBu#h}(t9590^`k3)s>x+AA
zB`T$6oq4Q!HYa(-s-jnIHu1l4t&v*ac=S(;t^K@kl<tx$vPS8c1wd$fU~6EO`RbD3
zLF8ax=O_x=eC(@dWpTgox<Avt>li~qu$d)N#3QLT9TOjd?<5*VKzZIHg3eFb5r`I3
zT+C<+B+lK>e;d2%ZUVKUTmG-~@uf%$p{Pxj#j_V}%=q`60{HH#zw--u8Dzke*7QDC
zjRH}0DSGj4W~T`!ecJYBkp0h+kM#d#t=)8$sb(u5(A`nvcmSZZ?7X~wKXd`w#JW(b
zx^j!a4T{ROw{%$6tUhn{`sqkAc~|2O(0k?vqhDxaKL_p?X&Hod^}eqQ*KjUMmF;%m
zvl4fKrf$r#%U|*ZPUy>pF^``cv2@CY0Pd_b?8P!2&hSww)1C7fY$K0>*<(mDVr4O{
z%(T?#Xm#qn%`&l9Nv#GT&@e>b<n%U~CP)6rmF??20|#4hyXO*c&9r!Pa&x6;YAl*x
zta}2Uft5V6Fm>!<qv6<f@G@dwGOjR(V%rf%JX-??3s43YcCUn)a=3LHRCkyX;#zo`
zkh@3yLqW!ufvBA9<ba2!vGzQptj`mxJWc(s9Bw>9+na{&6$7Kh>>2nOnJ{4{eqiOH
z95_xWv&0@vz=iIR2}(vZ;R^taW)V7T<4ISb!>mjEV6V_d)fWqRoAzMX^^wK#FTLh9
z$;o&48V{TW@)y$YCIkZB;2~!O2&K71gOFB9549U{G@`zcS>4&Qc6;7Gh6(|n^m7l2
zh|*1}gaj)Z^a)}{v6W!%7NugL??~38s^2l$9v$H=mSk{*s<_m%?3JCFHQ8#F4VOHs
zH7=<y3PAFp=P%y0$Hdaha`QcoW?O)zI<5^99tjUT?oEL8D4Ni!fG1)xM}L|3OQk0@
z8g&aXPif?bwGBuC{u4lZ#euVKy<bAp%zEw|kkhYL@jvG&gTj8O8Kp_KW<r<?HB>AG
z%d**|r#s`KiKYV?Um>~IyOnCne~Zx8$n@h=y1}Q@&4y$~w$cHN{EM$YFR&xXF|Y%a
z7^-TORMh0gTGo)ZCg27DX1Tli2EX<kKdJdn$7oGJ9w}oFUe;$M>od?8X<}wE83!Q}
z*0=v;dwi0MeY_tn@|5mnh!l84PJeLe*{Ic(MKq4O3U9n%iAmVzllJKwN*D!YdJrCv
zM<N}E1k?QJE8>bx*crD?JEN!W`K^j2q61l%030qN9HSS%TldZJNVrpuv8Et*%Rr}R
zY9}ovsW4n@^P@t;h%_$wIpNKoayAf!*lvER(5dq=GxqliN5QJFUPsm|bd?cOcYllM
zvoroqzJ|>p&VW40iw=1WN&nj}NI4+PMar_4mP*2wUg{;Wu}LqIWs^_<=B@y4d2#vX
z`p%`X#?q@{9)g@M@cE@LFF?@uMK4o;pDu>ZI=wM1h*A>09-ODZ+c$U&AKGA&gGB0>
z$%t4)GXW|t^=9Se_pf>0)G;j&%+h)De4Be~h808)rkF{H*+Z-}JXJ^hS~y?Kh~$s$
z6QdTd+ke+Tm;Q*r;-BRFe44jh!T6K{1~>i=t!p_N#(^an6cROMSxEZr{xu^BGcQpX
z^sVuumAvin*xbIa<TXe@<y{e@!%kPqUwgOylLmP7%A$uL5~hMdtHmfk-&FsVkKZc&
zw(`nZWjra4(#M)K($hVKFL%<mELWR>Uu{F9bdC6F7#5rnQ0V~|)<gdYb@P=4bi17B
zY54Q@q6cr-vT~-2X^?OTeBwUcM|P{vQdlrJ#?L4;D!ezKeTAcGAo{jzR|<17qxdP3
zC=VRt)YW26PEKQGsGxId{87~We6ijV=G!W_FMPG@NcAo2*rS?EMZGXEf)tRq5gIkr
ze2iIS*8SX6YtfowIkm@_$#HW1mys}I>Ng^wdFuI@<A$b|GY6O4d1uquSq`)9pTU9Q
zfE^B3e2@p81zHz-8TutL9S{izI9E_2>0^Q&!AZaI**?r+XgD6KyPOXs<d}_AnMkx>
zBR<+MsgF@5@LU@e1|c>Db{PwcU?Jzq!sU^^HM_w!C6G)juN+ZkxREZtCRDO22Ebgn
zujaSl0I}91Fl`{R<K8qC&_Tw;7&wpsxS2?({@`V;WhrUQbCSpaFA|1qC04CRcj3i2
z=Oz;~irWKU{U!SH7i2>{m=kLLDDwc!n;!lNYGhRvhm@pbB=R$QNona|N*WrOEb*{x
zy%tZ~OI8nrK!+iNCCLnLsEQObdD;A1A>wP3+G5!u+6<K>R3uS!9|sAwer$&89)K+8
z*sbl4DBDa{DI(#}jnAG$UI7iHIbtEtv9baec%1ebfhMb1AQ!W}Fzj2Z*P{DjAd&1b
zjsuZPvP84`I1)txNR3!y`E;pbtzDTbWpAA7ux;$C_<V>3u52q8+`t)8qhrvi^bX5L
zoaxdHqzlM~k^=(x|Cz1`dI$92jONM_Ch@scqT;jtFd*6of<+J`SpAExtib(AP^gYQ
z>`UEOSwq$EYBC>Ej7!HMu#3UiYnSYEMeZ!a4${?DN~u;}xb6a^cxD~?xdw+5diSq|
zKquK~mIQhduT$wo@(C2+V?QwQY*jU`U`!KNH#OLp>Rf6;5aj6AJl@>?)xj7;>t-7q
z0Te98vE!6S-SB@o2@f@E01W_2>$CKuzkHD`RKNabn>2LqVuZN&wbVmK)L3P)ln_>8
z<(1Ku`_xAOP>6ENF_i(<8X)wj-2eY(Bc`!DfzZ$9u&t8BZXB+k_~p^fH9)nMTj~aM
zJw>VA?O@jh&tmW%(Jq<wXkYZ_o%95YZm#}E8W=4mjfn<au1B#kjF2nds6So`XfDkG
zOe{LhV_V4`IG<=B8PH3Wpsi%0pY#$~{1PS}km1#Asgj!>XCSH~_W0-j0-!cl`^uZt
zZjQ80#0-&7<zvp86rg&!ZB>4Jl!UkQJCIzvuisWw;PJOiqJeH(bCiqFP}JX5rZKRc
zq@*M|pl36_P_@V`K{jf^zL*Sfid<ko%IjSz>Fc2&Ifw@WxGDp6r*lZ(9VNyQ<f+k%
z$ah6IGMt>V^9*~KpF=)}T=IPLT~cU`0_V3OlVn(bgFK}FCHcp2cLBP-&nES7y$w=Q
zN%6AY{eH%&X%x{M>)V@rs&X2@lj&Z0b1=9S*cZ5}kK5{Zb^u~?Xry-}!0^i`DnuzU
z!XaPG6UfWly%Z;Rf1-9TSIAOg0IqOu^YgO{$&}zUTK6Y$9N0rBf7c8MunZ2^Ns{s)
zsi+lE^4n^dy1XrkK5g5JgY0y(N5VKTez|}2<7?g~tFP$W8!dEiG|6Y%*<^jhT|mLX
zJO0p4Dj#9$;c6+QtG61REk`S4^(SD>yXUrctTz}KZ`};zzMQzsm|paX(Uk~CQhX!z
zX+^rE@_y`*WOLko3kc02t%u$GkNw#DjlSoE;hXR7_AQ=K8h#`iQAlL<VIV^&p-N;$
zdhG{_-+S>}K&;fo;*<89+I$rj!h=xXZ?Tk-h+u}NOfef%sIda3@T;?Ixa(vHUmg{Y
zMP<-jlgl@4hY284mk0C|DHW<LnPG%dTsQ9bd9ZQ582OY7{}LC=8tgOH_oLqfmrCX#
z;-bfGjvm=x=?PX42UrIEws_LPOY?eynA|wd49j%Fz=J&0TLI1<NNP^^^155a(<xu>
zFaUWU|1+4{Cy21<;`xb8A59;<=XP|5E#R$1Vi~@X`3z%R+AK^R9|yiUcAmpjsujHh
z`ir`?f%<`sG4sI)!F$?`G$&nRJ81ft<@c)(zw7Pt9ADrI<RC{xU*Z6jJ)_?_JA?oV
z%JUUHBD_N>(t8Zr3NlssWNSN@!n;~IEr#$!8kG_Q3G#gJUb}4PeswD=N4$b3yZ}p$
z9q6(x={|1nBo{HnK6F8}{9T!Ix-}+oe|w@(peG3E7(im+e#WXL4yZ&JG%g|$^we&d
zxD4%q0^a|fNQPs*bA6-6|3}qVhDFtWU&BauBVE#6(%s!DjVK|FNOvP4($XOyDbn33
zozk7sE%m?W`Cada_p6u8oH^${JJw!nZAPNgL2}P#yWT2BLR3kJC++For~#MjBA#c{
zibsj&Wlam67Q-&D&7^b=)!PVFh$#GcLBXreD!$~}ma{&R+Shoht4F#1&rjFcRErp4
zH2;837&*kjbR9@Wz5+e?T~yyD^!sFU^e!~d{|x2-hw7b`;h5_R5`@D&&~w<`3voH_
z%5hzOM%JX_oO#A2!*K;r^W;xUxxl0Ti!rfECG>5za162npkO}-dS$sR&mAHGAiFj}
z#t!S(&m!3se!QI01Z|Y>=-^j+_<j@5ZTvvvVWRgLRB<BLsYc#MwQM+I&kw(ZA5OcW
zWj>=`MTU{re&IRbDQ%^C-S&|<?g<0pfn#RhS2a<_IV0B?X7nu)FeywE^=%^McM^AK
zK6)KD9NMfJagLr1**j@}t}qXp0-b~K21+dqirgho=%fGzsi{!m*wE1Ac2J-;;G3AS
z-U1esd?Zewm{E>#Z@*r{&5HL$Vq2w~Ct!C_Ho$F6S7(gXu`-LS{9$CBQTK6~$Y7uD
z9LX&CD&C3Z0g#y>&+K5^m?Y0B!T}(FMWr(r)9Spa19T}bd`U4iWPW0}PLPoY0Uf6z
zbQG1nMV<1}yZ{G63-Jja%Mj3F?-T)pSpoOIsh3BKde?vd&_FexvD_Y~W<;D8A;SOm
z@+WI-w1BICT7g!P>OcOL1Mz^?e+Q-8ORi%xG&!li0C~(w0a#23xbE!n$i|VgLQ^*o
zv6?`qyg>FbX(hQL8xNG-?>~xSNtWuAeh=Ldd%BfUcR;{|n<iD0gRebqE}ZqQ*WNV5
z6uFEqTnQ)xD&~GK5GcwCO?@Ub9XXP5B+CzGO5cEv8`*F<(aEl)z9gq`ECiI|K}u_b
z0^Vh?6ek!Cbjq1<LE>xWG3<tzkIvsda=5l%?R;}IJeV+H$Of+(zgq2L^QTHS$1l_}
zEZdrAiDNQ^##@Sf+}u-wyBV%!vN6O4(S+=EfELC|>(dmw>fBG3d~R!AViQ#1o9%m@
zrfO=#%UXC=lV~Sv2mCE6Hs{r8nv;p4|Dd2mB)oqM)wVOoPFfg(C*59HlRo?Oc+Xn9
zRbLpQGw1w)0d`3<UBA_FuEIE(n5+)eAiGh)UQDcIg|a%v_mZ^}z{W$Vu^dgu-E*kF
z2w|G-m*mIt5J3eMm87PRhqi|v_h;%KK*V8S;Ksy>@PX)4?Vm?3Zq1GKZ)eyld@(hj
z9Y2Gc)-o|!<k6iaH7MEfiT%1Eqi9Q$g-Gs^qt26)nx2yFw4J0Eh4WfXArIIqRQM{&
z<D>aX2_dJ%_p$ZjOW1et-vN&Uw<F1xJelZ&b+>}T5dFrh**C`hKPSrH@M#P&8vx@E
zQ9`YQoQb19zlv%cS552$bC0A0o}JN3q`ZOoLHmL4ZMZP!Qfvui+|8nR)mqA#v~Lmc
zv<UPcxib_y*kRp3;o<_~-cX9E-@YPjOlVk;p<tru)n3HP3>=hEHGmkH5c!j<_#=_$
z<y7nWpXCxwY4j10mKtyd>HtM4Y}ab>Y=rCfl2eoCn1Un(cq5>OWo5o(YkzRjph**r
zuBh=e9M9slOJ*qFV&p;$YhIS>jlzd_<yFhz&)r-MHSE!$Dfx$|ybmOPSw6tsWU^F`
z-E-@U++~qOFanqDGy|*nk1u*;gjy%U@T8`#UbUidLO9;VnuRFv>OxqH?q&9in{>LO
zT_GkgeGlQ4?N5ePT$5UAB897p9AEenJNff&lIY1M?x}mA(anC0g)K>`chF9Z^c5No
z(i;eUISWy{L-Ak1pHf*rgcfLh!t4W48_Z6Te}vuF=3?(ScVP{ZV~`79{nP1QU7&*!
zHgg1YyZ5fOE=e{1790HfzOo7ia0UQjE7SieIkp_~_XVLws-^9cy5GeJpH~~h&gTWO
zsvSN^d2`(bAhQXaZ^!u~-%baN0*YH{a;`}qNg%R5K61L6wK!)ZpLSsEo|H`bT|B@v
zUM_qutI-;EtJCVTo|zPNjGTZCtwkdNJwqDTyCbZ@8m_I#rZFX-50dkVta$K&RewP3
zDWZ+Z>~1ZU3&X8@#_)n*C=fgOO!>v84N{@)O7XD%ZE0m&!eK@8sLtDmu-xiuqAyUZ
zk2jUzg;_KtL5bP3N-_Q({y5X3o`O0A*cYg9I=E(Aa8`5R?|u})nu&#If5n7b&G!4J
zz@%Mlrn+9A8Bm#)uUP9?(nv_2&xpz?;;e^0;Vn#FmZ@0oP%@fJPgB~o$2H%cgx^vq
zC{tBEw?B!*SnQF;58R77{M-IGUU|@q6nJuR<DAN@ff8<ZT<5WTS69s3D(m+p{xWBO
z40eKxw4+L<;LN6+4b4YiGySq92}9e6H_y7sJOBPXKi;e!u5w6rU6?jXO@_(G%T1#w
z8p;O1;s&MT{)qYN9E)RJ9w+*5KvVZ&!J4Q)DS1*;GVdcW0(k>wr1bzmd{?sWZm(Tq
z*^ePTfgq>&?MF<e#uF%I4QQ2;Yo-~hL}UGjib@K3ek8kWzhxXLDg4fMP(6V(7|PI(
zpgq+X2KbZ)RoaU+HdBmeCjO5fm&Ff8HWMv#=W}=5^|56C^P6Z?949cf<#J-Et^)>9
zaNOKff$>-a14DIe-p<iif1+rp2IJD=1K1(`)v<=bx|g+mWkeQMR`2hkj*B;CVQQIU
zm+H-HE56^`m}@mkyUbup(z0x*i9Nb0H5ye@1~A1G7NUjM@Cvi6P&qO2DOb3f<yN3Y
zxfxcahF6t*$7_nU-0a2_t4VBr#d?y%a$5Jo&I@;Xyr~c^#i&1tvkv$NeKK&rL)>m$
z4<li*f+-vhx=cL#N)V<ZnETH?2;T?IjA7p7#q@lYNB9B>lOw-VZ-Gg1+DYRsd8;mS
zSw|OD$0tJVQ}t3rp<+IYqXONJ9cJ%)FF{_A6kpp_=`S4ny?kz!J)|kzxqEqwl^9_l
z%^a9dA2)D1^P<2-lXpMqI-;kqO3dpJl_S0{UWjzCo7lMVBaU#k2>dOQ4zWs!Mt)dP
zw-?1*^4}*R^%QEbu2SX=A-Ud;2=fDox);X?3R#n=v!cpksi39H3d1TBKL1uRW`h3y
z*TIN*GZX*)-(R(MFSaq2gu+A31f4f}9+IinE;x%Iqc*@&rC_Xg>#ZAterpn&v0>sE
z2P-9F28SAme-VZd6*Z*<K$#ibV|OKHmS)A$ZBa)e9Tj{fr7QAkCVD1e#paRG2Voq=
z$>>DoR+`IcB=Os6B!9eT3vxDpEdI+cVSMYj&hcvIDA^3bxIw1e$L3COG_R2SnDr{~
zSjLc_^=z|b1`d(z_!AM^YOy#xU;5Qk9(Bt=R{Wsd?<xED9czzEPJ(kuZYeMelEd<7
z(IK+owfW{|t1n4hAe-_toQ9a83$=uFczCMxpF;PRYr&gZZ|au1GLstIQ-%P^@enJ*
zu$1+tjwvjm>G_CYn0lmK6x&{!^2ZQfVo2G>>37&pJPbSR<K`35R#JMFX<>oJ8NkJa
zPCb_XV?)H5n8=dfyT$pq$<Y@2Mma}!X1~HB{cj|&mV`NQXT_HM?Z*mshB7sW4$H6o
z<77riDbW|5bEW{%n<ZDnUr5i{^P{XGnlO)G7ywt1svHoolq-dpa%yu;6Kj}0^{~YU
zo!8&W<bat5m;JtZ+W9cm{%lR6=`IHj@>Y09+iwvl7o@TH1M|L7p`2erRFiAW^GI>2
z2b}i&CaF4_Rd?EtYA#n+n$Xo1(cCQ<O9tz=BP3&mDJD$gVHU_NxMq5VWpg#1iGTY4
zqivt2bo@HfgrZz;ch~(-n4hwSJzilU1&R<gzg>&+F0^WVjVJm7w!a~keoX_Wb`E9M
z2&$Anak1Z=2l?2jUFv7xOezP()x*VD3MduTs<?16`Ycoow+R#z7a3YzaM8X()x_#}
zk)Gg}NxuvPRLkvISEYgYu^U<a5&cXj>Z<!5RZo{~Ul*OwSQmTSIVUDV{S>Q<osorf
zkuuc5uDe&Ded-lf+g_WolzfR1j)0?N63PTXZ)0{u!*)O4Mqu1g0Af$jOgaI(N!eU!
zJ1FzvGjR<y^t-wLBNCV(EqQC$-1#0N-+3MVY{?h}eWo5nNbN&PAoEF59e!ns9n*5E
z-IBa8QcCO)-+OT#t*3$7{%=#NLMm%XMU;~6?sdxPJcGPH(zAIsH#WAw{Tx!m(fC-=
zFOc(cMHfR4-Y%61v7-9j2yr8*MO_0rIrvyM)~h?pzNXViV)=JKo`Dn27i3(z2*X<O
z`>mj{@}VSVB{12zoDQUXH&y@wL|%Zn=9ia5xnUa=k8YK}Pm-7v&O}$|@&iyx^|9dG
zNmrSIb+3|COX}tA3LoE|#=(4!onewOM7ElBx;ark`N?66lD!k}`BGA;BOeBZ54@_d
z<uV~w0uRQWH%TI96tmJtK#)=KRP}ck@3PL2K<QLNDU`r%Qu)6FULZ4)=i*Q+%}e3d
zF6=C0fI}7NgFEl%^NWk$OWdK@<y#HYD%<M5j21-y144c_{Qfcmv3gh+)!J2(NqHpG
zuXiH}z|bqwP*Krwv;M9_;1RTO<;!IFsuO9<&@&B}-JzwI`~@?a?929|8k`vS4%P%*
z9r<GMj?W4^Kw+c1iry%7$G&K5UYEtDNxLonxF*BeT4L#bFs;BIl|LIYr&t8gnuAB%
z5s#yr<_~|WHH%cqJRi>bjdxR7IE=BTE~@ln3{#9T8>LQrv|9sTARbs_*-}kWn$f<p
zmRWad^SL`;sDSH!zRsETA{<a~dJ(zrXRF|JZ|-m}(UFfZ?MI$5vb*C%o_v-|9#o$a
zw+PClS6Iprt0c#9`U(b`N3j(eiq$kG=bxA8#L6pQ(yzZ;9&Ya^VJg&59e;_|s$dwm
z&6=;$sg4W3hG(qv&`>Db@oXGw(RSFMEX<qzNC*Np)*ZMl(4k{(0HOq56i01abKO}$
zQ5FI^@t#dUyc$Qg8*nD`N^?R=#KI_2&HND!tCx@}8S!Nj6s88rEC$rR_t*Gkdq^ZW
zEQZ04fcP?fp~%@<1>`PX2UOR*fDpsHfkillL3Ls#p!(ai*R2=GB9y$mn%prJ>}}0h
zPqbiUTsY1H)l|xU*)EZ---Bxjs>d!vAN!B>|3wjonPx=WaD2{RnBfzjQtY&CwTT3E
z)%qSWQPTl-<5A81R#)OM3QtO~=_A7%gjm*bo=26kf4B679$&d1V~)AWc@kIs?#t~A
zR{?yv1$yDRboDY1ejsIGy}a6+kSdyKbba6Ym-cf!=SM79Vx_<SpvJ8^y#<bS*12b(
zm;Ew7uU|gWqb~ZEIOEe<FQFYQp6mz^)XZhMRdrEs)Y~uW79qnD>`PLT17A9`FC<96
z4`<7#(ha495D08IZq+)9V1R4`;2DQkI-EBUM_LcdTW}q<r;!NeAd^uB%F}b?*&Ep0
zEMVAZRi<h)<5KL;SUsXdbTrYFTJ0Uk6@WQL>yQR4?V%#wPgxzt*;BVc(J$)@gi$f`
z7BaNCioK8#l<v)I-dWB94BC`>7`}KcN~*Y2b--?8wT9wJhA^Qy5$oPa*>oKT%UN-M
z;!dFTxSbr8(-UY%Dx|8K!aJe@cycv*d0=rJ8rBhrxrko+`Q77*pS_0Eo&%t-_8K<^
zD)o5$J`PA7j|gk;O+No8W{RbS$-T%zRVuL(yctS-gL2(@sL#OSQ2__~E5>fUn-mk9
z$L$s_R+pG>bHR}_rSc0sot`2hWuw79=9uHQUL>=9NGvUvFPri1J?Hy4ghxYRzNM$T
z{s;isdDnb^+~nh$-I7Q_Vd1{9Jnn*_cSKy=oT28usKc)6+NvIe{cJ6S99;ttHy(8Z
z!g`txtvf(_G6;%dub~iAb_M7E5*UAaM<!unf{2{jQ1~#0P!l<e&nfbQuSY0>=t;?$
z^?1nG+8lL_z!u%hrj!Efi9D})GStxy>w(AMTo-E*s%G(=8pPkr!XBqNzA1LiZu^rE
z30wz;<*5hI%ee`&JV#n}EWg;`{@=4^=D1zpfi1-#;;rEnT>vPa!0-Q3TZBG@L!8)C
zB?|4)BKxmS5W@>(59+FeQx~GA8<@uWzD*a0{hh2lCsR>mas5zX2)gx8i(aE_G9mW?
z6~5(yB2;SBp3V$a@0Y-UtuD3SHdc0zH(ghmH-rGM>$?JB7aLkij+0b?IZoI*sGPPG
z3C^f$xc<AOg)#$f)_u!Kc9xYh5~<Tv(g%<o?UJ}x2%wO%JS8y_kGx8vDth$r)Wx-o
z)JKDU800ek8fDps$A-)Dy8<3YUx|SC++LJ$W~`X-2HB#%mpl^sCEW?+S_mVG3c$E5
zWlZ#5ncVkM<EZCpn7w@(LB6Ui+zc6=u?tvC=CJ-Xzr)xjhEr__4cdN;r;^%=;aeG3
z@~1f-;ae>`vVdA!`jXmoDP~h~0C-IOwxNso5Fj)&c9j+@^ecG4g`<E3KE`T=5;C0r
z6Qm|64FSqBeQ4Ql@cDI|%FW!Ni5S{p8t#_@1v?S#&=dLwRe}=`aUWA)%9iO>GZ;?V
z?klD%jNhd5*yJ5)<-F?7P=?bV>&_O~&?(WBVQc=&WiJjVmW_1!j2uIk_yKCqRQE1i
zP0d;kQ1Hu>J^($^PtjEtui(3E3g62wS*B5*r5wNeHbnGezI6ISIEQwVw$<EjTe}2{
zZq1Hg5F?H1q1p<t_zz*JIx8l#FtWFt20`6G*R@%a!E~8Y8m>zA!7}^!3w$fHYuYFl
zC+6;lWD0FR<~fW6zuGYQU`_a6s-FCFd>KOsoCxIJlxUKr`;6kwVYwe0l)8k~z>z^%
zP%nG3hRFJ^zr%^*cZ3xcr@}OA5Y2!jhG6xakyWglPS)Xc%}nyG`dBV*dgA(3V;#3Y
z`;B2YfVmT3>m_#d)>bLMPcZy`5#X*(kvsFY_JOkM?^@+~S9<4U`>49WueZ0Nr;o)^
zH2G$D1Q>r^Q90y?RLpl27<k>;8Ve5{(6iqdkq;|?{QeL4rtRP12;_S`%fL<xk&uIN
zP=paA*f8ab?$<hnaD?7M30ui6-9+9CMYH|DY^%QuMcWgC-GwHDzgqe>p<yrsPIweH
z^v#Rn%*V$q<%IVCj;0{eo|WL6q%W}9#X1|+kLe?LWM+8<$pC#W2p#J`jLkVEqO~8j
zB_M^3gIIUcjzMSi@|4xcMsxCa@~TmwNq;&_pslw1y%5+j28QOyhhf7Vpf_K}xk83M
z25|^^_}Y<8hd;p*;T8eM+yAAV3B@&mZIYTtyT$DT?kELlk6$_w#b|Nx*u5fi4%iTh
zrvjR`1eGM5R~9nzl!<UYw&J+BxK~`d`mlpOQH1OjtfOtuPu_9EI-%8&-_g+9jq**L
zm)31%xhxSa<5y8tbk{?$^4g*Z>Q-%x<#x%GDflICXO%^(k#Bu;!nyTs=Up(Jyq#8k
zZw7%vatZV7zd$BU7TBB!^KYF(ZtJU9oP6`Y-u#NE3H5cEX0ep|`j%H}Gu{%a%!V|?
zKS&b=yBfV4UA9#fNRs!ev;n4;X>vf4d^kb6cIpRg&8p2hgCcrBC3~f7*C5iN2yuFf
z+AjHR3t8E46@ykt(p-VmwrQj97YpSp_nWs87Gw(FTDXY`)0CGJ{{5%DvidI!O~5xp
zn=!q4I9tBdyXqh~)E;VEt9O1nB>)nv=fC};E5jqpzR%8No3dNj1HWKU@SHll&bJhR
z-6)u&4jht{VS{m00NiLvI)mOcE7KVJJUw7=;;jAoOkM%EbCki#U9Xl*b=9X}t2yJu
z`h9aqr{2N15zItf6G@b8>Z~UuSAb6%AZ@%*>3KZ8i;Cq-00qYGZH^Yy=yeh_GbI4O
zGFf5T7^sqj7EoX&@`8<>##N8(>uO!rK=&VE+9jml3fYVlAF`>{=Dvxqb4$kr&v;ki
zz0=iAW|k}KjV*lr^I+U_H<MnUd`iTO=Xz3!eTJFZ-2NKOM;r6R4PJw3jR4Ta7~A;V
zu7_7_stKQkm~1ZBZa$M>MI43Aw++FrdjjNm5`<w9$<H76uz^UjBIR$7qB1b2#V)hV
zPD{IcHj-v{#uzyP?wEy{2bjb>@+Yn`5k2TEy=iZ5f$e2^NJxm5sBI`rDH!n0f?CE!
zNW>zpgb{I;xv~Z4=apqIIAiCkYx!arZ^}&<Y^|7fbI?X<PbaQFm9Mm~S|16wbvGs<
zbteGnC5b99+59b7=mvDewNSLE#Hzx$AAq}7B~~5fB#tc;=>o3b3klkPPV<N#0=ke>
zuP4CFSZhCjFN9NQZ3i`<F3=IPY=v?-t%>`RuG*4)$`l<s1q7`9O(><zN>h>Vk>q)r
zp>p&F^cfTP4~*f42~(POqi=wHa_+~g8ND~QRtk0iaZEO(p4NoaT!A{|jjb`T`pnZ!
zVKX-JL?;u}?k5uQs^PU?;87|Ua%7}&QYtq-iNYO_1;bL-Dzx3T8^hCeCLiX8Ji%0x
zd~!#ETofZzQSE{>Ol1DA9pze6+j;2<LxQ4z((ohBHT|pXqga+6(}>+Em>H3`yOaB%
z=_0q3JQ<Cdrof7Y_>FRwz@}J&ZkcY!9Wk(GA!RgI$&RaC0Mqs#=-+-i0(WP_H<65f
zfNq)+OC}VBLtyN=?9`2(2ghOn;Lq7aCUY%d2h9vpVOgx}!>w~CmYA+>3)H{Yd1|dQ
zxOQja6_kT+(BPCiic73nc2@zXZND1C|CLT90l?sg`(fj{|CkU*15+rs?m=Y{#hG^i
zMCGH1S4xVCk~~l~xtUn9Xr*E8kI{Qz`s>7MANz3+IxwhhWw6ZYM7Ha^Ck?9CBW9+7
zodpx?qh_hL7+F$adkxB`$jQ+tuQv&aiFgWtx+s1!SD8&J>chXaZ4m~2EzFS6+MCK+
zZjU7XR6nnpOS^tvT~{$%nB}vY$nsR|Af}k@dheliX)LJUDs|iCbpQ~$xuBd$t|7p*
zD-2aDfT6;bv<8gyT6M%u3<|VDDEMax3r~e7b&a*B9FSA*yeZ47OpT5d|1!Bg95C|+
z!7Y3XY_JVELL?F=Lz?o;$Pa4gOqdl*_w@vRM?y`lm2P`PmEjw1H=?(J?WNlctP3jK
zG|1zsKva%tuNK^*+#z@gQ1jPfH0O)#GzCE7uK>ng+tKW8P9uX1rfn_4*YlP^Rzgxl
z<GCFD5Z&9o4<5lm|I=ZV3URKmB&M4*vlZ(wpVt3UpAGi}j6-R<KwGPgTF_yMEiyZ<
z7*TOC69v}(^BN=MvRr)YSu)|qh)eMl_V#`9hgT;V_n|azAdvMJn8G>37=_qq2|!fv
zJydkl0MVTR37`*^Pwvm*oAIbvYo$x%l!TPx4ZZGwQg{?zdm2rqZrhm!kOBv6-Yr&n
zT+#9NyB!kyq&WWh@c1_ZpY0f}*;M$wE{ny(fTMHrQ|jXmiIv_I>ZO{s*%55InYAPh
zFPMJ<A;9G~#1*<6gAaf;=pZkDr2bxN&wD5By=32eK*>w^&XawyJ2pqwqt(|Pj+ye>
zeqms1aLCqq0834y;lEBhNEK#u|2^v}o9mMxwO+QuYK{bA))<<o(zCkglBf>dYai1g
zx{QM&uI#~!OCu!lwUEA_pvE?AtnoOr5a~izp@f7;yrgPG9H6_uIhkwDWvoTb#afAH
zla=Q*#yqRChkS=nihl`p0t^J}Ts#z(&lQpr2x*9&*)Dq#2ifV-wy$MI9;X*{8ZtC5
zgpKb<WPN;Eet+XrdzSVDPP$Z+axT6Yo%s{%4#=)pvY%h(lDu$atO^Qux&eVWbXpVj
zhg<Q;nfnH7j)eE+UhZzZM|Agp8eFUokTYjaF3?*MJ=}>3xKRtu|KWV}!Mb(1F-oho
z{DG!*K|D<R#0<AZqmV^R3CoZ|S?~y^?LoO7A;5lH%D=msRBC-EAMIlS;F)?^gAu9P
zT+~lc32OB7K2w%bVuT%HFQuUOJ0cYi5W-4r3~|W6`PnT=?kX4KJ_&xE^wN{W1<DZ<
zPtNzhw|(Pcll?V)V5W8Wi_$R-Ch)E(+m8!+bc<l38u2||IO!P&Bdm48SPv(&QUy-|
z-CF0jFO@KXf0P}r@l*PtWiO>Z$dt*iQf3&LXb7M33z2n2mHAHKs_O2iN7#pRruyaY
zdNR6mJk^rk?}WnW>W6&C4PpozU9U!(I$C>@H;6l=vQb71amL<>lOzhIa<rmicPfOF
zq6K?RVo2zRl;X0OkYG=KlvYe$Nci8bBL<3~!WmjQSHNp?YsZ~iyd<Y-!9p-EcpD_P
z&EdS<zV3qj5o!&e<=Eu1tr+M{|68Qj_G`RO)d4nI7G=Ce=wS0n+nX_>k7~?$e)n7x
zdTpgFyp^4rIjWIAc5L+zM%EJ_JC|~a<(iq)GY7o@^3OV>Q3kLB16!`@!WBQ3!mj!?
zKiK1!(~BzOQF$xrdtr>$ZfP9I(gcBza=*%4<s7S%9Yn|t@S_73SpGZ*e_TwkE4z}L
zl@_<p&<I^x;>bl%ym-%OU*K*TvTAF+ph=VcudxD-Lkazt9iO7DA1%gV&i5CFij3cv
z>8N5SxeSL+iUdBCc&5%?&6!qC=|GCyuL?e=8TTKN3=tL;vivz}zN{157H=C$e@t{;
z_d-5q)_C3U))vqR3VB*9Jcc5MG?O3yy&OX1Q?-r#;MQ!u(B|6=2Eig;{3N<Y9?=0q
z#6KKpVH5$BQUm8$aK7l!tTOhEqdoYn6+m_SU|gtM)crBoJD`uik#tC{<USX2ufnGc
zAC`dp1yJ%*3uhz!@9tlm4`!C&6eS<MW$=MGne(`ed_C9C1l)-pvF@5sQ>Nq&64?2I
z4l^XF9ryA=5z(@B?A@9v)u{{qqyDOx&6iIV0JOiSYWKg_!cdE3w9)d$?po6Pjedov
zF8bT*BcJ>^9$&q$s#EvY6z1M;wm;ix{kCJk0kAar_ar-}C+r3({$ZYpK!}=32b0v|
zo8a8WHL(2_C8x1to$5bfQIo1diqeeW*(YQ5p-tywG_pWmIo+YEna4uY^3KVe>5@Ly
zTxMif>cAlSH8|KyQ!Q5Zt8fY?`OWp0W`ziRN~h0}kzKh!5)&(|PX}6qQ#zQ{9I};p
zD!ptC<sYx^TOPwcS&<qwsmRR@f<eXB3UQpqt(%ij_1-Am+7!~Di3ooV)Q24&*IESK
zcX1QJ^;_&-utJIrP*}o6i(gfr8Qu$6AFr5Mb-MXt0aP(sxV0&JNu#wgL#rt*ZeAF0
z_pw+Yeyu^3Z|YT{{`jmu=|LSaFgxa5QNI_B&~WQ1+ks|;(uRu_T%I~^fa7?n$qJpT
z9(hvf0Y2)-YmLm+V_cwZ`hmE;!}Mt=)QUaYmY_@+8Sgc0HiTivzye*DU%K}^WynQI
z$lwtaKUe9cFA>81$JOBhkp<so2W&>cLW3;uSvTVWrA)mEbDM{x_zR6r22JgPMlsh)
zG~KRUUVO*+;o<t2D8XL|udqhpd{A=qoskX`H-hm|l&xpW(q?@mUl1$8;>GU$WGNPl
z-J@4d?MRAO4hD*AdCCt+JR+<LY$Zvr^4pi#)oR&DUT;TD2ayg6zEZ0^pl2O6rnP5&
zY&P*In4Pn^>Z)l1qCC{uu=l{qN7S@+J>m(R>k%p+VqtxIYtT<DbpH55_}39!{cH2@
zfUS&$0*R|<qM=|FI~Thig^2(75xx0*bZpYp+$<p}fsD-|jtx(%tu4(W{tB-bh87PC
z8NZ;Qxf#B|J1~^B&imc!r?K8Yj@~I&pLSaRxL%#Dw6xrOdjIa(^;l$gZPlBx&%-Fv
zS2j;nB5Dl5VdT_kZJ0JWc!5|ozZ5SuQ`1QElGsp7+>>~F+BUaG7!PSxogvi+&?C{<
zB_>=4tW)%;Hi?PG6eS1eAd1-k1`p&h<S%yy^k*wg*;~gb_)K*Aym#tVY^vo$G`-Y^
zG{sF$@!TUdtu;)%PzEo7XPG5XcygKg_}y%7DhD8Qz-nQgI@NT^k%^q1g&~!BE>k2^
zTT!Is(Z(kvv$QTV3+QwYTZIuEjodlJ$pmmctM_#Q(|<y+=|fIg`SU}w%AWxF0WeCv
z`g!aa6+Orvw&9WB92<p1H%3H68=3Jus28C5k`Bis@$~_y43j+#7-R4YOY)3PLACjz
z0#?V>Z)@|YFwrp4Bw8>%Y{T`uuSon7AQv*t?nmTz=C5iLoObox1j(cc!X8xrcgcZ9
z$d~0OpSO!Pt8P755MHm(=QIW}^}rgZW0;!WDHqIMcE`J%5N=@jC^%zB#KiOhiUo(m
z5<gU$uphU-(ke7C;Q`2All>uRN`_1Ya$JH|UuD-5gaUoM=VoT`0dYWe%s_GCp7D5x
zdrbJnmmi8d??xW4dtD0vv10zGW%xrOm8MhBc~?U3*ASXVm%O>qksxU;jGfWUZzqz0
zC;NmXgmfKnsU4eGspmC>e)G67@%qb~OJS8G;*=^1-8Xae9etAoG}2{bpYtfYZCY%o
zA&J-#J;cZpWikb0iA_OadnKRAgb1X<&<5Rz4ODGxbL3+fZzzP^m5DQ~BffEwYRJlV
zb9RSbe#&GiPYjhWXy^eJMrh$%=`JH$7+y_sprS1lAN7C`)jR=ilfXIC<kx&)dXpBm
z$jJ8yB%VM0pZyH@hNu}QlZM}0wO|UkO<fFD>46><6fo?Y>mL@W$poRcN}Cy4qFzJi
z^8dP76uqb?eO_;DZsKFV&`uNauA}zL9B4VbGqOnR-cTuv@GMr8mJZR#dhda>8^jmC
z#*1qPiBnqpmic9<YCAX1o21PIE2kY<%;Z~{kMo%?txR^8vbJK*`>`x8N1<&YQ@}o<
z4l#)3#n(DY1ajy1f^{G{r)gzAT~B?K#A2dWX{ZK^RII=nlBiUIVz;9O-bdm|mf6|a
zAyAO~fG&@L%6X|j+o5b16mfy>%OC~h0FzvARL+tJ3f6O@Zk0Ws^;d=C0tKOcaTM&8
z*vUqoQ7=F0gaqh>6ekiZMA)TOW?d7Z>?4qnkjQ){Wd^Jy4XF6&4+fPadJzM4b^M1H
zM-5KvLBG+}Zc@ek+a&L{WV*;?lx38~z%qd!;T%KT?)v!m7i2+v#UG;X723(IIX_ax
z37pY&gU<Kus2(v!k>sr55Vn%kDUV2i%dD$81iXdCnH_KJm&QHaIowTE5=#VUOiX#_
z9R0@Kmeer%=6_6uz)#DL=&&X<8KbN9_8-#37t^p>wrp6~1v+|r(Nx6~wT9>?CaawP
z(Qoni`FoKq<a>t64a0u>Sf&uYoM`*QxzaeE2oo$UtV?>1y21G2)l1MpiQcZg0JAs+
za>5Pm*fkV$rb7<r4QaHO9F)s>e*jh<5C2tCZIVYyib^aMFzB=lrxj2q5?kw6{oceP
zeL7weSaz{XePP?cwwcaSCAl@^jYP%rXi#jzGs0;{b;uqgNWt#}bA5e%&SAV-?`Zm&
zTtu+7)u3`}=+FqB!LuIqBiqRIR+7w5@fpekeympA6+<I6@YbLxcC0KwOhu0(IVI))
zz9c~MCK(Pg8QQg?Jnhf)Y{0u=r_;{H5GoD#ui_?sJv_o}&dBdB^yig*Gkytk4GgV>
zOxM?z6&sXgAZV`gym+^t>b5sd<pYKZ@acjYzuu|D2Y!|&x(kahJ_Hq@5fX|@DNR46
zpaa9@he;eB-r%qe#$^xC**b0XAa^t7+_Ras8AZJzb}5on9VaSsjpr}S^(H>1XMYO9
z<BGRxL7ce){ImF=ln~cG$&Yr6b*%DlNunw%E8Utz0qpLHqMrUuBIY}W*G43L!B7$3
zi$`io_3tdC5i5z8cYnaM$0H1!#U~ptt|9w=64Uo`oosA-0_nl`1d}v&DR_|AFDO50
zD&M$l{a5p>Q&(MXo&01WQ7!%`b)Y1CWq&<~7G5Ucc&e~j{K&4+ofIAip3Cs)#5@D_
zDm;@48(`B@?j)0ZvP6^tTiA?*>a@knH!C!y4crmpQ5jO(<@GBGhh@*>&cQH+P8vkf
z+1c4X3T+HLjy05_H9CD35!7zGqhvOXyreYryH!;j0w;+(S?^d2#%fGlY63Kq^8pTH
z4nPg)PNxqv$m76uZqSq&FMUuulr#oB(~`Xl*EASh233e<vq#==hMDl2eq<eA`{)ae
zcOOq!bNwyt_K2xO-*@&djFc_t#`kHTdHPW4$M53J2mm-H1@dLmCtBdketn_YrQ2tg
z{H@=XSUCon4h&lseUef)TV<|i8#4RC(y=0mwP#@1Gij4PO3VCS7F$tQ38xZam{#VR
zioT$%m*Z09{+FN%(Sd~4Gm0Ua76SS%Nk$=><aAYb*vkGN@C%f(1<m+n4?iz)9nVd=
z$8HLP#wm%;KKQl(LF2ay({%3t_sHmBDc&=GK3HS32o{AIG2KiM3ml;;{mJElEL!>W
zLij`Ld3(SZhXCxk8GSUxNYQUY`NT=@c3`=6juj~#JkFhAS7keS2-@0Vfz(%9KlCcu
z%5!)$m0ZQtG6h3{{oEkc35{IrOSY6l05&L=+5iK!ExUCj+K-s%yHil(p21C`UUn7q
z0e$(J1g8RXXQsD0h1gpyD4u`cv+(>@rRFa+k2{t*qB<<fRjq0Be-<_IScm^p_xWaG
z%U!iXom#V<+K=(A;4AIs%UPUQv9xQF`%n)lg-VWd58U<yJWfnW>{&yZ)Q-aUqBC*A
zO9PuKA<_(W2a%Yepg3*ETYS9h14lPe8M4*8Y-v(eefd^-5bhMIJj-{JWV<onK54wb
zJI)C|+twCRKrgLNBhz!2n6<X0z}AxqHRF>(vtyR@VWM7XD5E>V-B9!ji?#_E0;Y0!
z*h~t?+#a2%u*DJPKHH$@RCIExq7IuX3~$1+J13W{Vw7A{IB`4oA(VPJ=if(QvhXXW
z?xJP{nhx!dd7Xj$%&ar8xnp?q64SHuE8;z%nNsB+M_^lc#ts-J`eArprT{@HcK$%r
zOUbbb)U2Apu29r%=kpLkT~nC?ZnbtfS#}R90KJ6bCQ+jWPcobEi!oaG{h;pBE;Ri*
z6-Lmqwx1$fCrO1|jiUZfvw$z~wm0F($MPhHFDCUH(`t)$QCW2AR%rykd9NWWK~8T}
zisLApB2VDO&DSJ^si4GDe&fiUc)iV=Fh?B|u|G<Y%A5{JZ7l~q{V1vdaCo6YI2TM)
z&tcIoH&G&GIE}LWXmDKc{>kgZZF_d*mAnigLRM#@)@`J&#!%?S-G^=31t9z6i9}w)
zv7MC_?Fki2q-F@QD%Px)%x?je_N>de2oWZkymeBX95+nPCAJfZ-0YB)ru8bL=$BiX
z#hPRTFtRrT#9<0OXNfmC*YP>{uDbZ<Rx0gkvapImjF$;j@k8&U%spk4S=D1H#IpSS
z97qhYatO3NVVSjZjS6cbOmX(__j!gC#pzrpkoWIZ8YKd4gM)&^zlIDdtG@fdrGa|d
zYr=}6t8`)U3t@ou8u8*qDhLVKaCDB*(jG13t2bVIfp4gZjXPwIW9GwTB!2Z&-QO@A
zska5_o!QvZV&UV{hW}xV5Jnf-)wX`3rS%^a)XqFJ5>$;<CffCSC#<@1ir4oO@EExM
zYV}#xsH6wQqJBv$Cr=CruYUdIEABpqi~JCy7Oo9#ItJy&$9Jv1-{-cZrMqwNtQguQ
zZwlho@PZ<D!UzhcOZ6}Ttr=22W9Z^0nKu;Gah$`iXMox}j6-*(+|2l|oiXaR5N0S!
z8WlgiK{+>{fduEjIxip@xn*?)UG2#SQ>gOQS|n4fp@ZU=SzonVU6wZPHz9`qU<*ly
z@b_Eq-hHQ{gtP=Fx1bRDS`U`0vp5;LFuz(s^P(zpmDh?#8m){E7%7hr7*+F`thFc>
zt$*`&QSIjUVcH+I@qt)Uc!tNWoOlRNB%dXf8aI={&3oaZhI+;th=H&x(^jKeyC2#*
z-avj#mypwcb%k|IKyU>7KVvm^v^V5otWrm7`__fEba<Y=HzAJL8?G31+LmVqTTXXj
z${ho6E_gXSJr&93*JZ*C>MU031A}&-f8X-pIS!l|VokZv-e1^3tJ(lVBpx=)xRsBY
zXM<r#zxVIQr*v6Aa=VMThdcJ2eDVXI+f?PV;}FQ@-g@gv3oM8H_&l0ZJ`)i7GrOX7
zYd^%XKHxIg&jAK~!FYjqZIN1bAK-;<OWqHDcJxrW&~M~`1>aMn9MHvO95-%0lg7`=
zxB2tH0V_LOX_!8GtUqXwkT41+G&D~j)hH@9U<Zyt<sW`7w)lnW?pSsl2ASZ%XBC<7
zkdq!baMIK<Vc#&LK2VZ=p>v4oX?>aL#q_Qq{Vz`P80{y&<b7UXDe-FW;U%3J93&k#
z2Z0X6+Abg^u&OdV_abzzMGN;Bfqo1JGlciip0lBmS++cqK?C;SQ<!}Zg~hzD#T5}!
z4ZEeT?@)|6gf>$=)>XU~5-Q0S`O<)En?QgBpGP=QccK64Ews>kiG*gqA4QgeTXm|>
zVq%}(TvWO4Q(pNg)Uj)_`Ql9GY9Gn$tmNu=>mPUE2RI%(*pYdhp*zJ3(Kj{Lf&Z=!
z-wXFFf{)>V{Y7bJWfOSPqyB*Do!^@=uKmke%OPf-pow7k_=zce*}!K<Hu8oW)*g4f
z2A+q;>s)o1vGPNotH(F+$8<SXkZlorjvuW;E5>B8GnIG2(j|>ayf?`fu6wroN5}6e
ztQ|%+ufhL3rGWia72x8?1$`unD1j*?%^f41INUdK-;BRLH*gaQb<J72#H5*>*|;wc
zqgz1IkWypdd9+Gz;X(DU-0>M%`EWh7qJ0UMD1lU6i1Jz64_-pz&j~}>G9V#srCYE?
zw=8;q+GtC1u~&y-X6+$|!in)X123Cx)}i-`p^Y7U3=>rcM4OhZa|V1OD3}rhvZHzX
z#P%aUJ!ABTQ3Y20V!KrrrajClbAH8xZt-;%=&raNd1UZy{#4V-#*#Ab&Ymna;sPB!
zzMEhsULM}R3b2nOE>V%A(tRJF?A^*OO77rIX!isfzrORrM2p86C!HA^oPI#MlA4PU
zG+1fCdCj_a%_<?^zI*>l^l&5X{o-JCqt!4$BdLH39PkuEKvppf!=zxF6WIPvS2POc
z7_Hocf`pQ@$@ku!DEiOfAmg&&LWx$9q*bJXic;sNIZ-)VL#95RdxE-T8OxCoTm%Ym
zLd5aG*Z#;O0hVvzDF@2Yb2NUVZ~EOBt~x_H(URf&5523atIB@yH6uTt;|dxdA0KpD
z=mD0g6<k$wP#rSq{D3nILnETjc71yAWR%w{(+|X^k(Dpq2TMFBfc+=lD|DAUQCQF?
z<M9BHcZMAxN&c~uLh*d5;>eU8*|#|3gG<ujS^xeT&>W2a-TkKP-h#o;CzE8p+42`&
zCbTRv*pPQqP33^y9!_C*fdK+bI94DnApo|+KYi|8fSnSdR5*rAyWgX@MWW>9w)TeG
z&s3i~sYGXnxZG{I?#ZA>bJvZY`_updTr*hP(bi#mOK?(HkoT^<(vV}rdOjU3gp#PL
znQa-UU7poLm$R{lX4lr9wXF<p2$*%iGy<mtM4;yA13MnYuU=988)B}^`S2%PV2MVH
z=Crr>Mq{;{2qBrwA^EX8#sZ>D=@03<4;yM{^Fe@~$pGXn@qm^d8*=(c6`V|<HcSeN
z6`mg4m@m`uzI>v=P(!w}K8(T;SnBj>w)Wcx%UD@b^5x=&cm_dT9e<&m?cd6-I=2$6
z+BUY<*b(lk6r;!OhXX#@mKq#WmDbLW|Ha-1IZ7@r&8T`Xb5vMY7<@hOBC{+K>{tz`
zum41+Yx=3aJN%Hk%3hx`<HHPR!7`BIj7#eN(IL^bkl7b#5WFWZ`{1K)Z~X#rKZLYM
z{(GHh!vh4{3KcON9T=fMgi;N%wR8bwFnN-pD7WA?O@OW~L+BF*A-hQrSPeE&@3{J5
z<Ez8GtiI^rzq{@00pSzJs9;V-Ja;{#7+D9_D)S{a1ON2w1+dMP#jpkmIEsBQCJ_4y
zLIf@jcr=o?57y9#4}+aUb&XE)ItNf&xN0=O1l8&8+zJ2%n1DeeCoV1?C?0dP5m=sr
z<9wU!1-BfW==8by5~Jz<rn_IK9a4J)SYvYP>R6%=r&27&O?ZKUfgYeAD;!``m%4ie
zzJW(A0KRyqIi3WXUUZRr`uZ$Dmk*U>K>KtucZb!s7(j}|XR7!fomqGp^=ziXkE1oE
z981e|1>0vz8cFZ#wPDjPns#6biXf@i_Dc=e&kq-v8JU?AZNA<$_KO7m4`<<*Wn*rz
z?a;7PhExT^TY9|J2Mvbs5WMM3E_994n-_=}1Lk``&!xofLPGMb-&Qhw2*aAmB1m-^
z`%3@Db1B+VGyn9i_tV7ay}~7$2j|%0m+%K*2PsZ|`4;&Rtc+6sX(1!<iHC}cYRvAA
z5<I1aSKv^5d+e)y2j1>rI0pE4fQ2*;2I}f`REmL(AO3I=^|Ug4<2FI-b!><a*sNFK
z##3_^r8n}z91&i~Q(I$(cOVXp%@Y8Cu0zsrXE5Tn(L9JFL)y9UZP?iZ;D#L_SHbA`
z5<0_!R%=`^5G;7JI9=<U+z$)-^|jCu*coxrzH_b_QGqMYrmlX~+D->i5G>>;|8gjT
zdwHhmGwW&>MW}>1de!oPG5teF388+q)w>?=08iO}qbD*VHg@zxQ*;!34+6MpGvf5l
z_|Wg63q-^uUjrld`1LS`&p7C<alqvH`ubVzn}HGQA<LxeEM`q_ee>sCe6@XEdXs-J
zGnt2LNnG7g1vb34(;YxX7Yq8IO_0-Eto{DZ|BQ%;U`V*XP=TgebXbC%@9U##R{tfC
z@s?hYkCk?*7uo>wQsbei>Ta2gtmbKP^~WQl>6_8tIF(s?^Pz1{hFyK+$`lfVt+7(0
z#_G@hUZ8^y2@A^u4b@BTcb}Ko&cn~pq3x(Ughf1>j8hC6ViP1Od3o`nl5kzYsC9+3
zfOjM5@c#b(Un!xmXir7fOWKx=uhGs7qO`0;rY3hte(r%Dzm|$E?3vMf!5JIl;>L^g
zu8!B_r>}kuMRUZ3KnS-js%-cUB295B47_%wZaFc4XXAjO`6ieLOM`u?$|jo?ycy~v
za|B|48ObX>aI$&+9y@G?uH*N0fCvwkYb0g^DILuyIX{~5TOMMa%1B1bei}L!Qky|W
zbvMEM>0pX3xK#0VBqyfPF6YfsaNEov2{47feIBpoB+i5wW!?b*Ra@>|LRFA^7Vc*U
zUNQ~(j*5W;!qVu@9IfSv?q_&3hDSOU)~J>5xdjLDF6?-WpQPfw^vZ&t7cnrt+_Pko
zoxMvB>O^m%^1QJ!`ol@;-t}z-M-r*%kq~u8u?5Fju3Xs2T#pW>ZX05*_gcM7sZ;gC
z;;jb(5pEkcxEgqx4oHnz#w`mpgowX}cwhhhk`|Ta|Kz#<Q>AleM!zMajN@rA+~kZT
z9Im79;H*3mo6#JaDcr7(jNf9&{Y&M4mC+b+`;{=>?Jf-K8`Zdsba&q>NnPQC8Oa{%
zH*qok*;2Z?Ub~-TlbpY#2n$)Edr`M85mAoC_Ga|V?QM`{vgue08Tn4A?{qm5DpqBG
zSJ1c!sT4qJneWv<D>@st;gu~Ln{V$U*kSVNBYznV1t%hpHpdfIk@0U=cejM;Lsr%U
zbDi}nxep)s87|a0xZTaK9H1MvS&SO6fGB=&pGW8D&|neyaI|-`-*>{Jz4hL5hLzzg
z3@bZ-V&taLC;0d76{WEo3y!L>c$XL<*7KOB&AMB$F}y0eZP#wCXch8lU`#e4OGp5V
zb?&JOK%e`5TK1m~(r2$h5p#*-eYv3W_Bf-AZ*yaALcSkb@bVZXIxTz&C*Itku9Lto
z2V3vaSjN-sTpKEJ9<afcV12jvQrRm?Lcy*dEjZb#P(^HqBKaNR6qPPV0+NoGgQpcY
zIi~^he&M?qg0_*du>|h4(8mMdWKK6Q?Lhn&w}J~iJtjKw+yE$Q;Nk5(e48jLD#}!0
zzw<-Ia{*QD8RxTm(%*?<<#)s8JKV1RA4RWuz8jN8OIWQ+kW{KRW~X*zXJWY`7mcF+
zWRxz_FA9_H`02pQ|GGFZU?O;3y_}k*EV?ghsXzf22$|8rLG6;G@O_n!<pcON084sP
zmu}F=->HFQYUskmQ<S)qb`VNg`1)m?mJ|h2^pVv>tW&`Xp{v>^Ziv}+GQr|+J1Pzd
zDvST;1>iI2#mv%Z1YQXb`3^~aEMN$6%Q?8(^br+sE|S~1z?y32R+YhXg?7O~)N_C_
z=>N2UFE$Wz|I6^29)^&R5DFH)1g4XgbrJ0E!5hsC2jmc+p`r{!F~G^TFV_~*68U7R
z(j#|BQ?(xh6QA;spBRkkZoX1}a^_b!rm<LS-j+g#8g0?FujHaHa`x9MzV|C!k=7%z
zrrUyE3FXc^f~BUklNT5K=734!Vx862tPoLWGesBo3-wb($PbCn-z!hT6`a#u=-~+5
zUpv`qB96w`cK_61)o*UZJC^Xl#~lb4Z}qx*8)a%(T5GKu&<2E@Tn~MKtZn{2<>IXu
zN+^`EllC!$CAU{YKY##Hr;Q$0ojwrkdq5)-!~=mVj?@#Rkyt@y!wy50Kje|j<|X>4
zd5*A^Ft3+PV|i~<HopEa&2NdgN~?|krM^)}BKg5YGB34X!7e>}U%$QyFB3!3V?mGQ
z>lIgi8(lXXd~K2VHI!ncI{`@eFUv7_PI#W?4SKR~^^}Dg7<Q`!c`M+H`abrw%pO$L
zjNLh=PcRK&a*;p)oRCfuR3ruivhQylpULL_zCMJ?sK{Nsy!-~Z;y*1)ja1O0O(B5m
zbUgkZEQ^i#O0Pyt8?BLr&lD6)A-W#B(!SFFK*Q<Lnr4^v>D5Ht-t~u!&!V3hdEa#}
z9zW;tvT`D8e7hbJ_^O~6To5jRtTH!RzV_T{S9PX4*WyFWNWx(TV=cM|>dI{=VFO8e
zmGoCH7I%^JkT4Qpih2+49H^BO$s-9XsGe@ykxVb^@lG&inB+MRmZ}3&W7Tt!vIgqS
zAP2NL0<eHKtpr5ll&iTXnL?lPv`aJ(XvcU#eJef#Hz|!oF*K(dxb1(pP3U&AVmx!@
zn>b|f#?VZcg2FBP6Q;`0e6EApXmb5@jrN0^B}zfRcTAd7oge>OWvVaaWlPk(MOxj4
zr(~0u7`#mHFXa6b1&J<<xHQp#^=mK!dcqUj<)=bWp}W}1q;d8AoSZb$>lf77-rz3g
zn@mXPb%V!-UF#88A`^RI!^r4lzlg_XPl9@Ajh?Tf!|_h+^q1mm*b(IM6caDxODk*~
z9O~|D^_=(Y?Ckm|><Z~Gye@WB1bV6gA8MQfxE+I_-jR=kgn^N~%I>xdj*@cn;GV|e
zBg1Zrdp&{xExIWY+iq~vyj51Tg6DF3(|IIb=4Pocq8%zp51B|XBJ*pSvn8E|PbUG2
z?J7wo2XW^{yr4u_qnz@byhJ%qE;3glHm5o9v=mC2IBj<Q<>hil@`RJ%xFqp=#S$s)
zE*wp6d$I}JXptA&RsOJRa#UC4Wh0w%jyfEd|0do6L0@Yz82e9N@W?y}7O<n><R|(T
z0D}VPbeYsJ_woZMr*y2utv4q(ia0@^TMW0?ZwG+j3E(}jKVbcXCq2&aq$^{!HjG9P
zDbB-1aY+A|cDb{NP&TJb3ciK#l+!}*q^tIc0*Uid$Y_B_B1uQA({V34ogkZN@o;A+
z4Ad-}VDJovEl^Fbn>H}s8}&%ns6S##3>)isui^akR@;zY2V+o<Wie!UtR-?W+b_JB
z^*$#~iNiMY)?7J<0oi&KnbC4nAp`*)UZIp;fE*qHA!zc~7nzy{R3R#SKJzv)Tn;wa
zf1<fgB6u>vlh$>%GeZsd91~Lvaz1f)H>b9^ge~*q@I`rXW_?$Kdz;gQF|P}$Y%fIl
zkt^-TMAZ~eKH}<36~`5RsR8W+1)!UE0L`g5w%)WRgTDXYC)^19*$EHqp{R@$BcVDh
zF*M@tp$Q4rnJur>R2Xmtu88vs3qu@AmxoC&CJ4Ddw29zySVEvZVm>`!dnReT78Vx%
z-B6qM?cIC(z&{qE)+g{c*bYCDixT|1nMq11Pp4t^g{MpmS3mefKg;><7^Yq0_kK00
zwZ*?aUXBK<J1qWP?gMTr#dw3W<&>_n@bb_M(ed)aVCYUv0#?k5Gty1bBa@V{0w+^O
zDhnA3;qJ^9`W8y!O9(WiWaX}101_{(uR=W1)zwv!t{P5W!9Tee;?RbM2ArwLC3SF$
zQPcvu&UpZ1ZpXC<O^{Z>2ZvWtW8doz?!fCgGP^#x_tc(j{B|&~xXFv|VZ{fQR>kL?
z4}C3A&lpOWf<;ODA=jY)1gjB<#yGcMkC1#koFuj?ij~EmFy&F>vE3v$Iu;=P)Tbi%
z`#3*mzQ8CofEfB*OL7AD^nm|uS>WExe3}tG^h#7IMMcSh4<SsbLEZ-e!?+`Z(_}H>
zuNImK`i*{W^vP%q;RxHMT~j42$$!wh_{#Y$;{xdg8bH}Mu43wUM|&_^9t{i@5J9&Z
zmY?tC(xcVp6>OClwr}Z9A+dE(j`ZXbOPck`X8Gml$f0wYhE)Ig!WJA4A7bK*iEj@g
z-S}pZbb6<Mmo@^GaTem5EoQvPksBeUgeBDZvqzGb1YZt~3X;)|^~h06k9$$A!q*g5
zv*hI!x~E)E%-_EGbopabJ40vUZ|mSmfb81!$tpX%&GXZvPUdswKY@2+8a>AXVIltP
z!Cmhrd^D<)4V!n#Ug-YH?7>gT?*zDOf?e&#_!5>dd|r`x{8BX~wzU-HKTtE5CJD_&
zLt9ep+x?>K@j@j+AE0Ie(^tPptn5Sx_hpJz!{jd6D`V84lZYpNzEb?;Y5ow-nYP4@
zuT9+(vzmQ~nN>0cys`4U8ki;bKY7$rGp2!jh@FTgIb&utLm+=a@r`#w=P$kYiT6*q
zoaGh-OM-RM4_~Gl7EX+pNS_3#lO3?kvm|xi_*bOf;XtnuF^_MRkEZ@JG9G>4z<@lF
z#{)3ScA0OLgufW$`AYl*gYEwTOX{e(u*j{~v^`{FH!8bAO~QKG*T>k7P1v3rvwrUM
zSMUAN^4aVUjxu6A7#GcrgiLX87o5Pb653fq_cAzJ?#rRe$ZOc;ntRo=m2V{^CopLR
z^&N}Ep7Ql|EljB(w0`o<3mw$@{v(NEuGAWwD~Mv?-hK-GwwG!3+sFq<gU=n;Ks1nx
z<)7;VZ>67r__*JyU(;~w05YmIppC-2r~{V)>i=u+t)jB(-o8;lP(bPKkdzLQ?(UXu
zq`Nz$yQRBJT0lA^q*J;}KtQ^`c|Y&_kAr=($N0wBC))!CV<C&R=9>4luJ{GeBY=0p
z$uXHkeDY+hM#5$IUNMzmhsx>6OwOBdHgs!P^UblV@VCGxjGT~;<F!FNQ$Fj{jaK`@
zaMes5M`~suDx%YD4-EvWS*b3kiohgGQ%r*1#%6sg9~x%hjnHgkJsRmMiL~RpKyiis
z%kCWVzbD7Jv;;b-f(~dCKvWV&$Or(n*ZKf7LFnLb9roRO=`?z7=l!@##rXDJ&RnsO
z1iL=ih-j!CmK<)EcOCbCc<4211b3a7nnKIge++#%8E)IG4VCY%cf)bNIz+Vk7K+^h
zQnHON8EYH;Q=g|pm(R-`%k{dgWJET$tb^^m+{-+(jrES1cUc_G3o4~oS65R3Tvh4s
zPaK!~eKrx1i}*vgw@<(Dxb$Zp(~v2tURo=iv(G+qBAc_se+BjBg*{V@;Kgek#*q)>
zyze7n*4COG3R1NOzk#ZC-2qZ~4jWDay__`pdXNRgddbY{<v8z9_4sO2I)!^(9=?25
z`fRXsF(H!iw}q*V4}-b@*-)p^PHD2tGGNir*fgN!(VKbwS}|&gFg#qB@3ph86n}V+
zhtjEMx|!^BzhsmzU@7D#<!I4jV`KMdcXa4DE3xz#+K~M5yRR6O%RxjT6J2R-3XXOg
z3Qw#^_MJB3dv5_f3ZL#<6&xChqe<%7nj>HG^Cpb&8?8F2rrN6eRy1MkxjYC&vJwVB
zr5G3BuOC>rd>`Cz9}QX;G1n4l_1*W|cE~^6W4X7_5E1k7d>Y0ePWMKcu8#Tqt%_u|
z{Dy_Fig=}-kC6*$oC#5gC%*2yms-Oev*E+Z%6IB|+Q|!)h=z%Fuj@d)^5JvzJ}-J{
z4KZU^qLhU%ysd6=<g-0mPSq6U+uAe9Q-N@*i7-hpljEr@F95JKQ78Z@aB_B5?PW;`
z*$t>wx)v5%O7GbpeR*MXVgf&;`dh*)5}$xB(a?q~BC~$xw7u-Ye$sa`_>4{%2Z?dX
z4Jiv&3wiw?j`WTKpH?35ePHx{Oh3hbk!EETitTtUGV#3{BjlUo&l}v;vCuB?ab^MX
zH);C5pa)V4ke&P=OYfOY^&=KMG=9Vtg&|fGrFU03(Q(dw?Ve^=opFI=vG)f(0sCqf
z$b03?&{$~A&IjlKR!vo3pp>aVLPCNyTWwyRfR9fWx(IF=8maN)(|V)zZRceKa_8DD
z9Q)pR;yV?k{+1uc0?WOVh<<NQ#ZK0Q*Nx1=zYtW+Pv6%PX!m`9w8~9VsaVq|P{=<A
zKoT0U2a2ubm^vmrm{m|`k$T=kFXwci-VJIryV}z79TAnM`voCvO>mr)faowBus?c_
zG*o2_6D#c>L>=u8>MyyM@Fl8k?6ISnh;SGv`WGMaIZhILk5-MEvm67>7|>|*j0Syp
zGplsZ<ogvi$mhf~Z6yvS_P*WU>?64GYJa#tkNm5->&`UXA?C4TafgjGG<^{VWLq-C
zRED4#J(r+G?N(6mQ@(6u2bs<^HFRn=C|E^LfXC}(m<ligbNnxL^r;kiVHx$>;1Pe$
zwYpfP5yxl32mp9WJ$eqNApiDWQS;pt4MOc-lC>U?VsS-``{l<PU9^yy?@of=X6HM{
zGbt>ZEn5cqJm1tdKJ*MG$FOV(A2S{<t|52^pvm(BuE7r2Bs46(di6@+ca^GJhwiO1
zB#%~085dkP>&*oMT+w-34v&`#X9oS)`^H;pAI+-cED%6tg%2~i7aG00l3G7+<$Juh
zCEKNg5O)fB1qoTO(=vTP7za`yr5bzQ1R0cEBI4Bx0alL^LL^v`(yvQ;{I&%Z)iWxC
z+m^ws1clAcJ9sjgI{#yrO#izcI*%oT4H@4XcOTd*U4;=XB41r77+YK0DN6;G$|1La
z-QW&Ta>BoUP1iO1TcE#I9qXo(NAU;FCD9$sV8Fq!lik)I95yt+yZk$XuJ`PS(4(W!
zl##E(C*tBz@r;Uq*x%{jzkx+Xl*GL5{uv+a0y9y7&VLv{?h(L|3j~2q$0oI4Ph!a8
zfs<T{{IH-1Hl-8Y(6^I~)tMGW(O(&V>p{avR<K&GEzKT_ty&=@N0+pC_72OI<4;Sr
zHW2;1T{2od=f`cMf5Vn@F8&j75rIuLiIDhO@8VnJ<_w^b-KVmeMnn-vBg<So6-&}-
zF=20>)Hx+`J5CPtky%dbEn^^{i@LsWzi<~0ao+U4&^p=anb&v1o&a6Jp9m|MFPzuA
z0+gfFE7XzL^S%SIH+LZC6CW4n59;`QK$-}q?)?Y`Q@MyR0LCfv&3$Sw$JZnVkL|}%
zUrGM-Tkj#QWpAfU$?#vWJA2!V{Ff2Lbf0kydy1|nr=Q`X%2*f7H>XdF%~gL83tV0O
zkdYB~pr;wC$(Ro&UEkZI-U|VcI(2+ynz>5=Ba2B*O%-02%la~rY5H|9cx(A&jr?@$
zL%j22(};wh*|KvV(KC+8<(_gK{6AUyHKqjVUDWlsRYouKj#y|cOTYlNpypTy;7T0S
z2w{^u3bIQ?QpZcTdB3>scz{#?!w8RBhGz5VbiLl00ml3vsCtKn@!r1khGkk>9`||B
z8+=CI`%{v8-{y6rJA!1Rw95bd`X<U7VWI(jn6A@yh1-J22M8~XSVn|HLlxact=5sm
zTe*=k@S_p8b9WcHy#1BTwpNH1(u8xZ^;%vM<j3Q`EI2qga`ht`Oc=t$QTC`TXkUoU
zahzIFDJmoAbovr8bw02j9UX0lz0wRDsV$@|Aw8PM3R|op@O}HTOV=cAs46bl+-K0y
z@K#4>-8sEwrGn;q+WuklsROrz{EbTXmFPVF?gxf^8V{^(J*;=CakapHp@p0w4~tH{
z59A~)Mt$&{-25Z<YH|0akA%Z>lqx?W8fwFFfb8V;x793|*TX7n<?*NmNE@Kxa9aLN
z*-NF_H<&cHh0NV@3#euYk|=t4c{P|%!n{Hz9Gr7br;`@BfHZz4umf`Zp6~$T5i*A|
z8P;_I!j~muTZ=yn;ysz(Bx5W5RPhc8ixS^r?D$*|f6v^wI}SIzV>_Z}N4e{t0O#B$
zxzKW&di#ceAkk2MJip9zd%DJKoS2Zu^$mq6gkhlQsp&+AJWEHm{&`-><x(~&?SipV
zCli(R5Jksx7iszSK>}|xobO<?V*Wj~AnhCp!cPDm9nufle*de<Mmx=GzO6MxyBAg(
z8(LcT7wFX-=rjOKW)vY;okn|$oY=>lxG;l_Fd^dZ?FGHN$oQV`eAn(-OTzO;BP|~$
zW(wXzP;dhGf+}i!<9l<MDHCd+AI_F0HN0ti*v~RMcpdnrx&i%o9q{E7YHg*W5>T_a
zoT!vlR7ei^wYU~Kq&;rl{Em(|r~1iNAdh4f;eY+gq2(HW+57&r=tCny5>ixT6D0g4
zxNL(?BqT3mv6!NmK<x)u%Lsr0BmkMujH{jfahf0kWeu47#eG%+N+Uuo^`L=i>q<cr
zOvZ($dwgAuI+s$~uuZ@+@{4)ibxLQP>8p2?jo~44%MXS9KhM1M{VtY_MPiu~U<xf$
zQg}TlN~$&<Ln*eP4=9G+KpL*ru=l0)VuKX-+F1Jg*V`zD)%}Y<b=^nYL>I~mlx!ZE
zPCYm9DArmd33`8Q{f<0&YqE<zVIG*T!1fXL(-I>HibblKc%gH&TL^M<#e@?8QyX6^
zKs$>EX<^JLK!$W<Ry+=yK@SCspvb)Zc!y?HTKM~P{ltbmaT1^NeQChodj3$|g=G;s
zvBDt3g%$mN`+Hw7{ek8S`tm(F*mbw7g(s{b>+8){Rk9)Og&EE6#brRf<l0ctK0Lem
z1Qej04FGPZsd*jf3H;P(zW5MVT%2ZA+fbh@u(%(ZK^}6L$habS6p#piYZ2ZM#{J<d
zQ|xql$Z1PyhW~B{7R-wmLPERs*mqDJr#-Lt0cz1%YtS=OpACdQMi|WTM0)Oyj*i^r
z<6SC#+Dhf^)~x0!JBm%Q)HKI6Kl;!mCybohR$Tfw>A}}eK59X#f4fFn{Wcf;pVHBD
zLflf@8{vEp_CD7U&+UId<rm(%2oY&x6o$D-BUA9uay|M*=JOUp3C7K|k33Z>|Bi*1
zLs<SX=;Y8x(cuY`C7&57E#&vw9n6MbrG(=I-|TD_-9;P(lfi{E85-?-01BCRDgqF>
z2J^L!_NZs6vzcbd)QukojOlT?ooQa85Jv%73Yii_r@BQNa&Og(xfkR<yZ2#e=X27p
zLlN=$8@}o=4vb08Q4ghN+vRv53|UB}>Y1V4eer!EKess6XiE#*lT^}v>MTcnk?w~w
z-!tmeVHA^Pxt#@umVLmbHX0anN|xw2PGxb}q(_C@Y?r4VIdH5Jr-lC3_k3Aql)Yc&
zMzwjj9(o{1+sJ@(iTY0+nqG2YYI0Vnk;#r}NCRNT8o;paVGEejbq4S!L81(RmZX1w
z{9W-iuy|-9R`l*ohD!K?6Q<#LO7GO9(90!POGUQ%-GeD-N8i1O_2AOuMJRoQ6IVa4
z^GLrNb*m4s%^FfN`*uus`L?;b)v`BTTWGm64Rq?2UBC)6G8}_CA4sj>zPC)$9GDml
zPbDn3TR>$rI(uG!-$%kjSI-<grb|^>*tmYBO5iclBkqJwQ?hI6n)B(!qzZ0CX(`Rk
z{rw*N^I-g2R$a4LVm?RSr)C~5)W<FK?L!%K=wbOQ&{&av6>)pMw^de>&6=^B=!E96
zFJ85RkbZJ-E-ujAaPy3^m5JZVWb}P-jUT7z=x4rP+6Tq%T50)`wAqgKdGxbCYa6)F
zh18yNySE-c_Lo6akR+4tJx{XA&U6`lpC%&Yt_&OTOIHH5(Ss@B>q>~#0Jd_J@*htp
zI>N9HT(6{%BS(y!3k~U?Ltyp-J&p0}n_Z4GVWGVRfbxW9WMmxBslmRN#6(6->JAQB
zAUd26x~AjXpbs>gUT#<(UPw*UaP~^coWFJLS5TZT(z7i|UwLXuCafv!Bw5uV4pDJS
zII}QA`K7TlHhct?nk$6aaR9;VP8vZb%X?wz#)9{O`HkprG5#og`y%uE(O%SM0W>!1
zw|D;NE_F9L(fxXv%2BT&v}A<5XE6t3X?bG}{oV!T^n6y{pOB3Ib{m6>VHe;%x&c$5
z;OgC;wm@AjNO+m5vhMado3Gu4pI8cR%{-EG`v^3=y*U0*!EGc@^-e6;>*|$cT-K%*
zvRfcTOUw3V@~@t{Y#1sUyKriX(hl&-1?QoK18i-Y+NYu(M_EocG2d$ACXzrKS^*0@
zm*ZcA9IM&E?L|Xhry-fNyd>3$S~X+_c#EE^k$nM&i;o`xru7zj-c%1>aBd|d-N|}y
zgCy>`ZjgP@l0T04gBD~zN!fD0nTa&)r<K%*GaQNh4sDf@()L2pNCnTW=0$Czr*nQ_
zm<X*f-X2;YwEJb2dJQEkT%I(N=2l9PA`Ogh3qX=dL#uc0K?Z6v|Ld1|zZbbq@s@F<
z<^x4j>QEe<`e1oA+L2lZQ`;E#jDsn<1o&Pf#4v$&I4KWwmV79961Xxc^w4mFzJQxi
zpHmpmXF*#Qw%Ys(Mco$K#_Qq;zSC4-JFRhWqCwOLW^P$OLXM1Xa-k&jP1&}2|2Z*|
zw|RQclFhPWXA(n51ljFI)iQIl$Df7VH}hw$=I~&g{W|F(fDn3!{0<P~esbp9b=($f
z4xo+3W(OxzW@gMKzaHI-;c>*D<UuBP9?P*W)x6C!ZO~PTVM!+$gdsMA))G|o#s}-#
zf+2~K7b@wjtQ-dT=0gJ3pkdIWpS$_??gm!0dX;hN(I&~^<)cLV%aXhIh^ofz`2%A$
zNaS%3Ff%SzL3UOQ{@=3f0;(CpsT<4o{arr4IQ^k-$Vs~!EPuEGC!tN8$~NZ}uz6ao
z)1v%ite7jGLUbSs?=#p~c*Mjl+E>wP0xJBWyxY239};A=91%B>voXg)LQz?L&<KO6
z+nuJl?Xkx~ngSkf8Lb7*2q%OSwzzVGVF$jXVL=aH%cUfNkz&vIxPs?$lU2#+ZFK7^
zCDsAw?R284$Q3I=lwTj|Ro0)lv3y`(2l@tvM&rCp!HbEIS9|SkBPGD1Sz@rf`-(Mq
zZ`rq_blXN{Dn7OF5mWmfA~39(;(2vMD}oOc4SFbClnzCv(GyU;_Axh+pFcN?Ja<hE
zK___(wRrG>Y)DwJEYI8!nMPZ1_Edg@n;9AjUE{ke1ONRI8<)v780_SMEsJjrXM)%X
zAI}mTvbdaW9UbwyBdE%+o7WK3$@gzv2RB?TA1Z|1Ih^+de#PF2*I=Y27V~cfo0e?;
zQ<ExN3#hG}DcSYz2~a^tRLH%>LqkK$)mZ%6_BZ0edwPObQ*4wnuz$;-&bc9!AlMH5
zb#fuyw?f?L8y})SQCY}fU{Zujsbu+a>|yhcANhObd>tG+T|7+3r`P7tLT47ABn*H`
z5=7V_J|Q6x7=h*i1W~%R@zks~yndVb%d#u?CN|!CemJY^z)_JxuI#0rIir=wPQ}HJ
z%)y1Hd}r1v3ixETyQ6j!E{f-<!Cdz8c7h`tcgfWx-3F_9Mu@`AuQm@hVA0BDfn_sQ
z7*1PJxM-%5^hWwST~$Gku%)2|ZOAD>Z;=fK7=I(D8(UWPU@IEO@9u%Os^SqWXq?jp
zn`vmI5?Y=B41G2WQ)Ihvu(#mDkW<)=(~AVgHUIh73UBR42*{n{eFFZ7>m3sas~dRz
z;-=*kDC2Gvg^g!I%_Qe8llLd$Xh-uuGm`9>J~EI!{u8W@MHsRF$2&uUasud6ObF+A
zNxR7{zz?BwgG8QIQsz!)GK!aWth53(qd`%s!v%-sdn`Ff#}t>9xJpzBoxm6~rHOYm
zh#?nmjW4!l6njF#zrVyXr3;M81hK~fl1y?SAGCII{hps{FguSLRWW_=ja-S*dz|>D
z5|r0hI(e2`8^ncF&Q_$_XhRobMgNF+eWjjU=_K(!avbX^rew7IdibY;Jmn|^zM;|}
zwwBz!J>zroVukh9Wr4>U5ZoI8Grn3dXa(MOh!AHVG$xIx-BrN4HohVjsnh_glhk`*
zg6Cqp07an_*=pVmGYr!Z*FFZmtlzMzVT1u|N1<|{okbN)t;uI@OU=MeGP0<pJ^f?I
zkkoNSUX*@`v`y`C{c@A-?`wgt)?#=(VXQdu{pXI$T)fBEgxME9*kg0M$({VhUbD?a
zISC<luHuG|x9;AIQ||mKk-eH_ML9J6e?SF%2EqBCL`E6StgPrV%&O}0fd*gLikoo6
z<c;50Z<!tvYzz^y)wle6TSMsbR$Hc4#9Al@?i6q8X|&u^sexFMP$BzlP6y%QTFUMP
z&^C`#5f<uCKhTPQ9BPH%nC$RQ9MRaGY369t^ArzKEl+yvBfRQ6G^*wCX5$EbLL!jS
zcD_7hsLE~_?RSQiUy=K<--t%DXBaKD!i%<EUPS`jxy&-D2L=Yr&<ku98{$(Y_1ZlH
z`py6N7@U^7l`54<ig4FLjb^p%#sc7wH%`j_%cHeUedIh)z9Rz=Oait%dM2juP<P&b
z=;tUn9xfW(?P&b^z0y;2yBA;gzGL0UJZe2qTBGHk+iw%IJ6i>mczflw$`Bc=W#y<q
z!IXKz)gy}<cTZ|;<Zj16M`ymjeNhG_H+w-#A%5^Zn7)8rM`4YQ&+`H**!Az_PIKCi
zeI4xFAGy}~W&r(#=I(2qhY%DRY7B8ka8FQ6{402Uyo3W-Qo$W1_>6^JXDmFiq@F+d
zSq=nnv&UTm%uX0<99_n~c@9|&agqX%4ubaQ)EOG*v*Uo6RfXQ!kWiHKV6z^K>X4Gn
z-o_2o-xvZHe}y$sT=$s`-L`Md)8|B-#6DJOQO;vNWV04d0u#?*-mg2KgQ;`jpofid
zgHQB35)ewWp}5{C;wFQEj#!9N-bM{b&twLmXFu}CBEI8pf8!#Y&-Ulkf-}65BKxtm
zM@)AA8%-DQte2EqVWX4V4YsONb@1K`eJs7>Q3H!ShP`rL)U?aIVRFUCVWB4tZ*pY5
zy)}v0MS1s%Mgs551t}>TqLZT|dcXatSY5=GCZJhcsn?DV<}RU~oqnyjl-+$rCTIrK
zg~C@Kv;`q=Z#KjLAeUea2$ZQG?1=YKx`6IV0Q8HO=KOKao3|BVi)|<@ODH`}-n7k;
zhOYC}={PhW&f5!@IByI-Acs>*UqcbKeb0{^oE}>}68Dh7UJ?N{$IYz)drD5sfDBR=
zOG6Re@`859FL#{TXp5)YJdw~sTuLG7ue4+4pqD3fE@5NiF?P9CGZzS#1ZPg>l?uLe
zpPBZHuLJFnskFg$MbSJZ0D^_7dKE3-f)lbo>eY{W?>jVhT*l$(TVf;lv=9*(yw7`K
z@C7q_vMk>G&jK<7A5U&;eOT|n+?bIUQ~KtQYh&lsS|)sgF=_)v6`VJ=e-O=hn#?ou
znGnxM>dnT7?d=FSth>OoF+G|DsvrR=VCsRhn?iYqkDdEz`H^05wAtzXR09CX8Gz=L
zV}gL(MM;bLcKZ|1=aW29p{70#serV>wEB)ICes}6`E|q=dEDZurt?1Sczf;H8lfVK
zB@{W~<hv-DZ%h(1@GcdEIO)1-41LMIQfMYhi#WL!H=a)xZKJKs`^w?4VJ(e+s4flH
z3P8!$%gsviMEM@SU$RK&WjA0Wk73?u`lkoB#%B+~%t+?mvK+udz`Ay89nRez0Lcl#
zM?&UJG60M+JwCe`l29%Js?o63R{i37CtE!QEpFNpM_<|_TS}eY_`!C^@JX?fNclQv
zOO~i4?0W?p7b=OO6IY214Mp@-%dHR`g4V9NVPTuu?YnIe|B&5SA|9%K8iXkzP&<g~
zaM3;wFqx`VTJLjsl16$VE42nL&tb2;)B-5zBxDzCi%FjsfnjC_Bc}y=Czl2c`k0Pz
zl06k@zT;jc|3sKvz=yQohlg0^vq|^L>CSMb#7gug3(_RC*{{v1vm!K{cO$C%h&bH@
z;HF*0HjK;>Ll7d(-OvVCd*ic`8}7v6k&u$-l<+SX+Pyx2o=6cYCChN&#dG^G%*8YP
zh;1ZX>4HnyJABbJF>{S9SZaog9qGis7I~amTEyxfpwxrJ-X2UL9kdfS8sg9&9T&2p
zAt(^&Gxb_5%u%p1^<_)pWW}h<D?2BgR_^zy$60r|OHjd3pHLW|ooQHqPa<{vxwO^d
zIR;6tIjpfp`=qRxY?qtKf@#8)v<9bFNyRO6!SYnSFO&TJ6Q)6ux%`}pUT}7SNvm=e
zRLawEdjJMH2`2T<lVz8NE+T#ux}DKMiF?}<o)1IkHD~AOd5OQJtx7~@myMyti}<17
z!b&zSjg?-l8y|kLJ)qxFoU`}RV+(-62$PY=h><?iAZy$GDpr_Z0>3dM5jLsy)CAY@
zDyLKrW;@CPwV<Jx<P3=UB?+us#Iym5peLPv(0gNOtsv%ES32xm%R{u|nLPk@|5a~>
z0?9u1oIf=<PPI`XW)xl~I10Qu8+a0Xkg5%9EGpp3#GivH>UXwOC72_wUPw>P#R(J)
z8?7)hf3$oMYmuL#&aYE(VYjzp3@(Y)9lF_yM?yZK!G;m)F$@pdA7*o~M<YHr!SZQ}
z!D!2J59`qI&sZ-8I!6gHvJiM|feb($$c;aUJMAAIAIm9LZ2D2Wp4c?AuA>GKAJ21?
z?*`Dl4gwQ{s7DnFXPhr~Bo0A~$*NjTlP(h<Kj21XFW&wxzrj)2*SLgA*qQ?~Qe)}P
z3^^?+JtZ)s$04kbYIKL98!sL`0x?FdaJ`a3)C{Wx|MVME@}<&4Iszsabh?W7jd~qs
zzBVIOt_PPFui6S)RylW9v~dJBmz~Or;@5eZP%4qqR$#f12V}UE<M=OURC3X%Wn|9b
zSNdUQR8Lsn@_vCUMI*I3MPq;72euxZj@y!V%yAVJR#e@Z0AGyMMDLV5)RRUUGPU*G
z;tyL}*iYS4D<lV6Rb=y5SU(H(b7iJC)HmN-th7-DQE76WP{HLziFmNM)u&^oQ*a(M
zCc|lGPj#P#NWoJS78+KhQnwxm!yqq93O_2l?rZg;>6UXj7E>l(NS^Vrb8x7Cig+s|
zEicFJt)O=az`JoF&|1^N_YI$DO`)~CPY4p%(%?#mzISb7<?2s^VAl(pT{~Yb5wU=C
z*}=~U-Wl4AS8{<&YSQ=WZD1gW!jLI!olvAAHCYrX2Z|+wj~j-$`|OlRLgDjl;iI5X
zhOc3YmKL^Fcf^cD&DbHL>;93jx19DMH-a^oC}?Df4@lBIyOC$C)#hsY+7@_}hvpV;
zV<uVDyhy|p)Qahe3I*yR?`@_VXzz$Wz^l|HDF>o>R;fqQzE(u)fPSrIik%BbX-d2o
z|EtaSkvoQ%FCE00n~+@$i0Z2^-XxAP$P72u*K=>hODL(xp8B}@h`1P>s_F6{V=l{k
z%Y5Z5HX7a?e_r2SYEE=N@7%$*rCt%0oYIY7WL?kul@wUd{f<*D0LY>3rrE!c<_N%S
zCuhjd=tq52uZ3;ZEXb&dYQo9Bc>ie4xmt<W$+v%>BU&nyny|3})ckXk1^@#oA*NuP
zS6U{G^_k?6g%TaWp$qj##y>%8jrhwsdpW}A3l3bsiOk9N3g7QX76DPCfA(}c%1BXM
ziRbdhbeO<j6!bCOV7cRniN;F*B+r1b^IB2G9v52H6N*(~Nk?Yy;|Hb14qoZVymMCM
zo$b~JAFd|r^q&NQOYw98>?~#%=8CN59sAi<;qW-O``St0BxKN5%Yst{q*Ig`cmHXd
z#`wk?_S8%e`hCVNx-DWS$Hv7qca{OG%;x)C3pMMyM@2~)5ZFfGJNX23CzP!dlIwL^
z9KkRZ+Y*4VI^qiA=60cWW<?xYHI|V&qt@x3Nw?=bf<o7XqbiUQijL3@t4SBBh{G)q
zPHWCWN;KMRe9&lmh?C<3>j`0we<J2tB+kFR!Ns6qffWvh;-lG(ByLL!5;4kCRG<*o
zPN2b(fn$2AOiKD7qNu0{G8rXlyh9orRy<~)92d8>xs|veRZpW~A>{v;A|-#{q9fE2
zVS>U5J<VjOu+i`yOn^(lm_M^u<lF<Ij@C~F$I#R`+i@8f*c3_`x~>;ye}g7`?i*F3
zRlF*aDhAs_w3!>$lD>-8WdCt_ok$UpA4#m*IS28y;qpnr*|U50hi>EJFqSdkiL4)5
z2kVi0V=$-&7Pu%!C6GQk=(A5@4z6D}zOYu3pl=i#QIgO;KW$Q10e;ks><p19z>c)=
zW9S=VOyr2bU4j%0YWYIDX@|dLqy-XE@8|_(l<hJ!wOzQ0K%+hsFaXFoIW?-0mKt)X
z;-{Gu>hz{wWl%*y#QAI!ZyM^RvIku1_z^HO`9L-XG9dRj)WBEqZfJOJBuY{nVRI5>
zKUj%T2+`NkjS<GpdE85yyXSidkci63y4uO5J=8+Y@FsotmQ{4q7qo*jdSRoa{dYr^
z?Y*>0mp$X&_3}P?G2tCPMGpkWVIK6UQcuVuDq|Ok9}^b{M2U|NHpgqLQ?VwcifHXf
z!2N`|Pzpc0?U(l7JOj9d&wn37f`Ux6r)xp6CQ}QFcd~k|I5+aq+PubYm3Z)awcym1
z@#vP)387k(Fjr<4Hn!XHeXubcYKvv|p&?H;-|zRUmU6X^s1H;D!p8;l>xek+8eU<z
z=>ezC7O+ewb?~R<F9+_53~8ry906Xxs{wY{W6?ilkAN4m(9;mToiHVWt($i6o%CUN
zjY4u?oDUa@l|!@!ul2g+_?+_emBAVRN~SjgaWLlV35h(lkv-dAHA1_!Ma}V=IE{Ny
z)J)yLSiVJ(=JleytgI*yNzvKIA!fMXKIF)<Ld~RLURhb$I6S25H~rxP#J<;0PGbH2
zp=jA@i_*133~*Q9v17`gGZYvLqhk1wOxEUwMaK%tZocR%7A4aoiDdpMDf+8_Gr$<e
zT7_Z#tP9_E1N$_pG1M%9ZTN6`qe?Y27BzK@AG!wVG+2&{<QK<va3c;%B7w$vI)Zty
ze{vC=<;}t{Wd#kN7Zcokk4o*6Hw=x+^yn+@w69Okffso+lnz>YVXAg44|cSK`k+%^
zg=PR<o=;rBMT*(COuEQgZ4nbDl$0R&HjzL0e#pYX*?FWPM-)Hp8Ywb5TJEmNkYv;=
zDl$?ACp5&SH(m6tO`=AjC!T1rp<M3<MS?}%-gLUM^i=w9xz1DbJezU>xj~MjlE#vf
z63k3?JnbqGG?Og3$Y=@Six<3M->FkjMJYo_St*6zgiDZfGvH5R3tMX;klDWN!CfdO
z?H5N0g_Yr?(&%RCe;MN$pP=mE9~o?5yc4M06i{lm1l4gBaO(8#HMN_a#;i+7as?ax
z2*umb2!10SEUH{B7(6kHIcf2}LkBu#YB<^|3)_R766a>R-SjDz^v}OfETaWK(!owF
z%C)(AG#Af1XTHWzBmmr$cfaESkAru9F)nzLR8r~<K7Evl=}2oFO`#9_b3E(0qB$9Q
zSP12zRj)64%*#B<&G@GF_I9@8x3#HCCis2DSy`?jp0paC%9i8_n+0)6q<sw<1Mojh
zWOZ;i(chva($goFv4qKBWRg|3q=ZY>$O|P@A=g%W7KWcVeu33)rdaBIKZ|B-F=mhP
zVq>QgX2bRn0Y#gnndi29bQFh?_^HO#EjSp-Z^qHb=^R4b{7bP;={P+-RpWehvY?8V
zbKzU5$BF+Nm9SudueJj%FLCweZzF0Mu+ZI*ysioQq7!K&QTw>&)86kp{^ou`=-v3A
z_0M9Wg6Do%NKP+@@`5VOceP4=h>3|ES>`!D+2HKFF4;KbWRWFenmh9}43LW!GZJP`
zNZ5*_Pbu7XrzoK!)%<c}FC`=FsKu(Bj7gyl|C&NM-l$BZJQ<l*-9i!zTdF-(-Zaq&
znjj0#+C{xap)sU=6??3QmDc*3eUn2#eF5%O(^n{*S4_>EUI;7)uRgl@(J~WN5qq|N
zs$%K{<SIa}&G3&-h8qs6lx^5nrwQZlf9DgIE8*^)-jFU%!K<SmDd}^QeigZ;6mB6Y
zsRV#E&^RpDGyP-eV@7$6742}D!Por9ZWxiDqk}d2;A5-cGW(2vxjxu+E>n+v`?gC9
z({d>%wVHF!qu#GNIPC!#YLJPLvpCsnVywEcWF~!LP(<|r9>q3lO+<!aU3pPaVIb?u
zAmzq}mXvfzzQT*CsoXHJ>S_H*T=Ii^5?iw>Z~P#&NpigKkbYK#@RS})Nns@o0+k?1
z*+~Qknzm+@iy=w%J}oIq4;pMDbQ|S(lbjGyFFtglzIMV3#XdJ|B>g4o2&Pup$k0Pk
zx-bOT8Wn2;D?@6wqhDH!z5T<)t{l}yXQAy?7=%YU24;KkJYHrjy4_e;$c*;(&cUDS
zd5$u53=Rx(8WBMD3i^izDX`YTl9c1#T8PSnQW2HKEJKJ!iBqUw5~${Djr8e{6A#%9
zZPWx0q%oAS$h1fhKQ5-+2ZcrBytbLnNeCrR?yH0&3^sQ`4@`kAPed&Zc^|IlMW%P$
z?|@!~0{5r)eS7g^Lo94{mb;Biq&Y#jJ>%kA#TvJQh()p52CZ+l415{1uEs!JwP+`i
zH_Ku$&B(e+qZS4fj(tE0L$OSm5^J`@UM=1UWeX#o3fsrKM`T0tE5_53gcW+ib32Fi
z;Q=8T{Xwg9H*HXfKQ&xxQ9-+oHs`PIo*`re;S0(L!(9p<^guw~(py4sFwb~*{nMC(
zT%#o#HD%5yN5foBCZdLU@xXeW6#M=edjL~gBhp~U^{T1Hr4C0Q)2P-p^mF59++x?D
zs^~<{U05$3v$LYjH)eD!Ov+)BW>&TEbQD=kdqNR+5t>)L)OGfDBpnfubv>1YHRmq}
ztw;^xgE}3B;t?eZovmQ|XdL0>Ad9>7D}+hu0m-%y1Q{En@|*jDw`X_Hl$!7hea}~v
zk?%DvhUzlNoB9!5jVzOd;_&AvWTk2ncpI_b>Zj!E7OIu`sBbndQ$KY~ENT(vo<H3?
ziD(}zg*>9nqkJv;5%F`IE9B9c!6tI)+3ooGMChLQ500PT^U~N&>sR=N9hIKl-<I<J
z5N|1<Jj&Z-x5h}Xv#{4YkzoX=gZqn(bl4196byL{Uvo_Xgfx}SOunNeQ3ch*7RNO0
z`>rk?y$%|-t{64Fe?wSH4r(M^e<fy&DE3^>mXh^hKa-G{cg<8EQy2ROnL-bQw?&*{
zXfo+Hs{1=y0pv|Cm~8{X4~WTDe9k>=+F!%k9nr>7pEb2LdgEb98Rnj=s&qDJnzDlH
zqdGOF9Tr_{9Fvw}=6Vh!-$?LG7#+~?+i$A$L*|Ac#-$3rgxM}Sp$a*%_|?IQh-V?0
zL=`FUg+dakCuw(Js!3kMV5nS1IJvU+c@6u%&x%|AI?hT-Xc7B4vNLM)gtqE=DaGne
z0<-lCuQ*d5e=i3ShxO0%zSo`%*N<+*HU!yHo0)nlS<+gQnNW`a5Cjy2yL9@gT}VAV
zI)PKk4Nx5+(ezh-`5B;wcJKLreRpFjS1n68@rZR4&Qh*YBx68Macy#}MYVcu$k$NQ
zn73wh@Gaj)=C#b3OiYiR#!zE2YMc?>68~Y;KtC4+`%a6IfDJ*lLMNBq|J)xywV*<?
z`tlOC&MOwRlpC>T{g4L0NQd<<=r?$*6yxcD<PPvNBj<&L$m*qv&<)!kixqMhMG$t}
zRtpI2R+~=>GROA*A@YOSHDJLCCc?5)3+j6wP{zR*(Q`r6@SS+u+uBS79sh^z@c{Dn
zUjWrgSUhj?)xHQ&C;y>OL*m2_$gcumLo8rUt^?q1lE|6Gc5PNs9L@vaZ%tO~ey5kX
zq5Sv%2am_U3<4)XXC6M2BmRSF!bd|Rsl`Xz%)Rr1Nw<}KkbL-G&+&h*Een>NRuGAX
z)`tT0L?D0xaEkx^`{tho&-z3s#Ftu9K-B-wkElqyU}j(^ZsY&!D9sRHW2S7c?ll3l
z#J^6_1q%+QLvafv{MT<&rui3V#mO!>3=ItdJPwY0CZ`g`Y_sbzK8QS2e7BL?A>N7P
z)b{sRHaB;7yJ^7{gCxTr=$QkWn>i;oPfqmLt!_lO&~r;EeSLi&@K_nIU<9HCMBv0t
z>oDwAT7v;@20uGH+hZ<ZGryv}28zK1WfTBfAijc<<9h7y;Il=yl_4%6fm0{$t?7W#
z?0H%K=G@fIPJcOe^B%NGWM$vv=jWs1;c13d+@c$!HaqS_jF1lGkQq<-UYJd+k=zlU
zne9(5;2lN)V*bx@MPGpii5S9g(3v5q&<gg92_~1$tKN=`Na})27XT;Q7?|~mdFpp)
zPNJDl<U(W9Yd}edbcy-E0;M9#`rIloi}Xp}!k2=%c;x_GT_Kelh7uX{?+ifmG6r5O
z?<$EthQq5?sLTBhf|%zL!;eFQKEESG;N@RCC6@t^Z5wCxb+rGz`~Z2L4fR@a)Q#-J
ze?PuO2z_4rvA+=jsQ-1`e;06@|F56Yp42nh+0fdWo}8RqvBTRVc_yqPJ{ii)VMtn3
z_bU>f4zLs|sg7{4nL<#+#`#Uc!}I;Zr!9{dCJDTxfsR{wiLy?jEG(mLYY?!o?wXt9
znD%Ap0BLf+-WK<N?K8n%Sa*26-mC#Nz#{zjEn!1$$>^&?)_;ATat*;My<hgwary66
ziU+I2aD_jg_Fvl+p9-wf|Cgs!oAHRqFD>QJ!D`owO-f4Q6|&FS2`|w=DK0A7@$&nV
z<Bf*3gaBu%KXD#WmG8a9i(vn}9X_!As&QF>UQq7gDm*f>H<iU$5tvcCdwS-(ovZ@x
zH?u?4%^8JltJ_J;hgJ8t1aJP-TT4bYy#<6ApnWN9U_e?~Ri#v|!zG)|i^rYCs6vFz
zs1pY0j=htUXaMHd4<ZgL(H>5}#5&mA?m)#`smWRs0ARL&L72F+vvcvQzh*QT$cgQ_
z<0?SO`V2_En^wH=3#lVxS&RYh&-tF0zZb9<?P!3)tuSD%Y;0@<L}1Yw0r+=_NV;Y{
z)O&}IK7WU(H2^os_vzNG63nnZ*e(kKpnTqr{(CC%yI-*i^722xWE9L7iwRHqeNx_H
z7aS3CSmS~ZmOq4-6N*Ce1Bl)Sg5rS?gGyG??+N%w?VyALp4yNT@b?G=gM<yx@H^N$
z6+c76Wj99!yo|6Gr#&OUQsH#igav|(2?qfWc*8-xCQSTy`)_r?_<ZU7mMsY>T*+->
zkD81O8u)bx7Y7GXVR6ruD3G)Ou)S>*i2yNBKS{n4Ek)(lkrfqu5K^UQU`PfiBcAq`
zIE*^E4(?)MIbe?)^1^_*;YZ7v(!A#H-{}CXY#0cKu<>Qy(_<hPbc97jB;<SnZnS2e
ze}FbH_5E;7;+=xV%Qs9rt-y<R*y?M0iUmn0jVFwDlXd)>K3E)?&RZ}U+3A3UB%cR7
zX$j-0XfW=5r>CbEfh(s7WU=GR82`DWeI{;~--T`9UE0F$w%qIxQBhHm08qESV?e|!
z573b5fIh{+{Y*zUw&E>85BoDv4S3Pi)C5u#D^Iw=BfuI{1EUWX9}+v<*seB@bH#F1
z+Du*#Wn?Q8AJ%J4b@Crxa!!swZW5_3@Dn}2qY8o$V7}M~E{D{&Z)3qMXVe`Lpc#g8
z%49_&_QXIdQ%K|#Sd+{9b%B@TPE&Mrw9dI14N>$EhdE-<jZlbP=cBs(V_i*+<k#1J
zAyZ1J)}O_#@Y&5tbC^U;nmnynTCo)PE-{aekEde+3FigaRHy<^Q`coapW#Xoy!Jty
zIXydzCucW)Z|<utDJl6wx6OtEhCTB;ka&qJ9V!DKEzy3?d-E9f(V@{_A1JtkgXPA~
zF$)kNZ->e^k70uv`)pX)*i>ScKOWn38(<{|aqp<9s9u8Q9su?!pUtv8UILw#FDP5%
zij%BNBP)G0Fd$UFWa&vfc6@qcDq=K4bn!X5qoOYiI*1Yz85#NSD<Y(y1c;YPAiyIr
z?JS;VncZ}MImngP2Q75Nfw<X_r_xUh>}6o;rvC1S$MN3Ym%Y!;<A3{%FFpfVo&J^Y
zZaWXuo}A&t?~Kfqs*#>2%p&MZkJimdl^?9qf6AZR_cP};=n!NN=8(NWn63mOB{2Y^
zr+Y`Vt@`5W4Y*(Td$8T#l88I;SWtv!CLQp^WWIwaS;i`nn9d>_EvE8f<KtVl4fF3N
zYWVY0bq%yE4-X@nG!AJEM#Smg<W$a|T5X}O^RprE1@Z>dTd5Swb_0!$2_Q`Ff#C5&
zW$3PjwQYAixz9Ms&z$=w;AkiU^E;sarNI4m^7Ad53FZSAe^Ag*z`l<G5NKubxWNO8
z|GhGE#8u#t3F`=p;p9~GnNkj+fMnvOnauCEcZ8<&g#_kg)LK<ZN53WL-hcS)`4Scu
zz)M-RWrFJA`e3)L?>#~f5bSf(I#5bqn%n|IYLp!uRu5GI#Nfxggi9w=_v6h?BhKXc
zep!D}YB7>r8j|hC@4&PAR`lr&7TXQ4t->5TIwQa|CZUnjB*0!GAuUaDgyVoqgPwp7
zH7`d*7>~l1zZ-#o8z2ntO6be@4W3a&$|)pveN~yojl7nw2^c+sWT^IV^C{+0V>S)*
zQW*A!RlvC@m<uLRXNFleg99W!v-q3BUpWE~r!RnfQrdx1h(NYxNzH`So$&nB7pLM7
zi)}F==VCr|^SHCSOT{olVPAS`Ht3v1o9{iS=m)@-BdQ3FgxY{sZ@b!-#wZ8^6hi!@
z9;%xbWU6<NcCjMnBvKYfI$GwppK6HAVFMB(xS1fn82~GZ`>@&Jb3bL}a5%@nHC_N<
z{s;H&B7CsT<FZRQY@bHrHi5L!?Lr^*Y*a@oZGz|=ZZ)P_pnyvMnj2<8@@}~jZ%l!q
z9268Xrj)3Vs<B8O=>^Dwq+;K7gZ+lL_4OGr|8B2?chT{&5k;SY693Trb|uK7wytG<
zP*0umcytkDcJJfLW#zVfe>v`c_a;2fEG_fh0nhl*5CUk;54-cY*j4b!C$-EgJSeI5
z5s0Jd|B6WEtqhBkl?DVpOhc^q*ToebK1O<mO`N%^7Jt~LopphV;pWj%WmwnW2>blO
zro!Ul;fQc1dogb`I*>(w>^sf>3yde|$aTVv!bB|67r#W6pc}{gNFU5reA#9oe22La
zRv5-*H4I|!G}$SLLBT^GXvC`rgObXK|B0TZOu+t^sq?ES75@&P9Y^50ehgwuAn!?~
z#T5Ax0iR4MphDt(8bF?Tmju+AXnO+G(*PD$>F}-@rGV>&j;y4h1}_#m_oi8d_vdg<
z&xjjS%O3o*0wh>RjNE0jm%=}E6>|7>edYJ-6Q;@OZR&(6MEfV&9s;ow|C$;F09Az1
z=46I$g#v>MaxqI!l4M#HabPEHLq-12)fF;1qUVC7*y76|$@oPJi}!fAp^F$NrD^#L
zFo`fBhrWx!n2y9m%a=!^4QI<LxWd6!6`GV}q@ogZ;xTu0{}DbwRgEsdPXadREfnjS
zVLTcvW<ro-f)fkiKi3O830c^FzY$44>;+qm4quIMeLU`<HGp3v3DX~)6L+`CtO_Yh
z<lOau?NgXu+$G`r&QH+gyQ>?mfcpLKs^ASm4MqZ<>$?x(|CMi9Lh`NA_FfkNTKsnk
zhX+wd3dtIl1L{)$K9~-X;c+^#U-_@>*B}H^X&9C`CjQsK+)p6cn_cG7fk=w{>v$>|
zXe@sERkjS#L;Baj(ln3(zQ0DEkN&SK`XmX&lK%h8{C9!ze{nT!Aada#w8cr$RfTY;
zVnPXIf`u=DJZ;tG2WIeOW`uJ=wpjz-`1*huquA<faq)ZhwL~oOd&~E09(zPUcB@2i
zTvkS=7kn3=l%$$_{@OD^@2dnzh0cJNPM}`T-amT|QLalEt!U!odGJ3wC>q!g;G>}h
z0GQ@5cHh9j7O0{%TAgV@S{njp@44VJ+rQchfG3-N$19qHa>oP%XLKq*-lQcT3?_L{
z5lV*SzcGy=L`9$;Ms={HNs<j0O*2c&e?ztvkfs<C$4a4W*?xWUyVKQ5;OgFQ{=CWc
z`MLMHdO+_`@491NE9Zr-?sZLxY?=|sX-^Gqa%@ZY2tL?m`aIsvf^^|ZVN}M&2b8N<
ze|KcGTO3WxIwXu?QGvT43~X)@RskOj`~x-&q97fxWCFPDaj%@~leHyqyL=d>>oou`
z>oH%?kH=x18coPG1q4e|$`3(YUjVJr2y}nn`>WCVE|3N^0qLb8PhxyBe<+w|aeuNK
zzk(lbsDkU?uuAniJ7_UVt@i<e!s+Dp;ns-&pyJ=#tuB9_0##UQpb!>PBnlztgnFe$
zyw%qiNQu|KXMe^JawU8u$pOUVZuu;3Q-D{FtvCXS5r@lfRjXe$d9!6I1NAikQgnX!
z+w5$!-?tLV6Fes0%A@0vG`1=*omc;=$Co1>m#G4Z1GU4&#tJh{fcCU;Ih<<*4=NpI
z)T9h}8eJaFj{`^1gvwo9Xjs%i9e*fxCuMF?sDL`g2_Sr30lGkZ-ZvBaVnTT^W8gkL
z?SW3iyUuFaZIGN-f{`e3YPEhR|H&+Hu-_2M37in#xjBPufDb76TZiD8Uv2owAx-Eg
zBm=Xhd*=Y~lO-U1*JcZ}5$4KNsHf@Q!F7V`x*RF(C@6#beGLT6R<D40jw?{?P-$|x
z*q>|y+@<@AgT!cDmd!6*IhF-`#iU@B#jqv_6%k?JNl!}<f=Jo$nGL$uI$VMHbv_^;
z++Cu^iIJV-wY#5@&p&~ge!2h&fcXs_g30LKo*}eK^(ZLg^2tO(w#Q_MgGS6S1An#s
zX1*X|&}nA=cn!)h^S|3elOP{#w*{%RZw~XTnQ>6<9q)lf{^>()B3ckP8U>n*+b(2@
zhc-a2JH_f8<k>VPUIhSGwfEZ@b+^NF35A4zd)6rs3I^VURxz)1k|FCYxN=if!AS4n
zFH9#2B!QCCsBIA;vm|_;CirveyDH~YYDq;i?>tR$l6_`s+~E-!U`u`5Cj^FTEN6Y{
zXr@~|FD*|#;z^qtgNKoAo#0k!_yFEQp4e)dW6d-?p0|H@Ze|3MYoldAq3Bb62;hpF
z@1EZTeDec}-d!hIZt)mk?~}fT4q0alEF^$Mz43u%cdjx#+!oFR)q)n#GpYm|X0F}K
zEyoY94w@gf`ol-&^4S9*JmdsFIzPjqK>1=sL+V^ShtKO15ETrocyI!pJPzl5MSx<-
z8h@VA0Wt?)?s%u$LY}!0G&TL^i1|Ekcojx3XL14+bY-yN28Z&!1U&vyXzn;EsGWhD
zvCUH+RS+tG9u8ixex{HKToeQBCLb4%^ZxotK|eo8oKE4mwb%=xF2UaRl@l`8>4|H9
z<+G?P6;O(eLu<gGidkcMqBKe;mjddkC9u=vD$ZQiKr?d@aCvP2GHmEm%a&H7<?Vxt
zsdci8+|x>@pTNBQt3_*m&4xWQ*1@^P8;=IkaLALwl<|jZ(5SnJ1P@ACP~=F<qT1T9
zjr$Q4$8&)EHckH4X0Cc&R-2vnX6EG|2Ma(9GLu3f=G}+>4R-#P44gpn${Qysr+H^P
zpFIGI=z!6KJ_e~z6@d4+KHj<5l~k5Tu$I2_WHjZ*vi{w2@ewo=GT6*wY*yPAminH-
zXNr>l!mJaN%PvR1SU#3~zVW!Q#)L#H4G^*V6N>b~0(IiJU;oLnD=IurV!x<54rL#y
zCY9|jzCuugcmvH_td_uZ^0@u^1!{)}E#6l%3Oxdd`0u^-00bw;7;hfuPSuqS`NmoI
zoHZFsx5glVRzp=?rMnbHb`(x6oUI&C5>Mr}8u9fsRp2s#$n6!@sbOur%}VQR!;W$t
zkjb2{uh5$P>b3va=%Z4%@6qtWe>YAU@(}Y8Oj`28J0RcIk>{$NZU_M813Yd4h@9ev
zU&m=iaz?zOnN^8`TQZdf>BY$eql8_V7s0|}Hi<^`G>LiG^giV&4JwP1F^^O*Iitg@
z(ZG7et5*$(t)UQ1OBkB3<S>}9`xJQ&Hh3m7Kad1h7U^dI@q_tbvS*#FKP#Z)U=E~k
z9KI;EA@alKD#1HG-Yzy+U}W)mam-WkPek0;RH=9mQ-i>vhzaeBP-dRTNA%Xe>x3%T
zx@1=_MQ0?@TfxTQE7>_v>3m8EkZqbiizN||_3|3a_%Pn^Y*uG(uAebv6;r$$nL@uf
zpt3N*DN}Kno>9&(gPdcvTJF0dMRyBAyoq5XW#q^2)c0yW@I7)1YK<k3sMU{tbLrP;
zv=Z)%23ClbG50pv56Al*=j?<lZ<M~{&G(54t7hHK>_VF_zE2Nn^P<{<2VbHQ;c_fX
z`z40fRb22RnDD&I`8A!#g}X}@`{+&(_!Er?-}(!(z`_eg=1J#(fH(leG>WdaX83a{
zah@MOym@RZsmr{hEO<6mf~w+^xujG0XFL6ZdDD%fo%)0(xE_l-aoTvbIzx2<f&k+z
zkCng#P{O(8P$;@H8vda*Qn+yq`l`2^rNa7N=eyCt`r5;fGiG@lGm!V4CIYJeCrT*+
zc*qU@^Q8<HH&CHp^ex!5P~f!!?z9qIU423!$$yThg3Vl(Y992zzXDGhmkb4MuAXr5
z`9DXb!RrVMBl=%wfrhO^Cxsf7PVoKD5oPeli;eQp{^t*azb>c_POK?4h4P;x@1S8O
zRAt$P|L0mD?>Wec>7?$2{(VG}QV=RVB3%4G_wfI8SMY)=ER*p6+!5ppDIGX*CB?z3
z{~Uqb!#k>f(t!Utl?mj;$rO+OUK{vAa1V0-?-!>_ztm%Y>-MN<6AJv35|bCL7B&d{
EKN{koX8-^I

literal 42302
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
Giv0&a0D<lR

diff --git a/reference/figures/README-seir-conn-figures-2.png b/reference/figures/README-seir-conn-figures-2.png
index dcdf7d07882303b1302432a401ae43edc7dffde8..fecf53df003efe0b7f84c57ab22c8055f0c60cbc 100644
GIT binary patch
literal 44236
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
H*-!o_?(9L9

literal 38218
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%0A;665sz9Nj(%Y+;vWk
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
HD}DYKpd={3

diff --git a/reference/figures/README-seir-conn-figures-3.png b/reference/figures/README-seir-conn-figures-3.png
index 516d9201f2e96d42aed9fef63005d91c033bb144..8e52506560e2b467e70ffd9cf4f50b5736b4edbe 100644
GIT binary patch
literal 41484
zcmeGEg;$hq+dYmG0}|4ugp`CqN%s&Ek`hWI-Q69MDu^OTGe|cGf^?TiBi-F8UElM<
z=Y2l!TEE|)@UAu9i#7Meb)B(~eeAu@30GE>#=#=TLPA2qk(H5DK|(@7AR!^oVW5L&
zJU`5GAtAwVEhHqAtt6x+?5yn^RqYLoOr%Y0O&l$ZRHVg`koY1Z)OF1%)rmzCtID1{
z?0q|&mGv3-n)^$+waP%y#M-q<na$MGXzOyZsIIN)WD7>l#mfwfM<T>x_)R%;(Q`N2
zO-!_w`P=VVzLhI~gS}-w?LU`J8zjTrtl})IiT-I-*FAN%lC<l)I^(o6gB|trsdnrP
z1IknKB9`T$g|d#7)>Z-MCZB#BpMI7nkui^B7?CL!n;Ry!cWK&ZMvp5`Zp=1|l%<iw
zrh~@{_<qqXm>^w~w0+n0hlyQuVvZV~VzvreC($erw){YPeJ=%X?|WbTr)OdM&z~~q
zeYkF&47;;Rf2;+&<Fq#!Da4&q_=v9ic^6N9f+GD;-P;Slis#c-t&?w+K9;fj5YM9i
zJpTIFF?K!_KUIBc$~ml<)uOBo|Hh=s0&|}pNw=mp*b!@Aq}52>tCn)jIX91Ypz%re
zaJ(7*>|1x2CZS*LJCc__IP{aSTzplM?ylfHK$=^4%u?ccLjRyd!QydPcf@ORo{odC
z)1ND(rYJr;EM^u0qy7Aurtid_?z~?-Ab6E6()v0#<*WFWK1(HWJA-hDUeaCXPIi~e
zqjT5S$?+HqpZUqK$v-f#z51~)-s$)H2U7;VeucB&$Azg*g~{k&$f*sf<jcy@)Y02I
zBCRBG5nb@6Adf8)_BTY5Q8aiK-r8@{v$4q6%+uB~&C^c*%x%p!KRUZcs#LSQ?%Z4(
zU>DE2q2KGzYu+_ir?0*1>tUYn(vN9sPe05d%O?Bz?I|T)^b-4h+H{)FOkJwRAB+bC
zUf^<f#L_t#A65+vdmz)Rr1HM6eZS@=)_!ef95+|q*Y+Zn7k{j8tk3FK%&4uNfRF9#
z_cc<lQfo$>)}0@kkz2AjcTNl^JNDf)>#vTM=&$l>-Mzl!i|V&I`Kpq8lk4{@ET3vS
z?N;eSVMSw+Ocr%(gR=B*n%u9>QK-9-e5%}QFwD@kFPBcbL_b?~oqVQd^jn-+5}EIH
zN_9+inDy_}onv*>chq;Fc1o4D9QN4dvf3$5FU4B1`1*1xRa|R~MTprrSh%^R*;r0#
zjU*%p(}2y>l{cR#f=ssty`#j=INzthpDfpD%eJ6wWL{KFDi)o|J8N;56IIc6F^FDP
z^gdm%O^s*J_EDCrubl8iaX`D%zO@jVp|`#_mk6<Fv;Euqv+wI)ZtV{{u7B^wUHD*;
zT>c|r<6TSF(xM?&@w3OIcb6Lx%$wC~HIxHcxIey{FC&$BJ>zS(lfAwooAk&uaY{w!
zyJQkP(W>Cbn=3%=zcBCS@i$wn+eIo6$#Oqdac62ZoJHaL^R}hwwGw$>KK162w!1CE
z4APi)o!-sGm8Z`k>hLVmPs9!C4TC#&o6$%&00=%44OvqK1*FH|Zww^lPzxj&_zM~Q
zBM1K=EJ697XHXCb)c^S#c@FxYg!+?HNJwxbSxGT9cjT>Pv|6=46E|dr0k7-O17D+|
ziovv>)}pw+p+^r4m<}%tn|?R_ZY<!PVF1hHv0$8UdIXav?}B%3&P8@>Rz%Huos)$*
z8;;I?#|wKE*DchX#Csf<rI?ePEvQMtVgK)ecmXrbR}tNi`d`n%VITZq%F`HhG${Xl
zs58(Ym*@Tb6OR$*|KA6A5$b<m0si>E7yaK5K&yb=OWjM=3@iv7xw-Z1R97XDvy4PO
zhi_inKSrl?oO+f8T({PECapQ$<^t|iqmgPLcE&HSPG)zK-DVt~6#X<bELu(RD)Ra}
zAiaI~(_wMSx=dZ4&AyA_>(4t6+-W$ntSPdS9N%f%RxMBU3hr9}LB}CqIvz9nXq~+l
z2dz#ndazpW6K>-p6EHIc%=%vRz<yKM{!G&>)A!yFPGmO-tXcc^eo9qI_>UyJ)vKy@
zH}*aWT>jRe%9rU<45pkO2gZqlg5Q{5Y!$Dx-=X%7x+hWOdot_iSGn|Aj&b8;<Ij`P
zM*^(S_UOToL9z*v6a-u9m+ai!TRc~>Q|rl!!bywl<f(&hw%r-8U146=Ee&3ubLSIq
zlQjyw)5AUoT}(v^i9E|&B0M%|VmR9dj+!Ph>ekm=R)6x;57P2%PIjhi!dH%#zv{ad
z*B-n(YWVX?yNV%JgN`G%H(5}yi2mZybhV2d<xmK8!%K3A7{3MEc<CK)=^RgRS=@3+
zg)8Tq#deGOp6i*@MjwS&@ZX5X^E+i}TV%#ebx`|R*Vxvdnew{t&DrzqUmx~~)};EL
z=Z4dK;fphP>*Ra3OjZfT$TVlafxM$n<l;BW_f9%SHIsr<zdQF(<(3Y61?{5qZVp9n
z7VFP9p73^1I{n0@638I=_ST-?eh&V%0NG|xIRtOk`!M3Dre7S}Bxk_eP2|wdcjRV=
z|7<CG8VryrH9Pj$o3}X6)O)I^S$Mrylbm`bb$wk$ZZ4fF#|+<BjTCA#9cSATJ58%j
z_L~vl2e=dF)R(>#;x|_VH%UTcKkYKgpj9^)h@F6uN(qm4z1Xg-0hiV%yx&S>+s#rb
zKWw(xMy6kGa^`n^m}<)QE_ux$lxoHI=IVs;=y<}4?c}51WlNfgH+W(?!K%oDC-dff
zw86S6t|A(HmD=}o-uC)z)lH7&#}~{mPl{{5AAQyNxZl6yI%#8OB#E@-vJ!8m#eJ^j
zHtjO)eb}>F?Yg~z|NZ{vPR;HPyD*~md?SA(#AnZMr}j|s!h780>v+-C@noOKP@lfv
z6-izd`0t<CtpRqrMwZ&WX50NXGB+|k_q3K+t}0@In<c0B<5KR%wY7nW7lKxWKVr9A
zvc7se(<{%mpK+V@v6*_U;}G1Ft(vW9+k{3|z8NJD;$7^u;c@;Hg-%%l*6*JOp*5TV
z!`+7F$<t46eD7-e)s)F*3?3a!a0sUI)Z#~v9m};VOiZ|p>TYY)xNg(2Wk~4}-S?Ph
zd^w9<{b`hrv3H-mu9c&>=R@tQArY_;wgwhIil*dL&WBJiP8^Z{Zso@l{;Rwc+-4rZ
zJtDJp*lhcas(q8YY9!LF`o*w;pSy?HV5FA;cd6Y-fo4S?cIwMD!C@ue-O*xw!w=Tr
zCK;Ks&+G?fnHbuaxDh>;^2q|+4wtP&O7fH^z3LUBI&MYCqaq*bq(45W*be^NDiWy+
zR&+QIR@F{;bU7`!Q72di^3kmCW3VEYnfAca{#o2`JwYzjeJ>U<zCZ0YTlI-vn#T*x
z&YmlPZ)>mjGtY4tz=Xn@(}nkib!I6Z?Gg7m+bg1PO4K5bquumswkr~;OmkD6n8B=m
zr4aS4wMkbnS-(vGDDq4ppA2c*p@Yh-<MU1b$b?n#cCG!!p4O~!w89kFL%SNDX5&=5
z*K7@!gI9Ykcv-p2I=}Il-D`(@na30l_!C!8KS@7W*Er95^VvUr(5X-OE4$eqN{QSE
zYiPw`ykCxXm)n+SC=P|`=v)h)XnEM3ztS*&@Wm5F45P!?mppgr9xA`9+j0GV4Q6(j
zG$4T}p8E~h7YQ_T!SzA0-E2y{_njCE=L9wjjE-s>WB5h|IT(7cz@^bQ5ZiR1-@O+#
zM$P4aJ;{5}y%2uoyDmJ?8}nMv;=*mpL3%RO)usKz{qSlL;+Nlw+@ii;b!m0VMl&*O
zFxt6`O^TeGTy<h+4&>z*S#BdV6<9w+e62)Qn4!uX@;~2Gdo{{-A}#jhm+Xw}6Ar0{
zsbur)s52(TU*BKmp?|4Lr^RhcBpCZSK<70SR3fP5I&NZfW0_xQdVy896CU!PiCjX{
z*Y3k6FT@zWi(ETiIxhJnEdAq+tGv0GgOIH2l2~+{&S&nBlNqmKi+e2&*7T3YXtSOK
zVPK(6{#Fj0HaDj*`&RFB5z>OoV!>RVyfqz>g-bCo95_N0N>_WfPl@NF{PB!bHA_Bz
zAxk0AG~2ecjZ`7Yxr9U4Aedxo(yqZ~qSZJntyt#}@96Pa<hG5Y&=CGOlJ={GhLC4{
zLWg6fbEHK$g4lICX$p1k!33ZqV<LVyBy+tW$dN_iLo3z!AffnOx^|RMKq%=E1~r&p
zx9Br8+UR7y$Mai+?<(obdz@#spB^${^Q{XNNK8`7*?zTwJ;ai0>Iyb8sN&l);~%$@
z>G_R>XIH^HVNOpZ<>2{(w6U50toDvUM0Kvucec1^L2k#vpZhK)reD-&>-Dj}N{aj*
zV{enA+Ue3ak`)>5kI@?K59@c=Ba3(e+XzI`bi{{0k_g3h89Qgd_SwR7{bn5+*kjH-
zGvAK#C$w+aZnoa%RAW!j#z-~1j>)K{CMgj9LD=j&(miq|Tw3DePr_lPG<)?IJ2kfP
zCb6XwO(`7FNC|SB?|PnS$?vWixfZ$ChF0`HY&aUx9#H~yi>TTBp6b->Tbcxmq?p>B
z`14_3utH;LX_zu%=Zo~7BWN+)1r?ka4ZjD`A5{28YNUewT5W;#k$>eL_KQ@kx68JJ
z&MG@U7jcR1jkk~AL5@(C4my04WnFhP;!2LfJfGU%NVil<Js;P&CniWSp_DD#Ru$4*
z8YT4we%^Ezb}yp~Z9euO_2#mJs~I-ir#7N(CoCAGN<bTdFJ$1_h<xXv;{9jFGKMvJ
zJdZu5H-kT|(4riP!%@uZbYy!ZV1_S{`i}5*9;Dg0QPW2=xNlMHGvfu4kAG4Wy>d=O
zYn~W4OSNgHdhmyGv5k-yjY4ALQI`D!amL{5a8+3^b5;UL2oc|J#^-N~_?&BySWB0Z
znP8@zyy@GZ%9{EpdL3uZs44O5;Muw~CrNp}`=M%4^~U3&qUO8Ws=rne?RLVhH0?4!
zkJim-ScuRmZ^9n>kDQYXpFXEqfoZtbU7v3%Amn=kTT3uE6l1AiMZB}#W#Ov*fC+73
zbPs3Bk!f3+j#Dbo=L+pst)|pIBg>R%aTK8af-w+8Ppl=SmtS08jhS(VRRN%~cGBdl
zZUOeLf*p_$W-oRdL<el}?~QYKpYAbsUvw!dg%e%dq2jQ)W&~N%#d(#;nq0%0{Pvpe
zs4C?q_Qh21xS+}q5d;X(BGi&x9BH|62y#eJT9MkiDMP=M{7$jjGAEH;m#Ij5gBQP<
z<Q-}BvFkfOihc=N&uZ<Gz|%}l9%_}GaQ}E6ChJ9GiHVorkr=$zLKov_O7ED=oE`ic
zRxI2u9(F0_#w9Pt7^Vli?Z{o7n~4AryMK=`4rG?5j?)EmbAbN;c_@E`Mr=|2PtyPE
zb7<PZbM624y8j!O|G(?Nw75f7-AIvM>Vy4jJ&(*pzw5L7f#mc5E;IaqT8!VqCsVe+
z<2Y<*JXU-1edW|FNzMidsYX3hg}siQvr~PmVf|VSQREH(>5qr+2Y^~s{Z-GitFV0V
zMQL(87vi~I0sxQc9<XI?3xA9}{*IQ+_&>`QVlVxfa$gU4wN^+?P_;}EmWuzYE2j|z
ztAG4#E$6@OH(+-0m@-H#oXXrx|L;TSqLKmnZ+Sbb{jWD8e#4f6)c)raH{u(y*=pw=
zxX&S<K=cSez{qy>W)Va`i&r06+1_$%8XR*pM4l|P(Q<fE{H~6^PTEvXPl4BM0;myk
zYr*0Dxfm(f8`Q6DSNCHkEB}mG?9J8DsGA&XRYo`Q^!|3`tZSjx563AsC87Nw8^81Q
z?B{<oR5t>^^?Ck$m+%(46ScU;E~eBisYuH8iE@j@Na14*H}D}f;HyReQ?|1OSLjB>
zq*$<rG3-5sx#xcX2C(X@zAyi_GJz20hhCpDs8J9;9-|)#7#va*7wnb-NItHdM|*qa
zN+_H_3?b9^F109VkEGh{71(@Q3A)Q_P|y0Py!V=H0WIADeMfFzm(?o|qA}l#?P;OI
z-;02;_nNLENb0~<O#36F>P%MHOoN8bPV2Ah_5^o+K2?Mm_#z`6vmO;_q~9?%4n7iJ
zdz@deaQ=6FC?lCZlCN3BY|xWCw*b#YVUGIdG<4FoW_t>Z`1bYn#V(_h4`?l>%Pod}
ze|U>J#RkFh1^9x(nG%B*O08p~Nd9)H={mmt&Dp0xwG|QFO>R|S;8U`@n(D`+U>S-_
zH5G`>y4H!5;l&aE%Da-mzx`yw+!#VZd~B3L?aB&=%d^$go_3<+V1b^;=F$=bZ|*-x
zBMjiIngaa`RLvc3u1^|lcmo%~mv4Zk$n8SNWkYQ!OvNreg2xe?r9A3lzk|9^@n?s)
zSJDYswqw#<dy5?(-I$V{Ki3@mdSau$J5$#q%Q`&jC4||DEs`?&Je?4LbHEtB2H;dr
zkJuCX2hybzaj4%KX}X;5&GRTGMXO07;XHgvpb?^PS9f$51LdLCfCQc}*Ap7pXje2-
z&2p@E?*@Sl?Q1bP0rP$uNF>lwhv_6OW+|oGidz>Qy3{UX$e>O*Zv82Pme4RPplT(d
zJK239oM(i}b*yPiv=nu@!*@96rR`4Dsw*gS-U`2;zb$wgFm9UI18er$sp=r$4>$md
zLDg=<%?!>1AwH|sr|Ea*Ij!0<-sTrpB-HFRV^7bAQtzbro?B?wH=L~`>H=yLZE3+7
z2_eXSp1J((Ky#u<Q@MN*JYP#!*z{P8;7w?hl~>-{>3_FzN7R(804?+_g5Rk9E)m9k
z^qJi;T(^zkN1HjZ8iwHo9Ya*LJJp+0P{n7h`>RrRBN-;V{6#fk9FZmX`a&z#KXy(#
zw!xDO8qNe7_+>kwlcPBIpS42miuG2t^SYrT6JYj!3ctnP7T_Y6$MIp6-fbAsvZ?}_
z1-n6NybUbZwROtri!nw2ZF6s5)rf-q(`&bGl&e6}9NN9Vp9WopQn_kW>^K($12D0f
z$42Zt2MQq~7Q=aa;?KScL4Y;PUaDE-UMOAcGUkAqIc)|J8rvy?s!fWE*sz}v*Sdqs
z%^89KlVx%~d&K5cRaqjJg-TA=NgQE6p|?EShY*JUz|)TxZ?cnJ9Yrtq-U=QKtLold
zU$Kaor#Y<;q=zPg^-f8fu=km1ya{xfMi=JTlSW(74g#J4m8Sh}F7)My<aGJlNM6*O
zA2Im9O0DuF{>K6Wsu}%l>>GTqrfPQU69IWz3!1F7+hwiUdd6!z#aB73B3FgOJJnC+
z*hx#;`=~tFf3i@Uw+xk`n~+?2D+Yo<<>$K`4E?`C2f_>mDm3t{fKbKLCpe=H5eUR5
zj48jHt60ZR@P#_hBg>3jt0ERSlAUMZnA_IaK;}ev$b66hpFru-?3zht%&YIiRka;I
zI?=g`UP~?B?uC1VG_UBZY9ARFoB>J3i0=hXZVCpC^Ec$4R|mP#+ul_9BFMswYX7;T
zfCPp;0G*8Oiag{j-x%!8CBQWxp%B8c{WJ5RHP^oev;T`gIEbIN4oE(Sum=lLXO#`}
z*r0L7k)QLsUiGs+c4txz>&~Hro(m?7LegU9_;b6K&>8W$5J3%Tm#2##apWab!IR9f
z0Fw>7)`cL<G>4;zp-yBeP$bsD`q67Kxl9O{Q9<!B@y}tr9gvq8Fq|A%zf{#iLN<n4
z2zcu+d-Z(i(v-i#0+G%kNo9oz$6Qy>RN)2eu_A!UHiCTATRf&lF~AhTKsbu$rCR03
zhrzkQqAO&yIl5gU+=?{jaDZ;UiQ!xbZeKBOZvt~#aOc_>wbdlhHqd$qF8$_mRn+E`
z5N@^q*zz}B{{h&K6_?!o7`NAE3a)Jpz@oWPERq)I*P;bf2F{TW_c;$XLNC@tZ_bqT
zTo#qXbq@V5_ods@h@%O%-m}%qP_#c))!wZ;(bF|~0GgY9*TMfREj2I{)j+)(r^Q6%
z29a-a=4yiVqCW~2P-Q3G`=7_#lQnIm+P`&yU}hl(v`y|Jr`2AdtgV!JTJM(iiR=Ki
zL~-~A%=`3KS>H~iz(!7M{cuFIlE^qgI5NeO+l)uY56eHlrae}ZUu^>z{@%BR&33MB
z8gDYi(Lotq8AW-133&N*thTMi;@ykp3sgLzInTdq^I`96fPhsa$5zKh`RhCqsU9>2
zyabkZK-C+~R-zuQu+gq;C%5{Uo#L4%O9Andn$4n`gsuE#JTP`=8x~u)GiCx!c9E{&
zrY4Gc3>*AIwZ!Qpq-LD%FHVCkw7{sCv<5_h#q;CsO<aLBniC*v@ZR6X72KLTh7?hN
zj5XlHC+hawDUQ!Tadx4wDSs(W{|;ZS217f(JfL#gHF453(MG4_x$WS<jnA0R$u!lG
zZQaqU(7g&Uc0a)ci~%yF#X8lo-YYkA0`9g363K)QI_bM=Y%ao?Qc5^3H}!A6SJ^gP
z9ovE`vIA)luXtTL(8zS=(D5EviwkzV@uv}a(};93D92WnBJ4$;4M-NJ!-l3=@^T0c
z#me>NVP9)~!pt7o>r4!kYxGD)`8eg)c!ApuWcju6#gjtfGwQmvNWq<w6CjCHxiY1H
z`YH+3NuDrouAns_!dQ+(jxIe1m+QV1tS0CR*2~1zGsmS)Qy0;j%flSdV-H|GDZqzl
zi|dpXXW=zqS^Wj|Wc^!X(7QWkd@pP+ehbU)%Uv9gTN!LS9i)QVB$NOoC_1(+hF!&)
zt6xuwCH2ZEJiJyrt=!V5T_+1=>wq@LtK~i)oUU1B%5a?O)XV=#N!7|oW=noNPQ=Hv
z9ALWStj~$=0>;%{N<Q}ec${L*h~p`zKE{jllU?eFdmP`o>Yb@y={U4?VxO+#wwb1a
z-F0<}XaW*O7~BOjh{3&Fjo1R7-z~~ocLm022T(F+NMdKn&5qpM$S=OFp@!jS!>URE
z=EdHkXTEaLQ+9#m$HTx3NY~#weWh))Z10TSz0t*#Heei2U1*UO>{P3~YWs6OBq^a4
zti9fI19`Aqoy&?e&SwD?(%Bp-B<kq@^)1aC$f$%DD!l#epcT$z9eZhnEdWIL%I%6t
zp4@66EYy@5b?}T!Cl4tKve@C+Mn@YRi=mkRW(^CWhw#mT5kHny(=|f|DdO-?-qe_$
z&yl+JgN_{z-SxrD_bkO;IBAFE;-RQG#}V;Z-3!FUF6AenH=c}5->tu}4aG5K=0m0Z
z0;+M5ZN>OIB7>4TV|h?9EzEhg1-qx8ma+X9R<Zc#rI2kDE>iWT;e}YvZ#8y>MoOA5
zZ*JZxC+nP2x0F8dxQ=5hVY7cxq;EA@Hag+Ytp_0<P(J7ZX!&*xqZ5c!PK8-En3bD=
z670rlkTu9D!6(^5T0S29mkdS&>(N;Th`||93<TZ#`K;Az-y-*E#zGdp)>0|T^$DLO
zZBExzZa?6)P2wjonANn#JiG#igU)D?E+-GshDn}3sng%Jfff7ZuSbOwV3(QgnuiUM
z*cr~veJXf~<MP%>pRbQ?NDyY*ptc*>!>wh&m2ECxhWR%wg0Ddi8o7Zn2t#S4VEwI^
z0I{+>n)BnxL{s?Ejh)cL2Z#;%iD86x(wax59@>&8K%XRL@L$MPI0GgHVe`u@O!ssN
z!JusSiojK`1IJ@Xg6zJSso<pbUr;MwNwBI0#Ew;4Rr4bni-=De=JWJ89sJ{aaz%lf
zV#RuO@)82Zo%kn!0M|h3DXdlA2~toM(&G!Z@A_m~I=8G2?<pl+0Oq_(uDA7Zm67t|
zk-0yFVKgXzXz<IEX>pjuvtj*%U5hvn7%^=z$k}l;kgg=V>4nA?#w{cdY;l!`f$qe3
zf)RfUe+A=5(8vw|Vp;8v$xxGk(dzEUL^g&$vG%>2l~cr=vMyc8F($AwTRz@!74gaB
zED>L&3(YBD*r%(bg(r~RwInD=Tt<rC1NaPM-kicw!FM7`0^!;QiJ<{Ygd$GKpRtcx
zzWW?pYfXY$Wc6Bp@wSGM(&2MS&)@m94Bu_Cc12JLx>~2b{3Bf{hLIaH?#^aKv5_Gg
z{nS`x<0qzeP%^#T8rWW6`Dse0KB6l2Z!x4woHAnVvqfVo%JB&h5FG-v<fU~6wCY8X
z${r6Ro{%H~*%t<fpvfhb&L0|pU_Z@J<MRW()rcu0GLLyAL4`y8x1j65D|7SreHc3h
zTo1{5dpiEoo+a_wl9@G8bj1H-w!mIth{{8Lj+EI+ko#@SXq-=+fa6KHLO8FxrPz}&
zL>1uD<7uE6_18`fwRK7kxd9EoO8u2)8(I@jd8jK1?Jk%qH<2&VErRtLg)BCPHSa12
zDO6C#he(a&e3vIhnw|4ri{h$aM3_qt#n4!P<Htq2crA~mViZAFa%XZ>nal~jJT)!3
zq=9rc6S=T0Ka1lQudwkk$oorRY{=zktl}T4AIcNRtzZPhQaWmq<_^-OBA$ui&2x<j
z9B+>H=>pVbTqCfx02H;HW(y+-BOjn=_MwCD(1hN?2T7{m!cax2#Y7~xnSKeR$8(Ji
z(icDUXvSn(npVtu7pFkO7tIiUR!XTv<9Uv8L!Z0qx;rx+X@E_RHJ&gh9m@!F<s)q0
zD6E`$7Mu29w}9_WX!4_Txa0IsJFuZHNCr=DHxwgaMG3XAzWxm4h%U6e1NNVI54`up
zK<!_x0;bX+mB-R29uzK5Z^pOEj{JZ7C0KeMCdfBq(#jZw%C0<&9hY5>FFKvuWJDOe
zmJP}9?gk#>lKV@149x?P)48`cNmW8q+ZmL8>|~7u7Hj=!xMfJq+*Dp$rI8<$;;{mc
zLnv&`n@t?42ICE>Ur@djnjHxH#-ax#_~`s`5A#^wY3Cuv3#<LNK)|TAB)@H{%8>$w
z8BXWS1ITJ$7!fv-?gOvmN7uz&$yhHcWG+?ODK!j!ZqV3Nwi3!2=Ov7NM7*!`$r5Kh
zp0iM*I#;?*TCWv9ZU7F8MSgnxa<J*M)T(}rKmo1ZC8xb0CWSRfLp8{HHm*iLW+W0t
z{{7MRoMF8x4}zlsPM!jFb*;hvTnL9M!hOm+0Yhb&sa@%e@-ORAv=2NSrdf?yMS`<U
zgaJanPf!R&x{MD}vbIU}yY_Hvzi-ARSWM~$Smpm(F*1Mrf1!i*5?Eb;jRJYg<8C3!
za%b{bs-d6>Dq^LKiYtztJFMEsyDcYlQJtbJ6w1?g>6FQlt@ZcgI!Yhw7kg2DQ8{e;
z%JVK(SR2K>`{4ENErH?$_ETZJTxP%s5^_>8)}zdJQI?Ei%i%wS-rUUjc(<$<6{QKC
zD=2P&(3?s}O+gH%6$VH%DN3>JZL2kc0Ym0`+SH9*KT?Efe}b}4OM}cMGAd3_0F@67
zBG5$@uqnOAi=5gGdi5)Nk6mIcOY2eV$|c~I&u}Z_N|b=D{k;8Nb*qd5%Tf+oR_d_p
z!U5oOIz>V4z#*eS;a~z=8C=kBHVu-H6VP1<1m;9vB*710?o1a00KZcz+#FlncBaM;
z5>-EL`y7vV49bNNbp|Nv{7#P)c)VqKthlA1VnO&ec2Clns5v+E;LmIQakJxKvRsKS
zf60n8@8G5W^;y3goAJndW|khHXQy<K!F=-E^&3P`f4rFJyJRE4=1Nxfg4CU0GQFSU
z9vRoQ5F_0#{zC;A>CrEXsoMcHLCGao_8orYevrrY069qX8Bqka=*%_%W!r_;a7coS
z9S<A+j3;_&PsD7DF#(!07VN<xB~cp-!Lv)iva2I_CYaL*o`+@X1{KPai>g?E=4Ory
z;96h15y3A>_N<)o%$IPVG<?tUbnHUQsxT&OEo!HB$*1Awy2ix$MbD68GE<6sb36P}
zb)_1xIqk>2&SyK(lg1aIv9N!82hTS4Y8@CNPIoBn;S(Ow6V78L20MMCH}W<`Jfaux
z^HpHTeyGw!jPlG2^2xUi*bmvp><1q%*>wMc0>{M24w*?JY)OpA7U>)q)+J5opWI~L
zdt-H(6739SD=n$&OX<n{FcP`Snr5Pxj<kL?Y6g2J;Jk)kSkjC&VApVE+EK?dw9x=m
zik^*zzk_nFzgHtGjYKMIed@u2-YV0dsO;0jp4@_*exZewqlw?99V%|8LPwuQx1{uj
zs6DoAmz)N9a~Dv5N$aWJ?@8c(QhEbau<(^QqsTB0<Hz7CK6<ZZcCKbCsqL>@)3dcs
z{sjIoIe6oO#zBaZ968{XbRMrKwn<*=aCidcWAMTIZbb{Y)nS!bIw`bp^N7H<d*+V_
zP!Z_O(~l(G#xFbp<<^3KN>fUS<+Z-g55eoxMIyQ1OY%%^=LoU4D*0NG#~}aF3@qb1
z(A&6r11ZKa&OONFXeqki{JZzZk@Eg#ejwju*8uz3(UP#ZW=CK%l!K-2?_f{0;kqBN
zZk>SerAR69<bB9NyjhCumfSR)qGls6zZ$d(><(cfosL|df6X~98l7o$X>r#;3L&-<
zomZE_VLY1;!W;6?Tl7hS=ixB7JeO&VZ?&@D>JV5_4O`yxO+BVQ={Y+2xz?w7zhl(0
zmw$@R3(ww(b);T1S*6cz<jn)YTk6T!4yY%sv=H07QG5YP^GLphFlTie>RaZ?rTs!h
z1@|6%<20aXkzZoUdX5{;pCtw0zc>McRI7+!slVu$o?-qOh|UNU+x&KC?4FK8HGZr&
zw65_@iFK@4#h(3_nnsZ*K>kEZDH@0+^~7@NzUx)?IPBqdL%oB`rKs0U={mYp1M5$y
zwI(mW6<Sl_0ysI8pI$WJ-uUd}oE)B#Iq`7y{hA)cLS&|-mMwCT;1fR*>y%ezDBXl;
zDD9Um(ReKWC5KwE5}Y<R55c6^6t5lr(Hb|qNnxO?IMFrNmyHny{lXJDrO8Jk-!R#@
zlSUB1fcx54b2iVQMYhYBY+K<jrH~4Do&iIXV(&rd4KG)AG?S7mA-v3gkoF%tKBwL5
zW@{KT7N_wP0b=&mIqT1>cH3SCfu&*p>-5!k7J^TXF3TfU#>PQIo8KfnP^4Q^@T0CL
zjjBUcNW1A!*n{6I*=2--&BJao9v|-TSPL}a(~jLNUkh^!IszF}>-&2NMIKkNQ@4N4
zfAgw8|25mKB19_@!e>XZU4MBXM}*JWL&CzOcNB+Dtj!07bl8snjwO9fw6_k)3jnnU
zJj#iYW64Wx7DHn)JCq;#qZ76@R30?<)@~MPIiqH#=*xFJDJ=h-975^<VoLIput2J2
zN}g}#+ae(9QhqeX@3bPnn(U<0mm-`v+@zYce9+BW^LtBnfX`DpmC*(3irwTFu^?K+
z7TB-Wv>Bf#8+H6kRI0H4e^{mkS6xdi_hxdDBX{aP-|Dj+Ew&pgwU?V^{ijeZfx{lZ
zpqV}pqza+d;-^(7_S+&q(Hr5(0xo_g6@|fjjpp`Gp@FD_W2Ht47hiW^&Ah>$T^$Zu
zbR%mZ4P`=`5|*fGspw1@)W1MP_JxCPim?HU0CyA^sM0czf+i^JY6lF`e?9a150!k+
zk|cL`Sc`4&KMo}%mtn!0znjRk+^_zE&J|@|;AYsk@KDnFg-`=#dx}m!)&gHS#2j}Z
z=4b;P-N<|KtyS`@x0>L3M)VXUpa;I8h)mag-dS^VePNSJx$92d%uLC8N;Roo9`ga2
zHj>QfN!DCXB>KHVGiE-SwC(4D2}Q8^*uz))K1a^#-*;M)khhuSE$aXYIC_$^e@h!l
zFpLNNUmz8tT*kQuxJENL1&O2dE$Z$VDOH2eSNvC=W{VP+t<mCCNcvS6qn{cCN`Sf8
z7y$;sE09Z4TwV0c`cc<<KU{$CcnX*V9z$@!_dU#Q9aCI2vdwI1XF~HqL<hD^s%;Ux
zGh?t-mddF?4$;`fP&{f|+LX`R8PR<}DzCB7FGXX?I*rSX<VueJhDSVPDwj-;T%OsP
zuYb!FXi>me_P6B?Di4G}I~=khoFGq15U3%AW<nEZwII8~eZMO$^udNk;IY^`3k6{y
zv1^>q#qkgKZy5*juf6wNi0nB|Xe3nXm$MRW9c!5}f<)NsgGCMh%M+jc<B6uE{+xrQ
z9S=4;Pru~SnA?F)eFt#aUuq1SzP%D<wd+}lriHJu?`RVcG?1c`S8^QuZ5q-M77A{S
zC~OBz311XN<n4#6Q=-nqZDpCSVLb1tr#*kEQmtg4Tw>zm#UgEBAgZtwZI+Dn4Z|56
z)eFNH%^44qv5{8?NEg4v?D8X{tV?RPGwFL*1V+d82`mSeX;f6RxX3HYusqkhdI!l9
zI0S(14`)7SX&UW+Ua+U!6`t~OuZuk_OF3sxeSZGyus5yK{v#o(`w`#Kl9YJwJ!7M-
zO>t<yzm7XPC4!0IcI)B-0U6+7i3HI2X9>`DVb`CJiVKg31VD1SwTVOHugW(Y_EQcW
z@#tK$P76B4D>m>_8X8GdWRvK_y!QLm?Y9=)4=K2!%n#Q#t{Fa}#$%F?9+de9M;lDv
zkP?PGA93d*GYmBXz0Rn~j$^IO-XkrT^t-$BnBbc?lqn;d%i<OfAZpY98P@D(nTM_>
zx5wh4KJ3Oq)Ohw-+jDTZir|JzH6(Mm`o~_?3KwEYxy=_v!tBFLSN6M==srNJ>d@ZS
z0p9w%+xGHwpVT&ulr^ZG`JeI;C5xKJaLT989iaeQkVCA%l&xuE{{~oeL{NO)mz@LV
zQTbe@yFUS)*sathiQqy3P9(Vb%Ejl$WX&7H5+SjJGV9i$VtZo@PZ0`<*>>S1D&Q!j
zEC6MEI&fkIRm=ryW8kpwM4cJP%TF!D%F2dbg4eIWEESP-&5~WFAf?Nj@sU@j4E{6r
z49Y?2f8dUS2{zr}hb=gEQ0@j8fufbzIk#~WvQYf<qfz~u0Mt7P5lpx;#^{ac&KtwI
zJ0PjyV$>1&!^Bh9=-(#{Vj2&DZOf8etc4#SMXwx%bPmde#*#0kpT<gW#a+EeQBW)|
zvt$AU;;7CH0AlQ#>V8^zCr?%9bz<u(4<$3f1B(fWFu4J17P2Vj^Fl5m7+eAYwXlA+
z`qO4$85yi-;+6nYaU3XaHnzv(W^OH^c$HH{e_-QPPG+H@7u0^2^H5|+3$VP)p-;g9
zI>qLa?^!U4$aL(*dWZDAwz+u?nqip>zhz&LfUnyKfaAkeTi7{xL1e)`nEMVv4r@RX
z3bXhOB$Ju;B$!yFEAq|5DCQe(uIzY$@`3%$vxj?B&29K*l!60JAmtI055%07g|HRN
zUC=CXv)C7T{)?O*!D%K5Ym=fj=CQ1B>6CR*_|cS`sR&N5fFi@C)S;@#-zN1F(AF9t
z&GyAMbxBE5_Ifg#zw}ssZ0<*5`;d%*3P}DrWDwGH#|#Te(ma4UdN%oixNVWw$xb*s
zMOVwtcv<!Z5dN$&g*+N6{#BNZ_i!GZoY=X|O)V=PI%OR2z5SW7TEChf_yFF~)9wVi
z>^LfO?iQ*-5D7JPny9duOxms4skSQPu)1YcVQ>SO#&QBkp%yy#aP|rHD8?d9+zodH
z^>v9R$_djK^ai{gDZpo(qH<^@SaFGb<qYUPr1m-nJ#Qv0(^~%ap4IW`jZvcKLO7Gw
zX{Nl7+xj5G5bZYPY#<YKMk96aVx+k@W^-14MoM6kQ71wskiqYK<bM#%320yU)1VSr
z%!D?Zit%<`$1aBO_Po-7!yzcShtctORNt=(bUS(E(|NaTo4E!`(>13q1|tF(V`JJ9
zL}UTqFqeqo79MRRubrV-uGi6@*HjZqTq$G0u0YIOi<ILh=ve`ras`r{0fjC8+{_yD
z3^(}+v{xhGG#H3=adr+rk0#z`T?GF-xCiDEga6<%SXEn~p%6UuUOi+=^)_UyxH#JE
z&{oHGkbSM|qCOP(>W7ibEezpE(Ilc0GG`#$lu(Edkpw)$@03GoTOmwT3arb1GKQ{R
zQ*JvwakM>IIWe6l3XO?5A4(M$f)Gxz6Wbs39AOMi8=wR6dyrkJHIfQ+(3&O1KesF=
z48DyYg<kGj6eIN*<%c*;Hqwh<U7$Uj!J*_Ud9{+^070@p#+OfURvc!7eVN|<&EkfM
z7vq#pzhAb`{P_a#T9~l&{+)8AR1w>QrLG+?vc(-|R*De%(V*~SEDicQR>#ge!G{e1
zelWruE#aW6u-q3J)iA=T1OlPJck0acfEFU%|A3VUCV0y;D_B2hdPc5*V+H7+>k+1S
z8F1E^DWEN-R1dWhi6TDLkRP%gGXYqy8XXjYr9nB8fRp#1SH&iT13dxW%K%J`j+$^H
zrfT36PNrDz2PyfqnLPVP`NQC6m@pjkEcoBQISi)<POsn7DfdAasHp<^lbf>*e!@=u
zQ~%)P89oLI^wK0oWG+;pZP4$?$kAk@I|H}C9^?xhAn|wty<8Q79!W$!=297~*jnbu
z2hZG<PT3ZPpBoW0N`o)lE4}2qJDeLW7l8)4yMD)ya@!!k2S&Ix2&f+%Rrur~7{dhM
zF4q9_nwR?cz(%zmlz~A-T@-VzrxTB$dvp<_p}yUg3o2HGbjsY&{3`H_w_g1nQc|ag
z5`Zj7WP&g<WDEGBi!c{CLCzf%ejE6v!RLPoj4=2<P%v0hl6!%lDx*YGi2kKS4vOqg
z0+pKOFClH*_ZW~L=b1F10-Fh{qz1q;%43%Y?i{x>LD>C(4=8K=t4WI$)2`aQAU@FH
zT0w`*ML~7@@&KT<!uqWZ;y|=>a#SOoEWnaT=869U=YFwBvS76&!22YAbYx!t8&*Sc
zxZK`<Z@Zia0d2Bnzv6TcODNt89?$V<4yPeBHcj<$<sH>=GO-rZ+q*xo25|*)6brO|
zDA0>TEh41gvi<MY%^#wOUBug*Q9S^gV7;hc=Q+X|df{NAI`+R01&B(0p|leIcF?-4
zXC>zb0KuP@VF23r0a%c8D)!S-3z|vGWO%>7>7l<_B$R7$l*~KIFWi3*Kf=gx5&z~z
z`4NiOj><qbLhVNGXJ{V7;5G!EuTg&$XoRd*E&_7zjLrJ<jg5j@I?#f19)qD{4q1gP
zJM}y1z5m8w;W>>y4s&`em3eJZvJ^e=Hlki4=^B4}J_THT{MAw`>wgzb0@=7#v2*uB
zVEtJ7ce&Y6K$Ye}xHxlglR(qN%nJz5%0XbZJ|<#0tN2(F;R|`Kv%q$R))>4ChNT(!
zl}M%QC)oR3cLT~%%t69o8nE6mc6=^S-oa!C`~^!xq3^jDr~ohMqejr3hZJ~SYX5VF
zh&&NaORmh)#Cu%#ZTvl)7B*-J$F_jG{HI)e1xxtI%Z8hiz+4tGaX;6e-|7N!L{aEm
zD`YY)L;>WGaV^D`6v6_{El}~f5Lhj0I1?KZF!E3!k+oNiB;-QlNGuPa^DM~VGnsdj
zyGtMj*VBM<MVVYKVB*cO)}I=lfRO)B(d$$CqY|&>nAZv0L%9ELV1fz3a5~Wtk`RE=
z`U$Rx{1+e+???9(>rp)~8{iNgwmCc?kN!7RXc)xbkYmWa(OCTxhyw%|qEwNnK>9lo
zREsGPa9AeQcoQJdhOqdzMKkC@LQ3HA1jt?~KMqLZLA)fc0#~8aY?hnhQV)INFin6s
z7os2v@^@*=4<^%YrJ#5WP(m(%n<{ekSM>xO6fm`vxcJYIeSrq_Rk!`CbI9@qRY50P
zl8Xh*gCl-t6-@MG%Be=zb-e9pXL@qb=^Ks>I06z~4}w4wOJyR^Y6IVSCqUo#tc~%r
z(mlq<hIiiWodJ=sdX7Y&`XLuK^g)E67y^4baR+>Jg@|+nc}#^JCc>iBJp1<TT*yI6
z<?%L?72Nv%K#oQdu$kZ@f(yEAeCc}xiKG4gFh?vzqV@Oi3!qPs<40uO0&Ro>&6wXx
z{#8({&^*OO%D@&_#1IfIg<y331ref}=VZFWE}&HJGA%6el;2J_oiYWai!0%uv(sZD
z0)l41Abcn2Tn}pP;-f8WxIQleRPcBPSnZr#q6=a4OY3nFMNqyOGzCP=t;mn$Imdh~
zm!IMf)PSc1AW$_HnE*~RrBX9Ej`9H#_@*G!J;mo((``i4tO}siP%;oV*C$3q{w)u3
zMlgvu`a(FmFhfO9?gW6aaRU6?$$W6$AbdTFB;4H&P`m(GKa9i%8e#YqKC=`=xX-Ju
zK~+)v3{@2%MfO9ShgI|RE-K`_O@qY2)R#x9&8$#N9GVtP0Kc0{;+Eue_!7{-K%oK1
zrNX_FF?`T3fu||o4;`O*Fu3}d=pLu(hc?T$>palYk=7gmJ)-!4c{mw-xiA5!&M8G%
zD|9IPbYOWh+#M3fW?2fkd*3i{4Mdr2#X`WD6$7`8-0W&7LHEOAh*7W1vSc6$bVRm5
zO?y_Og91;FsR#5>!RZQk#N79A6kdZ8r2`8@S2KwF^;~TmTrLb;qO#*f<OAUe=%|uy
zjQT4M10oh}5VCnnJOmU!f{8&dY<zdH)uv>bl8qDApk~Sk9HKEL9BA<Klg3{M++N@T
z`7Kf)lu^WxSRUSuuARfqEI6m@kAs0casXN=J>@4TUZ63;AiN56(cKXZqloql(sa#P
z_r(ZOtWD@Rl{B?ad4zQU8Yw%@+EQ2aG^pI0?H{RkdBEPi7ojBqH1ZrY6s^GG;QS1Z
zcW@g*P+jQEA=$+i81xm+mb4^h2gKPRI_3iMI;9<q)Pt@hnE2^2fw_{7v}&ZK+63?c
zz5Ls`O@qA~@c)Hfulx%{X(D84(vduS`B&q7R)=#{sV2wYfkNi|*sB0AkdY=(99MZD
z<0QHCBjE-Ye-0i5%TaFu=<y@1mw?F{fDKOE7P_5KYF~TsChi{c$#K2sCq+bZj3uDc
z(4+viT>^9*%|`mA@xG>}XNSidK+0IFsJWqT(f#&v(98FCh<Y?&?`Wf5At~6df#T!>
zbPn}{qE?=c6pxkoRx=y5)JD)c**w?-5SXqFj;*lhS!F9GPra0;GI`6tTYCs41vRb$
zazS4fkiew;0iF0T6}+_r5N`cgvEmh4a|nP*Xu+ClBXx!jPEGPZ81p&*%h9)4PEuaB
z0PB<rj$p-=fsi3l$*{r|M4xV(CE%aspWYh|05|MI2(|_m=6Jx!>J>sW9L|rK@dNn^
zxD8WtO>ei?j}q<b9YE=J;AFFm_1F(%k|)v|eas^L28^+D&>M0Q@1OKeBrmaIbzL>(
zVkR8ZRr<g+{ZK^Q!(n!kLb?Jgq$k`3%BZ^Bg;KU~G>nWt{&bCV{ef><9I>=`Dx&p=
z4Z6VTklh%BY5=yXe6&t9SgQjIWsW`n79ufVE?P3c%Zo-YC*BZv4I_UG*TP{|odwHx
z`?*XOP=cxm=%u*O3I2sTB^!Y?Qyv9)9y78UZxr}WR+Rf_{q}TCD`jX&9fEptdjYW!
zZh_*8L0ki4Qv$efhl_|HhZv%!R39mLd!cC14mexF-6wTCKhFn*z%qWdJn67<ou&t5
zPGP~MTAkn&o31T5y2iU&5_La!St=_9e57Rz((L{zDn#d1*vX#ZS-`Q=GOMA@1C|wI
zdSkjL*w5eZMLYfG2=&@5tkeN@;P=l<=nN(3$X_|S*i<3~0ByFh2yZmxt~%6K-w7eT
z_pTbyyc{BwHcQd?dRV_e6($!5?b8G#k@th-)yx$@o7mn@Oorb#K2Y)xF4S%VSA;bq
zuwd@qA7@;Y;`;NvKN>E7)OA4xv!M`EyQS&x7?caHn66}zSYoSti2~ZeGD3ZUf6hIs
zGxTiZ&1f00>8hdbT4+{@f0@_~#6_w>8(roQ)@Gm8YLr<}F=1JuCN<~rn+_u_^R`H~
z;WIx+oq)7jpvFzQsc`sgQi7#>&IA^yu4Qf}1g?Y+K_-g-q#2uSY<152FQ~l_BdyZU
z0gyR^wyd)E=BU_j`~o`nw}B@m3_6!#v;YJ$3m1$iS|5zi7P33oetFoW2|-|9&!EN*
z;sj+UQvkqOsD)BB13PA-=2o9}u~jX7UZ#%M`u!ehg#bFM^5;3~i%&?F_rT#SNdyc6
zH!heertXFsxI}aam)qvoKz_pQqsVy<|Iark;r(TUFP>CE=S{Z(eql+@2J+s;mAO=o
zx=ChW1F%9`OS7Q`+X#X`lG}3$gbzV18%&9!478sUxvgR^K>q0IC?74q9#9%i!0EU+
zpFR+D(rud0T?f#8Wv1bq4Q5kk*jWbzILHDV&EXC@%e)e|)1!h3v~-cny%yWAx~>kQ
zfOagrhv9WVQCZnj`8Lg~J~1Sm?%fX{r#C-34>~$m$RVrQ`rf@Y|1Ol3guvVwEEhNc
zTm`5_OK1-K+fxt=op+4*pyC8NZy5>D`*1zor1J+{Y{4QStdCV5)jrOUKY{W%LRp0>
zDy|IH-&}MFbqSy`HWjOEiPx=mb^wRYLbbuUSEx+FB?tg|oG(QyRkKu#(d{<`9TWKl
zOxNKd2d)FVa7_6ww<Z|g-%v*e^iY!_{~~aew#9YF-y09T!yh(0<JFI+hc(WEM)B$E
zE1)hICF|HXp^?%wfJ9y_`Co9lGgp3<!!l;MkaxztMM}+zT=@YpuE^<|&~-S_<)<M<
z6(mo~@`j!-dVoqXfyXGC1P&Y{79X4gk7Zhl!e$BB1>JccWvSl5DKUuikQx3?LeS=C
z(T@;|<==&%c~sXeS%S!O;5k_ph{Xxust(-)ynX@RnC<Xe>j5zOa{z>D>T6OkA2wCa
z`U)lhJ1ZUVF}4Fnq?d_2Hgs&(Ql3}r+W+%g03vEKOK3}LfRlWz0QqtAigDBT4?ueH
z*~#@yV!G(LP1ge2e&?*jC%l+H#`lJ@6w0pjh$f8vbVNP?*R+VtNXZvCBWt<YDR~p@
zJ_${oiP2;CY^&F^Bpa@!IVbE}aBLdLJ`-L1phbz0oa?0jSbh@#II?K5#l>CgR}Fv$
zed0B+aO{Q3e8<03*^wAn_RnCqfwCt#kB8jjwR&=qK`m662GO0*N9qb<=YV%rn7lO9
z@x9#d$SR#MOZ7>*`Cg7VZB4EL08O=6zwqt})&p`^|FNGdo~1(EE*ryvlWeP)>sz80
zshwz0f5mC~yCe*4d8=%=!rqdC{f)oJjvX-gV#UAw{GQ?Ue6gA1w{YG|cKtU(=4Wo;
zY=Y$1Yh<QRh9lVB;a3wtETmJ;LFX!XQvehwOuvA}e4t5Gj1SJn8wf#}YIBcUeo9Lh
zX4v<3ugy_TjyP7z;T;sllkYUl4GmOPb6f{K|4R#T0{>IGo}+I!kyL_=Zkk8i&c~^D
z4I}wi?B75A9`>BAv5HX<t>za<lJ)M>x4lJiFu~Lk24d4Bqt}qG+q8NNtrt$tkwi%G
zFd+!y=XM-v!ZwoOCCELz_`-PgU*3>@`OVb&m@zu#9mEvjG;GLU<fSp3y$R+APC+fJ
zf(`;uxeULwUHKia&Jg|<CuAorXj^TPZcFmLLxQ-w#A)Y|c+1+?vle!(C1G=Tv;=!_
zK<giZbs*pVpgm|rYEcHcf4ZLyc`q*sgLPZLVTgg9^(B!~?Q{f{IzfQcL(rjnqYikL
zkw}xzLFZMd!1_8yx?Ab6*j_c?5=zm$Cpr@*#BB!lUlz>qg);cxp)4Q2d9;R2O}^E_
zh7J+*{Jbn_!L^z&3>KaD4yw4@5!1sn`5T8yU>H*Jc0O?S+JDt?43}u!=aH+>?X#Hs
zOcnJ?*X57t@Zw{C&q-Yht7@*arg^4e3!dC(yEM(Ha=TNDfd6tw<JcWqcacCxPKXq%
zD%B(r1enCtu#bTYfDcsOB$o9GbbnteeG$Yt3;HE%yg1OQxzK+bP68!#kf75<Ze!73
z%9o$_pu+JL$!aQ8hAJEm_T?Ub!t?u*AOHQqiCp<hkUyhq@TQmsv~%RRF#wgm_$8-=
z+f3b@@`#8kg_Q-<Lpv-3CtVQARS7js1q;|t(D#q}>rCMp6~R<sic);#H3(x=NceIu
zWHcd8BECVIzW9^;R`K7En@<t7J_!-w^)20@AHy#{T4dI|zM#X`M!BY)y`~22SEK))
zgAR25l<-Cl9Jo+kDqG=pl7F1@QXMqQ%wcdAKHBBGv9jnH;0FOFKRf3ky(c{YG2v%s
zl)K@{o<9v!HQQx%f8FP{{32oXJeF}c*rF8vgvb9L7iH{hbPF2;-jgD7WoyyWvbJ8L
zi#{BlvBtBT$DH{zr-H|I;7Iwa1GUH15hLi*>4LkpL(s_r$WJb^8Z9Dq{BR-j97Y}k
zPb2Sd#Jr=d$0tS@f~m@EB7x=n7yS4EKGet(Jl$7m=g$D_c3#M<BQ3~(_dQF6M)VcS
z5i+WqAwQ3J*OEW+$^%$`NdeXI>&0ZRV7}5Z-+k1eX?BNO(Qngtsq<58<u#Nt{V04K
zx4n301MwEuvDK;2wdvY<HQBA=^^c2JesuV+QGzG@vwBgbWp4G2PD#+ORfEv;B+(W)
zLt$GHYfK^j<XuH4+ipVpJDQfqe;Dvz-}Vd&`QfHQ#9NLY8dc!P3KeY`2qUtVkqCkw
zAz6Qh)9hi8>eU-GLr=1RSSIBH^zvotA_AyqLxC#r)0Yc>-wt7Srwftn0%2zdsA`qU
z0({pwYG0A${$%`Uc`u|Ww<nY|cN)AWYtBGNgkOOz%^gW)--sN!21_fqo1Jl#I@ugm
zYBux#=0*^P2{_0yFZ{MJ|55;T^9wHK>$mL@Ci>;6=0c^|+u%13syfn-4`}?QKAnC6
zHnFwVq)q~c+}?U^&*2)KQ4HijOat8B3App1#69Ih0CC~Wrw(BdL1wgPEo~*ND1YGl
zGb{yucigJDZsZf4OKTXx{mJ5E<Siu-BGq}H=U<W9?9=<v4)~Gz!jwl$D5W%wC)h9U
ze17)ER9${vEFMNQrgA8nb<4!MU<cQxO^UeL^m>n3<Up5iI_UdMAhxVD{}R+BDslRK
z1v!==m2r?6f7+{W{+_}4yY!iw7pC@`W+SwD&fyk|yU1MHAC$J9%i6<9^Te@4V_Wl%
zW-4q!OUJyVwpw?<LMCL;7Kl_00ORNSP&P#kepEd|N?j9XnFQyLo%IN#FBlKPBm!qT
zPp=U3@4?R*Ea?PhtJcH!bWAm45UaVxFYe0Qn1W2F=nxtL&uqUDZc51I-E|x{@6NFs
zO6eGend<(7(4{eS(Glc&zF}5EZC9pLCM2-bY93;QeX&NN(o&;-^~(^Q$BL#0SH<<4
z55p;Uf(A@^qEU!;c0nRs^Uu<qC*>XHc7rC)U6s0jhyt`g=6LoHM?BTGsP%B!E9}ne
z^4wdIGD;pS%y;Z!GC1GcXxyXjGakiEAu66I0R?NE3-RGwQuiL@=wT+u=?j6Msp##{
z<t}!GDSbv#?hpBH96EwpXwD2B*J+s#`^@qJd0k<B6_{Fh*{0rRvZ)LQfS=8jXJHiC
zOq4r-7}1AA4nv#!!i!z9cjB;vpR%US{ZM)&8HKaDp$oZC{9Fi()Q4Vkv~e-_ZnupL
zBcvNh(dj?ri^i|{L>!!3yoCNk7o^2jev<OhWOn<1neqYx1^Bs>+46gTtEL>g8QhGT
znFTvzNni?;f5KK}|H7!hOvHBXJ5vj}+ebS^i*A9VM8}`vlB%%Ai}3LWycfnG&1dpE
zzuXl@w(;*@>fVlML}~<iAV*Lqc@*WVO5P76wBfo3(NwYaJlHZI#bs_+w{bT(7`$IY
zPZIjXZ8pX4c(REGC?*S3L7w{Z3r$T$WUeu1!o_GWx+-tbyB>cM0H#w?8~D8z2G8;|
zkm4<GMQ*+Pz0zL-6pl%U^3SlKzE?XS<1Hx9TrzjJ!*L!&Cylkp%3DFkx@RN^t-;I!
ze~7TWI86qXTxPBACFU0iRIC~r{}-qeIc}d<SWx1j#-Qs{58>k!(5xyUA@97!6R`)(
z-n_Tz3t;-uF+r%Q-Us1=fH@NRq(8zu8+1_qws)WDLHQ~;2Ob3|U4liQ6F*t0PAEOT
zqAGNJ<l9GQil!oN^CuF?z$2>$Kj<<k-5ymKwCv`n&P4W21Yxj}BE48ZhY}%$&>>g8
z&VDrL&oe=larO=lyo0*A(*KXSw~WfFjk-qR7Uf2y5gtmqOC$tAx=RF<29<6>QbHP}
z1f@h$1VN-5DJkie7D*8aX=%>dzVGv#?~L>3{5+1KV+eQbeeEmOnrqIvRv6D%_uaT+
zb5!z$pl&dIJ5T;A4stbD0=eW`55<62)vHb-Mes(YlzYy#|4d_m?NZTpF>kv21|M~x
zZU`;N-`lkk44swA$bA4TqD~&x7$^@4Wfo|gP$raowJwqOg2i<uJ5lH%)$oPv#UA;)
zUw*|()(Ao!X?2TdFa@b114Oj8)(lIke+5z)7j1oC6UA8lLfs5>Xpq<~NH==t(C-;9
z>no;22Q(RU^?(q>pzOOh;7P+d&+zO`RgR!OruW#ZJWaUkA$Bd)HE#Ke4cfd+7Swv^
zdCi_Dhk4~K&UMykQ)~`Q0TQ|OA|1%yDODZAQ{N}dMliqMk<B>6fvvz&FaGh(3FEyN
z?AQ2ZhZVI0w5fVjvv5%lYp^tqCIANO$wW`7UsEKMCc=W_|4_As%}N4Azh5wJ0pV3W
zMgQ&1rVHFGD}dSc4B`w2@fg+WUiZejv)yCKDRuljfo$EuCYHvEgUH8$3CZ=CuaMN0
zV|`b2kNUxZ3MR5T>wdH3T^F&{^rQQ^-yFwR`s>b%iU`N(^`Xp{Xc`*c6i4THWpu_a
zg+O%BBL-iV{g+EzpQ(JOtDPv`$jwp%+9$fx!_V!;CM~ihIp{a<2el$*bVlBO`drEb
z1CBcflCr;}WT7$=<x(N2Lu5sP5=oq;Ad_nCT&5Aw^tkyQiq=0$#Jmq4lPKz29PE8x
z1<^}<ae>`fVXFDf`KN1;!fybj>j`zgHem;vFGxW|WqEvOR9Xt7Z7@7idE)X!>Spb-
zT;ZWha*xZhRwA>n@`qE)TwXjYy39ZFOd32$eTiyoV=zUIP6EMMkpOUMhq;|mq<+x%
zuA-5mm<E<sd>0`ab9(Ul+by#iir>G%o~aFM5ct+#5D6`X=yIL2wN%LkNDw3V_wV&x
zK=&e=q>FL=Ro}dW?@S`R&|Xe*Zg$MI;j866Nf!v+KBTZ*SveXKCkmtTcea+Sz@n|<
z%-;%=^hN>?y-RKTF)0)1H}uhrX<yLHK@**0EPUd_g;BAQ09!U=5CuN~RgBt|WV+w5
zG+#J1!UQ8e9=6BAjI-6XqwiY=#^E%$u~_rnj<9FtSzgljC0K|f6Nnk`$|7Q`x}<Hq
z8Rdp;-M|p@2B{l>g2(yWC-*yVTBwdC1e|M7zRTA_Y~C@(u#Ymk21Y%~eYN4ee-X2s
zl>3_g<MNk4zE+UFke1gdy!K@gqu*^!W;ova;y_b1q38e-Vk6b(4WP7Y@f^BrRur+I
z<5Un-Ik|e8@*TPyjnoskv>E{Xu$GwzZVF8f5#F4yzS$+$Y4#Ex_SQ+UU%6R!q9+e&
znMZJrwZ3=L`~5xo&7ykE1-lV0Z1<UP!^0#0mH}X;EI@HF#`T{QkJ29XaP^dzFITe)
zmVGTc#dT7KphCg*6%fKcGH(gb$3gM6kc)CxT5bE<M@Xh11<|~RNz#{Y56x^h>Nte9
z3G<I2A`xJM<Y6u;B+u?F?jm4v@5F_IpGb<xn-Dq}ofnsmVS$e}P7;~5YI)HNkjbw;
z;e{(tP%?B(*S#w>@iF7}^SQl^5qdtIIIKR0t~how!)sL9LCu6#;=^?%-`Bo3Hp<!1
zMcX^iVG};QMx~WfUK;N$m?11^U-9)mi}%nEOl<1eeTc-rytrvWiq7F+&`^PLg1*f^
zEUJ}+(m44Eob?XeTZ6ig2Xsj`NyPu)I#UqS2ed&EV`i}ef(_X-73Sr`J>Ac^<bwcJ
zX>H{lPXCA<8>MjP6=SZfA%n+c-FN1LW)&TiU|al1m3Ub^Qj_!t!aR@{Z}MJb<dqet
zO6+aJ4ta4xpg%f?D9mF2xb*9@j!DtlaBT-v@%^FixN-l_AibTT_?gwBy*<fZ-GZ?I
zL~2ufjxwp^MR-JEqL{x^EdLbf2*rtMr}OnrZpU&fJE-76{JE&m^gb@S?oih^-XQnB
zIv(2%o|=;91&RYsH)a6ug1zgt8>^15W1kLt8ixOOCoIOR9FtfH(PMg+G>GGv`+yYo
zl3g_+9-GK`i3y@j>~(VilcwSh>~X*QWrm<DsWkj@qAt2Fu%m6s1x1YFHc4}9pXMMO
zz0jZ^IbaN<x4L*M%%aht${}a3pUmFRC4=;a?8O;xL_45H(&dIeZmkSQx28%0!=Q(M
z+`o&6eM84+fyDn8afkJVaBLSq3Dq_qt{^IvDkAkaLcOu>Zyu|1#54QRwRKCp8^@&=
z_)d)V)=*uMiHvT;f-uL57W+N06D9&L9Zuw5Rfs!TC0%2Eg?qSEashEZp>Z9BlzOq{
z>V!onEtPh{Hc`)Td`ujDYQ3Ru^T$fUbcYlu$Q=^1C6W-IvXg2xjNH3}MHwL}uN3lN
z8KRGh)yazdU=#}1i4~`f#Q4IcE5&tFQNbUVEFw-H(KoX);-Rc~96bf1(CP0=nC380
zocj^NNkjpwaa!tmldXXZsLJ#_<~3Yb%@^;FBYSUP9uMX^6NCy4eO3FG_=4sq;%M}q
z{-1u}QxCTGyyoY&;1osD+*V)vFj!8T8Qt~W?rLGjhFu=nnB2i>eOLW&vBWs6&>r6^
znux61Bs!%1+Hsz%Ux8?)w)?IV?LRiYa21F_hOvK?)yHJN{mxIovl5X!q9rQ(+{|-B
zOAiXeAEW;iI%>A@x=#6?Grk<&DD8aC>^+;dbMEYR?vx%pAGkH;TZ9u;$0EMgceEkH
zCkGVi${nj$<Zh`mne3~ca~U_E6+fw)kQx8F_RThef%m6DeZ`ou=yu;zqROiA*#X+~
zo5mL=*TmKd{i}&L`=SP8=w-TYh&d)dI>$!jx_XmZi~!Zw;EV*|v8mMdhWD4)OH2y;
zGLbtHkbD0A)5`OEoeCjoKktt!zpH|>dW=#e`|+|Uo*?#-1fg)xJ5FDm-socunHBs*
zpY$rZD8fa;8IKM~2JVzMU*;UQ-1ijyT6aVZNp5PO%&V&GC~v#I4zG8tlQqEidQ!R2
ztNKxVY|87C<;NEbaX0TNmG=sJ9$wemFHYE!r6Kgc#X6hiHhzxk!i5mn{}*BIMNENp
zVln?J2nRev7ZfT3PFcHOe>P?_Frwj%!cggGE#opf6yE(OVUB;o|B=D-7Q8W{H{TZn
z7BKiu9{XM1kL>)yS)yiw;Jb_qB++;89D8I4V-n5(M6y`OI24V);nRvw{~{utQ6PDY
zV2Hs*k0{cJqo+czJku3#y@L5Z5-1i-GTh6$Azyg*pb+O8)ZZ*-4yhVh1SvlmV6NIw
z)N&l*Eb@$ybOXAA#*h%PpLoR;Dxscvnvhd0wm+qHB8<U4Pm8Yjf4Sz>6Vw9cY#(Rw
zrQiCgqS#QhPR7qIR}#Mw6Of{fu$;dXI=xa8ax$jUd;GmE?K(iYuTPmO^ARftpuoKq
zk&6uwNDr7@YoXJ-R0R8ZQ78MmIJsG0fa<yKTfGXj7GE^Q?y{B*5(cLOnw7h7V5qx;
z4UlM%*HxkpIX|!XMVy&BcAc-uqSvrAQttm%&eIV>EpGn$XYxljQu#9BEgA?nekbM*
z>&K8=Pk9OaH<xG{dT^};6EDS84on|{k*aI!-fs6y-y5B3;5rNlq(k;^OmCD>P*|l_
z;kS#x6;e0^kH<N5*qInLYmT%<qogntB+mK=UhdR)pWp0rW=hGGeJJOTW|_GrX1cT6
z8|YBePRDx?nd>TvMVTzAj~TZq1ZkM_gDh@F6*Yi;C@CLQu+TpG8O*yQeblRf!EC`i
zvk^r3mRHl~rSVH_{CyIFvV_asdndW)koj+fa~4|N*aZ$p6A{^S^BwQ<+Cu=`>c78n
z$su5f@%O8`3$a*L>g%sD_R-ih8(F|roVEv-v4q=fEqNDz%a=X<nHiewH<hQwIz0Mn
ziRVx>?JDt&{LIcjmEHT%L;hiG*>Rf#)D11l)+)<L$%4q=<wvowfyZaY<`uToh0Dg<
zftT=ZC@@n48(n(}r<0fB4gEPl-uJIN)RmrcQytR2s_SFkiK+S&*%f<{xd@+Adj)Xg
zGS7ve#dW1#Pn=7|vr849Joi*Dk^k~~1>AJ^@rR*kg#wqfLthH<ZEK0)wD+k|Dot;y
zWY6e3H#i+5Qo^p!^-2@>*_lakD$I$t6wxtlcx@~Q*-wsJGMLTU{ZcbpJNqHdY7<1R
z$>^AD>KYa@A3X3jRNC$O<et!)Tva9soWYkFHE`7xt?OrB=ZsP7{gSDR@gdy(8O9hL
zwrR18Pqr`DmPi_)mX%<0Il~aQp{brk<8C!hLF=J$nbF8$h4&C}AX5+MgE4u74!wtx
zLOgex<bJaD?dhi!PtEwqUss{(+8Vj86J$Jp9(sQD_w?6AF`wLLsG#L-x1HEAJN+ac
z=_v%>BUAfqxmSAJDf(3Cf)mu;CirMWYbHt_xq0kR*cL&NEcWJ`QkH6+zkYcA1Xu3@
zZc6dO#JB1eA}?d0lw;5HKGkff=sgbrxK`2?JyMQwnV~`W0JWzgNQ5Fc(Ga5`>1ux;
z@DaZ)X<t(fbHvMp%1io)RBOP@dA-iwlJEW4iHMa;{j%3${W7C(B$R3OH&X&Gu?see
zWp+GRrAZyCoG3Dp5Z$Q%Gkk5V?}$nAfQMG8wea>Ig>Br2_)>8`Xy3dgD2WuCPCV+*
zNqe>a1gaMW_1aO51VWDbO6~sgaq*}#otL=hoZ@soi)9({q}@U%zVF1}G5^W7hYfHW
zD(091wjAo3ydhVFjd9Jag{LZPmm7<;KPb_St6w!e?-cHIknN1e>*V-4mu{Y**A75#
z`McK-$xor^B)FCQC3+Viw@SAyk2^X*@Bse8YfJBjYbPs{gAJ1mevGkW(W2==O+=Tj
zP}xXF9A>PMUFMR_X&R-pq~*n6VNtw&`H#Jba+q&ya#Vyk#TfYI*k2j<&DmeMif?f<
z{I>Aic=+kr7yP(fN@1=0oGAt(<9T>+;ax<Et3h#vqK%QdyNP#d_se;op*~+|(8Y|?
zko2hbGPv#))-l45k9{&56LKe;9n;bG(cvtjZfwPD)|u;&GSr;^k;D0}Z0~g<S8rYw
zk(!R&@vlgXfJs2g?e9{ZXnvXky+0Q-4}I_B>u){OYH{8hw^%uuIvt&W7fi~X(%HI+
zu&<fEBA3sH<DjHbsq{qnCukT9D*J8O)S8%P9GqW^d6wctQGY2Z8fQ>=_t#P**97H>
zo3R%`cgBy4vN|B<wP>voo5PX5qxerbvoBFb63?$A>iLi(<|vjYOgcgjKM+#hxavIW
zMP;+&z+w}md`d$15R+3LN(#k<DxLf@plw;tx*6ew6zLYuJQiaWxE@_VUE{OCiFbjr
zl|EZJ_=bMl$Io)(Fy7pi+uBbBLsY$1+;rC-aJm`a_xhv}@uE8v$WOz+HhpG$3#paE
z9;tYE;OC39Rc7r#bpH$CUQt#j%&CZaKPTs3G(@pwCZI88_Bk)!;SG8G;|cf*IAY^y
z6ltDgH3u?CU$da>WHuX?9ye1;F+)S@6KX#7C_Z4#d79NsoKt54ArcN^b^l~aq1#Pz
zS9C`FpsWQUEqEFl(g>7e{3zDB&g+c~C*uGF*(OhB#B;l;`YU-P@l?{JBK#@|@c0;Q
zs<>h@Ij2&WM88ZdsYm=Sqd<$D*B_zsmMbi@N0n8-Te3GQXp6$&6VTCpcrhX?!u~p?
zS{Fja0sPEy%D}!NzFzAOh+&I$-*9~^Q;q)iSOhm&rTjP4d~&iRf*vJ|4B9jRL~MZ_
ze)`_sw^TQC+!L{CipDl>mw4D5^fKZ5Yn6kI%LKzqDe05IF3eQ}Vw>%3Z7}b;vW;Z=
z(_ie2{%TpuPf%trwyyoo!DG-O#cVzN-1mMnuwmxu>I6aKi#Kn8NTs!a^;oQV{}0q8
zOUylPM7V<TQY}SzFt+&sYP(#=R|az!dX5gNqFuT=FM2J3q^~bvhSBhmvrPRWmz&iC
zII|y-#FdaMnBIESismO#bjVLy-~4v9p*!4KW*Nb*$^BnqX*9em&34J>)#kqWM%h-<
z$(N4tvdR<jU6pP%ft=fSk_9>w7=d7^yc{?rO07_wD3@zyBF@a!@+1xB-0X}8Os1a7
zSE|w;pBQ)T%LnB*z)gxbUxsy%+vBm>ig!m0y~Avi{|{AU3g-0Y1l@j8*z7JP5+RVW
z^e(SbHbWd8$K>~Dq))3%*&GL}Kx%-2bl9Mh*~6DwsUVymRcXR;o{rHS|Bh8w@ymrX
zV4}E--+vqI8bF~E7c|v*@9}{ZSX1g<d|~MG%cGmPDW%QwCBLY0x?T_UGpK+%l{NMV
zlu9!)XY@`Z;ByzsEnB=Ww`DQVc`lf|7Ll!L>D>E9i#4!$-RNr{VqGrDg<}?VA=$Q7
zthXPgf6a##kLOs;iEgkab875RxoZ;qByA2mkUk5lk-51@c`aU;dV|e}PhHo+n_f_S
z<xZVkd^=?PvN{|%DFH$=9;WVK;U!w0cu1OFI81cw`9W$@&}NLx+_U6L?{?muj|7=X
z+ty{ouFWk^Jdz4!X>EWIoKcC6dxvSRH)xrVS3of~YZZt=+0YvCT3QIO&1YShc_MoA
z{F-2oT^6)SVRKPUE0<({)d=W6l7{NaHg$b=_FI0kA|RC_Ze~r_d->({^T!%<m{4)K
z*W3bS_Jms0FCDCTg$yQ40pH=gexhLWnoVZo9xfRnrt-&~PU21ibR)`$nHfwzJ=I}X
zAABcDb}K0@m2vW4@2-t4w=+v(JbmOtrit)y@{Kz@>8)jJe}@nXi;u9IaV-^6wUb}V
z>HgL*32flp+XxDn){c{#vLTmCG%t@hsv<#BZvDhqQ<#%sQ(we*O7^(rytdz^_?YYH
z)Xa=iS-SPF`8xb~Cb`2Mzqw4Cqy2V3<EolL7ud5o*RuWuo%c#O$^63T$(^lpX)od2
z+!1ojX0kod^IuJVdKGhI*|aK@W-Vfeon9oMpZoi}TlA^Y^MUdA_47JQ5)KIOI|4Z#
z=jfLf*1Qs6$;y56a%6g~<z~WW#pNv#w3-5z-qysH_?B0;sq^C!B@deMO=h#p(;O(o
zxf-9S-Ag8seB#~3{(c;jTI_(2Raf}h7elJGjGd^dupQ!Mgn3EhG3)>1y7WKP%?s}?
zQ+rIkst6H|%KMW1Lepzrb`~;#$~jWXy8-vmX9}LPh#q-6c?bk!mY$2hKm8V0AY)up
zRJzc0JKWtH&h7QN8%6CLy3et#*4_`c-;nr=(M!hk=z~cu@gZ+}$Fn@ayk+|chI1Lp
z!||}n^FamLC~uqQ4hhejc{)Y3-gL_yUk>sQcD>Pb+mGbMZIwHHJb4{#yLky%CVzqX
z$+{Q7xWvchgDHOQKf=6=9ZcKyHl40A7R`kNF)8s!{P5b`d9!H1_~BV5&vt-JIe4y2
zo?lt_q!JhH#!ZWTAs_QI)KuKVqxC#d`2@$~$?IG&E{`2Elb?~zn#J@IwfnR$9;7w1
zJOeuHQPw}o+udJiq7KfYRkoTdqWUev!n<Px@QHE_P`<8A+jCb<Z#Sk;YD7+VrV-8m
zbHppmx%gRrfno@k_%hZV6BKuT+zUx&!Hh+pFa9Blm!Q!3^zf2VC^rr8#WxUUim`@!
z(8xn7HFEuY@5}z3gEq0gvBhew1ah`*L*m_q9$y>5{+rAIVFQ)-@Cl30eG~iog~nXz
zrd9sV${knzkR}l3&4bWHXE>4-+q2(Ypl#eA%!o$ae$R?De!fJNq(n-e6t>>&?rx~8
z+lKSq+KD0&5z!Caz;X_GD4olMd&P-RE0sI!`Ooxy`$Z1};w143^={RC-=}!;$DhL*
z<6Z|dAH*;-dweN145bKGc0+N|lda|o`kr{$Qhyp;955fhQx<v0TM-M5We|{L+NkhU
z_N)l}l&*(jcy-W+>UN~AWsM9bFcGc=A>L$fLx`{jq!~H6Ab%!n$jepFchNk+e}$pX
zJPU0b5Z3CYI940G0WiTglL$XQ{r!wP3!B0yjPJ|v&1h~=layws$+To?ilgSbZ&?v2
zTZ^DGti;)+vRID$HFJNs^AK3Zxjd&L6ks<qe49aockFRp@=aSH9p#X>{e^<eOD8g_
zs>Ilji%dU7|48bQ`N|<&u$8JCW~#qEUZ)i4!_`V6et076h>a;Arv1h9Bjp>|XP1zo
zNqs>Ua9fsDcciCfd?g2GV{obFb|KTP$W8+=dTN`hOrYrRRn=0Xe$GemI$XfD5Ag^L
zKi6wmjnB&l52guxqH^(?jHvzn)Jjft9$2NQ7Cs_yqq*f$?Bj7WF`usI<@Yqn6{{J-
z>BmoP@&Xc)wq{4<F3~dJk!n7kWZ?J$WH@VlVOcLaYGQShylGtPs+d~ju-_4S9X-9;
z7WYUnqiy%z`jY?*%4;9;zcn7go(6&jZ*J}SKaUpq?PU>wV6m}>vB+96<=4(<1>fi5
zTQx*NAC`j30eN^c*I*LBO~HxJj}Qz3-d6x>;w9&cBfL$y@p9_^g$W#wPyHRdb5j-5
z;IYX-{TcB>3Njsn*!h|#fv4z3*_42F<P)c-^WJA;U3a~6Gdd(x^`D(_vTtn&77l_A
z$}pN|+rbnpDq~F^Dn-&qV!xL^fAB^}RM^uK^ULHvVjjgJ-#zBUDQ~&tt_K?NsY`jf
z8n-K-(YI0$SI>z5Qk>!DzuEXU*8Mag*8^Nl#w&!^%ZK&fdhM~J@Z>VcQer^(wIdT8
zT1Y@YtU=B@W|q(FhiKCq%6~&m&roJ)D~SZrk}=Y1jTBlEmU@@~fcln#-$EAdw18$|
zW?rhFw?%%2Oklf@tMVBX@Y%Yr)W1?K2U`%`H)4K>0sbJ+b{T1vd-v%-B4lFo70z_|
zI-`$!D&<iRTSDXzHbrY7If~7@F6(}u1z~dDstm25SH^a-k*FKgrheG5;$LmvV_}eP
zU>2+M@H+LrllSztqw=G%ImkN-o__zOfkhc5$&Jns8S7q7GR0qR!J8m9N*DK`t_iJY
z>3uequN^3<%R|tu^Yy2ek9G)#%JjHXY2BL4BRw-5UYEbjL_4w2D-`o?-+kOeQw5!*
z^`hI-2118Q4l;o(<D_><2;kIZnK@l&9J`v5DPyGZL>LjH9YvZ)W1fF+_mESveBJ)A
zouNppZdgsYCxQPF-)bfyJ)I7HJIBRB*{g~?#-HqHWl|SSv+YP6U#$juUi8`grW>79
z5X{qJ8u+3H_2Z7ySsL1OnAn@$Jrz*FBZP{}EJomFGp_k?{6!Smz7^toFcC6J5bn{(
z<gJ(3a!DYK-|pkx!|_N&BwR+fgT6j<rP)p_({DCtc3ChR-;(SXanA{$(l-^7&3+$h
z<`ONY1q9*~Bz3lZVX1hLslHvJZ0Dtx-%=R=SgS{*#)CW8XP0ua)qy%(U2IEsxx#Ay
z0rmF#(DN5A3rNR=^%D)&LETs?^lPA0<?rN^kjbyY94%j65gZ{y;b1nzY34E#@5rEo
zA2vMvtW052vV7@mPPAa$%_R*s1s}qWZp~|V3?C71GYB%3Nbv1`!Rf>v;}KqV^2x~W
z<LZKnLg*{ugcHSAtdvo1w~E$&^{CdHG5F=g>0~RT<K?{v|1zjPx<yh7c8Tpeef*qh
z3Feh-lbtLT5{=W2pE_a|5<8Nucw3ZlT^|o@SEeQ`vDV-@>R5eOKo19%)WXrGO0}|X
zS3sHB4)$6MQ~1rU+lOs-B&Q3A@)S;vBGH9Nel9yQ>1{;Ji*N3m_kEvySZEpQAPs4o
z9%ovLQPj%}cvdMz(I5-vmdw!jgg)P;1cdkAAmXwUO$0R}-ty<Qxh7yBlYahfE$1;E
zNA^MX_l|Q(J%cl$GWYWfl!w`Un#o^lxD}hcN)&t##kbj^301JkP}RAS9oK1#+59xD
zF7DWMoKGsHRtFt8Y8w<AH0jX-+ahZu%ki~DH)K7f_y$R%oyO~i(h00d537?a*R^iR
z8xKU(iAXb;#*JN3C~mrcdwL3ZITgpLk+N$oe0he!S7gdx_e57ZZJ0Ka&oENwhjY)!
zHcxI59C!+15*)Sp3iVxlW6{21n$Yf<1p7GfW%Yrk27-+ECToA~l$n`MF()M@MGh(7
z6Uqv08H~M3zx`k}n?}v>7snKbNnxX8eXKKm*SA0St@BHueJ85oez-cs;~ZcS#u9|3
zSNo#%d=G2scz=T=Mck?3W?9KGX20zQw%GQmvVv@vhWG+gn+&V82_e}EEqw`fn=Lnq
z>1Xy|;EECDEzCR>I!tEGPLxnz<0qmTEUtuI2N=2j?YE*Dbu_lkRB0uQ#SBRa41^(P
z9)CQ03M8m2eo9neS!BO^(>nL6<oK~+Uhn(Up1rr?eFjcEvdRxrWKA>>@c@^9Euo~3
zzT|Q9tO9<)dy}U({L4#!&VPR@h^5g;ZDTTyj>;xYm-;ffrLsXJZO?|#*w+6@^)Wii
zkh!hiZpW%CQ);dMLQr!v>$()T_kQJsr!5Q7wfZM_-f~aMU@U!piLKu3ThcGeCWwQ*
zs3!duk-|hH4NA-zgJ(Me$$Ub{|1eKV{!TGFCM?%f8Mwtj7}{LFwthoR*PLgG>#^y*
zfZsCd6(5v_gFeX2nxA9`Wy|QwkLSGbZl^6DvHEAh@PR@S?~i+h*a5=*I;JH42}~LQ
zG^n#Ootysx>k)LQebV`7r}6uTybs*+wUZ>Tj}o*Wx49`KD_rj5J;S~+cqNbKlk4ga
z^tjrLRr~>oFjBi$x#lI0>RgceZ7Nv{q}DODbn$PV_9n)!Hl_V`_->>UoSXFpVfnM-
zvFRlpoTov1pNhcYhoxD>Zr;MP8qze!8uPTYsIIzGA3JSCeDgX=WT$zfZXlrG!}+%0
z?=#JY{JJJH)j)2J1wX2^{j<<E>Kpa)BO&CPIhqJVT-~gc!)0yc%a57RN2TJ<o*N5I
zOTF|xhhZ)$PCUge`_yiqD{uELd_}5}9H70#s0HI&z2x4JHLfe&Q)wc!+SR3ucC(``
zi7wY?c**1rFx6N)LVPmSOMHITb&)hJP`#%tVi$1qEIKS#R~laFWwU#uAs<XSDeb{b
z!`UpwhL$3&%m3f3h<E=9RI+H&7JYGM#Clpz>fDB<uWVtYtP#ENQ)CgkJc#PLN67I)
zbVC?7YN?_=;Sevhdow0vfyi`6WrnQbvZF_-5>X-k!_?f1*$Lja=VU5#uibw7PnPC!
z!S3PQF^ia?POU@**tZh?RZWd#?(BwFzI%3lhMyTny~z<zPuTFTCDE;<J_GM9(DF-_
zNIY7yq!@iO+*xd$RcYrHW}(1#bDiknfMymsVE}e7EhS%Lo!<5=5)K+rEoKsAMvs41
zMsM-3XGZ(v&e8@oAs$ab59>C!gjiW@00^H33uZGEL-L&65~MJFoV{#obu=H^=z?!b
z^GP!YNJtmnRJ!r-36K{0L~l_LG+X-|%!TgzC|1`xqgy_cq`8&F>u>oHJV6r-&wb)v
z8$&c%3q&29S4ed0)Lxx#dRSr|moj5Lceg0<$cPFpxW&%{xPQ{~lj}!74t?)jK0CqX
zNZcHf6dY8=ey^hdKel}%Sh%j$(`@D2`(*(sHbN=Uu+4I4z?8r&I|Lj}wNHwXO4lA#
zE1-j20LXnE(>>%Ng2mn5?;hbU)J54s>`&sqS@>x~+3L0k`8w~zxw=#V+F`OFVaF*O
zyD-tN3pzQ{k1(zk6Kz|Q(<h!&^s$O_cA{p$NHg?)g6(zdA*SUr0+ArI`w<>!HU)O=
z3zXMxbPu{SPl59Hz#-qv#Kr)q_CK(kDLRj;V+X;{(jw%KFUP+6(+)Gs1Vj6g1t)5W
zla~f^?|+mvC&^s+olWMbW7&Rg*s_>dr4vyXl0Wjp)i)l!R{v+l?X)h0Yg=FBiQ8u-
zY;2}NTjw-;X_DBPVO|`AjYDbY2>w)dal=>r+rx{#nJ+-y`|kNGyu)rBC0S)Pu_dL|
z*N$7#*}>e~%?8Hr4<vVE31n$w`(n=<y*G?fOr(D@X}+=GG;XokY2%lux&9@lA&w0z
zo(F!gK&LNP*?i7B7UY#l7EV5EUpJkIaM<D*XK9tW<BXS{vehq@zgQi=Ks-PZigj*o
ztD^FbKz3oJB{j+4yOclT9HpIy;h({b)(_OIZ7S^Z`uye+C)V3PTUS$`RkOVr&57Gu
znLa_!Du(P3Ot=?Msq%;`2aAv$7G3Nn3-U4Bb{2abugk;YY9@Zso<k_{h1j;@E6LqX
zmEVZ)_w_<XJl;i163yptD|*aXm1DdFGUzvbtQdzyDV2<a<E~#zSgCh!TxjUm?l_WP
znJBY-#bITIv#Wkti*}UDF+`1$eO5+XWz*17^OL5H8p5wYIb6C2C0AyUQklP|Vf3a(
z9T0t1qW7E#=XHtiB0-xBE$Lsgd>)giyiVM-zk{IcVVAfR7SLfC!d3%xp{yeN;Yb2e
ze~`{>OVmAV+8$XFX%3FJu}gTCox<tTRO7PS%G|qA3c`Qbg<3s+Fg77xL@Yn&asw5-
zDw|)52WPJ<lU++wntQ&^GIKWWmcv=xyhGiNUdxQhdmiefT)A|n(KzCM)D)QBamg&b
zWs$u?b#K3#dO<&7fnKoURM{JU;R?Z6{7)Hsq&{@Xzr0-|2xG3Bz#b9mBdSjEva27X
z*uVC(!PZxUHE={fJkI}c?;&`USp<gd6MhcUutuk&nLMnuHizUDk>**dKi8(Jih>*G
zo`_t=S4O9MgdKA!lMw}8S4JwFw~L*rKlQ3!RO2z87FUwKUtpHAgFEs2m8Gzz)k_oc
zsdFtfpPc@kA5!$%SLc=qs|N+{GcGX`97<vI#l7VBXc`OOCrJQ>3BlN!796-%s)+a+
zLb1LEyUxs>L>_(8v{C|a7B=vGw4#u`4I~cAhH}pDSx<9aQD|4I)yIU0sFQej&i_V`
zsuyGg#K$TVn^LpuE({NYQa08k>Ds0*VBd6<Nh^uSIBormGgmVde3j-}ZrSUL8SHx#
z@v6n`gO?ws{}y)?wbAb&-1snLntfV)C0z-lK#;)W2WikVoQwetBL8+4m=+gtOzOt5
zw;2P;^ZMJ?!uY~+S}bL5ys#0=ThJcR_E^pp#>;zG62!Z*nQf$LdaH&W9n|!5CBaU{
zuvg=~HXZ#ntJ(*@ADWcn+1Nbuc$2j<1teTef{JlVReaqosfZqELn+qG2Y>7PuiUFB
zS=tUNGRL#>s4k>bb!CDBKok*}Eyiv$MH^Af$%lPf-Vyi&faEtKFT&#i8**Rt(cY?M
zchqi_50%^Fao3U&5Kranxh2}X$e%t9=C!t#>{i=9uW)A>&?H^{?t3?e22&@Y5iKwG
zndU0fU8OiW%DZ<-@t()F(nKm5&Ql8Vu{f}W|6@o;eRZIkAt1MUHssUWOVc+Q-f}U#
z2{`>))Tgu1V^qyA(?7l8m43@|!$k-FNPMmOG3I!${+|2JFc#zUS`fBRFG{nEc97>t
z8!~XHj@%t{bBpnMOUJX<sB2UWl%i8Y%){Z2Q5jz&KK$y9<;+HSVO8!=Gvm=;yWPRT
zwp+jF0cJrTxfLaMMkY5d@0j_;t~NRhe_5gq6~7ST{8i;wL;{tnukZvCRHKW!DHer|
zNUV1kGBbF@)qFKtawwW9h3Hi70AQ@eE&YvhAm@d}_j#v`lsme$Ma(9dlwa65-=|c5
z5*)4fcxiISvm&N?$YW4Az#_hTDDU;!ugcLXiy7O5y27I8cL83=-Pin;GZsL$gb%GJ
zc6swCg)-tZQViG|>16IL4V)YAWA%I(isNvwC(}4IyEj(%ORIY&hdF458p}%GCem3t
z!v%{{7+3PcC6_L|xY{#N=K9`Qf`ppCz_pMfb3#31>17TOP+2%t=%v)(3vN{8&~d)R
zDjMzLk&F36ULcT7`?z3F)laekOMpnJFvRR)FFvv1(K9rOed&v<pL{^rdUV3Uv-DwN
zzm$??eW~+sWUnRErSWOzsB@YP>T560mmS+DgW6nKkNStN99(a?y&Do#CqSw^YR-+x
z@#Vl8hw^3Svc_9u8R5;`mkG&PDb|d|V6A-km0&M*WZ-(<#r#6UZP8qcJo*ll=z}Id
z>a9Fe<t!ZR;7c{ucmEiuNs)zB^llccoFqqM<4P6(GZL4!K#0Z?IMXtkCDsN5j4c)G
zE@c)S1xg_j%Yku4SE3iL-A|O!h!P%ZN54Zmv`NW-b&YnX-sjb<b;dpv_$teV({Ec?
z)1IRB?0Y>=;uGiF?-TWwy&IJi6_$AN3*UcD(oVF&9T_dRpAyoF6o@|8o-=2P;pD5B
z+MbQ^x%2vs=>-&FE-jWBrkd7c2W^HiSMr(-YZJRaGQ_TH<9yDJqpzn1x>yTsd7ZyS
zzpk#nS?=5oA~6#8%GW2;L*c${gv)kfBwsFJ4JkIM;qRVD^ldMtTU(xnr<@OTaEED(
zPC3=Ho*n7Sv5V%`51g0TZe`(+u$a+)*s~uSp6|}Sx>6cQB|o?D%`9*2r?y?_y}aoN
z6^<?ydiof7l(jBSUIt%=Qp_R<4->36>qj5CNs!Hai)6vJsxwF$q05hCVX=<X*O&R}
z+=5CTrF;ignBA#{(w$F2+U>hh`8>LZ<0HBb1zq<FGalZ$OzD+OW0vQtVtkalb~Uwh
zcx2Sgl_Yk^2J@-{3&YpZ;Z|4r7%o&ENe1N@`<RBlr=0180Ey1GANn=28-~$v$Tk|L
zwTBhjUven@km+pwGoYv^C~23d8iblBUDD18g-ZPT=8C4t6#*}6AAp0IapjvK59Q$E
zw|Do0WegQx`Fs?r3dAV*i7ODrKYQT|on(uOTi7xcJOC3c&6}6Bzh?RW(a$&DFcGj&
z;onZ=(tDJQ$@Sf*Vri7QPk~jSFS8_?-*G!YvIcD>D0nf7=<8+M%TII6iCkqYPr6O%
zZ9gAh2|wY71NS$MB>$clxZPWB*b)x`h-Tr?5s`kKd3i_a^1a@m#70wY)(<6dPwDR%
zpzCkVF^k$Sy{{wmlN7_!WS49ySPfOBJxv;^Af#L#&>gEdUhw@Tj(O9e3zyl|Nhjrb
zUMK7Jb_S0J&Icef#8HRU&Il5z$hZnj8S#E}c4fi*c>PgpSda2;W?t1aax~e1ok_;$
zqY3bp5__U_zjRZRX0qBWK6*$J1GU5uQ_FMU?4P&33ftH^<?PX_vShOs*)5zwkQ^|u
zigMe~yW2QFD;F}!6k%;E25s9vzw@<M`}^PA?2ot;MW5K6%T&-o>QKRfYnA-v*{_BG
z3_N?oYMlmp4F4lJ49w(#Bm7ZJt_++4y6|{%Opz=d;n9MUYqCGrCdy9diMB7~$uTt(
zXL_1fM?Yr@?+3Q!Z+vBv=tbKd&|mMX*cY0PGK&}`Jn~tby7z74@@G_S3%+RFVsdt$
zK)H2h6zASv2Q7+Fkp&aW>c(nYfGeFYF0sC9_(lH;Vqu`q7U&ci`|7E<`gdc$4|+wN
zXRDff;xsBB!{~yCIj~)?L~!-f+-mqmQq1IC))(7S8Rb}n8QDt)E*qIn_@e=D`R8TP
zBMg|_uI%p*fH2lT?w!2LsIc3YUIfmg-J%9XZS&dlLlfUNoz0<|?s(|@{ws>o_yf!;
z4i0~5X$({eiQ*p9yK!qKww3{5MoAKFcG7G%6fpwNm7FX3jgC(KlDjI7$!cyOxzw&q
z@?M~_Qt1Ax@Cyor889iL#X4bgP^3l1?_=4${QIv*M-y5$oTFc;&|MDK{(`0x$1NI|
zm6B}c533aLIz#h*oio17+Drj6$%xMHqJV!z*dD)symTxbkW3eE`~r2uA6(m?!P@zX
zHO#kc^8{9X^|&%t`(mi+G|16(k|eqjQhp&JxBTVaDZ*z^;8^9&5&D7>IkZ>X7n+ic
zi=OK6zOeXHWjApn{*P29JY-i!N%E80EzZt~Oj{0@d-015W|uM1lF)}GsFJ(fwL<#}
z4=yG$h*(zK%|#nSx{~>fGGbWB_XW++U|AXEs%>DR+K4i68-yL0Z*vNCeOA^Oiij1#
zqKmOYJ*7w3llGt>^u3n{-4P~151MR4ejlzfaa~piBRCKPOIaENQ=j<bYJ#;@oD5^V
zLyeOVy!SrJdHg%@Q4ES7Nc|vN)VUYn0>)0GpWJ_|dM67tce{E_sB2BIb7IjE5@6QO
zF3kO7%LAV(e`~a-^9l_5Ma&wbTZ=I=bq6P%cYNnBE+cs+WUGzb#&zSornP3BFSVyt
z+N47gZLzH6Zmh{<oDnvmlACJrqi&!C{NrU{%vn%i?pB3>$G$6?dbg<rZ5E5Bs~k-n
z551wlum(D$Kl#e>d5R@QEa-vFQW}GHGb~K>yATYr0j&G?kh@83V$fuQ(QL(PPW}y+
z5-#%Izg{~3kO1SgXL~U@t#Z$AA8$I-7+0D$Vo<<*d(P^Iq4wZvu)K)C5DpiETmTG@
zY6di5IJ-O-EO6{h&-1QRJRxKq-ZNP%5cm29yl0D8(yzUnKViE0g^JZX)6O_mh+njc
zG;}^S{~XNXo*EKy-!P=&dlV!=Hgu3mdWvIjV702L?Gg^pxm6Yelai!ExD4k$Oj0LJ
zW?uBW2uVoG?V!S*b2SjU8xv3oSj8X&4&dIB8<bncDtYI)-g`Gt8C=O@Bq(DIb4VC{
z9fuu1obLzHd+TUvMPM!iCOh8`)%!3BC((!?nD?FtSezg|a{1d5|EULu#~a7iQ)n^`
zEUQVI=xu2_aTI#sK)3y+mQ{?*1satcGZc*EOGywGufxi$0BP`dFrA?I9p(#SvT|Tw
zu*Cl%xlA*8vv&3ZQ3JikIWqn4FK0^O8)@TkUTgEmz_Rg|Oyn_AO|K=^FSmLaMRl`s
zsXKA1E1t6en7*z{qtyhUdcA{+#Ox)}u6cP8ladQ-sg`F9-btsSj>?R}truUa6B>hO
zV3Ur4D&JqFdykdL*N#dK45oo+8cl>o3Dmial}s(T!H84B1=wO}Z?t6c;YU5GDeB*&
z!@xwx1vas~v76_8HM%6*{W;85GJ}WY!4<1!8**H$W{#kF*u$CWAA|GX6wD?^prLpv
zZL?~@bxpudhLcYVJ4ZfY_yzc&peBS(azqGUb)@9Sa}e}Zlx!gA9vZn*<eMbv++YaD
zV+##JbS1~4Xf0(hP=tQ)yBKej%V*Y)(E%9dWZumjA;@=@5FdO$KeH^e=-u}0syTzg
zkTLr?(i6t`*{Q4T=*QPkaDMZ3j)RB+g<4^To#>&f0y(_-?**3-$1EI@+z}gue%e-u
z&h6al7<kGh@XQZwxpj-1kbW(V^TWVhayUKyQw4p?CM3?bUg&m9Tfl@^Cu&0Jd#&Zy
zIT!oQhvX@X$-*RNXT1(<0_ha<5zH_~Vc|E{{Y3a#&`qoI@tic3sN2W%lwCx*)1AO=
z5AGlQ^+^(-q|AA}ldn@$2}T+>mq^*fvFKm{4e)P50doRm@%DIBLgmne>ADni78^1e
zqp3|`hp^OUx$~p9K4TgXMxPvniMkG@K_PHbbfkzsSc6tlcNkZ5n_HigtmkG$mqPD`
z)@X?{4_sf_Q>il;zC748y#qdQxinVUPmNN-0?BxJmlO@ZSyg`khLYm1pu(g_m>v!b
zFf<jUM`uX)ndL@ifxrXpR-_d#ch0YzbUxFNJ1w;E<m!=!{oxax<ZHjU4CPF?Qb{|k
zk(R8Ct(2=WVFo3jZYJF?8xF39K7AGnWq7bOVlYqwQt|Bv{aE)d$-xwO#5w?uMd{1X
z#9<A#x&Fl>`!;r@b?KSGx2*{&6}L;cHXW?T!c*|swa8l0HqnKDC`d1&2*XnS+8^5l
zEFt=h&}&a~ds9S)Ss9O3F)(P1lw_r}pMk;H14Oh)JLU;h{UfJM1b;wmB|u7X5mB0*
z?!K20tZ^6`N_C!+g<&32^HWm9`Ox?PGaFZ2Dqi|7%-V4@;wb_(BlTCabx_4TWi^}m
zaF0_$D$lY%O$dbRqTpn^2L2U)(qoV;#SJ8O*X6}A=BQBYEbvq{mM&t3<K|%9yZrZl
znFpZTkQdn2tRd6~V8x9t*F*VY0_>q24D3pRztciKmHtiuL{Y<$9wKkYYPY~#^X7A1
z6f6l}SSnaw>5VpVK3oZhohB~QkLxwGVbrxf1OJH#1Us=+Ymxf<X#Tm7oKXwWaYk3h
z-zoHWSx3T#U}lBe{|~O!T#qoE^2kcV@ZTkp^kd2GD~5k=uwDM2bqOn+(GP>0VzQaP
z9i=bK-}m>W$b$9x``GzmjsMS8!2E%y(+N*UC8V-A5@H{F{S{LXC{;n6Na}VYj~-d)
ze_s@io(*BAkFT)krTo2G2!eHCJ$1!YjVu52YdAGz;83M3ytq7B?X(ctvJ`OV2iCv8
zql;lcZvWmWc!I`f3~BtGxPNazgA#T_Zaf|5;Q!rI;Jb1|;8rQG%l^BaAe&kUhS6sB
zT(Wy1($D(a)764~5N}VFns?hlU91?{8h%FiQ_<u6d%cPjNceDn{N!+_0OTF}@Q^K)
z`M~0fO2qly>GAjTO6culK0opA$Y7vcgW)SGbYIDYT-lm0Q%U3zg5%@O4fAm1B)VUq
zZ+=V2vM)uSizYGTze~-g_q$jwU})R32eQp#VDTG(HzpE$j6$EOXMG^td4OyO;Keuv
z>wdW)Q_w;l^?weEuB2^VDdKeUZ0YRu*s|4<t!p4t=JW^9K`7rI{NG>XiVR7@hf+93
z&blJVxIbtIv_+5~SA$dQ{af-_|2}p?MN#Cozs`bW#y*NturyEW{Un4TaqPjZ%SZ>Q
zKYzfVM^%jKe<lw++KfU%NxxA|HN+>w4O&X*lFGS(nq~re$6K(bJPttiJ>N%~%YCWf
z>#Y7Ed&o)ezw6hyg;JH~pqZk4(g0w!9R#>;V3Rco-9uj~ea})LfaZ8FD<JMea?QWz
z1@de;VFtn|gN;ub7`&Myb?-?aF0O%PQVEUw^dLA}^4fyQ2zNrH%6}8Ue+XuILbUyi
z2-1k|__XI3ix{@>|6Ky4$oUq|`Qq*W{dxh2P;yE}+4%qaVnsd}ng0(jVxhmP=b3-M
zV4Hu;<mn1C74#qi$Bs^c{8T~-f7p?x;bfna*jiSPR!QLEyWPL7rV^Ik1W_BZzwg+~
zp47a`LVJV5>}Z3JS7SA{>^y7ngU_h`O4rrVElc(2N*IveB!((azFZ~aG5km8K65uV
zrasdooIw-dRbBwwI15p&_n|YERV<h7t#zm%3JH3HOUMUy_Ae2186h@HUGZnwbz#FI
z*_Tkn8GyJnI5OHOcFi&1^rVW8m4{DXqO#L4!%wLcLOu1jnXWED7>%|n?IjF2Tt>Ac
zyU-{~C00aR9QYCHW#F}-BOa5Hbjg7^jZJDv$^5Qa>Kln?4T6p{V)09No@Qd>Q(GY(
zb0*vzE9PpZhYodH@`&-E9eDOybNSA9BZOgn;2^AlT3FFrZ&<$xA*v!>U#4K04nM_x
z&hrQQeA<CpU{5@s#AqOn3^7d2aXSE2zv2oFsgB)IWW++d-hXov10@HKj|?Yz_}^Ir
zt27+h(W0p=rT%^Fm}pWZ*m0PI)ghw)_l0cHuug;>QZD}Qt_8o*V1fr9J1dO$ztaVo
z^un+k%~v~-{r5gU$yk_|asdkh|IKa;|9SLm7^D~?mc41Wr)phSE$}D>I-XmyUPI|y
z6ah8tV-P7ppK^^A^Si5@_jSRPii3vn(Kj6UKQKM|Yu(msH(tle#ACsJV45oGZo&MH
zW96e46DNIvXiLRX#=RIY(&L<hjejiRV;_x--)IfTQpmq|;wM>(GjK6|?I_dbzk$i<
zgJtmldKI1ID<g?G{QqumL<H{cmQMCG;eWTMC<J3rx*9t4-{|?@Qh>o*{t!n6!RG&d
zXD4#zxt(g<`fm(0mf>VrHH>$b`R^M3hKZepw94534e>8(`1I6#O$YRU*TD1!f`yQy
z=Wp3U3_BPIb;~TGe8BeWVO5u7lFoDHq7G!*w!3T=5Z$f7*?yRKC)tL#$)6IZsY+gU
zH3g%+jj<=xNZdM{SL#NetY4wb?MUz!+Xq285-F~Ok-HGY1FjuWT5^)}Kgk;pf)OK^
zct0>|y6FZb*a^fV4%~+-AocHoQO;Lh3CmS|Fi~p0|3%_#aI(tL5!shPZ$I(<Z2zV~
z{Zm)<M`<h6)EC!PQ*V7mO3AhprP;7#dkf+1%FB(wm3Hgl`=Se>$459D+@SY?wz7<D
zFIJkzJPye1_ST@2T#wR~@5pE5MvX&}>?2r<h@^i%-Ee>HZ57DR7Cs40>}uD+{dlz8
zS_|oL76raz9G82ae!cYR4J)Zslc3)qtX)DQXhA%PoB&81clQ;G+KC&{gi|<UvGY<_
zhoIXHR)xm1y&_IN3L!h)-7MNuwx_V&WI^{sj!EdPn3d`_$?p8NLQ|i?8RrVc4JPNe
ztVeL*T|;~`2H^$dBJ{r+Wt7uaB;RiShO!46>=8~b(9=o|g7a{sEnO~bMt^(dboQJ!
zDX6>1BYEUvkfs25;dRv4$s<%D7Cb6JlE(}kPqaldErqZSpihL41mGtP>#n>X2BDmk
zbO>3P_$zw*$Cu<jQyqPC=2aU6)@v5Lna`Ow-B@NC$nvl2ei=}4?WwT^_<3nXrZ6)u
z_rQ*%0CAY1I<@E_(SXFeq)LZxw<f`Ii4$i4qOIQZ9gFiaM2Xw**&8HA+n*F~t5tYx
zJ?clScRJ{=Kc1EBza_h^icK8+?0mnfF$yUgbl}l;rmS)8o?T>@MZB`^!VdoyR&5X)
zuQ+&QnVxUQKQ}Wiz}hYS&DC@EOv1pg*}Y)gMhtW`H|4qY%X9aG(}b$!gKX7`A&yi4
zo!bL-%CTYc8sk^0hCa4|D*?RCF=r46CX-0G!Bzc8xeXl}A$m~$dmGh|eSU<liTmK>
zb6nUNZdp^M@Py1#bk^^}jnI*M<)G1R5|erN3ok0K9{RoX=q)=Fy8u%@fyd}q=<Q9_
z<qUQY1taTU`1h+Gqj#43Z(3f&`-DV5h)-qDUYyxH;_ij?R9=UX?`SQ#d;70cZlihu
z{}Xt?a4-irGBaJ2s{?4{$J4lv5c|Z}2FDZGKb8`HLJU2?mvc7$NSw?Oh-|6vPC-EL
zZRlec_{@s?NpW$R5DE;R3MIHc$I%EhID8Jcc!qsjG;KW@=VXcZ+17amvE032B#{%E
zFeBlWE_)GC<NFimE6IR|UQ}MMMSe*ov<KQWO=M2?$jM($>?eAzd^_SYt@oxst;sQX
z_K&l_PkAX~6e;SqmNYRYZzZ#PK~7f`v!1Kw8q1Rw${Qcc`u!Y*qMECiCHI<{+9|U>
zI?Y2nMmhP&p-bd_0x4SnQ5~yMsHSAkJl$WjM$$j);hbQmy;3}RKZ_3%=TRWPm}H%?
z%8GJUACf5esHPg(`T6BoAC%fEM_rD#Vq-r1(@Kr0AFJGZj6in47qEoLB=N9SY*>)L
zo3#y0Eq`(!I7Aktt1h?CSg4aMg!dOyInTd%1{RI4UF@{gX74;ZdR4<Wi&#`}kTg{(
zb9pK#`_*oBpJo3{KR<bI4?eU%Le|H#6ODiEWZ?BtnP&$f;ewMxZZzU9Hww|xlP3yw
z=z19HlaizHON^47w>bnAtjJ2F-P{fKebsn^PC8H6!<rzFHF;ijL&Ke@4p(}GTk+`b
zAv6sA^}W?qsNdz`m3)<gM9rJ``wHv#^@k(vdR@M%<OTe*D$<Al)OSy>!secvz|>WA
z?(sGx|5bdZ?b^cIEj-@O9^CzzQ1>wMAHHTVZX^2rTIx27L+RUfDA>;=|7Hn0vaFhS
zOe>V3GUQ*U<00oU{OP3#go9hd-5=`Af3_)SidTL{4<x6jDzooe<Q7{EzD+TGXyTxY
z-XgYwk{9z#ZNQrcrVfu3>d5n3YC5;UkkfJ!*g<AUzmXs6o;mz%qt-I#$D$k6Sv3>Q
zGtTd5oqR}Jh0BTN7@qomyMmQAhw(1_H-IT#`G}i=x8oN`znA42UN!)VD&)0q_l(Rt
z-!IWJuC*Ty2V3Y~+$AF8&^G-}<PE=N^x!2}KvrMWKJKk71*kotAl+SO2{<ZrufW|a
zfk|?tkXbA-CzUt8m+#|RLLYW{;q@IGzA>|?aP^TkZ?FjMVU2j2E<dl;AYr~TApCBv
zi9b~>Ytw$Y?en>!WqKZt!ewIB%SV_+A9@E$*0yRUSx+P-d%&2L1nKZyC;3v566mXU
zGM>9qmgQoYyvWRzAU-Ue?k2Z#L${OaiCYJjb&^)nw1<k`p%7uUNht_;s`Sg0DiWjD
zlX`pVuFQLi@xIeLeK^UOji7v8Y%L)n@E7+vN=l&<Jx_mqCH1$Q7o2+!)95u%Lu!MV
z#RboPLTHyC7h_pV{4#*S?6z}*?UOznk}HdkjivgF=SxlAj)Vv}&LF+ft5Tj!9QymQ
zIINtD9q%+<AUMEsp1kceFWZRsoi^!eZ8nZ!Ur}kEt*|I!7U}!&BKMgTRf<|pvHi+L
z9MxqZuH{xl!1{v1y>R>lSG#`rDh0N-9jR>7X_ov(C}Xmir}N^>HO8u6&)sDupzT_~
zHocQM$|2+dvqXmSQmfCRZ!Y7_ZeizFLJZ3<*_}sYY)(h-_0{;cS7UC@G^QK)Ga_6@
z4j-gv06~al?ZI-3UVOcYvPg#eLfu;+in30^UDP)!a~EgKPJi@RK6mKRS!8jMbv{{V
z`7Y;><FrLy_};R%(7j)Dih#{K;@LmtNuiV2mU$7=;l>R<@mVh1g|i{6W;b&1`ZCx&
zWFq{kGx1}ox~aMKN|`7@hiwwptcKOQc<=k<1L{G`4-Lh5r&gjWFP~*h)7kx&HR60j
zIGQTyiqg*S{h8zyyqn+CQBqVE{_*(Yst10b<y%V@hkHIF|8Q)olAqK4#Gb};+LRc#
zA!ya>e{Y;n8u(_5vgWyR>`?XGtyt>2pK$0Vl*ao4CGVlM-+#VI;PI8osW9M#pK1~<
zlAVbDT1JDie@u7xpla3PMY(Q(LCEm=x$R(lctqexl~A?+^;+y`2zPt&<8b4_TJmiN
zwQzw3YP;gYMC(<fNz!D3m3)>aej~v|??-}fzCBm}o>~c~&3(`CWW!#+)5i1T#-5%r
z4iaKLQp^LgVD2X`S=z1Z>O-Qn1y_x5tONP0FV75k+&MkB-H?_m`iH*kXbAQxnW!B=
zhyG#&NVH9c<b=2uJOFY0`!hlaA}`=TedoU)bs+#eS&t#se*vQ;9ps^xh`s+y;UMP^
zhFG2}sRsRTd<sYfU~PCz|3_X-$c78Cr{47^ME`vohQA~r%!-@;&x=A2ls@>u@Lv>*
zf%1m{HD(qHdH*5+8C;M7n1Ak(`!52=z(T=?(|x}Ae_Vhb+)H=B>xh5v4ekjG!fnX_
z$N%F3O5t7-F7lKAi<3gif`$+G$NK)?w_%{n=^>%{|MNh7U@dl8(L9Du6!~{FLKv0U
zWGEb7slbinz?G{h$|2BCMje*#_N#PVM5>+M9z|sUHbCn!GWaD>K!~rnj`Ws6s)9wf
z2&>wy1@GoKfZ;pJ>5gv&ZAZuZefRkdsvkdWcprnLFW@6hDa%9ZBgBg2_KNJ7I0N9q
z+tnv=?)?lKFxWB(Ry)84{{gT9(r$x1e-zBFUw;1v9U~rsF~G-qFx)Y|GUg%`@3=Yp
zc^?Sdx^T$aDjN@MA@%mZ8!}?XdFw?h@*FNR!vl!>X9da$x1=Od<&b$JSw+h6AxJbn
znl$>(5VJXr1H_cF;Pjgsq)^a3Cv*bfnVqg9<n#o$${Z$?%i;FY%;ghkXRQkY=WPyx
z=g9mal>xl`QLYm{tO!dSI{;T$R5CthB34|}%dlZSfZlcGNaL)CA@G*&Wx8~Agu4Nt
ztqEW@r70ERxxV`I>udK0*cqi96z_mlEVQ*9UIUkK{JZ-gADnXZ-JzO-z@Y$=oSDnV
zz<fVm=voGH{LU2d0C*kznJS%0gY01xn))D3&QGoftnp<dot5{X)sBJQA3#~AAh<=q
z<{LP@YXcwk_>nFc>)@W<5p97i3&}N@vL%enG5{N{WBHye&`v>e@&Msko)##QDnIsx
zu+cch$a5+FtePtpT07)GN3EyENzs&o9LuB7OL$%`UDoQ}+-GdsasbD_MYKQm25Q#-
z)!CIsC7nfaTAcE<xlCD39ZeBTJCWt2S!0@8l%eHPR%8nzj#dZB(nQK8D>FtR(A-i>
zGY~14T+`AP*GNlH%*F;WH7j!|1ySby8&CORJ`JDXo&*2;9`D_E-@U*4yOra<4znyJ
z9*5H+z79UtfRg=9{ea1eMPji*K-+7<yvZJ`fV548pJxw+5;;VK43JwnsZIx}?{bw$
zp!rV+Fi?_W^l(KpX8q);Kg_c<vzmdZjMt>hH~sc5!uYKtxe&Z5@9@_EbGgh=H25mJ
z2ysrLp=Ai3GjRmCa>ZkcUSG8`Ar=aGYgCoVk2rYR6Kxkqq}wI=q3mJ--I?&@onyIh
zpcgtu);&Qy!{)n;FFBO2AEdUQK=t8P>QTFiNeJ6dOhWO;`X1{Tid>M`46SDRyHZSA
zvr7SJur9z`uvdFy;E9vq_K;<Te?O~K76Lt&A7S$*WFgAXP4_b2$2TGdGLv%-qYyw#
zfXWeqV-mD8Xvwwp7cKWFE?S+YZ^bh-&muQBl$rM5Dtnr0YKe89801gZR`Y#ErS|cX
z9AQ~~k2x^U=RuWl1A$$Tdt3#nh^GC!{JQ7cOPUdy-Ve$XK0ywYmzmK9{YtnnTryRE
zyilx$vc2Mo`?Q7mkod7P#6bS0W;Qzr;>%?YcEr~AMWP#*X>b?X2aPjwonn?0!G0SX
zOc3e6Eq@f!qjM`Ml>v0XVOjt*wsKpnK~B%4-a@YU5DFr%tUucc*Eb2U<s-pY12r!%
zUGHFMhJk<5wa@AS>l^{DANno!)r9>n$hOr<vx#4Ujw|>>H~~zkBo{?q_LWem4x`DW
zh&k25f=N!XteXd+MBUlv-9&KPt?P`%jHiUkq8aD^#4Nz469B+%aBc2_st{>-Gd5wn
z&dsC)=&F5Qafi4AyO`$B7XqPRo?6wj<+gOJ>^M@I2phf#&}$nu`H%q~E@7y6tBdl>
z$Y-IFIoH+ZSgn+PD(=OLAXe_tjLk`LNV>t$-3-kBZkCBJOc!@{%Tr<EyZj{=rF{_k
zxr@XNEbF$3+D%0An|PVW!VZTvV798@j=(qvXMO>S>xGy2s`!vsOq1u!U)>K8A-Nj=
zM?0DjiYQ6e4!v+F?4{fIcr7N`d%2gA`Z#T#r6U3Dg*+H;zy^R+q+wKHuo@rV#*G8{
z&M}}55j_bo=D7G7BPWyTVwfdfEgJ`khtQdDVH_25<ODpiGk8np@l(-jqjxGay?P-6
z5&NpdP4gkN6%s>d1zBvAMLMHqf<^Hh4TJvDs-+EDzT#p*vi;}2l4pMPX3Cx|YAJe&
zpO~|h`>18Fd(@#_72}`ED_(^@znCEQJU<Mfz_07yz9AVSj<4&Qg#5<?XVu{+h++YQ
z=rD>K-6^&2X3aq{S3>12Xt^xX+TW4|4dGFdg<4IkLtF2WZ3%0gA(!GLr$;y+SCK@=
zN`&ugncY`Y{49cJS_Dg~C?DGLShVP$Hx@f>3`hmUlFuq*?0lLmr=41D6?_EuQt(CV
zWF^hjpi~&*yTQMCWW6{wON^zyQL_s6DUW8S1Ye1z5hoL^iQ%wfnb2uyMgG<5)uC8B
zV{CAQq6my|FQm)rGBtlmq7HP}L=nF^E}RP}^OaoJ_G=dK*SF5CZRb(1EyfO$I<uFz
z<us@e(rHp;BO&`Eg1MlF-(V>FFzPg^J#jo3bJrqCAGgn<Ha1(3QMEm%OFx;v+5A*m
zU<cp(^h?)CNLD7&@<@k^!cSFRIc?NIB6^*Hj1ekwxAvV5KKK20Ilv+847+DrR_5Cb
zuA=gVADfuIdE@2${d-QAd%Lk;XF-*551KX4G&jhTJLb7{r)~X`v@0Ha=uU&Yu@C8i
z-X^wOOydI=I$8H9n08YQSRJeGu(2?dfw`2%EETnW5#?#!mcTzUx_|TQZrSd9e;GQx
zyTCJNvo>;?agvbi3&wR4Ol*Z=`lmp}UmRWK*N?CDPQDnLqlB=>87nu9)a(97c9M6G
zhQp0-LVkx&NVYn0qf{KfZbyVS_o6l8A5kHG`OJw;pXOo>89`$6;Pq_)V?fpfvbD7I
zK)(a%x;g)T1O<R98g|=*wX7czMmxhbAS&6$UIbG$^<BGzaAbuYHqxFZIshUn3k^BX
zsb5D$J^&wXxZ2TZny3UsT}F7@Y5rLl==v@y+HsobKh-~ndOlD0+o3=81ewt}6f*{`
z`2N5dbL9xGNe`p*J^Ttd2oUM(;fJRAh_x}`lj2;_KO(YPml4q#wj8m_Q~Jjtv-3YE
aOugt~4(GDjuf7XV@WMM09EDpCo&N_lXPK=4

literal 32300
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

diff --git a/reference/figures/README-sir-figures-1.png b/reference/figures/README-sir-figures-1.png
index 7203b10eac159d77c7600aafe95a4f3043a672e5..20a8417c5aa1b551693b2ee6d44b7ba9e1af694c 100644
GIT binary patch
literal 45470
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
LSutPUJm7x-`<&)|

literal 35901
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

diff --git a/reference/figures/README-sir-figures-2.png b/reference/figures/README-sir-figures-2.png
index 1963afc53355dc3fd332480b3ec943c62530d353..b6f289d98159e6b2fa11a1ed7c211fab9339eaec 100644
GIT binary patch
literal 55060
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
H9Q3~cEqh!@

literal 45528
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
PLSQz>(lpIv#qR$A{kuzf

diff --git a/reference/figures/README-transmission-net-1.png b/reference/figures/README-transmission-net-1.png
index 6277139c12653532af1b1ccbc98b6ad2c63917f4..b3e48c13b8127bcb68fdc1b3a8c490d78bec7792 100644
GIT binary patch
literal 81295
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
Vnj)h1qD4Xe<fN1(tHe!0{y(DP6SV*U

literal 35433
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

diff --git a/reference/global-actions.html b/reference/global-actions.html
index 8aeb146d..4441511a 100644
--- a/reference/global-actions.html
+++ b/reference/global-actions.html
@@ -265,7 +265,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/index.html b/reference/index.html
index 5527d3f7..29354e5a 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -210,7 +210,7 @@ <h2 id="all-functions">All functions<a class="anchor" aria-label="anchor" href="
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/run_multiple.html b/reference/run_multiple.html
index 14a0f28e..9dc64c39 100644
--- a/reference/run_multiple.html
+++ b/reference/run_multiple.html
@@ -181,7 +181,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/tool.html b/reference/tool.html
index ceba684f..d21c953a 100644
--- a/reference/tool.html
+++ b/reference/tool.html
@@ -420,7 +420,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/reference/virus.html b/reference/virus.html
index 7c370f69..e0a00c13 100644
--- a/reference/virus.html
+++ b/reference/virus.html
@@ -369,7 +369,7 @@ <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-e
 
 
     <footer><div class="pkgdown-footer-left">
-  <p>Developed by Derek Meyer, George Vega Yon, Centers for Disease Control and Prevention.</p>
+  <p>Developed by George Vega Yon, Derek Meyer, Centers for Disease Control and Prevention.</p>
 </div>
 
 <div class="pkgdown-footer-right">
diff --git a/search.json b/search.json
index 06241624..7c1da37b 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":[]},{"path":"/CODE_OF_CONDUCT.html","id":"our-pledge","dir":"","previous_headings":"","what":"Our Pledge","title":"Contributor Covenant Code of Conduct","text":"members, contributors, leaders pledge make participation community harassment-free experience everyone, regardless age, body size, visible invisible disability, ethnicity, sex characteristics, gender identity expression, level experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, sexual identity orientation. pledge act interact ways contribute open, welcoming, diverse, inclusive, healthy community.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"our-standards","dir":"","previous_headings":"","what":"Our Standards","title":"Contributor Covenant Code of Conduct","text":"Examples behavior contributes positive environment community include: Demonstrating empathy kindness toward people respectful differing opinions, viewpoints, experiences Giving gracefully accepting constructive feedback Accepting responsibility apologizing affected mistakes, learning experience Focusing best just us individuals, overall community Examples unacceptable behavior include: use sexualized language imagery, sexual attention advances kind Trolling, insulting derogatory comments, personal political attacks Public private harassment Publishing others’ private information, physical email address, without explicit permission conduct reasonably considered inappropriate professional setting","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"enforcement-responsibilities","dir":"","previous_headings":"","what":"Enforcement Responsibilities","title":"Contributor Covenant Code of Conduct","text":"Community leaders responsible clarifying enforcing standards acceptable behavior take appropriate fair corrective action response behavior deem inappropriate, threatening, offensive, harmful. Community leaders right responsibility remove, edit, reject comments, commits, code, wiki edits, issues, contributions aligned Code Conduct, communicate reasons moderation decisions appropriate.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"scope","dir":"","previous_headings":"","what":"Scope","title":"Contributor Covenant Code of Conduct","text":"Code Conduct applies within community spaces, also applies individual officially representing community public spaces. Examples representing community include using official e-mail address, posting via official social media account, acting appointed representative online offline event.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"enforcement","dir":"","previous_headings":"","what":"Enforcement","title":"Contributor Covenant Code of Conduct","text":"Instances abusive, harassing, otherwise unacceptable behavior may reported community leaders responsible enforcement derekmeyer37@gmail.com. complaints reviewed investigated promptly fairly. community leaders obligated respect privacy security reporter incident.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"enforcement-guidelines","dir":"","previous_headings":"","what":"Enforcement Guidelines","title":"Contributor Covenant Code of Conduct","text":"Community leaders follow Community Impact Guidelines determining consequences action deem violation Code Conduct:","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_1-correction","dir":"","previous_headings":"Enforcement Guidelines","what":"1. Correction","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Use inappropriate language behavior deemed unprofessional unwelcome community. Consequence: private, written warning community leaders, providing clarity around nature violation explanation behavior inappropriate. public apology may requested.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_2-warning","dir":"","previous_headings":"Enforcement Guidelines","what":"2. Warning","title":"Contributor Covenant Code of Conduct","text":"Community Impact: violation single incident series actions. Consequence: warning consequences continued behavior. interaction people involved, including unsolicited interaction enforcing Code Conduct, specified period time. includes avoiding interactions community spaces well external channels like social media. Violating terms may lead temporary permanent ban.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_3-temporary-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"3. Temporary Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: serious violation community standards, including sustained inappropriate behavior. Consequence: temporary ban sort interaction public communication community specified period time. public private interaction people involved, including unsolicited interaction enforcing Code Conduct, allowed period. Violating terms may lead permanent ban.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_4-permanent-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"4. Permanent Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Demonstrating pattern violation community standards, including sustained inappropriate behavior, harassment individual, aggression toward disparagement classes individuals. Consequence: permanent ban sort public interaction within community.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"attribution","dir":"","previous_headings":"","what":"Attribution","title":"Contributor Covenant Code of Conduct","text":"Code Conduct adapted Contributor Covenant, version 2.1, available https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. Community Impact Guidelines inspired Mozilla’s code conduct enforcement ladder. answers common questions code conduct, see FAQ https://www.contributor-covenant.org/faq. Translations available https://www.contributor-covenant.org/translations.","code":""},{"path":"/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2023 George G. Vega Yon Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":[]},{"path":"/articles/getting-started.html","id":"setup-and-running-the-model","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Setup and running the model","title":"Getting started with epiworldR","text":"example implements social network parameters listed within ModelSIRCONN function. virus name specified (COVID-19), 50000 agents initialized, virus prevalence 0.001 declared, agent contact two others (contact_rate), transmission rate given agent 0.3, recovery rate set 13\\frac{1}{3}. create model epiworldR, simply use ModelSIRCONN function. , example take basic features epiworldR. Printing model shows us information. Nevertheless, can extract detailed information using summary method. First, name model, population size, number entities (think public spaces agents can make social contact one another), duration days, number viruses, amount time last replicate took run (last run elapsed t), rewiring status (). model also includes list global actions (interventions) called model run. Next, see list viruses used model. case, COVID-19 virus used. Note epiworldR can include one virus model. Tool(s) lists agents’ tools fight virus. Examples may include masking, vaccines, social distancing, etc. model, tools specified. Lastly, model parameters listed. execute model, use run function SIR model object, number simulation days, optional seed reproducibility. Next, print results simulated model using model_sir. two additional sections included summary running model. First, see distribution population time 50. section describes flow agents state (SIR) 50 days. example, ’ll see number agents susceptible state decreased 49,995 3,245, number agents infected state increased 5 1, recovered agents increased 46,754 50 days. counts states change based model parameters simulation run-time. transmission probabilities section outputs 3x3 matrix describes probability moving one state another. example, susceptible row, agent 0.95 probability remaining susceptible state 0.05 probability moving susceptible state infected state. Notice chance skipping states. words, agent can’t jump susceptible state recovered state; agent must pass infected state progress recovered state. logic applies moving backward; agent become susceptible infection.","code":"library(epiworldR) model_sir <- ModelSIRCONN(   name              = \"COVID-19\",   n                 = 50000,    prevalence        = 0.0001,    contact_rate      = 2,   transmission_rate = 0.5,   recovery_rate     = 1/3   )  # Printing the model model_sir #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 50000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. The model hasn't been run yet. summary(model_sir) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) (connected) #> Population size     : 50000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 0 (of 0) #> Number of viruses   : 1 #> Last run elapsed t  : - #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - COVID-19 #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate      : 2.0000 #>  - Recovery rate     : 0.3333 #>  - Transmission rate : 0.5000 run(model_sir, ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. summary(model_sir) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) (connected) #> Population size     : 50000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 50 (of 50) #> Number of viruses   : 1 #> Last run elapsed t  : 96.00ms #> Last run speed      : 25.78 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - COVID-19 #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate      : 2.0000 #>  - Recovery rate     : 0.3333 #>  - Transmission rate : 0.5000 #>  #> Distribution of the population at time 50: #>   - (0) Susceptible : 49995 -> 3245 #>   - (1) Infected    :     5 -> 1 #>   - (2) Recovered   :     0 -> 46754 #>  #> Transition Probabilities: #>  - Susceptible  0.95  0.05  0.00 #>  - Infected     0.00  0.68  0.32 #>  - Recovered    0.00  0.00  1.00"},{"path":[]},{"path":"/articles/getting-started.html","id":"extracting-information","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Extracting information","title":"Getting started with epiworldR","text":"running epiworldR model, list functions can called using epiworld model object. demonstrate, start basic plot get_hist_total functions.  evident plot, SIR model constructed epiworldR displays changes susceptible, infected, recovered case counts time (days). Notice certain amount time, curves flatten. , table representation plot printed, complete state within SIR model, date, agent counts. essential statistic epidemiological models reproductive number: epiworldR method plot reproductive number automatically. function takes average values table date repeats data accounted .  Another typical piece information daily incidence. number new cases per day. epiworldR, can get incidence looking daily transitions states. Although function get_hist_transition_matrix provides desired data, function plot_incidence nice wrapper visualizing data:","code":"methods(class = \"epiworld_model\") #>  [1] add_tool                   add_virus                  #>  [3] agents_from_edgelist       agents_smallworld          #>  [5] get_agents                 get_hist_tool              #>  [7] get_hist_total             get_hist_transition_matrix #>  [9] get_hist_virus             get_n_replicates           #> [11] get_n_tools                get_n_viruses              #> [13] get_name                   get_ndays                  #> [15] get_param                  get_reproductive_number    #> [17] get_states                 get_today_total            #> [19] get_transition_probability get_transmissions          #> [21] print                      queuing_off                #> [23] queuing_on                 run_multiple               #> [25] run                        set_name                   #> [27] set_param                  size                       #> [29] summary                    verbose_off                #> [31] verbose_on                 #> see '?methods' for accessing help and source code plot(model_sir) head(get_hist_total(model_sir)) #>   date       state counts #> 1    0 Susceptible  49995 #> 2    0    Infected      5 #> 3    0   Recovered      0 #> 4    1 Susceptible  49987 #> 5    1    Infected     13 #> 6    1   Recovered      0 repnum <- get_reproductive_number(model_sir) head(repnum) #>   virus_id    virus source source_exposure_date rt #> 1        0 COVID-19  34927                   48  0 #> 2        0 COVID-19   2868                   45  0 #> 3        0 COVID-19   6747                   42  0 #> 4        0 COVID-19  35511                   41  0 #> 5        0 COVID-19   3593                   41  0 #> 6        0 COVID-19  41396                   40  0 x <- plot(repnum, type = \"b\") subset(x, date == 10) # Reproductive number on day 10 #>    virus_id    virus date      avg   n       sd lb ub #> 11        0 COVID-19   10 2.366379 696 2.096099  0  7 plot_incidence(model_sir)"},{"path":"/articles/getting-started.html","id":"adding-more-virusesviruses","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Adding more viruses/viruses","title":"Getting started with epiworldR","text":"epiworldR supports multi-virus models. code gives instructions implement . Using virus function, give name new virus/virus corresponding probability infecting given agent. example, prob_infecting set 1.0, making highly contagious. officially add new virus model, use add_virus function calling original epiworldR model object, new virus, new virus’ prevalence (set 0.01 example). running updated model new virus included 50 days, output describes simulation. confirm flu included, notice presence “Flu” Virus(es) section output. output interpretable specified previous sections. Plotting previous model (including flu) yields following. Notice presence two reproductive numbers plotted time. Variant 0 refers COVID-19, virus 1 refers flu.","code":"# Building the virus flu <- virus(   name = \"Flu\", prob_infecting = .3,   prevalence = .0001, as_proportion = TRUE   )  # Adding the virus to the model add_virus(model_sir, flu) run(model_sir, ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. model_sir #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 50000 agents, 2 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 3227 Susceptible, 3 Infected, and 46770 Recovered. repnum2 <- get_reproductive_number(model_sir)  op <- par(mfrow = c(2,1)) plot(model_sir) plot(repnum2, type=\"b\") par(op)"},{"path":"/articles/getting-started.html","id":"tools","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Tools","title":"Getting started with epiworldR","text":"Now, implementation tools combat viruses viruses model demonstrated. First, sake simplicity, remove flu virus SIR model object (keep mind index flu virus model object 1). Next, provide parameters new tool using tool function. parameters include name tool, reduction probabilities SIR model parameters, increased probability recovery option. order add tool SIR model, use add_tool function SIR model object, new tool, prevalence tool. example, assume 85% population received vaccination.","code":"# Removing the flu virus from the model rm_virus(model_sir, 1)  vaccine <- tool(   name = \"Vaccine\",   prevalence = 0.5,   as_proportion = TRUE,   susceptibility_reduction = .9,   transmission_reduction = .5,   recovery_enhancer = .5,    death_reduction = .9 )  add_tool(model_sir, vaccine) run(model_sir, ndays = 50, seed = 1231) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. repnum3 <- get_reproductive_number(model_sir)  op <- par(mfrow = c(2,1)) plot_incidence(model_sir) plot(repnum3, type=\"b\") par(op)"},{"path":"/articles/implementation.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Implementation details of epiworldR","text":"following vignette provides detailed information implementation epiworldR. package wrapper C++ package epiworld, framework building agent-based models.1","code":""},{"path":"/articles/implementation.html","id":"general-flow-of-the-models","dir":"Articles","previous_headings":"","what":"General flow of the models","title":"Implementation details of epiworldR","text":"core function epiworldR run() function. function executes model saves results database part underlying C++ object. package implements discrete-time ABM, meaning model executed discrete steps (e.g., days). run() function executes following steps: model reset(), involves: () resetting agents, available, restoring population backup2, (b) resetting database, (c) distributing viruses tools, (d) setting initial state agents. steps fixing current_date = 0. model’s state recorded database, current_date incremented 1. resetting model, start iterative process repeating following steps: state agent updated. States updated according corresponding update_state function. Since model discrete-time, state changes stored promises, meaning agents’ states updated immediately. Instead, state updated end updates. done avoid updating state agent using updated state update state another agent. example, agent ii infects agent jj, agent jj able infect agent ii step. update schedule laid , changes made effective, , instance, individuals became infected update start next step infected state. Global actions executed. also change agents’ states, just like previous step, changes stored promises made effective actions evaluated. model’s state recorded database, current_date incremented 1. model checks whether simulation stop. simulation stop, model stops. Otherwise, model goes back step . steps included epiworld epiworldR network rewiring mutation viruses. implemented future versions epiworldR.","code":""},{"path":[]},{"path":"/articles/implementation.html","id":"transmission-probability","dir":"Articles","previous_headings":"Computing probabilities","what":"Transmission probability","title":"Implementation details of epiworldR","text":"Generally, epiworldR assumes step simulation, susceptible agents can acquire disease one infected agent. probability transmission ii jj given following formula: P(→j|one)=pij×∏k≠(1−pkj)∏k(1−pkj)+∑kpkj×∏l≠k(1−plj) P(\\j| \\mbox{one}) = \\frac{p_{ij} \\times \\prod_{k\\neq }\\left(1 - p_{kj}\\right)}{\\prod_k\\left(1 - p_{kj}\\right) + \\sum_k p_{kj} \\times \\prod_{l\\neq k}\\left(1 - p_{lj}\\right)} adjusted probabilities pijp_{ij} computed function ii, jj, virus. following section describes probabilities computed.","code":""},{"path":"/articles/implementation.html","id":"adjusted-probabilities","dir":"Articles","previous_headings":"Computing probabilities","what":"Adjusted probabilities","title":"Implementation details of epiworldR","text":"Viruses tools provide way adjust agents move states. Viruses epiworldR contain various baseline probabilities used across models, including transmission, recovery, death. hand, tools alter probabilities reducing/increasing . Furthermore, tools alter agents’ susceptibility, infectiousness, recovery, death probabilities. Currently, tools alter probabilities constant factor, pij=pv×(1−factorhost)×(1−factortarget) p_{ij} = p_{v} \\times \\left(1 - factor_{host}\\right) \\times \\left(1 - factor_{target}\\right) pvp_{v} raw transmission probability virus vv, factortfactor_{t} increasing/reducing factors tools process. example, p_v 0.9, host wearing mask, factormask host=0.3factor_{\\mbox{mask host}} = 0.3 target vaccinated, factorvaccinated target=0.5factor_{\\mbox{vaccinated target}} = 0.5, adjusted probability pijp_{ij} 0.9×(1−0.3)×(1−0.5)=0.270.9 \\times (1 - 0.3) \\times (1 - 0.5) = 0.27. agents one tool, factors combined follows: factoragent=1−∏t∈toolsagent(1−factort) factor_{agent} = 1 - \\prod_{t\\tools_{agent}}\\left(1 - factor_{t}\\right) Therefore, example, vaccinated agent wearing mask factor 1−(1−0.30)×(1−0.5)=0.651 - (1 - 0.30) \\times (1 - 0.5) = 0.65. adjusted probabilities principle also applies recovery rates SIR SEIR models.","code":""},{"path":"/articles/implementation.html","id":"transmission-in-connected-modelsmodels","dir":"Articles","previous_headings":"Computing probabilities","what":"Transmission in connected models3","title":"Implementation details of epiworldR","text":"“connected” models provide version agents live fully connected network. means agent can infect agent, making version similar typical compartmental models. models, transmission probability depends contact rate. susceptible agent, transmission process simulated follows: number contacts cc drawn binomial distribution parameters nn pp, nn number agents p=p =contact_rate/n/ n. , cc agents randomly selected population. Transmission can occur agents susceptible agent. probability transmission cc agents calculated described previous section.","code":""},{"path":"/articles/mixing.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Mixing models","text":"vignette shows create mixing model using epiworldR package. Mixing models feature multiple populations. group, called Entities, subset agents. agents can interact within group agents groups. contact matrix defines interaction agents.","code":""},{"path":"/articles/mixing.html","id":"an-seir-model-with-mixing","dir":"Articles","previous_headings":"","what":"An SEIR model with mixing","title":"Mixing models","text":"example, simulate outbreak featuring three populations. contact matrix defined follows: [0.90.050.050.10.80.10.10.20.7] \\left[% \\begin{array}{ccc} 0.9 & 0.05 & 0.05 \\\\ 0.1 & 0.8 & 0.1 \\\\ 0.1 & 0.2 & 0.7 \\\\ \\end{array}% \\right] matrix represents probability agent population ii interacting agent population jj. matrix row-stochastic, meaning sum row equal 1. build model using entity class epiworld. following code chunk instantiates three entities contact matrix. hand, can proceed create mixing model. following code chunk creates model, SEIR mixing, adds entities model: function add_entity adds corresponding entity. default behavior randomly assigns agents entities beginning simulation. Agents may assigned one entity. following code-chunk simulates model 100 days, summarizes results, plots incidence curve:","code":"library(epiworldR)  e1 <- entity(\"Population 1\", 3e3, as_proportion = FALSE) e2 <- entity(\"Population 2\", 3e3, as_proportion = FALSE) e3 <- entity(\"Population 3\", 3e3, as_proportion = FALSE)  # Row-stochastic matrix (rowsums 1) cmatrix <- c(   c(0.9, 0.05, 0.05),   c(0.1, 0.8, 0.1),   c(0.1, 0.2, 0.7) ) |> matrix(byrow = TRUE, nrow = 3) N <- 9e3  flu_model <- ModelSEIRMixing(   name              = \"Flu\",   n                 = N,   prevalence        = 1 / N,   contact_rate      = 20,   transmission_rate = 0.1,   recovery_rate     = 1 / 7,   incubation_days   = 7,   contact_matrix    = cmatrix )  # Adding the entities  flu_model |>   add_entity(e1) |>   add_entity(e2) |>   add_entity(e3) set.seed(331) run(flu_model, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(flu_model) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Exposed-Infected-Removed (SEIR) with Mixing #> Population size     : 9000 #> Agents' data        : (none) #> Number of entities  : 3 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 126.00ms #> Last run speed      : 7.12 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - Flu #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Avg. Incubation days : 7.0000 #>  - Contact rate         : 20.0000 #>  - Prob. Recovery       : 0.1429 #>  - Prob. Transmission   : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible : 8999 -> 137 #>   - (1) Exposed     :    1 -> 35 #>   - (2) Infected    :    0 -> 139 #>   - (3) Recovered   :    0 -> 8689 #>  #> Transition Probabilities: #>  - Susceptible  0.96  0.04  0.00  0.00 #>  - Exposed      0.00  0.84  0.16  0.00 #>  - Infected     0.00  0.00  0.86  0.14 #>  - Recovered    0.00  0.00  0.00  1.00 plot_incidence(flu_model)"},{"path":"/articles/mixing.html","id":"investigating-the-history","dir":"Articles","previous_headings":"","what":"Investigating the history","title":"Mixing models","text":"running simulation, possible question : many agents entity infected day? following code chunk retrieves agents entity transmissions occurred simulation: can retrieve daily incidence entity merging transmissions agents’ entities. following code chunk accomplishes : information, can now visualize daily incidence entity. following code chunk plots daily incidence entity:","code":"library(data.table)  agents_entities <- lapply(get_entities(flu_model), \\(e) {   entity_get_agents(e) }) |> rbindlist()  head(agents_entities) #>    agent entity #>    <int>  <int> #> 1:   507      0 #> 2:  1710      0 #> 3:  8984      0 #> 4:  7844      0 #> 5:   760      0 #> 6:  4379      0 # Retrieving the transmissions transmissions <- get_transmissions(flu_model) |>   data.table()  # We only need the date and the source transmissions <- subset(   transmissions,   select = c(\"date\", \"source\") )  # Attaching the entity to the source transmissions <- merge(   transmissions,   agents_entities,   by.x = \"source\", by.y = \"agent\" )  # Aggregating by date x entity (counts) transmissions <- transmissions[, .N, by = .(date, entity)]  # Taking a look at the data head(transmissions) #>     date entity     N #>    <int>  <int> <int> #> 1:    75      1    12 #> 2:    47      0   114 #> 3:    51      0   133 #> 4:    52      0   152 #> 5:    47      2    74 #> 6:    48      2    87 setorder(transmissions, date, entity)  ran <- range(transmissions$N) transmissions[entity == 0, plot(   x = date, y = N, type = \"l\", col = \"black\", ylim = ran)] #> NULL transmissions[entity == 1, lines(x = date, y = N, col = \"red\")] #> NULL transmissions[entity == 2, lines(x = date, y = N, col = \"blue\")] #> NULL  legend(   \"topright\",   legend = c(\"Population 1\", \"Population 2\", \"Population 3\"),   col = c(\"black\", \"red\", \"blue\"),   lty = 1 )"},{"path":"/articles/run-multiple.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Run Multiple","text":"purpose “run_multiple” function run specified number simulations using model object. , function makes possible compare model results across several separate repeated simulations.","code":""},{"path":[]},{"path":"/articles/run-multiple.html","id":"setup-and-running-model","dir":"Articles","previous_headings":"Example: Simulating a SEIRCONN Model 50 Times","what":"Setup and Running Model","title":"Run Multiple","text":"use “run_multiple” function epiworld, create epimodel choice; case, example uses SEIRCONN model COVID-19, 100000 people, initial prevalence 0.0001 (0.01%), contact rate 2, probability transmission 0.5, total 7 incubation days, probability recovery 13\\frac{1}{3}.","code":"library(epiworldR) model_seirconn <- ModelSEIRCONN(   name              = \"COVID-19\",   n                 = 10000,    prevalence        = 0.0001,    contact_rate      = 2,   transmission_rate = 0.5,   incubation_days   = 7,   recovery_rate     = 1/3   )"},{"path":"/articles/run-multiple.html","id":"generating-a-saver","dir":"Articles","previous_headings":"Example: Simulating a SEIRCONN Model 50 Times","what":"Generating a Saver","title":"Run Multiple","text":"Next, generate saver purpose extracting “total_hist” “reproductive” information model object. Now, use “run_multiple” function model object, number desired days run simulation, number simulations run, number threads parallel computing. Using “run_multiple_get_results” function, extract results model object simulated 50 times comparison across simulations.","code":"# Generating a saver saver <- make_saver(\"total_hist\", \"reproductive\") # Running and printing run_multiple(model_seirconn, ndays = 50, nsims = 50, saver = saver, nthreads = 2) #> Starting multiple runs (50) using 2 thread(s) #> _________________________________________________________________________ #> _________________________________________________________________________ #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. # Retrieving the results ans <- run_multiple_get_results(model_seirconn) head(ans$total_hist) #>   sim_num date nviruses       state counts #> 1       1    0        1 Susceptible   9999 #> 2       1    0        1     Exposed      1 #> 3       1    0        1    Infected      0 #> 4       1    0        1   Recovered      0 #> 5       1    1        1 Susceptible   9999 #> 6       1    1        1     Exposed      1 head(ans$reproductive) #>   sim_num virus_id    virus source source_exposure_date rt #> 1       2        0 COVID-19   9315                   50  0 #> 2       2        0 COVID-19   9075                   50  0 #> 3       2        0 COVID-19   8775                   50  0 #> 4       2        0 COVID-19   8745                   50  0 #> 5       2        0 COVID-19   8742                   50  0 #> 6       2        0 COVID-19   8325                   50  0"},{"path":"/articles/run-multiple.html","id":"plotting","dir":"Articles","previous_headings":"Example: Simulating a SEIRCONN Model 50 Times","what":"Plotting","title":"Run Multiple","text":"plot epicurves reproductive numbers time using boxplots, extract results model object using “run_multiple_get_results”. example, dates filtered less equal 20 observe epicurves first 20 days. Notice boxplot table represents observed values 50 simulations date.  view plot reproductive number 50 days 50 simulations, store reproductive results new object using “run_multiple_get_results”, plot using “boxplot” function. Notice source exposure date displays boxplot representing distribution reproductive numbers across 50 simulations. expected, reproductive number average, decreases time.","code":"seirconn_50 <- run_multiple_get_results(model_seirconn)$total_hist seirconn_50 <- seirconn_50[seirconn_50$date <= 20,] plot(seirconn_50) seirconn_50_r <- run_multiple_get_results(model_seirconn)$reproductive plot(seirconn_50_r) # boxplot(rt ~ source_exposure_date, data = seirconn_50_r, #         main = \"Reproductive Number\", #         xlab = \"Source Exposure Date\", #         ylab = \"rt\", #         border = \"black\", #         las = 2)"},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Derek Meyer. Author, maintainer. George Vega Yon. Author. Susan Holmes. Reviewer.            JOSS reviewer Abinash Satapathy. Reviewer.            JOSS reviewer Carinogurjao. Reviewer. Centers Disease Control Prevention. Funder.           Award number 1U01CK000585; 75D30121F00003","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Meyer, Derek Vega Yon, George (2023). epiworldR: Fast Agent-Based Epi Models. Journal Open Source Software, 8(90), 5781, https://doi.org/10.21105/joss.05781 Meyer D, Vega Yon G (????). epiworldR: Fast Agent-Based Epi Models. R package version 0.3-2, https://github.com/UofUEpiBio/epiworldR.","code":"@Article{,   entry = {Article},   title = {epiworldR: Fast Agent-Based Epi Models},   author = {Derek Meyer and George {Vega Yon}},   journal = {The Journal of Open Source Software},   year = {2023},   month = {oct},   volume = {8},   number = {90},   doi = {10.21105/joss.05781},   url = {https://joss.theoj.org/papers/10.21105/joss.05781}, } @Manual{,   title = {{{epiworldR: Fast Agent-Based Epi Models}}},   author = {Derek Meyer and George {Vega Yon}},   note = {R package version 0.3-2},   url = {https://github.com/UofUEpiBio/epiworldR}, }"},{"path":"/index.html","id":"epiworldr","dir":"","previous_headings":"","what":"Fast Agent-Based Epi Models","title":"Fast Agent-Based Epi Models","text":"R package wrapper C++ library epiworld. provides general framework modeling disease transmission using agent-based models. main features include: Fast simulation average 30 million agents/day per second. One model can include multiple diseases. Policies (tools) can multiple user-defined. Transmission can function agents’ features. ---box parallelization multiple simulations. package’s description: flexible framework Agent-Based Models (ABM), epiworldR package provides methods prototyping disease outbreaks transmission models using C++ backend, making fast. supports multiple epidemiological models, including Susceptible-Infected-Susceptible (SIS), Susceptible-Infected-Removed (SIR), Susceptible-Exposed-Infected-Removed (SEIR), others, involving arbitrary mitigation policies multiple-disease models. Users can specify infectiousness/susceptibility rates function agents’ features, providing great complexity model dynamics. Furthermore, epiworldR ideal simulation studies featuring large populations. Current available models: ModelDiffNet ModelSEIR ModelSEIRCONN ModelSEIRD ModelSEIRDCONN ModelSEIRMixing ModelSIR ModelSIRCONN ModelSIRD ModelSIRDCONN ModelSIRLogit ModelSIRMixing ModelSIS ModelSISD ModelSURV","code":""},{"path":"/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Fast Agent-Based Epi Models","text":"can install development version epiworldR GitHub : CRAN","code":"devtools::install_github(\"UofUEpiBio/epiworldR\") install.packages(\"epiworldR\")"},{"path":"/index.html","id":"examples","dir":"","previous_headings":"","what":"Examples","title":"Fast Agent-Based Epi Models","text":"R package includes several popular epidemiological models, including SIS, SIR, SEIR using either fully connected graph (similar compartmental model) user-defined network.","code":""},{"path":"/index.html","id":"sir-model-using-a-random-graph","dir":"","previous_headings":"","what":"SIR model using a random graph","title":"Fast Agent-Based Epi Models","text":"Susceptible-Infected-Recovered model features population 100,000 agents simulated small-world network. agent connected ten agents. One percent population virus, 70% chance transmission. Infected individuals recover 0.3 rate: Visualizing outputs","code":"library(epiworldR)  # Creating a SIR model sir <- ModelSIR(   name              = \"COVID-19\",   prevalence        = .01,   transmission_rate = .7,   recovery          = .3   ) |>   # Adding a Small world population    agents_smallworld(n = 100000, k = 10, d = FALSE, p = .01) |>   # Running the model for 50 days   run(ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  sir #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered (SIR) #> It features 100000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 822 Susceptible, 415 Infected, and 98763 Recovered. summary(sir) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Recovered (SIR) #> Population size     : 100000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 50 (of 50) #> Number of viruses   : 1 #> Last run elapsed t  : 134.00ms #> Last run speed      : 37.07 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  (none) #>  #> Virus(es): #>  - COVID-19 #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Recovery rate     : 0.3000 #>  - Transmission rate : 0.7000 #>  #> Distribution of the population at time 50: #>   - (0) Susceptible :  99000 -> 822 #>   - (1) Infected    :   1000 -> 415 #>   - (2) Recovered   :      0 -> 98763 #>  #> Transition Probabilities: #>  - Susceptible  0.91  0.09  0.00 #>  - Infected     0.00  0.70  0.30 #>  - Recovered    0.00  0.00  1.00 plot(sir) plot_incidence(sir)"},{"path":"/index.html","id":"seir-model-with-a-fully-connected-graph","dir":"","previous_headings":"","what":"SEIR model with a fully connected graph","title":"Fast Agent-Based Epi Models","text":"SEIR model similar SIR model includes exposed state. , simulate population 10,000 agents 0.01 prevalence, 0.6 transmission rate, 0.5 recovery rate, 7 days-incubation period. population fully connected, meaning agents can transmit disease agent: Computing key statistics","code":"model_seirconn <- ModelSEIRCONN(   name                = \"COVID-19\",   prevalence          = 0.01,    n                   = 10000,   contact_rate        = 10,    incubation_days     = 7,    transmission_rate   = 0.1,   recovery_rate       = 1/7 ) |> add_virus(     virus(       name = \"COVID-19\",       prevalence = 0.01,       as_proportion = TRUE,       prob_infecting = 0.01,       recovery_rate = 0.6,       prob_death = 0.5,       incubation = 7     ))  set.seed(132) run(model_seirconn, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(model_seirconn) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> Population size     : 10000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 2 #> Last run elapsed t  : 81.00ms #> Last run speed      : 12.21 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - COVID-19 #>  - COVID-19 #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Avg. Incubation days : 7.0000 #>  - Contact rate         : 10.0000 #>  - Prob. Recovery       : 0.1429 #>  - Prob. Transmission   : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible :  9800 -> 13 #>   - (1) Exposed     :   200 -> 0 #>   - (2) Infected    :     0 -> 1 #>   - (3) Recovered   :     0 -> 9986 #>  #> Transition Probabilities: #>  - Susceptible  0.94  0.06  0.00  0.00 #>  - Exposed      0.00  0.86  0.14  0.00 #>  - Infected     0.00  0.00  0.85  0.15 #>  - Recovered    0.00  0.00  0.00  1.00 plot(model_seirconn) repnum <- get_reproductive_number(model_seirconn)  head(plot(repnum)) #>   virus_id    virus date      avg  n       sd  lb   ub #> 1        0 COVID-19    0 5.615385 91 4.832228 1.0 17.0 #> 2        0 COVID-19    2 5.000000  9 3.605551 0.2 10.4 #> 3        0 COVID-19    3 6.000000 13 5.049752 0.0 13.0 #> 4        0 COVID-19    4 4.592593 27 3.885469 0.0 12.7 #> 5        0 COVID-19    5 4.846154 26 4.920913 0.0 14.5 #> 6        0 COVID-19    6 4.236842 38 3.241906 0.0 12.0  head(plot_generation_time(model_seirconn)) #>   date      avg  n       sd ci_lower ci_upper    virus virus_id #> 1    2 7.125000  8 2.474874      2.7    9.825 COVID-19        0 #> 2    3 8.090909 11 7.203534      2.0   23.750 COVID-19        0 #> 3    4 6.708333 24 4.338695      2.0   16.425 COVID-19        0 #> 4    5 7.428571 21 4.738897      2.0   15.500 COVID-19        0 #> 5    6 7.628571 35 4.173345      2.0   15.300 COVID-19        0 #> 6    7 6.921053 38 4.675304      2.0   16.150 COVID-19        0"},{"path":"/index.html","id":"sir-logit","dir":"","previous_headings":"","what":"SIR Logit","title":"Fast Agent-Based Epi Models","text":"model provides complex transmission recovery pattern based agents’ features. , can reflect co-morbidities change probability infection recovery. , simulate population including dataset two features: intercept binary variable Female. probability infection recovery functions intercept Female variables. following code simulates population 100,000 agents small-world network. agent connected eight agents. One percent population virus, 80% chance transmission. Infected individuals recover 0.3 rate:","code":"# Simulating a population of 100,000 agents set.seed(2223) n <- 100000  # Agents' features X <- cbind(   Intercept = 1,   Female    = sample.int(2, n, replace = TRUE) - 1   )  coef_infect  <- c(.1, -2, 2) coef_recover <- rnorm(2)  # Creating the model model_logit <- ModelSIRLogit(   \"covid2\",   data = X,   coefs_infect      = coef_infect,   coefs_recover     = coef_recover,    coef_infect_cols  = 1L:ncol(X),   coef_recover_cols = 1L:ncol(X),   prob_infection = .8,   recovery_rate = .3,   prevalence = .01 )  # Adding a small-world population agents_smallworld(model_logit, n, 8, FALSE, .01)  # Running the model run(model_logit, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. plot(model_logit) # Females are supposed to be more likely to become infected rn <- get_reproductive_number(model_logit)  (table(   X[, \"Female\"],   (1:n %in% rn$source) ) |> prop.table())[,2] #>       0       1  #> 0.12984 0.14201  # Looking into the agents get_agents(model_logit) #> Agents from the model \"Susceptible-Infected-Removed (SIR) (logit)\": #> Agent: 0, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 1, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 2, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 3, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 4, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 5, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 6, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 7, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 8, state: Susceptible (0), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 9, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> ... 99990 more agents ..."},{"path":"/index.html","id":"transmission-network","dir":"","previous_headings":"","what":"Transmission network","title":"Fast Agent-Based Epi Models","text":"example shows can draw transmission network simulation. following code simulates population 500 agents small-world network. agent connected ten agents. One percent population virus, 50% chance transmission. Infected individuals recover 0.5 rate:","code":"# Creating a SIR model sir <- ModelSIR(   name           = \"COVID-19\",   prevalence     = .01,   transmission_rate = .5,   recovery       = .5   ) |>     # Adding a Small world population      agents_smallworld(n = 500, k = 10, d = FALSE, p = .01) |>     # Running the model for 50 days     run(ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  # Transmission network net <- get_transmissions(sir)  # Plotting library(epiworldR) library(netplot) #> Loading required package: grid x <- igraph::graph_from_edgelist(   as.matrix(net[,2:3]) + 1   )  nplot(x, edge.curvature = 0, edge.color = \"gray\", skip.vertex=TRUE)"},{"path":"/index.html","id":"multiple-simulations","dir":"","previous_headings":"","what":"Multiple simulations","title":"Fast Agent-Based Epi Models","text":"epiworldR supports running multiple simulations using run_multiple function. following code simulates 50 SIR models 1000 agents . agent connected ten agents. One percent population virus, 90% chance transmission. Infected individuals recover 0.1 rate. results saved data.frame:","code":"model_sir <- ModelSIRCONN(   name = \"COVID-19\",   prevalence = 0.01,   n = 1000,   contact_rate = 2,   transmission_rate = 0.9, recovery_rate = 0.1   )  # Generating a saver saver <- make_saver(\"total_hist\", \"reproductive\")  # Running and printing # Notice the use of nthread = 2 to run the simulations in parallel run_multiple(model_sir, ndays = 100, nsims = 50, saver = saver, nthread = 2) #> Starting multiple runs (50) using 2 thread(s) #> _________________________________________________________________________ #> _________________________________________________________________________ #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # Retrieving the results ans <- run_multiple_get_results(model_sir)  head(ans$total_hist) #>   sim_num date nviruses       state counts #> 1       1    0        1 Susceptible    990 #> 2       1    0        1    Infected     10 #> 3       1    0        1   Recovered      0 #> 4       1    1        1 Susceptible    977 #> 5       1    1        1    Infected     22 #> 6       1    1        1   Recovered      1 head(ans$reproductive) #>   sim_num virus_id    virus source source_exposure_date rt #> 1       1        0 COVID-19    976                    9  0 #> 2       1        0 COVID-19    644                    9  0 #> 3       1        0 COVID-19    608                    9  0 #> 4       1        0 COVID-19    314                    9  0 #> 5       1        0 COVID-19     41                    9  0 #> 6       1        0 COVID-19     32                    9  0  plot(ans$reproductive)"},{"path":"/index.html","id":"tutorials","dir":"","previous_headings":"","what":"Tutorials","title":"Fast Agent-Based Epi Models","text":"virtual INSNA Sunbelt 2023 session can found : https://github.com/UofUEpiBio/epiworldR-workshop/tree/sunbelt2023-virtual -person INSNA Sunbelt 2023 session can found : https://github.com/UofUEpiBio/epiworldR-workshop/tree/sunbetl2023-inperson","code":""},{"path":"/index.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Fast Agent-Based Epi Models","text":"use epiworldR research, please cite follows:","code":"citation(\"epiworldR\") #> To cite epiworldR in publications use: #>  #>   Meyer, Derek and Vega Yon, George (2023). epiworldR: Fast Agent-Based #>   Epi Models. Journal of Open Source Software, 8(90), 5781, #>   https://doi.org/10.21105/joss.05781 #>  #> And the actual R package: #>  #>   Meyer D, Vega Yon G (2024). _epiworldR: Fast Agent-Based Epi Models_. #>   R package version 0.3-2, <https://github.com/UofUEpiBio/epiworldR>. #>  #> To see these entries in BibTeX format, use 'print(<citation>, #> bibtex=TRUE)', 'toBibtex(.)', or set #> 'options(citation.bibtex.max=999)'."},{"path":"/index.html","id":"existing-alternatives","dir":"","previous_headings":"","what":"Existing Alternatives","title":"Fast Agent-Based Epi Models","text":"Several alternatives epiworldR exist provide researchers range options, unique features strengths, enabling exploration analysis infectious disease dynamics agent-based modeling. manually curated table existing alternatives, including ABM [@ABM], abmR [@abmR], cystiSim [@cystiSim], villager [@villager], RNetLogo [@RNetLogo].","code":""},{"path":"/index.html","id":"other-abm-r-packages","dir":"","previous_headings":"","what":"Other ABM R packages","title":"Fast Agent-Based Epi Models","text":"may want check R packages agent-based modeling: ABM, abmR, cystiSim, villager, RNetLogo.","code":""},{"path":"/index.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of Conduct","title":"Fast Agent-Based Epi Models","text":"epiworldR project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"/paper.html","id":null,"dir":"","previous_headings":"","what":"Introduction","title":"Introduction","text":"Agent-based modeling (ABM) emerged powerful computational approach studying complex systems across various fields, including social sciences epidemiology. simulating interactions behaviors individual entities, known agents, ABM provides unique lens researchers can analyze understand emergent properties dynamics systems. epiworldR package provides flexible framework ABM implementation methods prototyping disease outbreaks transmission models using C++ backend. supports multiple epidemiological models, including Susceptible-Infected-Susceptible (SIS), Susceptible-Infected-Removed (SIR), Susceptible-Exposed-Infected-Removed (SEIR), others, involving arbitrary mitigation policies multiple-disease models. Users can specify transmission/susceptibility rates function agents’ features, providing great complexity model dynamics.","code":""},{"path":"/paper.html","id":"key-features","dir":"","previous_headings":"","what":"Key Features","title":"Introduction","text":"Built robust foundation C++, package combines efficient computation flexibility R, providing seamless user experience several standout features: Multiple Viruses - feature allows researchers simulate analyze dynamics various infectious diseases simultaneously. Multiple Tools - capability enables users design model objects may reflect real-world interventions. Examples include vaccines, mask wearing protocols, social distancing, much . Multiple Runs - epiworldR ability run simulations multiple times, providing complete picture simulation results behaviors. Global Actions - Similar adding multiple tools, global actions allow users implement interventions policies global scale point simulation, mimicking real-world scenarios aiding assessment impact. Built-Epidemiological Models - feature ensures researchers access well-established widely recognized frameworks, making easier compare benchmark results. Included popular epidemiological models : SIR, SIS, SEIR, SIR connected, SIS connected, SEIR connected, . extensive range features, epiworldR empowers researchers practitioners field epidemiology conduct thorough analyses, make informed decisions, contribute advancement public health.","code":""},{"path":"/paper.html","id":"existing-alternatives","dir":"","previous_headings":"","what":"Existing Alternatives","title":"Introduction","text":"Several alternatives epiworldR exist provide researchers range options, unique features strengths, enabling exploration analysis infectious disease dynamics agent-based modeling. manually curated table existing alternatives including ABM [@ABM], abmR [@abmR], cystiSim [@cystiSim], villager [@villager], RNetLogo [@RNetLogo].","code":""},{"path":"/paper.html","id":"statement-of-need","dir":"","previous_headings":"","what":"Statement of Need","title":"Introduction","text":"epiworldR package addresses need sophisticated epidemiological research offering user-friendly agent-based modeling (ABM) tool simulating analyzing infectious disease dynamics. caters diverse audience researchers, epidemiologists, public health practitioners, social scientists, policymakers, enabling study complex disease spread patterns, evaluate intervention strategies, prepare emerging pathogens. Unlike traditional epidemiological models, epiworldR’s ABM approach captures individual-level behaviors interactions, providing realistic representation disease dynamics. distinction sets apart compartmental models ABM frameworks, making epiworldR valuable accessible tool advancing infectious disease modeling enhancing outbreak preparedness.","code":""},{"path":"/paper.html","id":"conclusion","dir":"","previous_headings":"","what":"Conclusion","title":"Introduction","text":"development epiworldR package ushered new era agent-based modeling field social science epidemiology. harnessing power C++ flexibility R, comprehensive package offers multitude features enhance modeling analysis complex infectious disease dynamics. package’s ability handle multiple viruses tools, diverse set epidemiological models, capability run simulations multiple times, inclusion global actions capability empower researchers explore wide range scenarios make informed decisions regarding public health interventions. epiworldR serves valuable resource social science epidemiological communities, enabling study real-world phenomena, prediction outcomes, policy analysis. field epidemiology continues evolve, epiworldR stands forefront, providing researchers practitioners powerful tool navigate complexities infectious diseases contribute improvement global health outcomes.","code":""},{"path":[]},{"path":"/reference/ModelDiffNet.html","id":null,"dir":"Reference","previous_headings":"","what":"Network Diffusion Model — ModelDiffNet","title":"Network Diffusion Model — ModelDiffNet","text":"network diffusion model simple model assumes probability adoption behavior proportional number adopters network.","code":""},{"path":"/reference/ModelDiffNet.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Network Diffusion Model — ModelDiffNet","text":"","code":"ModelDiffNet(   name,   prevalence,   prob_adopt,   normalize_exposure = TRUE,   data = matrix(nrow = 0, ncol = 0),   data_cols = 1L:ncol(data),   params = vector(\"double\") )  # S3 method for class 'epiworld_diffnet' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelDiffNet.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Network Diffusion Model — ModelDiffNet","text":"name Name model. prevalence Prevalence disease. prob_adopt Probability adoption. normalize_exposure Normalize exposure. data Data. data_cols Data columns. params Parameters. x Object class epiworld_diffnet. main Title plot ... Passed graphics::plot.","code":""},{"path":"/reference/ModelDiffNet.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Network Diffusion Model — ModelDiffNet","text":"object class epiworld_diffnet epiworld_model.","code":""},{"path":"/reference/ModelDiffNet.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Network Diffusion Model — ModelDiffNet","text":"Different common epidemiological models, network diffusion model assumes probability adoption behavior proportional number adopters network. model defined following equations: $$ P(adopt) = \\mbox{Logit}^{-1}(prob\\_adopt + params * data + exposure) $$ exposure number adopters agent's network. Another important difference transmission network necesary useful since adoption model particular neighbor.","code":""},{"path":[]},{"path":"/reference/ModelDiffNet.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Network Diffusion Model — ModelDiffNet","text":"","code":"set.seed(2223) n <- 10000  # Generating synthetic data on a matrix with 2 columns. X <- cbind(  age = sample(1:100, n, replace = TRUE),  female = sample.int(2, n, replace = TRUE) - 1 )  adopt_chatgpt <- ModelDiffNet(   \"ChatGPT\",   prevalence = .01,   prob_adopt = .1,   data       = X,   params     = c(1, 4) )  # Simulating a population from smallworld agents_smallworld(adopt_chatgpt, n, 8, FALSE, .01)  # Running the model for 50 steps run(adopt_chatgpt, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  # Plotting the model plot(adopt_chatgpt)"},{"path":"/reference/ModelSEIR.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"Susceptible Exposed Infected Recovered model (SEIR)","code":""},{"path":"/reference/ModelSEIR.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"","code":"ModelSEIR(name, prevalence, transmission_rate, incubation_days, recovery_rate)  # S3 method for class 'epiworld_seir' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIR.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. x Object class SEIR. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSEIR.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"ModelSEIRfunction returns model class epiworld_model. plot function returns plot SEIR model class epiworld_model.","code":""},{"path":"/reference/ModelSEIR.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) Proportion non-infected agents removed, (2) Proportion exposed agents set infected.","code":""},{"path":[]},{"path":"/reference/ModelSEIR.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"","code":"model_seir <- ModelSEIR(name = \"COVID-19\", prevalence = 0.01,  transmission_rate = 0.9, recovery_rate = 0.1, incubation_days = 4)  # Adding a small world population agents_smallworld(   model_seir,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_seir, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seir #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 0 Susceptible, 0 Exposed, 7 Infected, and 993 Removed.  plot(model_seir, main = \"SEIR Model\")"},{"path":"/reference/ModelSEIRCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"SEIR connected model implements model agents connected. equivalent compartmental model (wiki).","code":""},{"path":"/reference/ModelSEIRCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"","code":"ModelSEIRCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   incubation_days,   recovery_rate )  # S3 method for class 'epiworld_seirconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"name String. Name virus. n Number individuals population. prevalence Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Probability recovery_rate. x Object class SEIRCONN. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"ModelSEIRCONNfunction returns model class epiworld_model. plot function returns plot SEIRCONN model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSEIRCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"","code":"# An example with COVID-19 model_seirconn <- ModelSEIRCONN(   name                = \"COVID-19\",   prevalence          = 0.01,    n                   = 10000,   contact_rate        = 2,    incubation_days     = 7,    transmission_rate   = 0.5,   recovery_rate       = 0.3 )    # Running and printing run(model_seirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 429 Susceptible, 4 Exposed, 3 Infected, and 9564 Recovered.  plot(model_seirconn)   # Adding the flu flu <- virus(\"Flu\", .9, 1/7, prevalence = 0.001, as_proportion = TRUE) add_virus(model_seirconn, flu)  #' # Running and printing run(model_seirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> It features 10000 agents, 2 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 1 Susceptible, 0 Exposed, 1 Infected, and 9998 Recovered.  plot(model_seirconn)"},{"path":"/reference/ModelSEIRD.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD)","code":""},{"path":"/reference/ModelSEIRD.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"","code":"ModelSEIRD(   name,   prevalence,   transmission_rate,   incubation_days,   recovery_rate,   death_rate )  # S3 method for class 'epiworld_seird' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRD.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. death_rate Numeric scalar 0 1. Rate death virus. x Object class SEIRD. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRD.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"ModelSEIRDfunction returns model class epiworld_model. plot function returns plot SEIRD model class epiworld_model.","code":""},{"path":"/reference/ModelSEIRD.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) Proportion exposed agents infected, (2) proportion non-infected agents already removed, (3) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSEIRD.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"","code":"model_seird <- ModelSEIRD(name = \"COVID-19\", prevalence = 0.01,  transmission_rate = 0.9, recovery_rate = 0.1, incubation_days = 4,  death_rate = 0.01)  # Adding a small world population agents_smallworld(   model_seird,   n = 100000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_seird, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seird #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed-Deceased (SEIRD) #> It features 100000 agents, 1 virus(es), and 0 tool(s). #> The model has 5 states. #> The final distribution is: 1961 Susceptible, 388 Exposed, 1358 Infected, 88223 Removed, and 8070 Deceased.  plot(model_seird, main = \"SEIRD Model\")"},{"path":"/reference/ModelSEIRDCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"SEIRD connected model implements model agents connected. equivalent compartmental model (wiki).","code":""},{"path":"/reference/ModelSEIRDCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"","code":"ModelSEIRDCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   incubation_days,   recovery_rate,   death_rate )  # S3 method for class 'epiworld_seirdconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRDCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"name String. Name virus. n Number individuals population. prevalence Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Probability recovery_rate. death_rate Numeric scalar 0 1. Probability death. x Object class SEIRCONN. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRDCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"ModelSEIRDCONNfunction returns model class epiworld_model. plot function returns plot SEIRDCONN model class epiworld_model.","code":""},{"path":"/reference/ModelSEIRDCONN.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) Proportion exposed agents infected, (2) proportion non-infected agents already removed, (3) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSEIRDCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"","code":"# An example with COVID-19 model_seirdconn <- ModelSEIRDCONN(   name                = \"COVID-19\",   prevalence          = 0.01,    n                   = 10000,   contact_rate        = 2,    incubation_days     = 7,    transmission_rate   = 0.5,   recovery_rate       = 0.3,   death_rate          = 0.01 )    # Running and printing run(model_seirdconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirdconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed-Deceased (SEIRD) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 5 states. #> The final distribution is: 474 Susceptible, 4 Exposed, 1 Infected, 9330 Removed, and 191 Deceased.  plot(model_seirdconn)   # Adding the flu flu <- virus(   \"Flu\", prob_infecting = .3, recovery_rate = 1/7,   prob_death = 0.001,   prevalence = 0.001, as_proportion = TRUE ) add_virus(model = model_seirdconn, virus = flu)  #' # Running and printing run(model_seirdconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirdconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed-Deceased (SEIRD) (connected) #> It features 10000 agents, 2 virus(es), and 0 tool(s). #> The model has 5 states. #> The final distribution is: 398 Susceptible, 6 Exposed, 4 Infected, 9379 Removed, and 213 Deceased.  plot(model_seirdconn)"},{"path":"/reference/ModelSEIRMixing.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"Susceptible Exposed Infected Removed model (SEIR) mixing","code":""},{"path":"/reference/ModelSEIRMixing.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"","code":"ModelSEIRMixing(   name,   n,   prevalence,   contact_rate,   transmission_rate,   incubation_days,   recovery_rate,   contact_matrix )  # S3 method for class 'epiworld_seirmixing' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRMixing.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. incubation_days Numeric scalar. Average number days incubation period. recovery_rate Numeric scalar 0 1. Probability recovery. contact_matrix Matrix contact rates individuals. x Object class SIRCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRMixing.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"ModelSEIRMixingfunction returns model class epiworld_model. plot function returns plot SEIRMixing model class epiworld_model.","code":""},{"path":"/reference/ModelSEIRMixing.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"contact_matrix matrix contact rates entities. matrix size n x n, n number entities. row-stochastic matrix, .e., sum row 1. initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSEIRMixing.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"","code":"# Start off creating three entities. # Individuals will be distribured randomly between the three. e1 <- entity(\"Population 1\", 3e3, as_proportion = FALSE) e2 <- entity(\"Population 2\", 3e3, as_proportion = FALSE) e3 <- entity(\"Population 3\", 3e3, as_proportion = FALSE)  # Row-stochastic matrix (rowsums 1) cmatrix <- c(   c(0.9, 0.05, 0.05),   c(0.1, 0.8, 0.1),   c(0.1, 0.2, 0.7) ) |> matrix(byrow = TRUE, nrow = 3)  N <- 9e3  flu_model <- ModelSEIRMixing(   name              = \"Flu\",   n                 = N,   prevalence        = 1 / N,   contact_rate      = 20,   transmission_rate = 0.1,   recovery_rate     = 1 / 7,   incubation_days   = 7,   contact_matrix    = cmatrix )  # Adding the entities to the model flu_model |>   add_entity(e1) |>   add_entity(e2) |>   add_entity(e3)  set.seed(331) run(flu_model, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(flu_model) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Exposed-Infected-Removed (SEIR) with Mixing #> Population size     : 9000 #> Agents' data        : (none) #> Number of entities  : 3 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 129.00ms #> Last run speed      : 6.96 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - Flu #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Avg. Incubation days : 7.0000 #>  - Contact rate         : 20.0000 #>  - Prob. Recovery       : 0.1429 #>  - Prob. Transmission   : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible : 8999 -> 137 #>   - (1) Exposed     :    1 -> 35 #>   - (2) Infected    :    0 -> 139 #>   - (3) Recovered   :    0 -> 8689 #>  #> Transition Probabilities: #>  - Susceptible  0.96  0.04  0.00  0.00 #>  - Exposed      0.00  0.84  0.16  0.00 #>  - Infected     0.00  0.00  0.86  0.14 #>  - Recovered    0.00  0.00  0.00  1.00 #>  plot_incidence(flu_model)"},{"path":"/reference/ModelSIR.html","id":null,"dir":"Reference","previous_headings":"","what":"SIR model — ModelSIR","title":"SIR model — ModelSIR","text":"SIR model","code":""},{"path":"/reference/ModelSIR.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIR model — ModelSIR","text":"","code":"ModelSIR(name, prevalence, transmission_rate, recovery_rate)  # S3 method for class 'epiworld_sir' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIR.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIR model — ModelSIR","text":"name String. Name virus prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. x Object class SIR. main Title plot ... Additional arguments passed graphics::plot.","code":""},{"path":"/reference/ModelSIR.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIR model — ModelSIR","text":"ModelSIR function returns model class epiworld_model. plot function returns plot SIR model class epiworld_model.","code":""},{"path":"/reference/ModelSIR.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"SIR model — ModelSIR","text":"initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSIR.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIR model — ModelSIR","text":"","code":"model_sir <- ModelSIR(name = \"COVID-19\", prevalence = 0.01,                        transmission_rate = 0.9, recovery_rate = 0.1)  # Adding a small world population agents_smallworld(   model_sir,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sir, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sir #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered (SIR) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 0 Susceptible, 9 Infected, and 991 Recovered.  # Plotting plot(model_sir)"},{"path":"/reference/ModelSIRCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"Susceptible Infected Removed model (SIR connected)","code":""},{"path":"/reference/ModelSIRCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"","code":"ModelSIRCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   recovery_rate )  # S3 method for class 'epiworld_sirconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. recovery_rate Numeric scalar 0 1. Probability recovery. x Object class SIRCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSIRCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"ModelSIRCONNfunction returns model class epiworld_model. plot function returns plot SIRCONN model class epiworld_model.","code":""},{"path":"/reference/ModelSIRCONN.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSIRCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"","code":"model_sirconn <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )    # Running and printing run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sirconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 2056 Susceptible, 0 Infected, and 7944 Recovered.  plot(model_sirconn,  main = \"SIRCONN Model\")"},{"path":"/reference/ModelSIRD.html","id":null,"dir":"Reference","previous_headings":"","what":"SIRD model — ModelSIRD","title":"SIRD model — ModelSIRD","text":"SIRD model","code":""},{"path":"/reference/ModelSIRD.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIRD model — ModelSIRD","text":"","code":"ModelSIRD(name, prevalence, transmission_rate, recovery_rate, death_rate)  # S3 method for class 'epiworld_sird' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRD.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIRD model — ModelSIRD","text":"name String. Name virus prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. death_rate Numeric scalar 0 1. Rate death virus. x Object class SIR. main Title plot ... Additional arguments passed graphics::plot.","code":""},{"path":"/reference/ModelSIRD.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIRD model — ModelSIRD","text":"ModelSIRD function returns model class epiworld_model. plot function returns plot SIRD model class epiworld_model.","code":""},{"path":"/reference/ModelSIRD.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"SIRD model — ModelSIRD","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) proportion non-infected agents already removed, (2) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSIRD.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIRD model — ModelSIRD","text":"","code":"model_sird <- ModelSIRD(  name              = \"COVID-19\",  prevalence        = 0.01,   transmission_rate = 0.9,  recovery_rate     = 0.1,  death_rate        = 0.01 )  # Adding a small world population agents_smallworld(   model_sird,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sird, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sird #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered-Deceased (SIRD) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 0 Susceptible, 5 Infected, 912 Recovered, and 83 Deceased.  # Plotting plot(model_sird)"},{"path":"/reference/ModelSIRDCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"Susceptible Infected Removed Deceased model (SIRD connected)","code":""},{"path":"/reference/ModelSIRDCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"","code":"ModelSIRDCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   recovery_rate,   death_rate )  # S3 method for class 'epiworld_sirdconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRDCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. recovery_rate Numeric scalar 0 1. Probability recovery. death_rate Numeric scalar 0 1. Probability death. x Object class SIRDCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSIRDCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"ModelSIRDCONNfunction returns model class epiworld_model. plot function returns plot SIRDCONN model class epiworld_model.","code":""},{"path":"/reference/ModelSIRDCONN.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) proportion non-infected agents already removed, (2) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSIRDCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"","code":"model_sirdconn <- ModelSIRDCONN(   name                = \"COVID-19\",   n                   = 100000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.5,   death_rate          = 0.1 )    # Running and printing run(model_sirdconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sirdconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed-Deceased (SIRD) (connected) #> It features 100000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 3778 Susceptible, 0 Infected, 86521 Recovered, and 9701 Deceased.  plot(model_sirdconn,  main = \"SIRDCONN Model\")"},{"path":"/reference/ModelSIRLogit.html","id":null,"dir":"Reference","previous_headings":"","what":"SIR Logistic model — ModelSIRLogit","title":"SIR Logistic model — ModelSIRLogit","text":"SIR Logistic model","code":""},{"path":"/reference/ModelSIRLogit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIR Logistic model — ModelSIRLogit","text":"","code":"ModelSIRLogit(   vname,   data,   coefs_infect,   coefs_recover,   coef_infect_cols,   coef_recover_cols,   prob_infection,   recovery_rate,   prevalence )"},{"path":"/reference/ModelSIRLogit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIR Logistic model — ModelSIRLogit","text":"vname Name virus. data numeric matrix n rows. coefs_infect Numeric vector. Coefficients associated infect. coefs_recover Numeric vector. Coefficients associated recover. coef_infect_cols Integer vector. Columns coeficient. coef_recover_cols Integer vector. Columns coeficient. prob_infection Numeric scalar. Baseline probability infection. recovery_rate Numeric scalar. Baseline probability recovery. prevalence Numeric scalar. Prevalence (initial state) proportion.","code":""},{"path":"/reference/ModelSIRLogit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIR Logistic model — ModelSIRLogit","text":"ModelSIRLogit function returns model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSIRLogit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIR Logistic model — ModelSIRLogit","text":"","code":"set.seed(2223) n <- 100000  # Creating the data to use for the \"ModelSIRLogit\" function. It contains  # information on the sex of each agent and will be used to determine  # differences in disease progression between males and females. Note that  # the number of rows in these data are identical to n (100000).  X <- cbind(   Intercept = 1,   Female    = sample.int(2, n, replace = TRUE) - 1 )  # Declare coefficients for each sex regarding transmission_rate and recovery. coef_infect  <- c(.1, -2, 2) coef_recover <- rnorm(2)  # Feed all above information into the \"ModelSIRLogit\" function.  model_logit <- ModelSIRLogit(   \"covid2\",   data = X,   coefs_infect      = coef_infect,   coefs_recover     = coef_recover,    coef_infect_cols  = 1L:ncol(X),   coef_recover_cols = 1L:ncol(X),   prob_infection = .8,   recovery_rate = .3,   prevalence = .01 )  agents_smallworld(model_logit, n, 8, FALSE, .01)  run(model_logit, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  plot(model_logit)   # Females are supposed to be more likely to become infected. rn <- get_reproductive_number(model_logit)  # Probability of infection for males and females.  (table(   X[, \"Female\"],   (1:n %in% rn$source) ) |> prop.table())[,2] #>       0       1  #> 0.12984 0.14201   # Looking into the individual agents. get_agents(model_logit) #> Agents from the model \"Susceptible-Infected-Removed (SIR) (logit)\": #> Agent: 0, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 1, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 2, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 3, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 4, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 5, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 6, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 7, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 8, state: Susceptible (0), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 9, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> ... 99990 more agents ..."},{"path":"/reference/ModelSIRMixing.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"Susceptible Infected Removed model (SIR) mixing","code":""},{"path":"/reference/ModelSIRMixing.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"","code":"ModelSIRMixing(   name,   n,   prevalence,   contact_rate,   transmission_rate,   recovery_rate,   contact_matrix )  # S3 method for class 'epiworld_sirmixing' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRMixing.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. recovery_rate Numeric scalar 0 1. Probability recovery. contact_matrix Matrix contact rates individuals. x Object class SIRCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSIRMixing.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"ModelSIRMixingfunction returns model class epiworld_model. plot function returns plot SIRMixing model class epiworld_model.","code":""},{"path":"/reference/ModelSIRMixing.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"contact_matrix matrix contact rates entities. matrix size n x n, n number entities. row-stochastic matrix, .e., sum row 1. initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSIRMixing.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"","code":"# From the vignette  # Start off creating three entities. # Individuals will be distribured randomly between the three. e1 <- entity(\"Population 1\", 3e3, as_proportion = FALSE) e2 <- entity(\"Population 2\", 3e3, as_proportion = FALSE) e3 <- entity(\"Population 3\", 3e3, as_proportion = FALSE)  # Row-stochastic matrix (rowsums 1) cmatrix <- c(   c(0.9, 0.05, 0.05),   c(0.1, 0.8, 0.1),   c(0.1, 0.2, 0.7) ) |> matrix(byrow = TRUE, nrow = 3)  N <- 9e3  flu_model <- ModelSIRMixing(   name              = \"Flu\",   n                 = N,   prevalence        = 1 / N,   contact_rate      = 20,   transmission_rate = 0.1,   recovery_rate     = 1 / 7,   contact_matrix    = cmatrix )  # Adding the entities to the model flu_model |>   add_entity(e1) |>   add_entity(e2) |>   add_entity(e3)  set.seed(331) run(flu_model, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(flu_model) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) with Mixing #> Population size     : 9000 #> Agents' data        : (none) #> Number of entities  : 3 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 68.00ms #> Last run speed      : 13.18 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - Flu #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate       : 20.0000 #>  - Prob. Recovery     : 0.1429 #>  - Prob. Transmission : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible : 8999 -> 134 #>   - (1) Infected    :    1 -> 0 #>   - (2) Recovered   :    0 -> 8866 #>  #> Transition Probabilities: #>  - Susceptible  0.96  0.04  0.00 #>  - Infected     0.00  0.87  0.13 #>  - Recovered    0.00  0.00  1.00 #>  plot_incidence(flu_model)"},{"path":"/reference/ModelSIS.html","id":null,"dir":"Reference","previous_headings":"","what":"SIS model — ModelSIS","title":"SIS model — ModelSIS","text":"Susceptible-Infected-Susceptible model (SIS) (wiki)","code":""},{"path":"/reference/ModelSIS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIS model — ModelSIS","text":"","code":"ModelSIS(name, prevalence, transmission_rate, recovery_rate)  # S3 method for class 'epiworld_sis' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIS model — ModelSIS","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery virus. x Object class SIS. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSIS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIS model — ModelSIS","text":"ModelSIS function returns model class epiworld_model. plot function returns plot SIS model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSIS.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIS model — ModelSIS","text":"","code":"model_sis <- ModelSIS(name = \"COVID-19\", prevalence = 0.01,                       transmission_rate = 0.9, recovery_rate = 0.1)  # Adding a small world population agents_smallworld(   model_sis,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sis, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sis #> ________________________________________________________________________________ #> Susceptible-Infected-Susceptible (SIS) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 2 states. #> The final distribution is: 100 Susceptible, and 900 Infected.  # Plotting plot(model_sis, main = \"SIS Model\")"},{"path":"/reference/ModelSISD.html","id":null,"dir":"Reference","previous_headings":"","what":"SISD model — ModelSISD","title":"SISD model — ModelSISD","text":"Susceptible-Infected-Susceptible-Deceased model (SISD) (wiki)","code":""},{"path":"/reference/ModelSISD.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SISD model — ModelSISD","text":"","code":"ModelSISD(name, prevalence, transmission_rate, recovery_rate, death_rate)  # S3 method for class 'epiworld_sisd' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSISD.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SISD model — ModelSISD","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery virus. death_rate Numeric scalar 0 1. Rate death virus. x Object class SISD. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSISD.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SISD model — ModelSISD","text":"ModelSISD function returns model class epiworld_model. plot function returns plot SISD model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSISD.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SISD model — ModelSISD","text":"","code":"model_sisd <- ModelSISD(                name = \"COVID-19\",                 prevalence = 0.01,                 transmission_rate = 0.9,                 recovery_rate = 0.1,                 death_rate = 0.01              )  # Adding a small world population agents_smallworld(   model_sisd,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sisd, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sisd #> ________________________________________________________________________________ #> Susceptible-Infected-Susceptible-Deceased (SISD) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 89 Susceptible, 457 Infected, and 454 Deceased.  # Plotting plot(model_sisd, main = \"SISD Model\")"},{"path":"/reference/ModelSURV.html","id":null,"dir":"Reference","previous_headings":"","what":"SURV model — ModelSURV","title":"SURV model — ModelSURV","text":"SURV model","code":""},{"path":"/reference/ModelSURV.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SURV model — ModelSURV","text":"","code":"ModelSURV(   name,   prevalence,   efficacy_vax,   latent_period,   infect_period,   prob_symptoms,   prop_vaccinated,   prop_vax_redux_transm,   prop_vax_redux_infect,   surveillance_prob,   transmission_rate,   prob_death,   prob_noreinfect )  # S3 method for class 'epiworld_surv' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSURV.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SURV model — ModelSURV","text":"name String. Name virus. prevalence Initial number individuals virus. efficacy_vax Double. Efficacy vaccine. (1 - P(acquire disease)). latent_period Double. Shape parameter 'Gamma(latent_period, 1)' distribution. coincides expected number latent days. infect_period Double. Shape parameter 'Gamma(infected_period, 1)' distribution. coincides expected number infectious days. prob_symptoms Double. Probability generating symptoms. prop_vaccinated Double. Probability vaccination. Coincides initial prevalence vaccinated individuals. prop_vax_redux_transm Double. Factor vaccine reduces transmissibility. prop_vax_redux_infect Double. Factor vaccine reduces chances becoming infected. surveillance_prob Double. Probability testing agent. transmission_rate Double. Raw transmission probability. prob_death Double. Raw probability death symptomatic individuals. prob_noreinfect Double. Probability re-infection. x Object class SURV. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSURV.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SURV model — ModelSURV","text":"ModelSURVfunction returns model class epiworld_model. plot function returns plot SURV model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSURV.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SURV model — ModelSURV","text":"","code":"model_surv <- ModelSURV(   name                  = \"COVID-19\",   prevalence            = 20,   efficacy_vax          = 0.6,   latent_period         = 4,   infect_period         = 5,   prob_symptoms         = 0.5,   prop_vaccinated       = 0.7,   prop_vax_redux_transm = 0.8,   prop_vax_redux_infect = 0.95,   surveillance_prob     = 0.1,   transmission_rate     = 0.2,   prob_death            = 0.001,   prob_noreinfect       = 0.5 )  # Adding a small world population agents_smallworld(   model_surv,   n = 10000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_surv, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_surv  #> ________________________________________________________________________________ #> Surveillance #> It features 10000 agents, 1 virus(es), and 1 tool(s). #> The model has 8 states. #> The final distribution is: 9978 Susceptible, 0 Latent, 0 Symptomatic, 0 Symptomatic isolated, 0 Asymptomatic, 0 Asymptomatic isolated, 22 Recovered, and 0 Removed.  # Plotting plot(model_surv, main = \"SURV Model\")"},{"path":"/reference/agents.html","id":null,"dir":"Reference","previous_headings":"","what":"Agents in epiworldR — agents","title":"Agents in epiworldR — agents","text":"functions provide read-access agents model. get_agents function returns object class epiworld_agents contains information agents model. get_agent function returns information single agent. get_state function returns state single agent.","code":""},{"path":"/reference/agents.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Agents in epiworldR — agents","text":"","code":"get_agents(model, ...)  # S3 method for class 'epiworld_model' get_agents(model, ...)  # S3 method for class 'epiworld_agents' x[i]  # S3 method for class 'epiworld_agent' print(x, compressed = FALSE, ...)  # S3 method for class 'epiworld_agents' print(x, compressed = TRUE, max_print = 10, ...)  get_state(x)"},{"path":"/reference/agents.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Agents in epiworldR — agents","text":"model object class epiworld_model. ... Ignored x object class epiworld_agents Index (id) agent (0 n-1) compressed Logical scalar. FALSE, prints detailed information agent. max_print Integer scalar. Maximum number agents print.","code":""},{"path":"/reference/agents.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Agents in epiworldR — agents","text":"get_agents function returns object class epiworld_agents. [ method returns object class epiworld_agent. print function returns information individual agent class epiworld_agent. get_state function returns state epiworld_agents object.","code":""},{"path":[]},{"path":"/reference/agents.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Agents in epiworldR — agents","text":"","code":"model_sirconn <- ModelSIRCONN( name                = \"COVID-19\", n                   = 10000, prevalence          = 0.01, contact_rate        = 5, transmission_rate   = 0.4, recovery_rate       = 0.95 )  run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  x <- get_agents(model_sirconn) # Storing all agent information into object of                                 # class epiworld_agents                               print(x, compressed = FALSE, max_print = 5) # Displaying detailed information of  #> Agents from the model \"Susceptible-Infected-Removed (SIR) (connected)\": #> Information about agent id 0 #>   State        : Susceptible (0) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 1 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 2 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 3 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 4 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> ... 9995 more agents ...                                         # the first 5 agents using                                          # compressed=F. Using compressed=T                                         # results in less-detailed                                          # information about each agent.                                           x[0] # Print information about the first agent. Substitute the agent of  #> Information about agent id 0 #>   State        : Susceptible (0) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0      # interest's position where '0' is."},{"path":"/reference/agents_smallworld.html","id":null,"dir":"Reference","previous_headings":"","what":"Load agents to a model — agents_smallworld","title":"Load agents to a model — agents_smallworld","text":"functions provide access network model. network represented edgelist. agents_smallworld function generates small world network Watts-Strogatz algorithm. agents_from_edgelist function loads network edgelist. get_network function returns edgelist network.","code":""},{"path":"/reference/agents_smallworld.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load agents to a model — agents_smallworld","text":"","code":"agents_smallworld(model, n, k, d, p)  agents_from_edgelist(model, source, target, size, directed)  get_network(model)  get_agents_states(model)  add_virus_agent(agent, model, virus, state_new = -99, queue = -99)  add_tool_agent(agent, model, tool, state_new = -99, queue = -99)  has_virus(agent, virus)  has_tool(agent, tool)  change_state(agent, model, state_new, queue = -99)  get_agents_tools(model)"},{"path":"/reference/agents_smallworld.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load agents to a model — agents_smallworld","text":"model Model object class epiworld_model. n, size Number individuals population. k Number ties small world network. d, directed Logical scalar. Whether graph directed . p Probability rewiring. source, target Integer vectors describing source target edgelist. agent Agent object class epiworld_agent. virus Virus object class epiworld_virus. state_new Integer scalar. New state agent action executed. queue Integer scalar. Change queuing system action executed. tool Tool object class epiworld_tool.","code":""},{"path":"/reference/agents_smallworld.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load agents to a model — agents_smallworld","text":"'agents_smallworld' function returns model agents loaded. agents_from_edgelist function returns empty model class epiworld_model. get_network function returns data frame two columns (source target) describing edgelist network. get_agents_states returns character vector states agents end simulation. function add_virus_agent adds virus agent returns agent invisibly. function add_tool_agent adds tool agent returns agent invisibly. functions has_virus has_tool return logical scalar indicating whether agent virus/tool . get_agents_tools returns list class epiworld_agents_tools epiworld_tools (list lists).","code":""},{"path":"/reference/agents_smallworld.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Load agents to a model — agents_smallworld","text":"new_state queue parameters optional. provided, agent updated default values virus/tool.","code":""},{"path":"/reference/agents_smallworld.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Load agents to a model — agents_smallworld","text":"","code":"# Initializing SIR model with agents_smallworld sir <- ModelSIR(name = \"COVID-19\", prevalence = 0.01, transmission_rate = 0.9,                  recovery_rate = 0.1) agents_smallworld(    sir,    n = 1000,     k = 5,    d = FALSE,    p = .01  ) run(sir, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. sir #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered (SIR) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 0 Susceptible, 9 Infected, and 991 Recovered.  # We can also retrieve the network net <- get_network(sir) head(net) #>   from  to #> 1    0   1 #> 2    0   2 #> 3    0 998 #> 4    0 999 #> 5    1   2 #> 6    1   3  # Simulating a bernoulli graph set.seed(333) n <- 1000 g <- matrix(runif(n ^ 2) < .01, nrow = n) diag(g) <- FALSE el <- which(g, arr.ind = TRUE) - 1L   # Generating an empty model sir <- ModelSIR(\"COVID-19\", .01, .8, .3) agents_from_edgelist(   sir,   source = el[,1],   target = el[,2],   size   = n,   directed = TRUE )  # Running the simulation run(sir, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  plot(sir)"},{"path":"/reference/entities.html","id":null,"dir":"Reference","previous_headings":"","what":"Get entities — entities","title":"Get entities — entities","text":"Entities epiworld objects can contain agents.","code":""},{"path":"/reference/entities.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get entities — entities","text":"","code":"get_entities(model)  # S3 method for class 'epiworld_entities' x[i]  entity(name, prevalence, as_proportion, to_unassigned = TRUE)  get_entity_size(entity)  get_entity_name(entity)  entity_add_agent(entity, agent, model = attr(entity, \"model\"))  rm_entity(model, id)  add_entity(model, entity)  load_agents_entities_ties(model, agents_id, entities_id)  entity_get_agents(entity)  distribute_entity_randomly(prevalence, as_proportion, to_unassigned = TRUE)  distribute_entity_to_set(agents_ids)  set_distribution_entity(entity, distfun)"},{"path":"/reference/entities.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get entities — entities","text":"model Model object class epiworld_model. x Object class epiworld_entities. Integer index. name Character scalar. Name entity. prevalence Numeric scalar. Prevalence entity. as_proportion Logical scalar. TRUE, prevalence interpreted proportion. to_unassigned Logical scalar. TRUE, entity added unassigned pool. entity Entity object class epiworld_entity. agent Agent object class epiworld_agent. id Integer scalar. Entity id remove (starting zero). agents_id Integer vector. entities_id Integer vector. agents_ids Integer vector. Ids agents distribute. distfun Distribution function object class epiworld_distribution_entity.","code":""},{"path":"/reference/entities.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get entities — entities","text":"function entity creates entity object. function get_entity_size returns number agents entity. function get_entity_name returns name entity. function entity_add_agent adds agent entity. function rm_entity removes entity model. function load_agents_entities_ties loads agents entities. function entity_get_agents returns integer vector agents entity (ids).","code":""},{"path":"/reference/entities.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get entities — entities","text":"Epiworld entities especially useful mixing models, particularly ModelSIRMixing ModelSEIRMixing.","code":""},{"path":"/reference/entities.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get entities — entities","text":"","code":"# Creating a mixing model mymodel <- ModelSIRMixing(  name = \"My model\",  n = 10000,  prevalence = .001,  contact_rate = 10,  transmission_rate = .1,  recovery_rate = 1/7,  contact_matrix = matrix(c(.9, .1, .1, .9), 2, 2) )  ent1 <- entity(\"First\", 5000, FALSE) ent2 <- entity(\"Second\", 5000, FALSE)  mymodel |>   add_entity(ent1) |>   add_entity(ent2)  run(mymodel, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  summary(mymodel) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) with Mixing #> Population size     : 10000 #> Agents' data        : (none) #> Number of entities  : 2 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 67.00ms #> Last run speed      : 14.75 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - My model #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate       : 10.0000 #>  - Prob. Recovery     : 0.1429 #>  - Prob. Transmission : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible :  9990 -> 384 #>   - (1) Infected    :    10 -> 0 #>   - (2) Recovered   :     0 -> 9616 #>  #> Transition Probabilities: #>  - Susceptible  0.97  0.03  0.00 #>  - Infected     0.00  0.85  0.15 #>  - Recovered    0.00  0.00  1.00 #>"},{"path":"/reference/epiworld-data.html","id":null,"dir":"Reference","previous_headings":"","what":"Accessing the database of epiworld — epiworld-data","title":"Accessing the database of epiworld — epiworld-data","text":"Models epiworld stored database. database can accessed using functions described manual page. elements database : transition matrix, incidence matrix, reproductive number, generation time, daily incidence virus tool level.","code":""},{"path":"/reference/epiworld-data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Accessing the database of epiworld — epiworld-data","text":"","code":"get_hist_total(x)  get_today_total(x)  get_hist_virus(x)  get_hist_tool(x)  get_transition_probability(x)  get_reproductive_number(x)  # S3 method for class 'epiworld_repnum' plot(   x,   y = NULL,   ylab = \"Average Rep. Number\",   xlab = \"Day (step)\",   main = \"Reproductive Number\",   type = \"b\",   plot = TRUE,   ... )  plot_reproductive_number(x, ...)  get_hist_transition_matrix(x, skip_zeros = FALSE)  # S3 method for class 'epiworld_hist_transition' as.array(x, ...)  plot_incidence(x, ...)  # S3 method for class 'epiworld_hist_transition' plot(   x,   type = \"b\",   xlab = \"Day (step)\",   ylab = \"Counts\",   main = \"Daily incidence\",   plot = TRUE,   ... )  get_transmissions(x)  get_generation_time(x)  # S3 method for class 'epiworld_generation_time' plot(   x,   type = \"b\",   xlab = \"Day (step)\",   ylab = \"Avg. Generation Time\",   main = \"Generation Time\",   plot = TRUE,   ... )  plot_generation_time(x, ...)"},{"path":"/reference/epiworld-data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Accessing the database of epiworld — epiworld-data","text":"x object class epiworld_sir, epiworld_seir, etc. model. y Ignored. ylab, xlab, main, type parameters passed graphics::plot() plot Logical scalar. TRUE (default), function desired statistic. ... case plot methods, arguments passed graphics::plot. skip_zeros Logical scalar. FALSE return entries transition matrix.","code":""},{"path":"/reference/epiworld-data.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Accessing the database of epiworld — epiworld-data","text":"get_hist_total function returns object class epiworld_hist_total. get_today_total function returns named vector total number individuals state end simulation. get_hist_virus function returns object class epiworld_hist_virus. get_hist_tool function returns object epiworld_hist_virus. get_transition_probability function returns object class matrix. get_reproductive_number function returns object class epiworld_repnum. plot function returns plot reproductive number time. get_hist_transition_matrix returns data.frame four columns: \"state_from\", \"state_to\", \"date\", \"counts.\" .array method epiworld_hist_transition objects turns data.frame returned get_hist_transition_matrix array nstates x nstates x (ndays + 1) entries, first entry initial state. plot_incidence function returns plot originating object get_hist_transition_matrix. plot function returns plot originates epiworld_hist_transition object. function get_transmissions returns data.frame following columns: date, source, target, virus_id, virus, source_exposure_date. function get_generation_time returns data.frame following columns: \"agent\", \"virus_id\", \"virus\", \"date\", \"gentime\". function plot_generation_time wrapper plot get_generation_time.","code":""},{"path":"/reference/epiworld-data.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Accessing the database of epiworld — epiworld-data","text":"plot_reproductive_number function wrapper around get_reproductive_number plots result. plot_incidence function wrapper get_hist_transition_matrix plot method. plot method epiworld_hist_transition class plots daily incidence state. function returns data frame used plotting.","code":""},{"path":[]},{"path":"/reference/epiworld-data.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Accessing the database of epiworld — epiworld-data","text":"","code":"# SEIR Connected seirconn <- ModelSEIRCONN(   name              = \"Disease\",   n                 = 10000,   prevalence        = 0.1,   contact_rate      = 2.0,    transmission_rate = 0.8,   incubation_days   = 7.0,   recovery_rate     = 0.3 )  # Running the simulation for 50 steps (days) set.seed(937) run(seirconn, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  # Retrieving the transition probability get_transition_probability(seirconn)  #>             Susceptible   Exposed  Infected Recovered #> Susceptible   0.9028099 0.0971901 0.0000000 0.0000000 #> Exposed       0.0000000 0.8584473 0.1415526 0.0000000 #> Infected      0.0000000 0.0000000 0.7000978 0.2999022 #> Recovered     0.0000000 0.0000000 0.0000000 1.0000000  # Retrieving date, state, and counts dataframe including any added tools  get_hist_tool(seirconn) #> [1] date    tool_id tool    state   counts  #> <0 rows> (or 0-length row.names)  # Retrieving overall date, state, and counts dataframe  head(get_hist_total(seirconn)) #>   date       state counts #> 1    0 Susceptible   9000 #> 2    0     Exposed   1000 #> 3    0    Infected      0 #> 4    0   Recovered      0 #> 5    1 Susceptible   9000 #> 6    1     Exposed    861  # Retrieving date, state, and counts dataframe by variant head(get_hist_virus(seirconn)) #>   date virus_id   virus       state counts #> 1    0        0 Disease Susceptible      0 #> 2    0        0 Disease     Exposed   1000 #> 3    0        0 Disease    Infected      0 #> 4    0        0 Disease   Recovered      0 #> 5    1        0 Disease Susceptible      0 #> 6    1        0 Disease     Exposed    861  # Retrieving (and plotting) the reproductive number rp <- get_reproductive_number(seirconn) plot(rp) # Also equivalent to plot_reproductive_number(seirconn)   # We can go further and get all the history t_hist <- get_hist_transition_matrix(seirconn)  head(t_hist) #>    state_from    state_to date counts #> 1 Susceptible Susceptible    0   9000 #> 2     Exposed Susceptible    0      0 #> 3    Infected Susceptible    0      0 #> 4   Recovered Susceptible    0      0 #> 5 Susceptible     Exposed    0   1000 #> 6     Exposed     Exposed    0      0  # And turn it into an array as.array(t_hist)[,,1:3] #> , , 0 #>  #>             Susceptible Exposed Infected Recovered #> Susceptible        9000    1000        0         0 #> Exposed               0       0        0         0 #> Infected              0       0        0         0 #> Recovered             0       0        0         0 #>  #> , , 1 #>  #>             Susceptible Exposed Infected Recovered #> Susceptible        9000       0        0         0 #> Exposed               0     861      139         0 #> Infected              0       0        0         0 #> Recovered             0       0        0         0 #>  #> , , 2 #>  #>             Susceptible Exposed Infected Recovered #> Susceptible        8822     178        0         0 #> Exposed               0     737      124         0 #> Infected              0       0       92        47 #> Recovered             0       0        0         0 #>   # We cam also get (and plot) the incidence, as well as # the generation time inci <- plot_incidence(seirconn)  gent <- plot_generation_time(seirconn)"},{"path":"/reference/epiworld-methods.html","id":null,"dir":"Reference","previous_headings":"","what":"Methods for epiworldR objects — epiworld-methods","title":"Methods for epiworldR objects — epiworld-methods","text":"functions described section methods objects class epiworld_model. Besides printing plotting, methods provide access manipulate model parameters, getting information model running simulation.","code":""},{"path":"/reference/epiworld-methods.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Methods for epiworldR objects — epiworld-methods","text":"","code":"queuing_on(x)  queuing_off(x)  verbose_off(x)  verbose_on(x)  run(model, ndays, seed = sample.int(10000, 1))  # S3 method for class 'epiworld_model' summary(object, ...)  get_states(x)  get_param(x, pname)  set_param(x, pname, pval)  set_name(x, mname)  get_name(x)  get_n_viruses(x)  get_n_tools(x)  get_ndays(x)  get_n_replicates(x)  size(x)  set_agents_data(model, data)  get_agents_data_ncols(model)  get_virus(model, virus_pos)  get_tool(model, tool_pos)  initial_states(model, proportions)  clone_model(model)"},{"path":"/reference/epiworld-methods.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Methods for epiworldR objects — epiworld-methods","text":"x object class epiworld_model. model Model object. ndays Number days (steps) simulation. seed Seed set initializing random number generator. object Object class epiworld_model. ... Additional arguments. pname String. Name parameter. pval Numeric. Value parameter. mname String. Name model. data numeric matrix. virus_pos Integer. Relative location (starting 0) virus model tool_pos Integer. Relative location (starting 0) tool model proportions Numeric vector. Proportions agents distributed (see details).","code":""},{"path":"/reference/epiworld-methods.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Methods for epiworldR objects — epiworld-methods","text":"verbose_on verbose_off functions return model, however verbose_off returns model progress bar. run function returns simulated model class epiworld_model. summary function prints detailed view model, returns model invisibly. get_states function returns unique states found model. get_param function returns selected parameter model object class epiworld_model. set_param function return value instead alters parameter value. set_name function return value instead alters object epiworld_model. get_name returns name model. get_n_viruses returns number viruses model. get_n_tools returns number tools model. get_ndays returns number days model. get_n_replicates returns number replicates model. size.epiworld_model returns number agents model. 'set_agents_data' function returns object class DataFrame. 'get_agents_data_ncols' returns number columns model dataframe. 'get_virus' returns virus. get_tool returns tool. inital_states returns model updated initial state. clone_model returns copy model.","code":""},{"path":"/reference/epiworld-methods.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Methods for epiworldR objects — epiworld-methods","text":"verbose_on verbose_off functions activate deactivate printing progress screen, respectively. functions return model (x) invisibly. epiworld_model objects pointers underlying C++ class epiworld. generate copy model, use clone_model, otherwise, assignment operator copy pointer.","code":""},{"path":"/reference/epiworld-methods.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Methods for epiworldR objects — epiworld-methods","text":"","code":"model_sirconn <- ModelSIRCONN( name                = \"COVID-19\", n                   = 10000, prevalence          = 0.01, contact_rate        = 5, transmission_rate   = 0.4, recovery_rate       = 0.95 )  # Queuing - If you wish to implement the queuing function, declare whether  # you would like it \"on\" or \"off\", if any.  queuing_on(model_sirconn) #> Warning: SIR Connected models do not have queue. queuing_off(model_sirconn) run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # Verbose - \"on\" prints the progress bar on the screen while \"off\"  # deactivates the progress bar. Declare which function you want to implement,  # if any.  verbose_on(model_sirconn) verbose_off(model_sirconn) run(model_sirconn, ndays = 100, seed = 1912)  get_states(model_sirconn) # Returns all unique states found within the model. #> [1] \"Susceptible\" \"Infected\"    \"Recovered\"    get_param(model_sirconn, 'Contact rate') # Returns the value of the selected  #> [1] 5                                          # parameter within the model object.                                          # In order to view the parameters,                                           # run the model object and find the                                           # \"Model parameters\" section.   set_param(model_sirconn, 'Contact rate', 2) # Allows for adjustment of model                                              # parameters within the model                                              # object. In this example, the                                              # Contact rate parameter is                                              # changed to 2. You can now rerun                                              # the model to observe any                                              # differences.                                              set_name(model_sirconn, 'My Epi-Model') # This function allows for setting                                          # a name for the model. Running the                                          # model object, the name of the model                                         # is now reflected next to \"Name of                                          # the model\".                                           get_name(model_sirconn) # Returns the set name of the model.  #> [1] \"My Epi-Model\"  get_n_viruses(model_sirconn) # Returns the number of viruses in the model.  #> [1] 1                               # In this case, there is only one virus:                               # \"COVID-19\".                                 get_n_tools(model_sirconn) # Returns the number of tools in the model. In  #> [1] 0                            # this case, there are zero tools.                               get_ndays(model_sirconn) # Returns the length of the simulation in days. This #> [1] 100                          # will match \"ndays\" within the \"run\" function.                            get_n_replicates(model_sirconn) # Returns the number of replicates of the  #> [1] 2                                 # model.                                   size(model_sirconn) # Returns the population size in the model. In this case,  #> [1] 10000                     # there are 10,000 agents in the model.  # Set Agents Data # First, your data matrix must have the same number of rows as agents in the  # model. Below is a generated matrix which will be passed into the  # \"set_agents_data\" function.  data <- matrix(data=runif(20000, min=0, max=100), nrow=10000, ncol=2)                    set_agents_data(model_sirconn, data) get_agents_data_ncols(model_sirconn) # Returns number of columns  #> [1] 2  get_virus(model_sirconn, 0) # Returns information about the first virus in  #> Virus         : COVID-19 #> Id            : 0 #> state_init    : 1 #> state_post    : 2 #> state_removed : 2 #> queue_init    : 2 #> queue_post    : -2 #> queue_removed : -99                             # the model (index begins at 0).  add_tool(model_sirconn, tool(\"Vaccine\", .9, .9, .5, 1, prevalence = 0.5, as_prop = TRUE))                             get_tool(model_sirconn, 0) # Returns information about the first tool in the  #> Tool       : Vaccine #> Id         : 0 #> state_init : -99 #> state_post : -99 #> queue_init : 0 #> queue_post : 0                            # model. In this case, there are no tools so an                             # error message will occur."},{"path":"/reference/epiworldR-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","title":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","text":"Starting version 0.0-4, epiworld changed refered \"actions.\" Following traditional ABMs, actions now called \"events.\"","code":""},{"path":"/reference/epiworldR-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","text":"","code":"add_tool_n(model, tool, n)  add_virus_n(model, virus, n)  globalaction_tool(...)  globalaction_tool_logit(...)  globalaction_set_params(...)  globalaction_fun(...)"},{"path":"/reference/epiworldR-deprecated.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","text":"model Model object class epiworld_model. tool Tool object class epiworld_tool. n Deprecated. virus Virus object class epiworld_virus. ... Arguments passed new function.","code":""},{"path":"/reference/epiworldR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"epiworldR — epiworldR-package","title":"epiworldR — epiworldR-package","text":"flexible framework Agent-Based Models (ABM), 'epiworldR' package provides methods prototyping disease outbreaks transmission models using 'C++' backend, making fast. supports multiple epidemiological models, including Susceptible-Infected-Susceptible (SIS), Susceptible-Infected-Removed (SIR), Susceptible-Exposed-Infected-Removed (SEIR), others, involving arbitrary mitigation policies multiple-disease models. Users can specify infectiousness/susceptibility rates function agents' features, providing great complexity model dynamics. Furthermore, 'epiworldR' ideal simulation studies featuring large populations.","code":""},{"path":[]},{"path":"/reference/epiworldR-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"epiworldR — epiworldR-package","text":"Maintainer: Derek Meyer derekmeyer37@gmail.com (ORCID) Authors: George Vega Yon g.vegayon@gmail.com (ORCID) contributors: Susan Holmes (ORCID) (JOSS reviewer) [reviewer] Abinash Satapathy (ORCID) (JOSS reviewer) [reviewer] Carinogurjao [reviewer] Centers Disease Control Prevention (Award number 1U01CK000585; 75D30121F00003) [funder]","code":""},{"path":"/reference/global-actions.html","id":null,"dir":"Reference","previous_headings":"","what":"Global Actions — global-actions","title":"Global Actions — global-actions","text":"Global actions functions executed time step simulation. useful implementing interventions, vaccination, isolation, social distancing means tools.","code":""},{"path":"/reference/global-actions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Global Actions — global-actions","text":"","code":"globalevent_tool(tool, prob, name = get_name_tool(tool), day = -99)  globalevent_tool_logit(   tool,   vars,   coefs,   name = get_name_tool(tool),   day = -99 )  globalevent_set_params(   param,   value,   name = paste0(\"Set \", param, \" to \", value),   day = -99 )  globalevent_fun(fun, name = deparse(substitute(fun)), day = -99)  add_globalevent(model, action)"},{"path":"/reference/global-actions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Global Actions — global-actions","text":"tool object class tool. prob Numeric scalar. probability 0 1. name Character scalar. name action. day Integer. day (step) action executed (see details). vars Integer vector. position variables model. coefs Numeric vector. coefficients logistic regression. param Character scalar. name parameter set. value Numeric scalar. value parameter. fun Function. function executed. model object class epiworld_model. action global action.","code":""},{"path":"/reference/global-actions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Global Actions — global-actions","text":"globalevent_set_params function returns object class epiworld_globalevent_set_param epiworld_globalevent. globalevent_tool returns object class epiworld_globalevent_tool epiworld_globalevent. globalevent_tool_logit returns object class epiworld_globalevent_tool_logit epiworld_globalevent. function add_globalevent returns model added action.","code":""},{"path":"/reference/global-actions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Global Actions — global-actions","text":"function globalevent_tool_logit allows specify logistic regression model probability using tool. model specified vector coefficients coefs vector variables vars. vars integer vector indicating position variables model. function globalevent_set_param allows set parameter model. parameter specified name param value value. function globalevent_fun allows specify function executed given day. function object must receive object class epiworld_model argument. function add_globalevent adds global action model. model checks actions executed time step. added action matches current time step, action executed. day negative, action executed time step. day positive, action executed specified time step.","code":""},{"path":[]},{"path":"/reference/global-actions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Global Actions — global-actions","text":"","code":"# Simple model model_sirconn <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )  # Creating a tool epitool <- tool(   name = \"Vaccine\",   prevalence = 0,   as_proportion = FALSE,   susceptibility_reduction = .9,   transmission_reduction = .5,   recovery_enhancer = .5,    death_reduction = .9 )   # Adding a global action vaccine_day_20 <- globalevent_tool(epitool, .2, day = 20) add_globalevent(model_sirconn, vaccine_day_20)  # Running and printing run(model_sirconn, ndays = 40, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. model_sirconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 1 tool(s). #> The model has 3 states. #> The final distribution is: 2056 Susceptible, 0 Infected, and 7944 Recovered. plot_incidence(model_sirconn)   # Example 2: Changing the contact rate ------------------------------------- model_sirconn2 <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )  closure_day_10 <- globalevent_set_params(\"Contact rate\", 0, day = 10) add_globalevent(model_sirconn2, closure_day_10)  # Running and printing run(model_sirconn2, ndays = 40, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. model_sirconn2 #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 2115 Susceptible, 0 Infected, and 7885 Recovered. plot_incidence(model_sirconn2)  # Example using `globalevent_fun` to record the state of the # agents at each time step.  # We start by creating an SIR connected model model <- ModelSIRCONN(   name              = \"SIR with Global Saver\",   n                 = 1000,   prevalence        = 0.01,   contact_rate      = 5,   transmission_rate = 0.4,   recovery_rate     = 0.3   )  # We create the object where the history of the agents will be stored agents_history <- NULL  # This function prints the total number of agents in each state # and stores the history of the agents in the object `agents_history` hist_saver <- function(m) {      message(\"Today's totals are: \", paste(get_today_total(m), collapse = \", \"))    # We use the `<<-` operator to assign the value to the global variable   # `agents_history` (see ?\"<<-\")   agents_history <<- cbind(     agents_history,     get_agents_states(m)     )      }"},{"path":"/reference/run_multiple.html","id":null,"dir":"Reference","previous_headings":"","what":"Run multiple simulations at once — run_multiple","title":"Run multiple simulations at once — run_multiple","text":"run_multiple function allows running multiple simulations . available, users can take advantage parallel computing speed process.","code":""},{"path":"/reference/run_multiple.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run multiple simulations at once — run_multiple","text":"","code":"run_multiple(   m,   ndays,   nsims,   seed = sample.int(10000, 1),   saver = make_saver(),   reset = TRUE,   verbose = TRUE,   nthreads = 1L )  run_multiple_get_results(m)  make_saver(..., fn = \"\")"},{"path":"/reference/run_multiple.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run multiple simulations at once — run_multiple","text":"m, ndays, seed See run. nsims Integer. Number replicats saver object class epiworld_saver. reset TRUE (default,) resets simulation. verbose TRUE (default,) prints progress bar. nthreads Integer. Number threads (parallel computing.) ... List strings (characters) specifying save (see details). fn file name pattern.","code":""},{"path":"/reference/run_multiple.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run multiple simulations at once — run_multiple","text":"case make_saver, list class epiworld_saver. run_multiple function runs specified number simulations returns model object class epiworld_model. run_multiple_get_results function returns named list data specified make_saver.","code":""},{"path":"/reference/run_multiple.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Run multiple simulations at once — run_multiple","text":"Currently, following elements can saved: total_hist History model (total numbers per time). virus_info Information viruses. virus_hist Changes viruses. tool_info Information tools. tool_hist Changes tools. transmission Transmission events. transition Transition matrices. reproductive Reproductive number. generation Estimation generation time.","code":""},{"path":"/reference/run_multiple.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run multiple simulations at once — run_multiple","text":"","code":"model_sir <- ModelSIRCONN(   name = \"COVID-19\",   prevalence = 0.01,   n = 1000,   contact_rate = 2,   transmission_rate = 0.9, recovery_rate = 0.1   )  # Generating a saver saver <- make_saver(\"total_hist\", \"reproductive\")  # Running and printing run_multiple(model_sir, ndays = 100, nsims = 50, saver = saver, nthreads = 2) #> Starting multiple runs (50) using 2 thread(s) #> _________________________________________________________________________ #> _________________________________________________________________________ #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # Retrieving the results ans <- run_multiple_get_results(model_sir)  head(ans$total_hist) #>   sim_num date nviruses       state counts #> 1       1    0        1 Susceptible    990 #> 2       1    0        1    Infected     10 #> 3       1    0        1   Recovered      0 #> 4       1    1        1 Susceptible    975 #> 5       1    1        1    Infected     24 #> 6       1    1        1   Recovered      1 head(ans$reproductive) #>   sim_num virus_id    virus source source_exposure_date rt #> 1       1        0 COVID-19     67                   10  0 #> 2       1        0 COVID-19    981                    9  0 #> 3       1        0 COVID-19    880                    9  0 #> 4       1        0 COVID-19    673                    9  0 #> 5       1        0 COVID-19    452                    9  0 #> 6       1        0 COVID-19    913                    8  0  # Plotting multi_sir <- run_multiple_get_results(model_sir)$total_hist multi_sir <- multi_sir[multi_sir$date <= 20,] plot(multi_sir)"},{"path":"/reference/tool.html","id":null,"dir":"Reference","previous_headings":"","what":"Tools in epiworld — tool","title":"Tools in epiworld — tool","text":"Tools functions affect agents react virus. can used simulate effects vaccination, isolation, social distancing.","code":""},{"path":"/reference/tool.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Tools in epiworld — tool","text":"","code":"tool(   name,   prevalence,   as_proportion,   susceptibility_reduction,   transmission_reduction,   recovery_enhancer,   death_reduction )  set_name_tool(tool, name)  get_name_tool(tool)  add_tool(model, tool, proportion)  rm_tool(model, tool_pos)  tool_fun_logit(vars, coefs, model)  set_susceptibility_reduction(tool, prob)  set_susceptibility_reduction_ptr(tool, model, param)  set_susceptibility_reduction_fun(tool, model, tfun)  set_transmission_reduction(tool, prob)  set_transmission_reduction_ptr(tool, model, param)  set_transmission_reduction_fun(tool, model, tfun)  set_recovery_enhancer(tool, prob)  set_recovery_enhancer_ptr(tool, model, param)  set_recovery_enhancer_fun(tool, model, tfun)  set_death_reduction(tool, prob)  set_death_reduction_ptr(tool, model, param)  set_death_reduction_fun(tool, model, tfun)  # S3 method for class 'epiworld_agents_tools' print(x, max_print = 10, ...)  set_distribution_tool(tool, distfun)  distribute_tool_randomly(prevalence, as_proportion)  distribute_tool_to_set(agents_ids)"},{"path":"/reference/tool.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Tools in epiworld — tool","text":"name Name tool prevalence Numeric scalar. Prevalence tool. as_proportion Logical scalar. TRUE, prevalence interpreted proportion total number agents model. susceptibility_reduction Numeric. Proportion reduces susceptibility. transmission_reduction Numeric. Proportion reduces transmission. recovery_enhancer Numeric. Proportion improves recovery. death_reduction Numeric. Proportion reduces probability death.e tool object class epiworld_tool model Model proportion Deprecated. tool_pos Positive integer. Index tool's position model. vars Integer vector. Indices (starting 0) positions variables used compute logit probability. coefs Numeric vector. length vars, vector coefficients associated logit probability. prob Numeric scalar. probability (zero one). param Character scalar. Name parameter featured model added tool (see details). tfun object class epiworld_tool_fun. x object class epiworld_agents_tools. max_print Numeric scalar. Maximum number tools print. ... Currently ignored. distfun object class epiworld_tool_distfun. agents_ids Integer vector. Indices agents tool assigned.","code":""},{"path":"/reference/tool.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Tools in epiworld — tool","text":"tool function creates tool class epiworld_tool. set_name_tool function assigns name tool class epiworld_tool returns tool. get_name_tool function returns name tool class epiworld_tool. rm_tool function removes specified tool model. set_susceptibility_reduction function assigns probability reduction specified tool class epiworld_tool. set_transmission_reduction function assigns probability reduction specified tool class epiworld_tool. set_recovery_enhancer function assigns probability increase specified tool class epiworld_tool. set_death_reduction function assigns probability decrease specified tool class epiworld_tool. distribute_tool_randomly function returns distribution function class epiworld_tool_distfun. distribute_tool_to_set function returns distribution function class epiworld_tool_distfun.","code":""},{"path":"/reference/tool.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Tools in epiworld — tool","text":"name epiworld_tool object can manipulated functions set_name_tool() get_name_tool(). add_tool function adds specified tool model class epiworld_model specified proportion. case set_susceptibility_reduction_ptr, set_transmission_reduction_ptr, set_recovery_enhancer, set_death_reduction_ptr, corresponding parameters passed pointer tool. implication using pointers values read directly model object, changes reflected. set_distribution_tool function assigns distribution function specified tool class epiworld_tool. distribution function can created using functions distribute_tool_randomly() distribute_tool_to_set(). distribute_tool_randomly function creates distribution function randomly assigns tool proportion population. distribute_tool_to_set function creates distribution function assigns tool set agents.","code":""},{"path":"/reference/tool.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Tools in epiworld — tool","text":"","code":"# Simple model model_sirconn <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )  # Running and printing run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. plot(model_sirconn)   epitool <- tool(   name = \"Vaccine\",   prevalence = 0.5,   as_proportion = TRUE,   susceptibility_reduction = .9,   transmission_reduction = .5,   recovery_enhancer = .5,    death_reduction = .9 )  epitool #> Tool       : Vaccine #> Id         : (empty) #> state_init : -99 #> state_post : -99 #> queue_init : 0 #> queue_post : 0  set_name_tool(epitool, 'Pfizer') # Assigning name to the tool get_name_tool(epitool) # Returning the name of the tool #> [1] \"Pfizer\" add_tool(model_sirconn, epitool) run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sirconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 1 tool(s). #> The model has 3 states. #> The final distribution is: 8546 Susceptible, 0 Infected, and 1454 Recovered. plot(model_sirconn)   # To declare a certain number of individuals with the tool rm_tool(model_sirconn, 0) # Removing epitool from the model # Setting prevalence to 0.1 set_distribution_tool(epitool, distribute_tool_randomly(0.1, TRUE)) add_tool(model_sirconn, epitool) run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # Adjusting probabilities due to tool set_susceptibility_reduction(epitool, 0.1) # Susceptibility reduction  #> Tool       : Pfizer #> Id         : 0 #> state_init : -99 #> state_post : -99 #> queue_init : 0 #> queue_post : 0 set_transmission_reduction(epitool, 0.2) # Transmission reduction set_recovery_enhancer(epitool, 0.15) # Probability increase of recovery set_death_reduction(epitool, 0.05) # Probability reduction of death  rm_tool(model_sirconn, 0)  add_tool(model_sirconn, epitool) run(model_sirconn, ndays = 100, seed = 1912) # Run model to view changes #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.   # Using the logit function -------------- sir <- ModelSIR(   name = \"COVID-19\", prevalence = 0.01,    transmission_rate = 0.9, recovery_rate = 0.1   )  # Adding a small world population agents_smallworld(   sir,   n = 10000,   k = 5,   d = FALSE,   p = .01 )  # Creating a tool mask_wearing <- tool(   name = \"Mask\",   prevalence               = 0.5,   as_proportion            = TRUE,   susceptibility_reduction = 0.0,   transmission_reduction   = 0.3, # Only transmission   recovery_enhancer        = 0.0,   death_reduction          = 0.0 )  add_tool(sir, mask_wearing)  run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. hist_0 <- get_hist_total(sir)  # And adding features dat <- cbind(   female = sample.int(2, 10000, replace = TRUE) - 1,   x      = rnorm(10000) )  set_agents_data(sir, dat)  # Creating the logit function tfun <- tool_fun_logit(   vars  = c(0L, 1L),   coefs = c(-1, 1),   model = sir )  # The infection prob is lower hist(plogis(dat %*% rbind(.5,1)))   tfun # printing #> An epiworld_tool_function object. #> (model: Susceptible-Infected-Recovered (SIR)) #> This function was built using -tool_fun_logit()-. and it features the following coefficients: #>   0: -1.00 #>   1:  1.00    set_susceptibility_reduction_fun(   tool  = get_tool(sir, 0),   model = sir,   tfun  = tfun   )    run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. hist_1 <- get_hist_total(sir)  op <- par(mfrow = c(1, 2)) plot(hist_0); abline(v = 30) plot(hist_1); abline(v = 30)  par(op)"},{"path":"/reference/virus.html","id":null,"dir":"Reference","previous_headings":"","what":"Virus design — virus","title":"Virus design — virus","text":"Viruses can considered anything can transmitted (e.g., diseases, well ideas.) models epiworldR can feature multiple viruses.","code":""},{"path":"/reference/virus.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Virus design — virus","text":"","code":"virus(   name,   prevalence,   as_proportion,   prob_infecting,   recovery_rate = 0.5,   prob_death = 0,   post_immunity = -1,   incubation = 7 )  set_name_virus(virus, name)  get_name_virus(virus)  add_virus(model, virus, proportion)  virus_set_state(virus, init, end, removed)  rm_virus(model, virus_pos)  virus_fun_logit(vars, coefs, model)  set_prob_infecting(virus, prob)  set_prob_infecting_ptr(virus, model, param)  set_prob_infecting_fun(virus, model, vfun)  set_prob_recovery(virus, prob)  set_prob_recovery_ptr(virus, model, param)  set_prob_recovery_fun(virus, model, vfun)  set_prob_death(virus, prob)  set_prob_death_ptr(virus, model, param)  set_prob_death_fun(virus, model, vfun)  set_incubation(virus, incubation)  set_incubation_ptr(virus, model, param)  set_incubation_fun(virus, model, vfun)  set_distribution_virus(virus, distfun)  distribute_virus_randomly(prevalence, as_proportion)  distribute_virus_set(agents_ids)"},{"path":"/reference/virus.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Virus design — virus","text":"name virus prevalence Numeric scalar. Prevalence virus. as_proportion Logical scalar. TRUE, prevalence set proportion total number agents model. prob_infecting Numeric scalar. Probability infection (transmission). recovery_rate Numeric scalar. Probability recovery. prob_death Numeric scalar. Probability death. post_immunity Numeric scalar. Post immunity (prob re-infection). incubation Numeric scalar. Incubation period (days) virus. virus object class epiworld_virus model object class epiworld_model. proportion Deprecated. init, end, removed states acquiring virus, removing virus, removing agent result virus, respectively. virus_pos Positive integer. Index virus's position model. vars Integer vector. Indices (starting 0) positions variables used compute logit probability. coefs Numeric vector. length vars, vector coefficients associated logit probability. prob Numeric scalar. probability (zero one). param Character scalar. Name parameter featured model added virus (see details). vfun object class epiworld_virus_fun. distfun object class epiworld_distribution_virus. agents_ids Integer vector. Indices agents receive virus.","code":""},{"path":"/reference/virus.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Virus design — virus","text":"set_name_virus function return value, merely assigns name virus choice. get_name_virus function returns name virus class epiworld_virus. add_virus function return value, instead adds virus choice model object class epiworld_model. virus_set_state function return value assigns epidemiological properties specified virus class epiworld_virus. rm_virus function return value, instead removes specified virus model class epiworld_model. set_prob_infecting function return value, instead assigns probability infection specified virus class epiworld_virus. set_prob_recovery function return value, instead assigns probability recovery specified virus class epiworld_virus. set_prob_death function return value, instead assigns probability death specified virus class epiworld_virus. set_incubation function return value, instead assigns incubation period specified virus class epiworld_virus. distribute_virus_randomly function returns function can used distribute virus model.","code":""},{"path":"/reference/virus.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Virus design — virus","text":"virus() function can used initialize virus. Virus features can modified using functions set_prob_*. function virus_fun_logit() creates \"virus function\" can evaluated transmission, recovery, death. name sugests, computes probabilities using logit function (see examples). name epiworld_virus object can manipulated functions set_name_virus() get_name_virus(). case set_prob_infecting_ptr, set_prob_recovery_ptr, set_prob_death_ptr, corresponding parameters passed pointer virus. implication using pointers values read directly model object, changes reflected. distribute_virus_randomly function factory function used randomly distribute virus model. prevalence can set proportion number agents. resulting function can passed set_distribution_virus.","code":""},{"path":"/reference/virus.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Virus design — virus","text":"","code":"mseirconn <- ModelSEIRCONN(   name                = \"COVID-19\",   prevalence          = 0.01,    n                   = 10000,   contact_rate        = 4,    incubation_days     = 7,    transmission_rate   = 0.5,   recovery_rate       = 0.99 )  delta <- virus(   \"Delta Variant\", 0, .5, .2, .01, prevalence = 0.3, as_proportion = TRUE )  # Adding virus and setting/getting virus name add_virus(mseirconn, delta) set_name_virus(delta, \"COVID-19 Strain\") get_name_virus(delta) #> [1] \"COVID-19 Strain\"  run(mseirconn, ndays = 100, seed = 992) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. mseirconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> It features 10000 agents, 2 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 3685 Susceptible, 167 Exposed, 24 Infected, and 6124 Recovered.  rm_virus(mseirconn, 0) # Removing the first virus from the model object set_distribution_virus(delta, distribute_virus_randomly(100, as_proportion = FALSE)) add_virus(mseirconn, delta)   # Setting parameters for the delta virus manually set_prob_infecting(delta, 0.5) set_prob_recovery(delta, 0.9) set_prob_death(delta, 0.01) run(mseirconn, ndays = 100, seed = 992) # Run the model to observe changes #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # If the states were (for example): # 1: Infected # 2: Recovered # 3: Dead delta2 <- virus(   \"Delta Variant 2\", 0, .5, .2, .01, prevalence = 0, as_proportion = TRUE ) virus_set_state(delta2, 1, 2, 3) # Using the logit function -------------- sir <- ModelSIR(   name = \"COVID-19\", prevalence = 0.01,    transmission_rate = 0.9, recovery = 0.1   )  # Adding a small world population agents_smallworld(   sir,   n = 10000,   k = 5,   d = FALSE,   p = .01 )  run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. plot(sir)   # And adding features dat <- cbind(   female = sample.int(2, 10000, replace = TRUE) - 1,   x      = rnorm(10000) )  set_agents_data(sir, dat)  # Creating the logit function vfun <- virus_fun_logit(   vars  = c(0L, 1L),   coefs = c(-1, 1),   model = sir )  # The infection prob is lower hist(plogis(dat %*% rbind(-1,1)))   vfun # printing #> An epiworld_virus_function object. #> (model: Susceptible-Infected-Recovered (SIR)) #> This function was built using -virus_fun_logit()-. and it features the following coefficients: #>   0: -1.00 #>   1:  1.00   set_prob_infecting_fun(   virus = get_virus(sir, 0),   model = sir,   vfun  = vfun   )    run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. plot(sir)"},{"path":"/news/index.html","id":"epiworldr-03-2-dev","dir":"Changelog","previous_headings":"","what":"epiworldR 0.3-2 (dev)","title":"epiworldR 0.3-2 (dev)","text":"Starting version 0.3-0, epiworldR versioned using version C++ library, epiworld. Adds new mixing models ModelSIRMixing ModelSEIRMixing. Ports Entity class. Entities used group agents within model. Refactors add_tool, add_virus, add_entity simplifying syntax. Now, functions receive model object. Prevalence specified object . add_tool_n add_virus_n now deprecated. globalaction_* now defunct. Use globalevent_* instead. New functions specify viruses, tools, entities distributed among agents: distribute_viruses, distribute_tools, distribute_entities.","code":""},{"path":"/news/index.html","id":"epiworldr-01-0","dir":"Changelog","previous_headings":"","what":"epiworldR 0.1-0`","title":"epiworldR 0.1-0`","text":"CRAN release: 2024-04-08 Force model update agents’ states running simulation. causing issues calling run_multiple() single call run(). Reported 14.","code":""},{"path":"/news/index.html","id":"epiworldr-00-4","dir":"Changelog","previous_headings":"","what":"epiworldR 0.0-4","title":"epiworldR 0.0-4","text":"CRAN release: 2024-02-09 Added missing checks tool class adding model add_too_n. Various small improvements.","code":""},{"path":"/news/index.html","id":"epiworldr-00-3","dir":"Changelog","previous_headings":"","what":"epiworldR 0.0-3","title":"epiworldR 0.0-3","text":"CRAN release: 2023-09-08 Added following models: ModelSEIRD, ModelSEIRDCONN, ModelSIRD, ModelSIRDCONN, ModelSISD. Fixed bug reported issue 6.","code":""},{"path":"/news/index.html","id":"epiworldr-00-2","dir":"Changelog","previous_headings":"","what":"epiworldR 0.0-2","title":"epiworldR 0.0-2","text":"CRAN release: 2023-06-21 Added NEWS.md file track changes package. Fixed bug reported CRAN reference nullptr. Renamed arguments across Models favor consistency. Figures now show virus/tool name instead id. Fixed bug run_multiple added tests (C++). Redid autoconf Makevars using RcppArmadillo template checking OpenMP.","code":""}]
+[{"path":[]},{"path":"/CODE_OF_CONDUCT.html","id":"our-pledge","dir":"","previous_headings":"","what":"Our Pledge","title":"Contributor Covenant Code of Conduct","text":"members, contributors, leaders pledge make participation community harassment-free experience everyone, regardless age, body size, visible invisible disability, ethnicity, sex characteristics, gender identity expression, level experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, sexual identity orientation. pledge act interact ways contribute open, welcoming, diverse, inclusive, healthy community.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"our-standards","dir":"","previous_headings":"","what":"Our Standards","title":"Contributor Covenant Code of Conduct","text":"Examples behavior contributes positive environment community include: Demonstrating empathy kindness toward people respectful differing opinions, viewpoints, experiences Giving gracefully accepting constructive feedback Accepting responsibility apologizing affected mistakes, learning experience Focusing best just us individuals, overall community Examples unacceptable behavior include: use sexualized language imagery, sexual attention advances kind Trolling, insulting derogatory comments, personal political attacks Public private harassment Publishing others’ private information, physical email address, without explicit permission conduct reasonably considered inappropriate professional setting","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"enforcement-responsibilities","dir":"","previous_headings":"","what":"Enforcement Responsibilities","title":"Contributor Covenant Code of Conduct","text":"Community leaders responsible clarifying enforcing standards acceptable behavior take appropriate fair corrective action response behavior deem inappropriate, threatening, offensive, harmful. Community leaders right responsibility remove, edit, reject comments, commits, code, wiki edits, issues, contributions aligned Code Conduct, communicate reasons moderation decisions appropriate.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"scope","dir":"","previous_headings":"","what":"Scope","title":"Contributor Covenant Code of Conduct","text":"Code Conduct applies within community spaces, also applies individual officially representing community public spaces. Examples representing community include using official e-mail address, posting via official social media account, acting appointed representative online offline event.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"enforcement","dir":"","previous_headings":"","what":"Enforcement","title":"Contributor Covenant Code of Conduct","text":"Instances abusive, harassing, otherwise unacceptable behavior may reported community leaders responsible enforcement derekmeyer37@gmail.com. complaints reviewed investigated promptly fairly. community leaders obligated respect privacy security reporter incident.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"enforcement-guidelines","dir":"","previous_headings":"","what":"Enforcement Guidelines","title":"Contributor Covenant Code of Conduct","text":"Community leaders follow Community Impact Guidelines determining consequences action deem violation Code Conduct:","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_1-correction","dir":"","previous_headings":"Enforcement Guidelines","what":"1. Correction","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Use inappropriate language behavior deemed unprofessional unwelcome community. Consequence: private, written warning community leaders, providing clarity around nature violation explanation behavior inappropriate. public apology may requested.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_2-warning","dir":"","previous_headings":"Enforcement Guidelines","what":"2. Warning","title":"Contributor Covenant Code of Conduct","text":"Community Impact: violation single incident series actions. Consequence: warning consequences continued behavior. interaction people involved, including unsolicited interaction enforcing Code Conduct, specified period time. includes avoiding interactions community spaces well external channels like social media. Violating terms may lead temporary permanent ban.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_3-temporary-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"3. Temporary Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: serious violation community standards, including sustained inappropriate behavior. Consequence: temporary ban sort interaction public communication community specified period time. public private interaction people involved, including unsolicited interaction enforcing Code Conduct, allowed period. Violating terms may lead permanent ban.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"id_4-permanent-ban","dir":"","previous_headings":"Enforcement Guidelines","what":"4. Permanent Ban","title":"Contributor Covenant Code of Conduct","text":"Community Impact: Demonstrating pattern violation community standards, including sustained inappropriate behavior, harassment individual, aggression toward disparagement classes individuals. Consequence: permanent ban sort public interaction within community.","code":""},{"path":"/CODE_OF_CONDUCT.html","id":"attribution","dir":"","previous_headings":"","what":"Attribution","title":"Contributor Covenant Code of Conduct","text":"Code Conduct adapted Contributor Covenant, version 2.1, available https://www.contributor-covenant.org/version/2/1/code_of_conduct.html. Community Impact Guidelines inspired Mozilla’s code conduct enforcement ladder. answers common questions code conduct, see FAQ https://www.contributor-covenant.org/faq. Translations available https://www.contributor-covenant.org/translations.","code":""},{"path":"/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2023 George G. Vega Yon Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":[]},{"path":"/articles/getting-started.html","id":"setup-and-running-the-model","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Setup and running the model","title":"Getting started with epiworldR","text":"example implements social network parameters listed within ModelSIRCONN function. virus name specified (COVID-19), 50000 agents initialized, virus prevalence 0.001 declared, agent contact two others (contact_rate), transmission rate given agent 0.3, recovery rate set 13\\frac{1}{3}. create model epiworldR, simply use ModelSIRCONN function. , example take basic features epiworldR. Printing model shows us information. Nevertheless, can extract detailed information using summary method. First, name model, population size, number entities (think public spaces agents can make social contact one another), duration days, number viruses, amount time last replicate took run (last run elapsed t), rewiring status (). model also includes list global actions (interventions) called model run. Next, see list viruses used model. case, COVID-19 virus used. Note epiworldR can include one virus model. Tool(s) lists agents’ tools fight virus. Examples may include masking, vaccines, social distancing, etc. model, tools specified. Lastly, model parameters listed. execute model, use run function SIR model object, number simulation days, optional seed reproducibility. Next, print results simulated model using model_sir. two additional sections included summary running model. First, see distribution population time 50. section describes flow agents state (SIR) 50 days. example, ’ll see number agents susceptible state decreased 49,995 3,245, number agents infected state increased 5 1, recovered agents increased 46,754 50 days. counts states change based model parameters simulation run-time. transmission probabilities section outputs 3x3 matrix describes probability moving one state another. example, susceptible row, agent 0.95 probability remaining susceptible state 0.05 probability moving susceptible state infected state. Notice chance skipping states. words, agent can’t jump susceptible state recovered state; agent must pass infected state progress recovered state. logic applies moving backward; agent become susceptible infection.","code":"library(epiworldR) model_sir <- ModelSIRCONN(   name              = \"COVID-19\",   n                 = 50000,   prevalence        = 0.0001,   contact_rate      = 2,   transmission_rate = 0.5,   recovery_rate     = 1 / 3 )  # Printing the model model_sir #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 50000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. The model hasn't been run yet. summary(model_sir) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) (connected) #> Population size     : 50000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 0 (of 0) #> Number of viruses   : 1 #> Last run elapsed t  : - #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - COVID-19 #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate      : 2.0000 #>  - Recovery rate     : 0.3333 #>  - Transmission rate : 0.5000 run(model_sir, ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. summary(model_sir) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) (connected) #> Population size     : 50000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 50 (of 50) #> Number of viruses   : 1 #> Last run elapsed t  : 98.00ms #> Last run speed      : 25.45 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - COVID-19 #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate      : 2.0000 #>  - Recovery rate     : 0.3333 #>  - Transmission rate : 0.5000 #>  #> Distribution of the population at time 50: #>   - (0) Susceptible : 49995 -> 3245 #>   - (1) Infected    :     5 -> 1 #>   - (2) Recovered   :     0 -> 46754 #>  #> Transition Probabilities: #>  - Susceptible  0.95  0.05  0.00 #>  - Infected     0.00  0.68  0.32 #>  - Recovered    0.00  0.00  1.00"},{"path":[]},{"path":"/articles/getting-started.html","id":"extracting-information","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Extracting information","title":"Getting started with epiworldR","text":"running epiworldR model, list functions can called using epiworld model object. demonstrate, start basic plot get_hist_total functions.  evident plot, SIR model constructed epiworldR displays changes susceptible, infected, recovered case counts time (days). Notice certain amount time, curves flatten. , table representation plot printed, complete state within SIR model, date, agent counts. essential statistic epidemiological models reproductive number: epiworldR method plot reproductive number automatically. function takes average values table date repeats data accounted .  Another typical piece information daily incidence. number new cases per day. epiworldR, can get incidence looking daily transitions states. Although function get_hist_transition_matrix provides desired data, function plot_incidence nice wrapper visualizing data:","code":"methods(class = \"epiworld_model\") #>  [1] add_tool                   add_virus                  #>  [3] agents_from_edgelist       agents_smallworld          #>  [5] get_agents                 get_hist_tool              #>  [7] get_hist_total             get_hist_transition_matrix #>  [9] get_hist_virus             get_n_replicates           #> [11] get_n_tools                get_n_viruses              #> [13] get_name                   get_ndays                  #> [15] get_param                  get_reproductive_number    #> [17] get_states                 get_today_total            #> [19] get_transition_probability get_transmissions          #> [21] print                      queuing_off                #> [23] queuing_on                 run_multiple               #> [25] run                        set_name                   #> [27] set_param                  size                       #> [29] summary                    verbose_off                #> [31] verbose_on                 #> see '?methods' for accessing help and source code plot(model_sir) head(get_hist_total(model_sir)) #>   date       state counts #> 1    0 Susceptible  49995 #> 2    0    Infected      5 #> 3    0   Recovered      0 #> 4    1 Susceptible  49987 #> 5    1    Infected     13 #> 6    1   Recovered      0 repnum <- get_reproductive_number(model_sir) head(repnum) #>   virus_id    virus source source_exposure_date rt #> 1        0 COVID-19  34927                   48  0 #> 2        0 COVID-19   2868                   45  0 #> 3        0 COVID-19   6747                   42  0 #> 4        0 COVID-19  35511                   41  0 #> 5        0 COVID-19   3593                   41  0 #> 6        0 COVID-19  41396                   40  0 x <- plot(repnum, type = \"b\") subset(x, date == 10) # Reproductive number on day 10 #>    virus_id    virus date      avg   n       sd lb ub #> 11        0 COVID-19   10 2.366379 696 2.096099  0  7 plot_incidence(model_sir)"},{"path":"/articles/getting-started.html","id":"adding-more-virusesviruses","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Adding more viruses/viruses","title":"Getting started with epiworldR","text":"epiworldR supports multi-virus models. code gives instructions implement . Using virus function, give name new virus/virus corresponding probability infecting given agent. example, prob_infecting set 1.0, making highly contagious. officially add new virus model, use add_virus function calling original epiworldR model object, new virus, new virus’ prevalence (set 0.01 example). running updated model new virus included 50 days, output describes simulation. confirm flu included, notice presence “Flu” Virus(es) section output. output interpretable specified previous sections. Plotting previous model (including flu) yields following. Notice presence two reproductive numbers plotted time. Variant 0 refers COVID-19, virus 1 refers flu.","code":"# Building the virus flu <- virus(   name = \"Flu\", prob_infecting = .3,   prevalence = .0001, as_proportion = TRUE )  # Adding the virus to the model add_virus(model_sir, flu) run(model_sir, ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. model_sir #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 50000 agents, 2 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 3227 Susceptible, 3 Infected, and 46770 Recovered. repnum2 <- get_reproductive_number(model_sir)  op <- par(mfrow = c(2, 1)) plot(model_sir) plot(repnum2, type = \"b\") par(op)"},{"path":"/articles/getting-started.html","id":"tools","dir":"Articles","previous_headings":"Example 1: Simulating an SIR model","what":"Tools","title":"Getting started with epiworldR","text":"Now, implementation tools combat viruses viruses model demonstrated. First, sake simplicity, remove flu virus SIR model object (keep mind index flu virus model object 1). Next, provide parameters new tool using tool function. parameters include name tool, reduction probabilities SIR model parameters, increased probability recovery option. order add tool SIR model, use add_tool function SIR model object, new tool, prevalence tool. example, assume 85% population received vaccination.","code":"# Removing the flu virus from the model rm_virus(model_sir, 1)  vaccine <- tool(   name = \"Vaccine\",   prevalence = 0.5,   as_proportion = TRUE,   susceptibility_reduction = .9,   transmission_reduction = .5,   recovery_enhancer = .5,   death_reduction = .9 )  add_tool(model_sir, vaccine) run(model_sir, ndays = 50, seed = 1231) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. repnum3 <- get_reproductive_number(model_sir)  op <- par(mfrow = c(2, 1)) plot_incidence(model_sir) plot(repnum3, type = \"b\") par(op)"},{"path":"/articles/implementation.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Implementation details of epiworldR","text":"following vignette provides detailed information implementation epiworldR. package wrapper C++ package epiworld, framework building agent-based models.1","code":""},{"path":"/articles/implementation.html","id":"general-flow-of-the-models","dir":"Articles","previous_headings":"","what":"General flow of the models","title":"Implementation details of epiworldR","text":"core function epiworldR run() function. function executes model saves results database part underlying C++ object. package implements discrete-time ABM, meaning model executed discrete steps (e.g., days). run() function executes following steps: model reset(), involves: () resetting agents, available, restoring population backup2, (b) resetting database, (c) distributing viruses tools, (d) setting initial state agents. steps fixing current_date = 0. model’s state recorded database, current_date incremented 1. resetting model, start iterative process repeating following steps: state agent updated. States updated according corresponding update_state function. Since model discrete-time, state changes stored promises, meaning agents’ states updated immediately. Instead, state updated end updates. done avoid updating state agent using updated state update state another agent. example, agent ii infects agent jj, agent jj able infect agent ii step. update schedule laid , changes made effective, , instance, individuals became infected update start next step infected state. Global actions executed. also change agents’ states, just like previous step, changes stored promises made effective actions evaluated. model’s state recorded database, current_date incremented 1. model checks whether simulation stop. simulation stop, model stops. Otherwise, model goes back step . steps included epiworld epiworldR network rewiring mutation viruses. implemented future versions epiworldR.","code":""},{"path":[]},{"path":"/articles/implementation.html","id":"transmission-probability","dir":"Articles","previous_headings":"Computing probabilities","what":"Transmission probability","title":"Implementation details of epiworldR","text":"Generally, epiworldR assumes step simulation, susceptible agents can acquire disease one infected agent. probability transmission ii jj given following formula: P(→j|one)=pij×∏k≠(1−pkj)∏k(1−pkj)+∑kpkj×∏l≠k(1−plj) P(\\j| \\mbox{one}) = \\frac{p_{ij} \\times \\prod_{k\\neq }\\left(1 - p_{kj}\\right)}{\\prod_k\\left(1 - p_{kj}\\right) + \\sum_k p_{kj} \\times \\prod_{l\\neq k}\\left(1 - p_{lj}\\right)} adjusted probabilities pijp_{ij} computed function ii, jj, virus. following section describes probabilities computed.","code":""},{"path":"/articles/implementation.html","id":"adjusted-probabilities","dir":"Articles","previous_headings":"Computing probabilities","what":"Adjusted probabilities","title":"Implementation details of epiworldR","text":"Viruses tools provide way adjust agents move states. Viruses epiworldR contain various baseline probabilities used across models, including transmission, recovery, death. hand, tools alter probabilities reducing/increasing . Furthermore, tools alter agents’ susceptibility, infectiousness, recovery, death probabilities. Currently, tools alter probabilities constant factor, pij=pv×(1−factorhost)×(1−factortarget) p_{ij} = p_{v} \\times \\left(1 - factor_{host}\\right) \\times \\left(1 - factor_{target}\\right) pvp_{v} raw transmission probability virus vv, factortfactor_{t} increasing/reducing factors tools process. example, p_v 0.9, host wearing mask, factormask host=0.3factor_{\\mbox{mask host}} = 0.3 target vaccinated, factorvaccinated target=0.5factor_{\\mbox{vaccinated target}} = 0.5, adjusted probability pijp_{ij} 0.9×(1−0.3)×(1−0.5)=0.270.9 \\times (1 - 0.3) \\times (1 - 0.5) = 0.27. agents one tool, factors combined follows: factoragent=1−∏t∈toolsagent(1−factort) factor_{agent} = 1 - \\prod_{t\\tools_{agent}}\\left(1 - factor_{t}\\right) Therefore, example, vaccinated agent wearing mask factor 1−(1−0.30)×(1−0.5)=0.651 - (1 - 0.30) \\times (1 - 0.5) = 0.65. adjusted probabilities principle also applies recovery rates SIR SEIR models.","code":""},{"path":"/articles/implementation.html","id":"transmission-in-connected-modelsmodels","dir":"Articles","previous_headings":"Computing probabilities","what":"Transmission in connected models3","title":"Implementation details of epiworldR","text":"“connected” models provide version agents live fully connected network. means agent can infect agent, making version similar typical compartmental models. models, transmission probability depends contact rate. susceptible agent, transmission process simulated follows: number contacts cc drawn binomial distribution parameters nn pp, nn number agents p=p =contact_rate/n/ n. , cc agents randomly selected population. Transmission can occur agents susceptible agent. probability transmission cc agents calculated described previous section.","code":""},{"path":"/articles/mixing.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Mixing models","text":"vignette shows create mixing model using epiworldR package. Mixing models feature multiple populations. group, called Entities, subset agents. agents can interact within group agents groups. contact matrix defines interaction agents.","code":""},{"path":"/articles/mixing.html","id":"an-seir-model-with-mixing","dir":"Articles","previous_headings":"","what":"An SEIR model with mixing","title":"Mixing models","text":"example, simulate outbreak featuring three populations. contact matrix defined follows: [0.90.050.050.10.80.10.10.20.7] \\left[% \\begin{array}{ccc} 0.9 & 0.05 & 0.05 \\\\ 0.1 & 0.8 & 0.1 \\\\ 0.1 & 0.2 & 0.7 \\\\ \\end{array}% \\right] matrix represents probability agent population ii interacting agent population jj. matrix row-stochastic, meaning sum row equal 1. build model using entity class epiworld. following code chunk instantiates three entities contact matrix. hand, can proceed create mixing model. following code chunk creates model, SEIR mixing, adds entities model: function add_entity adds corresponding entity. default behavior randomly assigns agents entities beginning simulation. Agents may assigned one entity. following code-chunk simulates model 100 days, summarizes results, plots incidence curve:","code":"library(epiworldR)  e1 <- entity(\"Population 1\", 3e3, as_proportion = FALSE) e2 <- entity(\"Population 2\", 3e3, as_proportion = FALSE) e3 <- entity(\"Population 3\", 3e3, as_proportion = FALSE)  # Row-stochastic matrix (rowsums 1) cmatrix <- c(   c(0.9, 0.05, 0.05),   c(0.1, 0.8, 0.1),   c(0.1, 0.2, 0.7) ) |> matrix(byrow = TRUE, nrow = 3) N <- 9e3  flu_model <- ModelSEIRMixing(   name              = \"Flu\",   n                 = N,   prevalence        = 1 / N,   contact_rate      = 20,   transmission_rate = 0.1,   recovery_rate     = 1 / 7,   incubation_days   = 7,   contact_matrix    = cmatrix )  # Adding the entities flu_model |>   add_entity(e1) |>   add_entity(e2) |>   add_entity(e3) set.seed(331) run(flu_model, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(flu_model) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Exposed-Infected-Removed (SEIR) with Mixing #> Population size     : 9000 #> Agents' data        : (none) #> Number of entities  : 3 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 126.00ms #> Last run speed      : 7.11 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - Flu #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Avg. Incubation days : 7.0000 #>  - Contact rate         : 20.0000 #>  - Prob. Recovery       : 0.1429 #>  - Prob. Transmission   : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible : 8999 -> 137 #>   - (1) Exposed     :    1 -> 35 #>   - (2) Infected    :    0 -> 139 #>   - (3) Recovered   :    0 -> 8689 #>  #> Transition Probabilities: #>  - Susceptible  0.96  0.04  0.00  0.00 #>  - Exposed      0.00  0.84  0.16  0.00 #>  - Infected     0.00  0.00  0.86  0.14 #>  - Recovered    0.00  0.00  0.00  1.00 plot_incidence(flu_model)"},{"path":"/articles/mixing.html","id":"investigating-the-history","dir":"Articles","previous_headings":"","what":"Investigating the history","title":"Mixing models","text":"running simulation, possible question : many agents entity infected day? following code chunk retrieves agents entity transmissions occurred simulation: can retrieve daily incidence entity merging transmissions agents’ entities. following code chunk accomplishes : information, can now visualize daily incidence entity. following code chunk plots daily incidence entity:","code":"library(data.table)  agents_entities <- lapply(get_entities(flu_model), \\(e) {   entity_get_agents(e) }) |> rbindlist()  head(agents_entities) #>    agent entity #>    <int>  <int> #> 1:   507      0 #> 2:  1710      0 #> 3:  8984      0 #> 4:  7844      0 #> 5:   760      0 #> 6:  4379      0 # Retrieving the transmissions transmissions <- get_transmissions(flu_model) |>   data.table()  # We only need the date and the source transmissions <- subset(   transmissions,   select = c(\"date\", \"source\") )  # Attaching the entity to the source transmissions <- merge(   transmissions,   agents_entities,   by.x = \"source\", by.y = \"agent\" )  # Aggregating by date x entity (counts) transmissions <- transmissions[, .N, by = .(date, entity)]  # Taking a look at the data head(transmissions) #>     date entity     N #>    <int>  <int> <int> #> 1:    75      1    12 #> 2:    47      0   114 #> 3:    51      0   133 #> 4:    52      0   152 #> 5:    47      2    74 #> 6:    48      2    87 setorder(transmissions, date, entity)  ran <- range(transmissions$N) transmissions[entity == 0, plot(   x = date, y = N, type = \"l\", col = \"black\", ylim = ran)] #> NULL transmissions[entity == 1, lines(x = date, y = N, col = \"red\")] #> NULL transmissions[entity == 2, lines(x = date, y = N, col = \"blue\")] #> NULL  legend(   \"topright\",   legend = c(\"Population 1\", \"Population 2\", \"Population 3\"),   col = c(\"black\", \"red\", \"blue\"),   lty = 1 )"},{"path":"/articles/run-multiple.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Run Multiple","text":"purpose “run_multiple” function run specified number simulations using model object. , function makes possible compare model results across several separate repeated simulations.","code":""},{"path":[]},{"path":"/articles/run-multiple.html","id":"setup-and-running-model","dir":"Articles","previous_headings":"Example: Simulating a SEIRCONN Model 50 Times","what":"Setup and Running Model","title":"Run Multiple","text":"use “run_multiple” function epiworld, create epimodel choice; case, example uses SEIRCONN model COVID-19, 100000 people, initial prevalence 0.0001 (0.01%), contact rate 2, probability transmission 0.5, total 7 incubation days, probability recovery 13\\frac{1}{3}.","code":"library(epiworldR) model_seirconn <- ModelSEIRCONN(   name              = \"COVID-19\",   n                 = 10000,   prevalence        = 0.0001,   contact_rate      = 2,   transmission_rate = 0.5,   incubation_days   = 7,   recovery_rate     = 1 / 3 )"},{"path":"/articles/run-multiple.html","id":"generating-a-saver","dir":"Articles","previous_headings":"Example: Simulating a SEIRCONN Model 50 Times","what":"Generating a Saver","title":"Run Multiple","text":"Next, generate saver purpose extracting “total_hist” “reproductive” information model object. Now, use “run_multiple” function model object, number desired days run simulation, number simulations run, number threads parallel computing. Using “run_multiple_get_results” function, extract results model object simulated 50 times comparison across simulations.","code":"# Generating a saver saver <- make_saver(\"total_hist\", \"reproductive\") # Running and printing run_multiple(model_seirconn, ndays = 50, nsims = 50, saver = saver, nthreads = 2) #> Starting multiple runs (50) using 2 thread(s) #> _________________________________________________________________________ #> _________________________________________________________________________ #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. # Retrieving the results ans <- run_multiple_get_results(model_seirconn) head(ans$total_hist) #>   sim_num date nviruses       state counts #> 1       1    0        1 Susceptible   9999 #> 2       1    0        1     Exposed      1 #> 3       1    0        1    Infected      0 #> 4       1    0        1   Recovered      0 #> 5       1    1        1 Susceptible   9999 #> 6       1    1        1     Exposed      1 head(ans$reproductive) #>   sim_num virus_id    virus source source_exposure_date rt #> 1       2        0 COVID-19   9315                   50  0 #> 2       2        0 COVID-19   9075                   50  0 #> 3       2        0 COVID-19   8775                   50  0 #> 4       2        0 COVID-19   8745                   50  0 #> 5       2        0 COVID-19   8742                   50  0 #> 6       2        0 COVID-19   8325                   50  0"},{"path":"/articles/run-multiple.html","id":"plotting","dir":"Articles","previous_headings":"Example: Simulating a SEIRCONN Model 50 Times","what":"Plotting","title":"Run Multiple","text":"plot epicurves reproductive numbers time using boxplots, extract results model object using “run_multiple_get_results”. example, dates filtered less equal 20 observe epicurves first 20 days. Notice boxplot table represents observed values 50 simulations date.  view plot reproductive number 50 days 50 simulations, store reproductive results new object using “run_multiple_get_results”, plot using “boxplot” function. Notice source exposure date displays boxplot representing distribution reproductive numbers across 50 simulations. expected, reproductive number average, decreases time.","code":"seirconn_50 <- run_multiple_get_results(model_seirconn)$total_hist seirconn_50 <- seirconn_50[seirconn_50$date <= 20, ] plot(seirconn_50) seirconn_50_r <- run_multiple_get_results(model_seirconn)$reproductive plot(seirconn_50_r) # boxplot(rt ~ source_exposure_date, data = seirconn_50_r, #         main = \"Reproductive Number\", #         xlab = \"Source Exposure Date\", #         ylab = \"rt\", #         border = \"black\", #         las = 2)"},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"George Vega Yon. Author, maintainer. Derek Meyer. Author. Susan Holmes. Reviewer.            JOSS reviewer Abinash Satapathy. Reviewer.            JOSS reviewer Carinogurjao. Reviewer. Centers Disease Control Prevention. Funder.           Award number 1U01CK000585; 75D30121F00003","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Meyer, Derek Vega Yon, George (2023). epiworldR: Fast Agent-Based Epi Models. Journal Open Source Software, 8(90), 5781, https://doi.org/10.21105/joss.05781 Meyer D, Vega Yon G (????). epiworldR: Fast Agent-Based Epi Models. R package version 0.3-2, https://github.com/UofUEpiBio/epiworldR.","code":"@Article{,   entry = {Article},   title = {epiworldR: Fast Agent-Based Epi Models},   author = {Derek Meyer and George {Vega Yon}},   journal = {The Journal of Open Source Software},   year = {2023},   month = {oct},   volume = {8},   number = {90},   doi = {10.21105/joss.05781},   url = {https://joss.theoj.org/papers/10.21105/joss.05781}, } @Manual{,   title = {{{epiworldR: Fast Agent-Based Epi Models}}},   author = {Derek Meyer and George {Vega Yon}},   note = {R package version 0.3-2},   url = {https://github.com/UofUEpiBio/epiworldR}, }"},{"path":"/index.html","id":"epiworldr","dir":"","previous_headings":"","what":"Fast Agent-Based Epi Models","title":"Fast Agent-Based Epi Models","text":"R package wrapper C++ library epiworld. provides general framework modeling disease transmission using agent-based models. main features include: Fast simulation average 30 million agents/day per second. One model can include multiple diseases. Policies (tools) can multiple user-defined. Transmission can function agents’ features. ---box parallelization multiple simulations. package’s description: flexible framework Agent-Based Models (ABM), epiworldR package provides methods prototyping disease outbreaks transmission models using C++ backend, making fast. supports multiple epidemiological models, including Susceptible-Infected-Susceptible (SIS), Susceptible-Infected-Removed (SIR), Susceptible-Exposed-Infected-Removed (SEIR), others, involving arbitrary mitigation policies multiple-disease models. Users can specify infectiousness/susceptibility rates function agents’ features, providing great complexity model dynamics. Furthermore, epiworldR ideal simulation studies featuring large populations. Current available models: ModelDiffNet ModelSEIR ModelSEIRCONN ModelSEIRD ModelSEIRDCONN ModelSEIRMixing ModelSIR ModelSIRCONN ModelSIRD ModelSIRDCONN ModelSIRLogit ModelSIRMixing ModelSIS ModelSISD ModelSURV","code":""},{"path":"/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Fast Agent-Based Epi Models","text":"can install development version epiworldR GitHub : CRAN","code":"devtools::install_github(\"UofUEpiBio/epiworldR\") install.packages(\"epiworldR\")"},{"path":"/index.html","id":"examples","dir":"","previous_headings":"","what":"Examples","title":"Fast Agent-Based Epi Models","text":"R package includes several popular epidemiological models, including SIS, SIR, SEIR using either fully connected graph (similar compartmental model) user-defined network.","code":""},{"path":"/index.html","id":"sir-model-using-a-random-graph","dir":"","previous_headings":"","what":"SIR model using a random graph","title":"Fast Agent-Based Epi Models","text":"Susceptible-Infected-Recovered model features population 100,000 agents simulated small-world network. agent connected ten agents. One percent population virus, 70% chance transmission. Infected individuals recover 0.3 rate: Visualizing outputs","code":"library(epiworldR)  # Creating a SIR model sir <- ModelSIR(   name              = \"COVID-19\",   prevalence        = .01,   transmission_rate = .7,   recovery          = .3 ) |>   # Adding a Small world population   agents_smallworld(n = 100000, k = 10, d = FALSE, p = .01) |>   # Running the model for 50 days   run(ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. sir #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered (SIR) #> It features 100000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 822 Susceptible, 415 Infected, and 98763 Recovered. summary(sir) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #> #> Name of the model   : Susceptible-Infected-Recovered (SIR) #> Population size     : 100000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 50 (of 50) #> Number of viruses   : 1 #> Last run elapsed t  : 62.00ms #> Last run speed      : 79.47 million agents x day / second #> Rewiring            : off #> #> Global events: #>  (none) #> #> Virus(es): #>  - COVID-19 #> #> Tool(s): #>  (none) #> #> Model parameters: #>  - Recovery rate     : 0.3000 #>  - Transmission rate : 0.7000 #> #> Distribution of the population at time 50: #>   - (0) Susceptible :  99000 -> 822 #>   - (1) Infected    :   1000 -> 415 #>   - (2) Recovered   :      0 -> 98763 #> #> Transition Probabilities: #>  - Susceptible  0.91  0.09  0.00 #>  - Infected     0.00  0.70  0.30 #>  - Recovered    0.00  0.00  1.00 plot(sir) plot_incidence(sir)"},{"path":"/index.html","id":"seir-model-with-a-fully-connected-graph","dir":"","previous_headings":"","what":"SEIR model with a fully connected graph","title":"Fast Agent-Based Epi Models","text":"SEIR model similar SIR model includes exposed state. , simulate population 10,000 agents 0.01 prevalence, 0.6 transmission rate, 0.5 recovery rate, 7 days-incubation period. population fully connected, meaning agents can transmit disease agent: Computing key statistics","code":"model_seirconn <- ModelSEIRCONN(   name                = \"COVID-19\",   prevalence          = 0.01,   n                   = 10000,   contact_rate        = 10,   incubation_days     = 7,   transmission_rate   = 0.1,   recovery_rate       = 1 / 7 ) |> add_virus(   virus(     name = \"COVID-19\",     prevalence = 0.01,     as_proportion = TRUE,     prob_infecting = 0.01,     recovery_rate = 0.6,     prob_death = 0.5,     incubation = 7 ))  set.seed(132) run(model_seirconn, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(model_seirconn) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #> #> Name of the model   : Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> Population size     : 10000 #> Agents' data        : (none) #> Number of entities  : 0 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 2 #> Last run elapsed t  : 15.00ms #> Last run speed      : 64.01 million agents x day / second #> Rewiring            : off #> #> Global events: #>  - Update infected individuals (runs daily) #> #> Virus(es): #>  - COVID-19 #>  - COVID-19 #> #> Tool(s): #>  (none) #> #> Model parameters: #>  - Avg. Incubation days : 7.0000 #>  - Contact rate         : 10.0000 #>  - Prob. Recovery       : 0.1429 #>  - Prob. Transmission   : 0.1000 #> #> Distribution of the population at time 100: #>   - (0) Susceptible :  9800 -> 11 #>   - (1) Exposed     :   200 -> 0 #>   - (2) Infected    :     0 -> 3 #>   - (3) Recovered   :     0 -> 9986 #> #> Transition Probabilities: #>  - Susceptible  0.94  0.06  0.00  0.00 #>  - Exposed      0.00  0.85  0.15  0.00 #>  - Infected     0.00  0.00  0.86  0.14 #>  - Recovered    0.00  0.00  0.00  1.00 plot(model_seirconn) repnum <- get_reproductive_number(model_seirconn)  head(plot(repnum)) #>   virus_id    virus date      avg  n       sd    lb     ub #> 1        0 COVID-19    0 5.769231 91 5.455022 1.000 20.750 #> 2        0 COVID-19    2 6.400000 10 4.880801 0.450 14.875 #> 3        0 COVID-19    3 5.166667 18 4.422536 0.425 13.000 #> 4        0 COVID-19    4 4.659091 44 3.784566 0.000 12.850 #> 5        0 COVID-19    5 5.205882 34 3.273210 0.000 12.175 #> 6        0 COVID-19    6 3.137255 51 2.713077 0.000  8.750 head(plot_generation_time(model_seirconn)) #>   date      avg  n       sd ci_lower ci_upper    virus virus_id #> 1    2 4.444444  9 2.185813      2.2    8.000 COVID-19        0 #> 2    3 7.411765 17 3.922034      2.4   15.000 COVID-19        0 #> 3    4 8.538462 39 7.100208      2.0   22.000 COVID-19        0 #> 4    5 6.312500 32 3.905641      2.0   13.225 COVID-19        0 #> 5    6 7.200000 40 4.052223      2.0   15.100 COVID-19        0 #> 6    7 7.660000 50 4.461216      2.0   17.000 COVID-19        0"},{"path":"/index.html","id":"sir-logit","dir":"","previous_headings":"","what":"SIR Logit","title":"Fast Agent-Based Epi Models","text":"model provides complex transmission recovery pattern based agents’ features. , can reflect co-morbidities change probability infection recovery. , simulate population including dataset two features: intercept binary variable Female. probability infection recovery functions intercept Female variables. following code simulates population 100,000 agents small-world network. agent connected eight agents. One percent population virus, 80% chance transmission. Infected individuals recover 0.3 rate:","code":"# Simulating a population of 100,000 agents set.seed(2223) n <- 100000  # Agents' features X <- cbind(   Intercept = 1,   Female    = sample.int(2, n, replace = TRUE) - 1 )  coef_infect  <- c(.1, -2, 2) coef_recover <- rnorm(2)  # Creating the model model_logit <- ModelSIRLogit(   \"covid2\",   data = X,   coefs_infect      = coef_infect,   coefs_recover     = coef_recover,   coef_infect_cols  = 1L:ncol(X),   coef_recover_cols = 1L:ncol(X),   prob_infection = .8,   recovery_rate = .3,   prevalence = .01 )  # Adding a small-world population agents_smallworld(model_logit, n, 8, FALSE, .01)  # Running the model run(model_logit, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. plot(model_logit) # Females are supposed to be more likely to become infected rn <- get_reproductive_number(model_logit)  (table(   X[, \"Female\"],   (1:n %in% rn$source) ) |> prop.table())[, 2] #>       0       1 #> 0.12984 0.14201 # Looking into the agents get_agents(model_logit) #> Agents from the model \"Susceptible-Infected-Removed (SIR) (logit)\": #> Agent: 0, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 1, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 2, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 3, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 4, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 5, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 6, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 7, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 8, state: Susceptible (0), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 9, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> ... 99990 more agents ..."},{"path":"/index.html","id":"transmission-network","dir":"","previous_headings":"","what":"Transmission network","title":"Fast Agent-Based Epi Models","text":"example shows can draw transmission network simulation. following code simulates population 500 agents small-world network. agent connected ten agents. One percent population virus, 50% chance transmission. Infected individuals recover 0.5 rate:","code":"# Creating a SIR model sir <- ModelSIR(   name           = \"COVID-19\",   prevalence     = .01,   transmission_rate = .5,   recovery       = .5 ) |>   # Adding a Small world population   agents_smallworld(n = 500, k = 10, d = FALSE, p = .01) |>   # Running the model for 50 days   run(ndays = 50, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. # Transmission network net <- get_transmissions(sir)  # Plotting library(epiworldR) library(netplot) #> Loading required package: grid x <- igraph::graph_from_edgelist(   as.matrix(net[, 2:3]) + 1 )  nplot(x, edge.curvature = 0, edge.color = \"gray\", skip.vertex = TRUE)"},{"path":"/index.html","id":"multiple-simulations","dir":"","previous_headings":"","what":"Multiple simulations","title":"Fast Agent-Based Epi Models","text":"epiworldR supports running multiple simulations using run_multiple function. following code simulates 50 SIR models 1000 agents . agent connected ten agents. One percent population virus, 90% chance transmission. Infected individuals recover 0.1 rate. results saved data.frame:","code":"model_sir <- ModelSIRCONN(   name = \"COVID-19\",   prevalence = 0.01,   n = 1000,   contact_rate = 2,   transmission_rate = 0.9, recovery_rate = 0.1 )  # Generating a saver saver <- make_saver(\"total_hist\", \"reproductive\")  # Running and printing # Notice the use of nthread = 2 to run the simulations in parallel run_multiple(model_sir, ndays = 100, nsims = 50, saver = saver, nthread = 2) #> Starting multiple runs (50) #> _________________________________________________________________________ #> _________________________________________________________________________ #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. # Retrieving the results ans <- run_multiple_get_results(model_sir)  head(ans$total_hist) #>   sim_num date nviruses       state counts #> 1       1    0        1 Susceptible    990 #> 2       1    0        1    Infected     10 #> 3       1    0        1   Recovered      0 #> 4       1    1        1 Susceptible    971 #> 5       1    1        1    Infected     29 #> 6       1    1        1   Recovered      0 head(ans$reproductive) #>   sim_num virus_id    virus source source_exposure_date rt #> 1       1        0 COVID-19    943                    9  0 #> 2       1        0 COVID-19     40                    9  0 #> 3       1        0 COVID-19      6                    9  0 #> 4       1        0 COVID-19    973                    8  0 #> 5       1        0 COVID-19    495                    9  0 #> 6       1        0 COVID-19    480                    8  0 plot(ans$reproductive)"},{"path":"/index.html","id":"tutorials","dir":"","previous_headings":"","what":"Tutorials","title":"Fast Agent-Based Epi Models","text":"virtual INSNA Sunbelt 2023 session can found : https://github.com/UofUEpiBio/epiworldR-workshop/tree/sunbelt2023-virtual -person INSNA Sunbelt 2023 session can found : https://github.com/UofUEpiBio/epiworldR-workshop/tree/sunbetl2023-inperson","code":""},{"path":"/index.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Fast Agent-Based Epi Models","text":"use epiworldR research, please cite follows:","code":"citation(\"epiworldR\") #> To cite epiworldR in publications use: #> #>   Meyer, Derek and Vega Yon, George (2023). epiworldR: Fast Agent-Based #>   Epi Models. Journal of Open Source Software, 8(90), 5781, #>   https://doi.org/10.21105/joss.05781 #> #> And the actual R package: #> #>   Meyer D, Vega Yon G (????). _epiworldR: Fast Agent-Based Epi Models_. #>   R package version 0.3-2, <https://github.com/UofUEpiBio/epiworldR>. #> #> To see these entries in BibTeX format, use 'print(<citation>, #> bibtex=TRUE)', 'toBibtex(.)', or set #> 'options(citation.bibtex.max=999)'."},{"path":"/index.html","id":"existing-alternatives","dir":"","previous_headings":"","what":"Existing Alternatives","title":"Fast Agent-Based Epi Models","text":"Several alternatives epiworldR exist provide researchers range options, unique features strengths, enabling exploration analysis infectious disease dynamics agent-based modeling. manually curated table existing alternatives, including ABM [@ABM], abmR [@abmR], cystiSim [@cystiSim], villager [@villager], RNetLogo [@RNetLogo].","code":""},{"path":"/index.html","id":"other-abm-r-packages","dir":"","previous_headings":"","what":"Other ABM R packages","title":"Fast Agent-Based Epi Models","text":"may want check R packages agent-based modeling: ABM, abmR, cystiSim, villager, RNetLogo.","code":""},{"path":"/index.html","id":"code-of-conduct","dir":"","previous_headings":"","what":"Code of Conduct","title":"Fast Agent-Based Epi Models","text":"epiworldR project released Contributor Code Conduct. contributing project, agree abide terms.","code":""},{"path":"/paper.html","id":null,"dir":"","previous_headings":"","what":"Introduction","title":"Introduction","text":"Agent-based modeling (ABM) emerged powerful computational approach studying complex systems across various fields, including social sciences epidemiology. simulating interactions behaviors individual entities, known agents, ABM provides unique lens researchers can analyze understand emergent properties dynamics systems. epiworldR package provides flexible framework ABM implementation methods prototyping disease outbreaks transmission models using C++ backend. supports multiple epidemiological models, including Susceptible-Infected-Susceptible (SIS), Susceptible-Infected-Removed (SIR), Susceptible-Exposed-Infected-Removed (SEIR), others, involving arbitrary mitigation policies multiple-disease models. Users can specify transmission/susceptibility rates function agents’ features, providing great complexity model dynamics.","code":""},{"path":"/paper.html","id":"key-features","dir":"","previous_headings":"","what":"Key Features","title":"Introduction","text":"Built robust foundation C++, package combines efficient computation flexibility R, providing seamless user experience several standout features: Multiple Viruses - feature allows researchers simulate analyze dynamics various infectious diseases simultaneously. Multiple Tools - capability enables users design model objects may reflect real-world interventions. Examples include vaccines, mask wearing protocols, social distancing, much . Multiple Runs - epiworldR ability run simulations multiple times, providing complete picture simulation results behaviors. Global Actions - Similar adding multiple tools, global actions allow users implement interventions policies global scale point simulation, mimicking real-world scenarios aiding assessment impact. Built-Epidemiological Models - feature ensures researchers access well-established widely recognized frameworks, making easier compare benchmark results. Included popular epidemiological models : SIR, SIS, SEIR, SIR connected, SIS connected, SEIR connected, . extensive range features, epiworldR empowers researchers practitioners field epidemiology conduct thorough analyses, make informed decisions, contribute advancement public health.","code":""},{"path":"/paper.html","id":"existing-alternatives","dir":"","previous_headings":"","what":"Existing Alternatives","title":"Introduction","text":"Several alternatives epiworldR exist provide researchers range options, unique features strengths, enabling exploration analysis infectious disease dynamics agent-based modeling. manually curated table existing alternatives including ABM [@ABM], abmR [@abmR], cystiSim [@cystiSim], villager [@villager], RNetLogo [@RNetLogo].","code":""},{"path":"/paper.html","id":"statement-of-need","dir":"","previous_headings":"","what":"Statement of Need","title":"Introduction","text":"epiworldR package addresses need sophisticated epidemiological research offering user-friendly agent-based modeling (ABM) tool simulating analyzing infectious disease dynamics. caters diverse audience researchers, epidemiologists, public health practitioners, social scientists, policymakers, enabling study complex disease spread patterns, evaluate intervention strategies, prepare emerging pathogens. Unlike traditional epidemiological models, epiworldR’s ABM approach captures individual-level behaviors interactions, providing realistic representation disease dynamics. distinction sets apart compartmental models ABM frameworks, making epiworldR valuable accessible tool advancing infectious disease modeling enhancing outbreak preparedness.","code":""},{"path":"/paper.html","id":"conclusion","dir":"","previous_headings":"","what":"Conclusion","title":"Introduction","text":"development epiworldR package ushered new era agent-based modeling field social science epidemiology. harnessing power C++ flexibility R, comprehensive package offers multitude features enhance modeling analysis complex infectious disease dynamics. package’s ability handle multiple viruses tools, diverse set epidemiological models, capability run simulations multiple times, inclusion global actions capability empower researchers explore wide range scenarios make informed decisions regarding public health interventions. epiworldR serves valuable resource social science epidemiological communities, enabling study real-world phenomena, prediction outcomes, policy analysis. field epidemiology continues evolve, epiworldR stands forefront, providing researchers practitioners powerful tool navigate complexities infectious diseases contribute improvement global health outcomes.","code":""},{"path":[]},{"path":"/reference/ModelDiffNet.html","id":null,"dir":"Reference","previous_headings":"","what":"Network Diffusion Model — ModelDiffNet","title":"Network Diffusion Model — ModelDiffNet","text":"network diffusion model simple model assumes probability adoption behavior proportional number adopters network.","code":""},{"path":"/reference/ModelDiffNet.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Network Diffusion Model — ModelDiffNet","text":"","code":"ModelDiffNet(   name,   prevalence,   prob_adopt,   normalize_exposure = TRUE,   data = matrix(nrow = 0, ncol = 0),   data_cols = 1L:ncol(data),   params = vector(\"double\") )  # S3 method for class 'epiworld_diffnet' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelDiffNet.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Network Diffusion Model — ModelDiffNet","text":"name Name model. prevalence Prevalence disease. prob_adopt Probability adoption. normalize_exposure Normalize exposure. data Data. data_cols Data columns. params Parameters. x Object class epiworld_diffnet. main Title plot ... Passed graphics::plot.","code":""},{"path":"/reference/ModelDiffNet.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Network Diffusion Model — ModelDiffNet","text":"object class epiworld_diffnet epiworld_model.","code":""},{"path":"/reference/ModelDiffNet.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Network Diffusion Model — ModelDiffNet","text":"Different common epidemiological models, network diffusion model assumes probability adoption behavior proportional number adopters network. model defined following equations: $$ P(adopt) = \\mbox{Logit}^{-1}(prob\\_adopt + params * data + exposure) $$ exposure number adopters agent's network. Another important difference transmission network necesary useful since adoption model particular neighbor.","code":""},{"path":[]},{"path":"/reference/ModelDiffNet.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Network Diffusion Model — ModelDiffNet","text":"","code":"set.seed(2223) n <- 10000  # Generating synthetic data on a matrix with 2 columns. X <- cbind(  age = sample(1:100, n, replace = TRUE),  female = sample.int(2, n, replace = TRUE) - 1 )  adopt_chatgpt <- ModelDiffNet(   \"ChatGPT\",   prevalence = .01,   prob_adopt = .1,   data       = X,   params     = c(1, 4) )  # Simulating a population from smallworld agents_smallworld(adopt_chatgpt, n, 8, FALSE, .01)  # Running the model for 50 steps run(adopt_chatgpt, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  # Plotting the model plot(adopt_chatgpt)"},{"path":"/reference/ModelSEIR.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"Susceptible Exposed Infected Recovered model (SEIR)","code":""},{"path":"/reference/ModelSEIR.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"","code":"ModelSEIR(name, prevalence, transmission_rate, incubation_days, recovery_rate)  # S3 method for class 'epiworld_seir' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIR.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. x Object class SEIR. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSEIR.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"ModelSEIRfunction returns model class epiworld_model. plot function returns plot SEIR model class epiworld_model.","code":""},{"path":"/reference/ModelSEIR.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) Proportion non-infected agents removed, (2) Proportion exposed agents set infected.","code":""},{"path":[]},{"path":"/reference/ModelSEIR.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Recovered model (SEIR) — ModelSEIR","text":"","code":"model_seir <- ModelSEIR(name = \"COVID-19\", prevalence = 0.01,  transmission_rate = 0.9, recovery_rate = 0.1, incubation_days = 4)  # Adding a small world population agents_smallworld(   model_seir,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_seir, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seir #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 0 Susceptible, 0 Exposed, 7 Infected, and 993 Removed.  plot(model_seir, main = \"SEIR Model\")"},{"path":"/reference/ModelSEIRCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"SEIR connected model implements model agents connected. equivalent compartmental model (wiki).","code":""},{"path":"/reference/ModelSEIRCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"","code":"ModelSEIRCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   incubation_days,   recovery_rate )  # S3 method for class 'epiworld_seirconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"name String. Name virus. n Number individuals population. prevalence Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Probability recovery_rate. x Object class SEIRCONN. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"ModelSEIRCONNfunction returns model class epiworld_model. plot function returns plot SEIRCONN model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSEIRCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Removed model (SEIR connected) — ModelSEIRCONN","text":"","code":"# An example with COVID-19 model_seirconn <- ModelSEIRCONN(   name                = \"COVID-19\",   prevalence          = 0.01,    n                   = 10000,   contact_rate        = 2,    incubation_days     = 7,    transmission_rate   = 0.5,   recovery_rate       = 0.3 )    # Running and printing run(model_seirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 429 Susceptible, 4 Exposed, 3 Infected, and 9564 Recovered.  plot(model_seirconn)   # Adding the flu flu <- virus(\"Flu\", .9, 1/7, prevalence = 0.001, as_proportion = TRUE) add_virus(model_seirconn, flu)  #' # Running and printing run(model_seirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> It features 10000 agents, 2 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 1 Susceptible, 0 Exposed, 1 Infected, and 9998 Recovered.  plot(model_seirconn)"},{"path":"/reference/ModelSEIRD.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD)","code":""},{"path":"/reference/ModelSEIRD.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"","code":"ModelSEIRD(   name,   prevalence,   transmission_rate,   incubation_days,   recovery_rate,   death_rate )  # S3 method for class 'epiworld_seird' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRD.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. death_rate Numeric scalar 0 1. Rate death virus. x Object class SEIRD. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRD.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"ModelSEIRDfunction returns model class epiworld_model. plot function returns plot SEIRD model class epiworld_model.","code":""},{"path":"/reference/ModelSEIRD.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) Proportion exposed agents infected, (2) proportion non-infected agents already removed, (3) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSEIRD.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible-Exposed-Infected-Recovered-Deceased model (SEIRD) — ModelSEIRD","text":"","code":"model_seird <- ModelSEIRD(name = \"COVID-19\", prevalence = 0.01,  transmission_rate = 0.9, recovery_rate = 0.1, incubation_days = 4,  death_rate = 0.01)  # Adding a small world population agents_smallworld(   model_seird,   n = 100000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_seird, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seird #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed-Deceased (SEIRD) #> It features 100000 agents, 1 virus(es), and 0 tool(s). #> The model has 5 states. #> The final distribution is: 1961 Susceptible, 388 Exposed, 1358 Infected, 88223 Removed, and 8070 Deceased.  plot(model_seird, main = \"SEIRD Model\")"},{"path":"/reference/ModelSEIRDCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"SEIRD connected model implements model agents connected. equivalent compartmental model (wiki).","code":""},{"path":"/reference/ModelSEIRDCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"","code":"ModelSEIRDCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   incubation_days,   recovery_rate,   death_rate )  # S3 method for class 'epiworld_seirdconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRDCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"name String. Name virus. n Number individuals population. prevalence Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. incubation_days Numeric scalar greater 0. Average number incubation days. recovery_rate Numeric scalar 0 1. Probability recovery_rate. death_rate Numeric scalar 0 1. Probability death. x Object class SEIRCONN. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRDCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"ModelSEIRDCONNfunction returns model class epiworld_model. plot function returns plot SEIRDCONN model class epiworld_model.","code":""},{"path":"/reference/ModelSEIRDCONN.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) Proportion exposed agents infected, (2) proportion non-infected agents already removed, (3) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSEIRDCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Removed Deceased model (SEIRD connected) — ModelSEIRDCONN","text":"","code":"# An example with COVID-19 model_seirdconn <- ModelSEIRDCONN(   name                = \"COVID-19\",   prevalence          = 0.01,    n                   = 10000,   contact_rate        = 2,    incubation_days     = 7,    transmission_rate   = 0.5,   recovery_rate       = 0.3,   death_rate          = 0.01 )    # Running and printing run(model_seirdconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirdconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed-Deceased (SEIRD) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 5 states. #> The final distribution is: 474 Susceptible, 4 Exposed, 1 Infected, 9330 Removed, and 191 Deceased.  plot(model_seirdconn)   # Adding the flu flu <- virus(   \"Flu\", prob_infecting = .3, recovery_rate = 1/7,   prob_death = 0.001,   prevalence = 0.001, as_proportion = TRUE ) add_virus(model = model_seirdconn, virus = flu)  #' # Running and printing run(model_seirdconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_seirdconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed-Deceased (SEIRD) (connected) #> It features 10000 agents, 2 virus(es), and 0 tool(s). #> The model has 5 states. #> The final distribution is: 398 Susceptible, 6 Exposed, 4 Infected, 9379 Removed, and 213 Deceased.  plot(model_seirdconn)"},{"path":"/reference/ModelSEIRMixing.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"Susceptible Exposed Infected Removed model (SEIR) mixing","code":""},{"path":"/reference/ModelSEIRMixing.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"","code":"ModelSEIRMixing(   name,   n,   prevalence,   contact_rate,   transmission_rate,   incubation_days,   recovery_rate,   contact_matrix )  # S3 method for class 'epiworld_seirmixing' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSEIRMixing.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. incubation_days Numeric scalar. Average number days incubation period. recovery_rate Numeric scalar 0 1. Probability recovery. contact_matrix Matrix contact rates individuals. x Object class SIRCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSEIRMixing.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"ModelSEIRMixingfunction returns model class epiworld_model. plot function returns plot SEIRMixing model class epiworld_model.","code":""},{"path":"/reference/ModelSEIRMixing.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"contact_matrix matrix contact rates entities. matrix size n x n, n number entities. row-stochastic matrix, .e., sum row 1. initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSEIRMixing.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Exposed Infected Removed model (SEIR) with mixing — ModelSEIRMixing","text":"","code":"# Start off creating three entities. # Individuals will be distribured randomly between the three. e1 <- entity(\"Population 1\", 3e3, as_proportion = FALSE) e2 <- entity(\"Population 2\", 3e3, as_proportion = FALSE) e3 <- entity(\"Population 3\", 3e3, as_proportion = FALSE)  # Row-stochastic matrix (rowsums 1) cmatrix <- c(   c(0.9, 0.05, 0.05),   c(0.1, 0.8, 0.1),   c(0.1, 0.2, 0.7) ) |> matrix(byrow = TRUE, nrow = 3)  N <- 9e3  flu_model <- ModelSEIRMixing(   name              = \"Flu\",   n                 = N,   prevalence        = 1 / N,   contact_rate      = 20,   transmission_rate = 0.1,   recovery_rate     = 1 / 7,   incubation_days   = 7,   contact_matrix    = cmatrix )  # Adding the entities to the model flu_model |>   add_entity(e1) |>   add_entity(e2) |>   add_entity(e3)  set.seed(331) run(flu_model, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(flu_model) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Exposed-Infected-Removed (SEIR) with Mixing #> Population size     : 9000 #> Agents' data        : (none) #> Number of entities  : 3 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 128.00ms #> Last run speed      : 7.01 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - Flu #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Avg. Incubation days : 7.0000 #>  - Contact rate         : 20.0000 #>  - Prob. Recovery       : 0.1429 #>  - Prob. Transmission   : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible : 8999 -> 137 #>   - (1) Exposed     :    1 -> 35 #>   - (2) Infected    :    0 -> 139 #>   - (3) Recovered   :    0 -> 8689 #>  #> Transition Probabilities: #>  - Susceptible  0.96  0.04  0.00  0.00 #>  - Exposed      0.00  0.84  0.16  0.00 #>  - Infected     0.00  0.00  0.86  0.14 #>  - Recovered    0.00  0.00  0.00  1.00 #>  plot_incidence(flu_model)"},{"path":"/reference/ModelSIR.html","id":null,"dir":"Reference","previous_headings":"","what":"SIR model — ModelSIR","title":"SIR model — ModelSIR","text":"SIR model","code":""},{"path":"/reference/ModelSIR.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIR model — ModelSIR","text":"","code":"ModelSIR(name, prevalence, transmission_rate, recovery_rate)  # S3 method for class 'epiworld_sir' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIR.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIR model — ModelSIR","text":"name String. Name virus prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. x Object class SIR. main Title plot ... Additional arguments passed graphics::plot.","code":""},{"path":"/reference/ModelSIR.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIR model — ModelSIR","text":"ModelSIR function returns model class epiworld_model. plot function returns plot SIR model class epiworld_model.","code":""},{"path":"/reference/ModelSIR.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"SIR model — ModelSIR","text":"initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSIR.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIR model — ModelSIR","text":"","code":"model_sir <- ModelSIR(name = \"COVID-19\", prevalence = 0.01,                        transmission_rate = 0.9, recovery_rate = 0.1)  # Adding a small world population agents_smallworld(   model_sir,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sir, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sir #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered (SIR) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 0 Susceptible, 9 Infected, and 991 Recovered.  # Plotting plot(model_sir)"},{"path":"/reference/ModelSIRCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"Susceptible Infected Removed model (SIR connected)","code":""},{"path":"/reference/ModelSIRCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"","code":"ModelSIRCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   recovery_rate )  # S3 method for class 'epiworld_sirconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. recovery_rate Numeric scalar 0 1. Probability recovery. x Object class SIRCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSIRCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"ModelSIRCONNfunction returns model class epiworld_model. plot function returns plot SIRCONN model class epiworld_model.","code":""},{"path":"/reference/ModelSIRCONN.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSIRCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Infected Removed model (SIR connected) — ModelSIRCONN","text":"","code":"model_sirconn <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )    # Running and printing run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sirconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 2056 Susceptible, 0 Infected, and 7944 Recovered.  plot(model_sirconn,  main = \"SIRCONN Model\")"},{"path":"/reference/ModelSIRD.html","id":null,"dir":"Reference","previous_headings":"","what":"SIRD model — ModelSIRD","title":"SIRD model — ModelSIRD","text":"SIRD model","code":""},{"path":"/reference/ModelSIRD.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIRD model — ModelSIRD","text":"","code":"ModelSIRD(name, prevalence, transmission_rate, recovery_rate, death_rate)  # S3 method for class 'epiworld_sird' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRD.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIRD model — ModelSIRD","text":"name String. Name virus prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery_rate virus. death_rate Numeric scalar 0 1. Rate death virus. x Object class SIR. main Title plot ... Additional arguments passed graphics::plot.","code":""},{"path":"/reference/ModelSIRD.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIRD model — ModelSIRD","text":"ModelSIRD function returns model class epiworld_model. plot function returns plot SIRD model class epiworld_model.","code":""},{"path":"/reference/ModelSIRD.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"SIRD model — ModelSIRD","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) proportion non-infected agents already removed, (2) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSIRD.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIRD model — ModelSIRD","text":"","code":"model_sird <- ModelSIRD(  name              = \"COVID-19\",  prevalence        = 0.01,   transmission_rate = 0.9,  recovery_rate     = 0.1,  death_rate        = 0.01 )  # Adding a small world population agents_smallworld(   model_sird,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sird, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sird #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered-Deceased (SIRD) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 0 Susceptible, 5 Infected, 912 Recovered, and 83 Deceased.  # Plotting plot(model_sird)"},{"path":"/reference/ModelSIRDCONN.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"Susceptible Infected Removed Deceased model (SIRD connected)","code":""},{"path":"/reference/ModelSIRDCONN.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"","code":"ModelSIRDCONN(   name,   n,   prevalence,   contact_rate,   transmission_rate,   recovery_rate,   death_rate )  # S3 method for class 'epiworld_sirdconn' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRDCONN.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. recovery_rate Numeric scalar 0 1. Probability recovery. death_rate Numeric scalar 0 1. Probability death. x Object class SIRDCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSIRDCONN.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"ModelSIRDCONNfunction returns model class epiworld_model. plot function returns plot SIRDCONN model class epiworld_model.","code":""},{"path":"/reference/ModelSIRDCONN.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"initial_states function allows user set initial state model. user must provide vector proportions indicating following values: (1) proportion non-infected agents already removed, (2) proportion non-ifected agents already deceased.","code":""},{"path":[]},{"path":"/reference/ModelSIRDCONN.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Infected Removed Deceased model (SIRD connected) — ModelSIRDCONN","text":"","code":"model_sirdconn <- ModelSIRDCONN(   name                = \"COVID-19\",   n                   = 100000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.5,   death_rate          = 0.1 )    # Running and printing run(model_sirdconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sirdconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed-Deceased (SIRD) (connected) #> It features 100000 agents, 1 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 3778 Susceptible, 0 Infected, 86521 Recovered, and 9701 Deceased.  plot(model_sirdconn,  main = \"SIRDCONN Model\")"},{"path":"/reference/ModelSIRLogit.html","id":null,"dir":"Reference","previous_headings":"","what":"SIR Logistic model — ModelSIRLogit","title":"SIR Logistic model — ModelSIRLogit","text":"SIR Logistic model","code":""},{"path":"/reference/ModelSIRLogit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIR Logistic model — ModelSIRLogit","text":"","code":"ModelSIRLogit(   vname,   data,   coefs_infect,   coefs_recover,   coef_infect_cols,   coef_recover_cols,   prob_infection,   recovery_rate,   prevalence )"},{"path":"/reference/ModelSIRLogit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIR Logistic model — ModelSIRLogit","text":"vname Name virus. data numeric matrix n rows. coefs_infect Numeric vector. Coefficients associated infect. coefs_recover Numeric vector. Coefficients associated recover. coef_infect_cols Integer vector. Columns coeficient. coef_recover_cols Integer vector. Columns coeficient. prob_infection Numeric scalar. Baseline probability infection. recovery_rate Numeric scalar. Baseline probability recovery. prevalence Numeric scalar. Prevalence (initial state) proportion.","code":""},{"path":"/reference/ModelSIRLogit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIR Logistic model — ModelSIRLogit","text":"ModelSIRLogit function returns model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSIRLogit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIR Logistic model — ModelSIRLogit","text":"","code":"set.seed(2223) n <- 100000  # Creating the data to use for the \"ModelSIRLogit\" function. It contains  # information on the sex of each agent and will be used to determine  # differences in disease progression between males and females. Note that  # the number of rows in these data are identical to n (100000).  X <- cbind(   Intercept = 1,   Female    = sample.int(2, n, replace = TRUE) - 1 )  # Declare coefficients for each sex regarding transmission_rate and recovery. coef_infect  <- c(.1, -2, 2) coef_recover <- rnorm(2)  # Feed all above information into the \"ModelSIRLogit\" function.  model_logit <- ModelSIRLogit(   \"covid2\",   data = X,   coefs_infect      = coef_infect,   coefs_recover     = coef_recover,    coef_infect_cols  = 1L:ncol(X),   coef_recover_cols = 1L:ncol(X),   prob_infection = .8,   recovery_rate = .3,   prevalence = .01 )  agents_smallworld(model_logit, n, 8, FALSE, .01)  run(model_logit, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  plot(model_logit)   # Females are supposed to be more likely to become infected. rn <- get_reproductive_number(model_logit)  # Probability of infection for males and females.  (table(   X[, \"Female\"],   (1:n %in% rn$source) ) |> prop.table())[,2] #>       0       1  #> 0.12984 0.14201   # Looking into the individual agents. get_agents(model_logit) #> Agents from the model \"Susceptible-Infected-Removed (SIR) (logit)\": #> Agent: 0, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 1, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 2, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 3, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 4, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 5, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 6, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 7, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 8, state: Susceptible (0), Has virus: no, NTools: 0i NNeigh: 8 #> Agent: 9, state: Recovered (2), Has virus: no, NTools: 0i NNeigh: 8 #> ... 99990 more agents ..."},{"path":"/reference/ModelSIRMixing.html","id":null,"dir":"Reference","previous_headings":"","what":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"Susceptible Infected Removed model (SIR) mixing","code":""},{"path":"/reference/ModelSIRMixing.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"","code":"ModelSIRMixing(   name,   n,   prevalence,   contact_rate,   transmission_rate,   recovery_rate,   contact_matrix )  # S3 method for class 'epiworld_sirmixing' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIRMixing.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"name String. Name virus n Number individuals population. prevalence Double. Initial proportion individuals virus. contact_rate Numeric scalar. Average number contacts per step. transmission_rate Numeric scalar 0 1. Probability transmission. recovery_rate Numeric scalar 0 1. Probability recovery. contact_matrix Matrix contact rates individuals. x Object class SIRCONN. main Title plot ... Currently ignore.","code":""},{"path":"/reference/ModelSIRMixing.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"ModelSIRMixingfunction returns model class epiworld_model. plot function returns plot SIRMixing model class epiworld_model.","code":""},{"path":"/reference/ModelSIRMixing.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"contact_matrix matrix contact rates entities. matrix size n x n, n number entities. row-stochastic matrix, .e., sum row 1. initial_states function allows user set initial state model. particular, user can specify many non-infected agents removed beginning simulation.","code":""},{"path":[]},{"path":"/reference/ModelSIRMixing.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Susceptible Infected Removed model (SIR) with mixing — ModelSIRMixing","text":"","code":"# From the vignette  # Start off creating three entities. # Individuals will be distribured randomly between the three. e1 <- entity(\"Population 1\", 3e3, as_proportion = FALSE) e2 <- entity(\"Population 2\", 3e3, as_proportion = FALSE) e3 <- entity(\"Population 3\", 3e3, as_proportion = FALSE)  # Row-stochastic matrix (rowsums 1) cmatrix <- c(   c(0.9, 0.05, 0.05),   c(0.1, 0.8, 0.1),   c(0.1, 0.2, 0.7) ) |> matrix(byrow = TRUE, nrow = 3)  N <- 9e3  flu_model <- ModelSIRMixing(   name              = \"Flu\",   n                 = N,   prevalence        = 1 / N,   contact_rate      = 20,   transmission_rate = 0.1,   recovery_rate     = 1 / 7,   contact_matrix    = cmatrix )  # Adding the entities to the model flu_model |>   add_entity(e1) |>   add_entity(e2) |>   add_entity(e3)  set.seed(331) run(flu_model, ndays = 100) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. summary(flu_model) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) with Mixing #> Population size     : 9000 #> Agents' data        : (none) #> Number of entities  : 3 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 67.00ms #> Last run speed      : 13.32 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - Flu #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate       : 20.0000 #>  - Prob. Recovery     : 0.1429 #>  - Prob. Transmission : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible : 8999 -> 134 #>   - (1) Infected    :    1 -> 0 #>   - (2) Recovered   :    0 -> 8866 #>  #> Transition Probabilities: #>  - Susceptible  0.96  0.04  0.00 #>  - Infected     0.00  0.87  0.13 #>  - Recovered    0.00  0.00  1.00 #>  plot_incidence(flu_model)"},{"path":"/reference/ModelSIS.html","id":null,"dir":"Reference","previous_headings":"","what":"SIS model — ModelSIS","title":"SIS model — ModelSIS","text":"Susceptible-Infected-Susceptible model (SIS) (wiki)","code":""},{"path":"/reference/ModelSIS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SIS model — ModelSIS","text":"","code":"ModelSIS(name, prevalence, transmission_rate, recovery_rate)  # S3 method for class 'epiworld_sis' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSIS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SIS model — ModelSIS","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery virus. x Object class SIS. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSIS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SIS model — ModelSIS","text":"ModelSIS function returns model class epiworld_model. plot function returns plot SIS model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSIS.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SIS model — ModelSIS","text":"","code":"model_sis <- ModelSIS(name = \"COVID-19\", prevalence = 0.01,                       transmission_rate = 0.9, recovery_rate = 0.1)  # Adding a small world population agents_smallworld(   model_sis,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sis, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sis #> ________________________________________________________________________________ #> Susceptible-Infected-Susceptible (SIS) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 2 states. #> The final distribution is: 100 Susceptible, and 900 Infected.  # Plotting plot(model_sis, main = \"SIS Model\")"},{"path":"/reference/ModelSISD.html","id":null,"dir":"Reference","previous_headings":"","what":"SISD model — ModelSISD","title":"SISD model — ModelSISD","text":"Susceptible-Infected-Susceptible-Deceased model (SISD) (wiki)","code":""},{"path":"/reference/ModelSISD.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SISD model — ModelSISD","text":"","code":"ModelSISD(name, prevalence, transmission_rate, recovery_rate, death_rate)  # S3 method for class 'epiworld_sisd' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSISD.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SISD model — ModelSISD","text":"name String. Name virus. prevalence Double. Initial proportion individuals virus. transmission_rate Numeric scalar 0 1. Virus's rate infection. recovery_rate Numeric scalar 0 1. Rate recovery virus. death_rate Numeric scalar 0 1. Rate death virus. x Object class SISD. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSISD.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SISD model — ModelSISD","text":"ModelSISD function returns model class epiworld_model. plot function returns plot SISD model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSISD.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SISD model — ModelSISD","text":"","code":"model_sisd <- ModelSISD(                name = \"COVID-19\",                 prevalence = 0.01,                 transmission_rate = 0.9,                 recovery_rate = 0.1,                 death_rate = 0.01              )  # Adding a small world population agents_smallworld(   model_sisd,   n = 1000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_sisd, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sisd #> ________________________________________________________________________________ #> Susceptible-Infected-Susceptible-Deceased (SISD) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 89 Susceptible, 457 Infected, and 454 Deceased.  # Plotting plot(model_sisd, main = \"SISD Model\")"},{"path":"/reference/ModelSURV.html","id":null,"dir":"Reference","previous_headings":"","what":"SURV model — ModelSURV","title":"SURV model — ModelSURV","text":"SURV model","code":""},{"path":"/reference/ModelSURV.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"SURV model — ModelSURV","text":"","code":"ModelSURV(   name,   prevalence,   efficacy_vax,   latent_period,   infect_period,   prob_symptoms,   prop_vaccinated,   prop_vax_redux_transm,   prop_vax_redux_infect,   surveillance_prob,   transmission_rate,   prob_death,   prob_noreinfect )  # S3 method for class 'epiworld_surv' plot(x, main = get_name(x), ...)"},{"path":"/reference/ModelSURV.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"SURV model — ModelSURV","text":"name String. Name virus. prevalence Initial number individuals virus. efficacy_vax Double. Efficacy vaccine. (1 - P(acquire disease)). latent_period Double. Shape parameter 'Gamma(latent_period, 1)' distribution. coincides expected number latent days. infect_period Double. Shape parameter 'Gamma(infected_period, 1)' distribution. coincides expected number infectious days. prob_symptoms Double. Probability generating symptoms. prop_vaccinated Double. Probability vaccination. Coincides initial prevalence vaccinated individuals. prop_vax_redux_transm Double. Factor vaccine reduces transmissibility. prop_vax_redux_infect Double. Factor vaccine reduces chances becoming infected. surveillance_prob Double. Probability testing agent. transmission_rate Double. Raw transmission probability. prob_death Double. Raw probability death symptomatic individuals. prob_noreinfect Double. Probability re-infection. x Object class SURV. main Title plot. ... Currently ignore.","code":""},{"path":"/reference/ModelSURV.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"SURV model — ModelSURV","text":"ModelSURVfunction returns model class epiworld_model. plot function returns plot SURV model class epiworld_model.","code":""},{"path":[]},{"path":"/reference/ModelSURV.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"SURV model — ModelSURV","text":"","code":"model_surv <- ModelSURV(   name                  = \"COVID-19\",   prevalence            = 20,   efficacy_vax          = 0.6,   latent_period         = 4,   infect_period         = 5,   prob_symptoms         = 0.5,   prop_vaccinated       = 0.7,   prop_vax_redux_transm = 0.8,   prop_vax_redux_infect = 0.95,   surveillance_prob     = 0.1,   transmission_rate     = 0.2,   prob_death            = 0.001,   prob_noreinfect       = 0.5 )  # Adding a small world population agents_smallworld(   model_surv,   n = 10000,   k = 5,   d = FALSE,   p = .01   )    # Running and printing run(model_surv, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_surv  #> ________________________________________________________________________________ #> Surveillance #> It features 10000 agents, 1 virus(es), and 1 tool(s). #> The model has 8 states. #> The final distribution is: 9978 Susceptible, 0 Latent, 0 Symptomatic, 0 Symptomatic isolated, 0 Asymptomatic, 0 Asymptomatic isolated, 22 Recovered, and 0 Removed.  # Plotting plot(model_surv, main = \"SURV Model\")"},{"path":"/reference/agents.html","id":null,"dir":"Reference","previous_headings":"","what":"Agents in epiworldR — agents","title":"Agents in epiworldR — agents","text":"functions provide read-access agents model. get_agents function returns object class epiworld_agents contains information agents model. get_agent function returns information single agent. get_state function returns state single agent.","code":""},{"path":"/reference/agents.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Agents in epiworldR — agents","text":"","code":"get_agents(model, ...)  # S3 method for class 'epiworld_model' get_agents(model, ...)  # S3 method for class 'epiworld_agents' x[i]  # S3 method for class 'epiworld_agent' print(x, compressed = FALSE, ...)  # S3 method for class 'epiworld_agents' print(x, compressed = TRUE, max_print = 10, ...)  get_state(x)"},{"path":"/reference/agents.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Agents in epiworldR — agents","text":"model object class epiworld_model. ... Ignored x object class epiworld_agents Index (id) agent (0 n-1) compressed Logical scalar. FALSE, prints detailed information agent. max_print Integer scalar. Maximum number agents print.","code":""},{"path":"/reference/agents.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Agents in epiworldR — agents","text":"get_agents function returns object class epiworld_agents. [ method returns object class epiworld_agent. print function returns information individual agent class epiworld_agent. get_state function returns state epiworld_agents object.","code":""},{"path":[]},{"path":"/reference/agents.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Agents in epiworldR — agents","text":"","code":"model_sirconn <- ModelSIRCONN( name                = \"COVID-19\", n                   = 10000, prevalence          = 0.01, contact_rate        = 5, transmission_rate   = 0.4, recovery_rate       = 0.95 )  run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  x <- get_agents(model_sirconn) # Storing all agent information into object of                                 # class epiworld_agents                               print(x, compressed = FALSE, max_print = 5) # Displaying detailed information of  #> Agents from the model \"Susceptible-Infected-Removed (SIR) (connected)\": #> Information about agent id 0 #>   State        : Susceptible (0) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 1 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 2 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 3 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> Information about agent id 4 #>   State        : Recovered (2) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0 #> ... 9995 more agents ...                                         # the first 5 agents using                                          # compressed=F. Using compressed=T                                         # results in less-detailed                                          # information about each agent.                                           x[0] # Print information about the first agent. Substitute the agent of  #> Information about agent id 0 #>   State        : Susceptible (0) #>   Has virus    : no #>   Tool count   : 0 #>   Neigh. count : 0      # interest's position where '0' is."},{"path":"/reference/agents_smallworld.html","id":null,"dir":"Reference","previous_headings":"","what":"Load agents to a model — agents_smallworld","title":"Load agents to a model — agents_smallworld","text":"functions provide access network model. network represented edgelist. agents_smallworld function generates small world network Watts-Strogatz algorithm. agents_from_edgelist function loads network edgelist. get_network function returns edgelist network.","code":""},{"path":"/reference/agents_smallworld.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load agents to a model — agents_smallworld","text":"","code":"agents_smallworld(model, n, k, d, p)  agents_from_edgelist(model, source, target, size, directed)  get_network(model)  get_agents_states(model)  add_virus_agent(agent, model, virus, state_new = -99, queue = -99)  add_tool_agent(agent, model, tool, state_new = -99, queue = -99)  has_virus(agent, virus)  has_tool(agent, tool)  change_state(agent, model, state_new, queue = -99)  get_agents_tools(model)"},{"path":"/reference/agents_smallworld.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load agents to a model — agents_smallworld","text":"model Model object class epiworld_model. n, size Number individuals population. k Number ties small world network. d, directed Logical scalar. Whether graph directed . p Probability rewiring. source, target Integer vectors describing source target edgelist. agent Agent object class epiworld_agent. virus Virus object class epiworld_virus. state_new Integer scalar. New state agent action executed. queue Integer scalar. Change queuing system action executed. tool Tool object class epiworld_tool.","code":""},{"path":"/reference/agents_smallworld.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load agents to a model — agents_smallworld","text":"'agents_smallworld' function returns model agents loaded. agents_from_edgelist function returns empty model class epiworld_model. get_network function returns data frame two columns (source target) describing edgelist network. get_agents_states returns character vector states agents end simulation. function add_virus_agent adds virus agent returns agent invisibly. function add_tool_agent adds tool agent returns agent invisibly. functions has_virus has_tool return logical scalar indicating whether agent virus/tool . get_agents_tools returns list class epiworld_agents_tools epiworld_tools (list lists).","code":""},{"path":"/reference/agents_smallworld.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Load agents to a model — agents_smallworld","text":"new_state queue parameters optional. provided, agent updated default values virus/tool.","code":""},{"path":"/reference/agents_smallworld.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Load agents to a model — agents_smallworld","text":"","code":"# Initializing SIR model with agents_smallworld sir <- ModelSIR(name = \"COVID-19\", prevalence = 0.01, transmission_rate = 0.9,                  recovery_rate = 0.1) agents_smallworld(    sir,    n = 1000,     k = 5,    d = FALSE,    p = .01  ) run(sir, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. sir #> ________________________________________________________________________________ #> Susceptible-Infected-Recovered (SIR) #> It features 1000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 0 Susceptible, 9 Infected, and 991 Recovered.  # We can also retrieve the network net <- get_network(sir) head(net) #>   from  to #> 1    0   1 #> 2    0   2 #> 3    0 998 #> 4    0 999 #> 5    1   2 #> 6    1   3  # Simulating a bernoulli graph set.seed(333) n <- 1000 g <- matrix(runif(n ^ 2) < .01, nrow = n) diag(g) <- FALSE el <- which(g, arr.ind = TRUE) - 1L   # Generating an empty model sir <- ModelSIR(\"COVID-19\", .01, .8, .3) agents_from_edgelist(   sir,   source = el[,1],   target = el[,2],   size   = n,   directed = TRUE )  # Running the simulation run(sir, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  plot(sir)"},{"path":"/reference/entities.html","id":null,"dir":"Reference","previous_headings":"","what":"Get entities — entities","title":"Get entities — entities","text":"Entities epiworld objects can contain agents.","code":""},{"path":"/reference/entities.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get entities — entities","text":"","code":"get_entities(model)  # S3 method for class 'epiworld_entities' x[i]  entity(name, prevalence, as_proportion, to_unassigned = TRUE)  get_entity_size(entity)  get_entity_name(entity)  entity_add_agent(entity, agent, model = attr(entity, \"model\"))  rm_entity(model, id)  add_entity(model, entity)  load_agents_entities_ties(model, agents_id, entities_id)  entity_get_agents(entity)  distribute_entity_randomly(prevalence, as_proportion, to_unassigned = TRUE)  distribute_entity_to_set(agents_ids)  set_distribution_entity(entity, distfun)"},{"path":"/reference/entities.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get entities — entities","text":"model Model object class epiworld_model. x Object class epiworld_entities. Integer index. name Character scalar. Name entity. prevalence Numeric scalar. Prevalence entity. as_proportion Logical scalar. TRUE, prevalence interpreted proportion. to_unassigned Logical scalar. TRUE, entity added unassigned pool. entity Entity object class epiworld_entity. agent Agent object class epiworld_agent. id Integer scalar. Entity id remove (starting zero). agents_id Integer vector. entities_id Integer vector. agents_ids Integer vector. Ids agents distribute. distfun Distribution function object class epiworld_distribution_entity.","code":""},{"path":"/reference/entities.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get entities — entities","text":"function entity creates entity object. function get_entity_size returns number agents entity. function get_entity_name returns name entity. function entity_add_agent adds agent entity. function rm_entity removes entity model. function load_agents_entities_ties loads agents entities. function entity_get_agents returns integer vector agents entity (ids).","code":""},{"path":"/reference/entities.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get entities — entities","text":"Epiworld entities especially useful mixing models, particularly ModelSIRMixing ModelSEIRMixing.","code":""},{"path":"/reference/entities.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get entities — entities","text":"","code":"# Creating a mixing model mymodel <- ModelSIRMixing(  name = \"My model\",  n = 10000,  prevalence = .001,  contact_rate = 10,  transmission_rate = .1,  recovery_rate = 1/7,  contact_matrix = matrix(c(.9, .1, .1, .9), 2, 2) )  ent1 <- entity(\"First\", 5000, FALSE) ent2 <- entity(\"Second\", 5000, FALSE)  mymodel |>   add_entity(ent1) |>   add_entity(ent2)  run(mymodel, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  summary(mymodel) #> ________________________________________________________________________________ #> ________________________________________________________________________________ #> SIMULATION STUDY #>  #> Name of the model   : Susceptible-Infected-Removed (SIR) with Mixing #> Population size     : 10000 #> Agents' data        : (none) #> Number of entities  : 2 #> Days (duration)     : 100 (of 100) #> Number of viruses   : 1 #> Last run elapsed t  : 69.00ms #> Last run speed      : 14.32 million agents x day / second #> Rewiring            : off #>  #> Global events: #>  - Update infected individuals (runs daily) #>  #> Virus(es): #>  - My model #>  #> Tool(s): #>  (none) #>  #> Model parameters: #>  - Contact rate       : 10.0000 #>  - Prob. Recovery     : 0.1429 #>  - Prob. Transmission : 0.1000 #>  #> Distribution of the population at time 100: #>   - (0) Susceptible :  9990 -> 384 #>   - (1) Infected    :    10 -> 0 #>   - (2) Recovered   :     0 -> 9616 #>  #> Transition Probabilities: #>  - Susceptible  0.97  0.03  0.00 #>  - Infected     0.00  0.85  0.15 #>  - Recovered    0.00  0.00  1.00 #>"},{"path":"/reference/epiworld-data.html","id":null,"dir":"Reference","previous_headings":"","what":"Accessing the database of epiworld — epiworld-data","title":"Accessing the database of epiworld — epiworld-data","text":"Models epiworld stored database. database can accessed using functions described manual page. elements database : transition matrix, incidence matrix, reproductive number, generation time, daily incidence virus tool level.","code":""},{"path":"/reference/epiworld-data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Accessing the database of epiworld — epiworld-data","text":"","code":"get_hist_total(x)  get_today_total(x)  get_hist_virus(x)  get_hist_tool(x)  get_transition_probability(x)  get_reproductive_number(x)  # S3 method for class 'epiworld_repnum' plot(   x,   y = NULL,   ylab = \"Average Rep. Number\",   xlab = \"Day (step)\",   main = \"Reproductive Number\",   type = \"b\",   plot = TRUE,   ... )  plot_reproductive_number(x, ...)  get_hist_transition_matrix(x, skip_zeros = FALSE)  # S3 method for class 'epiworld_hist_transition' as.array(x, ...)  plot_incidence(x, ...)  # S3 method for class 'epiworld_hist_transition' plot(   x,   type = \"b\",   xlab = \"Day (step)\",   ylab = \"Counts\",   main = \"Daily incidence\",   plot = TRUE,   ... )  get_transmissions(x)  get_generation_time(x)  # S3 method for class 'epiworld_generation_time' plot(   x,   type = \"b\",   xlab = \"Day (step)\",   ylab = \"Avg. Generation Time\",   main = \"Generation Time\",   plot = TRUE,   ... )  plot_generation_time(x, ...)"},{"path":"/reference/epiworld-data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Accessing the database of epiworld — epiworld-data","text":"x object class epiworld_sir, epiworld_seir, etc. model. y Ignored. ylab, xlab, main, type parameters passed graphics::plot() plot Logical scalar. TRUE (default), function desired statistic. ... case plot methods, arguments passed graphics::plot. skip_zeros Logical scalar. FALSE return entries transition matrix.","code":""},{"path":"/reference/epiworld-data.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Accessing the database of epiworld — epiworld-data","text":"get_hist_total function returns object class epiworld_hist_total. get_today_total function returns named vector total number individuals state end simulation. get_hist_virus function returns object class epiworld_hist_virus. get_hist_tool function returns object epiworld_hist_virus. get_transition_probability function returns object class matrix. get_reproductive_number function returns object class epiworld_repnum. plot function returns plot reproductive number time. get_hist_transition_matrix returns data.frame four columns: \"state_from\", \"state_to\", \"date\", \"counts.\" .array method epiworld_hist_transition objects turns data.frame returned get_hist_transition_matrix array nstates x nstates x (ndays + 1) entries, first entry initial state. plot_incidence function returns plot originating object get_hist_transition_matrix. plot function returns plot originates epiworld_hist_transition object. function get_transmissions returns data.frame following columns: date, source, target, virus_id, virus, source_exposure_date. function get_generation_time returns data.frame following columns: \"agent\", \"virus_id\", \"virus\", \"date\", \"gentime\". function plot_generation_time wrapper plot get_generation_time.","code":""},{"path":"/reference/epiworld-data.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Accessing the database of epiworld — epiworld-data","text":"plot_reproductive_number function wrapper around get_reproductive_number plots result. plot_incidence function wrapper get_hist_transition_matrix plot method. plot method epiworld_hist_transition class plots daily incidence state. function returns data frame used plotting.","code":""},{"path":[]},{"path":"/reference/epiworld-data.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Accessing the database of epiworld — epiworld-data","text":"","code":"# SEIR Connected seirconn <- ModelSEIRCONN(   name              = \"Disease\",   n                 = 10000,   prevalence        = 0.1,   contact_rate      = 2.0,    transmission_rate = 0.8,   incubation_days   = 7.0,   recovery_rate     = 0.3 )  # Running the simulation for 50 steps (days) set.seed(937) run(seirconn, 50) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done.  # Retrieving the transition probability get_transition_probability(seirconn)  #>             Susceptible   Exposed  Infected Recovered #> Susceptible   0.9028099 0.0971901 0.0000000 0.0000000 #> Exposed       0.0000000 0.8584473 0.1415526 0.0000000 #> Infected      0.0000000 0.0000000 0.7000978 0.2999022 #> Recovered     0.0000000 0.0000000 0.0000000 1.0000000  # Retrieving date, state, and counts dataframe including any added tools  get_hist_tool(seirconn) #> [1] date    tool_id tool    state   counts  #> <0 rows> (or 0-length row.names)  # Retrieving overall date, state, and counts dataframe  head(get_hist_total(seirconn)) #>   date       state counts #> 1    0 Susceptible   9000 #> 2    0     Exposed   1000 #> 3    0    Infected      0 #> 4    0   Recovered      0 #> 5    1 Susceptible   9000 #> 6    1     Exposed    861  # Retrieving date, state, and counts dataframe by variant head(get_hist_virus(seirconn)) #>   date virus_id   virus       state counts #> 1    0        0 Disease Susceptible      0 #> 2    0        0 Disease     Exposed   1000 #> 3    0        0 Disease    Infected      0 #> 4    0        0 Disease   Recovered      0 #> 5    1        0 Disease Susceptible      0 #> 6    1        0 Disease     Exposed    861  # Retrieving (and plotting) the reproductive number rp <- get_reproductive_number(seirconn) plot(rp) # Also equivalent to plot_reproductive_number(seirconn)   # We can go further and get all the history t_hist <- get_hist_transition_matrix(seirconn)  head(t_hist) #>    state_from    state_to date counts #> 1 Susceptible Susceptible    0   9000 #> 2     Exposed Susceptible    0      0 #> 3    Infected Susceptible    0      0 #> 4   Recovered Susceptible    0      0 #> 5 Susceptible     Exposed    0   1000 #> 6     Exposed     Exposed    0      0  # And turn it into an array as.array(t_hist)[,,1:3] #> , , 0 #>  #>             Susceptible Exposed Infected Recovered #> Susceptible        9000    1000        0         0 #> Exposed               0       0        0         0 #> Infected              0       0        0         0 #> Recovered             0       0        0         0 #>  #> , , 1 #>  #>             Susceptible Exposed Infected Recovered #> Susceptible        9000       0        0         0 #> Exposed               0     861      139         0 #> Infected              0       0        0         0 #> Recovered             0       0        0         0 #>  #> , , 2 #>  #>             Susceptible Exposed Infected Recovered #> Susceptible        8822     178        0         0 #> Exposed               0     737      124         0 #> Infected              0       0       92        47 #> Recovered             0       0        0         0 #>   # We cam also get (and plot) the incidence, as well as # the generation time inci <- plot_incidence(seirconn)  gent <- plot_generation_time(seirconn)"},{"path":"/reference/epiworld-methods.html","id":null,"dir":"Reference","previous_headings":"","what":"Methods for epiworldR objects — epiworld-methods","title":"Methods for epiworldR objects — epiworld-methods","text":"functions described section methods objects class epiworld_model. Besides printing plotting, methods provide access manipulate model parameters, getting information model running simulation.","code":""},{"path":"/reference/epiworld-methods.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Methods for epiworldR objects — epiworld-methods","text":"","code":"queuing_on(x)  queuing_off(x)  verbose_off(x)  verbose_on(x)  run(model, ndays, seed = sample.int(10000, 1))  # S3 method for class 'epiworld_model' summary(object, ...)  get_states(x)  get_param(x, pname)  set_param(x, pname, pval)  set_name(x, mname)  get_name(x)  get_n_viruses(x)  get_n_tools(x)  get_ndays(x)  get_n_replicates(x)  size(x)  set_agents_data(model, data)  get_agents_data_ncols(model)  get_virus(model, virus_pos)  get_tool(model, tool_pos)  initial_states(model, proportions)  clone_model(model)"},{"path":"/reference/epiworld-methods.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Methods for epiworldR objects — epiworld-methods","text":"x object class epiworld_model. model Model object. ndays Number days (steps) simulation. seed Seed set initializing random number generator. object Object class epiworld_model. ... Additional arguments. pname String. Name parameter. pval Numeric. Value parameter. mname String. Name model. data numeric matrix. virus_pos Integer. Relative location (starting 0) virus model tool_pos Integer. Relative location (starting 0) tool model proportions Numeric vector. Proportions agents distributed (see details).","code":""},{"path":"/reference/epiworld-methods.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Methods for epiworldR objects — epiworld-methods","text":"verbose_on verbose_off functions return model, however verbose_off returns model progress bar. run function returns simulated model class epiworld_model. summary function prints detailed view model, returns model invisibly. get_states function returns unique states found model. get_param function returns selected parameter model object class epiworld_model. set_param function return value instead alters parameter value. set_name function return value instead alters object epiworld_model. get_name returns name model. get_n_viruses returns number viruses model. get_n_tools returns number tools model. get_ndays returns number days model. get_n_replicates returns number replicates model. size.epiworld_model returns number agents model. 'set_agents_data' function returns object class DataFrame. 'get_agents_data_ncols' returns number columns model dataframe. 'get_virus' returns virus. get_tool returns tool. inital_states returns model updated initial state. clone_model returns copy model.","code":""},{"path":"/reference/epiworld-methods.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Methods for epiworldR objects — epiworld-methods","text":"verbose_on verbose_off functions activate deactivate printing progress screen, respectively. functions return model (x) invisibly. epiworld_model objects pointers underlying C++ class epiworld. generate copy model, use clone_model, otherwise, assignment operator copy pointer.","code":""},{"path":"/reference/epiworld-methods.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Methods for epiworldR objects — epiworld-methods","text":"","code":"model_sirconn <- ModelSIRCONN( name                = \"COVID-19\", n                   = 10000, prevalence          = 0.01, contact_rate        = 5, transmission_rate   = 0.4, recovery_rate       = 0.95 )  # Queuing - If you wish to implement the queuing function, declare whether  # you would like it \"on\" or \"off\", if any.  queuing_on(model_sirconn) #> Warning: SIR Connected models do not have queue. queuing_off(model_sirconn) run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # Verbose - \"on\" prints the progress bar on the screen while \"off\"  # deactivates the progress bar. Declare which function you want to implement,  # if any.  verbose_on(model_sirconn) verbose_off(model_sirconn) run(model_sirconn, ndays = 100, seed = 1912)  get_states(model_sirconn) # Returns all unique states found within the model. #> [1] \"Susceptible\" \"Infected\"    \"Recovered\"    get_param(model_sirconn, 'Contact rate') # Returns the value of the selected  #> [1] 5                                          # parameter within the model object.                                          # In order to view the parameters,                                           # run the model object and find the                                           # \"Model parameters\" section.   set_param(model_sirconn, 'Contact rate', 2) # Allows for adjustment of model                                              # parameters within the model                                              # object. In this example, the                                              # Contact rate parameter is                                              # changed to 2. You can now rerun                                              # the model to observe any                                              # differences.                                              set_name(model_sirconn, 'My Epi-Model') # This function allows for setting                                          # a name for the model. Running the                                          # model object, the name of the model                                         # is now reflected next to \"Name of                                          # the model\".                                           get_name(model_sirconn) # Returns the set name of the model.  #> [1] \"My Epi-Model\"  get_n_viruses(model_sirconn) # Returns the number of viruses in the model.  #> [1] 1                               # In this case, there is only one virus:                               # \"COVID-19\".                                 get_n_tools(model_sirconn) # Returns the number of tools in the model. In  #> [1] 0                            # this case, there are zero tools.                               get_ndays(model_sirconn) # Returns the length of the simulation in days. This #> [1] 100                          # will match \"ndays\" within the \"run\" function.                            get_n_replicates(model_sirconn) # Returns the number of replicates of the  #> [1] 2                                 # model.                                   size(model_sirconn) # Returns the population size in the model. In this case,  #> [1] 10000                     # there are 10,000 agents in the model.  # Set Agents Data # First, your data matrix must have the same number of rows as agents in the  # model. Below is a generated matrix which will be passed into the  # \"set_agents_data\" function.  data <- matrix(data=runif(20000, min=0, max=100), nrow=10000, ncol=2)                    set_agents_data(model_sirconn, data) get_agents_data_ncols(model_sirconn) # Returns number of columns  #> [1] 2  get_virus(model_sirconn, 0) # Returns information about the first virus in  #> Virus         : COVID-19 #> Id            : 0 #> state_init    : 1 #> state_post    : 2 #> state_removed : 2 #> queue_init    : 2 #> queue_post    : -2 #> queue_removed : -99                             # the model (index begins at 0).  add_tool(model_sirconn, tool(\"Vaccine\", .9, .9, .5, 1, prevalence = 0.5, as_prop = TRUE))                             get_tool(model_sirconn, 0) # Returns information about the first tool in the  #> Tool       : Vaccine #> Id         : 0 #> state_init : -99 #> state_post : -99 #> queue_init : 0 #> queue_post : 0                            # model. In this case, there are no tools so an                             # error message will occur."},{"path":"/reference/epiworldR-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","title":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","text":"Starting version 0.0-4, epiworld changed refered \"actions.\" Following traditional ABMs, actions now called \"events.\"","code":""},{"path":"/reference/epiworldR-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","text":"","code":"add_tool_n(model, tool, n)  add_virus_n(model, virus, n)  globalaction_tool(...)  globalaction_tool_logit(...)  globalaction_set_params(...)  globalaction_fun(...)"},{"path":"/reference/epiworldR-deprecated.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Deprecated and removed functions in epiworldR — epiworldR-deprecated","text":"model Model object class epiworld_model. tool Tool object class epiworld_tool. n Deprecated. virus Virus object class epiworld_virus. ... Arguments passed new function.","code":""},{"path":"/reference/epiworldR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"epiworldR — epiworldR-package","title":"epiworldR — epiworldR-package","text":"flexible framework Agent-Based Models (ABM), 'epiworldR' package provides methods prototyping disease outbreaks transmission models using 'C++' backend, making fast. supports multiple epidemiological models, including Susceptible-Infected-Susceptible (SIS), Susceptible-Infected-Removed (SIR), Susceptible-Exposed-Infected-Removed (SEIR), others, involving arbitrary mitigation policies multiple-disease models. Users can specify infectiousness/susceptibility rates function agents' features, providing great complexity model dynamics. Furthermore, 'epiworldR' ideal simulation studies featuring large populations.","code":""},{"path":[]},{"path":"/reference/epiworldR-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"epiworldR — epiworldR-package","text":"Maintainer: Derek Meyer derekmeyer37@gmail.com (ORCID) Authors: George Vega Yon g.vegayon@gmail.com (ORCID) contributors: Susan Holmes (ORCID) (JOSS reviewer) [reviewer] Abinash Satapathy (ORCID) (JOSS reviewer) [reviewer] Carinogurjao [reviewer] Centers Disease Control Prevention (Award number 1U01CK000585; 75D30121F00003) [funder]","code":""},{"path":"/reference/global-actions.html","id":null,"dir":"Reference","previous_headings":"","what":"Global Actions — global-actions","title":"Global Actions — global-actions","text":"Global actions functions executed time step simulation. useful implementing interventions, vaccination, isolation, social distancing means tools.","code":""},{"path":"/reference/global-actions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Global Actions — global-actions","text":"","code":"globalevent_tool(tool, prob, name = get_name_tool(tool), day = -99)  globalevent_tool_logit(   tool,   vars,   coefs,   name = get_name_tool(tool),   day = -99 )  globalevent_set_params(   param,   value,   name = paste0(\"Set \", param, \" to \", value),   day = -99 )  globalevent_fun(fun, name = deparse(substitute(fun)), day = -99)  add_globalevent(model, action)"},{"path":"/reference/global-actions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Global Actions — global-actions","text":"tool object class tool. prob Numeric scalar. probability 0 1. name Character scalar. name action. day Integer. day (step) action executed (see details). vars Integer vector. position variables model. coefs Numeric vector. coefficients logistic regression. param Character scalar. name parameter set. value Numeric scalar. value parameter. fun Function. function executed. model object class epiworld_model. action global action.","code":""},{"path":"/reference/global-actions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Global Actions — global-actions","text":"globalevent_set_params function returns object class epiworld_globalevent_set_param epiworld_globalevent. globalevent_tool returns object class epiworld_globalevent_tool epiworld_globalevent. globalevent_tool_logit returns object class epiworld_globalevent_tool_logit epiworld_globalevent. function add_globalevent returns model added action.","code":""},{"path":"/reference/global-actions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Global Actions — global-actions","text":"function globalevent_tool_logit allows specify logistic regression model probability using tool. model specified vector coefficients coefs vector variables vars. vars integer vector indicating position variables model. function globalevent_set_param allows set parameter model. parameter specified name param value value. function globalevent_fun allows specify function executed given day. function object must receive object class epiworld_model argument. function add_globalevent adds global action model. model checks actions executed time step. added action matches current time step, action executed. day negative, action executed time step. day positive, action executed specified time step.","code":""},{"path":[]},{"path":"/reference/global-actions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Global Actions — global-actions","text":"","code":"# Simple model model_sirconn <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )  # Creating a tool epitool <- tool(   name = \"Vaccine\",   prevalence = 0,   as_proportion = FALSE,   susceptibility_reduction = .9,   transmission_reduction = .5,   recovery_enhancer = .5,    death_reduction = .9 )   # Adding a global action vaccine_day_20 <- globalevent_tool(epitool, .2, day = 20) add_globalevent(model_sirconn, vaccine_day_20)  # Running and printing run(model_sirconn, ndays = 40, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. model_sirconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 1 tool(s). #> The model has 3 states. #> The final distribution is: 2056 Susceptible, 0 Infected, and 7944 Recovered. plot_incidence(model_sirconn)   # Example 2: Changing the contact rate ------------------------------------- model_sirconn2 <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )  closure_day_10 <- globalevent_set_params(\"Contact rate\", 0, day = 10) add_globalevent(model_sirconn2, closure_day_10)  # Running and printing run(model_sirconn2, ndays = 40, seed = 1912) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. model_sirconn2 #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 0 tool(s). #> The model has 3 states. #> The final distribution is: 2115 Susceptible, 0 Infected, and 7885 Recovered. plot_incidence(model_sirconn2)  # Example using `globalevent_fun` to record the state of the # agents at each time step.  # We start by creating an SIR connected model model <- ModelSIRCONN(   name              = \"SIR with Global Saver\",   n                 = 1000,   prevalence        = 0.01,   contact_rate      = 5,   transmission_rate = 0.4,   recovery_rate     = 0.3   )  # We create the object where the history of the agents will be stored agents_history <- NULL  # This function prints the total number of agents in each state # and stores the history of the agents in the object `agents_history` hist_saver <- function(m) {      message(\"Today's totals are: \", paste(get_today_total(m), collapse = \", \"))    # We use the `<<-` operator to assign the value to the global variable   # `agents_history` (see ?\"<<-\")   agents_history <<- cbind(     agents_history,     get_agents_states(m)     )      }"},{"path":"/reference/run_multiple.html","id":null,"dir":"Reference","previous_headings":"","what":"Run multiple simulations at once — run_multiple","title":"Run multiple simulations at once — run_multiple","text":"run_multiple function allows running multiple simulations . available, users can take advantage parallel computing speed process.","code":""},{"path":"/reference/run_multiple.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Run multiple simulations at once — run_multiple","text":"","code":"run_multiple(   m,   ndays,   nsims,   seed = sample.int(10000, 1),   saver = make_saver(),   reset = TRUE,   verbose = TRUE,   nthreads = 1L )  run_multiple_get_results(m)  make_saver(..., fn = \"\")"},{"path":"/reference/run_multiple.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Run multiple simulations at once — run_multiple","text":"m, ndays, seed See run. nsims Integer. Number replicats saver object class epiworld_saver. reset TRUE (default,) resets simulation. verbose TRUE (default,) prints progress bar. nthreads Integer. Number threads (parallel computing.) ... List strings (characters) specifying save (see details). fn file name pattern.","code":""},{"path":"/reference/run_multiple.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Run multiple simulations at once — run_multiple","text":"case make_saver, list class epiworld_saver. run_multiple function runs specified number simulations returns model object class epiworld_model. run_multiple_get_results function returns named list data specified make_saver.","code":""},{"path":"/reference/run_multiple.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Run multiple simulations at once — run_multiple","text":"Currently, following elements can saved: total_hist History model (total numbers per time). virus_info Information viruses. virus_hist Changes viruses. tool_info Information tools. tool_hist Changes tools. transmission Transmission events. transition Transition matrices. reproductive Reproductive number. generation Estimation generation time.","code":""},{"path":"/reference/run_multiple.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Run multiple simulations at once — run_multiple","text":"","code":"model_sir <- ModelSIRCONN(   name = \"COVID-19\",   prevalence = 0.01,   n = 1000,   contact_rate = 2,   transmission_rate = 0.9, recovery_rate = 0.1   )  # Generating a saver saver <- make_saver(\"total_hist\", \"reproductive\")  # Running and printing run_multiple(model_sir, ndays = 100, nsims = 50, saver = saver, nthreads = 2) #> Starting multiple runs (50) using 2 thread(s) #> _________________________________________________________________________ #> _________________________________________________________________________ #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # Retrieving the results ans <- run_multiple_get_results(model_sir)  head(ans$total_hist) #>   sim_num date nviruses       state counts #> 1       1    0        1 Susceptible    990 #> 2       1    0        1    Infected     10 #> 3       1    0        1   Recovered      0 #> 4       1    1        1 Susceptible    975 #> 5       1    1        1    Infected     24 #> 6       1    1        1   Recovered      1 head(ans$reproductive) #>   sim_num virus_id    virus source source_exposure_date rt #> 1       1        0 COVID-19     67                   10  0 #> 2       1        0 COVID-19    981                    9  0 #> 3       1        0 COVID-19    880                    9  0 #> 4       1        0 COVID-19    673                    9  0 #> 5       1        0 COVID-19    452                    9  0 #> 6       1        0 COVID-19    913                    8  0  # Plotting multi_sir <- run_multiple_get_results(model_sir)$total_hist multi_sir <- multi_sir[multi_sir$date <= 20,] plot(multi_sir)"},{"path":"/reference/tool.html","id":null,"dir":"Reference","previous_headings":"","what":"Tools in epiworld — tool","title":"Tools in epiworld — tool","text":"Tools functions affect agents react virus. can used simulate effects vaccination, isolation, social distancing.","code":""},{"path":"/reference/tool.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Tools in epiworld — tool","text":"","code":"tool(   name,   prevalence,   as_proportion,   susceptibility_reduction,   transmission_reduction,   recovery_enhancer,   death_reduction )  set_name_tool(tool, name)  get_name_tool(tool)  add_tool(model, tool, proportion)  rm_tool(model, tool_pos)  tool_fun_logit(vars, coefs, model)  set_susceptibility_reduction(tool, prob)  set_susceptibility_reduction_ptr(tool, model, param)  set_susceptibility_reduction_fun(tool, model, tfun)  set_transmission_reduction(tool, prob)  set_transmission_reduction_ptr(tool, model, param)  set_transmission_reduction_fun(tool, model, tfun)  set_recovery_enhancer(tool, prob)  set_recovery_enhancer_ptr(tool, model, param)  set_recovery_enhancer_fun(tool, model, tfun)  set_death_reduction(tool, prob)  set_death_reduction_ptr(tool, model, param)  set_death_reduction_fun(tool, model, tfun)  # S3 method for class 'epiworld_agents_tools' print(x, max_print = 10, ...)  set_distribution_tool(tool, distfun)  distribute_tool_randomly(prevalence, as_proportion)  distribute_tool_to_set(agents_ids)"},{"path":"/reference/tool.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Tools in epiworld — tool","text":"name Name tool prevalence Numeric scalar. Prevalence tool. as_proportion Logical scalar. TRUE, prevalence interpreted proportion total number agents model. susceptibility_reduction Numeric. Proportion reduces susceptibility. transmission_reduction Numeric. Proportion reduces transmission. recovery_enhancer Numeric. Proportion improves recovery. death_reduction Numeric. Proportion reduces probability death.e tool object class epiworld_tool model Model proportion Deprecated. tool_pos Positive integer. Index tool's position model. vars Integer vector. Indices (starting 0) positions variables used compute logit probability. coefs Numeric vector. length vars, vector coefficients associated logit probability. prob Numeric scalar. probability (zero one). param Character scalar. Name parameter featured model added tool (see details). tfun object class epiworld_tool_fun. x object class epiworld_agents_tools. max_print Numeric scalar. Maximum number tools print. ... Currently ignored. distfun object class epiworld_tool_distfun. agents_ids Integer vector. Indices agents tool assigned.","code":""},{"path":"/reference/tool.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Tools in epiworld — tool","text":"tool function creates tool class epiworld_tool. set_name_tool function assigns name tool class epiworld_tool returns tool. get_name_tool function returns name tool class epiworld_tool. rm_tool function removes specified tool model. set_susceptibility_reduction function assigns probability reduction specified tool class epiworld_tool. set_transmission_reduction function assigns probability reduction specified tool class epiworld_tool. set_recovery_enhancer function assigns probability increase specified tool class epiworld_tool. set_death_reduction function assigns probability decrease specified tool class epiworld_tool. distribute_tool_randomly function returns distribution function class epiworld_tool_distfun. distribute_tool_to_set function returns distribution function class epiworld_tool_distfun.","code":""},{"path":"/reference/tool.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Tools in epiworld — tool","text":"name epiworld_tool object can manipulated functions set_name_tool() get_name_tool(). add_tool function adds specified tool model class epiworld_model specified proportion. case set_susceptibility_reduction_ptr, set_transmission_reduction_ptr, set_recovery_enhancer, set_death_reduction_ptr, corresponding parameters passed pointer tool. implication using pointers values read directly model object, changes reflected. set_distribution_tool function assigns distribution function specified tool class epiworld_tool. distribution function can created using functions distribute_tool_randomly() distribute_tool_to_set(). distribute_tool_randomly function creates distribution function randomly assigns tool proportion population. distribute_tool_to_set function creates distribution function assigns tool set agents.","code":""},{"path":"/reference/tool.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Tools in epiworld — tool","text":"","code":"# Simple model model_sirconn <- ModelSIRCONN(   name                = \"COVID-19\",   n                   = 10000,   prevalence          = 0.01,   contact_rate        = 5,   transmission_rate   = 0.4,   recovery_rate       = 0.95 )  # Running and printing run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. plot(model_sirconn)   epitool <- tool(   name = \"Vaccine\",   prevalence = 0.5,   as_proportion = TRUE,   susceptibility_reduction = .9,   transmission_reduction = .5,   recovery_enhancer = .5,    death_reduction = .9 )  epitool #> Tool       : Vaccine #> Id         : (empty) #> state_init : -99 #> state_post : -99 #> queue_init : 0 #> queue_post : 0  set_name_tool(epitool, 'Pfizer') # Assigning name to the tool get_name_tool(epitool) # Returning the name of the tool #> [1] \"Pfizer\" add_tool(model_sirconn, epitool) run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. model_sirconn #> ________________________________________________________________________________ #> Susceptible-Infected-Removed (SIR) (connected) #> It features 10000 agents, 1 virus(es), and 1 tool(s). #> The model has 3 states. #> The final distribution is: 8546 Susceptible, 0 Infected, and 1454 Recovered. plot(model_sirconn)   # To declare a certain number of individuals with the tool rm_tool(model_sirconn, 0) # Removing epitool from the model # Setting prevalence to 0.1 set_distribution_tool(epitool, distribute_tool_randomly(0.1, TRUE)) add_tool(model_sirconn, epitool) run(model_sirconn, ndays = 100, seed = 1912) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # Adjusting probabilities due to tool set_susceptibility_reduction(epitool, 0.1) # Susceptibility reduction  #> Tool       : Pfizer #> Id         : 0 #> state_init : -99 #> state_post : -99 #> queue_init : 0 #> queue_post : 0 set_transmission_reduction(epitool, 0.2) # Transmission reduction set_recovery_enhancer(epitool, 0.15) # Probability increase of recovery set_death_reduction(epitool, 0.05) # Probability reduction of death  rm_tool(model_sirconn, 0)  add_tool(model_sirconn, epitool) run(model_sirconn, ndays = 100, seed = 1912) # Run model to view changes #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.   # Using the logit function -------------- sir <- ModelSIR(   name = \"COVID-19\", prevalence = 0.01,    transmission_rate = 0.9, recovery_rate = 0.1   )  # Adding a small world population agents_smallworld(   sir,   n = 10000,   k = 5,   d = FALSE,   p = .01 )  # Creating a tool mask_wearing <- tool(   name = \"Mask\",   prevalence               = 0.5,   as_proportion            = TRUE,   susceptibility_reduction = 0.0,   transmission_reduction   = 0.3, # Only transmission   recovery_enhancer        = 0.0,   death_reduction          = 0.0 )  add_tool(sir, mask_wearing)  run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. hist_0 <- get_hist_total(sir)  # And adding features dat <- cbind(   female = sample.int(2, 10000, replace = TRUE) - 1,   x      = rnorm(10000) )  set_agents_data(sir, dat)  # Creating the logit function tfun <- tool_fun_logit(   vars  = c(0L, 1L),   coefs = c(-1, 1),   model = sir )  # The infection prob is lower hist(plogis(dat %*% rbind(.5,1)))   tfun # printing #> An epiworld_tool_function object. #> (model: Susceptible-Infected-Recovered (SIR)) #> This function was built using -tool_fun_logit()-. and it features the following coefficients: #>   0: -1.00 #>   1:  1.00    set_susceptibility_reduction_fun(   tool  = get_tool(sir, 0),   model = sir,   tfun  = tfun   )    run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. hist_1 <- get_hist_total(sir)  op <- par(mfrow = c(1, 2)) plot(hist_0); abline(v = 30) plot(hist_1); abline(v = 30)  par(op)"},{"path":"/reference/virus.html","id":null,"dir":"Reference","previous_headings":"","what":"Virus design — virus","title":"Virus design — virus","text":"Viruses can considered anything can transmitted (e.g., diseases, well ideas.) models epiworldR can feature multiple viruses.","code":""},{"path":"/reference/virus.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Virus design — virus","text":"","code":"virus(   name,   prevalence,   as_proportion,   prob_infecting,   recovery_rate = 0.5,   prob_death = 0,   post_immunity = -1,   incubation = 7 )  set_name_virus(virus, name)  get_name_virus(virus)  add_virus(model, virus, proportion)  virus_set_state(virus, init, end, removed)  rm_virus(model, virus_pos)  virus_fun_logit(vars, coefs, model)  set_prob_infecting(virus, prob)  set_prob_infecting_ptr(virus, model, param)  set_prob_infecting_fun(virus, model, vfun)  set_prob_recovery(virus, prob)  set_prob_recovery_ptr(virus, model, param)  set_prob_recovery_fun(virus, model, vfun)  set_prob_death(virus, prob)  set_prob_death_ptr(virus, model, param)  set_prob_death_fun(virus, model, vfun)  set_incubation(virus, incubation)  set_incubation_ptr(virus, model, param)  set_incubation_fun(virus, model, vfun)  set_distribution_virus(virus, distfun)  distribute_virus_randomly(prevalence, as_proportion)  distribute_virus_set(agents_ids)"},{"path":"/reference/virus.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Virus design — virus","text":"name virus prevalence Numeric scalar. Prevalence virus. as_proportion Logical scalar. TRUE, prevalence set proportion total number agents model. prob_infecting Numeric scalar. Probability infection (transmission). recovery_rate Numeric scalar. Probability recovery. prob_death Numeric scalar. Probability death. post_immunity Numeric scalar. Post immunity (prob re-infection). incubation Numeric scalar. Incubation period (days) virus. virus object class epiworld_virus model object class epiworld_model. proportion Deprecated. init, end, removed states acquiring virus, removing virus, removing agent result virus, respectively. virus_pos Positive integer. Index virus's position model. vars Integer vector. Indices (starting 0) positions variables used compute logit probability. coefs Numeric vector. length vars, vector coefficients associated logit probability. prob Numeric scalar. probability (zero one). param Character scalar. Name parameter featured model added virus (see details). vfun object class epiworld_virus_fun. distfun object class epiworld_distribution_virus. agents_ids Integer vector. Indices agents receive virus.","code":""},{"path":"/reference/virus.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Virus design — virus","text":"set_name_virus function return value, merely assigns name virus choice. get_name_virus function returns name virus class epiworld_virus. add_virus function return value, instead adds virus choice model object class epiworld_model. virus_set_state function return value assigns epidemiological properties specified virus class epiworld_virus. rm_virus function return value, instead removes specified virus model class epiworld_model. set_prob_infecting function return value, instead assigns probability infection specified virus class epiworld_virus. set_prob_recovery function return value, instead assigns probability recovery specified virus class epiworld_virus. set_prob_death function return value, instead assigns probability death specified virus class epiworld_virus. set_incubation function return value, instead assigns incubation period specified virus class epiworld_virus. distribute_virus_randomly function returns function can used distribute virus model.","code":""},{"path":"/reference/virus.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Virus design — virus","text":"virus() function can used initialize virus. Virus features can modified using functions set_prob_*. function virus_fun_logit() creates \"virus function\" can evaluated transmission, recovery, death. name sugests, computes probabilities using logit function (see examples). name epiworld_virus object can manipulated functions set_name_virus() get_name_virus(). case set_prob_infecting_ptr, set_prob_recovery_ptr, set_prob_death_ptr, corresponding parameters passed pointer virus. implication using pointers values read directly model object, changes reflected. distribute_virus_randomly function factory function used randomly distribute virus model. prevalence can set proportion number agents. resulting function can passed set_distribution_virus.","code":""},{"path":"/reference/virus.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Virus design — virus","text":"","code":"mseirconn <- ModelSEIRCONN(   name                = \"COVID-19\",   prevalence          = 0.01,    n                   = 10000,   contact_rate        = 4,    incubation_days     = 7,    transmission_rate   = 0.5,   recovery_rate       = 0.99 )  delta <- virus(   \"Delta Variant\", 0, .5, .2, .01, prevalence = 0.3, as_proportion = TRUE )  # Adding virus and setting/getting virus name add_virus(mseirconn, delta) set_name_virus(delta, \"COVID-19 Strain\") get_name_virus(delta) #> [1] \"COVID-19 Strain\"  run(mseirconn, ndays = 100, seed = 992) #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done. mseirconn #> ________________________________________________________________________________ #> Susceptible-Exposed-Infected-Removed (SEIR) (connected) #> It features 10000 agents, 2 virus(es), and 0 tool(s). #> The model has 4 states. #> The final distribution is: 3685 Susceptible, 167 Exposed, 24 Infected, and 6124 Recovered.  rm_virus(mseirconn, 0) # Removing the first virus from the model object set_distribution_virus(delta, distribute_virus_randomly(100, as_proportion = FALSE)) add_virus(mseirconn, delta)   # Setting parameters for the delta virus manually set_prob_infecting(delta, 0.5) set_prob_recovery(delta, 0.9) set_prob_death(delta, 0.01) run(mseirconn, ndays = 100, seed = 992) # Run the model to observe changes #> _________________________________________________________________________ #> Running the model... #> ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #>  done.  # If the states were (for example): # 1: Infected # 2: Recovered # 3: Dead delta2 <- virus(   \"Delta Variant 2\", 0, .5, .2, .01, prevalence = 0, as_proportion = TRUE ) virus_set_state(delta2, 1, 2, 3) # Using the logit function -------------- sir <- ModelSIR(   name = \"COVID-19\", prevalence = 0.01,    transmission_rate = 0.9, recovery = 0.1   )  # Adding a small world population agents_smallworld(   sir,   n = 10000,   k = 5,   d = FALSE,   p = .01 )  run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. plot(sir)   # And adding features dat <- cbind(   female = sample.int(2, 10000, replace = TRUE) - 1,   x      = rnorm(10000) )  set_agents_data(sir, dat)  # Creating the logit function vfun <- virus_fun_logit(   vars  = c(0L, 1L),   coefs = c(-1, 1),   model = sir )  # The infection prob is lower hist(plogis(dat %*% rbind(-1,1)))   vfun # printing #> An epiworld_virus_function object. #> (model: Susceptible-Infected-Recovered (SIR)) #> This function was built using -virus_fun_logit()-. and it features the following coefficients: #>   0: -1.00 #>   1:  1.00   set_prob_infecting_fun(   virus = get_virus(sir, 0),   model = sir,   vfun  = vfun   )    run(sir, ndays = 50, seed = 11) #> _________________________________________________________________________ #> |Running the model... #> |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| done. #> | done. plot(sir)"},{"path":"/news/index.html","id":"epiworldr-03-2","dir":"Changelog","previous_headings":"","what":"epiworldR 0.3-2","title":"epiworldR 0.3-2","text":"Starting version 0.3-0, epiworldR versioned using version C++ library, epiworld. Adds new mixing models ModelSIRMixing ModelSEIRMixing. Ports Entity class. Entities used group agents within model. Refactors add_tool, add_virus, add_entity simplifying syntax. Now, functions receive model object. Prevalence specified object . add_tool_n add_virus_n now deprecated. globalaction_* now defunct. Use globalevent_* instead. New functions specify viruses, tools, entities distributed among agents: distribute_viruses, distribute_tools, distribute_entities.","code":""},{"path":"/news/index.html","id":"epiworldr-01-0","dir":"Changelog","previous_headings":"","what":"epiworldR 0.1-0","title":"epiworldR 0.1-0","text":"CRAN release: 2024-04-08 Force model update agents’ states running simulation. causing issues calling run_multiple() single call run(). Reported 14.","code":""},{"path":"/news/index.html","id":"epiworldr-00-4","dir":"Changelog","previous_headings":"","what":"epiworldR 0.0-4","title":"epiworldR 0.0-4","text":"CRAN release: 2024-02-09 Added missing checks tool class adding model add_too_n. Various small improvements.","code":""},{"path":"/news/index.html","id":"epiworldr-00-3","dir":"Changelog","previous_headings":"","what":"epiworldR 0.0-3","title":"epiworldR 0.0-3","text":"CRAN release: 2023-09-08 Added following models: ModelSEIRD, ModelSEIRDCONN, ModelSIRD, ModelSIRDCONN, ModelSISD. Fixed bug reported issue 6.","code":""},{"path":"/news/index.html","id":"epiworldr-00-2","dir":"Changelog","previous_headings":"","what":"epiworldR 0.0-2","title":"epiworldR 0.0-2","text":"CRAN release: 2023-06-21 Added NEWS.md file track changes package. Fixed bug reported CRAN reference nullptr. Renamed arguments across Models favor consistency. Figures now show virus/tool name instead id. Fixed bug run_multiple added tests (C++). Redid autoconf Makevars using RcppArmadillo template checking OpenMP.","code":""}]