SUEWS: Surface Urban Energy and Water Balance Scheme

Documentation Status


Please report issues with the manual on the GitHub page.

  • How to get SUEWS?
The software can be downloaded via our GitHub page. The latest formal release of SUEWS is Version 2018a (released 2 August 2018).
  • How to use SUEWS?

    • For existing users:

    Overview of changes in this version, see Version 2018a (released 2 August 2018). If these changes impacts 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:

    Before starting to perform SUEWS simulations, it is suggested new users first get an overview from Introduction, then follow the steps in Preparing to run the model to prepare input files for SUEWS.

    Note theres is also a tutorial for running SUEWS via the tutorial.

  • How has SUEWS been used?

The scientific details and application examples for SUEWS can be found in related papers under Recent publications.
  • How to cite SUEWS?

    Please cite this manual as follows:

    Sun T, L Järvi, M Havu, HC Ward, S Onomura, F Lindberg, F Olofson, A Gabey, CSB Grimmond (2018). SUEWS Manual V2018a. Department of Meteorology, University of Reading, Reading, UK

  • How to support SUEWS?

    1. Cite SUEWS appropriately in your work.
    2. Contribute to the development.
    3. Report issues via the GitHub page.
    4. Provide suggestions and feedback.