Graph framework for urban energy systems
Alternatives To Uesgraphs
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
2 months ago13
Must-read papers on graph neural networks (GNN)
G610,571654774 hours ago445November 01, 2023472mitTypeScript
♾ A Graph Visualization Framework in JavaScript
Cytoscape.js9,6508912673 days ago241October 30, 202316mitJavaScript
Graph theory (network) library for visualisation and analysis
10 months ago121mitPython
Implementation of Graph Convolutional Networks in TensorFlow
Graph_nets5,18871a year ago7January 29, 20205apache-2.0Python
Build Graph Nets in Tensorflow
Serial Studio3,802
2 months ago63otherC++
Multi-purpose serial data visualization & processing program
Awesome Network Analysis3,192
4 months ago7R
A curated list of awesome network analysis resources.
3 years ago42mitPython
Graph Convolutional Networks in PyTorch
Pytorch_geometric_temporal2,3864a month ago46September 04, 202227mitPython
PyTorch Geometric Temporal: Spatiotemporal Signal Processing with Neural Machine Learning Models (CIKM 2021)
Spektral2,3176a month ago34June 01, 202367mitPython
Graph Neural Networks with Keras and Tensorflow 2.
Alternatives To Uesgraphs
Select To Compare

Alternative Project Comparisons

E.ON EBC RWTH Aachen University


License Build Status

uesgraphs is a Python package to describe Urban Energy Systems and manage their data in a Python graph structure. We extend the networkx Graph class and add basic methods to represent buildings and energy networks in the graph. uesgraphs can be used as a foundation to analyze energy network structures, evaluate district energy systems or generate simulation models.

uesgraphs is being developed at RWTH Aachen University, E.ON Energy Research Center, Institute for Energy Efficient Buildings and Indoor Climate.

Getting started

Install uesgraphs

uesgraphs relies on other packages to function correctly. On Windows, it may be necessary to install shapely and pyproj before uesgraphs. We recommend to download the .whl files for installing shapely and pyproj from the Unofficial Windows Binaries for Python Extension Packages for your system and python versions. Install both .whl files with pip install <path/to/file.whl>.

One way to get uesgraphs set up is to use a fresh Conda environment by following these steps:

  • Install Miniconda or update your conda installation with conda update conda
  • Create a new environment with conda create -n <nameOfEnvironment> python=3.6
  • Activate the environment with source activate <nameOfEnvironment> on Linux or activate <nameOfEnvironment> on Windows
  • Clone uesgraphs with git clone https://github.com/RWTH-EBC/uesgraphs.git
  • Install uesgraphs with pip install -e <path/to/your/uesgraphs>
  • Verify your uesgraphs installation by running the automated tests. Go to your uesgraphs top-level folder and type py.test --mpl


You can assemble a graph of an urban energy system by adding buildings, network nodes and edges to an UESGraph object. The following code builds a heating network from one building to another, connected via one network node:

import uesgraphs as ug
from shapely.geometry import Point

graph = ug.UESGraph()

supply = graph.add_building(
    position=Point(0, 10),
demand = graph.add_building(
    name='Building 1',
    position=Point(50, 15),
heating_node = graph.add_network_node(
    position=Point(30, 5),

graph.add_edge(supply, heating_node)
graph.add_edge(heating_node, demand)

You can go on to plot this energy system with

vis = ug.Visuals(graph)

Example graph

Instead of building a graph from scratch, uesgraphs comes with an example containing all supported energy network types. You can create this example graph with

import uesgraphs as ug
from shapely.geometry import Point

graph = ug.simple_dhc_model()
graph = ug.add_more_networks(graph)

vis = ug.Visuals(example_district)
fig = vis.show_network(

This leads to the following plot:

Example graph

You can extract single networks into their own subgraph with

heating_network_1 = graph.create_subgraphs('heating')['default']

In the example above, this extracts the first of the two heating networks shown in red:

Example graph

You can use this graph framework to add data to the nodes and edges, e.g.

import uesgraphs as ug
from shapely.geometry import Point

graph = ug.UESGraph()

demand = graph.add_building(
    name='Building 1',
    position=Point(50, 15),

graph.nodes[demand]['heat_load_kW'] = 200

This can be used as a foundation to analyze networks or to generate models.


uesgraphs is released by RWTH Aachen University, E.ON Energy Research Center, Institute for Energy Efficient Buildings and Indoor Climate, under the MIT License.


To reference uesgraphs, please cite the following paper (doi 10.1016/j.energy.2016.04.023):

Marcus Fuchs, Jens Teichmann, Moritz Lauster, Peter Remmen, Rita Streblow, Dirk Müller: Workflow automation for combined modeling of buildings and district energy systems, Energy, Volume 117, Part 2, 2016, Pages 478-484.

The BibTex for this paper is:

  doi = {10.1016/j.energy.2016.04.023},
  url = {https://doi.org/10.1016/j.energy.2016.04.023},
  year  = {2016},
  month = {dec},
  publisher = {Elsevier {BV}},
  volume = {117},
  pages = {478--484},
  author = {Marcus Fuchs and Jens Teichmann and Moritz Lauster and Peter Remmen and Rita Streblow and Dirk M\"{u}ller},
  title = {Workflow automation for combined modeling of buildings and district energy systems},
  journal = {Energy}


This work was supported by the Helmholtz Association under the Joint Initiative “Energy System 2050 – A Contribution of the Research Field Energy”.

Parts of uesgraphs have been developed within public funded projects and with financial support by BMWi (German Federal Ministry for Economic Affairs and Energy).

Popular Graph Projects
Popular Network Projects
Popular Computer Science Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.