Last updated: 2024-07-27

Checks: 7 0

Knit directory: muse/

This reproducible R Markdown analysis was created with workflowr (version 1.7.1). The Checks tab describes the reproducibility checks that were applied when the results were created. The Past versions tab lists the development history.


Great! Since the R Markdown file has been committed to the Git repository, you know the exact version of the code that produced these results.

Great job! The global environment was empty. Objects defined in the global environment can affect the analysis in your R Markdown file in unknown ways. For reproduciblity it’s best to always run the code in an empty environment.

The command set.seed(20200712) was run prior to running the code in the R Markdown file. Setting a seed ensures that any results that rely on randomness, e.g. subsampling or permutations, are reproducible.

Great job! Recording the operating system, R version, and package versions is critical for reproducibility.

Nice! There were no cached chunks for this analysis, so you can be confident that you successfully produced the results during this run.

Great job! Using relative paths to the files within your workflowr project makes it easier to run your code on other machines.

Great! You are using Git for version control. Tracking code development and connecting the code version to the results is critical for reproducibility.

The results in this page were generated with repository version e6dba7a. See the Past versions tab to see a history of the changes made to the R Markdown and HTML files.

Note that you need to be careful to ensure that all relevant files for the analysis have been committed to Git prior to generating the results (you can use wflow_publish or wflow_git_commit). workflowr only checks the R Markdown file, but you know if there are other scripts or data files that it depends on. Below is the status of the Git repository when the results were generated:


Ignored files:
    Ignored:    .Rhistory
    Ignored:    .Rproj.user/
    Ignored:    r_packages_4.3.3/
    Ignored:    r_packages_4.4.0/

Note that any generated files, e.g. HTML, png, CSS, etc., are not included in this status report because it is ok for generated content to have uncommitted changes.


These are the previous versions of the repository in which changes were made to the R Markdown (analysis/sradb.Rmd) and HTML (docs/sradb.html) files. If you’ve configured a remote Git repository (see ?wflow_git_remote), click on the hyperlinks in the table below to view the files as they were in that past version.

File Version Author Date Message
Rmd e6dba7a Dave Tang 2024-07-27 Format sample attribute
html f3646e2 Dave Tang 2024-07-27 Build site.
Rmd 3c6da94 Dave Tang 2024-07-27 Get sample information
html 7e58cae Dave Tang 2024-07-25 Build site.
Rmd a0610af Dave Tang 2024-07-25 Add intro and example query
html 1dbd4f3 Dave Tang 2024-07-25 Build site.
Rmd 39a6fe8 Dave Tang 2024-07-25 Querying the SRA

SRAdb

The SRAdb package is a compilation of metadata from NCBI SRA and tools. Specifically:

The Sequence Read Archive (SRA) is the largest public repository of sequencing data from the next generation of sequencing platforms including Roche 454 GS System, Illumina Genome Analyzer, Applied Biosystems SOLiD System, Helicos Heliscope, and others. However, finding data of interest can be challenging using current tools.

SRAdb is an attempt to make access to the metadata associated with submission, study, sample, experiment and run much more feasible. This is accomplished by parsing all the NCBI SRA metadata into a SQLite database that can be stored and queried locally. Fulltext search in the package make querying metadata very flexible and powerful.

fastq and sra files can be downloaded for doing alignment locally. Beside ftp protocol, the SRAdb has funcitons supporting fastp protocol (ascp from Aspera Connect) for faster downloading large data files over long distance. The SQLite database is updated regularly as new data is added to SRA and can be downloaded at will for the most up-to-date metadata.

SQLite database

First download SRAmetadb.sqlite.gz and gunzip it; the function getSRAdbFile() can do this but I recommend downloading this file externally. The gzipped file is around 6.8G in size (2024-07-26) and when uncompressed is 138G in size.

sqlfile <- getSRAdbFile(method = "wget")

Download database file externally using wget.

wget -c https://gbnci.cancer.gov/backup/SRAmetadb.sqlite.gz

Point to the location of downloaded and gunzipped file.

sqlfile <- '/data2/sradb/SRAmetadb.sqlite'

Create a connection for queries. The standard DBI functionality as implemented in RSQLite function dbConnect makes the connection to the database. The dbDisconnect function disconnects the connection.

sra_con <- dbConnect(SQLite(), sqlfile)

SRA tables

Database tables.

