# akanudia/vervestacks_models architecture

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

- Interactive diagram: https://gitdiagram.com/akanudia/vervestacks_models
- Repository: https://github.com/akanudia/vervestacks_models

## Overview

VerveStacks is a repository of country-specific power and heat energy-system models, distributed as branches for use in VEDA/TIMES. The documented workflow is to obtain a country model, open and solve it, then validate its representation and explore scenarios. The README describes substantial model capabilities, but the provided tree contains no model files or source excerpts; paths and relationships therefore reflect only documented evidence, not verified implementation wiring.

Main entry points: [`README.md`](https://github.com/akanudia/vervestacks_models/blob/main/README.md) (Country Model Branches)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model_data["Country Models"]
  node_country_models["Country Model Branches<br/>[README.md]"]
  node_fleet["Generation Fleet<br/>[README.md]"]
  node_grid["Grid Infrastructure<br/>[README.md]"]
  node_renewables["Renewable Potential<br/>[README.md]"]
  node_temporal["Timeslices and Profiles<br/>[README.md]"]
  node_climate["Climate Scenarios<br/>[README.md]"]
end

subgraph group_system_scope["Energy System Scope"]
  node_heat["Heat and Cogeneration<br/>[README.md]"]
  node_ccs["CO₂ Networks<br/>[README.md]"]
  node_storage["Utility Storage<br/>[README.md]"]
  node_flexible_loads["Flexible Loads<br/>[README.md]"]
end

subgraph group_analysis["Analysis and Validation"]
  node_validation["Model Validation<br/>[README.md]"]
  node_scenario_analysis["Scenario Analysis<br/>[README.md]"]
  node_documentation["Model Documentation<br/>[README.md]"]
end

subgraph group_execution["Model Use"]
  node_veda["VEDA-TIMES"]
  node_veda_online["Veda Online"]
  node_solve["Model Solve"]
end

node_analyst(("Analyst"))

node_fleet -->|"included in"| node_country_models
node_grid -->|"included where available"| node_country_models
node_renewables -->|"included in"| node_country_models
node_temporal -->|"included in"| node_country_models
node_climate -->|"integrated in"| node_country_models
node_heat -->|"integrated in"| node_country_models
node_ccs -->|"included where supported"| node_country_models
node_storage -->|"integrated in"| node_country_models
node_flexible_loads -->|"integrated in"| node_country_models
node_analyst -->|"selects branch"| node_country_models
node_country_models -->|"opened in"| node_veda
node_country_models -.->|"forked for"| node_veda_online
node_veda -->|"runs model"| node_solve
node_veda_online -.->|"solves model"| node_solve
node_analyst -->|"checks against reality"| node_validation
node_analyst -->|"explores scenarios"| node_scenario_analysis
node_solve -->|"provides model results"| node_validation
node_solve -->|"provides model results"| node_scenario_analysis
node_country_models -->|"ships with"| node_documentation

click node_country_models "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_fleet "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_grid "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_renewables "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_temporal "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_climate "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_heat "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_ccs "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_storage "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_flexible_loads "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_validation "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_scenario_analysis "https://github.com/akanudia/vervestacks_models/blob/main/README.md"
click node_documentation "https://github.com/akanudia/vervestacks_models/blob/main/README.md"

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_country_models,node_fleet,node_grid,node_renewables,node_temporal,node_climate toneBlue
class node_heat,node_ccs,node_storage,node_flexible_loads toneAmber
class node_validation,node_scenario_analysis,node_documentation toneMint
class node_veda,node_veda_online,node_solve toneRose
class node_analyst toneIndigo
```

## Components

### Country Models

- [Country Model Branches](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Generation Fleet](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Grid Infrastructure](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Renewable Potential](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Timeslices and Profiles](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Climate Scenarios](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`

### Energy System Scope

- [Heat and Cogeneration](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [CO₂ Networks](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Utility Storage](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Flexible Loads](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`

### Analysis and Validation

- [Model Validation](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Scenario Analysis](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`
- [Model Documentation](https://github.com/akanudia/vervestacks_models/blob/main/README.md): `README.md`

### Model Use

- **VEDA-TIMES**
- **Veda Online**
- **Model Solve**

### Other components

- **Analyst**

## Connections

- Generation Fleet → Country Model Branches: included in
- Grid Infrastructure → Country Model Branches: included where available
- Renewable Potential → Country Model Branches: included in
- Timeslices and Profiles → Country Model Branches: included in
- Climate Scenarios → Country Model Branches: integrated in
- Heat and Cogeneration → Country Model Branches: integrated in
- CO₂ Networks → Country Model Branches: included where supported
- Utility Storage → Country Model Branches: integrated in
- Flexible Loads → Country Model Branches: integrated in
- Analyst → Country Model Branches: selects branch
- Country Model Branches → VEDA-TIMES: opened in
- Country Model Branches → Veda Online: forked for
- VEDA-TIMES → Model Solve: runs model
- Veda Online → Model Solve: solves model
- Analyst → Model Validation: checks against reality
- Analyst → Scenario Analysis: explores scenarios
- Model Solve → Model Validation: provides model results
- Model Solve → Scenario Analysis: provides model results
- Country Model Branches → Model Documentation: ships with