# ghinwaismail/multimodal-traffic-digital-twins architecture

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

- Interactive diagram: https://gitdiagram.com/ghinwaismail/multimodal-traffic-digital-twins
- Repository: https://github.com/ghinwaismail/multimodal-traffic-digital-twins

## Overview

This is a notebook-first research artifact for trace-driven burst traffic generation for 5G digital twins. The documented per-application workflow preprocesses packet traces, fits a clustering/Markov burst model, generates synthetic bursts, and exports results; a separate notebook consolidates paper figures and tables. The tree includes several application notebooks and comparison outputs. Source excerpts were not provided, so relationships below rely on the README; undocumented implementation details are omitted.

Main entry points: [`notebooks/comparison_figures.ipynb`](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/comparison_figures.ipynb) (Paper reporting), [`notebooks`](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks) (Preprocess traces), [`comparison_figures`](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/comparison_figures) (Comparison results), [`comparison_figures/comparison_statistics_downlink.csv`](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/comparison_figures/comparison_statistics_downlink.csv) (Downlink statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Traffic pipeline"]
  node_preprocess["Preprocess traces"]
  node_fit["Fit burst model"]
  node_generate["Generate bursts"]
  node_export["Export results"]
  node_aparat["Aparat pipeline"]
  node_filimo["Filimo pipeline"]
  node_igap["iGap pipeline"]
  node_telegram["Telegram pipeline"]
  node_youtube["YouTube pipeline"]
  node_multi["Multi-model pipeline"]
end

subgraph group_reporting["Paper reporting"]
  node_paper["Paper reporting"]
  node_comparison["Comparison results"]
  node_statistics["Downlink statistics"]
  node_figures["Comparison figures"]
end

node_traces["Packet traces"]

node_traces -->|"provides input"| node_preprocess
node_preprocess -->|"precedes fitting"| node_fit
node_fit -->|"precedes generation"| node_generate
node_generate -->|"precedes export"| node_export
node_paper -->|"consolidates results"| node_comparison
node_paper -->|"exports tables"| node_statistics
node_paper -->|"exports figures"| node_figures

click node_preprocess "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks"
click node_fit "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks"
click node_generate "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks"
click node_export "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks"
click node_aparat "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_aparat.ipynb"
click node_filimo "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_filimo.ipynb"
click node_igap "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_igap.ipynb"
click node_telegram "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_telegram.ipynb"
click node_youtube "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_youtube.ipynb"
click node_multi "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generation_multi_model.ipynb"
click node_paper "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/comparison_figures.ipynb"
click node_comparison "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/comparison_figures"
click node_statistics "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/comparison_figures/comparison_statistics_downlink.csv"
click node_figures "https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/comparison_figures"

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_preprocess,node_fit,node_generate,node_export,node_aparat,node_filimo,node_igap,node_telegram,node_youtube,node_multi toneBlue
class node_paper,node_comparison,node_statistics,node_figures toneAmber
class node_traces toneIndigo
```

## Components

### Traffic pipeline

- [Preprocess traces](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks): `notebooks`
- [Fit burst model](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks): `notebooks`
- [Generate bursts](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks): `notebooks`
- [Export results](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/notebooks): `notebooks`
- [Aparat pipeline](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_aparat.ipynb): `notebooks/Traffic_generator_aparat.ipynb`
- [Filimo pipeline](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_filimo.ipynb): `notebooks/Traffic_generator_filimo.ipynb`
- [iGap pipeline](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_igap.ipynb): `notebooks/Traffic_generator_igap.ipynb`
- [Telegram pipeline](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_telegram.ipynb): `notebooks/Traffic_generator_telegram.ipynb`
- [YouTube pipeline](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generator_youtube.ipynb): `notebooks/Traffic_generator_youtube.ipynb`
- [Multi-model pipeline](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/Traffic_generation_multi_model.ipynb): `notebooks/Traffic_generation_multi_model.ipynb`

### Paper reporting

- [Paper reporting](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/notebooks/comparison_figures.ipynb): `notebooks/comparison_figures.ipynb`
- [Comparison results](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/comparison_figures): `comparison_figures`
- [Downlink statistics](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/blob/main/comparison_figures/comparison_statistics_downlink.csv): `comparison_figures/comparison_statistics_downlink.csv`
- [Comparison figures](https://github.com/ghinwaismail/multimodal-traffic-digital-twins/tree/main/comparison_figures): `comparison_figures`

### Other components

- **Packet traces**

## Connections

- Packet traces → Preprocess traces: provides input (evidence: `README.md`)
- Preprocess traces → Fit burst model: precedes fitting (evidence: `README.md`)
- Fit burst model → Generate bursts: precedes generation (evidence: `README.md`)
- Generate bursts → Export results: precedes export (evidence: `README.md`)
- Paper reporting → Comparison results: consolidates results (evidence: `README.md`)
- Paper reporting → Downlink statistics: exports tables (evidence: `README.md`)
- Paper reporting → Comparison figures: exports figures (evidence: `README.md`)
