Hello and welcome to the SUEWS community!
This is a friendly place for anyone working with SUEWS (Surface Urban Energy and Water balance Scheme) — whether you’re asking questions, sharing workflows, reporting issues, or discussing model physics.
New to SUEWS?
Start here:
- Running SUEWS with Python (Beginner’s Guide) — Run your first simulation in 15 minutes. No prior Python experience needed.
- Setting Up Python with uv — Best practice for managing Python environments.
Browse all tutorials in the Getting Started category.
Why Join This Community?
Create an account to:
- Get notified about new SUEWS releases and updates
- Receive answers to your questions via email
- Connect with other researchers using SUEWS worldwide
Stay Updated
All registered users automatically receive notifications for posts in the Announcements category — including new releases and important updates.
Customise your email frequency:
Go to Profile → Preferences → Emails to choose what works for you:
- Activity summary: Receive a digest email (daily/weekly) with highlights — recommended for most users
- Watch categories: Get notified only for specific categories you care about
- Mailing list mode: Receive every post as an individual email (for those who prefer email-based workflow)
Documentation & Resources
- SUEWS Documentation — Full model documentation
- Getting Started — Workflow introduction
- Tutorials — Step-by-step guides
- Troubleshooting — Common issues
- UMEP for QGIS — GIS integration
Quick Install
pip install supy
For a complete walkthrough, see our Beginner’s Guide.
Getting Help
When posting questions, please include:
- SUEWS version
- Operating system
- What you tried and what happened
For Developers
Want to contribute code or report bugs? Join us on GitHub.