Skip to content

SUEWS v2025.10.15: YAML Configuration System Release

Choose a tag to compare

View all tags
@sunt05 sunt05 released this 16 Oct 08:23
· 695 commits to master since this release
2025.10.15
ea7c5d5

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
  • Schema Versioning: Independent schema versions (1.0, 1.1, etc.) separate from model versions for cleaner configuration evolution
  • 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
  • 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
  • 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

Changelog

15 Oct 2025

  • [feature] Enhanced UMEP/QGIS build system with nightly builds and improved version handling (cdb4273, 8f540b9, 636c1b9, 35510bb, 4a972c7)
    • Enabled UMEP nightly builds with .dev1 versioning strategy for continuous testing
    • Explicitly excluded nightly builds from UMEP workflow to prevent conflicts
    • Added UMEP builds to master/manual workflow runs
    • Aligned UMEP builds with QGIS Python 3.12 requirements
  • [bugfix] Fixed sample output validation test to skip for NumPy 1.x builds (a4017cc)
  • [bugfix] Removed path filter from tag triggers to ensure all tagged builds are processed (1eb6667)
  • [maintenance] Performance improvement in Conductor setup by removing unnecessary build steps (ddedf96)

Installation

Standard (NumPy 2.x):

pip install suews==2025.10.15

UMEP/QGIS Compatible (NumPy 1.x):

pip install suews==2025.10.15rc1

Documentation

Assets 2
Loading