R for Biologists course

R takes time to learn, like a spoken language. No one can expect to be an R expert after learning R for a few hours. This course has been designed to introduce biologists to R, showing some basics, and also some powerful things R can do (things that would be more difficult to do with Excel). The aim is to give beginners the confidence to continue learning R, so the focus here is on tidyverse and visualisation of biological data, as we believe this is a productive and engaging way to start learning R. After this short introduction you can read this book to dive a bit deeper.

Most R programmers do not remember all the command lines we share in this document. R is a language that is continuously evolving. They use Google extensively to use many new tricks. Do not hesitate to do the same!

1. Intro to R and RStudio

RStudio is an interface that makes it easier to use R. There are four windows in RStudio. The screenshot below shows an analogy linking the different RStudio windows to cooking.

     

R script vs console

There are two ways to work in RStudio in the console or in a script. We can type a command in the console and press Enter to run it.

Your turn 1.1: Run the command below in the console.

1 + 1

Or we can use an R script. To run a command line, we place the cursor on the line you want to run, and then either:

  • Click on the run button on top of the panel
  • Use Ctrl + Enter (Windows/Linux) or Cmd + Enter (MacOS).

We can also highlight multiple lines at once and run them at once.

Your turn 1.2: Create a script from the top menu in RStudio: File > New File > R Script, then type the command below in the script and run it with one or the two options.

2 + 2

ⓘ Using a script is recommended practice
If we work in the console, we do not have a good record (recipe) of what we have done. It is good practice to use an R script to be able to re-use the code and remember what we have done in the past.

Commenting

Comments are notes to ourself or others about the commands in the script. They are useful also when you share code with others. Comments start with a # which tells R not to run them as commands.

# testing R
2 + 2

Keeping an accurate record of how you’ have manipulated your data is important for reproducible research. Writing detailed comments and documenting your work are useful reminders to your future self (and anyone else reading your scripts) on what your code does.

In Section 8 we describe how to use Rmarkdown to create reproducible and beautiful analysis reports. You will use our R markdown template in the exercise.

Working directory

Opening an RStudio session launches it from a specific location. This is the ‘working directory’.

R looks in the working directory by default to read in data and save files. You can find out what the working directory is by using the command getwd(). This shows you the path to your working directory in the console. It will be in this format: /path/to/working/directory (Mac) or C:\path\to\working\directory (Windows). We recommend your data and R scripts in the same directory.

To define the working directory, in RStudio click in the menu on Session > Set Working Directory > Choose directory and choose your folder.

Your turn 1.3: Create a folder for this course somewhere on your computer. Name the folder for example, Intro_R_course. Then, to set this folder as your working directory. Set your working directory as indicated above, then click ‘Open’. The files tab will now show the contents of your new folder.

Your turn 1.4: Save the script you created in the previous section as intro.R in this directory. You can do this by clicking on File > Save and the default location should be the current working directory (e.g. Intro_R_course).

R Packages or libraries

A package is a collection of functions along with documentation, code, tests and example data created by R developers who wish to share their methods and code to others. Often these packages are not installed by default on your computer.

We use the following command line to install a package:

install.packages("tidyverse")

We then load the package in our working directory:

library(tidyverse)

2. Packages in the CRAN or Bioconductor

Packages hosted on the CRAN (stands for Comprehensive R Archive Network) are often generic package for all sorts of data and analysis. Bioconductor is an ecosystem that hosts packages specifically dedicated to biological data. The installation of packages is a bit different, e.g to install the mixOmics package we type:

if (!require("BiocManager", quietly = TRUE))
    install.packages("BiocManager")

BiocManager::install("mixOmics")

You dont need to remember this command line, as it is featured in the Bioconductor package page (see here for example).

One advantage of Bioconductor packages is that they are well documented, updated and maintained every six months.

Here is how the example vignette looks like:

library(mixOmics)
browseVignettes("mixOmics")

R functions

In mathematics, a function defines a relation between inputs and output. In R (and coding languages) it is the same. A function takes several inputs called arguments inside parentheses, and output some results.

Your turn 2.1: Compare these two outputs. In the second line we use the function sum.

2+2
sum(2,2)

Operation assignment

