# okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data architecture

> Architecture diagram of the GitHub repository okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data
- Repository: https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data

## Overview

This is a single-script synthetic air-quality modeling workflow, not a live IoT ingestion service. A user runs the script, which simulates sensor observations and pollutants, computes AQI, exports a dataset, engineers features, compares and trains regressors, evaluates predictions, and saves model and visualization artifacts. The README documents these capabilities; implementation relationships below are evidenced by the sampled script. The provided spreadsheet is an example data artifact, not a demonstrated runtime input.

Main entry points: [`air_quality_iot_ml.py`](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py) (Workflow script)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Data simulation"]
  node_sensor_sim["Sensor simulation"]
  node_pollutants["Pollutant generation"]
  node_aqi["AQI calculation"]
  node_dataset["Dataset export"]
end

subgraph group_modeling["AQI modeling"]
  node_features["Feature engineering"]
  node_preprocess["Feature preprocessing"]
  node_selection["Model selection"]
  node_predict["Best-model prediction"]
end

subgraph group_outputs["Evaluation outputs"]
  node_evaluation["Model evaluation"]
  node_plots["Diagnostic plots"]
  node_artifacts["Saved model"]
end

node_user(("User"))
node_runner["Workflow script"]

node_user -->|"runs"| node_runner
node_runner -->|"generates"| node_sensor_sim
node_runner -->|"simulates"| node_pollutants
node_runner -->|"computes"| node_aqi
node_runner -->|"exports"| node_dataset
node_runner -->|"engineers"| node_features
node_runner -->|"configures"| node_preprocess
node_runner -->|"cross-validates"| node_selection
node_runner -->|"fits and predicts"| node_predict
node_runner -->|"evaluates"| node_evaluation
node_runner -->|"creates"| node_plots
node_runner -->|"serializes"| node_artifacts

click node_runner "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_sensor_sim "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_pollutants "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_aqi "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_dataset "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_features "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_preprocess "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_selection "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_predict "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_evaluation "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_plots "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py"
click node_artifacts "https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.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_sensor_sim,node_pollutants,node_aqi,node_dataset,node_user toneBlue
class node_features,node_preprocess,node_selection,node_predict toneAmber
class node_evaluation,node_plots,node_artifacts toneMint
class node_runner toneTeal
```

## Components

### Data simulation

- [Sensor simulation](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [Pollutant generation](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [AQI calculation](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [Dataset export](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`

### AQI modeling

- [Feature engineering](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [Feature preprocessing](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [Model selection](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [Best-model prediction](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`

### Evaluation outputs

- [Model evaluation](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [Diagnostic plots](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`
- [Saved model](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`

### Other components

- **User**
- [Workflow script](https://github.com/okes2024/air-quality-index-prediction-using-ml-and-iot-sensor-data/blob/main/air_quality_iot_ml.py): `air_quality_iot_ml.py`

## Connections

- User → Workflow script: runs (evidence: `README.md`)
- Workflow script → Sensor simulation: generates (evidence: `air_quality_iot_ml.py`)
- Workflow script → Pollutant generation: simulates (evidence: `air_quality_iot_ml.py`)
- Workflow script → AQI calculation: computes (evidence: `air_quality_iot_ml.py`)
- Workflow script → Dataset export: exports (evidence: `air_quality_iot_ml.py`)
- Workflow script → Feature engineering: engineers (evidence: `air_quality_iot_ml.py`)
- Workflow script → Feature preprocessing: configures (evidence: `air_quality_iot_ml.py`)
- Workflow script → Model selection: cross-validates (evidence: `air_quality_iot_ml.py`)
- Workflow script → Best-model prediction: fits and predicts (evidence: `air_quality_iot_ml.py`)
- Workflow script → Model evaluation: evaluates (evidence: `air_quality_iot_ml.py`)
- Workflow script → Diagnostic plots: creates (evidence: `air_quality_iot_ml.py`)
- Workflow script → Saved model: serializes (evidence: `air_quality_iot_ml.py`)
