Sovereign 8s.is mirror of standardgalactic/CenMAP
  • Python 98.6%
  • Makefile 0.6%
  • Awk 0.5%
  • Shell 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Keith Oshima 876f610d2c
Some checks failed
CI / test_scripts_and_workflow_logic (push) Has been cancelled
CI / test_workflow_chm13_chrY (push) Has been cancelled
CI / test_workflow_HG00731_mGorGor1_omit_rm (push) Has been cancelled
CI / test_workflow_HG002_chr2_nonlive (push) Has been cancelled
CI / test_workflow_mGorGor1_chr16 (push) Has been cancelled
CI / test_workflow_wrapper (push) Has been cancelled
Merge pull request #149 from logsdon-lab/feature/allow-set-perc-valid
feat: set percent valid in partial detection
2026-05-01 13:46:23 -04:00
.github/workflows Deploy configuration schema docs. 2026-01-13 01:13:33 -05:00
config Allow setting percent valid and drop to 90% by default for acrocentric cases. 2026-04-29 19:26:11 -04:00
data Remove unused files. Merge RM ref annotations. Update annotations README. 2025-09-10 21:57:05 -04:00
docs [no ci] Add test CI workflow for deploying docs. 2026-01-13 00:24:46 -05:00
test Fix no ref test. Update CDR-Finder workflow. 2026-01-11 05:17:47 -05:00
workflow Allow setting percent valid and drop to 90% by default for acrocentric cases. 2026-04-29 19:26:11 -04:00
.gitattributes Add experimental feature to omit repeatmasker. Make min 4 processes. Rename some files to better reflect workflow order. Renamed 7-fix_cens_w_repeatmasker to 7_finalize_cens. Refactor create_rm_overlay_bed awk code to script. Add workflow/scripts/filter_entropy_bed_kmers.py and integration test. 2025-12-07 05:31:12 -05:00
.gitignore Deploy configuration schema docs. 2026-01-13 01:13:33 -05:00
.gitmodules Fix assertion. Change CDR-Finder module to Logsdon lab version. Fix chromosomes arg. 2025-10-07 10:40:33 -04:00
.pre-commit-config.yaml Compress HOR hmm profile. 2025-09-10 21:41:47 -04:00
cenmap Bump version to v1.2.1. 2026-05-01 11:22:16 -04:00
env.yaml Update env yamls. 2025-12-11 13:27:13 -05:00
env_all.yaml Bump modkit. 2025-12-11 22:08:39 -05:00
LICENSE Removed NucFreq submodule. Added MIT license. Updated requirements. Updated README. 2024-04-07 22:05:21 -04:00
Makefile [no ci] Add test event for local CI testing with act. Update Makefile. Update docs. 2025-09-10 23:42:00 -04:00
README.md [no ci] Add citation. 2026-01-06 09:25:22 -05:00

CenMAP

CI GitHub Release install with bioconda

A centromere mapping and annotation pipeline for T2T human and non-human primate genome assemblies implemented in Snakemake.


Chr1 α-satellite higher-order repeat structure, centromere dip regions, and self-identity plot

Chr12 α-satellite HOR arrays

Ideogram

Cumulative α-satellite HOR array lengths

Quickstart

conda install bioconda::cenmap

For a single assembly:

# Find centromeres in human samples.
cenmap -i asm*.fa.gz -s HG002
# Find centromeres in non-human primate samples.
cenmap -i asm*.fa.gz -s mPanTro3 --mode nhp
# Find centromeres and validate with nucflag.
cenmap -i asm*.fa.gz -s HG002 --hifi hifi*.fq.gz
# Find centromeres and determine centromere dip regions.
cenmap -i asm*.fa.gz -s HG002 --ont ont*.bam
# Find centromeres, validate with nucflag, and determine centromere dip regions.
cenmap -i asm*.fa.gz -s HG002 --hifi hifi*.fq.gz --ont ont*.bam

For multiple assemblies:

# Create new config.
cenmap --generate-config > example.yaml
# Modify config parameters and include multiple samples.
# ...
# Then run.
cenmap --config example.yaml

Input

  • Verkko or hifiasm human or non-human primate genome assemblies
  • PacBio HiFi reads used in the assemblies
  • (Optional) Unaligned BAM files with 5mC modifications at CpG sites.

Output

  • Complete and correctly assembled centromere sequences and their regions validated by NucFlag.
  • Centromere α-satellite higher order repeat (HOR) array lengths via censtats.
  • RepeatMasker and HumAS-SD α-satellite HOR monomer of SF annotations and plots.
  • ModDotPlot sequence identity plots.
  • Combined sequence identity and HOR array structure plots via cenplot.
  • (Optional) Centromere dip region (CDRs) with CDR-Finder

Documentation

Read the docs on the CenMAP wiki.

Tests

To run tests, refer to the wiki page.

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