Note

Need help? Please let us know in the UMEP Community.

1. Introduction

UMEP is a community open source model that users can contribute to improve and extend the modelling capabilities. It is free to download. A major feature is the ability for a user to interact with spatial information to determine model parameters. The spatial data across a range of scales and sources are accessed through QGIS - a cross-platform, free, open source desktop geographic information systems (GIS) application – that provides data viewing, editing, and analysis capabilities.

This software is in continuous development. There are two types of releases:

  1. Long term release - this may be obtained from the QGIS plugin manager (see details).

  2. Current development version - this can be obtained from the plugin repository. This version you need to manually install yourself (see details).

As of Spring 2020, UMEP for processing is also available. Find more info here.

The UMEP plugin consist of three parts; a pre-processor, a processor and a post-processor. The pre-processor prepares spatial and meteorological data as inputs to the modelling system. The processor includes all the main models for the main calculations. To provide initial “quick looks” the post-processor will enable results to be plotted, statistics calculated etc. based on the model output. For more information on the content and archetecture, see Plugin Architecture.

Information on version history for version 3.x can be found here.

Note

One essential part when working with geodata in a GIS is to make sure that a common coordinate reference system (CRS) is used, both for the data itself and the current QGIS-project you are working in. For more info, see here. It is strongly recommended to reproject/transform all geodatasets into the same projected coordinate system before any processing starts as well using a CRS that is based on meters.

1.1. UMEP: How to Cite

Please use the reference below when UMEP is used:

Lindberg F, Grimmond CSB, Gabey A, Huang B, Kent CW, Sun T, Theeuwes N, Järvi L, Ward H, Capel- Timms I, Chang YY, Jonsson P, Krave N, Liu D, Meyer D, Olofson F, Tan JG, Wästberg D, Xue L, Zhang Z (2018) Urban Multi-scale Environmental Predictor (UMEP) - An integrated tool for city-based climate services. Environmen tal Modelling and Software.99, 70-87 https://doi.org/10.1016/j.envsoft.2017.09.020

The manual should be cited as:

Lindberg F, Grimmond CSB, A Gabey, L Jarvi, CW Kent, N Krave, T Sun, N Wallenberg, HC Ward (2019) Urban Multi-scale Environmental Predictor (UMEP) Manual. https://umep-docs.readthedocs.io/ University of Reading UK, University of Gothenburg Sweden, SIMS China

1.2. YouTube channel

For a detailed description including how to install QGIS and UMEP for Windows, watch instruction video 1 and 2 on our YouTube-channel where you also can find other instructional vidoes related to UMEP and QGIS.

1.3. Plugin Architecture

1.3.1. Pre-Processor

P and M indicates is the plugin is avialable in UMEP for processing and/or UMEP from the menubar in QGIS, respectively.

Meteorological Data

Prepare Existing Data

Transforms meteorological data into UMEP format. (M)

Download data (WATCH)

Prepare meteorological dataset from WATCH (deprecated).

Download data (ERA5)

Prepare meteorological dataset from the Coopernicus programme. (P)

Spatial Data

Spatial Data Downloader

Plugin for retrieving geodata from online services suitable for various UMEP related tools (deprecated, see FAQ (Frequently Asked Questions) on how to retrieve data such population density).

DSM generator

Creation/manipulation of a DSM based on user-specified building footprint vector data and/or Open Street Map data (if available) (P).

Tree generator

Creation/manipulation of vegetation input data. (P)

LCZ Converter

Conversion from Local Climate Zones (LCZs) in the WUDAPT database into SUEWS input data. (M)

Urban geometry

Sky View Factor

Calculation of continuous maps of Sky View Factors (SVF) based on high resolution digital surface models (DSM). Solar access, urban heat island (P)

Wall Height and Aspect

Calculation of height and aspect of building walls based on a DSM. (P)

Urban land cover

Land Cover Reclassifier

Reclassifies a grid into UMEP format land cover grid. Land surface models (M)

Land Cover Fraction (Point)

Land cover fractions estimates from a land cover grid based on a specific point in space. (P)

Land Cover Fraction (Grid)

Land cover fractions estimates from a land cover grid based on a polygon grid (P)

Urban Morphology

Morphometric Calculator (Point)

Morphometric parameters from a DSM based on a specific point in space. (P)

Morphometric Calculator (Grid)

Morphometric parameters estimated from a DSM based on a polygon grid. (P)

Source Area Model (Point)

Source area calculated from a DSM based on a specific point in space. Interpretation of observations (M)

Urban Energy Balance

SUEWS Prepare

Preprocessing and preparing input data for the SUEWS model (M)

SUEWS Converter

Tool for converting input forcing data from older versions of SUEWS (M)

Urban Heat Island

UWG Prepare

Preprocessing and preparing input data for the Urban Weather Generator. Urban heat island (UWG) (M)

UWG Reclassifier

Tool to reclassify urban topologies into UWG building classes. Urban heat island (M)

Urban Wind fields

URock Prepare

Tool to prepare spatial input data for the URock model. (P)

1.3.2. Processor

Outdoor Thermal Comfort

Mean Radiant Temperature (SOLWEIG)

Spatial variations of Tmrt in complex urban environments. Human Health: Outdoor thermal comfort; Park planning; Heat/Health warning; Daily Operations: visitors to parks (PM)

ExtremeFinder

Identify heat waves and cold waves for a certain location. Human Health: Outdoor thermal comfort; Daily City Operations: Energy use; Gas consumption (M)

TreePlanter

