# nishantrajora/aqi-prediction-india-ml architecture

> Architecture diagram of the GitHub repository nishantrajora/aqi-prediction-india-ml, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nishantrajora/aqi-prediction-india-ml
- Repository: https://github.com/nishantrajora/aqi-prediction-india-ml

## Overview

This repository presents an AQI forecasting project: historical city-level observations are explored and preprocessed, transformed into time-ordered training and test data, and used to evaluate Random Forest and XGBoost models. Its Streamlit app communicates the project’s EDA, preprocessing, scores, and feature-importance findings. The README describes a deployed prediction dashboard, but the inspected app source renders explanatory content and metrics; no live inference path is evidenced. Notebook internals were not sampled, so their detailed responsibilities and connections are based on the README.

Main entry points: [`main_project/preprocessed_city_day.csv`](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/preprocessed_city_day.csv) (Prepared records), [`main_project/model_and_testing.ipynb`](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/model_and_testing.ipynb) (Model evaluation), [`main_project/web_app.py`](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/web_app.py) (Streamlit dashboard), [`main_project/city_day.csv`](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/city_day.csv) (City AQI records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["AQI Data"]
  node_raw[("City AQI records<br/>[city_day.csv]")]
  node_processed[("Prepared records")]
  node_train_data[("Training features<br/>[X_train.csv]")]
  node_train_target[("Training targets<br/>[y_train.csv]")]
  node_test_data[("Test features<br/>[X_test.csv]")]
  node_test_target[("Test targets<br/>[y_test.csv]")]
end

subgraph group_analysis["Analysis &amp; Modeling"]
  node_eda["EDA workbook<br/>[EDA_Tableau.twb]"]
  node_preprocessing["Preprocessing"]
  node_modeling["Model evaluation"]
end

subgraph group_presentation["Project Dashboard"]
  node_app["Streamlit dashboard<br/>[web_app.py]"]
  node_collage["Histogram collage<br/>[collage_making.py]"]
end

node_visitor(("Project visitor"))

node_raw -.->|"explores trends"| node_eda
node_raw -.->|"preprocesses"| node_preprocessing
node_preprocessing -.->|"prepares records"| node_processed
node_processed -.->|"time-splits"| node_train_data
node_processed -.->|"time-splits"| node_train_target
node_processed -.->|"time-splits"| node_test_data
node_processed -.->|"time-splits"| node_test_target
node_train_data -.->|"trains models"| node_modeling
node_train_target -.->|"trains models"| node_modeling
node_test_data -.->|"evaluates models"| node_modeling
node_test_target -.->|"evaluates models"| node_modeling
node_visitor -->|"views dashboard"| node_app
node_modeling -.->|"shows reported results"| node_app
node_collage -.->|"supplies histogram display"| node_app

click node_raw "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/city_day.csv"
click node_eda "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/EDA_Tableau.twb"
click node_preprocessing "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/Preprocessing.ipynb"
click node_processed "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/preprocessed_city_day.csv"
click node_train_data "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/X_train.csv"
click node_train_target "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/y_train.csv"
click node_test_data "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/X_test.csv"
click node_test_target "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/y_test.csv"
click node_modeling "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/model_and_testing.ipynb"
click node_app "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/web_app.py"
click node_collage "https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/collage_making.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_raw,node_processed,node_train_data,node_train_target,node_test_data,node_test_target toneBlue
class node_eda,node_preprocessing,node_modeling toneAmber
class node_app,node_collage toneMint
class node_visitor toneIndigo
```

## Components

### AQI Data

- [City AQI records](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/city_day.csv): `main_project/city_day.csv`
- [Prepared records](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/preprocessed_city_day.csv): `main_project/preprocessed_city_day.csv`
- [Training features](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/X_train.csv): `main_project/X_train.csv`
- [Training targets](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/y_train.csv): `main_project/y_train.csv`
- [Test features](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/X_test.csv): `main_project/X_test.csv`
- [Test targets](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/y_test.csv): `main_project/y_test.csv`

### Analysis & Modeling

- [EDA workbook](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/EDA_Tableau.twb): `main_project/EDA_Tableau.twb`
- [Preprocessing](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/Preprocessing.ipynb): `main_project/Preprocessing.ipynb`
- [Model evaluation](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/model_and_testing.ipynb): `main_project/model_and_testing.ipynb`

### Project Dashboard

- [Streamlit dashboard](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/web_app.py): `main_project/web_app.py`
- [Histogram collage](https://github.com/nishantrajora/aqi-prediction-india-ml/blob/main/main_project/collage_making.py): `main_project/collage_making.py`

### Other components

- **Project visitor**

## Connections

- City AQI records → EDA workbook: explores trends (evidence: `README.md`)
- City AQI records → Preprocessing: preprocesses (evidence: `README.md`)
- Preprocessing → Prepared records: prepares records (evidence: `README.md`)
- Prepared records → Training features: time-splits (evidence: `README.md`)
- Prepared records → Training targets: time-splits (evidence: `README.md`)
- Prepared records → Test features: time-splits (evidence: `README.md`)
- Prepared records → Test targets: time-splits (evidence: `README.md`)
- Training features → Model evaluation: trains models (evidence: `README.md`)
- Training targets → Model evaluation: trains models (evidence: `README.md`)
- Test features → Model evaluation: evaluates models (evidence: `README.md`)
- Test targets → Model evaluation: evaluates models (evidence: `README.md`)
- Project visitor → Streamlit dashboard: views dashboard (evidence: `main_project/web_app.py`)
- Model evaluation → Streamlit dashboard: shows reported results (evidence: `README.md`)
- Histogram collage → Streamlit dashboard: supplies histogram display (evidence: `main_project/web_app.py`)
