nf-core pipeline · chip, chip-seq, chromatin-immunoprecipitation
nf-core/chipseq
A Nextflow pipeline for ChIP-seq quality control, alignment, peak calling, and differential binding analysis.
What nf-core/chipseq is
nf-core/chipseq is a bioinformatics pipeline designed for Chromatin ImmunoPrecipitation sequencing (ChIP-seq) data. It was originally developed by Chuan Wang and Phil Ewels at the National Genomics Infrastructure at SciLifeLab in Stockholm, Sweden, re-implemented by Harshil Patel at Seqera Labs, and converted to Nextflow DSL2 by Jose Espinosa-Carrasco at the Centre for Genomic Regulation.
The workflow resolves the challenge of standardising ChIP-seq analysis from raw sequencing reads through to biological interpretation. By automating quality assessment, read mapping, stringent filtering, peak detection, and comparative exploration, it provides researchers with reproducible results across different compute environments and experimental targets.
What the pipeline does
The workflow begins with raw read quality control using FastQC and adapter trimming via Trim Galore!. Sequencing reads are mapped to a reference genome using a choice of aligners: BWA, Chromap, Bowtie2, or STAR. Alignments have duplicates marked with Picard and can be merged across multiple sequencing libraries for the same sample. Reads undergo filtering to remove duplicates, unmapped alignments, multimapping reads, non-primary alignments, reads within blacklisted regions, and alignments containing more than four mismatches. For paired-end data, filtering additionally removes pairs with insert sizes over 2 kilobases, incorrect forward-reverse orientations, or reads mapping to different chromosomes.
Downstream analysis assesses library complexity with Preseq and Picard, calculates normalised coverage bigWig files scaled to 1 million mapped reads, and generates gene-body meta-profiles and genome-wide fingerprint enrichment metrics using deepTools. Normalised strand cross-correlation measures (NSC and RSC) are computed using phantompeakqualtools. Broad or narrow peaks are called with MACS3 and annotated against gene features using HOMER. BEDTools compiles a consensus peakset across samples, featureCounts quantifies read counts within consensus intervals, and DESeq2 conducts sample clustering and principal component analysis. An IGV session is assembled for visualisation, and MultiQC aggregates all quality metrics.
Key facts
- Workflow manager
- Nextflow DSL2
- Latest release
- 2.1.0
- Supported aligners
- BWA, Chromap, Bowtie2, STAR
- Peak caller
- MACS3
- Differential analysis
- DESeq2, R
- Quality reporting
- MultiQC, FastQC, phantompeakqualtools
- Input formats
- FASTQ, samplesheet CSV
- Key outputs
- BAM, bigWig, peak files, IGV session, MultiQC HTML
What you can use it for
- Transcription factor binding detection
- Identifies narrow enrichment regions for transcription factors such as FoxA1 across the genome relative to matched input control samples.
- Histone modification profiling
- Maps broad histone mark domains such as EZH2 and evaluates signal distribution using gene-body meta-profiles.
- Differential binding and clustering
- Counts read occupancies across consensus peaks and performs sample clustering and principal component analysis across conditions.
- Multi-library sample consolidation
- Merges multiple sequencing runs and libraries per sample with unified duplicate re-marking and quality filtering.
Run it here
The research agent runs nf-core/chipseq with Nextflow on its own machine — up to 32 cores, 256 GiB of memory and 24 hours per run, which covers the test profile and real single-sample runs. It builds the samplesheet, checks it against the pipeline's schema and reads the results back. When a run is too big for one machine, it gives you the exact command for your own cluster instead.
Strengths and limits
Good at
- Offers a choice of four aligners including BWA, Chromap, Bowtie2, and STAR to fit diverse alignment preferences.
- Applies comprehensive alignment filtering to exclude blacklisted regions, multimappers, high mismatch counts, and discordant read pairs.
- Calculates specialised ChIP-seq enrichment metrics including normalised and relative strand cross-correlation coefficients alongside fingerprint plots.
- Produces ready-to-load IGV session files and coverage bigWig tracks normalised to 1 million mapped reads.
Watch out for
- Several filtering criteria, including insert size limits and chromosome concordance checks, are only applied to paired-end data.
- Custom Nextflow configuration files cannot be used to supply pipeline parameters, which must be passed strictly via the command-line interface or parameter files.
Questions
Can I run nf-core/chipseq without my own cluster?
The research agent runs nf-core/chipseq with Nextflow on its own machine — up to 32 cores, 256 GiB of memory and 24 hours per run, which covers the test profile and real single-sample runs. It builds the samplesheet, checks it against the pipeline's schema and reads the results back. When a run is too big for one machine, it gives you the exact command for your own cluster instead.
What licence is nf-core/chipseq under?
MIT, like every nf-core pipeline.
Which aligners are available in the pipeline?
The pipeline supports four alignment tools: BWA, Chromap, Bowtie2, and STAR.
Can both narrow and broad peaks be analysed?
Yes, MACS3 is used within the workflow to call both narrow and broad peaks depending on the antibody and experimental design.
How are input samples specified?
Samples are supplied via a comma-separated samplesheet specifying sample identifiers, FASTQ file paths, replicate numbers, antibody names, and matched control library details.
What alignment quality metrics are reported?
The pipeline reports library complexity via Preseq, cross-correlation values including NSC and RSC via phantompeakqualtools, and genome-wide IP enrichment plots via deepTools.
How to cite it
Philip Ewels, Alexander Peltzer, Sven Fillinger, Harshil Patel, Johannes Alneberg, Andreas Wilm, Maxime Ulysse Garcia, Paolo Di Tommaso & Sven Nahnsen. The nf-core framework for community-curated bioinformatics pipelines. Nat Biotechnol. 2020 Feb 13. doi: 10.1038/s41587-020-0439-x.
Written from nf-core/chipseq's own README. Statements citing a figure that does not appear there are removed before publication. Licence and running details come from our registry.