# akramiot/wifi6_wifi7 architecture

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

- Interactive diagram: https://gitdiagram.com/akramiot/wifi6_wifi7
- Repository: https://github.com/akramiot/wifi6_wifi7

## Overview

##### File structure
- Top level: no separate folders—everything lives at root.
- Key files:
- `WIFI7_mptcp.py` – the main Python program containing data collection, ML preprocessing/training, and reporting logic.
- `ML_PER_BER.docx`/`.pdf` – design or research documentation describing the ML methodology and performance metrics (e.g., BER, throughput).
- Standard project metadata: `.gitignore`, `LICENSE`, `README.md`.

##### README
- Confirms: “ML based WIFI Performance analysis.”

##### Components and interactions
a. Main components
1. Data Collection Module
– Interfaces with OS/network stack (e.g., via `subprocess` calling tools like `iw`, `iperf`, or `tcpdump`).
2. Data Preprocessing & Feature Extraction
– Cleans raw logs, computes throughput, BER, RTT, jitter features.
3. ML Pipeline
– Model training, validation, and inference (classification/regression) using Python ML libraries.
4. Reporting & Visualization
– Generates plots, summary statistics, exportable reports (CSV, PDF, graphs).

b. Relationships & data flow
- Data Collection outputs raw measurement data → Preprocessing consumes raw data → Preprocessed features feed into the ML Pipeline → Model outputs performance predictions/analyses → Reporting consumes model outputs to produce visualizations and reports.

c. Architectural patterns
- Linear data‑pipeline pattern (ETL → ML → Reporting).
- Modular separation by function: each module can be a Python class or script function.

d. Technologies & frameworks
- Python 3.x
- Data libraries: pandas, NumPy
- ML frameworks: scikit‑learn (or TensorFlow/PyTorch if specified)
- Visualization: matplotlib, seaborn, or Plotly
- System interfacing: subprocess or OS modules

##### Elements
- Clear labels: “Data Collector,” “Preprocessor,” “ML Trainer/Predictor,” “Reporter”
- Blue rectangles for data at each stage
- Green for processing modules
- Orange for outputs/visuals

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Input
    subgraph "Input Data"
        RawData["Raw Wi‑Fi Metrics<br/>(iperf, iw, tcpdump)"]:::data
    end

    %% Processing Pipeline
    subgraph "Processing Pipeline"
        DC["Data Collection Module"]:::process
        DP["Data Preprocessing & Feature Extraction<br/>(BER, Throughput, Latency)"]:::process
        ML["ML Pipeline<br/>(Training & Inference/Validation)"]:::process
        RP["Reporting & Visualization<br/>(Plots, CSV, PDF)"]:::output
    end

    %% Documentation
    subgraph "Documentation"
        DOC1["ML Performance Documentation (.docx)"]:::doc
        DOC2["ML Performance Documentation (.pdf)"]:::doc
        README["Project Overview / Setup Instructions"]:::doc
    end

    %% Data Flow
    RawData --> DC --> DP --> ML --> RP

    %% Doc Links
    README -.-> DC
    DOC1 -.-> ML
    DOC2 -.-> ML

    %% Click Events
    click DC "https://github.com/akramiot/wifi6_wifi7/blob/main/WIFI7_mptcp.py"
    click DP "https://github.com/akramiot/wifi6_wifi7/blob/main/WIFI7_mptcp.py"
    click ML "https://github.com/akramiot/wifi6_wifi7/blob/main/WIFI7_mptcp.py"
    click RP "https://github.com/akramiot/wifi6_wifi7/blob/main/WIFI7_mptcp.py"
    click DOC1 "https://github.com/akramiot/wifi6_wifi7/blob/main/ML_PER_BER.docx"
    click DOC2 "https://github.com/akramiot/wifi6_wifi7/blob/main/ML_PER_BER.pdf"
    click README "https://github.com/akramiot/wifi6_wifi7/blob/main/README.md"

    %% Styles
    classDef data fill:#aed6f1,stroke:#2980b9,color:#1b2631;
    classDef process fill:#a9dfbf,stroke:#27ae60,color:#145a32;
    classDef output fill:#f9e79f,stroke:#b7950b,color:#7d6608;
    classDef doc fill:#d5dbdb,stroke:#979a9a,color:#2c3e50;
```
