# valdirstefenon/annomining architecture

> Architecture diagram of the GitHub repository valdirstefenon/annomining, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/valdirstefenon/annomining
- Repository: https://github.com/valdirstefenon/annomining

## Overview

AnnoMining is a single-file plant-genome analysis application. Its documented workflow accepts annotation, genome, and HMM-profile inputs; merges annotation evidence; searches protein sequences; classifies secondary-metabolism genes; scores pharmaceutical and disease-resistance potential; and produces tables, statistics, and visualizations. The README also documents comparative genome analysis. The source excerpt shows HMMER invocation, evidence merging, scoring, and visualization logic, but not the full orchestration; workflow edges below rely on the README where noted.

Main entry points: [`annoMining.py`](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py) (HMMER profile search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and access"]
  node_interface["Application interface<br/>[annoMining.py]"]
  node_annotation_inputs["Genome annotations"]
  node_genome_inputs["GFF and FASTA"]
  node_hmm_profiles["HMM profiles"]
end

subgraph group_analysis["Evidence analysis"]
  node_annotation_merge["Annotation merge<br/>[annoMining.py]"]
  node_protein_search["HMMER profile search<br/>[annoMining.py]"]
end

subgraph group_assessment["Gene assessment"]
  node_secondary_classification["Secondary classification<br/>[annoMining.py]"]
  node_pharma_scoring["Pharmaceutical scoring<br/>[annoMining.py]"]
  node_resistance_analysis["Resistance analysis<br/>[annoMining.py]"]
end

subgraph group_results["Results and comparison"]
  node_reporting["Visualization and reporting<br/>[annoMining.py]"]
  node_comparative_analysis["Comparative analysis<br/>[annoMining.py]"]
  node_result_files["Tables and figures"]
end

node_user(("Researcher"))

node_user -->|"runs"| node_interface
node_annotation_inputs -->|"annotation data"| node_annotation_merge
node_annotation_merge -->|"merged evidence"| node_protein_search
node_genome_inputs -->|"extracts proteins"| node_protein_search
node_hmm_profiles -->|"searches profiles"| node_protein_search
node_protein_search -->|"integrates hits"| node_secondary_classification
node_secondary_classification -->|"classified genes"| node_pharma_scoring
node_pharma_scoring -->|"scored genes"| node_resistance_analysis
node_resistance_analysis -->|"analysis results"| node_reporting
node_reporting -->|"writes reports"| node_result_files
node_result_files -.->|"compares genomes"| node_comparative_analysis

click node_interface "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"
click node_annotation_merge "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"
click node_protein_search "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"
click node_secondary_classification "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"
click node_pharma_scoring "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"
click node_resistance_analysis "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"
click node_reporting "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"
click node_comparative_analysis "https://github.com/valdirstefenon/annomining/blob/main/annoMining.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_interface,node_annotation_inputs,node_genome_inputs,node_hmm_profiles toneBlue
class node_annotation_merge,node_protein_search toneAmber
class node_secondary_classification,node_pharma_scoring,node_resistance_analysis toneMint
class node_reporting,node_comparative_analysis,node_result_files toneRose
class node_user toneIndigo
```

## Components

### Inputs and access

- [Application interface](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`
- **Genome annotations**
- **GFF and FASTA**
- **HMM profiles**

### Evidence analysis

- [Annotation merge](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`
- [HMMER profile search](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`

### Gene assessment

- [Secondary classification](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`
- [Pharmaceutical scoring](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`
- [Resistance analysis](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`

### Results and comparison

- [Visualization and reporting](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`
- [Comparative analysis](https://github.com/valdirstefenon/annomining/blob/main/annoMining.py): `annoMining.py`
- **Tables and figures**

### Other components

- **Researcher**

## Connections

- Researcher → Application interface: runs (evidence: `annoMining.py`)
- Genome annotations → Annotation merge: annotation data (evidence: `README.md`)
- Annotation merge → HMMER profile search: merged evidence (evidence: `README.md`)
- GFF and FASTA → HMMER profile search: extracts proteins (evidence: `README.md`)
- HMM profiles → HMMER profile search: searches profiles (evidence: `README.md`)
- HMMER profile search → Secondary classification: integrates hits (evidence: `README.md`)
- Secondary classification → Pharmaceutical scoring: classified genes (evidence: `README.md`)
- Pharmaceutical scoring → Resistance analysis: scored genes (evidence: `README.md`)
- Resistance analysis → Visualization and reporting: analysis results (evidence: `README.md`)
- Visualization and reporting → Tables and figures: writes reports (evidence: `README.md`)
- Tables and figures → Comparative analysis: compares genomes
