The Vertical City Weather Generator (VCWG)

The Vertical City Weather Generator (VCWG) is a software that predicts the urban microclimate in relation to a nearby rural climate given the urban characteristics. VCWG predicts vertical profiles of temperature, wind speed, humidity, and turbulence kinetic energy as well as the building energy performance in an urban area. More details on the model can be found at the Atmospheric Innovations Research (AIR) laboratory website at www.aaa-scientists.com.

To run the VCWG, it is required to put the weather file (*.epw) of the region of interest in the directory "Resources/epw/". This file can be downloaded from EnergyPlus (https://energyplus.net/). The VCWG can take input parameters from the file located in the directory ``resources/parameters/". This file contains the required parameters of the case study including urban characteristics, vegetation parameters, and simulation parameters. The user is able to change the parameters to define and run a simulation of interest. In the python file "VCWG_Example.py" located in the main directory, the user is required to change the name of weather file to the one located in the directory of "resources/epw". Once the user runs "VCWG_Example.py", the simulation will start. Depending on the simulation parameters, it takes a few minutes to generate the output files located in the "Output" directory. It is recommended to discard the first 24 hours of simulation as spin-up period while considering results after this period. VCWG must be run in Python 2.7.