SUEWS: Surface Urban Energy and Water Balance Scheme¶
What is SUEWS?¶
Surface Urban Energy and Water Balance Scheme (SUEWS) (Järvi et al., 2011, Ward et al., 2016) is a neighbourhood/local-scale urban land surface model to simulate the urban radiation, energy and water balances using only commonly measured meteorological variables and information about the surface cover. SUEWS utilises an evaporation-interception approach (Grimmond and Oke, 1991), similar to that used in forests, to model evaporation from urban surfaces.
The model uses seven surface types: paved, buildings, evergreen trees/shrubs, deciduous trees/shrubs, grass, bare soil and water. The surface state for each surface type at each time step is calculated from the running water balance of the canopy where the evaporation is calculated from the Penman-Monteith equation. The soil moisture below each surface type (excluding water) is taken into account. Horizontal movement of water above and below ground level is allowed.
How to get SUEWS?¶
Please visit the SUEWS download page.
The development build can be highly unstable and is not recommended for production use. However, it is automatically constructed every week for testing purposes and we are happy to receive feedback on the development build.
Download the development build of SUEWS from the GitHub Release page.
How to use SUEWS?¶
For existing users:
Overview of changes in this version, see Version 2020a (released on 14 May 2020). If these changes impact your existing simulations, please see appropriate parts of the manual. It may be necessary to adapt some of your input files for for the current version.
A helper python script, SUEWS table converter, is provided to help facilitate the conversion of input files between different SUEWS versions.
Additionally, the manuals for previous versions can be accessed in respective sections under Version History.
For new users:
Note there are tutorials learning about running SUEWS available the tutorial.
How to get help in using SUEWS?¶
Please let us know in the UMEP Community. The developers and other users are willing to help you :)
How has SUEWS been used?¶
The scientific details and application examples of SUEWS can be found in SUEWS-related Publications.
How to cite SUEWS?¶
Please go to our Zenodo repository for a proper citation of SUEWS.
Visit the repositories below for different citation styles.