Urban Energy Balance - SUEWS Advanced


The tutorial Urban Energy Balance - SUEWS Introduction should be completed first. This tutorial is designed to work with QGIS 3.x.


  1. To explore the link between QGIS and SUEWS to include new site-specific information

  2. To examine how it affects the energy fluxes

Overview of steps

  1. Initially become familiar with SUEWS advanced which is a plugin that makes it possible for you to set all parameters that can be manipulated in SUEWS as well as execute the model on multiple grids (Urban Energy Balance - SUEWS Spatial).

  2. Derive new surface information

  3. Run the model

How to run SUEWS Advanced from the UMEP-plugin

  1. Open the plugin which is located at UMEP -> Processor -> Urban Energy Balance -> Urban Energy Balance (SUEWS/BLUEWS, Advanced). This has most of the general settings (e.g. activate the snow module etc.) which are related to RunControl.nml.

  2. Use the Input folder: C:/Users/your_user_name/AppData/Roaming/QGIS/QGIS3/ profiles/default/python/plugins/UMEP/suewsmodel/Input/. The AppData folder might be hidden on your system. Then you need change the settings in your File explorer to also show hidden files and folders. On an iOS system this folder is located at: /Library/Applications/QGIS/QGIS3/profiles/default/ python/plugins/UMEP/suewsmodel/Input/

  3. Create or enter an Output directory of your choice.

  4. From the Input folder - confirm the data are in there.

  5. Tick in Obtain temporal… and set Temporal resolution of output (minutes) to 60.

  6. Click Run

  7. Make sure that output files are created.

  8. You can now close the SUEWS/BLUEWS (Advanced)-plugin again.


Fig. 27 Interface for SUEWS Advanced version.

Sensitivity Test

The default dataset included in Suews Simple has parameters calculated from a source area model to obtain the appropriate values for the input parameters. Roughness parameters such as roughness length (z0) and zero plane displacement length (zd) are calculated using morphometric models. Now you will explore the differences in fluxes using the default settings or using input parameters from the geodata included in the test datasets available for this tutorial. Download the zip-file (see below) and extract the files to a suitable location where you have both reading and writing capabilities.

Data for the tutorial can be downloaded here.



Ground and building DSM

DSM_LondonCity_1m.tif (m asl)

Vegetation DSM

CDSM_LondonCity_1m.tif (m agl)

DEM (digital elevation model)

DEM_LondonCity_1m.tif (m asl)

Land cover


They are all projected in UTM 31N (EPSG:32631). The three surface models originate from a LiDAR dataset. The land cover data is a mixture of Ordnance Survey and the LiDAR data.

  1. Open the geodatasets. Go to Layer > Add layer > Add Raster Layer. Locate the files you downloaded before (see above). You can also drag and drop the data from the Browser-panel to the Layer-panel in QGIS.

  2. A QGIS style file (landcoverstyle.qml) is available for the land cover grid. It can found in C:/Users/your_user_name/AppData/Roaming/QGIS/QGIS3/profiles/ default/python/plugins/UMEP/LandCoverReclassifier. Load it in the Layer > Properties > Symbology > Style (lower left) Load Style.

  3. Click Apply before you close so that the names of the classes also load. You can also get the properties of a layer by right-clicking on a layer in the Layers-window.

  4. If you have another land cover dataset you can use the LandCoverReclassifier in the UMEP pre-processor to populate with the correct values suitable for the UMEP plugin environment.

  5. Now take a moment and investigate the different geodatasets. What is the spatial (pixel) resolution? How is ground represented (what values) in the CDSM?

