How ecampbell50/ptolemaea works
Ptolemaea is a genome-scale bacterial antiviral-defence annotation and reconciliation pipeline. Users provide genome FASTAs; the documented run predicts proteins, invokes PADLOC and DefenseFinder, performs bidirectional BLAST against the Bacillus cereus defence set, then produces per-genome consensus profiles. Optional curation resolves MAPPING/CONFLICT patterns before final tables and heatmaps. The README documents runtime orchestration and tool stages, but those source scripts were not excerpted, so only documented links are shown. The sampled post-processing code supports the curation, aggregation, and plotting relationships.
Main entry points: create_defence_profile_direct.py Consensus profiles · Ptolemaea_singularity.sh Pipeline runner · create_final_defence_matrix.py Apply resolutions · genomes Genome FASTAs
Components 16
Annotation run
- Genome FASTAs
genomes - Pipeline runner
singularity_scripts/Ptolemaea_singularity.sh - Gene calling
singularity_scripts/Ptolemaea_singularity.sh - PADLOC detection
singularity_scripts/Ptolemaea_singularity.sh - DefenseFinder detection
singularity_scripts/Ptolemaea_singularity.sh - Bidirectional BLAST
singularity_scripts/Ptolemaea_singularity.sh - B. cereus reference
databases/bcereus_db/Bcereus_DefenceProts_17Sep25.faa - Consensus profiles
scripts/create_defence_profile_direct.py - Nomenclature key
databases/MASTER_ToolKey.tsv
Consensus curation
- Unresolved patterns
scripts/extract_unresolved_patterns.py - Curated resolutions
- Apply resolutions
scripts/create_final_defence_matrix.py
Results and plots
- Final data tables
scripts/create_final_defence_matrix.py - Defence heatmap
scripts/plot_defence_heatmap.py
Other components
- Genome analyst
- Manual curator
Connections 20
- Genome analyst → Genome FASTAs: provides
README.md - Genome FASTAs → Pipeline runner: supplies genomes
README.md - Pipeline runner → Gene calling: runs
README.md - Pipeline runner → PADLOC detection: runs
README.md - Pipeline runner → DefenseFinder detection: runs
README.md - Pipeline runner → Bidirectional BLAST: runs
README.md - Bidirectional BLAST → B. cereus reference: searches
README.md - Pipeline runner → Consensus profiles: produces profiles
README.md - PADLOC detection → Consensus profiles: provides detections
README.md - DefenseFinder detection → Consensus profiles: provides detections
README.md - Bidirectional BLAST → Consensus profiles: provides votes
README.md - Nomenclature key → Consensus profiles: maps names
README.md - Consensus profiles → Unresolved patterns: reads profiles
scripts/extract_unresolved_patterns.py - Unresolved patterns → Manual curator: presents patterns
README.md - Manual curator → Curated resolutions: decides labels
README.md - Consensus profiles → Apply resolutions: loads profiles
scripts/create_final_defence_matrix.py - Curated resolutions → Apply resolutions: applies decisions
scripts/create_final_defence_matrix.py - Apply resolutions → Final data tables: writes tables
scripts/create_final_defence_matrix.py - Final data tables → Defence heatmap: plots matrix
scripts/plot_defence_heatmap.py - Consensus profiles → Defence heatmap: plots profiles
scripts/plot_defence_heatmap.py