Sovereign 8s.is mirror of standardgalactic/NUMT_Analysis
  • Python 80.1%
  • Shell 19.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
LiantingFu 327c1808b4 update
2026-01-28 13:21:04 +08:00
datasets update 2026-01-28 10:03:05 +08:00
examples update 2026-01-28 10:03:05 +08:00
feature_analysis update 2026-01-28 10:03:05 +08:00
scripts update 2026-01-28 10:03:05 +08:00
workflow update 2026-01-28 10:03:05 +08:00
LICENSE Initial commit 2025-05-17 18:31:55 +08:00
pixi.lock update 2026-01-28 10:03:05 +08:00
pixi.toml update 2026-01-28 10:03:05 +08:00
README.md update 2026-01-28 13:21:04 +08:00
Snakefile update 2026-01-28 10:03:05 +08:00

NUMT_Analysis

A bioinformatics pipeline for the detection and characterization of nuclear-embedded mitochondrial DNA segments (NUMTs) utilizing pangenome graphs.


1. Installation

This workflow uses pixi for reproducible environment management.

# Clone the repository
git clone https://github.com/LiantingFu/NUMT_Analysis.git
cd NUMT_Analysis

# Install project environments/dependencies using pixi
# (ensure pixi is installed on your system first)
pixi install

2. Configuration & Inputs

The pipeline requires a configuration file (config.json) and a metadata table for mitochondrial references (chrM_info).

2.1 Configuration (config.json)

Create a config.json file in the repository root specifying input paths. ref specifies the reference genome used for coordinate definition. Example:

{
  "ref": "path/to/reference_genome.fasta",
  "chrM_info": "path/to/chrM_info.tsv",
  "pangenome_vcf": "path/to/pangenome_derived.vcf",
  "prefix": "output_prefix_name"
}

2.2 Mitochondrial metadata (chrM_info)

chrM_info is a TSV file describing mitochondrial references used during NUMT detection. Required columns:

Column Description Example
species Unique identifier for the sample or species human_chrM_1
fasta Path to the raw mitochondrial FASTA file chrM_datasets/human_chrM.1.fasta
repeat2_fasta Path to the mitochondrial FASTA with the sequence duplicated head-to-tail (2x) to handle circularity chrM_datasets/human_chrM_1.chrM_combined.fasta
chain Path to the alignment chain file (e.g., alignment to rCRS) chrM_datasets/human_chrM_1.aln.rCRS.chain

3. Usage

Run the workflow using Snakemake. Adjust the number of threads (-j) according to your available resources. Example:

snakemake -p -j <threads> --configfile config.json

4. Output

Results are written to results/final-output/. Example output structure:

results/
└── final-output
    ├── <prefix>.NUMT_detection_results.tsv         # NUMT detection report
    ├── <prefix>.NUMT_detection_results.vcf         # NUMT-associated variants (VCF)
    ├── <prefix>.fixed_reference-NUMT.info.tsv      # Details of fixed reference NUMTs
    ├── <prefix>.polymorphic_pangenome-NUMT.info.tsv # Details of polymorphic pangenome NUMTs
    └── <prefix>.polymorphic_reference-NUMT.info.tsv # Details of polymorphic reference NUMTs

NUMT_detection_results.tsv

Column Description
numt_id Unique identifier for the detected NUMT (e.g., REFNUMT_1).
source Origin of detection: reference (reference genome) or pangenome (graph-derived).
type Classification: fixed or polymorphic.
variant NUMT-associated variants (for polymorphic NUMTs).
nuchrom Nuclear chromosome.
nupos Position on the nuclear genome.
nustart Start coordinate on the nuclear genome.
nuend End coordinate on the nuclear genome.
mtchrom chrM
mtstart Start coordinate on the mitochondrial genome.
mtend End coordinate on the mitochondrial genome.
strand Orientation (+ or -).

5. Examples

To test the pipeline with example data:

  1. Prepare data:

Download the T2T-CHM13v2.0 chromosome 1 FASTA from NCBI and place it in examples/test_data/.

  1. Run Snakemake using the example configuration:
cd examples
snakemake -p -s ../Snakefile

Citation

Coming soon!