It is useful to store data or result so that we can use them later on for other parts of the analysis. We can use either the operator = or <-. In both cases the object where we store the result is on the left-hand-side, and the result from the operation is on the right-hand-side.

Your turn 2.2: Compare the two outputs.

result1 = 2+2
result1

result2 <- 2+3
result2

ⓘ Nomenclature of objects

We recommend you use explicit naming conventions of your objects, for example data.raw1 and data.normalised rather than data1 and data2 so that you can remember various steps in your analysis.

I need help!

To see what any function in R does, type a ? before the name and help information will appear in the Help panel on the right in RStudio.

?sum

What is really important is to scroll down the examples to understand how the function can be used in practice. You can use this command line to run the examples:

example(sum)

Google and Stack Overflow are also useful resources for getting help.

Common R errors

R error messages are common and often cryptic. You most likely will encounter at least one error message during this tutorial. Some common reasons for errors are:

  • Case sensitivity. In R, as in other programming languages, case sensitivity is important. ?install.packages is different to ?Install.packages.
  • Missing commas
  • Mismatched parentheses or brackets or unclosed parentheses, brackets or apostrophes
  • Not quoting file paths
  • When a command line is unfinished, the “+” in the console will indicate it is awaiting further instructions. Press ESC to cancel the command.

To see examples of some R error messages with explanations see here

3. Let’s get started with data!

In this tutorial, we will learn some R through creating plots to visualise data from an RNA-seq experiment.

The GREIN platform (GEO RNA-seq Experiments Interactive Navigator) provides >6,500 published datasets from GEO that have been uniformly processed. It is available at http://www.ilincs.org/apps/grein/. You can search for a dataset of interest using the GEO code. GREIN provide QC metrics for the RNA-seq datasets and both raw and normalized counts. We will use the normalized counts here. These are the counts of reads for each gene for each sample normalized for differences in sequencing depth and composition bias. Generally, the higher the number of counts the more the gene is expressed.

RNA-seq dataset form Fu et al.

Here we will create some plots using RNA-seq data from the paper by Fu et al. 2015, GEO code GSE60450. This study examined expression in basal and luminal cells from mice at different stages (virgin, pregnant and lactating). There are 2 samples per group and 6 groups, 12 samples in total.

Tidyverse package

The tidyverse package is a collection of R packages that includes the extremely widely used ggplot2 package.

The tidyverse makes data science faster, easier and more fun.

Load the package

We use library() to load in the packages that we need. As described in the cooking analogy in the first screenshot, install.packages() is like buying a saucepan, library() is taking it out of the cupboard to use it.

Your turn 3.1: Load your tidyverse library. If you get an error message, it means that you have not installed it! (see the code in the Section 2).

library(tidyverse)

Load the data

The files we will use are csv comma-separated, so we will use the read_csv() function from the tidyverse. There is also a read_tsv() function for tab-separated values.

Your turn 3.2: Download the data.zip file here. Unzip the file and store the content in the data folder in your working directory.

We will use the counts file called GSE60450_GeneLevel_Normalized(CPM.and.TMM)_data.csv stored in the data folder. The path to the file should be data/GSE60450_GeneLevel_Normalized(CPM.and.TMM)_data.csv.

Your turn 3.3: Load the data into your R working directory. We will store the contents of the counts file in an object called counts.

# read in counts file
counts <- read_csv("data/GSE60450_GeneLevel_Normalized(CPM.and.TMM)_data.csv")
## New names:
## Rows: 23735 Columns: 14
## ── Column specification
## ──────────────────────────────────────────────────────── Delimiter: "," chr
## (2): ...1, gene_symbol dbl (12): GSM1480291, GSM1480292, GSM1480293,
## GSM1480294, GSM1480295, GSM148...
## ℹ Use `spec()` to retrieve the full column specification for this data. ℹ
## Specify the column types or set `show_col_types = FALSE` to quiet this message.
## • `` -> `...1`
# read in metadata
sampleinfo <- read_csv("data/GSE60450_filtered_metadata.csv")
## New names:
## Rows: 12 Columns: 4
## ── Column specification
## ──────────────────────────────────────────────────────── Delimiter: "," chr
## (4): ...1, characteristics, immunophenotype, developmental stage
## ℹ Use `spec()` to retrieve the full column specification for this data. ℹ
## Specify the column types or set `show_col_types = FALSE` to quiet this message.
## • `` -> `...1`

