How paoli-lab/igua-df works
IGUA assigns genomic and metagenomic gene clusters to gene-cluster families (GCFs). The user supplies cluster data through the CLI; dataset adapters extract cluster and protein sequences, then the pipeline performs fragment mapping, nucleotide deduplication, and protein-composition clustering before writing GCF assignments and optional representative-protein and composition outputs. The README documents the three-stage method and outputs; sampled source shows CLI dataset construction and pipeline dependencies. Some stage-to-stage details are documented rather than fully visible in the excerpts.
Main entry points: pipeline.py Analysis pipeline · __init__.py CLI · inputs.py Input adapters · defensefinder.py DefenseFinder reader
Components 19
CLI and inputs
- CLI
src/igua/cli/__init__.py - Input adapters
src/igua/cli/inputs.py
Dataset adapters
- GenBank reader
src/igua/dataset/genbank.py - antiSMASH reader
src/igua/dataset/antismash.py - DefenseFinder reader
src/igua/dataset/defensefinder.py - FASTA/GFF reader
src/igua/dataset/fasta_gff.py - Dataset collection
src/igua/dataset/list.py - Dataset interface
src/igua/dataset/base.py
GCF analysis
- Analysis pipeline
src/igua/pipeline.py - Fragment mapping
src/igua/pipeline.py - Nucleotide deduplication
src/igua/pipeline.py - Protein clustering
src/igua/mmseqs.py - Composition matrix
src/igua/pipeline.py - GCF clustering
src/igua/clustering.py
Results
- GCF assignments
src/igua/pipeline.py - Representative proteins
src/igua/pipeline.py - Composition output
src/igua/pipeline.py
Other components
- Researcher
- MMseqs2
Connections 20
- Researcher → CLI: provides inputs
README.md - CLI → Input adapters: parses inputs
src/igua/cli/__init__.py - Input adapters → GenBank reader: creates dataset
src/igua/cli/inputs.py - Input adapters → antiSMASH reader: creates dataset
src/igua/cli/inputs.py - Input adapters → DefenseFinder reader: creates dataset
src/igua/cli/inputs.py - DefenseFinder reader → FASTA/GFF reader: extends
src/igua/dataset/defensefinder.py - CLI → Dataset collection: combines datasets
src/igua/cli/__init__.py - Input adapters → Dataset interface: returns datasets
src/igua/cli/inputs.py - Analysis pipeline → Dataset interface: extracts sequences
src/igua/pipeline.py - CLI → Analysis pipeline: runs
src/igua/cli/__init__.py - Analysis pipeline → Fragment mapping: performs
README.md - Analysis pipeline → Nucleotide deduplication: performs
README.md - Analysis pipeline → Protein clustering: performs
README.md - Analysis pipeline → MMseqs2: invokes
src/igua/pipeline.py - Analysis pipeline → Composition matrix: builds
README.md - Analysis pipeline → GCF clustering: delegates clustering
src/igua/pipeline.py - Analysis pipeline → GCF assignments: produces assignments
README.md - Analysis pipeline → Representative proteins: optionally writes
README.md - Analysis pipeline → Composition output: optionally writes
README.md - CLI → GCF assignments: writes TSV
src/igua/cli/__init__.py