Skip to content
Snippets Groups Projects
user avatar
Holly Ruess authored
586ddd0c

Astrocyte ATAC-seq analysis Workflow Package

Build Status Coverage Report Nextflow Astrocyte

Introduction

BICF ATAC-seq is a bioinformatics best-practice analysis pipeline used for ATAC-seq (Assay for Transposase-Accessible Chromatin using sequencing) data analysis at BICF at UT Southwestern Department of Bioinformatics.

The pipeline uses Nextflow, a bioinformatics workflow tool. It pre-processes raw data from FastQ inputs, aligns the reads and performs extensive quality-control on the results.

This pipeline is primarily used with a SLURM cluster on the BioHPC Cluster. However, the pipeline should be able to run on any system that supports Nextflow.

Additionally, the pipeline is designed to work with Astrocyte Workflow System using a simple web interface.

Current version of the software and issue reports are at https://git.biohpc.swmed.edu/BICF/Astrocyte/atacseq_analysis

To download the current (working not tagged) version of the software

$ git clone git@git.biohpc.swmed.edu:BICF/Astrocyte/atacseq_analysis.git

Input files

1) Fastq Files
  • You will need the full path to the files for the Bash Scipt

Design file

  • The Design file is a tab-delimited file with 4 columns for Single-End and 5 columns for Paired-End. Letter, numbers, and underlines can be used in the names. However, the names must begin with a letter. Columns must be as follows:

    1. sample_id - The id of the sample. This will be the header in output files, please make sure it is concise
    2. experiment_id - Same name given for all replicates of treatment. Will be used for the consensus header.
    3. replicate - Replicate number
    4. fastq_read1 - Name of fastq file 1 for SE or PE data
    5. fastq_read2 - Name of fastq file 2 for PE data
  • See HERE for an example design file, paired-end

  • See HERE for an example design file, single-end

Pipeline

  • There are ??? steps to the pipeline
    1. Check input files
    2. Trim adaptors with TrimGalore!
    3. Map reads with BWA, filter with SamTools, and sort with Sambamba
    4. Mark duplicates with Sambamba, Filter reads with SamTools, and calculate library complexity with SamTools and bedtools
    5. QC metrics with deep tools
    6. Calculate cross-correlation using PhantomPeakQualTools
    7. Call peaks with MACS2 from overlaps of pooled replicates

Output Files

Folder File Description
design N/A Inputs used for analysis; can ignore
trimReads *_trimming_report.txt report detailing how many reads were trimmed
trimReads *_trimmed.fq.gz trimmed fastq files used for analysis
alignReads *.flagstat.qc QC metrics from the mapping process
alignReads *.bam sorted bam file
filterReads *.dedup.qc QC metrics of find duplicate reads (sambamba)
filterReads *.dedup.bam filtered bam file with duplicate reads removed
filterReads *.dedup.bam.bai indexed filtered bam file
filterReads *.dedup.flagstat.qc QC metrics of filtered bam file (mapping stats, samtools)
filterReads *.dedup.pbc.qc QC metrics of library complexity
convertReads *.filt.nodup.bedse.gz bed alignment in BEDPE format
convertReads *.tagAlign.gz bed alignent in BEDPE or BEDSE format
experimentQC coverage.pdf plot to assess the sequencing depth of a given sample
experimentQC heatmeap_SpearmanCorr.pdf plot of Spearman correlation between samples
experimentQC heatmeap_PearsonCorr.pdf plot of Pearson correlation between samples
experimentQC sample_mbs.npz array of multiple BAM summaries
crossReads *.cc.plot.pdf Plot of cross-correlation to assess signal-to-noise ratios
crossReads *.cc.qc cross-correlation metrics. File HEADER

Common Errors

If you find an error, please let the BICF know and we will add it here.

Citation

Please cite individual programs and versions used HERE, and the pipeline doi: coming soon. Please cite in publications: Pipeline was developed by BICF from funding provided by Cancer Prevention and Research Institute of Texas (RP150596).

Credits

This example worklow is derived from original scripts kindly contributed by the Bioinformatic Core Facility (BICF), in the Department of Bioinformatics.