# nishita1652/ecological-pcc-ev architecture

> Architecture diagram of the GitHub repository nishita1652/ecological-pcc-ev, 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/nishita1652/ecological-pcc-ev
- Repository: https://github.com/nishita1652/ecological-pcc-ev

## Overview

Eco-PCC is a proof-of-concept EV cruise-control system: synthetic traffic scenarios support LSTM training, and the runtime predicts leader speeds, optimizes ego-car torque, simulates vehicle physics, and compares the result with a reactive-driver baseline. The simulation reports speed, safety-gap, and energy outcomes in a dashboard. The README documents forecasting, safety, comfort, and energy objectives; edges reflect only relationships visible in the excerpts or README. The trained weights are present, but their internal structure was not inspected.

Main entry points: [`src/run_simulation.py`](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py) (Race simulation), [`src/lstm_model.py`](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/lstm_model.py) (LSTM training), [`src/mpc_controller.py`](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/mpc_controller.py) (MPC controller), [`src/data_generator.py`](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/data_generator.py) (Traffic scenarios)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_traffic["Traffic Data"]
  node_profiles["Traffic scenarios<br/>[data_generator.py]"]
end

subgraph group_forecast["Forecasting"]
  node_training["LSTM training<br/>[lstm_model.py]"]
  node_weights["Traffic weights<br/>[traffic_lstm.keras]"]
end

subgraph group_control["Predictive Control"]
  node_mpc["MPC controller<br/>[mpc_controller.py]"]
  node_vehicle["EV dynamics"]
end

subgraph group_simulation["Simulation"]
  node_benchmark["Race simulation<br/>[run_simulation.py]"]
  node_traffic_profile["Race traffic profile<br/>[run_simulation.py]"]
  node_baseline["Reactive driver<br/>[run_simulation.py]"]
  node_dashboard["Results dashboard<br/>[run_simulation.py]"]
end

node_operator(("Benchmark operator"))

node_operator -->|"runs benchmark"| node_benchmark
node_profiles -->|"generates sequences"| node_training
node_training -->|"saves weights"| node_weights
node_mpc -->|"loads model"| node_weights
node_benchmark -->|"generates traffic"| node_traffic_profile
node_benchmark -->|"predicts and optimizes"| node_mpc
node_benchmark -->|"updates EVs"| node_vehicle
node_benchmark -->|"computes torque"| node_baseline
node_benchmark -->|"plots outcomes"| node_dashboard
node_training -->|"imports generator"| node_profiles
node_mpc -->|"uses EV state"| node_vehicle

click node_profiles "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/data_generator.py"
click node_training "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/lstm_model.py"
click node_weights "https://github.com/nishita1652/ecological-pcc-ev/blob/main/models/traffic_lstm.keras"
click node_mpc "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/mpc_controller.py"
click node_vehicle "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/vehicle_dynamics.py"
click node_benchmark "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py"
click node_traffic_profile "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py"
click node_baseline "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py"
click node_dashboard "https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.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_profiles toneBlue
class node_training,node_weights toneAmber
class node_mpc,node_vehicle toneMint
class node_benchmark,node_traffic_profile,node_baseline,node_dashboard toneRose
class node_operator toneIndigo
```

## Components

### Traffic Data

- [Traffic scenarios](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/data_generator.py): `src/data_generator.py`

### Forecasting

- [LSTM training](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/lstm_model.py): `src/lstm_model.py`
- [Traffic weights](https://github.com/nishita1652/ecological-pcc-ev/blob/main/models/traffic_lstm.keras): `models/traffic_lstm.keras`

### Predictive Control

- [MPC controller](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/mpc_controller.py): `src/mpc_controller.py`
- [EV dynamics](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/vehicle_dynamics.py): `src/vehicle_dynamics.py`

### Simulation

- [Race simulation](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py): `src/run_simulation.py`
- [Race traffic profile](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py): `src/run_simulation.py`
- [Reactive driver](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py): `src/run_simulation.py`
- [Results dashboard](https://github.com/nishita1652/ecological-pcc-ev/blob/main/src/run_simulation.py): `src/run_simulation.py`

### Other components

- **Benchmark operator**

## Connections

- Benchmark operator → Race simulation: runs benchmark (evidence: `README.md`)
- Traffic scenarios → LSTM training: generates sequences (evidence: `src/lstm_model.py`)
- LSTM training → Traffic weights: saves weights (evidence: `src/lstm_model.py`)
- MPC controller → Traffic weights: loads model (evidence: `src/mpc_controller.py`)
- Race simulation → Race traffic profile: generates traffic (evidence: `src/run_simulation.py`)
- Race simulation → MPC controller: predicts and optimizes (evidence: `src/run_simulation.py`)
- Race simulation → EV dynamics: updates EVs (evidence: `src/run_simulation.py`)
- Race simulation → Reactive driver: computes torque (evidence: `src/run_simulation.py`)
- Race simulation → Results dashboard: plots outcomes (evidence: `src/run_simulation.py`)
- LSTM training → Traffic scenarios: imports generator (evidence: `src/lstm_model.py`)
- MPC controller → EV dynamics: uses EV state (evidence: `src/mpc_controller.py`)
