Sovereign 8s.is mirror of standardgalactic/Snakemake-HumAS-SD
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-12-22 17:50:46 -05:00
config Fix chr21 b array monomer and chrX hybrid monomer edge-case breaking HOR. Decreased identity threshold from 90.0 to 85.0. 2025-02-12 11:21:47 -05:00
data First commit. Functional workflow. 2024-10-23 02:15:20 -04:00
test Fix chr21 b array monomer and chrX hybrid monomer edge-case breaking HOR. Decreased identity threshold from 90.0 to 85.0. 2025-02-12 11:21:47 -05:00
workflow Allow SD to fail in cases where N's are present. 2025-02-12 13:14:05 -05:00
.gitattributes Change final bed to not perform any identity filtering. Change stv script to filter and handle chrX cen edge case. 2024-12-17 19:24:06 -05:00
.gitignore Change chr parsing to look at chr name in monomer rather than in ctg name. Addresses #1. Add tests. 2024-12-09 11:11:15 -05:00
.pre-commit-config.yaml Make check for special chr edge cases more resilient to name differences. 2024-12-07 16:41:15 -05:00
env.yaml First commit. Functional workflow. 2024-10-23 02:15:20 -04:00
env_dev.yaml Change chr parsing to look at chr name in monomer rather than in ctg name. Addresses #1. Add tests. 2024-12-09 11:11:15 -05:00
LICENSE Add MIT license. 2025-12-22 17:50:46 -05:00
README.md Update README. 2025-12-22 17:46:51 -05:00

Snakemake-HumAS-SD

Workflow to use stringdecomposer to annotate alpha-satellite HOR monomers.

Usage

conda env create -f env.yaml --name humas_sd
conda activate humas_sd
snakemake -np --sdm conda --configfile config/config.yaml -c 1

Input

Expects .fa files in input_dir with chr? in name.

  • ex. chr3.fa, HG0002_ch3_new.fa, or HG00171_chr3.fa

Output

  1. results/{contig}/stv_row.bed
    • HOR variants
  2. results/{contig}/final_decomposition.bed
    • StringDecomposer output formatted as BED9 file

Configuration

# Input directory with fa files.
input_dir: "cens"
# Various directories.
output_dir: "results"
benchmarks_dir: "benchmarks"
logs_dir: "logs"
# Input HMM profile with all possible monomers.
# May remove.
hmm_profile: "data/AS-HORs-hmmer.hmm"
# Threads passed to stringdecomposer
threads: 4

Test

Workflow

On HG01596 chr3 H1.

# ~5-10 minutes.
snakemake -np --sdm conda --configfile test/config/config.yaml -c 4

Compare HumAS-HMMER

Two centromere HOR annotation bed files.

  1. Output from HumAS-HMMER_for_AnVIL using https://github.com/logsdon-lab/CenMAP/blob/main/data/models/AS-HORs-hmmer3.0-170921.hmm.
  2. Output from stringdecomposer.

Note

From HGSVC3 sample , HG01596_chr3_haplotype1-0000018:7760823-18212765, which was extracted via CenMAP v0.1.5.

python test/scripts/compare.py
Number of shared HORs annotated: 22894
Average Length Difference: 1.1741504324277103
Live:
        Correct: 18245
        Total: 18327
        Perc: 99.55257270693512
Other:
        Correct: 3880
        Total: 4567
        Perc: 84.9573023866871

Sources

  1. HMM profile:

  2. Based on annotations from:

    • Shepelev VA, Uralsky LI, Alexandrov AA, Yurov YB, Rogaev EI, Alexandrov IA. Annotation of suprachromosomal families reveals uncommon types of alpha satellite organization in pericentromeric regions of hg38 human genome assembly. Genom Data. 2015;5:139-146. doi:10.1016/j.gdata.2015.05.035

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