Please report issues with the manual on the GitHub page.

SUEWS: Surface Urban Energy and Water Balance Scheme

Documentation Status
  • How to get SUEWS?

  • 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:

    Before performing SUEWS simulations, new users should read the overview Introduction, then follow the steps in Preparing to run the model to prepare input files for SUEWS.

    Note there are tutorials learning about running SUEWS available the tutorial.

  • How has SUEWS been used?

The scientific details and application examples of SUEWS can be found in Recent publications.

  • How to cite SUEWS?


    Visit the repositories below for different citation styles.

    • Software with manual:

      Ting Sun, Leena Järvi, Hamidreza Omidvar, Natalie Theeuwes, Fredrik Lindberg, Zhenkun Li, & Sue Grimmond. (2019, November 8). Urban-Meteorology-Reading/SUEWS: 2019a Release (Version 2019a). Zenodo. doi_software

  • 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.