-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.Rmd
102 lines (63 loc) · 6.24 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
---
title: "R coaching session materials"
date: "`r format(Sys.time(), '%d %B %Y')`"
output:
github_document:
toc: true
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r setup, include = FALSE}
knitr::opts_chunk$set(eval = FALSE,
collapse = TRUE,
comment = "#>",
fig.path = "inst/images",
fig.align = "right")
```
## Overview
This page hosts the R tutorial materials for the **MSF UK R epi coaching series**. This coaching series was developed to support MSF R public health epidemiology users who have already undertaken some R courses and/or have some limited experience of R, but are still at an early stage in their R journey. The materials may also be useful to more experienced R users who want a quick refresher on how to undertake some common analytical tasks in R.
### Material source
The content of these sessions is inspired by requests from the coaching group. The tutorials are written by MSF OCA epidemiology advisors and tailored to the needs of the group. Each session typically focuses on a task that one or more members is undertaking during their daily work. The material for each session includes an R markdown document used to create a HTML tutorial, which introduces some brief context (a made up scenario) on which some exercises are based. For each exercise, there is some example code, followed by a 'your turn' section, which invites users to try the code themselves using different parameters. There are hint and solution sections at the end of each exercise, which can be revealed on a click if the users need more guidance.
The coaching sessions are usually run as an online interactive session, however the materials can also be used independently for self-learning.
### Credits
The style and approach taken by the tutorials follows closely that presented in the [Epidemiologist R handbook](https://epirhandbook.com/en/). For simplicity, in most sessions we have also used the data sets that accompany the handbook for the exercises. We gratefully acknowledge and thank the authors of the **Epidemiologist R handbook** for this invaluable resource.
### Available tutorials
Currently you can access tutorials for the following sessions:
+ *Session 1: working with R markdown documents*
+ [click here](https://msf-uk.github.io/r-epi-coaching/S1_rmarkdown.zip) to download session 1 materials
+ *Session 2: making epicurves*
+ [click here](https://msf-uk.github.io/r-epi-coaching/S2_epicurves.zip) to download session 2 materials
+ [click here](https://msf-uk.github.io/r-epi-coaching/Tutorial_S2_epicurves.html) to access the session 2 tutorial online
+ *Session 3: dealing with complex data structures - joining, binding and pivoting*
+ [click here](https://msf-uk.github.io/r-epi-coaching/S3_pivots_joins.zip) to download session 3 materials
+ [click here](https://msf-uk.github.io/r-epi-coaching/Tutorial_S3a_pivotsjoins.html) to access the session 3a tutorial (joining and binding) online
+ [click here](https://msf-uk.github.io/r-epi-coaching/Tutorial_S3b_pivotsjoins.html) to access the session 3b tutorial (pivoting data) online
+ *Session 4: descriptive statistics and logistic regression*
+ [click here](https://msf-uk.github.io/r-epi-coaching/S4_stats.zip) to download session 4 materials
+ [click here](https://msf-uk.github.io/r-epi-coaching/Tutorial_S4_statistics.html) to access the session 4 tutorial online
This list will be updated as new sessions become available.
## How to use this resource
If you would like to try the tutorials, we suggest you do the following:
01. Make sure you have the latest versions of R, RStudio and Rtools installed.
02. Download the materials pack for the relevant session from the links above.
03. Unzip the folder to a location on your computer (desktop or my documents).
04. Go to the sub-folder `outputs` and click on the HTML file inside it (it will open in your internet browser, but does not require an internet connection).
05. Alternately, if you have a good internet connection, you can access the tutorials directly online from the links above.
06. Now open the Rstudio project in the root of the session folder.
07. Create a new R script for the exercises and save it in the subfolder called 'scripts'.
08. Follow the introductory section to make sure you have the relevant packages installed, loaded and to import the data
09. Follow the rest of the sections in sequence to undertake the exercises (note: exercises are displayed in tabs).
10. If you are stuck, you can click on the arrow next to the *hint* or *solution* buttons at the bottom of each exercise to reveal them
If you are an experienced R user and would like to add to this tutorial or the coaching series, please see below for how to contribute.
## Github repository
### Distribution and licensing
These tutorials are covered by a Gnu General Public Licence version 3 (GPL-3). Please read the [licence conditions](https://github.com/MSF-UK/r-epi-coaching/blob/main/LICENSE) before using or distributing them.
### Contributing
The R code for the tutorials and practical materials on this page are hosted on the [MSF UK R epi coaching repository](https://github.com/MSF-UK/r-epi-coaching.git). Revisions and contributions are welcome; please check out your own branch to commit the updates and then submit a pull request. Write access to the repository can be provided on request.
### Comments and suggestions
Comments and suggestions are welcome. If you have found a bug in the tutorials, please raise an issue about it on the [MSF UK R epi coaching repository issues page](https://github.com/MSF-UK/r-epi-coaching/issues), clearly stating the nature of the problem and providing a reproducible example. You can also use the **issues** page to suggest revisions, new features or topics to cover in future tutorials.
### Contacts
This repository is currently maintained by:
+ [Amy Mikhail](https://github.com/AmyMikhail)
+ [Gregoire Falq](https://github.com/gfalqoca)
+ [Patrick Keating](https://github.com/pbkeating)
If you have any questions about the content of this repository, the best way to contact the maintainers is to create an issue (we will be automatically notified).