Identify locations for new trees based on mitigation of high radiant loads (heat stress). Human Health: Outdoor thermal comfort; Park planning; Heat/Health warning; Urban vegations; Street trees (P)

Urban Energy Balance

LQF

Spatial variations anthropogenic heat release for urban areas (M)

GQF

Anthropogenic Heat (QF). Daily City Operations: Energy use; Gas consumption; Traffic heat loads (M)

SUEWS (Simple)

Urban Energy and Water Balance. Disaster Risk Management: Drought, Heat; Environment evaluation for construction, Water Management, Green infrastructure (M)

SUEWS (Advanced)

Urban Energy and Water Balance. Disaster Risk Management: Drought, Heat; Environment evaluation for construction, Water Management, Green infrastructure (PM)

Solar Radiation

Solar Energy on Building Envelopes (SEBE)

Solar irradiance on building roofs and walls in urban environments. Economy and planning: Energy production, resource planning (P)

Daily Shadow Patterns

Shadow patterns on a DSM and CDSM. Economy and planning: Resource planning Human Health: Outdoor thermal comfort; Park planning (P)

Urban Heat Island

Urban Weather Generator

Model to calculate nocturnal urban heat island. Urban heat island (P)

Urban Wind fields

URock

Semi-empirical model to estimate 3D wind fields in urban settings. Model is based on (Röckle 1990) Thermal comfort; Urban outdoor planning; Wind loads. (P)

1.3.3. Post-Processor

Solar Radiation

SEBE Visualisation

Plugin to visualse output irradiation from SEBE on building roofs, walls and ground. (M)

Outdoor Thermal Comfort

SOLWEIG analyzer

Plugin for plotting, statistical analysis and post-processing of model results from SOLWEIG. (PM)

Spatial TC

Plugin to produce maps of thermal comfort indices using output from SOLWIEG and URock. (P)

Urban Energy Balance

SUEWS analyser

Plugin for plotting and statistical analysis of model results from SUEWS simple and SUEWS advanced. (PM)

Urban Heat Island

UWG analyser

Plugin for statistical spatial analysis of model results from UWG (P)

Benchmark

Benchmark System

For statistical analysis of model results, such as SUEWS. (M)

Urban Winds Fields

URock analyzer

Plugin for analyzing and vizualising URock resluts (P)

1.4. Tool Applications

A key element of UMEP is to facilitate the preparation of input data needed for City-Based Climate Services (CBCS). UMEP provides both guidance and tools that enable data preparation and manipulation. This is particularly important as many end-users have familiarity with some, but not the full spectrum, of the data needed for applications. Below you can find some examples on applications and workflows for the modelling procedure in UMEP and what tools that are connected to each other.

None

Fig. 1.1 Workflow and geodata used for analysing urban energy balance using the SUEWS model. Bold outlined boxes are mandatory items. Yellow, orange and red indicates pre-processor, processor and post-processor tools, respectively. Grey boxes indicate geodatasets.

None

Fig. 1.2 Workflow and geodata used for analysing mean radiant temperature using the SOLWEIG model. Bold outlines are mandatory items. Yellow, orange and red indicates pre-processor, processor and post-processor tools, respectively. Grey boxes indicate geodatasets.

None

Fig. 1.3 Workflow and geodata used for analysing solar irradiance on building envelopes using the SEBE model. Bold outlines are mandatory items. Yellow, orange and red indicates pre-processor, processor and post-processor tools, respectively. Grey boxes indicate geodatasets.

1.4.1. Evaluation and application studies

The tables of studies below is by no means complete. Please help us adding studies by submitting an issue to this documentation repository found at the top of this page. test * Mean Radiant Temperature (SOLWEIG)

  • References: Evaluation

Spatial reference

Reference

Gothenburg, Sweden

Lindberg et al. (2008)

Gothenburg, Sweden

Lindberg and Grimmond (2011)

Freiburg, Germany

Lindberg and Grimmond (2011)

Kassel, Germany

Lindberg and Grimmond (2011)

London, UK

Lindberg et al. (2016)

Hong Kong, China

Lau et al. (2016)

Shanghai, China

Chen et al. (2016)

Szeged, Hungary

Gal and Kantor (2020)

Phoenix, US

Buo et al. (2023)

  • References: Application

Spatial reference

Reference

London, UK

Lindberg and Grimmond (2011)

Gothenburg, Sweden

Lindberg et al. (2013)

Stockholm, Sweden

Lindberg et al. (2013)

Luleå, Sweden

Lindberg et al. (2013)

Adelaide, Australia

Thom et al. (2016)

Berlin, Germany

Jänicke et al. (2015)

Gothenburg, Sweden

Lau et al. (2014)

Frankfurt, Germany

Lau et al. (2014)

Porto, Portugal

Lau et al. (2014)

Gothenburg, Sweden

Lindberg et al. (2016)

Gothenburg, Sweden

Thorsson et al. (2011)

Stockholm, Sweden

Thorsson et al. (2014)

Santos, Brazil

Pereira et al. (2021)

Montreal, Canada

HosseiniHaghighi et al. (2020)

Vancouver, Canada

Aminipouri et al. (2019)

Seoul, South Korea

Yi et al. (2018)

Bilbao, Spain

Azcarate et al. (2021)

Nanjing, China

Kong et al. (2022)

Phoenix, US

Buo et al. (2023)

1.5. Road map for QGIS3 Version

The migration of UMEP into QGIS3 is complete. Some plugins are still experimental. Please report any issues to our repository.