Skip to content

Commit

Permalink
Update setup.md
Browse files Browse the repository at this point in the history
  • Loading branch information
martinherrerias authored Sep 18, 2023
1 parent ebff490 commit 1fa082c
Showing 1 changed file with 19 additions and 9 deletions.
28 changes: 19 additions & 9 deletions setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,26 @@ permalink: /setup/
*We will be using some example data in the lesson. Download the file from [here]({{ page.root }}/data/r-novice.zip) and extract it to your computer*

## Software
This lesson assumes you have the R and RStudio software installed on your computer. This should already be the case if you are using the University computers.
This lesson assumes you have the _R_ and _Rstudio_ software installed on your computer. This should already be the case if you are using the University computers on a cluster.

R can be downloaded [here](https://www.stats.bris.ac.uk/R/).
1. _R_ can be downloaded [here](https://www.stats.bris.ac.uk/R/). Select the precompiled binary distribution for your operating system.

RStudio is an environment for developing using R.
It can be downloaded [here](https://www.rstudio.com/products/rstudio/download/).
You will need the Desktop version for your computer; scroll to the bottom of the page for links.
2. _Rstudio_ is an environment for code development using _R_. It can be downloaded [here](https://www.rstudio.com/products/rstudio/download/). You will need the Desktop version for your computer; scroll to the bottom of the page for links.

The course teaches the [tidyverse](https://www.tidyverse.org), which is a collection of R packages that are designed to make many common data analysis tasks easier. The computers in G11 already have the tidyverse installed. If you are using your own laptop *please* install this before the course. You can do this by starting RStudio, and typing:
#### University Managed Laptop (Windows)
To install R and RStudio on a University managed windows machine, go to Software Centre to install: `R (4.2.3)`, `Rtools`, and `R Studio`

#### 😱 Help! It is the Day 1 of the course and I didn't install R/R Studio

If this is you, we recommend that you either:

+ Log on to a University of Manchester cluster remotely. Follow the instructions [here](https://www.itservices.manchester.ac.uk/students/pc-on-campus/remote-cluster-access/) and choose `Sackville Desktop G11` (R/R Studio are installed).

+ Use [_R Studio Cloud_](https://login.rstudio.cloud/) (an online version of _RStudio_). This service is not associated with the University of Manchester. You should take care to ensure that you only sign up for a free account.

## Packages

The course teaches the [tidyverse](https://www.tidyverse.org), which is a collection of _R_ packages that are designed to make many common data analysis tasks easier. Cluster computers already have the tidyverse installed. If you are using your own laptop *please* install this before the course. You can do this by starting _Rstudio_, and typing:

```{r}
install.packages("tidyverse")
Expand All @@ -25,10 +36,9 @@ At the `>` prompt in the left hand window of RStudio. You may be prompted to s

R will download the packages that constitute the tidyverse, and then install them. This can take some time. You may get a prompt `There are binary versions available but the source versions are later` and asking if you want to install from sources packages which require compilation. You should answer no to this.


If you are using a mac you may be prompted whether you wish to install binary or source versions of the packages; you should select binary.

On Linux several of the packages will be compiled from source. This can take several minutes. You may find that you need to install additional development libraries to allow this to happen.
On Linux, several of the packages will be compiled from source. This can take several minutes. You may find that you need to install additional development libraries to allow this to happen.

There will be a number of messages displayed during installation. After the installation has completed you should see a message containing:

Expand All @@ -50,5 +60,5 @@ ggplot(cars, aes(x=speed, y=dist)) + geom_point()

This should produce a plot in the lower right hand window of RStudio.

If you encounter difficulties installing R, RStudio or the Tidyverse please contact me at david.mawdsley@manchester.ac.uk before the course starts. There is little time to resolve installation problems on the day.
If you encounter difficulties installing R, RStudio or the Tidyverse please contact martin.herreriasazcue@manchester.ac.uk before the course starts. There is little time to resolve installation problems on the day.

0 comments on commit 1fa082c

Please sign in to comment.