In tgirke/systemPipeRdata: systemPipeRdata: Workflow templates and sample data

```{css, echo=FALSE} pre code { white-space: pre !important; overflow-x: scroll !important; word-break: keep-all !important; word-wrap: initial !important; }

<!---
- Compile from command-line
Rscript -e "rmarkdown::render('systemPipeRdata.Rmd', c('BiocStyle::html_document'), clean=F); knitr::knit('systemPipeRdata.Rmd', tangle=TRUE)"

-->

```r
BiocStyle::markdown()
options(width=60, max.print=1000)
knitr::opts_chunk$set(
    eval=as.logical(Sys.getenv("KNITR_EVAL", "TRUE")),
    cache=as.logical(Sys.getenv("KNITR_CACHE", "TRUE")), 
    tidy.opts=list(width.cutoff=60), tidy=TRUE)

suppressPackageStartupMessages({
    library(systemPipeRdata)
})

Introduction

systemPipeRdata provides data analysis workflow templates compatible with the systemPipeR software package [@H_Backman2016-bt]. The latter is a Workflow Management System (WMS) for designing and running end-to-end analysis workflows with automated report generation for a wide range of data analysis applications. Support for running external software is provided by a command-line interface (CLI) that adopts the Common Workflow Language (CWL). How to use systemPipeR is explained in its main vignette here. The workflow templates provided by systemPipeRdata come equipped with sample data and the necessary parameter files required to run a selected workflow. This setup simplifies the learning process of using systemPipeR, facilitates testing of workflows, and serves as a foundation for designing new workflows. The standardized directory structure (Figure 1) utilized by the workflow templates and their sample data is outlined in the Directory Structure section of systemPipeR's main vignette.

Figure 1: Directory structure ofsystemPipeR's workflows. For details, see here.

Getting started

Installation

The systemPipeRdata package is available at Bioconductor and can be installed from within R as follows.

if (!requireNamespace("BiocManager", quietly=TRUE))
    install.packages("BiocManager")
BiocManager::install("systemPipeRdata") 

Loading package and documentation

library("systemPipeRdata") # Loads the package

library(help="systemPipeRdata") # Lists package info
vignette("systemPipeRdata") # Opens vignette

