Hello! Please follow these instructions to download and install the necessary software and files. Note that it is not enough to have just R and tidyverse installed (which you might have) - you will also need a number of packages and a worksheet file, and your R should be up to date. I’d also recommend using RStudio instead of the plain R GUI. The instructions below come with troubleshooting steps - if something seems to be amiss or not working as intended, make sure you’ve read through everything.
- Andres Karjus
This document contains step-by-step instructions for:
All steps except 6 are mandatory and should be done before the workshop starts.
Importantly, if something went wrong and you could not install the software, please get in touch before the workshop starts so we can try to quickly troubleshoot. We cannot afford to waste any time on issues like installation during the workshop.
The installation process only takes a few clicks. But before you start, please make sure your operating system is up to date as well (particularly Macs: there are known conflicts between old versions of R and some newer packages, which will manifest if you have a Mac with an old version of the Mac OS, which in turn would lead you to download an old version of R).
First and foremost, you need R. If you already have R installed, please still update it to the most recent version, i.e. R version 4.0.2 (2020-06-22). Updating is done just by downloading the most recent installer and installing. Depending on your operating system, go to:
Download the installer and install (with default options, just keep clicking Next). Run R once to see that it works (in Windows, Rgui.exe should appear as a shortcut in the start menu and/or desktop; on a Mac, look for the R application in Finder). It should look something like this, depending on your OS:
Good job. Now close R (if it asks to save the workspace, say no). Once you get RStudio, there is no need to look at this ugly interface ever again.
While it is fine to use R from the command line or the bare-bones R interface application, we are going to use RStudio instead, which will make using R a lot easier and less of a hassle. It also has nice support for R Markdown, which we will be using.
Common issues and troubleshooting:
RStudio is an integrated development environment for R (which is why we had to install that first) - the Console panel on the left is basically the same thing that you saw when you ran “plain” R. But RStudio also features a number of very helpful features that will become apparent in the workshop. It comes with a handy script editor, which we are going to use right away.
Before we do that, we need to quickly change two options in RStudio to make it behave in a more useful way for us (fortunately, the RStudio interface is highly customisable).
Soft-wrap R source file(this will make using the script editor much easier, by wrapping long lines so you won’t have to keep scrolling left and right all the time). See below for illustration.
Show output inline for all R Markdown documents(i.e. make sure the tick box is empty). This will disable notebook-style plot previews in the script editor and show plots in the Plots pane.