No need to be overwhelmed by the outputs! It contains information regarding “column specification” (telling us that there is a missing column name in the header and it has been filled with the name “…1”, which is how read_csv handles missing column names by default). We will fix this later. It also tells us what data types read_csv is detecting in each column. Columns with text characters have been detected (col_character) and also columns with numbers (col_double). We won’t get into the details of R data types in this tutorial but they are important to know when you get more proficient in R. You can read more about them in the R for Data Science book.

4. Looking at the data

When assigning a value to an object, R does not print the value. We do not see what is in counts or sampleinfo. But there are ways we can look at the data.

Your turn 4.1: Option 1: Click on the counts object in your global environment panel on the right-hand-side of RStudio. It will open a new Tab.

Your turn 4.2: Option 2: type the name of the object and this will print the first few lines and some information, such as number of rows.

sampleinfo

We can also use dim() to see the dimensions of an object, the number of rows and columns.

We can also take a look the first few lines with head(). This shows us the first 6 lines.

head(sampleinfo)

We can look at the last few lines with tail(). This shows us the last 6 lines. This can be useful to check the bottom of the file, that it looks ok.

tail(sampleinfo)

Dimension of the data

It is very useful to check that what you have read in R corresponds to the number of lines and columns of the data.

Your turn 4.3: Check how many rows and columns are in sampleinfo.

dim(sampleinfo)

This show us there are 12 rows and 4 columns.

In the Environment Tab in the top right panel in RStudio we can also see the number of rows and columns in the objects we have in our session.

Column and row names of the data

Your turn 4.4: Check the column and row names used in in sampleinfo. Comment on the results you get.

colnames(sampleinfo)
rownames(sampleinfo)

The $ symbol

We can access individual columns by name using the $ symbol. For example:

sampleinfo$characteristics

Subsetting

Subsetting is very important in R to extract parts of the data you want to analyse. In R, a data set has the form of a matrix with rows and columns. You can access these rows, or columns by adding brackets.

For example, here we extract the first row ‘1’ of the data, as indicated on the left-hand-side of the colon:

sampleinfo[1,]

Here we extract the firsecond column ‘2’ of the data, as indicated on the right-hand-side of the colon:

sampleinfo[,2]

You can use a combination of number of row and column to extract one element in the matrix:

sampleinfo[1,2]

Your turn 4.5: Work out what the following commands mean, then include those to subset sampleinfo (either on the rows or the columns):

1:3
c(1, 3)

ⓘ The c() function

We use this function extremely often in R when we have multiple items that we are combining (‘c’ stands for concatening). We will see it again in this tutorial.

In the previous section, when we loaded in the data from the csv file, we noticed that the first column had a missing column name and by default, read_csv function assigned a name of “...1” to it. We can change this column to something more descriptive by combining what what we have learnt.

Your turn 4.6: Describe what the next command line is doing:

colnames(sampleinfo)[1] <- "sample_id"
# check
sampleinfo

Your turn 4.7: Do the same to rename the first column name from “...1” to “gene_id” in counts.

Other useful commands: str and summary

str() shows us the structure of our data. It shows us what columns there are, the first few entries, and what data type they are e.g. character or numbers (double or integer).

str(sampleinfo)

summary() generates summary statistics of our data. For numeric columns (columns of type double or integer) it outputs statistics such as the min, max, mean and median. We will demonstrate this with the counts file as it contains numeric data. For character columns it shows us the length (how many rows).

summary(counts)

ⓘ Multiple methods
There are multiple ways to do things in R. For example we used the function colnames in the prevous exercise, but we could have used the rename() function. When programming, you will often find many ways to do the same thing. Often there is one obvious method depending on the context.

5. Formatting data

Converting from wide to long format

We will first convert the data from wide format into long format to make it easier to work with and plot with the ggplot package.

Instead of multiple columns with counts for each sample, we just want one column containing all the expression values, as shown below:

We can use pivot_longer() to easily change the format into long format.

seqdata <- pivot_longer(counts, cols = starts_with("GSM"), names_to = "Sample", 
                        values_to = "Count")

