- Python 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .github/workflows | ||
| config | ||
| docs/images | ||
| paper | ||
| test | ||
| workflow | ||
| .gitignore | ||
| .gitmodules | ||
| .pre-commit-config.yaml | ||
| env.yaml | ||
| LICENSE | ||
| README.md | ||
Mutation Rate Analysis
Calculate mutation rate of query regions against a reference region.
HGSVC chr1 centromere clade,
chr1@6, (HG03520 H1 and 16 similar HGSVC haplotypes; seepaper/data/all_query.bed) mutation rate plot with satellite structure, local self sequence identity, and mutation rate.
Getting Started
Clone the repo and setup Snakemake and other requirements.
git clone https://github.com/logsdon-lab/Snakemake-MutationRate.git --recursive
cd Snakemake-MutationRate
# Load or install apptainer
# module load apptainer
which apptainer
conda env create --name smk-mut-rate -f env.yaml
conda activate smk-mut-rate
Configuration
# Alignment memory.
mem: 100GB
# Alignment threads.
threads: 8
# Directories
output_dir: "results"
log_dir: "logs"
benchmarks: "benchmarks"
# Reference config.
reference:
- name: reference
# Sample fasta.
path: reference.fasta
# Chromosome specific bed files of windows to evaluate. Filename is region name.
# Each window must have a chromosome name
# Can be created from a region bedfile via, bedtools makewindows -w "${window_size}" -b "${bedfile}"
bed:
- reference_chr1.bed
# Calculate rate for this region relative to everything else not in bed.
bed_comparison: reference.bed
# Reference region cenplot format configuration
# The mutation rate plot is added as the final track with legend elements for each track added in relative order.
plot_format: annotation.toml
# Regular expression patterns within fasta headers to find haplotype and matching chromosome.
# Used to group and filter alignments by exact match.
regex_sm_hap: "(mat|pat|haplotype1|haplotype2|hap1|hap2|h1|h2)"
regex_sm_chrom: "_(hsa(.*?)|chr(.*?)|cen(.*?))[:_]"
regex_ref_chrom: "(?:chr|hsa|cen)([0-9XY]{1,2})"
# Samples to align against each reference.
samples:
- name: query
# Query fasta
path: query.fasta
# Query bedfile. If none, entire region used.
bed: query.bed
# Minimap2 parameters. Important.
# Preset of asm20 recommmended if highly divergent region.
mm2_opts: -x asm20 --secondary=no -K 8G -t 8
# Assumed divergence time from reference.
divergence_time: 0
# Shape of alignment datapoint.
shape: 'o'
# Color of alignment datapoint as hexcode or color name.
color: "red"
Input
The main inputs are:
- Reference fasta (
reference.path) - Reference BED coordinates (
reference.bed) - Query fasta (
samples[n].path) - Query BED coordinates (
samples[n].bed)
Note
Should include chromosome and haplotype information in fasta names to filter alignments with
config.regex_*. ex.HG00096_chr1_haplotype1-00000X
Output
The main output files have the following prefix: results/{clade}/mutation_rate/{contig_name}/{clade}
| file | desc |
|---|---|
{clade}_annot.bedpe |
BEDPE-like file with paired intervals and their mutation rate. Includes header with columns: ref_chrom,ref_st,ref_end,mu,qry_chrom,qry_st,qry_end,ref_sm,qry_sm,category |
{clade}_mut.tsv |
TSV file with summary of mutation rates with format: ref_chrom,clade,cmp_mutation_rate,non_cmp_mutation-rate,fold_mutation_rate, |
{clade}.pdf |
PDF of mutation rate plot. |
{clade}.png |
PNG of mutation rate plot. |
Usage
snakemake -p --configfile config/config.yaml -j 40
Test
Mutation rate of CHM13 chr5 to CHM1 and Chimpanzee.
snakemake -p --configfile test/config/config_cen_var_glogsdon_small.yaml -c 4 -n
Mutation rate of CHM13 chr5 + chrX to CHM1, HG00733, Chimpanzee, Oranguatan, and Macaque.
# Rerun mutation rate estimation.
# https://www.nature.com/articles/s41586-024-07278-3#Sec6
# Recommend using cluster.
snakemake -p --configfile test/config/config_cen_var_glogsdon.yaml -j 40 -n --workflow-profile workflow/profiles/lpc
WIP
Sources
Cite
Gao S, Oshima KK, Chuang SC, Loftus M, Montanari A, Gordon DS, Human Genome Structural Variation Consortium, Human Pangenome Reference Consortium, Hsieh P, Konkel MK, Ventura M, Logsdon GA. A global view of human centromere variation and evolution. bioRxiv. 2025. p. 2025.12.09.693231. doi:10.64898/2025.12.09.693231

