# y-lebid/covid-19 architecture

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

- Interactive diagram: https://gitdiagram.com/y-lebid/covid-19
- Repository: https://github.com/y-lebid/covid-19

## Overview

This is a COVID-19 data-analysis and forecasting project, run primarily as a Python script. Its main workflow prepares data, creates visualizations, trains and evaluates regression and outbreak-classification models, then saves results locally. The README documents further modeling capabilities. `homework.py` is a separate script for cleaning, correlation analysis, country comparisons, and interactive visualization. The source is largely monolithic; components below represent distinct stages, not separate runtime modules. Connections reflect shown code or README statements; some details of `main.py` are omitted from the excerpts.

Main entry points: [`main.py`](https://github.com/y-lebid/covid-19/blob/master/main.py) (Main script), [`homework.py`](https://github.com/y-lebid/covid-19/blob/master/homework.py) (Homework script)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Main pipeline"]
  node_main["Main script<br/>[main.py]"]
  node_cleaning["Data cleaning<br/>[main.py]"]
  node_features["Feature engineering<br/>[main.py]"]
end

subgraph group_analysis["Exploratory analysis"]
  node_visuals["Visualizations<br/>[main.py]"]
end

subgraph group_modeling["Machine learning"]
  node_trainingdata[("ML input data<br/>[main.py]")]
  node_regression["Case regression<br/>[main.py]"]
  node_classification["Outbreak classification<br/>[main.py]"]
  node_balancing["Class balancing<br/>[main.py]"]
  node_evaluation["Model evaluation<br/>[main.py]"]
  node_optimization["Model optimization<br/>[main.py]"]
  node_predictions["Final predictions<br/>[main.py]"]
end

subgraph group_homework["Homework analyses"]
  node_homeworkscript["Homework script<br/>[homework.py]"]
  node_homeworkclean["Homework cleaning<br/>[homework.py]"]
  node_correlation["Correlation analysis<br/>[homework.py]"]
  node_comparisons["Country comparisons<br/>[homework.py]"]
  node_interactive["Interactive chart<br/>[homework.py]"]
end

node_user(("User"))
node_rawdata[("COVID dataset")]
node_cleaneddata[("Clean dataset")]
node_images["PNG charts"]
node_results["Analysis charts"]

node_user -->|"runs"| node_main
node_main -->|"reads"| node_rawdata
node_main -->|"performs"| node_cleaning
node_cleaning -->|"writes"| node_cleaneddata
node_main -->|"transforms"| node_features
node_main -->|"generates"| node_visuals
node_visuals -->|"saves"| node_images
node_main -->|"loads"| node_trainingdata
node_main -->|"trains"| node_regression
node_main -->|"trains"| node_classification
node_main -->|"applies"| node_balancing
node_main -->|"evaluates"| node_evaluation
node_main -->|"tunes"| node_optimization
node_main -->|"predicts"| node_predictions
node_predictions -->|"saves"| node_results
node_user -->|"runs"| node_homeworkscript
node_homeworkscript -->|"reads"| node_rawdata
node_homeworkscript -->|"performs"| node_homeworkclean
node_homeworkclean -->|"writes"| node_cleaneddata
node_homeworkscript -->|"computes"| node_correlation
node_homeworkscript -->|"plots"| node_comparisons
node_homeworkscript -->|"generates"| node_interactive

click node_main "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_cleaning "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_features "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_visuals "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_trainingdata "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_regression "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_classification "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_balancing "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_evaluation "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_optimization "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_predictions "https://github.com/y-lebid/covid-19/blob/master/main.py"
click node_homeworkscript "https://github.com/y-lebid/covid-19/blob/master/homework.py"
click node_homeworkclean "https://github.com/y-lebid/covid-19/blob/master/homework.py"
click node_correlation "https://github.com/y-lebid/covid-19/blob/master/homework.py"
click node_comparisons "https://github.com/y-lebid/covid-19/blob/master/homework.py"
click node_interactive "https://github.com/y-lebid/covid-19/blob/master/homework.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_main,node_cleaning,node_features,node_user toneBlue
class node_visuals,node_rawdata,node_cleaneddata toneAmber
class node_trainingdata,node_regression,node_classification,node_balancing,node_evaluation,node_optimization,node_predictions toneMint
class node_homeworkscript,node_homeworkclean,node_correlation,node_comparisons,node_interactive toneRose
class node_images,node_results toneIndigo
```

## Components

### Main pipeline

- [Main script](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Data cleaning](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Feature engineering](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`

### Exploratory analysis

- [Visualizations](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`

### Machine learning

- [ML input data](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Case regression](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Outbreak classification](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Class balancing](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Model evaluation](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Model optimization](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`
- [Final predictions](https://github.com/y-lebid/covid-19/blob/master/main.py): `main.py`

### Homework analyses

- [Homework script](https://github.com/y-lebid/covid-19/blob/master/homework.py): `homework.py`
- [Homework cleaning](https://github.com/y-lebid/covid-19/blob/master/homework.py): `homework.py`
- [Correlation analysis](https://github.com/y-lebid/covid-19/blob/master/homework.py): `homework.py`
- [Country comparisons](https://github.com/y-lebid/covid-19/blob/master/homework.py): `homework.py`
- [Interactive chart](https://github.com/y-lebid/covid-19/blob/master/homework.py): `homework.py`

### Other components

- **User**
- **COVID dataset**
- **Clean dataset**
- **PNG charts**
- **Analysis charts**

## Connections

- User → Main script: runs (evidence: `README.md`)
- Main script → COVID dataset: reads (evidence: `README.md`)
- Main script → Data cleaning: performs (evidence: `main.py`)
- Data cleaning → Clean dataset: writes (evidence: `README.md`)
- Main script → Feature engineering: transforms (evidence: `main.py`)
- Main script → Visualizations: generates (evidence: `main.py`)
- Visualizations → PNG charts: saves (evidence: `main.py`)
- Main script → ML input data: loads (evidence: `main.py`)
- Main script → Case regression: trains (evidence: `main.py`)
- Main script → Outbreak classification: trains (evidence: `main.py`)
- Main script → Class balancing: applies (evidence: `main.py`)
- Main script → Model evaluation: evaluates (evidence: `main.py`)
- Main script → Model optimization: tunes (evidence: `main.py`)
- Main script → Final predictions: predicts (evidence: `main.py`)
- Final predictions → Analysis charts: saves (evidence: `README.md`)
- User → Homework script: runs (evidence: `homework.py`)
- Homework script → COVID dataset: reads (evidence: `homework.py`)
- Homework script → Homework cleaning: performs (evidence: `homework.py`)
- Homework cleaning → Clean dataset: writes (evidence: `homework.py`)
- Homework script → Correlation analysis: computes (evidence: `homework.py`)
- Homework script → Country comparisons: plots (evidence: `homework.py`)
- Homework script → Interactive chart: generates (evidence: `homework.py`)
