Tutorial 1 – Example case (basics)




This tutorial goes through the implementation of the project called Example case on your All Projects page. It will show you how to implement the following features in your energy model:

à Basic conversion technologies: PV panels and Gas Boiler

à Simple heat pump representation ignoring heat source

à Multi-output technology with the example of a Gas CHP

àStorage modelling, i.e. a battery and heat storage


The energy hub diagram of this tutorial will look like the following:




If you’re in need of more information on a certain aspect of the software don’t forget to have a look at the user guide. Furthermore, if anything is unclear you can find the Help button on the webpage or send an email to  support@sympheny.zendesk.com.



Step 0 – Getting started

à Login to the web page https://app.sympheny.com/login to be able to start constructing your model.

à Click on the upper click on the upper left circled plus symbol () and name your project (e.g. Tutorial 1) to create your own project on your all project page.


à Select your project to go to the Analyses page. Add an analysis by pressing and name it (e.g. Energy Strategy 2050).

Graphical user interface, application, website

Description automatically generated


à Select the analysis Energy Strategy 2050 and to go to the scenario page. Add an analysis by pressing and name it (e.g. Baseline).

à Select the scenario Baseline to open the set-up page. Let’s start setting up your model!



Step 1 - Hubs

The hub section allows you to create different energy hubs that will contain multiple energy conversion, storage and/or network technologies.

à Select Add New Hub, name it (e.g. Swiss Town) and press Add.

à Press Next on the lower right corner to move to the Energy Carriers (EC) section.



Step 2 – Energy carriers

The energy carrier section allows you to define the energy carriers that will be flowing in your energy system, e.g. heat or electricity.

à Select Add New Energy Carrier to define an energy carrier.

à Assign the Type and Name of the energy carrier that you will need in this tutorial and select Add. You can find the list of the ones used in the table below.

à Repeat the procedure for each energy carrier.



Custom name

Thermal Energy

Heat 70-80°C


Electrical Energy



Solar Irradiance

Solar Roof


Fuel (Gaseous)




à Select Next, once you have added all the EC, to move to the Energy Demands section.



Step 3 – Energy Demands

Energy Demands represent the consumptions of the area that you are modelling.

à Press Add New Energy Demand to add an electricity or heat demand.

à Select the hub that requires the energy (only one hub here to choose from). Then select the energy carrier related to the demand and name this energy demand.

Finally, the Energy Profile of the demand is needed over a year. The energy profile should be given in [kWh] and for every hour of the year from the 1st of January to the 31st of December. Use a XLSX file up to 2 MB. The file should have a single sheet, 2 columns no header and exactly 8760 rows. The first column should contain incrementing integers (from 1 to 8760), the second row should contain decimal values corresponding to the hourly energy demand. 

à Press Select From Our Database to make things easier and select already saved profiles. For the Energy carriers given below, select the following energy demands from the Database:

·       Heat 70°C-80°C: MFH-Full_Retrofit-144299-Heat

·       Electricity:  MFH-Full_Retrofit-144299-Electricity

à Give them a scaling factor of 100 and Add. This will give you the demand profiles for 100 multi-family housings.



Step 4 – On-site resources

On-site resources are divided into two sections: Solar resources and Other resources.

à Select Add New Solar Resource to add the solar irradiance available.

à Select the energy carrier Solar Roof and the energy hub created before (i.e. Swiss Town). Then, as for the Energy Demands, you need an excel file giving the Energy Profile of the irradiance for a year given in [kWh/m2].

à Press Select From Our Database and select the irradiance profile Irradiance Lausanne 37 0, which corresponds to the optimal slope and azimuth for the city of Lausanne. Press Select Profile.

à Give the available solar collector area of 10 000 [m2] for example and select Add.

This tutorial does not include any other resource.

à Select Next to move to the Imports & Exports section.



Step 5 – Import & Exports

To include the price and the CO2 emission of energy imports, those need to be added to the model. They depend of the energy carrier imported.

à Select Add New Import/Export.

à Fill in the boxes for the EC Electricity like given below:

à Press Add.

à Repeat this procedure for the EC Gas but adapt the price to 0.08 [CHF/kWh] and the CO2 emissions to 0.22 [kg-CO2/kWh].

The exported energy is defined by their export price and on-site sale price, which is the price (Income) of providing the demand if the export is also a Demand Energy Carrier.

à For the EC Electricity, select Add New Import/Export and fill in the boxes like the following:

à Select Next to move to the Supply Technologies section.



Step 6 – Supply Technologies

Supply Technologies are divided between Conversion Technologies and Storage Technologies. Let’s go through the one’s used for this tutorial.


Step 6.1 – Modelling of PV panels and a Gas boiler

To model PV panels, create the conversion technology Rooftop PV.

à Select Add New Conversion Technology and fill in the boxes:

To be able to reuse this technology for the next Tutorial 4, this technology will be saved for later use.

à Select the Save the technology for future use box and then press Save.

à Fill in the popped up window like the following:

Graphical user interface, application

Description automatically generated

à Press Save again.

à Select Add New Conversion Technology to model a Gas Boiler, and enter the following characteristics and different function:


Step 6.2 – Modelling of a simple heat pump

The Air Source Heat Pump used in the Example case is a very simple representation of a heat pump in which the heat source is ignored.

à Select Add New Conversion Technology and enter the the parameters of the heat pump:


Step 6.3 – Implementing a multi-output technology

This step consists in modelling a Gas CHP (Combined Heat and Power), which generates two outputs: Heat 70-80°C and Electricity.

à Select Add New Conversion Technology and fill in the boxes like given below:

Since the CHP has two outputs one of them has to be defined as the primary output. The efficiency is defined with respect to the primary output/input.

à Select Heat 70-80°C as the primary output.

Here again this technology will be used in Tutorial 4.

à Select the Save the technology for future use box and then press Save. Fill the opening window like the following:


Step 6.4 – (Seasonal) storage modelling

Seasonal storage cannot be modelled per se. Indeed, you can model a heat storage unit but it is the optimizer that will decide if it is used during a certain season or not. For this step two storage units are modelled: a battery and a heat storage unit.

Select Add New Storage Technology on the lower part of the Supply technology page. The stored energy carrier is Electricity, and the Battery has the following characteristics:

à Press Save.

à Repeat the procedure to add the Heat storage:

à Select Next to move to the Network Technologies section.



Step 7 – Network Technologies and Links

Network technologies and links are used to model the pipes used to share an energy carrier between different hubs. This tutorial has only one hub and won’t need any links. See Tutorial 3 for an example with multiple hubs.

à Select Next to move to Other.



Step 8 – Other

This section allows to include the current interest rate in [%] to the model. Set it to 2%.



Step 9 – Review

The review section allows to have an overview over the entire scenario specification and edit a section if it is needed.

à Select Finish Specification & Prepare for Execution to get to the execution of the model.



Step 10 – Execution & Results

Next to the Setup section you can find the Execution section where you select the scenario to be optimized, the two objectives the optimization should be based on (i.e. Minimize Life-Cycle Costs and Minimize CO2 Emissions) and finally the number of points wanted in the pareto front. The more pareto points you have the more precise your pareto front will be but the longer the execution will take.

à Select Execute to start the optimization.

à Once you receive an email that the optimization is completed, Go to the Results section and Select Download to go through the results of the optimization.

à Click on View results to open the dashboard of your optimal design