Explanation: We use cols = starts_with("GSM") to tell the function we want to reformat the columns whose names start with “GSM”. pivot_longer() will then reformat the specified columns into two new columns, which we’re naming “Sample” and “Count”. The names_to = "Sample" specifies that we want the new column containing the columns we sepcified with cols to be named “Sample”, and the values_to = "Count" specifies that we want the new column contining the values to be named “Count”.

We could also specify a column range to reformat. The command below would give us the same result as the previous command.

seqdata <- pivot_longer(counts, cols = GSM1480291:GSM1480302, 
                        names_to = "Sample", values_to = "Count")

Alternatively, we could specify the columns we do not want to reformat and pivot_longer() will reformat all the other columns. To do that we put a minus sign “-” in front of the column names that we don’t want to reformat. This is a pretty common way to use pivot_longer() as sometimes it is easier to exclude columns we don’t want than include columns we do. The command below would give us the same result as the previous command.

seqdata <- pivot_longer(counts, cols = -c("gene_id", "gene_symbol"), 
                        names_to = "Sample", values_to = "Count")

Your turn 5.1: Type each command line above, then look at the data. Check their dimension (dim()) and length (length())

seqdata

Joining two tables

Now that we’ve got just one column containing sample ids in both our counts and metadata objects we can join them together using the sample ids. This will make it easier to identify the categories for each sample (e.g. if it’s basal cell type) and to use that information in our plots.

Explanation: We use the function full_join() and give as arguments the two tables we want to join. We add by = join_by(Sample == sample_id) to say we want to join on the column called “Sample” in the first table (seqdata) and the column called “sample_id” in the second table (sampleinfo) when the values match:

allinfo <- full_join(seqdata, sampleinfo, by = join_by(Sample == sample_id))

Your turn 5.2: Examine the code above, run and then look at the data.

6. Plotting with ggplot2

ggplot2 is a plotting package that makes it simple to create complex plots. One really great advantage compared to classic R packages is that we only need to make minimal changes if the underlying data change or if we decide to change our plot type, for example, from a box plot to a violin plot. This helps in creating publication quality plots with minimal amounts of adjustments and tweaking.

ggplot2 likes data in the ‘long’ format, i.e., a column for every variable, and a row for every observation, similar to what we created with pivot_longer() above. Well-structured data will save you lots of time when making figures with ggplot2.

ⓘ Ggplot architecture

Ggplot graphics are built step by step by adding new elements using the +. Adding layers in this fashion allows for extensive flexibility and customization of plots.

To build a ggplot, we use the following basic template that can be used for different types of plots. Three things are required for a ggplot:

  1. The data
  2. The columns in the data we want to map to visual properties (called aesthetics or aes) e.g. the columns for x values, y values and colours
  3. The type of plot (the geom_)

There are different geoms we can use to create different types of plot e.g. geom_line() geom_point(), geom_boxplot(). To see the geoms available take a look at the ggplot2 help or the handy ggplot2 cheatsheet. Or if you type “geom” in RStudio, RStudio will show you the different types of geoms you can use.

Creating a boxplot

Let’s plot boxplots to visualise the distribution of the counts for each sample. This helps us to compare the samples and check if any look unusual.

Note: with ggplot the “+” must go at the end of the line, it can’t go at the beginning.

Your turn 6.1: Run the following command line. Identify the key functions aes and type of plot:

ggplot(data = allinfo, mapping = aes(x = Sample, y = Count)) + 
  geom_boxplot()

This plot looks a bit weird. It’s because we have some genes with extremely high counts. To make it easier to visualise the distributions we usually plot the logarithm of RNA-seq counts. We’ll plot the Sample on the X axis and log~ 2~ Counts on the y axis. We can log the Counts within the aes(). The sample labels are also overlapping each other, we will show how to fix this later.

ggplot(data = allinfo, mapping = aes(x = Sample, y = log2(Count))) + 
  geom_boxplot()
## Warning: Removed 84054 rows containing non-finite values (`stat_boxplot()`).

We get a warning here about rows containing non-finite values being removed. This is because some of the genes have a count of zero in the samples and a log of zero is undefined. We can add +1 to every count to avoid the zeros being dropped (‘psuedo-count’).

