# sumanthjkl/ev-micro-abl architecture

> Architecture diagram of the GitHub repository sumanthjkl/ev-micro-abl, 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/sumanthjkl/ev-micro-abl
- Repository: https://github.com/sumanthjkl/ev-micro-abl

## Overview

This is an interactive electricity-generation carbon analytics dashboard. The user selects a country or region, years, and sources; the dashboard filters the processed Ember dataset, computes metrics and summaries, and presents charts, comparisons, insights, and downloadable data. A separate pipeline downloads and transforms Ember data into the CSV consumed by the app. Dashboard capabilities are documented in the README; the sampled app excerpt shows only some tab implementations, so unsampled features are represented at the app level.

Main entry points: [`app.py`](https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py) (Streamlit Dashboard), [`src/data_processing.py`](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/data_processing.py) (Dataset Download & Load), [`src/analysis.py`](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py) (DataFrame Analytics), [`data/processed/electricity_carbon_clean.csv`](https://github.com/sumanthjkl/ev-micro-abl/blob/main/data/processed/electricity_carbon_clean.csv) (Processed Dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Dashboard"]
  node_app["Streamlit Dashboard<br/>[app.py]"]
  node_filters["Filter Controls<br/>[app.py]"]
  node_charts["Analysis Views<br/>[app.py]"]
  node_compare["Comparisons<br/>[app.py]"]
  node_insights_export["Insights &amp; Export<br/>[app.py]"]
end

subgraph group_analytics["Analysis"]
  node_analysis["DataFrame Analytics<br/>[analysis.py]"]
  node_kpis["KPI Metrics<br/>[analysis.py]"]
  node_summaries["Source &amp; Trend Summaries<br/>[analysis.py]"]
  node_environmental_insights["Environmental Insights<br/>[analysis.py]"]
end

subgraph group_pipeline["Data Pipeline"]
  node_runner["Pipeline Runner<br/>[run_pipeline.py]"]
  node_ingestion["Dataset Download &amp; Load<br/>[data_processing.py]"]
  node_transform["Normalize &amp; Clean<br/>[data_processing.py]"]
  node_validation["Data Validation<br/>[data_processing.py]"]
end

subgraph group_storage["Data Storage"]
  node_raw_csv["Raw Dataset CSV"]
  node_processed_csv[("Processed Dataset")]
end

node_user(("Dashboard User"))
node_ember(("Ember Dataset"))

node_user -->|"uses"| node_app
node_app -->|"offers"| node_filters
node_app -->|"presents"| node_charts
node_app -->|"presents"| node_compare
node_app -->|"offers"| node_insights_export
node_app -->|"reads"| node_processed_csv
node_app -->|"calls"| node_analysis
node_filters -->|"filters via"| node_analysis
node_charts -->|"renders from"| node_summaries
node_compare -->|"calls"| node_analysis
node_insights_export -->|"generates via"| node_environmental_insights
node_analysis -->|"calculates"| node_kpis
node_analysis -->|"aggregates"| node_summaries
node_environmental_insights -->|"uses"| node_summaries
node_runner -->|"runs"| node_ingestion
node_ingestion -->|"downloads"| node_ember
node_ingestion -->|"loads"| node_raw_csv
node_ingestion -->|"runs"| node_transform
node_transform -->|"validates"| node_validation
node_ingestion -->|"writes"| node_processed_csv

click node_app "https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py"
click node_filters "https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py"
click node_charts "https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py"
click node_compare "https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py"
click node_insights_export "https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py"
click node_analysis "https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py"
click node_kpis "https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py"
click node_summaries "https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py"
click node_environmental_insights "https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py"
click node_runner "https://github.com/sumanthjkl/ev-micro-abl/blob/main/run_pipeline.py"
click node_ingestion "https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/data_processing.py"
click node_transform "https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/data_processing.py"
click node_validation "https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/data_processing.py"
click node_processed_csv "https://github.com/sumanthjkl/ev-micro-abl/blob/main/data/processed/electricity_carbon_clean.csv"

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_app,node_filters,node_charts,node_compare,node_insights_export,node_user toneBlue
class node_analysis,node_kpis,node_summaries,node_environmental_insights toneAmber
class node_runner,node_ingestion,node_transform,node_validation toneMint
class node_raw_csv,node_processed_csv toneRose
class node_ember toneIndigo
```

## Components

### Dashboard

- [Streamlit Dashboard](https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py): `app.py`
- [Filter Controls](https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py): `app.py`
- [Analysis Views](https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py): `app.py`
- [Comparisons](https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py): `app.py`
- [Insights & Export](https://github.com/sumanthjkl/ev-micro-abl/blob/main/app.py): `app.py`

### Analysis

- [DataFrame Analytics](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py): `src/analysis.py`
- [KPI Metrics](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py): `src/analysis.py`
- [Source & Trend Summaries](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py): `src/analysis.py`
- [Environmental Insights](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/analysis.py): `src/analysis.py`

### Data Pipeline

- [Pipeline Runner](https://github.com/sumanthjkl/ev-micro-abl/blob/main/run_pipeline.py): `run_pipeline.py`
- [Dataset Download & Load](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/data_processing.py): `src/data_processing.py`
- [Normalize & Clean](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/data_processing.py): `src/data_processing.py`
- [Data Validation](https://github.com/sumanthjkl/ev-micro-abl/blob/main/src/data_processing.py): `src/data_processing.py`

### Data Storage

- **Raw Dataset CSV**
- [Processed Dataset](https://github.com/sumanthjkl/ev-micro-abl/blob/main/data/processed/electricity_carbon_clean.csv): `data/processed/electricity_carbon_clean.csv`

### Other components

- **Dashboard User**
- **Ember Dataset**

## Connections

- Dashboard User → Streamlit Dashboard: uses (evidence: `README.md`)
- Streamlit Dashboard → Filter Controls: offers (evidence: `README.md`)
- Streamlit Dashboard → Analysis Views: presents (evidence: `README.md`)
- Streamlit Dashboard → Comparisons: presents (evidence: `README.md`)
- Streamlit Dashboard → Insights & Export: offers (evidence: `README.md`)
- Streamlit Dashboard → Processed Dataset: reads (evidence: `app.py`)
- Streamlit Dashboard → DataFrame Analytics: calls (evidence: `app.py`)
- Filter Controls → DataFrame Analytics: filters via (evidence: `app.py`)
- Analysis Views → Source & Trend Summaries: renders from (evidence: `app.py`)
- Comparisons → DataFrame Analytics: calls (evidence: `app.py`)
- Insights & Export → Environmental Insights: generates via (evidence: `app.py`)
- DataFrame Analytics → KPI Metrics: calculates (evidence: `src/analysis.py`)
- DataFrame Analytics → Source & Trend Summaries: aggregates (evidence: `src/analysis.py`)
- Environmental Insights → Source & Trend Summaries: uses (evidence: `src/analysis.py`)
- Pipeline Runner → Dataset Download & Load: runs (evidence: `run_pipeline.py`)
- Dataset Download & Load → Ember Dataset: downloads (evidence: `src/data_processing.py`)
- Dataset Download & Load → Raw Dataset CSV: loads (evidence: `src/data_processing.py`)
- Dataset Download & Load → Normalize & Clean: runs (evidence: `src/data_processing.py`)
- Normalize & Clean → Data Validation: validates (evidence: `src/data_processing.py`)
- Dataset Download & Load → Processed Dataset: writes (evidence: `src/data_processing.py`)
