Solar Energy and Building Physics Laboratory LESO-PB

CitySim Software

The software CitySim is aiming to provide a decision support for urban energy planners and stakeholders to minimize the net use of non-renewable energy sources as well as the associated emissions of greenhouse gases. In developing and testing this software several ambitious aims were reached in order:

  • To support the software users to describe, in an appropriate way, the 3D geometrical buildings forms at the scale of an urban district (comprising several hundreds of buildings) and to attribute these buildings thermo-physical properties in an efficient way using a dedicated XML file format;
  • To simulate the energy demand of these buildings, respecting the stochastic nature of occupants' presence and behaviour and accounting for a range of commonly used heating, ventilation and air conditioning systems (HVAC systems);
  • To determine the energy supplies of these buildings issued from renewable sources, including the radiation exchange driven by the urban environment, generated by a range of commonly used energy conversion systems;
  • To export standard text files (TSV) to allow the software users to support the analysis of energy performance data in order to identify scope for improving upon buildings' performance using their favourite graphical tool.

The software CitySim comprises CitySim Solver, a command-line Integrated Solver for simulating the energy demand and supply of buildings for space conditioning, together with the specification of the input buildings' characteristics (in CitySim XML file format) and the climate files (Meteonorm CLI file format).

In order to run the software simply call:

> CitySim buildings.xml

where buildings.xml is a CitySim XML file. To get the build date simply run CitySim without arguments.

Field surveys within residential and non-residential buildings, as well as World-class building energy analysis software such as ESP-r, were used to proceed to the validation of the novel models and algorithms implemented in CitySim. The IEA BESTEST was passed with sucess [1].

A graphical user interface is distributed by kaemco.

Disclaimer: EPFL shall not be held liable for any consequences resulting from the use and/or exploitation of the CitySim software.



We thank you for your interest in our work and kindly ask you to confirm your acceptance of the following conditions :

CitySim Solver

Build date :
Size :
3.37 MB