Pathway activity inference from scRNA-seq
24 October 2023
Package
decoupleR 2.8.0
scRNA-seq yield many molecular readouts that are hard to interpret by themselves. One way of summarizing this information is by inferring pathway activities from prior knowledge.
In this notebook we showcase how to use decoupleR for pathway activity
inference with a down-sampled PBMCs 10X data-set. The data consists of 160
PBMCs from a Healthy Donor. The original data is freely available from 10x Genomics
here
from this webpage.
1 Loading packages
First, we need to load the relevant packages, Seurat to handle scRNA-seq data
and decoupleR to use statistical methods.
## We load the required packages
library(Seurat)
library(decoupleR)
# Only needed for data handling and plotting
library(dplyr)
library(tibble)
library(tidyr)
library(patchwork)
library(ggplot2)
library(pheatmap)2 Loading the data-set
Here we used a down-sampled version of the data used in the Seurat
vignette.
We can open the data like this:
inputs_dir <- system.file("extdata", package = "decoupleR")
data <- readRDS(file.path(inputs_dir, "sc_data.rds"))We can observe that we have different cell types:
DimPlot(data, reduction = "umap", label = TRUE, pt.size = 0.5) + NoLegend()
3 PROGENy model
PROGENy is a comprehensive resource
containing a curated collection of pathways and their target genes, with weights
for each interaction. For this example we will use the human weights
(mouse is also available) and we will use the top 100 responsive genes ranked
by p-value. We can use decoupleR to retrieve it from OmniPath:
net <- get_progeny(organism = 'human', top = 100)
net
#> # A tibble: 1,400 × 4
#> source target weight p_value
#> <chr> <chr> <dbl> <dbl>
#> 1 Androgen TMPRSS2 11.5 2.38e-47
#> 2 Androgen NKX3-1 10.6 2.21e-44
#> 3 Androgen MBOAT2 10.5 4.63e-44
#> 4 Androgen KLK2 10.2 1.94e-40
#> 5 Androgen SARG 11.4 2.79e-40
#> 6 Androgen SLC38A4 7.36 1.25e-39
#> 7 Androgen MTMR9 6.13 2.53e-38
#> 8 Androgen ZBTB16 10.6 1.57e-36
#> 9 Androgen KCNN2 9.47 7.71e-36
#> 10 Androgen OPRK1 -5.63 1.11e-35
#> # ℹ 1,390 more rows4 Activity inference with Weighted Mean
To infer activities we will run the Weighted Mean method (wmean). It infers
regulator activities by first multiplying each target feature by its associated
weight which then are summed to an enrichment score wmean. Furthermore,
permutations of random target features can be performed to obtain a null
distribution that can be used to compute a z-score norm_wmean, or a corrected
estimate corr_wmean by multiplying wmean by the minus log10 of the obtained
empirical p-value.
In this example we use wmean but we could have used any other.
To see what methods are available use show_methods().
To run decoupleR methods, we need an input matrix (mat), an input prior
knowledge network/resource (net), and the name of the columns of net that we
want to use.
# Extract the normalized log-transformed counts
mat <- as.matrix(data@assays$RNA@data)
# Run wmean
acts <- run_wmean(mat=mat, net=net, .source='source', .target='target',
.mor='weight', times = 100, minsize = 5)
acts
#> # A tibble: 6,720 × 5
#> statistic source condition score p_value
#> <chr> <chr> <chr> <dbl> <dbl>
#> 1 corr_wmean Androgen AAACATACAACCAC-1 0.00321 0.94
#> 2 corr_wmean Androgen AAACGCTGTTTCTG-1 -0.0147 0.34
#> 3 corr_wmean Androgen AACCTTTGGACGGA-1 0 0.0800
#> 4 corr_wmean Androgen AACGCCCTCGTACA-1 0 0.0200
#> 5 corr_wmean Androgen AACGTCGAGTATCG-1 0.0242 0.140
#> 6 corr_wmean Androgen AACTCACTCAAGCT-1 0.00672 0.0800
#> 7 corr_wmean Androgen AAGATGGAAAACAG-1 0.0250 0.62
#> 8 corr_wmean Androgen AAGATTACCGCCTT-1 0.00849 0.86
#> 9 corr_wmean Androgen AAGCCATGAACTGC-1 0.0314 0.58
#> 10 corr_wmean Androgen AAGGTCTGCAGATC-1 0 0.5
#> # ℹ 6,710 more rows5 Visualization
From the obtained results, we will select the norm_wmean activities and store
them in our object as a new assay called pathwayswmean:
# Extract norm_wmean and store it in pathwayswmean in data
data[['pathwayswmean']] <- acts %>%
filter(statistic == 'norm_wmean') %>%
pivot_wider(id_cols = 'source', names_from = 'condition',
values_from = 'score') %>%
column_to_rownames('source') %>%
Seurat::CreateAssayObject(.)
# Change assay
DefaultAssay(object = data) <- "pathwayswmean"
# Scale the data
data <- ScaleData(data)
data@assays$pathwayswmean@data <- data@[email protected]This new assay can be used to plot activities. Here we visualize the Trail pathway, associated with apoptosis, which seems that in B and NK cells is more active.
p1 <- DimPlot(data, reduction = "umap", label = TRUE, pt.size = 0.5) +
NoLegend() + ggtitle('Cell types')
p2 <- (FeaturePlot(data, features = c("Trail")) &
scale_colour_gradient2(low = 'blue', mid = 'white', high = 'red')) +
ggtitle('Trail activity')
p1 | p2
6 Exploration
We can also see what is the mean activity per group across pathways:
# Extract activities from object as a long dataframe
df <- t(as.matrix(data@assays$pathwayswmean@data)) %>%
as.data.frame() %>%
mutate(cluster = Idents(data)) %>%
pivot_longer(cols = -cluster, names_to = "source", values_to = "score") %>%
group_by(cluster, source) %>%
summarise(mean = mean(score))
# Transform to wide matrix
top_acts_mat <- df %>%
pivot_wider(id_cols = 'cluster', names_from = 'source',
values_from = 'mean') %>%
column_to_rownames('cluster') %>%
as.matrix()
# Choose color palette
palette_length = 100
my_color = colorRampPalette(c("Darkblue", "white","red"))(palette_length)
my_breaks <- c(seq(-2, 0, length.out=ceiling(palette_length/2) + 1),
seq(0.05, 2, length.out=floor(palette_length/2)))
# Plot
pheatmap(top_acts_mat, border_color = NA, color=my_color, breaks = my_breaks) 
In this specific example, we can observe that Trail is more active in B and NK cells.
7 Session information
#> ─ Session info ───────────────────────────────────────────────────────────────────────────────────────────────────────
#> setting value
#> version R version 4.3.1 (2023-06-16)
#> os Ubuntu 22.04.3 LTS
#> system x86_64, linux-gnu
#> ui X11
#> language (EN)
#> collate C
#> ctype en_US.UTF-8
#> tz America/New_York
#> date 2023-10-24
#> pandoc 2.7.3 @ /usr/bin/ (via rmarkdown)
#>
#> ─ Packages ───────────────────────────────────────────────────────────────────────────────────────────────────────────
#> package * version date (UTC) lib source
#> abind 1.4-5 2016-07-21 [2] CRAN (R 4.3.1)
#> backports 1.4.1 2021-12-13 [2] CRAN (R 4.3.1)
#> bibtex 0.5.1 2023-01-26 [2] CRAN (R 4.3.1)
#> BiocManager 1.30.22 2023-08-08 [2] CRAN (R 4.3.1)
#> BiocParallel 1.36.0 2023-10-24 [2] Bioconductor
#> BiocStyle * 2.30.0 2023-10-24 [2] Bioconductor
#> bit 4.0.5 2022-11-15 [2] CRAN (R 4.3.1)
#> bit64 4.0.5 2020-08-30 [2] CRAN (R 4.3.1)
#> bookdown 0.36 2023-10-16 [2] CRAN (R 4.3.1)
#> bslib 0.5.1 2023-08-11 [2] CRAN (R 4.3.1)
#> cachem 1.0.8 2023-05-01 [2] CRAN (R 4.3.1)
#> cellranger 1.1.0 2016-07-27 [2] CRAN (R 4.3.1)
#> checkmate 2.2.0 2023-04-27 [2] CRAN (R 4.3.1)
#> cli 3.6.1 2023-03-23 [2] CRAN (R 4.3.1)
#> cluster 2.1.4 2022-08-22 [3] CRAN (R 4.3.1)
#> codetools 0.2-19 2023-02-01 [3] CRAN (R 4.3.1)
#> colorspace 2.1-0 2023-01-23 [2] CRAN (R 4.3.1)
#> cowplot 1.1.1 2020-12-30 [2] CRAN (R 4.3.1)
#> crayon 1.5.2 2022-09-29 [2] CRAN (R 4.3.1)
#> curl 5.1.0 2023-10-02 [2] CRAN (R 4.3.1)
#> data.table 1.14.8 2023-02-17 [2] CRAN (R 4.3.1)
#> decoupleR * 2.8.0 2023-10-24 [1] Bioconductor
#> deldir 1.0-9 2023-05-17 [2] CRAN (R 4.3.1)
#> digest 0.6.33 2023-07-07 [2] CRAN (R 4.3.1)
#> dplyr * 1.1.3 2023-09-03 [2] CRAN (R 4.3.1)
#> ellipsis 0.3.2 2021-04-29 [2] CRAN (R 4.3.1)
#> evaluate 0.22 2023-09-29 [2] CRAN (R 4.3.1)
#> fansi 1.0.5 2023-10-08 [2] CRAN (R 4.3.1)
#> farver 2.1.1 2022-07-06 [2] CRAN (R 4.3.1)
#> fastmap 1.1.1 2023-02-24 [2] CRAN (R 4.3.1)
#> fastmatch 1.1-4 2023-08-18 [2] CRAN (R 4.3.1)
#> fgsea 1.28.0 2023-10-24 [2] Bioconductor
#> fitdistrplus 1.1-11 2023-04-25 [2] CRAN (R 4.3.1)
#> future 1.33.0 2023-07-01 [2] CRAN (R 4.3.1)
#> future.apply 1.11.0 2023-05-21 [2] CRAN (R 4.3.1)
#> generics 0.1.3 2022-07-05 [2] CRAN (R 4.3.1)
#> ggplot2 * 3.4.4 2023-10-12 [2] CRAN (R 4.3.1)
#> ggrepel * 0.9.4 2023-10-13 [2] CRAN (R 4.3.1)
#> ggridges 0.5.4 2022-09-26 [2] CRAN (R 4.3.1)
#> globals 0.16.2 2022-11-21 [2] CRAN (R 4.3.1)
#> glue 1.6.2 2022-02-24 [2] CRAN (R 4.3.1)
#> goftest 1.2-3 2021-10-07 [2] CRAN (R 4.3.1)
#> gridExtra 2.3 2017-09-09 [2] CRAN (R 4.3.1)
#> gtable 0.3.4 2023-08-21 [2] CRAN (R 4.3.1)
#> hms 1.1.3 2023-03-21 [2] CRAN (R 4.3.1)
#> htmltools 0.5.6.1 2023-10-06 [2] CRAN (R 4.3.1)
#> htmlwidgets 1.6.2 2023-03-17 [2] CRAN (R 4.3.1)
#> httpuv 1.6.12 2023-10-23 [2] CRAN (R 4.3.1)
#> httr 1.4.7 2023-08-15 [2] CRAN (R 4.3.1)
#> ica 1.0-3 2022-07-08 [2] CRAN (R 4.3.1)
#> igraph 1.5.1 2023-08-10 [2] CRAN (R 4.3.1)
#> irlba 2.3.5.1 2022-10-03 [2] CRAN (R 4.3.1)
#> jquerylib 0.1.4 2021-04-26 [2] CRAN (R 4.3.1)
#> jsonlite 1.8.7 2023-06-29 [2] CRAN (R 4.3.1)
#> KernSmooth 2.23-22 2023-07-10 [3] CRAN (R 4.3.1)
#> knitr 1.44 2023-09-11 [2] CRAN (R 4.3.1)
#> labeling 0.4.3 2023-08-29 [2] CRAN (R 4.3.1)
#> later 1.3.1 2023-05-02 [2] CRAN (R 4.3.1)
#> lattice 0.22-5 2023-10-24 [3] CRAN (R 4.3.1)
#> lazyeval 0.2.2 2019-03-15 [2] CRAN (R 4.3.1)
#> leiden 0.4.3 2022-09-10 [2] CRAN (R 4.3.1)
#> lifecycle 1.0.3 2022-10-07 [2] CRAN (R 4.3.1)
#> listenv 0.9.0 2022-12-16 [2] CRAN (R 4.3.1)
#> lmtest 0.9-40 2022-03-21 [2] CRAN (R 4.3.1)
#> logger 0.2.2 2021-10-19 [2] CRAN (R 4.3.1)
#> lubridate 1.9.3 2023-09-27 [2] CRAN (R 4.3.1)
#> magick 2.8.1 2023-10-22 [2] CRAN (R 4.3.1)
#> magrittr 2.0.3 2022-03-30 [2] CRAN (R 4.3.1)
#> MASS 7.3-60 2023-05-04 [3] CRAN (R 4.3.1)
#> Matrix 1.6-1.1 2023-09-18 [3] CRAN (R 4.3.1)
#> matrixStats 1.0.0 2023-06-02 [2] CRAN (R 4.3.1)
#> mime 0.12 2021-09-28 [2] CRAN (R 4.3.1)
#> miniUI 0.1.1.1 2018-05-18 [2] CRAN (R 4.3.1)
#> munsell 0.5.0 2018-06-12 [2] CRAN (R 4.3.1)
#> nlme 3.1-163 2023-08-09 [3] CRAN (R 4.3.1)
#> OmnipathR 3.10.0 2023-10-24 [2] Bioconductor
#> parallelly 1.36.0 2023-05-26 [2] CRAN (R 4.3.1)
#> patchwork * 1.1.3 2023-08-14 [2] CRAN (R 4.3.1)
#> pbapply 1.7-2 2023-06-27 [2] CRAN (R 4.3.1)
#> pheatmap * 1.0.12 2019-01-04 [2] CRAN (R 4.3.1)
#> pillar 1.9.0 2023-03-22 [2] CRAN (R 4.3.1)
#> pkgconfig 2.0.3 2019-09-22 [2] CRAN (R 4.3.1)
#> plotly 4.10.3 2023-10-21 [2] CRAN (R 4.3.1)
#> plyr 1.8.9 2023-10-02 [2] CRAN (R 4.3.1)
#> png 0.1-8 2022-11-29 [2] CRAN (R 4.3.1)
#> polyclip 1.10-6 2023-09-27 [2] CRAN (R 4.3.1)
#> prettyunits 1.2.0 2023-09-24 [2] CRAN (R 4.3.1)
#> progress 1.2.2 2019-05-16 [2] CRAN (R 4.3.1)
#> progressr 0.14.0 2023-08-10 [2] CRAN (R 4.3.1)
#> promises 1.2.1 2023-08-10 [2] CRAN (R 4.3.1)
#> purrr 1.0.2 2023-08-10 [2] CRAN (R 4.3.1)
#> R6 2.5.1 2021-08-19 [2] CRAN (R 4.3.1)
#> RANN 2.6.1 2019-01-08 [2] CRAN (R 4.3.1)
#> rappdirs 0.3.3 2021-01-31 [2] CRAN (R 4.3.1)
#> RColorBrewer 1.1-3 2022-04-03 [2] CRAN (R 4.3.1)
#> Rcpp 1.0.11 2023-07-06 [2] CRAN (R 4.3.1)
#> RcppAnnoy 0.0.21 2023-07-02 [2] CRAN (R 4.3.1)
#> readr 2.1.4 2023-02-10 [2] CRAN (R 4.3.1)
#> readxl 1.4.3 2023-07-06 [2] CRAN (R 4.3.1)
#> RefManageR * 1.4.0 2022-09-30 [2] CRAN (R 4.3.1)
#> reshape2 1.4.4 2020-04-09 [2] CRAN (R 4.3.1)
#> reticulate 1.34.0 2023-10-12 [2] CRAN (R 4.3.1)
#> rlang 1.1.1 2023-04-28 [2] CRAN (R 4.3.1)
#> rmarkdown 2.25 2023-09-18 [2] CRAN (R 4.3.1)
#> ROCR 1.0-11 2020-05-02 [2] CRAN (R 4.3.1)
#> Rtsne 0.16 2022-04-17 [2] CRAN (R 4.3.1)
#> rvest 1.0.3 2022-08-19 [2] CRAN (R 4.3.1)
#> sass 0.4.7 2023-07-15 [2] CRAN (R 4.3.1)
#> scales 1.2.1 2022-08-20 [2] CRAN (R 4.3.1)
#> scattermore 1.2 2023-06-12 [2] CRAN (R 4.3.1)
#> sctransform 0.4.1 2023-10-19 [2] CRAN (R 4.3.1)
#> selectr 0.4-2 2019-11-20 [2] CRAN (R 4.3.1)
#> sessioninfo 1.2.2 2021-12-06 [2] CRAN (R 4.3.1)
#> Seurat * 4.4.0 2023-09-28 [2] CRAN (R 4.3.1)
#> SeuratObject * 4.1.4 2023-09-26 [2] CRAN (R 4.3.1)
#> shiny 1.7.5.1 2023-10-14 [2] CRAN (R 4.3.1)
#> sp 2.1-1 2023-10-16 [2] CRAN (R 4.3.1)
#> spatstat.data 3.0-3 2023-10-24 [2] CRAN (R 4.3.1)
#> spatstat.explore 3.2-5 2023-10-22 [2] CRAN (R 4.3.1)
#> spatstat.geom 3.2-7 2023-10-20 [2] CRAN (R 4.3.1)
#> spatstat.random 3.2-1 2023-10-21 [2] CRAN (R 4.3.1)
#> spatstat.sparse 3.0-3 2023-10-24 [2] CRAN (R 4.3.1)
#> spatstat.utils 3.0-4 2023-10-24 [2] CRAN (R 4.3.1)
#> stringi 1.7.12 2023-01-11 [2] CRAN (R 4.3.1)
#> stringr 1.5.0 2022-12-02 [2] CRAN (R 4.3.1)
#> survival 3.5-7 2023-08-14 [3] CRAN (R 4.3.1)
#> tensor 1.5 2012-05-05 [2] CRAN (R 4.3.1)
#> tibble * 3.2.1 2023-03-20 [2] CRAN (R 4.3.1)
#> tidyr * 1.3.0 2023-01-24 [2] CRAN (R 4.3.1)
#> tidyselect 1.2.0 2022-10-10 [2] CRAN (R 4.3.1)
#> timechange 0.2.0 2023-01-11 [2] CRAN (R 4.3.1)
#> tzdb 0.4.0 2023-05-12 [2] CRAN (R 4.3.1)
#> utf8 1.2.4 2023-10-22 [2] CRAN (R 4.3.1)
#> uwot 0.1.16 2023-06-29 [2] CRAN (R 4.3.1)
#> vctrs 0.6.4 2023-10-12 [2] CRAN (R 4.3.1)
#> viridisLite 0.4.2 2023-05-02 [2] CRAN (R 4.3.1)
#> vroom 1.6.4 2023-10-02 [2] CRAN (R 4.3.1)
#> withr 2.5.1 2023-09-26 [2] CRAN (R 4.3.1)
#> xfun 0.40 2023-08-09 [2] CRAN (R 4.3.1)
#> xml2 1.3.5 2023-07-06 [2] CRAN (R 4.3.1)
#> xtable 1.8-4 2019-04-21 [2] CRAN (R 4.3.1)
#> yaml 2.3.7 2023-01-23 [2] CRAN (R 4.3.1)
#> zoo 1.8-12 2023-04-13 [2] CRAN (R 4.3.1)
#>
#> [1] /tmp/RtmpanCALe/Rinst25088d1cb2a11e
#> [2] /home/biocbuild/bbs-3.18-bioc/R/site-library
#> [3] /home/biocbuild/bbs-3.18-bioc/R/library
#>
#> ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────