SHAW

Runs the SHAW v3.03 Fortran model to simulate coupled soil heat, water, freeze-thaw, and snow processes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Configuring and running the SHAW (Simultaneous Heat and Water) Fortran model correctly requires deep knowledge of its free-format input files, unit conventions, and freeze-thaw parameterization; this Skill packages that operational expertise so an agent can prepare inputs, execute the real binary, validate outputs, and recover from known failures without substituting approximations. ## Core Features & Use Cases - Seven-stage pipeline: site file generation from HWSD soil data, weather conversion from CMFD/MSWX/NASA POWER, plant canopy and snow/residue configuration, initial condition setup, execution, output parsing, and VIC coupling via 13 documented tools. - Diagnostic recovery: 33 symptom-diagnosis-remedy triplets covering known failure modes such as MTSTEP mismatches, solar radiation unit errors, and the BPAR=30 freeze-thaw trap. - Validated outputs: soil temperature profiles (headline variable), liquid/total water content, frost and snow depth, and energy balance, graded against cited NSE/RMSE conventions with benchmark results from Canadian boreal and prairie sites. - Use Case: Simulate one year of hourly soil temperature and frost depth at a boreal forest flux tower site, then validate the modeled profiles against observed soil temperature sensors at six depths. ## Quick Start Run python preflight_check.py in this KI directory to verify the SHAW binary, Python environment, and required data before starting any simulation.

Frequently Asked Questions about SHAW

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

FAQPage Schema
How do I run the SHAW model from the command line?

Run the compiled shaw303 binary from the directory containing your input files and pipe the .inp filename plus a final Enter via stdin: printf "Trial.303.inp\n\n" | shaw303. Judge success by non-empty output files, since SHAW may exit with a benign Fortran EOF backtrace.

What input files does the SHAW model require?

SHAW requires five files: a master .inp control file, a .sit site characteristics file, a .wea weather file, a .moi initial moisture profile, and a .tem initial temperature profile. Plant growth, residue change, and soil source/sink files are optional depending on flag settings.

What is the difference between SHAW hourly and daily weather formats?

Hourly mode (MTSTEP=0) uses 9 columns with instantaneous air temperature and relative humidity, while daily mode (MTSTEP=1) uses 8 columns with TMAX, TMIN, and dew-point temperature and no hour column. The MTSTEP flag must match the weather file column count or precipitation and dates will be misread.

Why does my SHAW simulation show no soil freezing?

A BPAR value around 30 in the .sit file keeps liquid water unrealistically high at subfreezing temperatures, disabling freeze-thaw. Apply texture-based pedotransfer corrections so BPAR falls in the physical range of roughly 2-12, and keep QUARTZ as a 0-1 fraction.

Can SHAW output be compared against soil moisture sensors in frozen soil?

Compare liquid-only sensors against SHAW's liquid water content output (liquid.out), not the total water content in moist.out, because sensors detect only unfrozen water during frozen periods. Confusing the two causes frozen-season moisture bias.

When should I use standalone SHAW instead of RZ-SHAW?

Use standalone SHAW v3.03 for detailed freeze-thaw studies, multi-layer snow research, up to 10 solute species, dynamic residue layers, and sub-surface lateral flow. RZ-SHAW embedded in RZWQM2 simplifies snow, fixes residue within a season, and offers only van Genuchten retention.