How bge-barcoding/beegees works
BeeGees is a Snakemake bioinformatics workflow that turns genome-skim reads into cleaned, validated COI-5P or rbcL barcode sequences, per-sample metrics, and a MultiQC report. The user supplies sample metadata and configuration, then starts the run through the CLI. The README documents the major workflow stages and outputs; implementation of the Snakefile and several stages was not sampled, so those documented connections cite the README rather than implying source inspection.
Main entry points: workflow Read preprocessing · __main__.py BeeGees CLI · 01_human_mitogenome_filter.py Human contamination filter · 05_consensus_generator.py Clean consensus generation
Components 23
Run setup
- Run configuration
beegees/config/config.yaml - BeeGees CLI
beegees/__main__.py - Workflow file lookup
beegees/utils/configs.py - Command builder
beegees/utils/snakemake_args.py
Read processing and recovery
- Snakemake workflow
beegees/workflow/Snakefile - Read preprocessing
beegees/workflow - Reference retrieval
beegees/workflow - Barcode recovery
beegees/workflow - Consensus preparation
beegees/workflow/scripts/rename_headers.py
Consensus cleaning
- Human contamination filter
beegees/workflow/scripts/01_human_mitogenome_filter.py - AT content filter
beegees/workflow/scripts/02_at_content_filter.py - Outlier filter
beegees/workflow/scripts/03_statistical_outlier_filter.py - Reference filter
beegees/workflow/scripts/04_reference_filter.py - Clean consensus generation
beegees/workflow/scripts/05_consensus_generator.py
Barcode validation
- Structural validation
beegees/workflow/scripts/structural_validation.py - Local BLAST search
beegees/workflow/scripts/tv_local_blast.py - Taxonomic validation
beegees/workflow/scripts/tv_blast2taxonomy.py
Reports and metrics
- Validated barcode FASTA
beegees/workflow - Combined metrics CSV
beegees/workflow/scripts/val_csv_merger.py - Filter metrics aggregation
beegees/workflow/scripts/06_aggregate_filter_metrics.py - MultiQC report
beegees/workflow
Other components
- Researcher
- Read files and samples
Connections 26
- Researcher → BeeGees CLI: starts run
README.md - Researcher → Read files and samples: provides reads
README.md - Researcher → Run configuration: configures run
README.md - BeeGees CLI → Command builder: builds command
beegees/__main__.py - Command builder → Workflow file lookup: locates workflow
beegees/utils/snakemake_args.py - BeeGees CLI → Snakemake workflow: launches
beegees/__main__.py - Snakemake workflow → Read preprocessing: runs
README.md - Read files and samples → Read preprocessing: supplies reads
README.md - Read preprocessing → Reference retrieval: feeds run
README.md - Reference retrieval → Barcode recovery: provides references
README.md - Barcode recovery → Consensus preparation: produces consensuses
README.md - Consensus preparation → Human contamination filter: feeds alignments
README.md - Human contamination filter → AT content filter: filters sequences
README.md - AT content filter → Outlier filter: filters outliers
README.md - Outlier filter → Reference filter: filters references
README.md - Reference filter → Clean consensus generation: generates consensus
README.md - Clean consensus generation → Structural validation: validates structure
README.md - Clean consensus generation → Local BLAST search: searches taxonomy
README.md - Local BLAST search → Taxonomic validation: supplies hits
README.md - Structural validation → Validated barcode FASTA: selects barcodes
README.md - Taxonomic validation → Validated barcode FASTA: validates taxonomy
README.md - Human contamination filter → Filter metrics aggregation: records filter metrics
beegees/workflow/scripts/01_human_mitogenome_filter.py - Filter metrics aggregation → Combined metrics CSV: contributes metrics
README.md - Taxonomic validation → Combined metrics CSV: records validation
README.md - Read preprocessing → MultiQC report: reports QC
README.md - Combined metrics CSV → MultiQC report: summarizes results
README.md