nf-core/fastquorum
Pipeline to produce consensus reads using unique molecular indexes/barcodes (UMIs)
1.0.0
). The latest
stable release is
1.1.0
.
Introduction
nf-core/fastquorum is a bioinformatics pipeline that implements the pipeline implements the fgbio Best Practices FASTQ to Consensus Pipeline to produce consensus reads using unique molecular indexes/barcodes (UMIs).
nf-core/fastquorum
can produce consensus reads from single or multi UMI reads, and even Duplex Sequencing reads.
The pipeline is built using Nextflow, a workflow tool to run tasks across multiple compute infrastructures in a very portable manner. It uses Docker/Singularity containers making installation trivial and results highly reproducible. The Nextflow DSL2 implementation of this pipeline uses one container per process which makes it much easier to maintain and update software dependencies. Where possible, these processes have been submitted to and installed from nf-core/modules in order to make them available to all nf-core pipelines, and to everyone within the Nextflow community!
On release, automated continuous integration tests run the pipeline on a full-sized dataset on the AWS cloud infrastructure. This ensures that the pipeline runs on AWS, has sensible resource allocation defaults set to run on real-world datasets, and permits the persistent storage of results to benchmark between pipeline releases and other analysis sources. The results obtained from the full-sized test can be viewed on the nf-core website.
Tools | Description |
---|---|
- Read QC (
FastQC
) - Fastq to BAM, extracting UMIs (
fgbio FastqToBam
) - Align (
bwa mem
), reformat (fgbio ZipperBam
), and template-coordinate sort (samtools sort
) - Group reads by UMI (
fgbio GroupReadsByUmi
) - Call consensus reads
- For Duplex-Sequencing data
- Call duplex consensus reads (
fgbio CallDuplexConsensusReads
) - Collect duplex sequencing specific metrics (
fgbio CollectDuplexSeqMetrics
)
- Call duplex consensus reads (
- For non-Duplex-Sequencing data:
- Call molecular consensus reads (
fgbio CallMolecularConsensusReads
)
- Call molecular consensus reads (
- For Duplex-Sequencing data
- Align (
bwa mem
) - Filter consensus reads (
fgbio FilterConsensusReads
) - Present QC (
MultiQC
)
Verified Vendors, Kits, and Assays
The following Vendors, Kits, and Assays are provided for informational purposes only.
No warranty for the accuracy or completeness of the information or parameters is implied.
Verified | Assay | Company | Strand | Randomness | UMI Location | Read Structure | URL |
---|---|---|---|---|---|---|---|
No | SureSelect XT HS | Agilent Technologies | Single | Random | link | ||
No | SureSelect XT HS2 (MBC) | Agilent Technologies | Dual | Random | link | ||
No | TruSight Oncology (TSO) | Illumina | Dual | Nonrandom | link | ||
No | xGen dual index UMI Adapters | Integrated DNA Technologies | Single | Random | index1 (i7) | link | |
No | xGen Prism (xGen cfDNA & FFPE DNA Library Prep MC v2 Kit) | Integrated DNA Technologies | Dual | Nonrandom | link | ||
No | NEBNext | New England Biosciences | Single | Random | index1 (i7) | link | |
No | AML MRD | TwinStrand Biosciences | Dual | Random | link | ||
No | Mutagenesis | TwinStrand Biosciences | Dual | Random | link | ||
No | UMI Adapter System | Twist Biosciences | Dual | Random | Inline (R1 & R2) | 5M2S+T 5M2S+T | link |
Column Definitions:
- Assay: the name of the assay or kit
- Company: the name of the company or vendor providing the assay or kit
- Strand: Dual if both strands of a double-stranded source molecule are sequences (e.g. Duplex Sequencing), Single otherwise
- Randomness: if the unique molecular identifiers (UMIs) are fully random (degenerate) or are synthesized from a fixed set
- UMI Location: the location of UMIs within the reads.
- Read Structure: the [
read_structure
][read-structure-link] describes how the bases in a sequencing run should be allocated into logical reads, including the unique molecular index(es) - URL: link(s) to vendor documentation or further information
To become “Verified” by nf-core/fastquorum
, please open an issue and provide the maintainers with an example dataset that can be shared publicly.
The dataset or a subset will be added to nf-core/test-datasets.
Please reach out to maintainers if additional support is needed to prepare or select such data.
Usage
If you are new to Nextflow and nf-core, please refer to this page on how to set-up Nextflow. Make sure to test your setup with -profile test
before running the workflow on actual data.
First, prepare a samplesheet with your input data that looks as follows:
samplesheet.csv
:
Each row represents a fastq file (single-end) or a pair of fastq files (paired end).
The sample
column provides a unique identifier for the given sample, while the read_structure
describes how the bases in a sequencing run should be allocated into logical reads, including the unique molecular index(es).
(Please see the fgbio documentation for detailed information on read structure syntax and formatting.)
Now, you can run the pipeline using:
Please provide pipeline parameters via the CLI or Nextflow -params-file
option. Custom config files including those provided by the -c
Nextflow option can be used to provide any configuration except for parameters;
see docs.
Two modes of running this pipeline are supported:
- Research and Development (R&D): use
--mode rd
orparams.mode=rd
. This mode is desirable to be able to branch off from the pipeline and test e.g. multiple consensus calling or filtering parameters - High Throughput (HT): use
--mode ht
orparams.mode=ht
. This mode is intended for high throughput production environments where performance and throughput take precedence over flexibility
For more details and further functionality, please refer to the usage documentation and the parameter documentation.
See also:
- The fgbio Best Practise FASTQ -> Consensus Pipeline
- Read structures as required in the input sample sheet.
Pipeline output
To see the results of an example test run with a full size dataset refer to the results tab on the nf-core website pipeline page. For more details about the output files and reports, please refer to the output documentation.
Credits
nf-core/fastquorum was originally written and is primarily maintained by Nils Homer.
We thank the following people for their extensive assistance in the development of this pipeline:
Acknowledgements
We thank Fulcrum Genomics for their extensive assistance in the development of this pipeline.
Contributions and Support
If you would like to contribute to this pipeline, please see the contributing guidelines.
For further information or help, don’t hesitate to get in touch on the Slack #fastquorum
channel (you can join with this invite).
Citations
If you use nf-core/fastquorum for your analysis, please cite for this pipeline and for fgbio
.
An extensive list of references for the tools used by the pipeline can be found in the CITATIONS.md
file.
You can cite the nf-core
publication as follows:
The nf-core framework for community-curated bioinformatics pipelines.
Philip Ewels, Alexander Peltzer, Sven Fillinger, Harshil Patel, Johannes Alneberg, Andreas Wilm, Maxime Ulysse Garcia, Paolo Di Tommaso & Sven Nahnsen.
Nat Biotechnol. 2020 Feb 13. doi: 10.1038/s41587-020-0439-x.