sra_tables <- dbListTables(sra_con)
sra_tables
 [1] "col_desc"        "experiment"      "metaInfo"        "run"            
 [5] "sample"          "sra"             "sra_ft"          "sra_ft_content" 
 [9] "sra_ft_segdir"   "sra_ft_segments" "study"           "submission"     

Study fields.

dbListFields(sra_con, "study")
 [1] "study_ID"             "study_alias"          "study_accession"     
 [4] "study_title"          "study_type"           "study_abstract"      
 [7] "broker_name"          "center_name"          "center_project_name" 
[10] "study_description"    "related_studies"      "primary_study"       
[13] "sra_link"             "study_url_link"       "xref_link"           
[16] "study_entrez_link"    "ddbj_link"            "ena_link"            
[19] "study_attribute"      "submission_accession" "sradb_updated"       

Sample fields.

dbListFields(sra_con, "sample")
 [1] "sample_ID"            "sample_alias"         "sample_accession"    
 [4] "broker_name"          "center_name"          "taxon_id"            
 [7] "scientific_name"      "common_name"          "anonymized_name"     
[10] "individual_name"      "description"          "sra_link"            
[13] "sample_url_link"      "xref_link"            "sample_entrez_link"  
[16] "ddbj_link"            "ena_link"             "sample_attribute"    
[19] "submission_accession" "sradb_updated"       

Query.

rs <- dbGetQuery(sra_con, "select * from study limit 3")
rs[, 1:5]
  study_ID study_alias study_accession
1        1   DRP000001       DRP000001
2        2   DRP000002       DRP000002
3        3   DRP000003       DRP000003
                                                                                study_title
1                          Bacillus subtilis subsp. natto BEST195 genome sequencing project
2                       Model organism for prokaryotic cell differentiation and development
3 Comprehensive identification and characterization of the nucleosome             structure
               study_type
1 Whole Genome Sequencing
2 Whole Genome Sequencing
3  Transcriptome Analysis

Query matching specific study accession.

dbGetQuery(sra_con, "select * from study where study_accession == 'DRP000001'")
  study_ID study_alias study_accession
1        1   DRP000001       DRP000001
                                                       study_title
1 Bacillus subtilis subsp. natto BEST195 genome sequencing project
               study_type
1 Whole Genome Sequencing
                                                                                                                                                                                           study_abstract
1 <b><i>Bacillus subtilis</i> subsp. <i>natto</i> BEST195</b>. i>Bacillus subtilis</i> subsp. <i>natto</i> BEST195 was isolated from fermented soybeans and will be used for comparative genome analysis.
  broker_name center_name                    center_project_name
1        <NA>        KEIO Bacillus subtilis subsp. natto BEST195
  study_description related_studies primary_study sra_link study_url_link
1              <NA>            <NA>          <NA>     <NA>           <NA>
                             xref_link study_entrez_link ddbj_link ena_link
1 pubmed: 20398357 || pubmed: 25329997              <NA>      <NA>     <NA>
  study_attribute submission_accession       sradb_updated
1            <NA>            DRA000001 2023-12-03 23:10:21

Match a list of study accessions.

rs <- dbGetQuery(sra_con, "select * from study where study_accession in ('DRP000001', 'DRP000003')")
rs[, 1:5]
  study_ID study_alias study_accession
1        1   DRP000001       DRP000001
2        3   DRP000003       DRP000003
                                                                                study_title
1                          Bacillus subtilis subsp. natto BEST195 genome sequencing project
2 Comprehensive identification and characterization of the nucleosome             structure
               study_type
1 Whole Genome Sequencing
2  Transcriptome Analysis

SRX to SRR

How do we get the SRR accession for SRX510365? (Should be SRR1216135)

exps <- c("SRX510281", "SRX510280", "SRX510279", "SRX510278", "SRX510277", "SRX510276")

lookup <- sraConvert(exps, sra_con = sra_con)
lookup
  experiment submission     study    sample        run
1  SRX510276  SRA090948 SRP025982 SRS588793 SRR1216046
2  SRX510277  SRA090948 SRP025982 SRS588794 SRR1216047
3  SRX510278  SRA090948 SRP025982 SRS588795 SRR1216048
4  SRX510279  SRA090948 SRP025982 SRS588796 SRR1216049
5  SRX510280  SRA090948 SRP025982 SRS588798 SRR1216050
6  SRX510281  SRA090948 SRP025982 SRS588797 SRR1216051

