Quick start guide

Joris Berkhout edited this page Jul 12, 2016 · 58 revisions

Table of Contents


As the urgency of energy transition is becoming widely recognized, the energy debate is shifting from the global/national scope to a local one. ETMoses allows the various stakeholders to gain insights into the effects of the (local) energy transition. By giving insight into the total social business case of the different stakeholders and the limitations of local infrastructure, better informed choices can be made for efficient local energy systems.

In order for ETMoses to compute meaningful business cases, a detailed description of the local energy situation needs to be made. Such so-called Local Energy Solutions (LES) are locally defined energy system for which ETMoses performs load and financial calculations. A LES contains data on the local electricity, gas and heat infrastructure as well as the technologies that are connected to these infrastructures. In addition, the user can apply strategies to deal with potential congestion of the electricity network as well as to make most use of locally produced electricity. Finally, one can specify market models that, combined with the technical specifications of the LES, define the business cases for the stakeholders within the LES. ETMoses gives the resulting business case for these stakeholders.

Creating a LES can be a time consuming process. This quick start guide is intended to guide the user to a meaningful LES in as fews steps as possible, leaving out some of the details. These details are reported in separate sections of this Wiki that can be accessed through the menu on the right or through direct links in this quick start guide.

It is possible to open an existing LES by selecting one of the LESses from the Previously saved Local Energy Solutions list. Doing so will allow you to review the possibilities of ETMoses, but not give you the possibility to edit the LES. You can find specific instructions on how to review a LES in Step 3 of this guide.

The following steps describe how you can create your own LES.

Step 1: Creating the national context

To start, it is important to provide an appropriate (inter-)national context for your local energy solution (LES) using the Energy Transition Model (ETM). This context can be used later to contrast your local scenario with the national situation in which it is embedded. You can start a new or existing scenario in the professional version of the ETM as shown in the image below.

Start a new or existing scenario in the professional version of the ETM

Starting a scenario opens the user interface of the ETM, showing around 300 sliders or parameters you can set to adjust your scenario. These sliders control about every aspect of the energy system. Specific information on how to use the ETM can be found in its own documentation section.

Adjusting a scenario in the professional version of the ETM

Step 2: Create your LES

Once you are satisfied with the national scenario that you have created in step 1, you can create a LES from this scenario. This involves several steps that are described below.

Scale the national scenario to the size of your LES

First up, you have to scale your scenario to the size of your LES. Scaling is done based on the number of residences in your LES compared to the number of residences in the national scenario. You can find the scaling functionality under Settings -> Scale this scenario.

Scale a national scenario in the Energy Transition Model

This opens the interface displayed below.

Scaling interface in the Energy Transition Model

You can chooses to include or exclude the industry, agriculture and energy sector from your LES. If you choose to include a sector, this sector is scaled with the same scaling factor described above. Once you have scaled your scenario, you can continue to edit your local scenario by adding, for example, more electric vehicles and solar panels. More information about the scaling of your scenario can be found in the page Local Energy Solutions.

Open your scenario in ETMoses

Once you have finished you local scenario, you can open this scenario in ETMoses and start creating a LES from it. You can open your scenario in ETMoses by selecting Settings -> Save and open as local energy solution. This transfers all relevant technologies from your scenario to your LES. Not all technologies are modelled explicitly in ETMoses. For details on which technologies are included, see Technologies.

Open a local scenario as a new LES

When opening your local scenario as a LES, you need to define a few more parameters of your LES. This is done through the following interface that opens automatically.

Create a LES from your local scenario

Specify the topology (i.e. the electricity network)

The exact layout and capacities of the electricity network are key to determine if this network can accommodate the electrical technologies that you have installed in your local scenario. You can select the network for your LES under Topology as shown in the image above (see Topologies for more information). You can also create a new topology under Topology -> Create new. There you can define the structure of the electricity network and the capacities of its components. For instance, if you want to model every household in your testing ground as a separate connection to the network, you will have to specify these connections here. If you want to use your newly defined topology, you have to repeat the previous step (Open your scenario in ETMoses) in order for this topology to show up in the list of topologies.

Specify the market model

The changing energy system will most likely introduce new financial relations between the different stakeholders in your energy system. You can select a market model from the list or create a new one under Market models -> Create new. If you want to use this new market model you have to repeat the step described above under Open your scenario in ETMoses. See Market models for more details.


