Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
gptomics avatar

Bio Methylation Bismark Alignment

  • 4 installs
  • 1.1k repo stars
  • Updated July 25, 2026
  • gptomics/bioskills

Align bisulfite sequencing reads with Bismark using bowtie2/hisat2, including genome preparation, producing BAMs with methylation information.

About

Aligns bisulfite-converted sequencing reads to a reference using Bismark with bowtie2 or hisat2, handling genome preparation. A developer uses it when aligning WGBS, RRBS, or other bisulfite reads.

  • Bismark genome prep and alignment
  • Produces BAMs with methylation info

Bio Methylation Bismark Alignment by the numbers

  • 4 all-time installs (skills.sh)
  • Ranked #1,625 of 2,064 Data Science & ML skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/gptomics/bioskills --skill bio-methylation-bismark-alignment

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs4
repo stars1.1k
Last updatedJuly 25, 2026
Repositorygptomics/bioskills

What it does

Align bisulfite sequencing reads with Bismark using bowtie2/hisat2, including genome preparation, producing BAMs with methylation information.

Files

SKILL.mdMarkdownGitHub ↗

Bismark Alignment

Prepare Genome Index

# One-time genome preparation (creates bisulfite-converted index)
bismark_genome_preparation --bowtie2 /path/to/genome_folder/

# Genome folder should contain FASTA files (e.g., hg38.fa, chr1.fa, etc.)
# Creates Bisulfite_Genome/ subdirectory with CT and GA converted indices

Basic Single-End Alignment

bismark --genome /path/to/genome_folder/ reads.fastq.gz -o output_dir/

Paired-End Alignment

bismark --genome /path/to/genome_folder/ \
    -1 reads_R1.fastq.gz \
    -2 reads_R2.fastq.gz \
    -o output_dir/

Common Options

bismark --genome /path/to/genome_folder/ \
    --bowtie2 \                    # Use bowtie2 (default)
    --parallel 4 \                 # Number of parallel instances
    --temp_dir /tmp/ \             # Temporary directory
    --non_directional \            # For non-directional libraries
    --nucleotide_coverage \        # Generate nucleotide coverage report
    -o output_dir/ \
    reads.fastq.gz

RRBS Mode

# Reduced Representation Bisulfite Sequencing
bismark --genome /path/to/genome_folder/ \
    --pbat \                       # For PBAT libraries (post-bisulfite adapter tagging)
    reads.fastq.gz

# MspI digestion (RRBS standard)
# Bismark handles MspI-digested libraries automatically

PBAT Libraries

# Post-Bisulfite Adapter Tagging (e.g., scBS-seq)
bismark --genome /path/to/genome_folder/ --pbat reads.fastq.gz

Non-Directional Libraries

# For libraries where all 4 strands are present
bismark --genome /path/to/genome_folder/ --non_directional reads.fastq.gz

With Quality/Adapter Trimming (Pre-alignment)

# Trim adapters first with Trim Galore (recommended)
trim_galore --illumina --paired reads_R1.fastq.gz reads_R2.fastq.gz

# Then align
bismark --genome /path/to/genome_folder/ \
    -1 reads_R1_val_1.fq.gz \
    -2 reads_R2_val_2.fq.gz

Multicore Processing

# --parallel sets instances per alignment direction
# Total threads = parallel * 2 (for directional) or parallel * 4 (non-directional)
bismark --genome /path/to/genome_folder/ \
    --parallel 4 \
    reads.fastq.gz

Output Files

# Bismark produces:
# - reads_bismark_bt2.bam          # Aligned reads
# - reads_bismark_bt2_SE_report.txt # Alignment report

# View alignment report
cat output_dir/reads_bismark_bt2_SE_report.txt

Sort and Index BAM

# Bismark output is unsorted
samtools sort output.bam -o output.sorted.bam
samtools index output.sorted.bam

Deduplicate (Optional)

# Remove PCR duplicates (recommended for WGBS, not RRBS)
deduplicate_bismark --bam output_bismark_bt2.bam

# For paired-end
deduplicate_bismark --paired --bam output_bismark_bt2_pe.bam

Check Alignment Statistics

# Bismark generates detailed report
cat *_SE_report.txt

# Key metrics:
# - Sequences analyzed
# - Unique alignments
# - Mapping efficiency
# - C methylated in CpG context

Genome Preparation with HISAT2 (Recommended for Large Genomes)

# HISAT2 is faster and uses less memory for large mammalian genomes
bismark_genome_preparation --hisat2 /path/to/genome_folder/

# Align with HISAT2
bismark --genome /path/to/genome_folder/ --hisat2 reads.fastq.gz

# HISAT2 paired-end
bismark --genome /path/to/genome_folder/ --hisat2 \
    -1 reads_R1.fastq.gz \
    -2 reads_R2.fastq.gz

Key Parameters

ParameterDescription
--genomePath to genome folder
--bowtie2Use Bowtie2 aligner (default)
--hisat2Use HISAT2 aligner
--parallelParallel alignment instances
--non_directionalNon-directional library
--pbatPBAT library protocol
-oOutput directory
--temp_dirTemporary file directory
--nucleotide_coverageGenerate nuc coverage report
-NMismatches in seed (0 or 1, default 0)
-LSeed length (default 20)

Library Types

TypeParameterDescription
Directional(default)Standard WGBS/RRBS
Non-directional--non_directionalAll 4 strands
PBAT--pbatPost-bisulfite adapter tagging

Related Skills

  • methylation-calling - Extract methylation from Bismark BAM
  • methylkit-analysis - Import Bismark output to R
  • sequence-io/read-sequences - FASTQ handling
  • alignment-files/sam-bam-basics - BAM manipulation

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.