# ahh001/dc-bias-optimization-lifi-and-validation architecture

> Architecture diagram of the GitHub repository ahh001/dc-bias-optimization-lifi-and-validation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahh001/dc-bias-optimization-lifi-and-validation
- Repository: https://github.com/ahh001/dc-bias-optimization-lifi-and-validation

## Overview

This repository is a research workflow for optimizing DCO-OFDM Li-Fi DC bias: MATLAB generates simulation data, Python scripts train and evaluate hybrid regressors on simulation or hardware datasets, and Arduino transmitter/receiver code supports hardware validation. The README documents the workflow; the Python excerpts show feature selection, model fitting, prediction, metrics, and plots. MATLAB generation and Arduino internals were not sampled, so their connections reflect README statements rather than inspected implementation.

Main entry points: [`ML models/hybrid_linear_ with_ KNN_on_matlab_dataset.py`](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_linear_%20with_%20KNN_on_matlab_dataset.py) (Metrics and Plots), [`data generation/dco_ofdm_lifi_dataset.csv`](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/dco_ofdm_lifi_dataset.csv) (Simulation Dataset), [`data generation/HW_dataset.csv`](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/HW_dataset.csv) (Hardware Dataset), [`ML models/hybrid_polynomial_ with_ KNN_on_matlab_dataset.py`](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_polynomial_%20with_%20KNN_on_matlab_dataset.py) (Polynomial + KNN)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation Data"]
  node_matlab_generator["MATLAB Simulation<br/>[generate_dataset.m]"]
  node_simulation_data[("Simulation Dataset")]
end

subgraph group_models["Hybrid Models"]
  node_linear_matlab["Linear + KNN"]
  node_polynomial_matlab["Polynomial + KNN"]
  node_linear_hardware["Linear + KNN"]
  node_polynomial_hardware["Polynomial + KNN"]
end

subgraph group_hardware["Li-Fi Hardware"]
  node_transmitter["LED Transmitter"]
  node_receiver["Photodiode Receiver"]
  node_hardware_data[("Hardware Dataset<br/>[HW_dataset.csv]")]
end

