The scientific rigour in SuPy results is thus gurranteed by SUEWS (see :ref:`SUEWS publications <Recent_publications>` and :ref:`Parameterisations and sub-models within SUEWS`).
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?
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.
- 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
- SUEWS input data
- SUEWS Prepare
- Preprocessing and preparing input data for the SUEWS model
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.
|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|
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.
|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|
Calculates active surface
|Radiation and energy balances||Radiation, energy and water balance (includes LUMPS)|