Since October 2023, ReactomeGSA was extended to simplify the reuse of public data. As key features, ReactomeGSA can now directly load data from EBI’s ExpressionAtlas, and NCBI’s GREIN. Both of these resources reprocess available public datasets using consistent pipelines.
Additionally, a search function was integrated into ReactomeGSA that can search for datasets simultaneously in all of these supported resources.
The ReactomeGSA R package now also has all required functions to directly access this web-based service. It is thereby possible to search for public datasets directly and download them as ExpressionSet objects.
The ReactomeGSA package can be directly installed from
Bioconductor:
if (!requireNamespace("BiocManager", quietly = TRUE))
install.packages("BiocManager")
if (!require(ReactomeGSA))
BiocManager::install("ReactomeGSA")For more information, see https://bioconductor.org/install/.
The find_public_datasets function uses ReactomeGSA’s web
service to search for public datasets in all supported resources.
By default, the datasets are limited to human studies. This can be
changed by setting the species parameter. The complete list
of available species is returned by the get_public_species
function.
library(ReactomeGSA)
# get all available species found in the datasets
all_species <- get_public_species()
head(all_species)
#> [1] "Aegilops tauschii" "Anas platyrhynchos"
#> [3] "Anolis carolinensis" "Anopheles gambiae"
#> [5] "Arabidopsis lyrata" "Arabidopsis lyrata subsp. lyrata"The search_term parameter takes a single string as an
argument. Words separated by a space are logically combined using an
AND.
# search for datasets on BRAF and melanoma
datasets <- find_public_datasets("melanoma BRAF")
# the function returns the found datasets as a data.frame
datasets[1:4, c("id", "title")]
#> id
#> 1 GSE83592
#> 2 GSE110054
#> 3 GSE100066
#> 4 GSE107370
#> title
#> 1 JQ1 +/- Vemurafenib in BRAF mutant melanoma (A375)
#> 2 Transcriptional responses of melanoma cells to BRAF inhibition
#> 3 Transcriptome sequencing analysis of BRAF-mutant melanoma metastases.
#> 4 Concomitant BCORL1 and BRAF mutations in vemurafenib-resistant melanoma cellsDatasets found through the find_public_datasets function
can subsequently loaded using the load_public_dataset
function.
# find the correct entry in the search result
# this must be the complete row of the data.frame returned
# by the find_public_datasets function
dataset_search_entry <- datasets[datasets$id == "E-MTAB-7453", ]
str(dataset_search_entry)
#> 'data.frame': 1 obs. of 7 variables:
#> $ title : chr "RNA-seq of the human melanoma cell-line A375P treated with the BRAF inhibitor PLX4720 and a DMSO control"
#> $ id : chr "E-MTAB-7453"
#> $ resource_name : chr "EBI Expression Atlas"
#> $ description : chr ""
#> $ resource_loading_id: chr "ebi_gxa"
#> $ loading_parameters :List of 1
#> ..$ :'data.frame': 1 obs. of 2 variables:
#> .. ..$ name : chr "dataset_id"
#> .. ..$ value: chr "E-MTAB-7453"
#> $ web_link : chr "https://www.ebi.ac.uk/gxa/experiments/E-MTAB-7453/Results"The selected dataset can now be loaded through the
load_public_dataset function.
# this function only takes one argument, which must be
# a single row from the data.frame returned by the
# find_public_datasets function
mel_cells_braf <- load_public_dataset(dataset_search_entry, verbose = TRUE)
#> Downloading data from ExpressionAtlas
#> Converting ExpressionAtlas data
#> Creating summary dataThe returned object is an ExpressionSet object that
already contains all available metada.
# use the biobase functions to access the metadata
library(Biobase)
#> Loading required package: BiocGenerics
#>
#> Attaching package: 'BiocGenerics'
#> The following object is masked from 'package:SeuratObject':
#>
#> intersect
#> The following object is masked from 'package:limma':
#>
#> plotMA
#> The following objects are masked from 'package:stats':
#>
#> IQR, mad, sd, var, xtabs
#> The following objects are masked from 'package:base':
#>
#> Filter, Find, Map, Position, Reduce, anyDuplicated, aperm, append,
#> as.data.frame, basename, cbind, colnames, dirname, do.call,
#> duplicated, eval, evalq, get, grep, grepl, intersect, is.unsorted,
#> lapply, mapply, match, mget, order, paste, pmax, pmax.int, pmin,
#> pmin.int, rank, rbind, rownames, sapply, saveRDS, setdiff, table,
#> tapply, union, unique, unsplit, which.max, which.min
#> Welcome to Bioconductor
#>
#> Vignettes contain introductory material; view with
#> 'browseVignettes()'. To cite Bioconductor, see
#> 'citation("Biobase")', and for packages 'citation("pkgname")'.
# basic metadata
pData(mel_cells_braf)
#> Sample.Id AtlasAssayGroup organism cell_line organism_part
#> ERR2950741 ERR2950741 g2 Homo sapiens A375-P skin
#> ERR2950742 ERR2950742 g2 Homo sapiens A375-P skin
#> ERR2950743 ERR2950743 g2 Homo sapiens A375-P skin
#> ERR2950744 ERR2950744 g1 Homo sapiens A375-P skin
#> ERR2950745 ERR2950745 g1 Homo sapiens A375-P skin
#> ERR2950746 ERR2950746 g1 Homo sapiens A375-P skin
#> cell_type disease compound dose
#> ERR2950741 epithelial cell melanoma none
#> ERR2950742 epithelial cell melanoma none
#> ERR2950743 epithelial cell melanoma none
#> ERR2950744 epithelial cell melanoma PLX4720 1 micromolar
#> ERR2950745 epithelial cell melanoma PLX4720 1 micromolar
#> ERR2950746 epithelial cell melanoma PLX4720 1 micromolarDetailed descriptions of the loaded study are further stored in the metadata slot.
# access the stored metadata using the experimentData function
experimentData(mel_cells_braf)
#> Experiment data
#> Experimenter name: E-MTAB-7453
#> Laboratory:
#> Contact information:
#> Title: RNA-seq of the human melanoma cell-line A375P treated with the BRAF inhibitor PLX4720 and a DMSO control
#> URL: https://www.ebi.ac.uk/gxa/experiments/E-MTAB-7453/Results
#> PMIDs:
#> No abstract available.
#> notes:
#> notes:
#> Public dataset loaded from EBI Expression Atlas through ReactomeGSA.
# for some datasets, longer descriptions are available. These
# can be accessed using the abstract function
abstract(mel_cells_braf)
#> [1] ""Additionally, you can use the table function to quickly
get the number of available samples for a specific metadata field.
This object is now directly compatible with ReactomeGSA’s pathway analysis functions. A detailed explanation of how to perform this analysis, please have a look at the respective vignette.
# create the analysis request
my_request <-ReactomeAnalysisRequest(method = "Camera")
# do not create a visualization for this example
my_request <- set_parameters(request = my_request, create_reactome_visualization = FALSE)
# add the dataset using the loaded object
my_request <- add_dataset(request = my_request,
expression_values = mel_cells_braf,
name = "E-MTAB-7453",
type = "rnaseq_counts",
comparison_factor = "compound",
comparison_group_1 = "PLX4720",
comparison_group_2 = "none")
#> Converting expression data to string... (This may take a moment)
#> Conversion complete
my_request
#> ReactomeAnalysisRequestObject
#> Method = Camera
#> Parameters:
#> - create_reactome_visualization: FALSE
#> Datasets:
#> - E-MTAB-7453 (rnaseq_counts)
#> No parameters set.
#> ReactomeAnalysisRequestThe analysis can now started using the standard workflow:
# perform the analysis using ReactomeGSA
res <- perform_reactome_analysis(my_request)
#> Submitting request to Reactome API...
#> Compressing request data...
#> Reactome Analysis submitted succesfully
#> Converting dataset E-MTAB-7453...
#> Mapping identifiers...
#> Performing gene set analysis using Camera
#> Analysing dataset 'E-MTAB-7453' using Camera
#> Retrieving result...
# basic overview of the result
print(res)
#> ReactomeAnalysisResult object
#> Reactome Release: 90
#> Results:
#> - E-MTAB-7453:
#> 2633 pathways
#> 9429 fold changes for genes
#> No Reactome visualizations available
#> [1] "ReactomeAnalysisResult"
#> attr(,"package")
#> [1] "ReactomeGSA"
# key pathways
res_pathways <- pathways(res)
head(res_pathways)
#> Name Direction.E-MTAB-7453
#> R-HSA-69620 Cell Cycle Checkpoints Up
#> R-HSA-69239 Synthesis of DNA Up
#> R-HSA-69206 G1/S Transition Up
#> R-HSA-69242 S Phase Up
#> R-HSA-453279 Mitotic G1 phase and G1/S transition Up
#> R-HSA-68962 Activation of the pre-replicative complex Up
#> FDR.E-MTAB-7453 PValue.E-MTAB-7453 NGenes.E-MTAB-7453
#> R-HSA-69620 1.896271e-14 1.089929e-17 255
#> R-HSA-69239 1.896271e-14 1.440388e-17 106
#> R-HSA-69206 1.456016e-13 1.658963e-16 119
#> R-HSA-69242 1.622952e-13 2.465555e-16 148
#> R-HSA-453279 5.409825e-13 1.027312e-15 135
#> R-HSA-68962 7.699973e-13 1.765721e-15 33
#> av_foldchange.E-MTAB-7453 sig.E-MTAB-7453
#> R-HSA-69620 1.538884 TRUE
#> R-HSA-69239 1.585558 TRUE
#> R-HSA-69206 1.632018 TRUE
#> R-HSA-69242 1.436171 TRUE
#> R-HSA-453279 1.602551 TRUE
#> R-HSA-68962 2.563226 TRUEsessionInfo()
#> R Under development (unstable) (2024-10-21 r87258)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 24.04.1 LTS
#>
#> Matrix products: default
#> BLAS: /home/biocbuild/bbs-3.21-bioc/R/lib/libRblas.so
#> LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.12.0
#>
#> locale:
#> [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
#> [3] LC_TIME=en_GB LC_COLLATE=C
#> [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
#> [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
#> [9] LC_ADDRESS=C LC_TELEPHONE=C
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
#>
#> time zone: America/New_York
#> tzcode source: system (glibc)
#>
#> attached base packages:
#> [1] stats graphics grDevices utils datasets methods base
#>
#> other attached packages:
#> [1] Biobase_2.67.0 BiocGenerics_0.53.0 ReactomeGSA.data_1.19.0
#> [4] Seurat_5.1.0 SeuratObject_5.0.2 sp_2.1-4
#> [7] ReactomeGSA_1.21.0 edgeR_4.5.0 limma_3.63.0
#>
#> loaded via a namespace (and not attached):
#> [1] RColorBrewer_1.1-3 jsonlite_1.8.9 magrittr_2.0.3
#> [4] spatstat.utils_3.1-0 farver_2.1.2 rmarkdown_2.28
#> [7] vctrs_0.6.5 ROCR_1.0-11 spatstat.explore_3.3-3
#> [10] progress_1.2.3 htmltools_0.5.8.1 curl_5.2.3
#> [13] sass_0.4.9 sctransform_0.4.1 parallelly_1.38.0
#> [16] KernSmooth_2.23-24 bslib_0.8.0 htmlwidgets_1.6.4
#> [19] ica_1.0-3 plyr_1.8.9 plotly_4.10.4
#> [22] zoo_1.8-12 cachem_1.1.0 igraph_2.1.1
#> [25] mime_0.12 lifecycle_1.0.4 pkgconfig_2.0.3
#> [28] Matrix_1.7-1 R6_2.5.1 fastmap_1.2.0
#> [31] fitdistrplus_1.2-1 future_1.34.0 shiny_1.9.1
#> [34] digest_0.6.37 colorspace_2.1-1 patchwork_1.3.0
#> [37] tensor_1.5 RSpectra_0.16-2 irlba_2.3.5.1
#> [40] labeling_0.4.3 progressr_0.15.0 fansi_1.0.6
#> [43] spatstat.sparse_3.1-0 httr_1.4.7 polyclip_1.10-7
#> [46] abind_1.4-8 compiler_4.5.0 withr_3.0.2
#> [49] fastDummies_1.7.4 highr_0.11 gplots_3.2.0
#> [52] MASS_7.3-61 gtools_3.9.5 caTools_1.18.3
#> [55] tools_4.5.0 lmtest_0.9-40 httpuv_1.6.15
#> [58] future.apply_1.11.3 goftest_1.2-3 glue_1.8.0
#> [61] nlme_3.1-166 promises_1.3.0 grid_4.5.0
#> [64] Rtsne_0.17 cluster_2.1.6 reshape2_1.4.4
#> [67] generics_0.1.3 gtable_0.3.6 spatstat.data_3.1-2
#> [70] tidyr_1.3.1 hms_1.1.3 data.table_1.16.2
#> [73] utf8_1.2.4 spatstat.geom_3.3-3 RcppAnnoy_0.0.22
#> [76] ggrepel_0.9.6 RANN_2.6.2 pillar_1.9.0
#> [79] stringr_1.5.1 spam_2.11-0 RcppHNSW_0.6.0
#> [82] later_1.3.2 splines_4.5.0 dplyr_1.1.4
#> [85] lattice_0.22-6 survival_3.7-0 deldir_2.0-4
#> [88] tidyselect_1.2.1 locfit_1.5-9.10 miniUI_0.1.1.1
#> [91] pbapply_1.7-2 knitr_1.48 gridExtra_2.3
#> [94] scattermore_1.2 xfun_0.48 statmod_1.5.0
#> [97] matrixStats_1.4.1 stringi_1.8.4 lazyeval_0.2.2
#> [100] yaml_2.3.10 evaluate_1.0.1 codetools_0.2-20
#> [103] tibble_3.2.1 cli_3.6.3 uwot_0.2.2
#> [106] xtable_1.8-4 reticulate_1.39.0 munsell_0.5.1
#> [109] jquerylib_0.1.4 Rcpp_1.0.13 globals_0.16.3
#> [112] spatstat.random_3.3-2 png_0.1-8 spatstat.univar_3.0-1
#> [115] parallel_4.5.0 ggplot2_3.5.1 prettyunits_1.2.0
#> [118] dotCall64_1.2 bitops_1.0-9 listenv_0.9.1
#> [121] viridisLite_0.4.2 scales_1.3.0 ggridges_0.5.6
#> [124] crayon_1.5.3 leiden_0.4.3.1 purrr_1.0.2
#> [127] rlang_1.1.4 cowplot_1.1.3