rzwqm2

Automates setup, execution, and diagnosis of RZWQM2 agricultural 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 rzwqm2-lzwei196
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rzwqm2
Source: https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation/tree/main/models/RZWQM2
Command: npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill rzwqm2-lzwei196

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Running the RZWQM2 process-based agricultural model requires deep operational expertise scattered across Fortran binaries, fixed-format input files, and unit conventions, where silent errors (wrong units, wrong paths) produce scientifically invalid results that look successful. ## Core Features & Use Cases - End-to-end staged pipeline: Twelve stages (S0-S10) covering global data acquisition (SoilGrids, HWSD, MSWX, CMFD), site configuration, meteorological file generation, soil property setup, scenario assembly, binary execution, and result parsing. - Diagnostic recovery: 29 symptom-diagnosis-remedy triplets in diagnostics/triplets.yaml map known failure modes (unit traps, path issues, case sensitivity) to validated fixes. - Batch and calibration support: Mass scenario generation from a CSV of sites and automated calibration via LHS/Sobol sampling with NSE/RMSE/PBIAS metrics. - Use Case: An agent simulates maize yield, nitrate leaching, and tile drainage for a site in Iowa by retrieving SoilGrids soil and MSWX weather, assembling a scenario from the validated template, running the Fortran binary, and parsing the .ana output. ## Quick Start Run python preflight_check.py in this directory, then ask the agent to set up and run an RZWQM2 maize simulation for your site coordinates and date range.

Frequently Asked Questions about rzwqm2

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

FAQPage Schema
How do I run an RZWQM2 simulation for a new site?

Copy the canonical template scenario, then run the staged tools: S1 writes site properties, S2-S3 generate met and breakpoint rainfall files, S4-S6 configure soil and initial conditions, S7 assembles the scenario, and S8 executes the binary from the scenario directory.

What data sources does RZWQM2 support for soil and weather inputs?

Soil adapters cover SoilGrids (global API), HWSD (China raster), gSSURGO (US), and VIC parameters. Forcing adapters support CMFD, MSWX, ERA5, NASA POWER, VIC forcing, and user CSV files with daily weather.

Can RZWQM2 run on Linux or Apple Silicon?

RZWQM2 runs on Linux x86-64 via the main_ryzen binary, which requires AVX2 CPU support and an ELF interpreter patch using patchelf. It does not run on ARM, including Apple Silicon via Rosetta.

Why does my RZWQM2 run complete but produce wrong results?

Silent errors are common: latitude must be in radians, breakpoint rainfall in inches, and E-pan/PAR columns in the .met file must be zero. Check diagnostics/triplets.yaml, which maps 29 known symptom patterns to root causes and fixes.

How do I calibrate RZWQM2 against observed yield or drainage data?

Use tools/s10_calibration/rzwqm2_calibrate.py, which runs LHS or Sobol sampling over six soil and drainage parameters in agent-guided batches. It computes NSE, RMSE, and PBIAS against observations via parse_rzwqm2_output.py.

What are the limitations of RZWQM2 for watershed modeling?

RZWQM2 is a 1-D column model with only pseudo 2-D tile drainage; it does not perform 3-D distributed flow, stream routing, or regional groundwater simulation. Watershed-scale work requires coupling with external routing models.