R.Version()
install.packages("reshape2", verbose = TRUE)
install.packages("RColorBrewer", verbose = TRUE)
install.packages("ggplot2", verbose = TRUE)
install.packages("statmod", verbose = TRUE)
install.packages("gplots", verbose = TRUE)
install.packages("BiocManager", verbose = TRUE)
BiocManager::install(ask = FALSE)
if (!requireNamespace("BiocManager", quietly = TRUE))
install.packages("BiocManager")
BiocManager::install("limma")
BiocManager::install("edgeR")
library(reshape2)
library(limma)
library(edgeR)
library(ggplot2)
library(RColorBrewer)
library(gplots)
library(statmod)
Exchanging this raw data link for another appropiate input table allows you to perform the analysis with that particular data.
counts <- "https://raw.githubusercontent.com/tgstoecker/teaching/master/AppliedBioinformatics/B73/gene-level/total_file.count"
fc_res <- read.table(counts, header = T, row.names = 1)
Check the names of your columns and take a look at your table:
colnames(fc_res)
head(fc_res)
Shorten the column names indicating the samples - e.g.:
colnames(fc_res) <- sub("_trimmed_sorted.bam", "", colnames(fc_res))
colnames(fc_res)
For data exploration and visualization, it is useful to work with transformed versions of count data.
This is because the distribution of count values is usually extremely skewed.
Log2transformation helps to approximately normalize the distribution.
Take a look at your samples and create a histogram - e.g.:
ggplot(fc_res, aes(x = B73_con_1)) +
geom_histogram(binwidth = 2000)
Log base 2 is typically used here as it allows for the conversion back to the original scale:
A difference of 1 on the log base2 scale corresponds to a fold change of 2 on the original count scale.
Since count values for a gene can be zero in some conditions, this results in non-finite values which would be excluded in the plots.
An easy way around this is the use of pseudocounts, e.g. transforming the data by adding e.g. a 1 count everywhere
pseudoCount = log2(fc_res[, 6:13] + 1)
ggplot(pseudoCount, aes(x = B73_con_1)) +
ylab(expression(log[2](count + 1))) +
geom_histogram(colour = "white", binwidth = 1)
Taking a look at the count distribution between samples/replicates counts is useful to assess effects even before filtering and normalization: This can for instance be done with Boxplots In the following we visualize the distribution of the pseoudocounts in all of your samples.
Quick recap on boxplots:
Boxes are formed with sides at the 25-th and 75-th percentiles of the distribution.
The line within a box represents the median.
#ignore message about IDs
df = melt(pseudoCount)
df = data.frame(df, Condition = substr(df$variable,1,nchar(as.character(df$variable))-2))
ggplot(df, aes(x = variable, y = value, fill = Condition)) +
geom_boxplot() + xlab("") +
ylab(expression(log[2](count + 1))) +
scale_fill_manual(values = c("#619CFF", "orchid1")) +
coord_flip()
Pseudocounts distributions can also be summarized by means of a density plot.
ggplot(df, aes(x = value, colour = variable, fill = variable)) +
ylim(c(0, 0.25)) +
geom_density(alpha = 0.2, size = 1.25) +
facet_wrap(~ Condition) +
theme(legend.position = "top") +
xlab(expression(log[2](count + 1)))
Create a vector indicating treatment conditions of the samples
group = c("control", "control", "control", "control", "drought", "drought", "drought", "drought")
group
# create a DGE list object - the core of using edgeR
# For our purposes the DGEList-object should contain matrixes/dataframes of raw counts, group/treatment info as well as gene names
##ignore error warning - Warning message in seq_len(head.end.idx): ...
?DGEList
dge = DGEList(counts = fc_res[, 6:13], group = group, genes = rownames(fc_res))
ls.str()
A plot of log-fold change (M-values) vs the log average (A-values)
M-values = log of the ratio of level counts for each gene between two samples
A-values = the average level counts for each gene across the two samples (higher ~ more trustworthy)
MA-plots are a useful way of visualizing the "reproducibility" between replicates/samples of an experiment.
In other words a MA-plot usually indicates that normalization is needed/ would be appropriate.
In a MA plot, genes with similar expression levels in two samples will appear around the horizontal line (y= 0).
The code also plots a loess fit (in red) - basically a trend in the bias related to the mean expression.
x = pseudoCount$B73_con_1
y = pseudoCount$B73_con_2
## compute M-values
M = x - y
## compute A-values
A = (x + y)/2
df = data.frame(A, M)
p <- ggplot(df, aes(x = A, y = M)) +
geom_point(size = 1.5, alpha = 1/5) +
geom_hline(color = "blue2", yintercept = 0) +
stat_smooth(se = FALSE, method = "loess", color = "red")
p + ggtitle("B73_control_1 vs B73_control_2")
cpm <- cpm(dge)
lcpm <- cpm(dge, log=TRUE)
# checkout the library sizes of your samples
dge$samples
head(dge)
summary(cpm)
B73 based example
A CPM value of 1 for a gene is equal to having 5.8 counts in the sample with the lowest sequencing depth (B73_con_1, lib.size ~ 5.8 million) or 22 counts in the sample with the greatest sequencing depth (B73_con_3, lib.size ~ 22 million).
Log-CPM values are generally very suited for exploratory plots. When you set log=TRUE, the edgeR's cpm function adds an offset to the CPM values before conversion to the log2-scale. With default options, this offset is 2/L where 2 is the “prior count” (or offset) and L is the average lib.size in millions, so in other words: the log-CPM values are related to the CPM values by log2(CPM + 2/L).
Why? With this calculation we can enssure that any two read-counts with identical CPM values will also have identical log-CPM values.
Now, imagine a dataset, which average library size is about 50 million, so L approx. 50 and the minimum log-CPM value for each sample becomes log2(2/50) = -4.644. In other words, a count of zero for this data maps to a log-CPM value of -4.644 after adding the "prior count".
Now check your data/samples:
L <- mean(dge$samples$lib.size) * 1e-6
M <- median(dge$samples$lib.size) * 1e-6
c(L, M)
summary(lcpm)
Removing genes that are lowly expressed RNA-Seq datasets will include a mix of genes, some of them expressed and some which are not. For our purposes it is of interest to examine genes that are expressed in one treatment but not in the other. However some genes could be UNexpressed throughout all samples!
Are there any genes in your 8 samples that fit this scenario?
head(dge$counts)
table(rowSums(dge$counts==0)==8)
Why do we care? Genes that do not have a worthwhile number of reads in any sample should be filtered out of the downstream analyses. Biological reason: Genes not expressed at a biologically relevant level in any of our samples/conditions are uninteresting Statistical reason: removal of low count genes reduces statistical "noise"; more precisely: estimation of the mean-variance relationship is made more precise and also the number of statistical tests which need to be performed in the subsequent steps for differential expression are reduced.
EdgeR has an automatic way to filter our genes, while trying to keep as many as possible which are deemed worthwhile, regarding their counts (it is of course possible to dive deeper and set custom cutoffs etc.). -> for our purposes and most use cases the automatic way is a reasonable choice
Now, how does edgeR go about the filtering? The basic idea is to keep all genes which possess a minimum number of counts in a reasonable number of our samples. CPM values instead of raw counts are used as to not give preference to samples with large library sizes as discussed above. E.g. large lib.size leads to lower CPM cutoff; -> larger library sizes (higher resolution) allow for the exploration of more genes at lower expression levels (Usually the function keeps genes with about 10 or more read counts in enough samples) the cutoff can thus be roughly approximated by: log2(10/M + 2/L)
To sum up: Determining factors are the library sizes of the samples, the minimum required count and the design of the experiment.
For more details see documentation:
?filterByExpr
##ignore error warning - Warning message in seq_len(head.end.idx):
All this already indicates that such filtering is very much experiment specific. But how do we get edgeR/R to understand our data or research question?
This leads us to another necessary step:
With the data in the course we want to find out which genes are differentially expressed between control and drought treatment. A design matrix of our data is easily created using the sample information. note1: in this simple scenario we only need to make use of the group vector, created at the very beginning of this workflow note2: with ~0 we remove the intercept from our 2 level factor, which we treat as two seperate groups; we don't have any interaction in this simple model
design <- model.matrix(~0+group)
design
Design matrices can be much more complex, which (theoretically) allows you to model every well designed experiment e.g. factorial designs, complex interactions and much, much more are possible
Check the column names - these should be your groups of interest?
colnames(design)
Now we combine everything previously mentioned and perform edgeR's automatic filtering. Note how well designed edgeR is - Filtering the DGEList-object this way keeps gene and count info for the retained genes correctly associated.
keep <- filterByExpr(dge, design)
dge_filtered <- dge[keep, , keep.lib.sizes=FALSE]
#the amount of genes after filtering is reduced - how much in your case?
dim(dge_filtered)
All rows without any counts should definitely have been excluded:
table(rowSums(dge_filtered$counts==0)==8)
Data exploration also means visualization, so after so much theory let's plot the density distribution before and after filtering. To brush up your R skills: Take your time, go through the code line by line and try to understand what everything does.
#general setup of the plots
par(mfrow=c(1,2))
lcpm.cutoff <- log2(10/M + 2/L)
# create first plot
lcpm_unfiltered <- cpm(dge, log=TRUE)
nsamples <- ncol(dge)
col <- brewer.pal(nsamples, "Paired")
plot(density(lcpm_unfiltered[,1]), col=col[1], lwd=2, ylim=c(0,0.35), las=2, main="", xlab="")
title(main="A. Raw data", xlab="Log-cpm")
abline(v=lcpm.cutoff, lty=3)
for (i in 2:nsamples){
den <- density(lcpm_unfiltered[,i])
lines(den$x, den$y, col=col[i], lwd=2)
}
legend("topright", row.names(dge$samples), text.col=col, bty="n")
# create second plot
lcpm_filtered <- cpm(dge_filtered, log=TRUE)
plot(density(lcpm_filtered[,1]), col=col[1], lwd=2, ylim=c(0,0.35), las=2, main="", xlab="")
title(main="B. Filtered data", xlab="Log-cpm")
abline(v=lcpm.cutoff, lty=3)
for (i in 2:nsamples){
den <- density(lcpm_filtered[,i])
lines(den$x, den$y, col=col[i], lwd=2)
}
legend("topright", row.names(dge_filtered$samples), text.col=col, bty="n")
You just plotted the density of log-CPM values of all samples before and after filtering! The vertical line in each plot marks the aforementioned, approximated log-CPM threshold used in the filtering step.
Based on the inspection and visualization of our data we can conclude that a good amount of genes within each sample are either un-/verylow-expressed as is indicated by the small and negative logCPM values.
With Normalization systemic differences between samples are removed in order to negate the impact of technical bias (in other words: external factors that are not of biological interest) on the final results as much as possible.
Normalization generally entails that an appropriate baseline is determined; sample counts are then expressed relative to this baseline.
For robust diff. exp. analysis we want to assume that all samples have a similar range and distribution of expression values. We can make use of various normalization approaches to equalise the expression distributions so that all our samples are similar in this aspect across the entire experiment.
Any plot showing the per sample expression distributions, such as a density or boxplot, is useful in determining whether any samples are considerably different to others. Throughout all samples of our data distributions of log-CPM values are already quite similar (as can be seen e.g. in the created density plots)
Nevertheless, we are going to perform normalization by the method of trimmed mean of M-values (TMM) -
With edgeR this can be performed using the calcNormFactors function:
dge_normalized <- calcNormFactors(dge_filtered, method = "TMM")
#have a look at the individual normalization factors of the samples we just created
dge_normalized$samples$norm.factors
head(dge_normalized)
These serve as "scaling factors" for the individual library sizes. For the data used in the course the effect of TMM-normalisation is rather mild, as can be seen with the norm.factors, which are all relatively close to 1.
#Let's plot a comparison of the raw, filtered and normalized sample log-CPM values using boxplots - a.k.a. expression distribution
#general setup of the plots
par(mfrow=c(1,3), mar = c(9, 3, 3, 3))
#first plot - raw
lcpm <- cpm(dge, log=TRUE)
boxplot(lcpm, las=2, col=col, main="")
title(main="Raw data",ylab="Log-cpm")
# second plot - un-normalized but filtered
lcpm_filtered <- cpm(dge_filtered, log=TRUE)
boxplot(lcpm_filtered, las=2, col=col, main="")
title(main="Unnormalized but \n filtered data",ylab="Log-cpm")
# second plot - normalized and filtered
lcpm_normalized <- cpm(dge_normalized, log=TRUE)
boxplot(lcpm_normalized, las=2, col=col, main="")
title(main="Normalized and \n filtered data",ylab="Log-cpm")
As you can see there is not much to see ;)
Thus in order to give a better visual representation of the effects of normalisation, we are going to manually worsen our data a bit.
In the code provided below, counts of the 7th sample are reduced to 5% of their original values, and in the 8th sample they are multiplied to be 5-times larger.
Please feel free to make it even worse!
#Let's repeat the plot (without raw/unfltered data) - but with worsely distributed data - this time concentrating on normalization
dge_filtered_worse <- dge_filtered
dge_filtered_worse$samples$norm.factors <- 1
dge_filtered_worse$counts[,7] <- ceiling(dge_filtered_worse$counts[,1]*0.05)
dge_filtered_worse$counts[,8] <- dge_filtered_worse$counts[,2]*5
#general setup of the plots
par(mfrow=c(1,2))
# first plot - un-normalized and worsened
lcpm_filtered_worse <- cpm(dge_filtered_worse, log=TRUE)
boxplot(lcpm_filtered_worse, las=2, col=col, main="", ylim = c(-5, 15))
title(main="Unnormalized data \n (manually worsened)",ylab="Log-cpm")
#again perform normalization - and take a look at the norm.factors here, especially of all samples you altered!
dge_filtered_worse_normalized <- calcNormFactors(dge_filtered_worse)
dge_filtered_worse_normalized$samples$norm.factors
# second plot - normalized
lcpm_filtered_worse_normalized <- cpm(dge_filtered_worse_normalized, log=TRUE)
boxplot(lcpm_filtered_worse_normalized, las=2, col=col, main="", ylim = c(-5, 15))
title(main="Normalized data",ylab="Log-cpm")
With the modified data the distributions are decidedly different between before compared to after normalization.
Take special note of the TMM scaling factors of the altered samples – neither of the values should be close to 1.
EdgeR uses the negative binomial (NB) distribution to model the read counts for each gene in each sample. The dispersion parameter of the NB distribution accounts for variability between biological replicates - in fact three different kind of dispersions are estimated by edgeR.
#All 3 dispersion estimates can easily be obtained from the estimateDisp function in one command:
dge_disp <- estimateDisp(dge_normalized, design, robust=TRUE)
#By this, to the DGEList object additional components (common.dispersion, etc.) are added, which contain the estimated dispersions.
#The robust=TRUE option is generally recommended as it protects the empirical Bayes estimates against the impact of extreme/outlier genes with
#overproportional large or small individual dispersions.
#Once negative binomial models are fitted and dispersion estimates are obtained, we could start with the differential expression analysis.
#A second layer or extension of methods can be further employed to consider gene-specific variability from both biological/technical sources.
#This is especially reasonable in multifactor experiments and/or when having more than two groups.
#-> quasi-likelihood (QL) methods
#The estimation of QL dispersions is performed using the glmQLFit function:
fit <- glmQLFit(dge_disp, design, robust=TRUE)
#This returns a DGEGLM object (Digital Gene Expression Generalized Linear Model) containing the estimated values of the GLM coefficients for each individual gene.
The next step is to test for differential expression between the experimental groups - in our case control vs drought treatment.
For this, first the "contrast" has to be created, which corresponds to the comparison we are interested in.
# For this we can make use of limma's convenient makeContrasts function:
CvsD <- makeContrasts(groupdrought-groupcontrol, levels=design)
#In subsequent results, a positive log2-fold-change (logFC) will indicate a gene up-regulated in drought compared to control treated plants,
#whereas a negative logFC will indicate a gene more highly expressed in control treated plants.
#EdgeR offers two main kinds of tests - QL F-tests and likelihood ratio tests (LRT).
#We will use the former as they perform stricter error control by accounting for the uncertainty in dispersion estimation:
res <- glmQLFTest(fit, contrast=CvsD)
noteworthy:
Generally speaking, the QL F-test should be used as it far more robust and reliable.
This becomes most apparent when the number of replicates is small.
in even more detail:
LRT is typically used for situations in which a dispersion parameter is not used, e.g., logistic regressions or Poisson models.
However, for negative binomial models, the dispersion parameter needs to be estimated from the same data used to fit the model.
This introduces extra uncertainty into the model fit that is not handled by LRT.
#Returning to the differential expression analysis
#The top diff. exp. genes can be viewed with function topTags:
topTags(res)
In order to control the false discovery rate (FDR), multiple testing correction is performed using the Benjamini-Hochberg method.
Each locus is tested independently - imagine 20,000 tests being performed and alpha is set to P<0.05.
In this case we could expect at least 1,000 DE loci just by chance (0.05 * 20,000)!
Thus in order to control the false discovery rate, we can make use of control algorithms such as the one by Benjamini and Hochberg.
for a detailed explanation you can have look at: http://www.biostathandbook.com/multiplecomparisons.html
is.de <- decideTestsDGE(res, adjust.method = "BH")
#summary of the object gives us the amount of diff. exp. genes and also whether they are up/downregulated between conditions
summary(is.de)
#Now, using the res object we can add other parameters/cutoffs - by viewing/extracting subsets - thereby determining the set set of genes we are interested in
#and extracting all relevant information
#e.g. creating a TopTags object with all genes and information on fold changes and p-/q-values
check <- topTags(res, adjust.method = "BH", n = "all")
sum(check$table$logFC < 0 & check$table$FDR < 0.05)
sum(check$table$logFC > 0 & check$table$FDR < 0.05)
subset(check$table, logFC < 0 & FDR < 0.05)
subset(check$table, logFC > 0 & FDR < 0.05)
#or create lists of upregulated and downregulated genes - from drought perspective
edgeR_all_sig_genes <- subset(check$table, FDR < 0.05)$genes
up_drought <- subset(check$table, logFC > 0 & FDR < 0.05)$genes
down_drought <- subset(check$table, logFC < 0 & FDR < 0.05)$genes
The magnitude of the differential expression changes can be visualized with a fitted model MD plot.
in other words:
we visualize the log-fold change and average abundance of each gene.
Significantly up and down regulated, differentially expressed genes are highlighted in red and blue, respectively.
Some genes posess high fold changes but are deemed unsignificant due the p-/q-value cutoff/s - e.g. in case of 1 extreme outlier replicate.
plotMD(res, status=is.de, values=c(1,-1), col=c("red","blue"),
legend="topright")
#The easiest way to do this is to add further cutoffs to our subset function
subset(check$table, logFC < -1 & FDR < 0.05)
subset(check$table, logFC > 1 & FDR < 0.05)
Sidenote:
However, if one was to identify very high numbers of differentially expressed genes and wanted to apply more strict methods (in order to shorten the list to
those that are biologically more relevant) there exists a better alternative to simply applying cutoffs.
Namely, via the use of a more strict model than that used by glmQLFTest.
This is due to glmQLFTest identifying differential expression based on statistical significance regardless of how small the difference might be.
Using the glmTreat function one can directly perform tests which detect expression changes greater than a specified threshold.
Heatmaps are a very handy way to display differential expression results.
First convert the read counts into log2-counts-per-million (lcpm) values, as we also did in the beginning of script.
#Running dev.off and repeating the code, helps when error messages appear; e.g. if creating heatmap of big size (gene number)
lcpm <- cpm(dge_normalized, log=TRUE, prior.count = 1)
colnames(lcpm) <- paste(dge_normalized$samples$group, 1:4, sep="-")
#Using a heatmap we can display the gene expression pattern across all the samples.
#First we select the log2 CPM values for the 2000 top diff. exp. genes based on their p-values as computed in the diff. exp. test
#(using all/too many genes may result in your R session crashing depending on the system you are running on):
o <- order(res$table$PValue)
lcpm <- lcpm[o[1:200],]
#lcpm <- lcpm[1:30,]
#We produce a heatmap via the coolmap function:
coolmap(lcpm, cluster.by = "de pattern", margins=c(8,8))
Coolmap is a great choice since the default clustering metrics are chosen to be appropriate for expression data.
-> It will automatically standardize the expression values
Some notes on interpretation of the colour coded Z-scores:
Simply put, a Z-score represents the number of standard deviations from the mean value of the reference population/all samples.
Z-scores thus inform you where the score lies on a normal distribution curve.
Scores close to zero indicate that the values are exactly average while a score of e.g. +2 tells you that the value is much higher than average.
Genes are clustered by correlation (highly correlated genes are closest).
Samples are clustered, based on Euclidean distance between the expression values of the samples.
Replicate samples from each group should thus be clustered together.
Volcano plots allow for the visual summarization of both fold-change and statistical significance (generally p-values).
We will create a scatter-plot of the negative (log10 transformed) p-values of our diff. exp. test (y-axis) against the log2 fold change (x-axis).
Even before plotting we can think about where the regions of interest in such a graph are:
Points at the top of the plot possess small p-values thus being highly significant.
Points being far away from the center (left or right) display the largest fold changes.
## Let's start of by defining cutoffs for both the p-values and the log2 fold changes, e.g.:
lfc = 1
pval = 0.05
#We then create a smaller dataframe that contains our transformed p-values and the log2 fold changes of the respective genes:
tab = data.frame(logFC = res$table$logFC, negLogPval = -log10(res$table$PValue))
head(tab)
#next, we plot the basics
par(mar = c(5, 4, 4, 4))
plot(tab, pch = 16, cex = 0.6,
xlab = expression(log[2]~fold~change),ylab = expression(-log[10]~pvalue),
xlim = c(-4,4))
#This already quite good and informative but we can still greatly improve it
signGenes = (abs(res$table$logFC) > lfc & tab$negLogPval > -log10(pval))
points(tab[signGenes, ], pch = 16, cex = 0.8, col = "red")
abline(h = -log10(pval), col = "green3", lty = 2)
abline(v = c(-lfc, lfc), col = "blue", lty = 2)
mtext(paste("pval =", pval), side = 4, at = -log10(pval), cex = 0.8, line = 0.5, las = 1)
mtext(c(paste("-", lfc, "fold"), paste("+", lfc, "fold")), side = 3, at = c(-lfc, lfc),cex = 0.8, line = 0.5)
Red points indicate all genes having both fold-changes greater than our cutoff (x-axis) and high statistical significance (y-axis).
The green line shows the p-value cutoff with points above the line having a p-value < 0.05 and points below the line having a p-value > 0.05.
The vertical lines in blue colour show 1-fold changes.
Another important takeaway here is that even with base R and a bit of imagination extremely informative plots can be generated!
To make all your future plots and graphs pretty, you can use the following link showcasing all colour option in base R :D http://www.stat.columbia.edu/~tzheng/files/Rcolor.pdf
For some follow-up analyses a transcript-level instead of a gene-level analysis & corresponding results might make more sense or are in fact necessary.
Nevertheless, the following snippet is to demonstrate basic export of specific results for further downstream steps.
The first thing to check is whether or not our data contains infinite fold changes.
This shouldn't be the case because of the way edgeR works - however this is an important detail to keep in mind as software (e.g. MapMan) doesn't know what to do with them.
In other pipelines it might be necessary to transform infinite values to a common number.
#Create an easy to view intermediate file - then inspect it (infinite fold changes?)
desired_subset <- topTags(res, adjust.method = "BH", n = "all")
#Create a subset containing only three columns: Gene ID, log2 fold change and q-value/FDR correction;
#while we're at it, let's keep the column names simple
desired_subset_B73 <- data.frame(desired_subset$table$genes, desired_subset$table$logFC, desired_subset$table$FDR)
colnames(desired_subset_B73) <- c("gene_id", "log2_fold_change", "q_value")
#Write the data to a file - check and choose your working directory and file names - this file will be our input for MapMan
write.table(desired_subset_B73[,c("gene_id", "log2_fold_change", "q_value")], file="/desired_subset_B73.txt", sep="\t", col.names = T, row.names = F)
When using this script using colab, you can find your subset table under the root directory of the virtual machine.
To navigate there use the left sidebar, click on files and move "up" (..) in the filesystem.
Your .txt file should be at the bottom of the overview.