ggplot(data = allinfo, mapping = aes(x = Sample, y = log2(Count + 1))) + 
  geom_boxplot()

The box plots show that the distributions of the samples are not identical but they are not very different.

Violin plot

Your turn 6.2: Boxplots are useful summaries, but hide the shape of the distribution. For example, if the distribution is bimodal, we would not see it in a boxplot. An alternative to the boxplot is the violin plot, where the shape (of the density of points) is drawn.

Let’s choose a different geom to do another type of plot. Using the same data (same x and y values), try editing the code above to make a violin plot using the geom_violin() function.

Colouring by categories

Let’s add a different colour for each sample.

Your turn 6.3: Get the help file for geom_boxplot and scroll down to Aesthetics heading. It specifies that there is an option for colour.

In the code below we specify we want to map the Sample column to colour =. As we are mapping colour to a column in our data we need to put this inside the aes().

ggplot(data = allinfo, mapping = aes(x = Sample, y = log2(Count + 1), colour = Sample)) + 
  geom_boxplot()

Colouring the edges wasn’t quite what we had in mind. Look at the help for geom_boxplot to see what other aesthetic we could use. Let’s try fill = instead.

ggplot(data = allinfo, mapping = aes(x = Sample, y = log2(Count + 1), fill = Sample)) + 
  geom_boxplot()

That looks better. fill = is used to fill in areas in ggplot2 plots, whereas colour = is used to colour lines and points.

A really nice feature about ggplot is that we can easily colour by another variable by simply changing the column we give to fill =.

Creating subplots for each gene using faceting

With ggplot we can easily make subplots using faceting. For example we can make stripcharts. These are a type of scatterplot and are useful when there are a small number of samples (when there are not too many points to visualise). Here we will make stripcharts plotting expression by the groups (basal virgin, basal pregnant, basal lactating, luminal virgin, luminal pregnant, luminal lactating) for each gene.

Shorter category names

First we use the function mutate() to add a column with shorter group names to use in the plot, as the group names in the characteristics column are quite long.

Your turn 6.4: Run the code below, then look at the data using the head() function. What haschanged?

allinfo <- mutate(allinfo, Group = case_when(
        str_detect(characteristics, "basal.*virgin") ~  "bvirg",
        str_detect(characteristics, "basal.*preg")  ~  "bpreg",
        str_detect(characteristics, "basal.*lact")  ~  "blact",
        str_detect(characteristics, "luminal.*virgin")  ~  "lvirg",
        str_detect(characteristics, "luminal.*preg")  ~  "lpreg",
        str_detect(characteristics, "luminal.*lact")  ~  "llact"
       ))

Filter for genes of interest

We choose 8 genes with the highest counts summed across all samples. The are listed here:

mygenes <- c("Csn1s2a", "Csn1s1", "Csn2", "Glycam1", "COX1", "Trf", "Wap", "Eef1a1")

We filter our data for just these genes of interest. We use %in% to check if a value is in a set of values.

mygenes_counts <- filter(allinfo, gene_symbol %in% mygenes)

Your turn 6.5: Run the code above and look at mygenes_counts, what did it do?

To identify these 8 genes, we used pipes (%>%) to string a series of function calls together (which is beyond the scope of this tutorial, but totally worth learning about independently!).

mygenes <- allinfo %>%  
  group_by(gene_symbol) %>%  
  summarise(Total_count = sum(Count)) %>%  
  arrange(desc(Total_count)) %>%  
  head(n = 8) %>%  
  pull(gene_symbol)

Faceting

Explanation: We facet on the gene_symbol column using facet_wrap(). We add the tilde symbol ~ in front of the column we want to facet on.

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), fill = Group)) +
  geom_boxplot() +
  facet_wrap(~ gene_symbol)

Plotting individual points as scatterplot

However, the boxplots are not very informative as we only have two values per group. Let’s plot the individual points instead using the geom_point() to make a scatterplot.

ggplot(data = mygenes_counts, mapping = aes(x = Group, y = log2(Count + 1))) +
  geom_point() +
  facet_wrap(~ gene_symbol)

Jitter plot

The points are overlapping so we will make a jitter plot using geom_jitter() which adds a small amount of random variation to the location of each point so they do not overlap. If is also quite common to combine jitter plots with other types of plot, for example, jitter with boxplot.

