summa-knowledge-infrastructure

Runs, configures, and diagnoses SUMMA multi-physics hydrologic simulations via a staged tool pipeline.

155|6|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill summa-knowledge-infrastructure-lzwei196
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: summa-knowledge-infrastructure
Source: https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation/tree/main/models/SUMMA
Command: npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill summa-knowledge-infrastructure-lzwei196

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires netCDF4, numpy, and includes scripts (resource) and references (resource) components.

What problem does it solve? Operating the SUMMA hydrologic model requires deep operational expertise: preparing GRU/HRU domains, converting forcing units correctly, choosing among 35 physics decision categories, generating consistent NetCDF inputs, and recovering from silent failures like unit mismatches or vegetation-table mis-mappings. This Skill packages that expertise so an AI agent can run the real SUMMA Fortran binary end-to-end without substituting approximations. ## Core Features & Use Cases - Full 7-stage pipeline: domain setup (GRU/HRU from shapefile + DEM), VIC or reanalysis forcing conversion, decision configuration with validation, ROSETTA-based soil parameters, cold-start initial conditions, execution with fileManager validation, and automated multi-physics comparison with plots. - Diagnostic recovery: 18+ documented diagnostic triplets map symptoms (e.g., zero runoff, ET bias, CRS mismatch, Fortran path truncation) to diagnoses and validated remedies. - Calibration support: a commissioned calibration.yaml defines parameter ranges, constraints, and a runner for NSE-based calibration against gauged discharge. - Use Case: Compare snow-physics options on a mountain basin by running full-factorial decision variants and scoring simulated discharge against a HYDAT gauge. ## Quick Start Ask the agent to run the preflight check and then execute the SUMMA pipeline for your basin shapefile, DEM, and forcing data using the default decision set.

Frequently Asked Questions about summa-knowledge-infrastructure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run the SUMMA hydrologic model on a new basin?

Follow the 7-stage pipeline: create GRU/HRU structure from a shapefile and DEM, convert forcing to SUMMA NetCDF, configure decisions, set trial parameters, create cold-start initial conditions, then validate the fileManager and run summa.exe. Always run the preflight check first.

How do I compare different physics options in SUMMA?

Use the compare_physics.py tool with a decision variation dictionary; it generates full-factorial decision combinations, runs SUMMA for each variant, and outputs statistics and plots. Documented experiments cover snow physics, stomatal resistance, runoff generation, and radiation transfer.

Can SUMMA use forcing data other than VIC output?

Yes. Besides the VIC forcing converter, the build_summa_forcing_from_reanalysis.py tool builds multi-HRU SUMMA forcing directly from CMFD, MSWX, or NASA POWER reanalysis, with sub-daily timestepping and lapse-rate correction.

Why does SUMMA produce zero runoff or unrealistic ET?

Common causes are inconsistent initial matric head versus soil moisture, presTemp boundary mode producing zero ET, or vegetation class mis-mapping between USGS and MODIS tables. Check diagnostics/triplets.yaml, which maps these silent-error symptoms to validated remedies.

Does SUMMA route runoff to stream gauges for discharge validation?

No, SUMMA has no internal channel routing; averageRoutedRunoff is only a sub-grid gamma time-delay histogram. For gauged discharge you must run the Stage 8 mizuRoute tools, and never score averageRoutedRunoff times basin area directly against a gauge.