# mgarciak-leve/mosquito_virome_yucatan_leve architecture

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

- Interactive diagram: https://gitdiagram.com/mgarciak-leve/mosquito_virome_yucatan_leve
- Repository: https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve

## Overview

This repository is a research workflow for characterizing mosquito viromes from sequencing data, rather than a packaged application. The README describes input data, pipeline scripts, and result categories, but does not specify the scripts’ call sequence; those connections are therefore marked unverified. The sampled database utilities transform ICTV virus metadata, but their integration with the main analysis is not shown.

Main entry points: [`scripts/pipeline_whole/pipeline.sh`](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/scripts/pipeline_whole/pipeline.sh) (Pipeline runner), [`scripts/databases`](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/databases) (Virus databases), [`scripts/czid_analysis`](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/czid_analysis) (CZID analysis), [`raw_data`](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/raw_data) (Sequencing reads)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and references"]
  node_sequencing[("Sequencing reads")]
  node_reference_data[("Reference genomes")]
  node_virus_databases[("Virus databases")]
end

subgraph group_processing["Read processing"]
  node_pipeline["Pipeline runner<br/>[pipeline.sh]"]
  node_quality["Read quality checks"]
  node_trimming["Read trimming"]
end

subgraph group_discovery["Viral discovery"]
  node_assembly["Sequence assembly"]
  node_viral_id["Viral contig identification"]
  node_mapping["Read mapping"]
end

subgraph group_characterization["Virus characterization"]
  node_taxonomy["Viral taxonomy"]
  node_votu["vOTU analysis"]
  node_czid["CZID analysis"]
  node_genome_analysis["Genome analysis"]
  node_gravity_converter["GRAViTy table converter"]
  node_vmr_converter["VMR table converter<br/>[vmr_modify.py]"]
  node_results[("Analysis results")]
end

node_researcher(("Researcher"))

node_researcher -.->|"runs pipeline"| node_pipeline
node_sequencing -.->|"provides reads"| node_pipeline
node_reference_data -.->|"provides references"| node_pipeline
node_virus_databases -.->|"provides databases"| node_pipeline
node_pipeline -.->|"dispatches"| node_quality
node_pipeline -.->|"dispatches"| node_trimming
node_pipeline -.->|"dispatches"| node_assembly
node_pipeline -.->|"dispatches"| node_viral_id
node_pipeline -.->|"dispatches"| node_mapping
node_pipeline -.->|"dispatches"| node_taxonomy
node_pipeline -.->|"dispatches"| node_votu
node_pipeline -.->|"dispatches"| node_czid
node_pipeline -.->|"writes results"| node_results
node_gravity_converter -.->|"writes tables"| node_virus_databases
node_vmr_converter -.->|"writes table"| node_virus_databases
node_czid -.->|"analyzes sequences"| node_genome_analysis

click node_sequencing "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/raw_data"
click node_reference_data "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/aedes_reference_genomes"
click node_virus_databases "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/databases"
click node_pipeline "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/scripts/pipeline_whole/pipeline.sh"
click node_quality "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses"
click node_trimming "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses"
click node_assembly "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses"
click node_viral_id "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses"
click node_mapping "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses"
click node_taxonomy "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses"
click node_votu "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses"
click node_czid "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/czid_analysis"
click node_genome_analysis "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/czid_analysis"
click node_gravity_converter "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/scripts/databases/gravity_database.py"
click node_vmr_converter "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/scripts/databases/vmr_modify.py"
click node_results "https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/project_data"

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_sequencing,node_reference_data,node_virus_databases toneBlue
class node_pipeline,node_quality,node_trimming toneAmber
class node_assembly,node_viral_id,node_mapping toneMint
class node_taxonomy,node_votu,node_czid,node_genome_analysis,node_gravity_converter,node_vmr_converter,node_results toneRose
class node_researcher toneIndigo
```

## Components

### Inputs and references

- [Sequencing reads](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/raw_data): `raw_data`
- [Reference genomes](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/aedes_reference_genomes): `scripts/aedes_reference_genomes`
- [Virus databases](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/databases): `scripts/databases`

### Read processing

- [Pipeline runner](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/scripts/pipeline_whole/pipeline.sh): `scripts/pipeline_whole/pipeline.sh`
- [Read quality checks](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses): `scripts/individual_analyses`
- [Read trimming](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses): `scripts/individual_analyses`

### Viral discovery

- [Sequence assembly](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses): `scripts/individual_analyses`
- [Viral contig identification](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses): `scripts/individual_analyses`
- [Read mapping](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses): `scripts/individual_analyses`

### Virus characterization

- [Viral taxonomy](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses): `scripts/individual_analyses`
- [vOTU analysis](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/individual_analyses): `scripts/individual_analyses`
- [CZID analysis](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/czid_analysis): `scripts/czid_analysis`
- [Genome analysis](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/tree/main/scripts/czid_analysis): `scripts/czid_analysis`
- [GRAViTy table converter](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/scripts/databases/gravity_database.py): `scripts/databases/gravity_database.py`
- [VMR table converter](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/scripts/databases/vmr_modify.py): `scripts/databases/vmr_modify.py`
- [Analysis results](https://github.com/mgarciak-leve/mosquito_virome_yucatan_leve/blob/main/project_data): `project_data`

### Other components

- **Researcher**

## Connections

- Researcher → Pipeline runner: runs pipeline
- Sequencing reads → Pipeline runner: provides reads
- Reference genomes → Pipeline runner: provides references
- Virus databases → Pipeline runner: provides databases
- Pipeline runner → Read quality checks: dispatches
- Pipeline runner → Read trimming: dispatches
- Pipeline runner → Sequence assembly: dispatches
- Pipeline runner → Viral contig identification: dispatches
- Pipeline runner → Read mapping: dispatches
- Pipeline runner → Viral taxonomy: dispatches
- Pipeline runner → vOTU analysis: dispatches
- Pipeline runner → CZID analysis: dispatches
- Pipeline runner → Analysis results: writes results
- GRAViTy table converter → Virus databases: writes tables
- VMR table converter → Virus databases: writes table
- CZID analysis → Genome analysis: analyzes sequences