The scenario id will be automatically filled out if you created your LES from your local scenario.

Connect the testing ground scenario to the network

Once you are satisfied with your topology and market model, you can hit Continue.... This will connect the households and technologies in your local testing ground scenario to the network by specifying which end-point of the network 'holds' which households and/or technologies. The application will make a suggestion for you which you can edit manually. Note that the application assigns load profiles to your technologies and base-load profiles to your households. You can view and edit these profiles under the Profiles menu (see Profiles for more details). You can also add or remove technologies and change the assigned profiles and key figures of the technologies. Below the technology table you can select the technologies for which to switch from maximal concurrency to minimal (see Concurrency for more information). Once you are satisfied with the way the technologies are connected to the end-points in your topology, you can create your new LES by hitting the Create new Local Energy Solution button. Do not forget to give it a recognizable name.

More information on how to create a LES can be found on the Local Energy Solutions page.

Step 3: Explore your LES

There is much to see once you have opened your LES. This quick start guide only describes the highlights; you can find more details in the Results section of this Wiki. You are encouraged to explore the possibilities of ETMoses by changing technologies and parameters; you can always revert the changes you made.

Calculated load on the network

By default ETMoses shows you the load on the electricity network. It might take a while before the chart is loaded as ETMoses calculates the sum of the loads of all technologies for the entire year with a time resolution of 15 minutes.

The load calculation interface (see image below) shows you what the load on each of the components of your network is for each time step in the calculation (usually every 15 minutes). Components that exceed their capacity show up in red. You can click on the network nodes and inspect the load on the nodes. You can select an annual view or a specific week at the bottom of the chart.

By clicking on the Gas load tab, you can view the load on the gas network as well as the annual flow through it. More details on Loads and flows can be found in its dedicated section.

ETMoses showing the load on end-point Households 1

Business case

The resulting business case for all stakeholders in a LES will most likely be determining the success of that LES. You can review the business cases under the dedicated tab. There you can also compare the business case for your LES with that of another LES. This allows you to see the effect of different technologies, strategies and market models. More details can be found in the Business cases section.


You can try to negotiate the fact that some end-points exceed their capacity by applying several pre-defined strategies. These strategies can be selected under the Customise technology behaviour button. More details on these strategies can be found in the Strategies section of this Wiki.

Editing your LES

You can always edit the technologies, profiles, topology and market model by hitting the Edit LES button. There you can adjust all parameters of your LES. The technologies have been described above and their default parameters are described in the subsections of the technologies section. The topologies, market models and business cases are described elsewhere. ETMoses also models the gas and heat network, albeit in a different way than the electricity network. The details of these networks are described in gas network and heat network respectively.

Step 4: Scale up

Scale the testing ground scenario up to national size

Once you are satisfied with your LES, you can see what would happen if the entire country would adopt the technologies that are in your LES. You can scale your testing ground scenario to national size by hitting the Create national scenario button as shown in the image below.

Scale up your LES to national scale

Included technologies

Hitting the Create national scenario button opens a new interface showing you the settings derived from your LES. Currently only the settings for solar PV panels, heat pumps and electric vehicles are translated to slider settings in the ETM interface, but this feature is being extended to include the other technologies in ETMoses as well (see https://github.com/quintel/etmoses/issues/1107 for the current status of the included technologies). Optionally excluded sectors are re-introduced from the original national scenario. You can create a national scenario by hitting the Create national scenario button.

Create national scenario

Step 5: Merge your national scenario with another scenario or scenarios

The ETM makes it possible to merge multiple scenarios. If you, for example, want to see what the national energy system will look like when half of the system is like your local energy system and the other half remains the way it currently is you can merge these scenarios in the ETM. In order to do so, you need to first save your newly created national scenario. This is done under Setting -> Save scenario. Once you have saved your scenario, you can merge it with another scenario by going to Settings -> Load scenario and select the scenario that you would like to merge before hitting the Merge button. This opens the scenario merging interface where you can specify the weight or importance of the scenarios that you are merging. See the image below for an example of merging two scenarios with equal weight. Merging scenarios will only work if the end year of the scenarios, which was set in step 1 of this quick start guide, are identical. Also, it is only possible to merge national scenarios.


You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.