Get sample information.

purrr::map_df(lookup$sample, \(x){
  dbGetQuery(sra_con, paste0("select * from sample where sample_accession == '", x, "'"))
}) -> sample_info

The required sample information is stored in sample_attribute and that needs to be further formatted.

sample_info |>
  as_tibble() |>
  select(sample_accession, sample_attribute) |>
  tidyr::separate_longer_delim(cols = sample_attribute, delim = " || ") |>
  tidyr::separate_wider_delim(cols = sample_attribute, delim = ": ", names = c('key', 'value')) |>
  tidyr::pivot_wider(id_cols = sample_accession, names_from = key, values_from = value)
# A tibble: 6 × 9
  sample_accession source_name   `seqc sample` platform site  `library id` lane 
  <chr>            <chr>         <chr>         <chr>    <chr> <chr>        <chr>
1 SRS588793        Human Brain … B             Illumin… NYG   4            L03  
2 SRS588794        Human Brain … B             Illumin… NYG   4            L04  
3 SRS588795        Human Brain … B             Illumin… NYG   4            L05  
4 SRS588796        Human Brain … B             Illumin… NYG   4            L06  
5 SRS588798        Human Brain … B             Illumin… NYG   4            L07  
6 SRS588797        Human Brain … B             Illumin… NYG   4            L08  
# ℹ 2 more variables: barcode <chr>, flowcell <chr>

End

Disconnect.

dbDisconnect(conn = sra_con)

sessionInfo()
R version 4.4.0 (2024-04-24)
Platform: x86_64-pc-linux-gnu
Running under: Ubuntu 22.04.4 LTS

Matrix products: default
BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3 
LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.20.so;  LAPACK version 3.10.0

locale:
 [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
 [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8    
 [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: Etc/UTC
tzcode source: system (glibc)

attached base packages:
[1] stats     graphics  grDevices utils     datasets  methods   base     

other attached packages:
 [1] SRAdb_1.66.0        RCurl_1.98-1.14     graph_1.82.0       
 [4] BiocGenerics_0.50.0 RSQLite_2.3.7       lubridate_1.9.3    
 [7] forcats_1.0.0       stringr_1.5.1       dplyr_1.1.4        
[10] purrr_1.0.2         readr_2.1.5         tidyr_1.3.1        
[13] tibble_3.2.1        ggplot2_3.5.1       tidyverse_2.0.0    
[16] workflowr_1.7.1    

loaded via a namespace (and not attached):
 [1] gtable_0.3.5      xfun_0.44         bslib_0.7.0       processx_3.8.4   
 [5] Biobase_2.64.0    callr_3.7.6       tzdb_0.4.0        bitops_1.0-7     
 [9] vctrs_0.6.5       tools_4.4.0       ps_1.7.6          generics_0.1.3   
[13] stats4_4.4.0      fansi_1.0.6       blob_1.2.4        pkgconfig_2.0.3  
[17] data.table_1.15.4 lifecycle_1.0.4   compiler_4.4.0    git2r_0.33.0     
[21] statmod_1.5.0     munsell_0.5.1     getPass_0.2-4     httpuv_1.6.15    
[25] htmltools_0.5.8.1 sass_0.4.9        yaml_2.3.8        later_1.3.2      
[29] pillar_1.9.0      jquerylib_0.1.4   whisker_0.4.1     limma_3.60.4     
[33] cachem_1.1.0      tidyselect_1.2.1  digest_0.6.35     stringi_1.8.4    
[37] rprojroot_2.0.4   fastmap_1.2.0     grid_4.4.0        GEOquery_2.72.0  
[41] colorspace_2.1-0  cli_3.6.2         magrittr_2.0.3    utf8_1.2.4       
[45] withr_3.0.0       scales_1.3.0      promises_1.3.0    bit64_4.0.5      
[49] timechange_0.3.0  rmarkdown_2.27    httr_1.4.7        bit_4.0.5        
[53] hms_1.1.3         memoise_2.0.1     evaluate_0.24.0   knitr_1.47       
[57] rlang_1.1.4       Rcpp_1.0.12       glue_1.7.0        DBI_1.2.3        
[61] xml2_1.3.6        rstudioapi_0.16.0 jsonlite_1.8.8    R6_2.5.1         
[65] fs_1.6.4