ggplot(data = mygenes_counts, mapping = aes(x = Group, y = log2(Count + 1))) +
  geom_jitter() +
  facet_wrap(~ gene_symbol)

We can colour the groups similar to before using colour =.

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol)

7. Saving plots

We can save plots interactively by clicking Export in the Plots window and saving as e.g. “myplot.pdf”. Or we can output plots to pdf using pdf() followed by dev.off(). We put our plot code after the call to pdf() and before closing the plot device with dev.off().

Your turn 7.1: Let’s save our last plot.

pdf("myplot.pdf")
ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol)
dev.off()

8. R Markdown for reproducible reports

R markdown is a great tool embedded in RStudio that will produce reproducible and very neat reports.

R Markdown is a specific type of file format (.Rmd) designed to produce documents that include both code and text. We use it in place of the R script, as you will see in the exercises below.

Your turn 8.1: Download the Rmarkdown template here. Copy the content of this folder into your Working directory.

ⓘ Folder organisation with R Markdown
The working directory should look like this:

  • a folder where we store the data
  • a folder where the figures from the report will be saved
  • the report in .Rmd (this is what we will work with)
  • the rendered report in .pdf

Your turn 8.2: Together, let’s go through the different steps of compiling the .Rmd file to produce a .pdf report.

A good place to start with RMarkdown is with this cheatsheet.

9. Main exercises

Choose one of the two following exercise, or use your own data to practice how to input them into R and make a few plots (exercise 1).

Exercise 1: plotting

Here we will work on the RNA-seq data from Fu et al. However, feel free to upload your own data instead and apply your new learning!

  1. The raw counts for the RNA-seq data are available in the data folder with the name ‘GSE60450_GeneLevel_Raw_data.csv’.
  1. Plot a boxplot. Do the samples look any different to the normalised counts?
  2. Make subplots for the same set of 8 genes. Do they look any different to the normalised counts?
  1. The normalised counts for another data set ‘GSE63310_GeneLvel_Normalized(CPM.an.TMM)_data.csv’ are also available. Plot boxplots and violin plots colouring the samples using different columns in the metadata file.

Exercise 2: reading data, cleaning and reformatting

This exercise is useful to apply your learnings on how to wrangle data (a step that is often overlooked but takes a long time!)

  1. We will look at the ‘breast_tumors.csv’, ‘gene_description.txt’ and ‘gene_name.xlsx’ data files, then read each file using one of the appropriate function read_csv(), read_tsv() or read_excel() (from the package readxl). Name each file appropriately. *Note: you will need to load the package readxl first.

  2. Extract the treatment variable from breast_tumor.csv, inspect and solve issues in this file (hint: there are some labelling inconsistencies).

  3. Combine the data from ‘gene_name.xlsx’ and ‘gene_description.txt’

10. Session Info

At the end of your report, we recommend you run the sessionInfo() function which prints out details about your working environment such as the version of R yo are running, loaded packages, and package versions. Printing out sessionInfo() at the end of your analysis is good practice as it helps with reproducibility in the future.