Overview of workflow templates {#wf-bioc-collection}

An overview table of workflow templates, included in systemPipeRdata, can be returned as shown below. By clicking the URLs in the last column of the below workflow list, users can view the Rmd source file of a workflow, as well as the final HTML report generated after running a workflow on the provided test data. A list of the default data analysis steps included in each workflow is given here. Additional workflow templates are available on this project's GitHub organization (for details, see below). To create an empty workflow template without any test data included, users want to choose the new template, which includes only the required directory structure and parameter files.

availableWF()

library(magrittr)
Name <- c("new", "rnaseq", "riboseq", "chipseq", "varseq", "SPblast", "SPcheminfo", "SPscrna") 
Name_url <- c("new", "systemPipeRNAseq", "systemPipeRIBOseq", "systemPipeChIPseq", "systemPipeVARseq", "SPblast", "SPcheminfo", "SPscrna") 
Description <- c("Generic Workflow Template", "RNA-Seq Workflow Template", "RIBO-Seq Workflow Template", "ChIP-Seq Workflow Template", "VAR-Seq Workflow Template", "BLAST Workflow Template", "Cheminformatics Drug Similarity Template", "Basic Single-Cell Workflow Template") 
rmd <- paste0("https://www.bioconductor.org/packages/devel/data/experiment/vignettes/systemPipeRdata/inst/doc/", Name_url, ".Rmd")
rmd <- paste0("<a href=", rmd, ">Rmd</a>")
html <- paste0("https://www.bioconductor.org/packages/devel/data/experiment/vignettes/systemPipeRdata/inst/doc/", Name_url, ".html")
html <- paste0("<a href=", html, ">HTML</a>")
URL <- paste(rmd, html, sep=", ")
df <- data.frame(Name=Name, Description=Description, URL=URL)
df %>%
    kableExtra::kable("html", escape = FALSE, col.names = c("Name", "Description", "URL")) %>%
    kableExtra::kable_material(c("striped", "hover", "condensed")) %>%
    kableExtra::scroll_box(width = "80%", height = "500px")

Table 1: Workflow templates

Use workflow templates

Load a workflow {#load-wf}

The chosen example below uses the genWorkenvir function from the systemPipeRdata package to create an RNA-Seq workflow environment (selected under workflow="rnaseq") that is fully populated with a small test data set, including FASTQ files, reference genome and annotation data. The name of the resulting workflow directory can be specified under the mydirname argument. The default NULL uses the name of the chosen workflow. An error is issued if a directory of the same name and path exists already. After this, the user’s R session needs to be directed into the resulting rnaseq directory (here with setwd). The other workflow templates from the above table can be loaded the same way.

library(systemPipeRdata)
genWorkenvir(workflow="rnaseq")
setwd("rnaseq")

On Linux and OS X systems the same can be achieved from the command-line of a terminal with the following commands.

```{bash generate_workenvir_from_shell, eval=FALSE} $ Rscript -e "systemPipeRdata::genWorkenvir(workflow='rnaseq', mydirname='rnaseq')" $ cd rnaseq

## Run and visualize workflow {#run-wf}

For running and working with `systemPipeR` workflows, users want to visit
[systemPipeR's main
vignette](https://www.bioconductor.org/packages/devel/bioc/vignettes/systemPipeR/inst/doc/systemPipeR.html).
The following gives only a very brief preview on how to run workflows, and create scientific 
and technical reports. 

After a workflow environment (directory) has been created and the corresponding
R session directed into the resulting directory (here `rnaseq`), the workflow
can be loaded from the included R Markdown file (`Rmd`, here `systemPipeRNAseq.Rmd`).
This template provides common data analysis steps that are typical for RNA-Seq
workflows. Users have the options to add, remove, modify workflow steps by
applying these changes to the `sal` workflow management container directly, or 
updating the `Rmd` file first and then updating `sal` accordingly. 

```r
library(systemPipeR)
sal <- SPRproject() 
sal <- importWF(sal, file_path = "systemPipeRNAseq.Rmd", verbose = FALSE)

The default analysis steps of the imported RNA-Seq workflow are listed below. Users can modify the existing steps, add new ones or remove steps as needed.

Default analysis steps in RNA-Seq Workflow

1. Read preprocessing
   • Quality filtering (trimming)
   • FASTQ quality report
2. Alignments: HISAT2 (or any other RNA-Seq aligner)
3. Alignment stats
4. Read counting
5. Sample-wise correlation analysis
6. Analysis of differentially expressed genes (DEGs)
7. GO term enrichment analysis
8. Gene-wise clustering

Once the workflow has been loaded into sal, it can be executed from start to finish (or partially) with the runWF command. However, running the workflow will only be possible if all dependent CL software is installed on a user's system. Their names and availability on a system can be listed with listCmdTools(sal, check_path=TRUE).

sal <- runWF(sal)

Workflows can be visualized as topology graphs using the plotWF function.

plotWF(sal)

knitr::include_graphics("results/plotwf_rnaseq.png")

Scientific and technical reports can be generated with the renderReport and renderLogs functions, respectively. Scientific reports can also be generated with the render function of the rmarkdown package. The technical reports are based on log information that systemPipeR collects during workflow runs.

# Scietific report
sal <- renderReport(sal)
rmarkdown::render("systemPipeRNAseq.Rmd", clean = TRUE, output_format = "BiocStyle::html_document") 

# Technical (log) report
sal <- renderLogs(sal)

Additional workflow templates {#wf-github-collection}

The project's GitHub Organization hosts a repository of workflow templates, containing both well-established and experimental workflows. Within the R environment, the same availableWF function mentioned earlier can be utilized to retrieve a list of the workflows in this collection.

availableWF(github = TRUE)

Additional Workflow Templates in systemPipeR GitHub Organization:
       Workflow                                     Download URL
1     SPatacseq    https://github.com/systemPipeR/SPatacseq.git
2     SPclipseq    https://github.com/systemPipeR/SPclipseq.git
3      SPdenovo    https://github.com/systemPipeR/SPdenovo.git
4         SPhic    https://github.com/systemPipeR/SPhic.git
5   SPmetatrans    https://github.com/systemPipeR/SPmetatrans.git
6   SPmethylseq    https://github.com/systemPipeR/SPmethylseq.git
7    SPmirnaseq    https://github.com/systemPipeR/SPmirnaseq.git
8 SPpolyriboseq    https://github.com/systemPipeR/SPpolyriboseq.git
9    SPscrnaseq    https://github.com/systemPipeR/SPscrnaseq.git

To download these workflow templates, users can either run the below git clone command from a terminal, or visit the corresponding GitHub page of a chosen workflow via the provided URLs, and then download it as a Zip file and uncompress it. Note, the following lines of code need to be run from a terminal (not R console, e.g. terminal in RStudio) on a system where the git software is installed.

```{bash eval=FALSE} $ git clone <...> # Provide under <...> URL of chosen workflow from table above. $ cd

After a workflow template has been downloaded, one can run it the same way as 
outlined [above](#run-wf). 

# Useful functionalities

## Create workflow templates interactively

It is possible to create a new workflow environment from RStudio. This can be 
done by selecting `File -> New File -> R Markdown -> From Template -> systemPipeR New WorkFlow`.
This option creates a template workflow that has the expected directory structure 
(see [here](https://www.bioconductor.org/packages/devel/bioc/vignettes/systemPipeR/inst/doc/systemPipeR.html#3_Directory_structure)). 

![](results/rstudio.png)
__Figure 2:__ Selecting workflow template within RStudio.


## Return paths to sample data

The paths to the sample data provided by the `systemPipeRdata` package can be returned with the
the `pathList` function.

```r
pathList()[1:2]

Analysis steps in selected workflows {#wf-template-steps}

The following gives an overview of the default data analysis steps used by selected workflow templates included in the systemPipeRdata package (see Table 1). The workflows hosted on this project's GitHub Organization are not considered here.

Any of the workflows included below can be loaded by assigning their name to the workflow argument of the genWorkenvir function. The workflow names can be looked up under the 'Name' column of Table 1.

library(systemPipeRdata)
genWorkenvir(workflow="...")

Generic template

[ Vignette ]

This Generic workflow (named new) is intended to be used as a template for creating new workflows from scratch where users can add steps by copying and pasting existing R or CL steps as needed, and populate them with their own code. In its current form, this mini workflow will export a test dataset to multiple files, compress/decompress the exported files, import them back into R, and then perform a simple statistical analysis and plot the results.

1. R step: export tabular data to files
2. CL step: compress files
3. CL step: uncompress files
4. R step: import files and plot summary statistics

RNA-Seq workflow

[ Vignette ]

1. Read preprocessing
   • Quality filtering (trimming)
   • FASTQ quality report
2. Alignments: HISAT2 (or any other RNA-Seq aligner)
3. Alignment stats
4. Read counting
5. Sample-wise correlation analysis
6. Analysis of differentially expressed genes (DEGs)
7. GO term enrichment analysis
8. Gene-wise clustering

ChIP-Seq Workflow

[ Vignette ]

1. Read preprocessing
   • Quality filtering (trimming)
   • FASTQ quality report
2. Alignments: Bowtie2 or rsubread
3. Alignment stats
4. Peak calling: MACS2
5. Peak annotation with genomic context
6. Differential binding analysis
7. GO term enrichment analysis
8. Motif analysis

VAR-Seq Workflow

[ Vignette ]

1. Read preprocessing +Quality filtering (trimming) +FASTQ quality report
2. Alignments: bwa or other
3. Variant calling: GATK, BCFtools
4. Variant filtering: VariantTools and VariantAnnotation
5. Variant annotation: VariantAnnotation
6. Combine results from many samples
7. Summary statistics of samp

Ribo-Seq Workflow

[ Vignette ]

1. Read preprocessing
   • Adaptor trimming and quality filtering
   • FASTQ quality report
2. Alignments: HISAT2 (or any other RNA-Seq aligner)
3. Alignment stats
4. Compute read distribution across genomic features
5. Adding custom features to workflow (e.g. uORFs)
6. Genomic read coverage along transcripts
7. Read counting
8. Sample-wise correlation analysis
9. Analysis of differentially expressed genes (DEGs)
10. GO term enrichment analysis
11. Gene-wise clustering
12. Differential ribosome binding (translational efficiency)

scRNA-Seq Workflow

[ Vignette ]

1. Import of single cell read count data
2. Basic stats on input data
3. QC of cell count data
4. Cell filtering
5. Normalization
6. Identify high variable genes
7. Scaling
8. Embedding with tSNE, UMAP, and PCA
9. Cell clustering and marker gene classification
10. Cell type classification
11. Co-visualizatioin of cell types and clusters

BLAST Workflow

[ Vignette ]

1. Load query sequences
2. Select and prepare BLASTable databases
3. Run BLAST against different databases

Cheminformatics Workflow

[ Vignette ]

1. Import small molecules stored in SDF file
2. Visualize small molecule structures
3. Create atom pair and finger print databases for structure similarity searching
4. Compute all-against-all structural similarities
5. Hierarchical clustering and PCA of structural similarities
6. Plot heat map

Version information

sessionInfo()

Funding

This project was supported by funds from the National Institutes of Health (NIH) and the National Science Foundation (NSF).

References

tgirke/systemPipeRdata documentation built on Oct. 24, 2024, 9:49 p.m.