ESDL Documentation

The documentation of the Energy System Description Language, an open source project on:

ESDL generic information

What is ESDL?

ESDL is a modelling language created to describe complete (hybrid) energy systems in one uniform format. It allows to describe information about the individual energy system components, how they are connected, how they are used (e.g. using energy production or consumption profiles), where they are physically located (on the map), what they cost (now and in future). Furthermore information about buildings in an area, energy potential, KPIs (on buildings, areas, or any assets) can be described. Possible applications are facilitating interoperability between different energy transition models and publishing open data on energy systems.

Current state

ESDL is still being developed, with new versions being released periodically. The main structure will not change anymore. New attributes can be added to ESSL classes or new classes can be added, whenever a use case requires this. We are using ESDL in many different projects now to get experience in using it and collect feedback. Some parts are still subject to discussion. Feel free to start using it!


ESDL is licensed under the Apache 2.0 license, a permissive free software license written by the Apache Software Foundation. It allows users to use ESDL for any purpose, to distribute it, to modify it, and to distribute modified versions of the software under the terms of the license, without concern for royalties.


ESDL projects and applications

ESDL is used in many internal TNO projects each with a different focus. Several applications, tooling and simulation models have been developped during the last few months. More and more external projects with partners start using it. To get an impression of the possibilities have a look at this page for tooling and this page for projects

ESDL Documentation

This documentation contains the following chapters:

Alternatively, you can download an eBook version in the following formats (will not be updated regularly!):




ESDL Model reference documentation

Additional to this website, a browsable version of the reference documentation is generated from the ESDL model. In the reference documentation all the classes, attributes and references are shown in UML-based diagrams. This site can be found at