UMEP Manual/ Tutorials/IntroductionToSuews
- 1 Introduction
- 2 SUEWS Simple Objectives
- 3 Initial Steps
- 4 SUEWS Model Inputs
- 5 How to Run SuewsSimple from the UMEP-plugin
- 6 Model results
- 7 Saving a Figure
- 8 Output data Files
- 9 Sensitivity to land surface fractions
- 10 Advanced SUEWS Tutorial
- 11 Reporting a bug
- 12 References
- 13 Definitions and Notation
- 14 Further explanation
In this tutorial you will use a land-surface model, SUEWS to simulate energy exchanges in a city (London is the test case).
|SUEWS (Surface Urban Energy and Water Balance Scheme) allows the energy and water balance exchanges for urban areas to be modelled (Järvi et al. 2011, 2014, Ward et al. 2016a). The model is applicable at the neighbourhood scale (e.g. 102 to 104 m). The fluxes calculated are applicable to height of about 2-3 times the mean height of the roughness elements; i.e. above the roughness sublayer (RSL). The use of SUEWS within Urban Multi-scale Environmental Predictor (UMEP) provides an introduction to the model and the processes simulated, the parameters used and the impact on the resulting fluxes.
Tools such as this, once appropriately assessed for an area, can be used for a broad range of applications. For example, for climate services (e.g. http://www.wmo.int/gfcs/). Running a model can allow analyses, assessments, and long-term projections and scenarios. Most applications require not only meteorological data but also information about the activities that occur in the area of interest (e.g. agriculture, population, road and infrastructure, and socio-economic variables).
Model output may be needed in many formats depending on a users’ needs. Thus, the format must be useful, while ensuring the science included within the model is appropriate. Figure 1 provides an overview of UMEP, a city based climate service tool (CBCST). Within UMEP there are a number of models which can predict and diagnose a range of meteorological processes. In this activity we are concerned with SUEWS, initially the central components of the model. See manual or published papers for more detailed information of the model.
SUEWS can be run in a number of different ways:
- Within UMEP via the Simple selection. This is useful for becoming familiar with the model (Part 1)
- Within UMEP via the Advanced selection. This can be used to exploit the full capabilities of the model (Part 2)
- SUEWS standalone (see manual)
- Within other larger scale models (e.g. WRF).
SUEWS Simple Objectives
- An introduction to the model and how it is designed.
- Different kinds of input data that are needed to run the model
- How to run the model
- How to examine the model output
As UMEP is under development, some documentation may be missing and/or there may be instability. Please report any issues or suggestions to our repository.
SUEWS Model Inputs
Details of the model inputs and outputs are provided in the SUEWS manual. As this tutorial is concerned with a simple application only the most critical parameters are shown. Other versions allow many other parameters to be modified to more appropriate values if applicable. The table below provides an overview of the parameters that can be modified in the Simple application of SUEWS.
|Building/ Tree Morphology|
|Mean height of Building/Trees (m)||Grimmond and Oke (1999), Fig 2|
|Frontal area index (m2/ m2)||Area of the front face of a roughness element exposed to the wind relative to the plan area.||Grimmond and Oke (1999), Fig 2|
|Plan area index (m2/ m2)||Area of the roughness elements relative to the total plan area.||Grimmond and Oke (1999), Fig 2. Should be the same value as the land cover fractions for buildings and sum for trees, respectively.|
|Land cover fraction||Should sum to 1|
|Paved||Roads, sidewalks, parking lots, impervious surfaces that are not buildings|
|Buildings||Buildings||Same as the plan area index of buildings in the morphology section.|
|Evergreen trees||Trees/shrubs that retain their leaves/needles all year round||Tree plan area index will be the sum of evergreen and deciduous area. Note: this is the same as the plan area index of vegetation in the morphology section.|
|Deciduous trees||Trees/shrubs that lose their leaves||Same as above|
|Bare soil||Bare soil – non vegetated but water can infilitrate|
|Water||River, ponds, swimming pools, fountains|
|Initial conditions||What is the state of the conditions when the model run begins?|
|Days since rain (days)||This will influence irrigation behaviour in the model. If there has been rain recently then it will be longer before irrigiation occurs.||If this is a period or location when no irrigation is permitted/occurring then this is not critical as the model will calculate from this point going forward.|
|Daily mean temperature (°C)||Influences irrigation and anthropogenic heat flux|
|Soil mositure status (%)||This will influence both evaporation and runoff processes||If close to 100 % then there is plenty of water for evaporation but also a higher probability of flooding if intense precipitation occurs.|
|Year||What days are weekdays/weekends|
|Latitude (°)||Solar related calculations|
|Longitude (°)||Solar related calculations|
|UTC (h)||Time zone||Influences solar related calculations|
How to Run SuewsSimple from the UMEP-plugin
- Open SuewsSimple from UMEP -> Processor -> Urban Energy Balance -> Urban Energy Balance, SUEWS (Simple). The GUI that opens looks quite extensive but it is actually not that complicated to start a basic model run (Figure 2). Some additional information about the plugin is found in the left window. As you can read, a test dataset from observations for London, UK (Kotthaus and Grimmond 2014, Ward et al. 2016a) is included in within the plugin.
- To make use of this dataset click on Add settings from test dataset (see near bottom of the box). The land cover fractions and all other settings originate from Kotthaus and Grimmond (2014). They used a source area model to obtain the different input parameters (their Fig. 7 in Kotthaus and Grimmond, 2014).
- Before you start the model, change the location of the output data to any location of your choice. Also, make notes on the settings such as Year etc.
- Do a model run and explore the results by clicking Run. A command window appears, when SUEWS performs the calculations using the settings from the interface. Once the calculations are done, some of the results are shown in two summary plots.
The graphs in Figure 3a are the monthly mean energy (left) and water balance (right). The lower graphs (Figure 3b) show the radiation fluxes, energy fluxes, and water related outputs throughout the year. This plot includes a lot of data and it might be difficult to examine it in detail.
To zoom into the plot: use the tools in the top left corner, to zoom to a period of interest. For example, the Zoom in to about the last ten days in March (Figure 4). This was a period with clear relatively weather.
Saving a Figure
Use the disk tool in the upper left corner.
- .tif (Recommended)
Output data Files
In the output folder (you selected earlier) you will find (at least) three files:
- Kc98_2012_60.txt – provides the 60 min model results for site “KC1” for the year 2012
- Kc_FilesChoices.txt – this indicates all options used in the model run see the SUEWS Manual for interpretation of content (this is for when you are doing large number of runs so you know exactly what options were used in each run)
- Kc98_DailyState.txt – this provides the daily mean state (see SUEWS manual for detailed explanation). This allows you to see, for example, the daily state of the LAI (leaf area index).
- Kc_OutputFormat.txt – provides detailed information about the output files such as extended descriptions for each column including units.
If you open these files in a text editor. To understand the header variables read the SUEWS manual.
Sensitivity to land surface fractions
The previous results are for a densely build-up area in London, UK. In order to test the sensitivity of SUEWS to some surface properties you can think about changing some of the surface properties in the SUEWS Simple. For example, change the land cover fraction by:
- Change the land cover fractions as seen in the figure. Feel free to select other values as long as all the fractions add up to 1.0.
- Save the output to a different folder by selecting output folder.
- Click Run.
- 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
Authors this document: Lindberg and Grimmond (2016)
Definitions and Notation
To help you find further information about the acronyms they are classified by T: Type of term: C: computer term, S: science term, G: GIS term.
|DEM||Digital elevation model||G|
|DSM||Digital surface model||G|
|FAI (λF)||Frontal area index||S||Grimmond and Oke (1999), their figure 2|
|GUI||Graphical User Interface||C|
|LAI||Leaf Area Index||S|
|PAI (λP)||Plan area index||S|
|png||Portable Network Graphics||C||format for saving plots/figures|
|SUEWS||Surface Urban Energy and Water Balance Scheme||S|
|Tif||Tagged Image File Format||C||format for saving plots/figures|
|UMEP||Urban Multi-scale Environmental predictor||C|
|z0||Roughness length for momentum||S||Grimmond and Oke (1999)|
|zd||Zero plane displacement length for momentum||S||Grimmond and Oke (1999)|
Morphometric Methods to determine Roughness parameters:
For more and overview and details see Grimmond and Oke (1999) and Kent et al. (2017a). This uses the height and spacing of roughness elements (e.g. buildings, trees) to model the roughness parameters. For more details see Kent et al. (2017a), Kent et al. (2017b) and [Kent et al. (2017c)]. UMEP has tools for doing this: Pre-processor -> Urban Morphology
Source Area Model
For more details see Kotthaus and Grimmond (2014b) and Kent et al. (2017a). The Kormann and Meixner (2001) model is used to determine the probable area that a turbulent flux measurement was impacted by. This is a function of wind direction, stability, turbulence characteristics (friction velocity, variance of the lateral wind velocity) and roughness parameters.