systemPipeRdata: Workflow templates and sample data
Last update: 13 April, 2022
Package
systemPipeRdata 1.22.3
Note: the most recent version of this vignette can be found here.
Note: if you use systemPipeR and systemPipeRdata in published research, please cite:
Backman, T.W.H and Girke, T. (2016). systemPipeR: Workflow and Report Generation Environment. BMC Bioinformatics, 17: 388. 10.1186/s12859-016-1241-0.
1 Introduction
systemPipeRdata is a helper package
to generate with a single command workflow templates that are intended to be
used by its parent package systemPipeR (H Backman and Girke 2016).
The systemPipeR project provides a suite of R/Bioconductor packages for designing,
building and running end-to-end analysis workflows on local machines, HPC clusters
and cloud systems, while generating at the same time publication quality analysis reports.
To test workflows quickly or design new ones from existing templates, users can
generate with a single command workflow instances fully populated with sample data
and parameter files required for running a chosen workflow.
Pre-configured directory structure of the workflow environment and the sample data
used by systemPipeRdata are described here.
2 Getting started
2.1 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")Also, it is possible to install the development version from Bioconductor.
BiocManager::install("systemPipeRdata", version = "devel", build_vignettes = TRUE,
dependencies = TRUE) # Installs Devel version from Bioconductor2.2 Loading package and documentation
library("systemPipeRdata") # Loads the packagelibrary(help = "systemPipeRdata") # Lists package info
vignette("systemPipeRdata") # Opens vignette2.3 Starting with pre-configured workflow templates
Load one of the available workflows into your current working directory.
The following does this for the varseq workflow template. 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.
genWorkenvir(workflow = "systemPipeR/SPvarseq", mydirname = "varseq")
setwd("varseq")On Linux and OS X systems the same can be achieved from the command-line of a terminal with the following commands.
$ Rscript -e "systemPipeRdata::genWorkenvir(workflow='systemPipeR/SPvarseq', mydirname='varseq')"3 Workflow templates collection
A collection of workflow templates are available, and it is possible to browse the current availability, as follows:
availableWF(github = TRUE)This function returns the list of workflow templates available within the package and systemPipeR Organization on GitHub. Each one listed template can be created as described above.
The workflow template choose from Github will be installed as an R package, and also it creates the environment with all the settings and files to run the demo analysis.
genWorkenvir(workflow="systemPipeR/SPrnaseq", mydirname="NULL")
setwd("SPrnaseq")Besides, it is possible to choose different versions of the workflow template,
defined through other branches on the GitHub Repository. By default, the master
branch is selected, however, it is possible to define a different branch with the ref argument.
genWorkenvir(workflow="systemPipeR/SPrnaseq", ref = "singleMachine")
setwd("SPrnaseq")3.1 Download a specific R Markdown file
Also, it is possible to download a specific workflow script for your analysis.
The URL can be specified under url argument and the R Markdown file name in
the urlname argument. The default NULL copies the current version available in the chose template.
genWorkenvir(workflow="systemPipeR/SPrnaseq", url = "https://raw.githubusercontent.com/systemPipeR/systemPipeRNAseq/cluster/vignettes/systemPipeRNAseq.Rmd",
urlname = "rnaseq_V-cluster.Rmd")
setwd("rnaseq")4 Dynamic generation of workflow template
It is possible to create a new workflow structure from RStudio
menu File -> New File -> R Markdown -> From Template -> systemPipeR New WorkFlow.
This interactive option creates the same environment as demonstrated above.
Figure 1: Selecting workflow template within RStudio.
5 Directory Structure
The workflow templates generated by genWorkenvir contain the following preconfigured directory structure:
- workflow/ (e.g. rnaseq/)
- This is the root directory of the R session running the workflow.
- Run script ( *.Rmd) and sample annotation (targets.txt) files are located here.
- Note, this directory can have any name (e.g. rnaseq, varseq). Changing its name does not require any modifications in the run script(s).
- Important subdirectories:
- param/
- Stores non-CWL parameter files such as: *.param, *.tmpl and *.run.sh. These files are only required for backwards compatibility to run old workflows using the previous custom command-line interface.
- param/cwl/: This subdirectory stores all the CWL parameter files. To organize workflows, each can have its own subdirectory, where all
CWL paramandinput.ymlfiles need to be in the same subdirectory.
- data/
- FASTQ files
- FASTA file of reference (e.g. reference genome)
- Annotation files
- etc.
- results/
- Analysis results are usually written to this directory, including: alignment, variant and peak files (BAM, VCF, BED); tabular result files; and image/plot files
- Note, the user has the option to organize results files for a given sample and analysis step in a separate subdirectory.
- param/
Note: Directory names are indicated in green. Users can change this structure as needed, but need to adjust the code in their workflows accordingly.
Figure 2: systemPipeR’s preconfigured directory structure.
6 Run workflows
Next, run from within R the chosen sample workflow by executing the code provided
in the corresponding *.Rmd template file.
Much more detailed information on running and customizing systemPipeR
workflows is available in its overview vignette here.
This vignette can also be opened from R with the following command.
library("systemPipeR") # Loads systemPipeR which needs to be installed via BiocManager::install() from Bioconductorvignette("systemPipeR", package = "systemPipeR")6.1 Return paths to sample data
The location of the sample data provided by systemPipeRdata can be returned as a list.
pathList()## $targets
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/param/targets.txt"
##
## $targetsPE
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/param/targetsPE.txt"
##
## $annotationdir
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/annotation/"
##
## $fastqdir
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/fastq/"
##
## $bamdir
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/bam/"
##
## $paramdir
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/param/"
##
## $workflows
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/workflows/"
##
## $chipseq
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/workflows/chipseq/"
##
## $rnaseq
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/workflows/rnaseq/"
##
## $riboseq
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/workflows/riboseq/"
##
## $varseq
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/workflows/varseq/"
##
## $new
## [1] "/tmp/RtmpGGAfP2/Rinst1f931b17baa7d5/systemPipeRdata/extdata/workflows/new/"7 Version information
sessionInfo()## R version 4.1.3 (2022-03-10)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 20.04.4 LTS
##
## Matrix products: default
## BLAS: /home/biocbuild/bbs-3.14-bioc/R/lib/libRblas.so
## LAPACK: /home/biocbuild/bbs-3.14-bioc/R/lib/libRlapack.so
##
## 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
##
## attached base packages:
## [1] stats4 stats graphics grDevices utils
## [6] datasets methods base
##
## other attached packages:
## [1] systemPipeRdata_1.22.3 systemPipeR_2.0.8
## [3] ShortRead_1.52.0 GenomicAlignments_1.30.0
## [5] SummarizedExperiment_1.24.0 Biobase_2.54.0
## [7] MatrixGenerics_1.6.0 matrixStats_0.61.0
## [9] BiocParallel_1.28.3 Rsamtools_2.10.0
## [11] Biostrings_2.62.0 XVector_0.34.0
## [13] GenomicRanges_1.46.1 GenomeInfoDb_1.30.1
## [15] IRanges_2.28.0 S4Vectors_0.32.4
## [17] BiocGenerics_0.40.0 BiocStyle_2.22.0
##
## loaded via a namespace (and not attached):
## [1] sass_0.4.1 jsonlite_1.8.0
## [3] bslib_0.3.1 assertthat_0.2.1
## [5] BiocManager_1.30.16 latticeExtra_0.6-29
## [7] GenomeInfoDbData_1.2.7 yaml_2.3.5
## [9] remotes_2.4.2 pillar_1.7.0
## [11] lattice_0.20-45 glue_1.6.2
## [13] digest_0.6.29 RColorBrewer_1.1-3
## [15] colorspace_2.0-3 htmltools_0.5.2
## [17] Matrix_1.4-1 pkgconfig_2.0.3
## [19] bookdown_0.25 zlibbioc_1.40.0
## [21] purrr_0.3.4 scales_1.1.1
## [23] jpeg_0.1-9 tibble_3.1.6
## [25] generics_0.1.2 ggplot2_3.3.5
## [27] ellipsis_0.3.2 cli_3.2.0
## [29] magrittr_2.0.3 crayon_1.5.1
## [31] evaluate_0.15 fansi_1.0.3
## [33] hwriter_1.3.2.1 tools_4.1.3
## [35] formatR_1.12 lifecycle_1.0.1
## [37] stringr_1.4.0 munsell_0.5.0
## [39] DelayedArray_0.20.0 compiler_4.1.3
## [41] jquerylib_0.1.4 rlang_1.0.2
## [43] grid_4.1.3 RCurl_1.98-1.6
## [45] htmlwidgets_1.5.4 bitops_1.0-7
## [47] rmarkdown_2.13 gtable_0.3.0
## [49] codetools_0.2-18 DBI_1.1.2
## [51] R6_2.5.1 knitr_1.38
## [53] dplyr_1.0.8 fastmap_1.1.0
## [55] utf8_1.2.2 stringi_1.7.6
## [57] parallel_4.1.3 vctrs_0.4.0
## [59] png_0.1-7 tidyselect_1.1.2
## [61] xfun_0.308 Funding
This project was supported by funds from the National Institutes of Health (NIH) and the National Science Foundation (NSF).
References
H Backman, Tyler W, and Thomas Girke. 2016. “systemPipeR: NGS workflow and report generation environment.” BMC Bioinformatics 17 (1): 388. https://doi.org/10.1186/s12859-016-1241-0.