# kanors-emr/kinesys-documentation architecture

> Architecture diagram of the GitHub repository kanors-emr/kinesys-documentation, 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/kanors-emr/kinesys-documentation
- Repository: https://github.com/kanors-emr/kinesys-documentation

## Overview

Kinesys is presented here as an energy-system model through documentation, not implemented runtime code: the tree contains Sphinx content and no model source. The principal documented journey is from orientation and data sources through demand and energy-supply topics to applications and indicative results. The graph therefore maps documented subject areas, not executable calls or verified data transfers; relationships are limited to that broad topic progression.

Main entry points: [`source/pages/Demand_projection.rst`](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Demand_projection.rst) (Demand projection), [`source/pages/power_sector.rst`](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/power_sector.rst) (Power sector), [`source/pages/Primary energy supply.rst`](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Primary%20energy%20supply.rst) (Primary energy), [`source/pages/introduction.rst`](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/introduction.rst) (Introduction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orientation["Orientation and inputs"]
  node_intro["Introduction<br/>[introduction.rst]"]
  node_zen["GESM principles"]
  node_data["Data sources<br/>[Data_sources.rst]"]
end

subgraph group_demand["Demand modeling"]
  node_agriculture["Agriculture<br/>[Agriculture.rst]"]
  node_buildings["Buildings"]
  node_industry["Industry<br/>[Industry.rst]"]
  node_transport["Transport<br/>[Transport.rst]"]
  node_demand_projection["Demand projection"]
end

subgraph group_supply["Supply and conversion"]
  node_power["Power sector<br/>[power_sector.rst]"]
  node_primary_energy["Primary energy"]
  node_renewables["Renewables"]
  node_bioenergy["Bioenergy resources"]
  node_liquid_fuels["Liquid fuels"]
  node_hydrogen["Hydrogen<br/>[Hydrogen.rst]"]
  node_ccs["Carbon capture"]
end

subgraph group_system["System and results"]
  node_trades["Energy trades<br/>[Energy trades.rst]"]
  node_timeslices["Timeslice definitions"]
  node_load_shapes["Electricity load shapes"]
  node_applications["Applications and impact"]
  node_results["Indicative results"]
end

node_user(("Model user"))

node_user -->|"consults"| node_intro
node_intro -->|"explains"| node_zen
node_intro -->|"introduces"| node_data
node_data -->|"informs"| node_demand_projection
node_demand_projection -->|"projects demand"| node_agriculture
node_demand_projection -->|"projects demand"| node_buildings
node_demand_projection -->|"projects demand"| node_industry
node_demand_projection -->|"projects demand"| node_transport
node_data -->|"documents inputs"| node_primary_energy
node_primary_energy -->|"covers supply"| node_power
node_primary_energy -->|"covers supply"| node_renewables
node_primary_energy -->|"covers supply"| node_bioenergy
node_power -->|"covers conversion"| node_liquid_fuels
node_power -->|"covers conversion"| node_hydrogen
node_power -->|"covers mitigation"| node_ccs
node_power -->|"covers exchanges"| node_trades
node_demand_projection -->|"describes time detail"| node_timeslices
node_timeslices -->|"supports characterization"| node_load_shapes
node_trades -->|"discusses system impacts"| node_applications
node_applications -->|"presents results"| node_results

click node_intro "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/introduction.rst"
click node_zen "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/The%20ZEN%20of%20GESM.rst"
click node_data "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Data_sources.rst"
click node_agriculture "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Agriculture.rst"
click node_buildings "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Residential%20and%20commercial%20buildings.rst"
click node_industry "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Industry.rst"
click node_transport "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Transport.rst"
click node_demand_projection "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Demand_projection.rst"
click node_power "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/power_sector.rst"
click node_primary_energy "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Primary%20energy%20supply.rst"
click node_renewables "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/renewable_energy_characterization.rst"
click node_bioenergy "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Bioenergy%20resources.rst"
click node_liquid_fuels "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Liquid%20fuels%20processing.rst"
click node_hydrogen "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Hydrogen.rst"
click node_ccs "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Carbon%20capture%20and%20storage%20(CCS).rst"
click node_trades "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Energy%20trades.rst"
click node_timeslices "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/timeslice_definitions.rst"
click node_load_shapes "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/electricity_load_shapes.rst"
click node_applications "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Applications_and_Impact.rst"
click node_results "https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/tables/indicativeresults.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_intro,node_zen,node_data,node_user toneBlue
class node_agriculture,node_buildings,node_industry,node_transport,node_demand_projection toneAmber
class node_power,node_primary_energy,node_renewables,node_bioenergy,node_liquid_fuels,node_hydrogen,node_ccs toneMint
class node_trades,node_timeslices,node_load_shapes,node_applications,node_results toneRose
```

## Components

### Orientation and inputs

- [Introduction](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/introduction.rst): `source/pages/introduction.rst`
- [GESM principles](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/The%20ZEN%20of%20GESM.rst): `source/pages/The ZEN of GESM.rst`
- [Data sources](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Data_sources.rst): `source/pages/Data_sources.rst`

### Demand modeling

- [Agriculture](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Agriculture.rst): `source/pages/Agriculture.rst`
- [Buildings](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Residential%20and%20commercial%20buildings.rst): `source/pages/Residential and commercial buildings.rst`
- [Industry](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Industry.rst): `source/pages/Industry.rst`
- [Transport](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Transport.rst): `source/pages/Transport.rst`
- [Demand projection](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Demand_projection.rst): `source/pages/Demand_projection.rst`

### Supply and conversion

- [Power sector](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/power_sector.rst): `source/pages/power_sector.rst`
- [Primary energy](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Primary%20energy%20supply.rst): `source/pages/Primary energy supply.rst`
- [Renewables](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/renewable_energy_characterization.rst): `source/pages/renewable_energy_characterization.rst`
- [Bioenergy resources](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Bioenergy%20resources.rst): `source/pages/Bioenergy resources.rst`
- [Liquid fuels](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Liquid%20fuels%20processing.rst): `source/pages/Liquid fuels processing.rst`
- [Hydrogen](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Hydrogen.rst): `source/pages/Hydrogen.rst`
- [Carbon capture](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Carbon%20capture%20and%20storage%20(CCS).rst): `source/pages/Carbon capture and storage (CCS).rst`

### System and results

- [Energy trades](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Energy%20trades.rst): `source/pages/Energy trades.rst`
- [Timeslice definitions](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/timeslice_definitions.rst): `source/pages/timeslice_definitions.rst`
- [Electricity load shapes](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/electricity_load_shapes.rst): `source/pages/electricity_load_shapes.rst`
- [Applications and impact](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/Applications_and_Impact.rst): `source/pages/Applications_and_Impact.rst`
- [Indicative results](https://github.com/kanors-emr/kinesys-documentation/blob/main/source/pages/tables/indicativeresults.csv): `source/pages/tables/indicativeresults.csv`

### Other components

- **Model user**

## Connections

- Model user → Introduction: consults
- Introduction → GESM principles: explains
- Introduction → Data sources: introduces
- Data sources → Demand projection: informs
- Demand projection → Agriculture: projects demand
- Demand projection → Buildings: projects demand
- Demand projection → Industry: projects demand
- Demand projection → Transport: projects demand
- Data sources → Primary energy: documents inputs
- Primary energy → Power sector: covers supply
- Primary energy → Renewables: covers supply
- Primary energy → Bioenergy resources: covers supply
- Power sector → Liquid fuels: covers conversion
- Power sector → Hydrogen: covers conversion
- Power sector → Carbon capture: covers mitigation
- Power sector → Energy trades: covers exchanges
- Demand projection → Timeslice definitions: describes time detail
- Timeslice definitions → Electricity load shapes: supports characterization
- Energy trades → Applications and impact: discusses system impacts
- Applications and impact → Indicative results: presents results
