Setup

Setup instructions

R and RStudio are separate downloads and installations. R is the underlying statistical computing environment, but using R alone is no fun. RStudio is a graphical integrated development environment (IDE) that makes using R much easier and more interactive. You need to install R before you install RStudio. Once installed, because RStudio is an IDE, RStudio will run R in the background. You do not need to run it separately.

After installing both programs, you will need to install the tidyverse package from within RStudio. The tidyverse package is a powerful collection of data science tools within R see the tidyverse website for more details. Follow the instructions below for your operating system, and then follow the instructions to install tidyverse.

Windows

If you already have R and RStudio installed

if( !("installr" %in% installed.packages()) ){install.packages("installr")}
installr::updateR(TRUE)

If you don’t have R and RStudio installed

macOS

If you already have R and RStudio installed

If you don’t have R and RStudio installed

Linux

Install required R packages and Data

During the course we will need a number of R packages. Packages contain useful R code written by other people. We will use the packages tidyverse, hexbin, patchwork, and RSQLite.

To try to install these packages, open RStudio and copy and paste the following command into the console window (look for a blinking cursor on the bottom left), then press the Enter (Windows and Linux) or Return (MacOS) to execute the command.

install.packages(c("tidyverse", "here", "hexbin", "patchwork", "RSQLite", "palmerpenguins"))

Alternatively, you can install the packages using RStudio’s graphical user interface by going to Tools > Install Packages and typing the names of the packages separated by a comma.

R tries to download and install the packages on your machine. When the installation has finished, you can try to load the packages by pasting the following code into the console:

library(tidyverse)
library(here)
library(hexbin)
library(patchwork)
library(RSQLite)
library(palmerpenguins)

If you do not see an error like there is no package called ‘...’ you are good to go!

Updating R packages

Generally, it is recommended to keep your R version and all packages up to date, because new versions bring improvements and important bugfixes. To update the packages that you have installed, click Update in the Packages tab in the bottom right panel of RStudio, or go to Tools > Check for Package Updates....

Sometimes, package updates introduce changes that break your old code, which can be very frustrating. To avoid this problem, you can use a package called renv. It locks the package versions you have used for a given project and makes it straightforward to reinstall those exact package version in a new environment, for example after updating your R version or on another computer. However, the details are outside of the scope of this lesson.

Complications and Problems

If you find that you cannot download R/RStudio, you may instead use an image hosted by UCSB Letters and Science IT. You will be able to use R/Rstudio in your browser, so no installation is needed if you choose this option. If you wish to use the LSIT RStusio image, then you do not need to install anything. In the beginning of the workshop, we will provide you with the information you need to get RStudio running on your browser.