MONICA

Runs the MONICA agro-ecosystem model to simulate daily crop growth, soil water, carbon, and nitrogen dynamics.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Running the MONICA process-based crop model correctly requires deep operational knowledge: converting climate and soil data into exact formats and units, configuring crop rotations, and diagnosing silent failures where the model runs but produces physically wrong results. This Skill packages that expertise so an AI agent can execute, validate, and debug MONICA simulations reliably. ## Core Features & Use Cases - End-to-end pipeline tools: Convert CMFD/MSWX/ERA5 climate forcing into MONICA climate.csv, transform HWSD/SoilGrids soil data into site.json profiles, execute the monica-run binary, and parse output CSVs into clean time series and metrics. - Diagnostic recovery: 32 documented symptom-to-remedy triplets (e.g., radiation unit traps inflating yield 10-100x, soil layer thickness in cm causing crashes) plus a preflight check that verifies the binary, parameters, and tools before any run. - Validation against literature: Ranked output variables (Yield is rank-1) with cited pass-bands for PBIAS, NMAE, and PMARE, plus a documented China winter-wheat multi-site workflow with photoperiod adaptation for non-European latitudes. - Use Case: Simulate winter wheat yield across Chinese provinces from 1991-2000 using CMFD forcing and HWSD soils, with automatic irrigation, then compare provincial PBIAS against published validation bands. ## Quick Start Run python preflight_check.py in this directory to verify the MONICA binary and parameters, then ask the agent to simulate winter wheat yield at your site by converting your climate and soil data with the provided tools.

Frequently Asked Questions about MONICA

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

FAQPage Schema
How do I run a MONICA crop simulation with my own climate data?

Convert your daily weather data to MONICA's semicolon-separated climate.csv using convert_climate_to_monica.py, ensuring globrad is in MJ m-2 d-1 and precip in mm. Then configure sim.json, site.json, and crop.json, set MONICA_PARAMETERS, and execute via run_monica.py.

How do I convert HWSD soil data for MONICA site.json?

Extract T_SAND, T_CLAY, T_OC, and T_BULK_DENSITY from HWSD_DATA.csv for your location's MU_GLOBAL, write a one-row CSV, and pass it to convert_soil_to_monica.py with --format hwsd. The tool handles unit conversions like bulk density from g/cm3 to kg/m3.

Why is my MONICA simulated yield 10 to 100 times too high?

This is the classic globrad unit trap: your radiation input is in J cm-2 or W m-2 instead of MJ m-2 d-1. Divide J cm-2 values by 100 or multiply W m-2 values by 0.0864 before writing climate.csv.

Does MONICA work for crop simulations outside Europe?

Yes, but stock cultivars are calibrated for ~52N daylength. For sites like China at 35N, run site_photoperiod.py adapt to adjust DaylengthRequirement to local maximum photoperiod, otherwise phenology shifts and harvest index collapses.

What does MONICA not simulate?

MONICA models a single 1-D soil column at daily resolution with prescribed weather and management. It does not simulate lateral water or solute transport, spatial grids, atmospheric feedback, or management as an autonomous decision process.