Digital Expression Explorer 2 (or DEE2 for short) is a repository of processed RNA-seq data in the form of counts. It was designed so that researchers could undertake re-analysis and meta-analysis of published RNA-seq studies quickly and easily. As of April 2020, over 1 million SRA runs have been processed.
For further information about the resource, refer to the journal article and project homepage.
This package provides an interface to access these expression data programmatically.
The first step is to download the list of accession numbers of available datasets with the getDEE2Metadata function, specifying a species name. options for species currently are:
If the species name is incorrect, an error will be thrown.
## SRR_accession QC_summary SRX_accession SRS_accession SRP_accession
## 1 DRR003389 WARN(2,6) DRX002713 DRS002797 DRP000898
## 2 DRR003390 WARN(2,6,7) DRX002714 DRS002798 DRP000898
## 3 DRR024071 WARN(5,7) DRX021821 DRS023187 DRP002871
## 4 DRR024072 WARN(5,7) DRX021822 DRS002797 DRP002871
## 5 DRR031524 FAIL(3,6) DRX028492 DRS092197 DRP004944
## 6 DRR031525 FAIL(3,6) DRX028493 DRS092198 DRP004944
## Sample_name GEO_series Library_name
## 1 SAMD00015748 NA KH1668:smg-2(yb979)
## 2 SAMD00015747 NA KH1857:smg-2(yb979) unc-75 (yb1701)
## 3 DRS023187 NA N2 L1
## 4 SAMD00015748 NA KH1668
## 5 SAMD00027920 NA 1_unc-75_L1_homogenate
## 6 SAMD00027921 NA 2_unc-75_L1_cytoplasmIf you have a SRA project accession number in mind already (eg: SRP009256) then we can see if the datasets are present.
## SRR_accession QC_summary SRX_accession SRS_accession SRP_accession
## 5920 SRR363796 FAIL(2,3,4,6,7) SRX105188 SRS270025 SRP009256
## 5921 SRR363797 FAIL(3,4,6,7) SRX105189 SRS270026 SRP009256
## 5922 SRR363798 FAIL(2,3,4,6,7) SRX105190 SRS270027 SRP009256
## 5923 SRR363799 FAIL(3,4,6,7) SRX105191 SRS270028 SRP009256
## Sample_name GEO_series Library_name
## 5920 GSM829554 NA GSM829554: 4SU_GLD1_PARCLIP_1
## 5921 GSM829555 NA GSM829555: 4SU_GLD1_PARCLIP_2
## 5922 GSM829556 NA GSM829556: 4SU_GLD1_PARCLIP_3
## 5923 GSM829557 NA GSM829557: 6SG_GLD1_PARCLIP_1DEE2 data is centred around SRA run accessions numbers, these SRR_accessions can be obtained like this:
mdat1 <- mdat[which(mdat$SRP_accession %in% "SRP009256"),]
SRRvec <- as.vector(mdat1$SRR_accession)
SRRvec## [1] "SRR363796" "SRR363797" "SRR363798" "SRR363799"The general syntax for obtaining DEE2 data is this:
getDEE2(species,SRRvec,metadata,outfile="NULL",counts="GeneCounts")
First, the function queries the metadata to make sure that the requested datasets are present. If metadata is not specified, then it will download a ‘fresh’ copy of the metadata. It then fetches the requested expression data and constructs a SummarizedExperiment object. The ‘counts’ parameter controls the type of counts provided:
GeneCounts STAR gene level counts (this is the default)
TxCounts Kallisto transcript level counts
Tx2Gene transcript counts aggregated (sum) to the gene level.
If ‘outfile’ is defined, then files will be downloaded to the specified path. If it is not defined, then the files are downloaded to a temporary directory and deleted immediately after use.
The SRR numbers need to exactly match those in SRA.
Here is an example of using the SRR vector as defined above.
suppressPackageStartupMessages(library("SummarizedExperiment"))
x <- getDEE2("celegans",SRRvec,metadata=mdat,counts="GeneCounts")## For more information about DEE2 QC metrics, visit
## https://github.com/markziemann/dee2/blob/master/qc/qc_metrics.md## class: SummarizedExperiment
## dim: 46739 4
## metadata(0):
## assays(1): counts
## rownames(46739): WBGene00197333 WBGene00198386 ... WBGene00010967
## WBGene00014473
## rowData names(0):
## colnames(4): SRR363796 SRR363797 SRR363798 SRR363799
## colData names(82): QC_summary SRX_accession ... DatasetCorrel
## QC_SUMMARY## DataFrame with 4 rows and 7 columns
## QC_summary SRX_accession SRS_accession SRP_accession Sample_name
## <character> <character> <character> <character> <character>
## SRR363796 FAIL(2,3,4,6,7) SRX105188 SRS270025 SRP009256 GSM829554
## SRR363797 FAIL(3,4,6,7) SRX105189 SRS270026 SRP009256 GSM829555
## SRR363798 FAIL(2,3,4,6,7) SRX105190 SRS270027 SRP009256 GSM829556
## SRR363799 FAIL(3,4,6,7) SRX105191 SRS270028 SRP009256 GSM829557
## GEO_series Library_name
## <logical> <character>
## SRR363796 NA GSM829554: 4SU_GLD1_..
## SRR363797 NA GSM829555: 4SU_GLD1_..
## SRR363798 NA GSM829556: 4SU_GLD1_..
## SRR363799 NA GSM829557: 6SG_GLD1_..## SRR363796 SRR363797 SRR363798 SRR363799
## WBGene00197333 0 0 0 0
## WBGene00198386 0 0 0 0
## WBGene00015153 4 16 6 4
## WBGene00002061 44 100 217 77
## WBGene00255704 0 5 1 1
## WBGene00235314 0 0 0 1You can directly specify the SRR accessions in the command line, but be sure to type them correctly. In case SRR accessions are not present in the database, there will be a warning message.
x <- getDEE2("celegans",c("SRR363798","SRR363799","SRR3581689","SRR3581692"),
metadata=mdat,counts="GeneCounts")## For more information about DEE2 QC metrics, visit
## https://github.com/markziemann/dee2/blob/master/qc/qc_metrics.md## Warning, datasets not found: 'SRR3581689,SRR3581692'In this case the accessions SRR3581689 and SRR3581692 are A. thaliana accessions and therefore not present in the C. elegans accession list.
DEE2 data are perfectly suitable for downstream analysis with edgeR, DESeq2, and many other gene expression and pathway enrichment tools. For more information about working with SummarizedExperiment refer to the rnaseqGene package which describes a workflow for differential gene expression of SummarizedExperiment objects.
The function to obtain DEE2 in the legacy format is provided for completeness but is no longer recommended. It gives DEE2 data in the form of a list object with slots for gene counts, transcript counts, gene length, transcript length, quality control data, sample metadata summary, sample metadata (full) and any absent datasets.
## For more information about DEE2 QC metrics, visit
## https://github.com/markziemann/dee2/blob/master/qc/qc_metrics.md## [1] "GeneCounts" "TxCounts" "GeneInfo" "TxInfo"
## [5] "QcMx" "MetadataSummary" "MetadataFull" "absent"## SRR363796 SRR363797 SRR363798 SRR363799
## WBGene00197333 0 0 0 0
## WBGene00198386 0 0 0 0
## WBGene00015153 4 16 6 4
## WBGene00002061 44 100 217 77
## WBGene00255704 0 5 1 1
## WBGene00235314 0 0 0 1## SRR363796 SRR363797 SRR363798 SRR363799
## Y110A7A.10 11 23 48 45
## F27C8.1 0 0 0 0
## F07C3.7 0 2 0 21
## F52H2.2a 0 0 7 0
## F52H2.2b 0 4 0 5
## T13A10.10a 0 0 0 0## SRR363796 SRR363797 SRR363798
## SequenceFormat SE SE SE
## QualityEncoding Sanger/Illumina1.9 Sanger/Illumina1.9 Sanger/Illumina1.9
## Read1MinimumLength 36 36 36
## Read1MedianLength 36 36 36
## Read1MaxLength 36 36 36
## Read2MinimumLength NULL NULL NULL
## SRR363799
## SequenceFormat SE
## QualityEncoding Sanger/Illumina1.9
## Read1MinimumLength 36
## Read1MedianLength 36
## Read1MaxLength 36
## Read2MinimumLength NULL## GeneSymbol mean median longest_isoform merged
## WBGene00197333 cTel3X.2 150 150 150 150
## WBGene00198386 cTel3X.3 150 150 150 150
## WBGene00015153 B0348.5 1051 1178 1178 1178
## WBGene00002061 ife-3 1015 949 1107 1107
## WBGene00255704 B0348.10 363 363 363 363
## WBGene00235314 B0348.9 220 220 220 220## GeneID GeneSymbol TxLength
## Y110A7A.10 WBGene00000001 aap-1 1787
## F27C8.1 WBGene00000002 aat-1 1940
## F07C3.7 WBGene00000003 aat-2 1728
## F52H2.2a WBGene00000004 aat-3 1739
## F52H2.2b WBGene00000004 aat-3 1840
## T13A10.10a WBGene00000005 aat-4 1734The DEE2 webpage has processed many projects containing dozens to thousands of runs (available here). These large project datasets are easiest to access with the “bundles” functionality described here. The three functions are:
list_bundles downloads a list of available bundles for a species
query_bundles checks whether a particular SRA project or GEO series accession number is available
getDEE2_bundle fetches the expression data for a particular accession and loads it as a SummarizedExperiment object
In this first example, we search for a dataset with SRA project accession number SRP058781 and load the gene level counts.
## file_name date_added time_added file_size SRP_accession GSE_accession
## 1 DRP001761_NA.zip 2020-07-08 11:34 3.2M DRP001761 NA
## 2 DRP002301_NA.zip 2020-07-08 11:34 2.2M DRP002301 NA
## 3 DRP003066_NA.zip 2020-07-08 11:34 1.8M DRP003066 NA
## 4 DRP003416_NA.zip 2020-07-08 11:34 3.5M DRP003416 NA
## 5 DRP003686_NA.zip 2020-07-08 11:34 5.1M DRP003686 NA
## 6 DRP003759_NA.zip 2020-07-08 11:34 2.4M DRP003759 NA## $present
## [1] "SRP058781"
##
## $absent
## character(0)## For more information about DEE2 QC metrics, visit
## https://github.com/markziemann/dee2/blob/master/qc/qc_metrics.md## SRR2042819 SRR2042820 SRR2042821 SRR2042822
## AT1G01010 26 47 101 97
## AT1G01020 115 105 187 130
## AT1G03987 0 0 1 2
## AT1G01030 22 32 38 30
## AT1G01040 628 591 1227 890
## AT1G03993 0 0 0 0Similarly, it is possible to search with GEO series numbers, as in the next example.
## For more information about DEE2 QC metrics, visit
## https://github.com/markziemann/dee2/blob/master/qc/qc_metrics.md## SRR6268134 SRR6268135 SRR6268136 SRR6268137
## ENSDARG00000104632 0 0 0 0
## ENSDARG00000100660 51 41 36 38
## ENSDARG00000098417 0 0 0 0
## ENSDARG00000100422 11 5 4 9
## ENSDARG00000102128 0 0 0 0
## ENSDARG00000103095 0 0 0 0## R version 4.0.3 (2020-10-10)
## Platform: x86_64-w64-mingw32/x64 (64-bit)
## Running under: Windows Server 2012 R2 x64 (build 9600)
##
## Matrix products: default
##
## locale:
## [1] LC_COLLATE=C
## [2] LC_CTYPE=English_United States.1252
## [3] LC_MONETARY=English_United States.1252
## [4] LC_NUMERIC=C
## [5] LC_TIME=English_United States.1252
##
## attached base packages:
## [1] parallel stats4 stats graphics grDevices utils datasets
## [8] methods base
##
## other attached packages:
## [1] SummarizedExperiment_1.20.0 Biobase_2.50.0
## [3] GenomicRanges_1.42.0 GenomeInfoDb_1.26.0
## [5] IRanges_2.24.0 S4Vectors_0.28.0
## [7] BiocGenerics_0.36.0 MatrixGenerics_1.2.0
## [9] matrixStats_0.57.0 getDEE2_1.0.0
##
## loaded via a namespace (and not attached):
## [1] knitr_1.30 XVector_0.30.0 magrittr_1.5
## [4] zlibbioc_1.36.0 htm2txt_2.1.1 lattice_0.20-41
## [7] rlang_0.4.8 stringr_1.4.0 tools_4.0.3
## [10] grid_4.0.3 xfun_0.18 htmltools_0.5.0
## [13] yaml_2.2.1 digest_0.6.27 Matrix_1.2-18
## [16] GenomeInfoDbData_1.2.4 bitops_1.0-6 RCurl_1.98-1.2
## [19] evaluate_0.14 rmarkdown_2.5 DelayedArray_0.16.0
## [22] stringi_1.5.3 compiler_4.0.3