Tip

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

2. Please report issues with the manual on GitHub Issues (or use Report Issue for This Page for page-specific feedback).

3. Please cite SUEWS with proper information from our Zenodo page.

11.3. Version 2025.10.15 (released on 15 October 2025)

This release introduces a modern YAML-based configuration system with comprehensive validation, marking a significant infrastructure upgrade for SUEWS.

Major Features:

• YAML Configuration System: Modern, human-readable configuration format with 697 documented parameters. See the YAML configuration guide for migration from legacy table-based inputs.

• Schema Versioning: Independent schema versions (1.0, 1.1, etc.) separate from model versions for cleaner configuration evolution. Use suews-schema info to check your configuration version.

• Three-Phase Validation Framework:

  • Structure validation: YAML syntax and schema compliance

  • Physics validation: Scientific parameter constraints with CRU TS4.06 climatological data

  • Model validation: SPARTACUS multi-layer configurations, STEBBS constraints

  See validation documentation for details.

• JSON Schema Support: IDE integration enabling autocomplete and inline validation in VS Code, PyCharm, Vim and other editors.

• CLI Tools:

  • suews-schema: Schema management (info, validate, migrate, export)

  • suews-convert: Legacy table-to-YAML conversion

  • suews-validate: Configuration validation

  Run with --help for usage information.

• Build System Improvements: Automatic UMEP/QGIS compatible builds (rc1 variants) with NumPy 1.x for QGIS 3.40 LTR compatibility.

• Cross-Platform Enhancements: Python 3.13 support, Linux manylinux2014 compatibility, Windows Unicode fixes.