Note
Please report issues with the manual on the GitHub page.
8. SUEWS-related Software¶
8.1. SuPy¶
SuPy is a Python-enhanced urban climate model with SUEWS as its computation core.
The scientific rigour in SuPy results is thus gurranteed by SUEWS (see SUEWS publications and Parameterisations and sub-models within SUEWS).
Meanwhile, the data analysis ability of SuPy is greatly enhanced by the Python-based SciPy Stack, notably numpy and pandas.
How to get SuPy?
SuPy is available on all major platforms (macOS, Windows, Linux) for Python 3.5+ via PyPI:
python3 -m pip install supy --upgrade
How to use SuPy?
- Please follow Quickstart of SuPy and other tutorials.
- Please see SuPy API for usage details of SuPy functions.
8.2. SUEWS and UMEP¶
SUEWS can be run as a standalone model but also can be used within UMEP. There are numerous tools included within UMEP to help a user get started. The SUEWS (Simple) within UMEP is a fast way to start using SUEWS.
The version of SUEWS within UMEP is the complete model. Thus all options that are listed in this manual are available to the user. In the UMEP SUEWS (Simple) runs all options are set to values to allow intial exploration of the model behaviour.
- Pre-Processor
- Meteorological Data
- Prepare Existing Data
- Transforms meteorological data into UMEP format
- Download data (WATCH)
- Prepare meteorological dataset from
WATCH
- Spatial Data
- Spatial Data Downloader
- Plugin for retrieving geodata from online services suitable for various UMEP related tools - LCZ Converter Conversion from Local Climate Zones (LCZs) in the WUDAPT database into SUEWS input data
- Urban land cover
- Land Cover Reclassifier
- Reclassifies a grid into UMEP format land cover grid. Land surface models
- Land Cover Fraction (Point)
- Land cover fractions estimates from a land cover grid based on a specific point in space
- Land Cover Fraction (Grid)
- Land cover fractions estimates from a land cover grid based on a polygon grid
- Urban Morphology
- Morphometric Calculator (Point)
- Morphometric parameters from a DSM based on a specific point in space
- Morphometric Calculator (Grid)
- Morphometric parameters estimated from a DSM based on a polygon grid
- Source Area Model (Point)
- Source area calculated from a DSM based on a specific point in space.
- SUEWS input data
- SUEWS Prepare
- Preprocessing and preparing input data for the SUEWS model
- Processor
- Urban Energy Balance
- SUEWS (Simple)
- Urban Energy and Water Balance.
- SUEWS (Advanced)
- Urban Energy and Water Balance.
- Post-Processor
- Urban Energy Balance
- SUEWS analyser
- Plugin for plotting and statistical analysis of model results from SUEWS simple and SUEWS advanced
- Benchmark
- Benchmark System
- For statistical analysis of model results, such as SUEWS
8.3. Differences between SUEWS, LUMPS and FRAISE¶
The largest difference between LUMPS and SUEWS is that the latter simulates the urban water balance in detail while LUMPS takes a simpler approach for the sensible and latent heat fluxes and the water balance (“water bucket”). The calculation of evaporation/latent heat in SUEWS is more biophysically based. Due to its simplicity, LUMPS requires less parameters in order to run. SUEWS gives turbulent heat fluxes calculated with both models as an output.
Similarities and differences between LUMPS and SUEWS.
LUMPS | SUEWS | |
---|---|---|
Net all-wave radiation (Q*) | Input or NARP | Input or NARP |
Storage heat flux (ΔQS) | Input or from OHM | Input or from OHM |
Anthropogenic heat flux (QF) | Input or calculated | Input or calculated |
Latent heat (QE) | DeBruin and Holtslag (1982) | Penman-Monteith equation2 |
Sensible heat flux (QH) | DeBruin and Holtslag (1982) | Residual from available energy minus QE |
Water balance | No water balance included | Running water balance of canopy and water balance of soil |
Soil moisture | Not considered | Modelled |
Surface wetness | Simple water bucket model | Running water balance |
Irrigation | Only fraction of surface area that is irrigated | Input or calculated with a simple model |
Surface cover | Buildings, paved, vegetation | Buildings, paved, coniferous and deciduous trees/shrubs, irrigated and unirrigated grass |
8.4. FRAISE Flux Ratio – Active Index Surface Exchange¶
FRAISE provides an estimate of mean midday (±3 h around solar noon) energy partitioning from information on the surface characteristics and estimates of the mean midday incoming radiative energy and anthropogenic heat release. Please refer to Loridan and Grimmond (2012) [LG2012] for further details.
Topic | FRAISE | LUMPS | SUEWS |
---|---|---|---|
Complexity | Simplest: FRAISE | More complex: SUEWS | |
Software provided: | R code | Windows exe (written in Fortran) | Windows exe (written in Fortran) - other versions available |
Applicable period: | Midday (within 3 h of solar noon) | hourly | 5 min-hourly-annu al |
Unique features: | Calculates active surface
|
Radiation and energy balances | Radiation, energy and water balance (includes LUMPS) |