geoaquacrop_simulate

geoaquacrop_simulate runs AquaCrop-OSPy over large regions in gridded format. It takes the harmonised input datasets produced by geoaquacrop_preprocess, runs an independent AquaCrop simulation for every grid cell in parallel, and writes per-cell seasonal and daily results.

It is the middle stage of the GeoAquaCrop toolchain:

geoaquacrop_preprocess  ->  geoaquacrop_simulate  ->  geoaquacrop_visualize
(download & harmonise)   (simulate & correct)        (explore results)

What it does

Stage	Description
Input validation	Checks that climate, soil, crop calendar and crop area files exist, share a grid, and cover the requested period; derives the list of simulated cells from the crop area mask.
Per-cell simulation	Builds an AquaCrop Soil, Crop and weather series for each cell, adjusts crop phenology to the local growing season, and runs the model to termination across all seasons.
Parallel execution	Distributes cells over worker processes with a progress bar; failures are logged per cell without stopping the run.
Derived outputs	Adds seasonal water-balance metrics (water productivity, rainfall use efficiency, production, season length) via a pluggable enricher registry.
Yield correction	Optionally bias-corrects or calibrates modelled yields against an observational reference, per year, at the reference’s native support.

Outputs are pickled pandas frames (one seasonal summary row per cell per season, plus daily water-balance and crop-growth series), ready for geoaquacrop_visualize.

Getting started

• Installation
• Option A — the Python API (recommended)
• Option B — edit and run the script
• Required input files
• Output files
• Supported crop types

User guide

• Configuration reference
• Outputs
• Yield correction

API reference

• API reference

Indices and tables

• Index

• Module Index

• Search Page