You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: learners/setup.md
+16-33Lines changed: 16 additions & 33 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,25 +4,18 @@ title: Setup
4
4
5
5
## Motivation
6
6
7
-
**Outbreaks** appear with different diseases and in different contexts, but what all of them have in common is the key public health questions ([Cori et al. 2017](https://royalsocietypublishing.org/doi/10.1098/rstb.2016.0371#d1e605)). We can relate these key public health questions to outbreak data analysis tasks.
7
+
**Outbreaks**of infectious diseases can appear as a result of different pathogens, and in different contexts, but they typically lead to similar public health questions, from understanding patterns of transmission and severity to examining the effect of control measures ([Cori et al. 2017](https://royalsocietypublishing.org/doi/10.1098/rstb.2016.0371#d1e605)). We can relate each of these public health questions to a series of outbreak data analysis tasks. The more efficiently and reliably we can perform these tasks, the faster and more accurately we can answer the underlying questions.
8
8
9
-
Epiverse-TRACE aims to provide a software ecosystem for [**outbreak analytics**](reference.md#outbreakanalytics) with integrated, generalisable and scalable community-driven software. We support the development of R packages, make the existing ones interoperable for the user experience, and stimulate a community of practice.
9
+
Epiverse-TRACE aims to provide a software ecosystem for [**outbreak analytics**](reference.md#outbreakanalytics) with integrated, generalisable and scalable community-driven software. We support the development of new R packages, help link together existing tools to make them more user-friendly, and contribute to a community of practice, spanning field epidemiologists, data scientists, lab researchers, health agency analysts, software engineers and more.
10
10
11
11
### Epiverse-TRACE tutorials
12
12
13
-
The tutorials are built around an outbreak analysis pipeline split into three stages: **Early tasks**, **Middle tasks** and **Late tasks**.
13
+
Our tutorials are built around an outbreak analysis pipeline split into three stages: **Early tasks**, **Middle tasks** and **Late tasks**. The outputs of tasks completed in earlier stages commonly feed into the tasks required for later ones.
@@ -31,33 +24,23 @@ Each task has its tutorial website. Each tutorial website consists of a set of e
31
24
32
25
Each episode contains:
33
26
34
-
+**Overview**: describes what questions will be answered and what are the objectives of the episode.
35
-
+**Prerequisites**: describes what episodes/packages need to be covered before the current episode.
36
-
+**Example R code**: work through the episodes on your own computer using the example R code.
37
-
+**Challenges**: complete challenges to test your understanding.
38
-
+**Explainers**: add to your understanding of mathematical and modelling concepts with the explainer boxes.
27
+
+**Overview**: describes what questions will be answered and the objectives of the episode.
28
+
+**Prerequisites**: describes what episodes/packages ideally need to be covered before the current episode.
29
+
+**Example R code**: example R code so you can work through the episodes on your own computer.
30
+
+**Challenges**: challenges that can be completed to test your understanding.
31
+
+**Explainers**: boxes to enhance your understanding of mathematical and modelling concepts.
39
32
40
-
Also check out the [glossary](../reference.md) for any terms you may be unfamiliar with.
33
+
Also check out the [glossary](./reference.md) for any terms you may be unfamiliar with.
41
34
42
35
### Epiverse-TRACE R packages
43
36
44
37
Our strategy is to gradually incorporate specialised **R packages** into a traditional analysis pipeline. These packages should fill the gaps in these epidemiology-specific tasks in response to outbreaks.
45
38
46
-
.
47
-
48
-
<p><figure>
49
-
<img src="episodes/fig/pkgs-hexlogos-2.png"
50
-
alt="Outbreak analysis R packages"
51
-
width="600"/>
52
-
<figcaption>
53
-
<p>In **R**, the fundamental unit of shareable code is the **package**. A package bundles together code, data, documentation, and tests and is easy to share with others ([Wickham and Bryan, 2023](https://r-pkgs.org/introduction.html))</p>
54
-
</figcaption>
55
-
</figure>
56
-
</p>
39
+
)](episodes/fig/pkgs-hexlogos-2.png)
57
40
58
41
:::::::::::::::::::::::::::: prereq
59
42
60
-
This content assumes intermediate R knowledge. These tutorials are for you if:
43
+
This content assumes intermediate R knowledge. This tutorials are for you if:
61
44
62
45
- You can read data into R, transform and reshape data, and make a wide variety of graphs
63
46
- You are familiar with functions from `{dplyr}`, `{tidyr}`, and `{ggplot2}`
@@ -68,11 +51,11 @@ We expect learners to have some exposure to basic Statistical, Mathematical and
68
51
69
52
::::::::::::::::::::::::::::
70
53
71
-
:::::::::::::::::::::::::::: callout
54
+
:::::::::::::::::::::::::::: caution
72
55
73
56
### R refresher
74
57
75
-
If you need to refresh your R knowledge to fulfill the prerequisites,
58
+
If you need to refresh your R knowledge to fulfil the prerequisites,
76
59
we recommend you solve these
77
60
**interactive online self-paced tutorials** from Applied Epi on:
0 commit comments