Installation guide for Windows¶
Follow these instructions to install the CityEnergyAnalyst (CEA) on a Windows system (tested with Windows 10).
- Download the latest version of CEA in here.
- Open the installer and follow the instructions
For installing the development version of CEA, tick the box “development version” during the installation.
For previous releases please check here.
To install from the source check here
There are different ways in which you can interact with the code of CEA.
- The command line interface: This is the command line to all the commands of CEA from your computer terminal
- The dashboard: This a web-based interface to CEA, open source and developed by the CEA team.
- The pycharm interface: this interface provides access to all the source code of CEA.
- The Rhino/Grasshopper interface: This a 3D modeling interface to CEA.
- The ArcGIS interface: This a GIS interface to CEA (Not supported anymore).
The command line interface and dashboard interface are included during the installation of CEA.
Other interfaces require a few additional steps to get them up and running.
In order to access and work on the source code of CEA from pycharm do:
- Make sure to have installed the development version of CEA (see step 2 of the installation guide).
- Download and install Github Desktop (64-bit).
- Download and install Pycharm Community edition (64-bit)
- Open PyCharm from the start menu and open project CityEnergyAnalyst
(default location is
File>Settings>Project:CityEnergyAnalyst>Project Interpreter>Project Interpreter.
- Click on the settings button (it looks like a wheel) next to the current interpreter path, and click Add.
System Interpreterfrom the left hand list and select existing environment.
- Point to
- Click apply changes.
This is a highly experimental interface to Rhino/Grasshopper, and we do not include any tutorials nor support to the public. for the time being, just a few modules of CEA have been integrated. If you are interested in support or would like to furthermore activate this interface contact email@example.com
In order to install the interface for Rhino/Grasshopper do:
We ended support of Arcigs by the 1st of May of 2019. This means that there are not anymore tutorials nor advice on how to use this interface. You could still use this interface at your own risk. We invite all CEA users to get acquainted with the CEA Dashboard. The CEA dashboard is our new 100% open source user interface. We will aim to create a first tutorial on how to use this interface by mid-april of 2019.
In order to install the interface for ArcGIS do:
- Download and install the ArcGIS Desktop Background Geoprocessing (64 Bit).
- Follow the steps of the installation guide of the code base described above.
- In the CEA Console type
cea install-arcgisand press ENTER.