# georgyzaouk/metagenomics-diversity-analysis architecture

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

- Interactive diagram: https://gitdiagram.com/georgyzaouk/metagenomics-diversity-analysis
- Repository: https://github.com/georgyzaouk/metagenomics-diversity-analysis

## Overview

This repository documents a notebook-driven metagenomics workflow: users provide raw reads, run the notebook step by step, and obtain analysis files and command logs. The README names the processing stages and their order, but no notebook source was provided for inspection, so implementation details and internal calls cannot be verified.

Main entry points: [`pipeline.ipynb`](https://github.com/georgyzaouk/metagenomics-diversity-analysis/blob/main/pipeline.ipynb) (Workflow notebook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_preprocessing["Read preprocessing"]
  node_sortmerna["SortMeRNA"]
  node_fastqc["FastQC"]
  node_sickle["Sickle"]
  node_seqtk["Seqtk"]
end

subgraph group_analysis["Community analysis"]
  node_mothur["Mothur"]
  node_diversity["Diversity analysis"]
end

subgraph group_taxonomy["Taxonomy and phylogeny"]
  node_blast_silva["BLAST / SILVA"]
  node_ete3["ETE3"]
  node_itol["iTOL"]
end

subgraph group_outputs["Generated outputs"]
  node_work_files["Analysis files"]
  node_logs["Command logs"]
end

node_user(("Researcher"))
node_raw_reads["Raw reads"]
node_notebook["Workflow notebook<br/>[pipeline.ipynb]"]

node_user -->|"runs steps"| node_notebook
node_raw_reads -->|"provides input"| node_notebook
node_notebook -->|"runs first"| node_sortmerna
node_sortmerna -->|"then runs"| node_fastqc
node_fastqc -->|"then runs"| node_sickle
node_sickle -->|"then runs"| node_seqtk
node_seqtk -->|"then runs"| node_mothur
node_mothur -->|"supports analysis"| node_diversity
node_diversity -->|"then runs"| node_blast_silva
node_blast_silva -->|"then runs"| node_ete3
node_ete3 -->|"then runs"| node_itol
node_notebook -->|"writes files"| node_work_files
node_notebook -->|"writes output"| node_logs

click node_notebook "https://github.com/georgyzaouk/metagenomics-diversity-analysis/blob/main/pipeline.ipynb"

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_sortmerna,node_fastqc,node_sickle,node_seqtk toneBlue
class node_mothur,node_diversity toneAmber
class node_blast_silva,node_ete3,node_itol toneMint
class node_work_files,node_logs toneRose
class node_user,node_raw_reads toneIndigo
class node_notebook toneTeal
```

## Components

### Read preprocessing

- **SortMeRNA**
- **FastQC**
- **Sickle**
- **Seqtk**

### Community analysis

- **Mothur**
- **Diversity analysis**

### Taxonomy and phylogeny

- **BLAST / SILVA**
- **ETE3**
- **iTOL**

### Generated outputs

- **Analysis files**
- **Command logs**

### Other components

- **Researcher**
- **Raw reads**
- [Workflow notebook](https://github.com/georgyzaouk/metagenomics-diversity-analysis/blob/main/pipeline.ipynb): `pipeline.ipynb`

## Connections

- Researcher → Workflow notebook: runs steps (evidence: `README.md`)
- Raw reads → Workflow notebook: provides input (evidence: `README.md`)
- Workflow notebook → SortMeRNA: runs first (evidence: `README.md`)
- SortMeRNA → FastQC: then runs (evidence: `README.md`)
- FastQC → Sickle: then runs (evidence: `README.md`)
- Sickle → Seqtk: then runs (evidence: `README.md`)
- Seqtk → Mothur: then runs (evidence: `README.md`)
- Mothur → Diversity analysis: supports analysis (evidence: `README.md`)
- Diversity analysis → BLAST / SILVA: then runs (evidence: `README.md`)
- BLAST / SILVA → ETE3: then runs (evidence: `README.md`)
- ETE3 → iTOL: then runs (evidence: `README.md`)
- Workflow notebook → Analysis files: writes files (evidence: `README.md`)
- Workflow notebook → Command logs: writes output (evidence: `README.md`)
