Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Recent Releases of SUEWS

SUEWS - SUEWS v2025.10.15: YAML Configuration System Release

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

Climate Change - Earth and Climate Modeling - Python
Published by sunt05 8 months ago

SUEWS - CITATION-added

This release adds a CITATION file for proper citation of this repo.
Functionality-wise, the SUEWS model stays the same as last supy release (v2024.3.25.dev).

Climate Change - Earth and Climate Modeling - Python
Published by sunt05 about 2 years ago

SUEWS - 2020a Release

Improvement

  • A ponding water scheme is added in the automatic irrigation calculation; useful when a certain depth of ponding water to maintain in irrigation (e.g., flooding irrigation in rice
    crop-field).
  • Irrigation fraction can be specified for all surfaces (previously only available for vegetated surfaces)
  • A U-shape approach for calculating HDD/CDD is introduced to account for a wide comfort zone between heating and cooling critical temperatures.

Changes

  • A new RoughLenHeatMethod option 5: adaptively choose option 1 for fully pervious surface or 2 otherwise (if any impervious surface exists).
  • A new column H_maintain is added in SUEWS_Irrigation.txt to set ponding water depth.
  • New columns to specify irrigation fractions for non-vegetated surfaces in SUEWS_SiteSelect.txt.
  • A new scheme option BaseTMethod in RunControl.nml to set calculation scheme for HDD/CDD.

Fix

NONE.

Known issues

Wind direction is not currently downscaled so non -999 values
will cause an error.

Climate Change - Earth and Climate Modeling - Python
Published by sunt05 over 4 years ago