generated from microbiome/course_2022_oulu
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy path02-start.Rmd
110 lines (74 loc) · 5.04 KB
/
02-start.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
103
104
105
106
107
108
109
110
# Getting started {#start}
## Checklist
* Test your login to the CSC R environment (and optionally, set up your own R); see below for details
* Watch [short online videos](https://www.youtube.com/playlist?list=PLjiXAZO27elAJEptP59BN3whVJ61XIkST) on microbiome data science with R/Bioconductor.
* Optionally: Read through the manuscripts in the reading tips (listed below).
* Try out [reproducible reporting Quarto](https://microbiome.github.io/OMA/resources.html#quarto)
* Read about the selected demo data: [HintikkaXOData](https://microbiome.github.io/OMA/containers.html#hintikka-desc). You can also try to load it in R and explore the data structure.
* Online support: for installation and other issues, join us at [Gitter](https://gitter.im/microbiome/miaverse?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge).
## Study material {#material}
The course will use material from
[OMA](https://microbiome.github.io/OMA/) online book, which is
currently in its beta version. We encourage to familiarize with the
content of the book and try some examples already before the course
starts but this is optional.
A more extensive checklist for getting started is
[available](https://microbiome.github.io/OMA/training.html#checklist),
and the slides and other teaching material will be shared at a later
point through
[OMA](https://microbiome.github.io/OMA/training.html#material).
### Lecture slides
#### Day 1
- [Intro](https://microbiome.github.io/outreach/intro.html)
- [Bioconductor](https://microbiome.github.io/outreach/bioconductor.html)
- [Starting](https://microbiome.github.io/outreach/starting.html)
- [Reproducible Workflow](https://microbiome.github.io/outreach/reproducible_workflow.html)
- [Data Containers](https://microbiome.github.io/outreach/datacontainers.html)
- [SummarizedExperiment Container](https://microbiome.github.io/outreach/summarizedexperiment.html)
#### Day 2
- [Main Slides](https://microbiome.github.io/outreach/day2.html)
- [TreeSummarizedExperiment](https://microbiome.github.io/outreach/treese.html)
### Reading tips {#reading}
We suggest to read the following manuscripts in order to familiarize with some of the general concepts and approaches discussed at the course.
[Software for the Integration of Multiomics Experiments in Bioconductor](https://aacrjournals.org/cancerres/article/77/21/e39/662607/Software-for-the-Integration-of-Multiomics). Ramos et al. Cancer Res. (2017).
[Orchestrating single-cell analysis with Bioconductor](https://doi.org/10.1038/s41592-019-0654-x). Amezquita, R.A., Lun, A.T.L., Becht, E. et al. Nat Methods 17, 137–145 (2020).
[Bioconductor Workflow for Microbiome Data Analysis: from raw reads to community analyses](https://f1000research.com/articles/5-1492/v2). Callahan et al. (2016). F1000Res; 5: 1492.
## Setting up R environment {#renv}
### Your own computer
Setting up your own computer and using local R installation will allow
you to continue using the same tools after the course. In order to do
this, you can follow the [OMA setup checklist](https://microbiome.github.io/OMA/training.html#training).
The course organizers can provide limited online support for installations via [Gitter](https://microbiome.github.io/OMA/training.html#support-and-resources). However, installation is more demanding in some systems.
We also provide the CSC notebook for the course (see below); this
comes with all necessary R packages and data pre-installed for ease of
use.
### CSC Notebook
We provide a temporary access to a cloud computing environment
that readily contains the available software packages. Instructions to access
the environment will be sent to the registered participants.
1. Read the [instructions](https://docs.csc.fi/cloud/csc_notebooks/guide_for_students/)
2. Go to the [CSC notebook frontpage](https://notebooks-beta.rahtiapp.fi/welcome)
3. Login
a. Haka login
* If you have a Finnish university account, you should be able to login with Haka
1. Press **Login** button from the frontpage
2. Press **Haka** button
3. Select right organization
4. Enter login information
b. CSC login
* You can create a CSC account by following the [instructions](https://research.csc.fi/accounts-and-projects)
1. Press **Login** button from the frontpage
2. Press **CSC** button
3. Enter login information
c. Special login
* For those who cannot login with Haka or CSC account
1. Contact Giulio on [gitter](https://app.gitter.im/#/room/#microbiome_miaverse:gitter.im) if you are not able to login
2. We give you a guest account
3. Press **Special Login** button from the frontpage (below the **Login** button)
4. Enter login information (username goes to **email** slot)
4. Join workspace
a. Press **Join workspace** button (Top right corner)
b. Enter the **Join Code** (Check your email)
5. Start session
a. Press **ON** button
6. You can save files to **my-work** directory. They are kept stored even when the session is closed. **shared** folder is shared with all participants.