Skip to content

Commit 81557f3

Browse files
committed
update clarifications at setup file
1 parent a3ea931 commit 81557f3

File tree

1 file changed

+19
-17
lines changed

1 file changed

+19
-17
lines changed

learners/setup.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,48 +4,50 @@ title: Setup
44

55
## Motivation
66

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.
88

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.
1010

1111
### Epiverse-TRACE tutorials
1212

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.
14+
1415

1516
![An overview of the tutorial topics](https://epiverse-trace.github.io/task_pipeline-minimal.svg)
1617

17-
Each task has its tutorial website. Each tutorial website consists of a set of episodes.
18+
Each task has its tutorial website and each tutorial website consists of a set of episodes covering different topics.
1819

1920
| [Early task tutorials ➠](https://epiverse-trace.github.io/tutorials-early/) | [Middle task tutorials ➠](https://epiverse-trace.github.io/tutorials-middle) | [Late task tutorials ➠](https://epiverse-trace.github.io/tutorials-late/) |
2021
|---|---|---|
21-
| Reading and cleaning case data | Real-time analysis and forecasting | Scenario modelling |
22-
| Read and clean linelist data, Access delay distributions, and Estimate transmission metrics. | Forecast cases, Estimate severity, and Estimate superspreading. | Simulate disease spread and Investigate interventions. |
22+
| Read and clean case data, and make linelist | Real-time analysis and forecasting | Scenario modelling |
23+
| Read, clean and validate case data, convert linelist data to incidence for visualization. | Access delay distributions and estimate transmission metrics, forecast cases, estimate severity and superspreading. | Simulate disease spread and investigate interventions. |
2324

2425
Each episode contains:
2526

26-
+ **Overview** : describes what questions will be answered and what are the objectives of the episode.
27-
+ **Prerequisites**: describes what episodes/packages need to be covered before the current episode.
28-
+ **Example R code** : work through the episodes on your own computer using the example R code.
29-
+ **Challenges** : complete challenges to test your understanding.
30-
+ **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.
3132

32-
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.
3334

3435
### Epiverse-TRACE R packages
3536

36-
Our strategy is to gradually incorporate specialised **R packages** into our traditional analysis pipeline. These packages should fill the gaps in these epidemiology-specific tasks in response to outbreaks.
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.
3738

3839
![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))](episodes/fig/pkgs-hexlogos-2.png)
3940

4041
:::::::::::::::::::::::::::: prereq
4142

42-
This course assumes intermediate R knowledge. This workshop is for you if:
43+
This content assumes intermediate R knowledge. This tutorials are for you if:
4344

44-
- You can use the magrittr pipe `%>%` and/or native pipe `|>`
45-
- You are familiar with functions from `{dplyr}`, `{tidyr}`, and `{ggplot2}`
4645
- You can read data into R, transform and reshape data, and make a wide variety of graphs
46+
- You are familiar with functions from `{dplyr}`, `{tidyr}`, and `{ggplot2}`
47+
- You can use the magrittr pipe `%>%` and/or native pipe `|>`.
48+
4749

48-
We expect participants to have some exposure to basic Statistical, Mathematical and Epidemic theory concepts, but NOT intermediate or expert familiarity with modeling.
50+
We expect learners to have some exposure to basic Statistical, Mathematical and Epidemic theory concepts, but NOT intermediate or expert familiarity with modeling.
4951

5052
::::::::::::::::::::::::::::
5153

0 commit comments

Comments
 (0)