How swidler/roam-python works
RoAM is a Python genomics tool with two user-facing workflows: reconstructing ancient-DNA methylation from BAM reads, and detecting differentially methylated regions between sample groups. The reconstruction workflow prepares CpG coordinates and sample data, then processes and filters methylation data; the DMR workflow combines sample data and analyzes group differences, with optional genomic annotation. The graph preserves the shared genomic data model and utilities. Some subsystem details come from README descriptions and source-index references; unsampled implementation links are omitted where their runtime wiring is not shown.
Main entry points: run_roam.py RoAM runner · DMRs.py DMR analysis · mmsample.py Modern sample processing · run_DMRs.py DMR runner
Components 18
Ancient reconstruction
- RoAM runner
run_roam.py - Chromosome workers
amsample_parallel.py - Ancient sample processing
amsample.py
DMR analysis
- DMR runner
run_DMRs.py - DMR analysis
DMRs.py - Chromosome DMRs
cDMRs.py - DMR sample preparation
create_files_for_DMRs.py
Genomic data model
- CpG coordinates
gcoordinates.py - Modern sample processing
mmsample.py - Chromosome model
chroms.py - Genomic intervals
gintervals.py
Shared utilities
- Shared tools
tools.py
Other components
- Researcher
- Ancient BAM input
- Reference FASTA
- Modern methylation map
- DMR outputs
- Reconstruction outputs
Connections 25
- Researcher → RoAM runner: configures and runs
README.md - Ancient BAM input → RoAM runner: provides reads
README.md - Reference FASTA → RoAM runner: provides assembly
README.md - RoAM runner → CpG coordinates: creates coordinates
run_roam.py - RoAM runner → Chromosome workers: dispatches workers
run_roam.py - RoAM runner → Ancient sample processing: processes BAM
run_roam.py - Chromosome workers → Ancient sample processing: builds partial samples
amsample_parallel.py - Modern methylation map → RoAM runner: provides reference
README.md - RoAM runner → Modern sample processing: loads reference map
run_roam.py - RoAM runner → Reconstruction outputs: writes reconstruction
README.md - Researcher → DMR runner: configures and runs
README.md - DMR runner → Modern sample processing: loads modern samples
run_DMRs.py - DMR runner → DMR analysis: runs analysis
run_DMRs.py - DMR runner → DMR outputs: produces DMR results
- DMR sample preparation → Modern sample processing: converts Bismark data
create_files_for_DMRs.py - DMR analysis → Chromosome DMRs: uses chromosome DMRs
DMRs.py - DMR analysis → CpG coordinates: uses coordinates
DMRs.py - DMR analysis → Genomic intervals: uses intervals
DMRs.py - Ancient sample processing → Chromosome model: inherits chromosome methods
amsample.py - Modern sample processing → Chromosome model: inherits chromosome methods
mmsample.py - Genomic intervals → Chromosome model: inherits chromosome methods
gintervals.py - CpG coordinates → Chromosome model: inherits chromosome methods
gcoordinates.py - Ancient sample processing → Shared tools: uses utilities
amsample.py - Modern sample processing → Shared tools: uses utilities
mmsample.py - DMR analysis → Shared tools: uses utilities
DMRs.py