# kalpithas07/electricity_forecasting_dashboard architecture

> Architecture diagram of the GitHub repository kalpithas07/electricity_forecasting_dashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kalpithas07/electricity_forecasting_dashboard
- Repository: https://github.com/kalpithas07/electricity_forecasting_dashboard

## Overview

This is a Streamlit electricity forecasting dashboard. Users provide environmental and electricity inputs, view LSTM load and GRU price forecasts, and explore forecast-based insights such as appliance timing and estimated consumption; the app also supports PDF reports. The product is implemented in one large app module, so the nodes below represent its distinct responsibilities rather than separate services. Relationships for capabilities documented but not visible in the excerpts are cited to the README; unsampled implementation details are not inferred.

Main entry points: [`app.py`](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py) (Streamlit dashboard), [`24_hour_electricity_forecast.csv`](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/24_hour_electricity_forecast.csv) (24-hour forecast data), [`electricity_load_lstm.keras`](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/electricity_load_lstm.keras) (LSTM load model), [`electricity_price_gru.keras`](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/electricity_price_gru.keras) (GRU price model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Dashboard experience"]
  node_dashboard["Streamlit dashboard<br/>[app.py]"]
  node_input_forms["Forecast inputs<br/>[app.py]"]
  node_visualizations["Charts and KPIs<br/>[app.py]"]
end

subgraph group_forecasting["Forecasting"]
  node_forecast_data["24-hour forecast data"]
  node_load_model["LSTM load model"]
  node_price_model["GRU price model"]
end

subgraph group_insights["Forecast insights"]
  node_load_insights["Load alerts<br/>[app.py]"]
  node_recommendations["Appliance timing<br/>[app.py]"]
  node_consumption["Consumption estimate<br/>[app.py]"]
  node_billing["Electricity bill<br/>[app.py]"]
end

subgraph group_reporting["Reporting"]
  node_pdf_report["PDF report export<br/>[app.py]"]
end

node_user(("Dashboard user"))

node_user -->|"uses"| node_dashboard
node_dashboard -->|"collects inputs"| node_input_forms
node_dashboard -->|"loads forecast"| node_forecast_data
node_dashboard -->|"predicts load"| node_load_model
node_dashboard -->|"predicts price"| node_price_model
node_dashboard -->|"renders charts"| node_visualizations
node_dashboard -->|"exports report"| node_pdf_report
node_dashboard -->|"shows alerts"| node_load_insights
node_dashboard -->|"shows timing"| node_recommendations
node_dashboard -->|"estimates usage"| node_consumption
node_dashboard -->|"calculates bill"| node_billing
node_forecast_data -->|"provides forecast"| node_visualizations
node_forecast_data -->|"informs timing"| node_recommendations
node_forecast_data -->|"estimates usage"| node_consumption

click node_dashboard "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py"
click node_input_forms "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py"
click node_visualizations "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py"
click node_forecast_data "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/24_hour_electricity_forecast.csv"
click node_load_model "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/electricity_load_lstm.keras"
click node_price_model "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/electricity_price_gru.keras"
click node_load_insights "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py"
click node_recommendations "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py"
click node_consumption "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py"
click node_billing "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py"
click node_pdf_report "https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.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_dashboard,node_input_forms,node_visualizations,node_user toneBlue
class node_forecast_data,node_load_model,node_price_model toneAmber
class node_load_insights,node_recommendations,node_consumption,node_billing toneMint
class node_pdf_report toneRose
```

## Components

### Dashboard experience

- [Streamlit dashboard](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`
- [Forecast inputs](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`
- [Charts and KPIs](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`

### Forecasting

- [24-hour forecast data](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/24_hour_electricity_forecast.csv): `24_hour_electricity_forecast.csv`
- [LSTM load model](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/electricity_load_lstm.keras): `electricity_load_lstm.keras`
- [GRU price model](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/electricity_price_gru.keras): `electricity_price_gru.keras`

### Forecast insights

- [Load alerts](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`
- [Appliance timing](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`
- [Consumption estimate](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`
- [Electricity bill](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`

### Reporting

- [PDF report export](https://github.com/kalpithas07/electricity_forecasting_dashboard/blob/main/app.py): `app.py`

### Other components

- **Dashboard user**

## Connections

- Dashboard user → Streamlit dashboard: uses (evidence: `README.md`)
- Streamlit dashboard → Forecast inputs: collects inputs (evidence: `app.py`)
- Streamlit dashboard → 24-hour forecast data: loads forecast (evidence: `app.py`)
- Streamlit dashboard → LSTM load model: predicts load (evidence: `README.md`)
- Streamlit dashboard → GRU price model: predicts price (evidence: `README.md`)
- Streamlit dashboard → Charts and KPIs: renders charts (evidence: `README.md`)
- Streamlit dashboard → PDF report export: exports report (evidence: `README.md`)
- Streamlit dashboard → Load alerts: shows alerts (evidence: `app.py`)
- Streamlit dashboard → Appliance timing: shows timing (evidence: `app.py`)
- Streamlit dashboard → Consumption estimate: estimates usage (evidence: `app.py`)
- Streamlit dashboard → Electricity bill: calculates bill (evidence: `app.py`)
- 24-hour forecast data → Charts and KPIs: provides forecast (evidence: `app.py`)
- 24-hour forecast data → Appliance timing: informs timing (evidence: `app.py`)
- 24-hour forecast data → Consumption estimate: estimates usage (evidence: `app.py`)
