How cyrussarm/bioforge-genetic-data-analysis-pipeline works
BioForge is a command-line DNA analysis pipeline: a user supplies a FASTA file and filtering options, and receives a report of annotated ORFs that pass those filters. The main workflow loads and validates sequence and reference data, detects complete and incomplete ORFs across six reading frames, translates them into proteins, applies length, weight, and motif filters, assigns IDs, and writes results. The graph also shows logging, biological data files, and model/algorithm layers. Unsampled annotation details and some README-documented capabilities are represented only where the README or source index supports them.
Main entry points: main.py Pipeline CLI · logger.py Logging · dataLoader.py Biology data loader · sequence.py DNA sequence
Components 18
Command and loading
- Pipeline CLI
main.py - FASTA loader
fileLoaders/inputLoader.py - Biology data loader
fileLoaders/dataLoader.py - Codon table
data/codon_table.txt - Amino weights
data/amino_weights.txt
Sequence analysis
- DNA sequence
models/sequence.py - ORF detection
utils/ORF_detector.py - ORF model
models/ORF.py - Codon translation
utils/translator.py - Protein model
models/protein.py
Filtering and reporting
- Result filters
utils/filtering.py - ORF annotation
models/annotation.py - Report writer
utils/writeReport.py - Report file
output/report.txt
Runtime support
- Logging
logger.py - Custom errors
models/BioForgeExceptions.py - Execution log
Other components
- CLI user
Connections 30
- CLI user → Pipeline CLI: runs with options
README.md - Pipeline CLI → FASTA loader: loads records
main.py - Pipeline CLI → Biology data loader: loads tables
main.py - Biology data loader → Codon table: reads
fileLoaders/dataLoader.py - Biology data loader → Amino weights: reads
fileLoaders/dataLoader.py - Pipeline CLI → DNA sequence: creates sequences
main.py - Pipeline CLI → ORF detection: requests ORFs
main.py - ORF detection → DNA sequence: reads sequence
utils/ORF_detector.py - ORF detection → ORF model: creates ORFs
utils/ORF_detector.py - Pipeline CLI → Codon translation: translates ORFs
main.py - Codon translation → ORF model: sets protein
utils/translator.py - Codon translation → Protein model: creates protein
utils/translator.py - Pipeline CLI → Protein model: detects motifs
main.py - Pipeline CLI → Result filters: applies filters
main.py - Result filters → ORF model: filters by protein data
utils/filtering.py - Pipeline CLI → ORF annotation: assigns IDs
main.py - Pipeline CLI → Report writer: writes results
main.py - Report writer → DNA sequence: reads sequence data
utils/writeReport.py - Report writer → ORF model: reads ORF data
utils/writeReport.py - Report writer → Report file: writes report
utils/writeReport.py - Pipeline CLI → Logging: configures logging
main.py - Logging → Execution log: writes log
logger.py - FASTA loader → Logging: logs events
fileLoaders/inputLoader.py - FASTA loader → Custom errors: raises input errors
fileLoaders/inputLoader.py - Biology data loader → Logging: logs events
fileLoaders/dataLoader.py - Biology data loader → Custom errors: raises data errors
fileLoaders/dataLoader.py - DNA sequence → Logging: logs warnings
models/sequence.py - DNA sequence → Custom errors: raises validation error
models/sequence.py - Result filters → Logging: logs errors
utils/filtering.py - Result filters → Custom errors: raises filter errors
utils/filtering.py