atacseq-qc
Performs ATAC-specific biological validation. It calculates metrics unique to chromatin accessibility assays, such as TSS enrichment scores and fragment size distributions (nucleosome banding patterns). Use this skill when you have filtered BAM file and have called peak for the file. Do NOT use this skill for ChIP-seq data or general alignment statistics.
When & Why to Use This Skill
The ATACseq-QC skill automates the biological validation and quality control process for ATAC-seq (Assay for Transposase-Accessible Chromatin using sequencing) data. It streamlines the calculation of specialized metrics such as Transcription Start Site (TSS) enrichment scores, fragment size distributions (nucleosome banding patterns), and Fraction of Reads in Peaks (FRiP), ensuring high-quality chromatin accessibility analysis.
Use Cases
- Case 1: Validating the biological quality of ATAC-seq libraries by analyzing nucleosome banding patterns and TSS enrichment to ensure successful transposition.
- Case 2: Generating standardized QC reports (ataqv) for genomic research publications to demonstrate data reliability and signal-to-noise ratios.
- Case 3: Automating the setup of bioinformatics pipelines by detecting chromosome naming conventions and generating genome-specific reference files for human, mouse, or other model organisms.
- Case 4: Performing high-throughput quality assessment across multiple samples to identify outliers or technical failures in chromatin accessibility assays.
| name | ATACseq-QC |
|---|---|
| description | Performs ATAC-specific biological validation. It calculates metrics unique to chromatin accessibility assays, such as TSS enrichment scores and fragment size distributions (nucleosome banding patterns). Use this skill when you have filtered BAM file and have called peak for the file. Do NOT use this skill for ChIP-seq data or general alignment statistics. |
ATAC-seq Quality Control
Overview
This skill performs complete ATAC-seq data quality control from BAM and peak files.
Main steps include:
- Refer to the Inputs & Outputs section to check inputs and build the output architecture. All the output file should located in
${proj_dir}in Step 0. - Always prompt user for genome assembly used. Never decide by yourself.
- Generate TSS files according to genome assembly.
- Compute TSS enrichment, fragment distribution and FRiP.
Inputs & Outputs
Inputs
${sample}.bam # filtered bam files
${sample}.narrowPeak
Outputs
all_atac_qc/
${sample}_qc_results/
ataqv_metrics.json
ataqv_report.html/
temp/
Decision Tree
Step 0: Initialize Project
Call:
mcp__project-init-tools__project_init
with:
sample: alltask: atac_qcgenome: provided by user
The tool will:
- Create
all_atac_qcdirectory. - Return the full path of the
all_atac_qcdirectory, which will be used as${proj_dir}.
Step 1: Detect the name logic of the chromosomes in BAM file (have "chr" as prefix or not)
samtools view <sample>.bam | head -n 10 | cut -f 3
Step 2: Generate reference files
Call:
- mcp__qc-tools__generate_reference
with:
genome: Genome name (e.g., hg38), provided by usertemp_dir: ${proj_dir}/tempbam_uses_chr: True if BAM uses 'chr' prefix (chr1), False if not (1).
Step 3: Peform quality control for the ATAC-seq data
Call:
mcp__qc-tools__run_ataqv_qc
bam_file: Path to filtered BAM filepeak_file: Path to peak file (narrowPeak) corresponding to the BAM filetss_file: ${proj_dir}/temp/${genome}.tssspecies: Species used, choose from (fly, human, mouse, rat, worm, yeast)bam_uses_chr: True if BAM uses 'chr' prefix (chr1), False if not (1).output_dir: ${proj_dir}/${sample}_qc_resultsautosomal_ref_path: Provided ifbam_uses_chris False, ${proj_dir}/temp/${genome}.autosomal.ref