archaic-introgression
Detect Neanderthal and Denisovan introgression segments from modern human genomes
ClawBio · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add ClawBio/ClawBio --skill archaic-introgression技能说明
name: archaic-introgression description: Detect Neanderthal and Denisovan introgression segments from modern human genomes license: MIT metadata: version: 0.1.0 author: Manuel Corpas domain: genomics inputs:
- format: VCF description: Modern human genotypes required: true
- format: VCF description: Archaic reference genotypes (Neanderthal/Denisovan) required: true outputs:
- format: JSON description: Introgression segments with scores and summary statistics
- format: BED
description: Genomic coordinates of introgressed segments
openclaw:
requires:
bins:
- python3 always: false emoji: 🦴 homepage: https://github.com/ClawBio/ClawBio os:
- darwin
- linux trigger_keywords:
- archaic introgression
- Neanderthal DNA
- Denisovan ancestry
- IBDmix
- Sprime
- hmmix
- introgressed segments
Archaic Introgression Detector
Trigger
Fire when:
- User asks about Neanderthal or Denisovan DNA in modern humans
- User wants to detect archaic introgression segments
- User mentions IBDmix, Sprime, or hmmix methods
- User has modern + archaic VCF files and wants to compare them
Do NOT fire when:
- User asks about general ancestry or population structure (use claw-ancestry-pca)
- User asks about pharmacogenomics or clinical variants
- User wants admixture proportions without segment-level detail
Why This Exists
Between 1-4% of non-African modern human genomes derive from archaic hominins (Neanderthals, Denisovans). Identifying these segments matters for understanding human evolution, disease susceptibility, and immune adaptation. Three complementary methods exist (IBDmix, Sprime, hmmix), each with different strengths. This skill wraps all three behind a unified interface with a pure-Python fallback when external binaries are unavailable.
Core Capabilities
- IBDmix: Detect segments shared IBD between modern and archaic genomes using LOD score thresholds
- Sprime: Identify introgressed haplotypes without requiring an archaic reference panel
- hmmix: HMM-based detection of archaic ancestry tracts
- Pure-Python fallback: LOD-score-based segment calling when IBDmix binary is not installed
- EIGENSTRAT support: Read .ind/.snp/.geno files (text and binary packed formats)
- Summary statistics: Per-individual introgression burden, segment count, mean length
Scope
One skill, one task: detect and report archaic introgression segments. Does not perform downstream functional annotation of introgressed variants (chain with vcf-annotator for that).
Input Formats
- Modern genotypes: VCF (uncompressed or .vcf.gz with .tbi index)
- Archaic genotypes: VCF (Neanderthal/Denisovan reference panel)
- EIGENSTRAT: .ind + .snp + .geno files (text or binary packed format)
Workflow
- Parse modern VCF to extract sample names and genotype matrix (numpy array)
- Parse archaic VCF to extract reference genotypes at matching positions
- Identify shared variant positions between modern and archaic panels
- Run selected method (IBDmix / Sprime / hmmix) or pure-Python LOD fallback
- Collect IntrogressionSegment results per sample
- Compute per-individual summary statistics
- Write JSON report and optional BED file
CLI Reference
# Run with IBDmix on VCF inputs
python archaic_introgression.py \
--input modern.vcf --archaic archaic.vcf \
--method ibdmix --output /tmp/introgression
# Run demo with synthetic data
python archaic_introgression.py --demo --output /tmp/introgression_demo
# Filter to specific samples
python archaic_introgression.py \
--input modern.vcf --archaic archaic.vcf \
--samples SAMPLE01,SAMPLE02 --output /tmp/introgression
# Adjust LOD threshold
python archaic_introgression.py \
--input modern.vcf --archaic archaic.vcf \
--lod 5.0 --output /tmp/introgression
Demo
python archaic_introgression.py --demo --output /tmp/introgression_demo
Runs on bundled examples/demo_modern.vcf (3 samples, 10 SNPs on chr22) and
examples/demo_archaic.vcf (1 Neanderthal sample, same positions).
Example Queries
- "How much Neanderthal DNA do I have?"
- "Detect archaic introgression in my VCF"
- "Run IBDmix on my genotype data"
- "Show me introgressed segments from Denisova"
- "Compare my genome against the Vindija Neanderthal"
Output Structure
output_dir/
introgression_results.json # Full results with segments and summary
segments.bed # BED file of introgressed regions
JSON structure
{
"method": "ibdmix",
"lod_threshold": 3.0,
"num_samples": 3,
"segments": [
{
"sample": "SAMPLE01",
"chrom": "chr22",
"start": 16050075,
"end": 16051249,
"archaic_source": "Neanderthal",
"method": "ibdmix",
"score": 4.2,
"num_variants": 6,
"length": 1174
}
],
"summary": {
"SAMPLE01": {
"total_segments": 1,
"total_length_bp": 1174,
"mean_segment_length": 1174.0,
"mean_score": 4.2
}
}
}
Dependencies
- Python 3.11+
- numpy
- Optional: IBDmix binary, Sprime JAR, hmmix binary
- Optional: bcftools (for indexed VCF extraction)
Gotchas
- The model will want to report percentage of genome that is Neanderthal from 10 SNPs. Do not. Demo data is too sparse for genome-wide estimates. State the segment coordinates and LOD scores only.
- The model will want to assume all archaic segments are Neanderthal. Do not. Check the archaic source label. Denisovan segments have different frequency distributions in different populations.
- The model will want to skip the pure-Python fallback and just say IBDmix is required. Do not. The fallback LOD scoring works well for demonstration and small datasets.
- The model will want to interpret introgression as harmful. Do not. Many introgressed segments are adaptive (e.g., immune genes, altitude adapta