# tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection architecture

> Architecture diagram of the GitHub repository tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection
- Repository: https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection

## Overview

This repository combines two independent water-monitoring workflows: Arduino/LDR-based microplastic detection and ESP32 sensor-based potability classification. In the latter, synthetic data feeds XGBoost training; the dashboard reads live sensor values, predicts potability, and presents/logs results. The tree also contains a nested copy of the project, including its dashboards and training modules. Firmware paths are included based on the tree and README; firmware internals were not sampled, so their links are documented at the system level.

Main entry points: [`water_potability_detection/water_potability_dashboard.py`](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_dashboard.py) (Potability Dashboard), [`water_potability_detection/train_water_model.py`](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/train_water_model.py) (XGBoost Trainer), [`microplastic_detection/microplastic_dashboard.py`](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_detection/microplastic_dashboard.py) (Microplastic Dashboard), [`microplastic_detection/microplastic_arduino/microplastic_arduino.ino`](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_detection/microplastic_arduino/microplastic_arduino.ino) (Arduino Firmware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_micro["Microplastic Detection"]
  node_ldr_hw{{"Laser and LDR"}}
  node_arduino["Arduino Firmware"]
  node_micro_dash["Microplastic Dashboard"]
  node_micro_log[("Detection Log")]
end

subgraph group_potability["Potability Detection"]
  node_water_sensors{{"Water Sensors"}}
  node_esp32["ESP32 Firmware"]
  node_water_dash["Potability Dashboard"]
end

subgraph group_training["Model Preparation"]
  node_quality_data[("Training Dataset")]
  node_generator["Synthetic Data Generator"]
  node_trainer["XGBoost Trainer"]
  node_model["Model Artifact<br/>[water_model.pkl]"]
  node_scaler["Feature Scaler<br/>[water_scaler.pkl]"]
end

subgraph group_mirror["Nested Project Copy"]
  node_mirror_micro_dash["Copied Microplastic Dashboard"]
  node_mirror_water_dash["Copied Potability Dashboard"]
  node_mirror_generator["Copied Data Generator"]
  node_mirror_trainer["Copied Model Trainer"]
  node_mirror_arduino["Copied Arduino Firmware"]
  node_mirror_esp32["Copied ESP32 Firmware"]
  node_mirror_quality_data[("Copied Dataset Output")]
end

node_user(("Operator"))

node_user -->|"views results"| node_micro_dash
node_ldr_hw -.->|"provides readings"| node_arduino
node_arduino -->|"streams serial data"| node_micro_dash
node_micro_dash -->|"logs readings"| node_micro_log
node_user -->|"views prediction"| node_water_dash
node_water_sensors -->|"provides readings"| node_esp32
node_esp32 -->|"streams sensor data"| node_water_dash
node_generator -->|"writes samples"| node_quality_data
node_quality_data -->|"loads samples"| node_trainer
node_trainer -->|"saves classifier"| node_model
node_trainer -->|"saves scaler"| node_scaler
node_water_dash -->|"loads classifier"| node_model
node_water_dash -->|"loads scaler"| node_scaler
node_mirror_arduino -->|"streams serial data"| node_mirror_micro_dash
node_mirror_esp32 -->|"streams sensor data"| node_mirror_water_dash
node_mirror_generator -.->|"writes samples"| node_mirror_quality_data
node_mirror_quality_data -.->|"loads samples"| node_mirror_trainer

click node_arduino "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_detection/microplastic_arduino/microplastic_arduino.ino"
click node_micro_dash "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_detection/microplastic_dashboard.py"
click node_micro_log "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_log.csv"
click node_esp32 "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/water_potability_esp32.ino"
click node_water_dash "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_dashboard.py"
click node_quality_data "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_quality_data.csv"
click node_generator "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/generate_water_data.py"
click node_trainer "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/train_water_model.py"
click node_model "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_model.pkl"
click node_scaler "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_scaler.pkl"
click node_mirror_micro_dash "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/microplastic_detection/microplastic_dashboard.py"
click node_mirror_water_dash "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/water_potability_dashboard.py"
click node_mirror_generator "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/generate_water_data.py"
click node_mirror_trainer "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/train_water_model.py"
click node_mirror_arduino "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/microplastic_detection/microplastic_arduino/microplastic_arduino.ino"
click node_mirror_esp32 "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/water_potability_esp32/water_potability_esp32.ino"
click node_mirror_quality_data "https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/tree/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection"

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_ldr_hw,node_arduino,node_micro_dash,node_micro_log toneBlue
class node_water_sensors,node_esp32,node_water_dash toneAmber
class node_quality_data,node_generator,node_trainer,node_model,node_scaler toneMint
class node_mirror_micro_dash,node_mirror_water_dash,node_mirror_generator,node_mirror_trainer,node_mirror_arduino,node_mirror_esp32,node_mirror_quality_data toneRose
class node_user toneIndigo
```

## Components

### Microplastic Detection

- **Laser and LDR**
- [Arduino Firmware](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_detection/microplastic_arduino/microplastic_arduino.ino): `microplastic_detection/microplastic_arduino/microplastic_arduino.ino`
- [Microplastic Dashboard](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_detection/microplastic_dashboard.py): `microplastic_detection/microplastic_dashboard.py`
- [Detection Log](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/microplastic_log.csv): `microplastic_log.csv`

### Potability Detection

- **Water Sensors**
- [ESP32 Firmware](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/water_potability_esp32.ino): `water_potability_detection/water_potability_esp32/water_potability_esp32.ino`
- [Potability Dashboard](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_dashboard.py): `water_potability_detection/water_potability_dashboard.py`

### Model Preparation

- [Training Dataset](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_quality_data.csv): `water_quality_data.csv`
- [Synthetic Data Generator](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/generate_water_data.py): `water_potability_detection/generate_water_data.py`
- [XGBoost Trainer](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/train_water_model.py): `water_potability_detection/train_water_model.py`
- [Model Artifact](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_model.pkl): `water_model.pkl`
- [Feature Scaler](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_scaler.pkl): `water_scaler.pkl`

### Nested Project Copy

- [Copied Microplastic Dashboard](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/microplastic_detection/microplastic_dashboard.py): `water_potability_detection/water_potability_esp32/github_project/microplastic_detection/microplastic_dashboard.py`
- [Copied Potability Dashboard](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/water_potability_dashboard.py): `water_potability_detection/water_potability_esp32/github_project/water_potability_detection/water_potability_dashboard.py`
- [Copied Data Generator](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/generate_water_data.py): `water_potability_detection/water_potability_esp32/github_project/water_potability_detection/generate_water_data.py`
- [Copied Model Trainer](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/train_water_model.py): `water_potability_detection/water_potability_esp32/github_project/water_potability_detection/train_water_model.py`
- [Copied Arduino Firmware](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/microplastic_detection/microplastic_arduino/microplastic_arduino.ino): `water_potability_detection/water_potability_esp32/github_project/microplastic_detection/microplastic_arduino/microplastic_arduino.ino`
- [Copied ESP32 Firmware](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/blob/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection/water_potability_esp32/water_potability_esp32.ino): `water_potability_detection/water_potability_esp32/github_project/water_potability_detection/water_potability_esp32/water_potability_esp32.ino`
- [Copied Dataset Output](https://github.com/tsgpushkar7-sketch/water-potablity-detector-and-microplastic-detection/tree/main/water_potability_detection/water_potability_esp32/github_project/water_potability_detection): `water_potability_detection/water_potability_esp32/github_project/water_potability_detection`

### Other components

- **Operator**

## Connections

- Operator → Microplastic Dashboard: views results (evidence: `README.md`)
- Laser and LDR → Arduino Firmware: provides readings (evidence: `README.md`)
- Arduino Firmware → Microplastic Dashboard: streams serial data (evidence: `README.md`)
- Microplastic Dashboard → Detection Log: logs readings (evidence: `microplastic_detection/microplastic_dashboard.py`)
- Operator → Potability Dashboard: views prediction (evidence: `README.md`)
- Water Sensors → ESP32 Firmware: provides readings (evidence: `README.md`)
- ESP32 Firmware → Potability Dashboard: streams sensor data (evidence: `README.md`)
- Synthetic Data Generator → Training Dataset: writes samples (evidence: `water_potability_detection/generate_water_data.py`)
- Training Dataset → XGBoost Trainer: loads samples (evidence: `water_potability_detection/train_water_model.py`)
- XGBoost Trainer → Model Artifact: saves classifier (evidence: `water_potability_detection/train_water_model.py`)
- XGBoost Trainer → Feature Scaler: saves scaler (evidence: `water_potability_detection/train_water_model.py`)
- Potability Dashboard → Model Artifact: loads classifier (evidence: `README.md`)
- Potability Dashboard → Feature Scaler: loads scaler (evidence: `README.md`)
- Copied Arduino Firmware → Copied Microplastic Dashboard: streams serial data (evidence: `README.md`)
- Copied ESP32 Firmware → Copied Potability Dashboard: streams sensor data (evidence: `README.md`)
- Copied Data Generator → Copied Dataset Output: writes samples
- Copied Dataset Output → Copied Model Trainer: loads samples
