# dimpesh10/carbon-emission- architecture

> Architecture diagram of the GitHub repository dimpesh10/carbon-emission-, 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/dimpesh10/carbon-emission-
- Repository: https://github.com/dimpesh10/carbon-emission-

## Overview

This repository implements a carbon-emission forecasting project: it synthesizes environmental and activity features, prepares time-series inputs, trains forecasting models, and presents predictions and analysis. The principal user workflow is entering conditions in the Streamlit dashboard and viewing a prediction; the API offers a separate prediction interface for external clients. The graph preserves the documented CNN, Transformer, baseline comparison, evaluation, and SHAP capabilities. Several stage-to-stage handoffs are inferred from shared generated files rather than shown directly, so those links are dashed and unverified; preprocessing and API server internals were not sampled.

Main entry points: [`carbon_cnn_project/05_cnn_model.py`](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/05_cnn_model.py) (CNN forecaster), [`carbon_cnn_project/05b_transformer_model.py`](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/05b_transformer_model.py) (Transformer forecaster), [`carbon_cnn_project/04_data_preprocessing.py`](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/04_data_preprocessing.py) (Time-series preparation), [`carbon_cnn_project/07_streamlit_app.py`](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/07_streamlit_app.py) (Streamlit dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_synthesis["Feature synthesis"]
  node_eda["Data exploration"]
  node_preprocessing["Time-series preparation"]
end

subgraph group_models["Forecast models"]
  node_cnn["CNN forecaster<br/>[05_cnn_model.py]"]
  node_transformer["Transformer forecaster"]
end

subgraph group_serving["Prediction interfaces"]
  node_dashboard["Streamlit dashboard"]
  node_api["Prediction API"]
  node_api_test["API client simulation<br/>[09_test_api.py]"]
end

subgraph group_analysis["Model analysis"]
  node_baselines["Baseline comparison"]
  node_evaluation["Model evaluation"]
  node_explainability["SHAP explanations"]
  node_report["Report generation<br/>[generate_report.py]"]
end

node_user(("Dashboard user"))
node_api_client(("API client"))

node_synthesis -.->|"provides source data"| node_preprocessing
node_preprocessing -.->|"prepares training data"| node_cnn
node_preprocessing -.->|"prepares training data"| node_transformer
node_cnn -->|"loads checkpoint"| node_evaluation
node_transformer -->|"loads checkpoint"| node_evaluation
node_cnn -->|"loads checkpoint"| node_baselines
node_transformer -->|"loads checkpoint"| node_baselines
node_transformer -->|"loads preferred model"| node_explainability
node_cnn -->|"fallback model"| node_explainability
node_user -->|"enters conditions"| node_dashboard
node_api_client -->|"posts prediction request"| node_api
node_dashboard -.->|"uses fallback model"| node_cnn
node_dashboard -->|"uses primary model"| node_transformer

click node_synthesis "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/02_data_synthesis.py"
click node_eda "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/03_eda_visualization.py"
click node_preprocessing "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/04_data_preprocessing.py"
click node_cnn "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/05_cnn_model.py"
click node_transformer "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/05b_transformer_model.py"
click node_baselines "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/10_baseline_comparison.py"
click node_evaluation "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/06_model_evaluation.py"
click node_explainability "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/08_explainable_ai.py"
click node_dashboard "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/07_streamlit_app.py"
click node_api "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/09_fastapi_server.py"
click node_api_test "https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/09_test_api.py"
click node_report "https://github.com/dimpesh10/carbon-emission-/blob/main/generate_report.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_synthesis,node_eda,node_preprocessing,node_user,node_api_client toneBlue
class node_cnn,node_transformer toneAmber
class node_dashboard,node_api,node_api_test toneMint
class node_baselines,node_evaluation,node_explainability,node_report toneRose
```

## Components

### Data preparation

- [Feature synthesis](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/02_data_synthesis.py): `carbon_cnn_project/02_data_synthesis.py`
- [Data exploration](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/03_eda_visualization.py): `carbon_cnn_project/03_eda_visualization.py`
- [Time-series preparation](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/04_data_preprocessing.py): `carbon_cnn_project/04_data_preprocessing.py`

### Forecast models

- [CNN forecaster](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/05_cnn_model.py): `carbon_cnn_project/05_cnn_model.py`
- [Transformer forecaster](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/05b_transformer_model.py): `carbon_cnn_project/05b_transformer_model.py`

### Prediction interfaces

- [Streamlit dashboard](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/07_streamlit_app.py): `carbon_cnn_project/07_streamlit_app.py`
- [Prediction API](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/09_fastapi_server.py): `carbon_cnn_project/09_fastapi_server.py`
- [API client simulation](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/09_test_api.py): `carbon_cnn_project/09_test_api.py`

### Model analysis

- [Baseline comparison](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/10_baseline_comparison.py): `carbon_cnn_project/10_baseline_comparison.py`
- [Model evaluation](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/06_model_evaluation.py): `carbon_cnn_project/06_model_evaluation.py`
- [SHAP explanations](https://github.com/dimpesh10/carbon-emission-/blob/main/carbon_cnn_project/08_explainable_ai.py): `carbon_cnn_project/08_explainable_ai.py`
- [Report generation](https://github.com/dimpesh10/carbon-emission-/blob/main/generate_report.py): `generate_report.py`

### Other components

- **Dashboard user**
- **API client**

## Connections

- Feature synthesis → Time-series preparation: provides source data
- Time-series preparation → CNN forecaster: prepares training data
- Time-series preparation → Transformer forecaster: prepares training data
- CNN forecaster → Model evaluation: loads checkpoint (evidence: `carbon_cnn_project/06_model_evaluation.py`)
- Transformer forecaster → Model evaluation: loads checkpoint (evidence: `carbon_cnn_project/06_model_evaluation.py`)
- CNN forecaster → Baseline comparison: loads checkpoint (evidence: `carbon_cnn_project/10_baseline_comparison.py`)
- Transformer forecaster → Baseline comparison: loads checkpoint (evidence: `carbon_cnn_project/10_baseline_comparison.py`)
- Transformer forecaster → SHAP explanations: loads preferred model (evidence: `carbon_cnn_project/08_explainable_ai.py`)
- CNN forecaster → SHAP explanations: fallback model (evidence: `carbon_cnn_project/08_explainable_ai.py`)
- Dashboard user → Streamlit dashboard: enters conditions (evidence: `carbon_cnn_project/07_streamlit_app.py`)
- API client → Prediction API: posts prediction request
- Streamlit dashboard → CNN forecaster: uses fallback model
- Streamlit dashboard → Transformer forecaster: uses primary model (evidence: `carbon_cnn_project/07_streamlit_app.py`)