sessionInfo()
## R version 4.3.1 (2023-06-16)
## Platform: x86_64-apple-darwin20 (64-bit)
## Running under: macOS Ventura 13.2.1
## 
## Matrix products: default
## BLAS:   /Library/Frameworks/R.framework/Versions/4.3-x86_64/Resources/lib/libRblas.0.dylib 
## LAPACK: /Library/Frameworks/R.framework/Versions/4.3-x86_64/Resources/lib/libRlapack.dylib;  LAPACK version 3.11.0
## 
## locale:
## [1] en_US.UTF-8/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8
## 
## time zone: Australia/Melbourne
## tzcode source: internal
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
##  [1] lubridate_1.9.2 forcats_1.0.0   stringr_1.5.0   dplyr_1.1.3    
##  [5] purrr_1.0.2     readr_2.1.4     tidyr_1.3.0     tibble_3.2.1   
##  [9] ggplot2_3.4.3   tidyverse_2.0.0
## 
## loaded via a namespace (and not attached):
##  [1] bit_4.0.5         gtable_0.3.4      jsonlite_1.8.7    crayon_1.5.2     
##  [5] compiler_4.3.1    tidyselect_1.2.0  parallel_4.3.1    jquerylib_0.1.4  
##  [9] scales_1.2.1      yaml_2.3.7        fastmap_1.1.1     R6_2.5.1         
## [13] labeling_0.4.3    generics_0.1.3    knitr_1.44        munsell_0.5.0    
## [17] bslib_0.5.1       pillar_1.9.0      tzdb_0.4.0        rlang_1.1.1      
## [21] utf8_1.2.3        stringi_1.7.12    cachem_1.0.8      xfun_0.40        
## [25] sass_0.4.7        bit64_4.0.5       timechange_0.2.0  cli_3.6.1        
## [29] withr_2.5.1       magrittr_2.0.3    digest_0.6.33     grid_4.3.1       
## [33] vroom_1.6.4       rstudioapi_0.15.0 hms_1.1.3         lifecycle_1.0.3  
## [37] vctrs_0.6.3       evaluate_0.22     glue_1.6.2        farver_2.1.1     
## [41] fansi_1.0.4       colorspace_2.1-0  rmarkdown_2.25    tools_4.3.1      
## [45] pkgconfig_2.0.3   htmltools_0.5.6

11. Key Points

  • Tabular data can be loaded into R with the tidyverse functions read_csv() and read_tsv()
  • Tidyverse functions such as pivot_longer(), mutate(), filter(), select(), full_join() can be used to manipulate data
  • A ggplot2 plot has 3 components: data (dataset), mapping (columns to plot) and geom (type of plot). Different types of plots include geom_point(), geom_jitter(), geom_line(), geom_boxplot(), geom_violin().
  • facet_wrap() can be used to make subplots of the data
  • The aesthetics of a ggplot can be modified, such as colouring by different columns in the dataset, adding labels or changing the background.
  • R markdown is a useful tool for reproducible analyses and reporting.
  • Don’t forget to practice on subsetting, checking the dimension of the data, extracting and amending the names of the rows and columns of your data.

Extra material: Customising the plot

Specifying colours

We might want to change the colours. To see what colour names are available you can type colours(). There is also an R colours cheatsheet that shows what the colours look like.

mycolours <- c("turquoise", "plum", "tomato", "violet", "steelblue", "chocolate")

Then we then add these colours to the plot using a + and scale_colour_manual(values = mycolours).

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  scale_colour_manual(values = mycolours)

There are built-in colour palettes that can be handy to use, where the sets of colours are predefined. scale_colour_brewer() is a popular one (there is also scale_fill_brewer()). You can take a look at the help for scale_colour_brewer() to see what palettes are available. The R colours cheatsheet also shows what the colours of the palettes look like. There’s one called “Dark2”, let’s have a look at that.

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  scale_colour_brewer(palette = "Dark2")

Axis labels and Title

We can change the axis labels and add a title with labs(). To change the x axis label we use labs(x = "New name"). To change the y axis label we use labs(y = "New name") or we can change them all at the same time.

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  labs(x = "Cell type and stage", y = "Count", title = "Mammary gland RNA-seq data")

Themes

We can adjust the text on the x axis (the group labels) by turning them 90 degrees so we can read the labels better. To do this we modify the ggplot theme. Themes are the non-data parts of the plot.

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  labs(x = "Cell type and stage", y = "Count", title = "Mammary gland RNA-seq data") +
  theme(axis.text.x = element_text(angle = 90))

We can remove the grey background and grid lines.

There are also a lot of built-in themes. Let’s have a look at a couple of the more widely used themes. The default ggplot theme is theme_grey().

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  labs(x = "Cell type and stage", y = "Count", title = "Mammary gland RNA-seq data") +
  theme_bw() +
  theme(axis.text.x = element_text(angle = 90))

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  labs(x = "Cell type and stage", y = "Count", title = "Mammary gland RNA-seq data") +
  theme_minimal() +
  theme(axis.text.x = element_text(angle = 90))

There are many themes available, you can see some in the R graph gallery.

We can also modify parts of the theme individually. We can remove the grey background and grid lines with the code below.

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group, y = log2(Count + 1), colour = Group)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  labs(x = "Cell type and stage", y = "Count", title = "Mammary gland RNA-seq data") +
  theme(axis.text.x = element_text(angle = 90)) +
  theme(panel.background = element_blank(),
        panel.grid.major = element_blank(),
        panel.grid.minor = element_blank())

