How abson-dev/aquacrop-grid works
AquaCrop-Grid runs one rainfed AquaCrop season per raster pixel, accepting daily climate and per-pixel sowing dates, with an optional soil raster. The principal workflow validates the zarr inputs, prepares crop and soil parameters, processes spatial tiles through a shared runner and CPU or GPU kernels, then writes final results and optional daily series to zarr. The CLI also generates synthetic input data and reports throughput. The graph follows the README and indexed references; unsampled code limits detail on tile internals and the benchmark implementation.
Main entry points: pipeline.py Tiled pipeline · cli.py CLI commands · synthetic.py Synthetic data · constants.py Kernel array layout
Components 19
User interface
- CLI commands
src/aquacrop_grid/cli.py - Throughput benchmark
src/aquacrop_grid/bench.py
Raster preparation
- Synthetic data
src/aquacrop_grid/io/synthetic.py - Input validation
src/aquacrop_grid/io/schema.py - Soil raster I/O
src/aquacrop_grid/io/soil.py - Tiled pipeline
src/aquacrop_grid/pipeline.py
Simulation engine
- Crop parameters
src/aquacrop_grid/params.py - Soil profile builder
src/aquacrop_grid/soil_grid.py - Array runner
src/aquacrop_grid/engine/run.py - CPU backend
src/aquacrop_grid/engine/cpu.py - GPU backend
src/aquacrop_grid/engine/gpu.py - Kernel compiler
src/aquacrop_grid/kernels/loader.py - Daily AquaCrop step
src/aquacrop_grid/kernels/impl.py - Kernel array layout
src/aquacrop_grid/kernels/constants.py
Results
- Results zarr
Other components
- CLI user
- Climate zarr
- Sowing zarr
- Soil zarr
Connections 26
- CLI user → CLI commands: invokes
README.md - CLI commands → Tiled pipeline: runs simulation
src/aquacrop_grid/cli.py - CLI commands → Synthetic data: generates inputs
src/aquacrop_grid/cli.py - CLI commands → Throughput benchmark: measures throughput
src/aquacrop_grid/cli.py - Synthetic data → Climate zarr: writes
src/aquacrop_grid/io/synthetic.py - Synthetic data → Sowing zarr: writes
src/aquacrop_grid/io/synthetic.py - Synthetic data → Soil zarr: writes
src/aquacrop_grid/io/synthetic.py - Climate zarr → Tiled pipeline: supplies weather
README.md - Sowing zarr → Tiled pipeline: supplies dates
README.md - Soil zarr → Tiled pipeline: supplies soil
README.md - Tiled pipeline → Input validation: opens inputs
src/aquacrop_grid/pipeline.py - Tiled pipeline → Soil raster I/O: opens soil
src/aquacrop_grid/pipeline.py - Tiled pipeline → Crop parameters: prepares parameters
src/aquacrop_grid/pipeline.py - Tiled pipeline → Soil profile builder: builds soil profiles
src/aquacrop_grid/pipeline.py - Tiled pipeline → Array runner: runs tile arrays
README.md - Tiled pipeline → Results zarr: writes results
README.md - Array runner → CPU backend: dispatches CPU
src/aquacrop_grid/engine/run.py - Array runner → GPU backend: dispatches GPU
src/aquacrop_grid/engine/run.py - CPU backend → Kernel compiler: loads kernels
src/aquacrop_grid/engine/cpu.py - GPU backend → Kernel compiler: loads kernels
src/aquacrop_grid/engine/gpu.py - Kernel compiler → Daily AquaCrop step: compiles source
src/aquacrop_grid/kernels/loader.py - Daily AquaCrop step → Kernel array layout: uses indices
src/aquacrop_grid/kernels/impl.py - CPU backend → Kernel array layout: uses output indices
src/aquacrop_grid/engine/cpu.py - GPU backend → Kernel array layout: uses output indices
src/aquacrop_grid/engine/gpu.py - Soil profile builder → Soil raster I/O: consumes soil grid
src/aquacrop_grid/soil_grid.py - Crop parameters → Kernel array layout: packs parameters
src/aquacrop_grid/params.py