The etm-esdl app allows for converting ESDL files into scenarios on the Energy Transition Model. Please vist the ESDL documentation if you want to learn more about this energy language.
You can find more info on the api at http://esdl.energytransitionmodel.com/api/v1/. Here you can find all the endpoints and their documentation.
The etm-edsl app is a python Flask app that has support for running in Docker. We recommend installing Docker on your system.
You can download a Docker image, or generate one yourself with docker-compose build
If you want to run the app locally in debug and reload-on-change mode, please use docker-compose up.
For development and testing please use pipenv. Install and setup with the following commands:
pip3 install pipenv
pipenv install --dev
The dev flag is used to install development dependencies as well (like pytest).
You can now test your local changes by running pytest. You can use the shortcut:
pipenv run test
You can update your local dependencies when the Pipfile.lock was updated upstream by using
pipenv install --dev --ignore-pipfile
When you update the Pipfile manually please relock and install new dependencies by simply
pipenv install --dev
The aim of this manual is to support users in applying the Mondaine suite. More specifically, how to use the ETM as a part of the Mondaine suite.
The ETM is one of the models and tools participating in the Mondaine suite, in addition to Vesta-MAIS (PBL, developed using GeoDMS by Object Vision), PICO (Geodan), and the ESDL MapEditor (TNO).
The ETM is an open-source interactive tool for energy modeling. It is aimed at anyone who personally wants to explore the possibilities for the future of the energy system. The model is bottom-up and demand-driven and it ensures that energy is conserved. The ETM challenges the user to think about all aspects of the energy future, including supply, demand, flexibility and costs. This makes ETM ideally suited as support for fact-based discussions on energy in the public sector, business and education. The ETM is used by many different parties, among which are grid operators, governmental parties, energy consultants, and NGOs, to justify plans for the future energy system.
In addition to the yearly energy balance, the ETM has a merit order module that calculates the hourly electricity mix based on the demand for electricity and the installed capacities and marginal costs of the electricity producing technologies. The model also performs calculations on an hourly basis for other carriers, such as network gas, hydrogen and heat. If there are any hourly mismatches between demand and supply—think of electricity excesses from volatile producers—the user may explore the impact of flexibility options such as storage or conversion techniques.
In order to test the robustness of a scenario, sensitivity analyses can be performed. Assumptions related to costs (for instance, fuel prices) can be adjusted or a future year with extreme weather conditions can be selected. The user may explore to what extent these changes affect the future energy system.
At present, the ETM includes models for eight countries, the EU-27, and many Dutch provinces, energy (RES) regions and municipalities.
Summarizing, the ETM:
- allows you to bring together energy plans at different levels,
- provides insights into how demand and supply balance on both a yearly and an hourly base, and
- provides system insights such as CO2 emissions, renewability, energy mix, etc.
By using the Mondaine suite, users of the ETM are able to exploit the strengths of other models:
-
The ESDL MapEditor allows to geographically create or edit a scenario and convert it into an ETM scenario. Also, it allows to provide a geographical impression of assumptions made in an ETM scenario. For instance, it allows users to explore the spatial impact of assumptions on the installed capacity of wind turbines and/or solar PV parks.
-
Vesta-MAIS is used to calculate the impact of heat transition plans for the built environment on a very detailed level. By using the Mondaine suite, these plans can be aggregated and converted into an ETM scenario. This makes it possible to build further upon the results from Vesta-MAIS.
In order for the models and tools to collaborate, ESDL is used to describe relevant parts of the energy system. On the one hand, ESDL energy systems can be used to descripe the output of a model or tool. On the other hand, ESDL energy systems can be used as input for other models or tools.
This app comprises of an interface that allows to
- import an ESDL file and convert it to an ETM scenario
- export an ETM scenario to an ESDL file
ESDL files can be imported and converted into ETM scenarios in two ways: i) in the ESDL MapEditor, or (ii) in the ETM itself. Both ways are described below.
After having loaded an ESDL file in the ESDL MapEditor, you can call one of the external ESDL services.
On the right side of the ESDL MapEditor a frame will pop up that provides an overview of all available ESDL services. Select the "Open" button next to the ETM service. If necessary, change the environment from pro to beta. However, in nearly all cases you should keep the pro environment. This allows you to use the stable version of the ETM. After selecting the "Run Service" button, the ETM service will run.
When the service has been run, an ETM scenario has been created that can be opened by clicking the "Open ETM" link.
This redirects you to the ETM scenario.
WIP
WIP
During the Mondaine project several features have been developed that can be exploited by ETM users. These involve the following topics:
- Renewable electricity (wind turbines, solar PV parks)
- Solar PV on rooftops
- Heat transition built environment
- System integration
For each topic, we'll go a bit more in depth below.
The ESDL MapEditor provides a service by Geodan to explore spatial possibilities for large scale wind and solar. Afterwards, one may add one or more assets from the Energy Data Repository in order to place ETM onshore windturbines or solar PV parks within these search areas. The ESDL MapEditor allows the user to adjust the technical specifications of these production assets, such as the installed capacity or the number of full load hours. These values are then updated in the ESDL energy system.
When calling the ETM service, this information is processed and converted into the corresponding input values. Here, the installed capacity in our ETM scenario is set based on the three 3 MW wind turbines that were added to the ESDL. The ETM allows the user to easily explore the impact of the production by these wind turbines on the electricity balance. What is the share of the wind production compared to the total electricity demand? What is the impact of doubling the installed capacity? How realistic is the ambition for an energy neutral energy system?
Another service by Geodan that is hosted by the ESDL MapEditor is the possibility to explore the potential for rooftop PV panels. The service allows the user to query the full rooftop solar potential after which the user can decide which percentage of the potential will be used in the future scenario, i.e. what share of the potential is converted into actual installations.
This percentage is processed by the ETM service and converted into input values for solar PV on rooftops of both residences and services.
Vesta-MAIS is used to calculate the impact of heat transition plans for the built environment. These plans can be aggregated and converted into a heating technology mix both for residences and services--i.e. input values for the future share of residences/services with a (hybrid) heat pump or heat network connection. Also, energy savings are taken into account here. Based on the future energy labels by Vesta-MAIS the input values for heat reduction are set in the ETM.
As explained in the paragraphs above, the Mondaine Suite can be used to aggregate multiple energy plans described in ESDL and convert those into an ETM scenario. This allows the user to explore the effects of system integration; to what extent do energy plans affect each other? Also, the user may make other assumptions about the future energy system. For instance, about the share of greengas in the gas network, about the CO2-emissions of imported electricity, or about the modal shift and technology mix of the transport sector.
After all future energy plans and assumptions have been brought together in the ETM scenario, the user can get insights into integral system outcomes, such as:
- CO2 emissions,
- the reduction in energy use,
- the renewability of the future energy system,
- the energy balance for electricity, gas or heat on both a yearly and hourly basis,
- the need for flexibility caused by possible imbalances between demand and supply.
These system insights may help the user to refine and improve the energy plans in order to optimize the system integration
Do you have any questions on the above? Don't bother to contact us!
- Nora (https://github.com/noracato)
- Roos (https://github.com/redekok)
For more information on the Mondaine Suite, please visit our website: https://www.mondaine-suite.nl.