1. Need help? Please let us know in the UMEP Community.

  2. Please report issues with the manual on the GitHub Issues.

  3. Please cite SUEWS with proper information from our Zenodo 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 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 Recent publications.