subgraph group_validation["Validation Results"]
  node_model_results["Metrics and Plots"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs simulation"| node_matlab_generator
node_matlab_generator -->|"generates dataset"| node_simulation_data
node_researcher -->|"runs model"| node_linear_matlab
node_researcher -->|"runs model"| node_polynomial_matlab
node_simulation_data -->|"loads data"| node_linear_matlab
node_simulation_data -->|"loads data"| node_polynomial_matlab
node_researcher -->|"uploads code"| node_transmitter
node_researcher -->|"uploads code"| node_receiver
node_transmitter -->|"transmits signal"| node_receiver
node_receiver -->|"extracts features"| node_hardware_data
node_researcher -->|"runs model"| node_linear_hardware
node_researcher -->|"runs model"| node_polynomial_hardware
node_hardware_data -->|"loads data"| node_linear_hardware
node_hardware_data -->|"loads data"| node_polynomial_hardware
node_linear_matlab -->|"computes metrics"| node_model_results
node_polynomial_matlab -->|"computes metrics"| node_model_results
node_linear_hardware -->|"computes metrics"| node_model_results
node_polynomial_hardware -->|"computes metrics"| node_model_results

click node_matlab_generator "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/generate_dataset.m"
click node_simulation_data "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/dco_ofdm_lifi_dataset.csv"
click node_linear_matlab "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_linear_%20with_%20KNN_on_matlab_dataset.py"
click node_polynomial_matlab "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_polynomial_%20with_%20KNN_on_matlab_dataset.py"
click node_linear_hardware "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_linear_%20with_%20KNN_on_arduino_dataset.py"
click node_polynomial_hardware "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_polynomial_%20with_%20KNN_on_arduino_dataset.py"
click node_transmitter "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/hardware%20validation/lifi_transmitter_message_generator.ino"
click node_receiver "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/hardware%20validation/lifi_receiver_feature_extraction.ino"
click node_hardware_data "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/HW_dataset.csv"
click node_model_results "https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_linear_%20with_%20KNN_on_matlab_dataset.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_matlab_generator,node_simulation_data toneBlue
class node_linear_matlab,node_polynomial_matlab,node_linear_hardware,node_polynomial_hardware toneAmber
class node_transmitter,node_receiver,node_hardware_data toneMint
class node_model_results toneRose
class node_researcher toneIndigo
```

## Components

### Simulation Data

- [MATLAB Simulation](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/generate_dataset.m): `data generation/generate_dataset.m`
- [Simulation Dataset](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/dco_ofdm_lifi_dataset.csv): `data generation/dco_ofdm_lifi_dataset.csv`

### Hybrid Models

- [Linear + KNN](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_linear_%20with_%20KNN_on_matlab_dataset.py): `ML models/hybrid_linear_ with_ KNN_on_matlab_dataset.py`
- [Polynomial + KNN](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_polynomial_%20with_%20KNN_on_matlab_dataset.py): `ML models/hybrid_polynomial_ with_ KNN_on_matlab_dataset.py`
- [Linear + KNN](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_linear_%20with_%20KNN_on_arduino_dataset.py): `ML models/hybrid_linear_ with_ KNN_on_arduino_dataset.py`
- [Polynomial + KNN](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_polynomial_%20with_%20KNN_on_arduino_dataset.py): `ML models/hybrid_polynomial_ with_ KNN_on_arduino_dataset.py`

### Li-Fi Hardware

- [LED Transmitter](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/hardware%20validation/lifi_transmitter_message_generator.ino): `hardware validation/lifi_transmitter_message_generator.ino`
- [Photodiode Receiver](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/hardware%20validation/lifi_receiver_feature_extraction.ino): `hardware validation/lifi_receiver_feature_extraction.ino`
- [Hardware Dataset](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/data%20generation/HW_dataset.csv): `data generation/HW_dataset.csv`

### Validation Results

- [Metrics and Plots](https://github.com/ahh001/dc-bias-optimization-lifi-and-validation/blob/main/ML%20models/hybrid_linear_%20with_%20KNN_on_matlab_dataset.py): `ML models/hybrid_linear_ with_ KNN_on_matlab_dataset.py`

### Other components

- **Researcher**

## Connections

- Researcher → MATLAB Simulation: runs simulation (evidence: `README.md`)
- MATLAB Simulation → Simulation Dataset: generates dataset (evidence: `README.md`)
- Researcher → Linear + KNN: runs model (evidence: `README.md`)
- Researcher → Polynomial + KNN: runs model (evidence: `README.md`)
- Simulation Dataset → Linear + KNN: loads data (evidence: `ML models/hybrid_linear_ with_ KNN_on_matlab_dataset.py`)
- Simulation Dataset → Polynomial + KNN: loads data (evidence: `ML models/hybrid_polynomial_ with_ KNN_on_matlab_dataset.py`)
- Researcher → LED Transmitter: uploads code (evidence: `README.md`)
- Researcher → Photodiode Receiver: uploads code (evidence: `README.md`)
- LED Transmitter → Photodiode Receiver: transmits signal (evidence: `README.md`)
- Photodiode Receiver → Hardware Dataset: extracts features (evidence: `README.md`)
- Researcher → Linear + KNN: runs model (evidence: `README.md`)
- Researcher → Polynomial + KNN: runs model (evidence: `README.md`)
- Hardware Dataset → Linear + KNN: loads data (evidence: `ML models/hybrid_linear_ with_ KNN_on_arduino_dataset.py`)
- Hardware Dataset → Polynomial + KNN: loads data (evidence: `ML models/hybrid_polynomial_ with_ KNN_on_arduino_dataset.py`)
- Linear + KNN → Metrics and Plots: computes metrics (evidence: `ML models/hybrid_linear_ with_ KNN_on_matlab_dataset.py`)
- Polynomial + KNN → Metrics and Plots: computes metrics (evidence: `ML models/hybrid_polynomial_ with_ KNN_on_matlab_dataset.py`)
- Linear + KNN → Metrics and Plots: computes metrics (evidence: `ML models/hybrid_linear_ with_ KNN_on_arduino_dataset.py`)
- Polynomial + KNN → Metrics and Plots: computes metrics (evidence: `ML models/hybrid_polynomial_ with_ KNN_on_arduino_dataset.py`)
