Skip to content

Pipeline to produce consensus reads using unique molecular indexes/barcodes (UMIs)

License

Notifications You must be signed in to change notification settings

nf-core/fastquorum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nf-core/fastquorum

GitHub Actions CI Status GitHub Actions Linting StatusAWS CICite with Zenodo nf-test Nextflow run with conda run with docker run with singularity Launch on Seqera Platform

Get help on SlackFollow on TwitterFollow on MastodonWatch on YouTube

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

  1. Read QC (FastQC)
  2. Fastq to BAM, extracting UMIs (fgbio FastqToBam)
  3. Align (bwa mem), reformat (fgbio ZipperBam), and template-coordinate sort (samtools sort)
  4. Group reads by UMI (fgbio GroupReadsByUmi)
  5. Call consensus reads
    1. For Duplex-Sequencing data
      1. Call duplex consensus reads (fgbio CallDuplexConsensusReads)
      2. Collect duplex sequencing specific metrics (fgbio CollectDuplexSeqMetrics)
    2. For non-Duplex-Sequencing data:
      1. Call molecular consensus reads (fgbio CallMolecularConsensusReads)
  6. Align (bwa mem)
  7. Filter consensus reads (fgbio FilterConsensusReads)
  8. Present QC (MultiQC)

Verified Vendors, Kits, and Assays

Warning

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

Note

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:

sample,fastq_1,fastq_2,read_structure
CONTROL_REP1,AEG588A1_S1_L002_R1_001.fastq.gz,AEG588A1_S1_L002_R2_001.fastq.gz,5M2S+T 5M2S+T

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:

nextflow run nf-core/fastquorum \
   -profile <docker/singularity/.../institute> \
   --input samplesheet.csv \
   --genome GRCh38 \
   --outdir <OUTDIR>

Warning

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:

  1. Research and Development (R&D): use --mode rd or params.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
  2. High Throughput (HT): use --mode ht or params.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:

  1. The fgbio Best Practise FASTQ -> Consensus Pipeline
  2. 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.

Fulcrum Genomics

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 DOI for this pipeline and DOI 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.