Order of categories

The groups have been plotted in alphabetical order on the x axis and in the legend (that is the default order), however, we may want to change the order. We may prefer to plot the groups in order of stage, for example, basal virgin, basal pregnant, basal lactate, luminal virgin, luminal pregnant, luminal lactate.

First let’s make an object with the group order that we want.

group_order <- c("bvirg", "bpreg", "blact", "lvirg", "lpreg", "llact")

Next we need to make a column with the groups into an R data type called a factor. Factors in R are a special data type used to specify categories, you can read more about them in the R for Data Science book. The names of the categories are called the factor levels.

We’ll add another column called “Group_f” where we’ll make the Group column into a factor and specify what order we want the levels of the factor.

mygenes_counts <- mutate(mygenes_counts, Group_f = factor(Group, levels = group_order))

Take a look at the data. As the table is quite wide we can use select() to select just the columns we want to view.

select(mygenes_counts, gene_id, Group, Group_f)

Notice that the Group column has <chr> under the heading, that indicates is a character data type, while the Group_f column has <fct> under the heading, indicating it is a factor data type. The str() command that we saw previously is useful to check the data types in objects.

str(mygenes_counts)
## tibble [96 × 9] (S3: tbl_df/tbl/data.frame)
##  $ gene_id            : chr [1:96] "ENSMUSG00000000381" "ENSMUSG00000000381" "ENSMUSG00000000381" "ENSMUSG00000000381" ...
##  $ gene_symbol        : chr [1:96] "Wap" "Wap" "Wap" "Wap" ...
##  $ Sample             : chr [1:96] "GSM1480291" "GSM1480292" "GSM1480293" "GSM1480294" ...
##  $ Count              : num [1:96] 90.2 95.6 4140.3 8414.4 49204.9 ...
##  $ characteristics    : chr [1:96] "mammary gland, luminal cells, virgin" "mammary gland, luminal cells, virgin" "mammary gland, luminal cells, 18.5 day pregnancy" "mammary gland, luminal cells, 18.5 day pregnancy" ...
##  $ immunophenotype    : chr [1:96] "luminal cell population" "luminal cell population" "luminal cell population" "luminal cell population" ...
##  $ developmental stage: chr [1:96] "virgin" "virgin" "18.5 day pregnancy" "18.5 day pregnancy" ...
##  $ Group              : chr [1:96] "lvirg" "lvirg" "lpreg" "lpreg" ...
##  $ Group_f            : Factor w/ 6 levels "bvirg","bpreg",..: 4 4 5 5 6 6 1 1 2 2 ...

str() shows us Group_f column is a Factor with 6 levels (categories).

We can check the factor levels of a column as below.

levels(mygenes_counts$Group_f)
## [1] "bvirg" "bpreg" "blact" "lvirg" "lpreg" "llact"

The levels are in the order that we want, so we can now change our plot to use the “Group_f” column instead of Group column (change x = and colour =).

ggplot(data = mygenes_counts, 
       mapping = aes(x = Group_f, y = log2(Count + 1), colour = Group_f)) +
  geom_jitter() +
  facet_wrap(~ gene_symbol) +
  labs(x = "Cell type and stage", y = "Count", title = "Mammary gland RNA-seq data") +
  theme(axis.text.x = element_text(angle = 90)) +
  theme(panel.background = element_blank(),
        panel.grid.major = element_blank(),
        panel.grid.minor = element_blank())

We could do similar if we wanted to have the genes in the facets in a different order. For example, we could add another column called “gene_symbol_f” where we make the gene_symbol column into a factor, specifying the order of the levels.

Exercise

  1. Make a colourblind-friendly plot using the colourblind-friendly palettes here.

  2. Create a plot (any plot whatsoever) and share it with the class by pasting the image in the Google Docs link provided in your workshop. You plot should use the subtitle argument in the labs function to add a unique identifier (e.g. a message and your name or initials) which is displayed below the title.

Tip: An easy way to copy your plot in RStudio is using the plot pane’s export option and selecting “Copy to Clipboard…”. You can then paste it into the provided Google document.