Generating data from the geodatasets

  1. Make certain that you have the four geodatafiles open. The file at the top of the layers window is the one that is shown on the canvas (figure below). You can swap their order using the layers window.

  2. Open SUEWS Simple.

  3. Begin by adding the test dataset again.

  4. You will now update the building morphology parameters (top left panel in Suews Simple) by generating new values from the geodata. Click Open tool…

  5. This is another plugin within UMEP that can be used to generate morphometric parameters


    Fig. 28 QGIS where Suews Simple and Image Morphometric Parameters (Point) is opened.

  6. First, clear the map canvas from your two other plugin windows, e.g. as figure above.

  7. If you use the default test data in SUEWS Simple - you can overwrite is as you go.

  8. Locate the eddy covariance tower position on the Strand building, King’s College London. To find the position, consult Figure 1 (KSS) in Kotthaus and Grimmond (2014).

  9. Use Select point on canvas and put a point at that location.

  10. Generate a study area. Use 500 m search distance, 5 degree interval and click Generate study area. A circular area will be considered.

  11. Enter the DSM and DEM files (i.e. the files you currently have in the viewer).

  12. Use Kanda et al. (2013) as Roughness calculation method and build as File prefix.

  13. Click Run.


    Fig. 29 Settings for Image Morphometric Parameters for buildings.

  14. In the folder you specified two additional files will be present (i) isotropic - averages of the morphometric parameters (ii) anisotropic - values for each wind sector you specified (5 degrees).

  15. Close this plugin

  16. Click on Fetch file from… in the building morphology panel.

  17. Choose the isotropic file (just generated).

  18. Do the same for vegetation (upper left panel, right). See figure below.

  19. Instead of locating the point again you can use the existing point.

  20. You still need to generate a separate study area for the vegetation calculation.

  21. Examine the CDSM (vegetation file) in your map canvas. As you can see, this data has no ground heights (ground = 0). Therefore, this time Tick the box Raster DSM (only buildings) exist.

  22. Enter the CDSM as your Raster DSM (only 3D objects).

  23. Click Run.


    Fig. 30 Settings for Image Morphometric Parameters for vegetation

  24. If you see a warning that appears that your vegetation fractions between the morphology dataset and land cover dataset are large, you can ignore this for now since the land cover dataset also will change.

  25. Repeat the same procedure for land cover as you did for buildings and vegetation but instead using the Land Cover Fraction (Point) plugin. Use lc as the File prefix

  26. Enter the meteorological file (For Windows users: C:/Users/your_user_name/AppData/Roaming/QGIS/QGIS3/ profiles/default/python/plugins/UMEP/suewsmodel/Input/Kc_2011_data_60.txt), Year etc. This should be the same as the first run you made.

  27. Now you are ready to run the model. Click Run.

  28. Save your plots. Preferable you can zoom in on a couple of days for easier analysis later on.

You are now familiar with the full capabilities of the Suews Simple plugin. Your next task is to choose another location within the geodataset domain, generate data and run the model. Try to choose an area where the fraction of buildings and paved surfaces are low. Consider lowering the Population density to get more realistic model outputs. Compare the results for the different areas. When you are done, compare the fluxes beteen the two runs and try to identify and find explanations for the differences.

Tutorial finished.


  • Grimmond CSB and Oke 1999: Aerodynamic properties of urban areas derived, from analysis of surface form. Journal of Applied Climatology 38:9, 1262-1292

  • Grimmond et al. 2015: Climate Science for Service Partnership: China, Shanghai Meteorological Servce, Shanghai, China, August 2015.

  • Järvi L, Grimmond CSB & Christen A 2011: The Surface Urban Energy and Water Balance Scheme (SUEWS): Evaluation in Los Angeles and Vancouver J. Hydrol. 411, 219-237

  • Järvi L, Grimmond CSB, Taka M, Nordbo A, Setälä H &Strachan IB 2014: Development of the Surface Urban Energy and Water balance Scheme (SUEWS) for cold climate cities, , Geosci. Model Dev. 7, 1691-1711

  • Kormann R, Meixner FX 2001: An analytical footprint model for non-neutral stratification. Bound.-Layer Meteorol., 99, 207-224

  • Kotthaus S and Grimmond CSB 2014: Energy exchange in a dense urban environment - Part II: Impact of spatial heterogeneity of the surface. Urban Climate 10, 281–307

  • Onomura S, Grimmond CSB, Lindberg F, Holmer B, Thorsson S 2015: Meteorological forcing data for urban outdoor thermal comfort models from a coupled convective boundary layer and surface energy balance scheme. Urban Climate. 11:1-23 (link to paper)

  • Ward HC, L Järvi, S Onomura, F Lindberg, A Gabey, CSB Grimmond 2016 SUEWS Manual V2016a, http://urban-climate.net/umep/SUEWS Department of Meteorology, University of Reading, Reading, UK

  • Ward HC, Kotthaus S, Järvi L and Grimmond CSB 2016b: Surface Urban Energy and Water Balance Scheme (SUEWS): Development and evaluation at two UK sites. Urban Climate http://dx.doi.org/10.1016/j.uclim.2016.05.001

  • Ward HC, S Kotthaus, CSB Grimmond, A Bjorkegren, M Wilkinson, WTJ Morrison, JG Evans, JIL Morison, M Iamarino 2015b: Effects of urban density on carbon dioxide exchanges: observations of dense urban, suburban and woodland areas of southern England. Env Pollution 198, 186-200