cropengine 1.0.2

cropengine is a Python package that streamlines running process-based crop models by automating data preparation, simulation workflows, and result analysis.

Welcome to cropengine

A Python package for streamlining process-based crop modeling and simulation

• GitHub repo: https://github.com/geonextgis/cropengine
• Documentation: https://geonextgis.github.io/cropengine
• PyPI: https://pypi.org/project/cropengine
• Notebooks: https://github.com/geonextgis/cropengine/tree/main/docs/examples
• License: MIT

---

Introduction

cropengine is a Python package designed to bridge the gap between geospatial data and process-based crop modeling. It streamlines the complex workflows involved in preparing input data, configuring simulation parameters, and executing crop models for yield prediction and agricultural research.

While traditional crop modeling often requires extensive manual data preparation and file manipulation, cropengine automates these tasks. It is built to integrate seamlessly with geospatial workflows (such as those using geeagri), allowing users to easily drive simulations with site-specific weather, soil, and management data.

cropengine is ideal for:

• Agronomists and researchers running point-based or spatial crop simulations.
• Data scientists integrating biophysical models with machine learning pipelines.
• Developers building agricultural decision support systems.

For a complete list of examples and use cases, visit the notebooks section.

---

Key Features

• Automated Data Preparation — Streamline the formatting of weather, soil, and management data into model-ready structures.
• Simulation Management — Easily configure and run process-based crop simulations with a Pythonic API.
• Geospatial Integration — Connect directly with satellite and climate data sources to drive simulations for specific locations (lat/lon) or regions.
• Scalable Workflows — specialized tools for running batch simulations across multiple sites or growing seasons efficiently.
• Result Analysis — Built-in utilities to parse simulation outputs, calculate yield gaps, and visualize crop growth dynamics over time.
• Model Agnostic Design — Designed to support various crop modeling engines and frameworks through a unified interface.

---

Installation

conda create -n cropengine python=3.10
conda activate cropengine
pip install cropengine
# (Optional) Upgrade to the latest version if already installed
pip install --upgrade cropengine

Models

Model ID	Model Name	Description	Production Level	Water Balance	Nutrient Balance
Wofost72_Phenology	WOFOST 7.2 (Phenology Only)	Simulates only the phenological development stages of the crop, ignoring biomass growth.	Phenology	N/A	N/A
Wofost72_PP	WOFOST 7.2 (Potential Production)	Simulates crop growth under potential production conditions (no water or nutrient stress).	Potential	N/A	N/A
Wofost72_WLP_CWB	WOFOST 7.2 (Water-Limited)	Simulates crop growth limited by water availability using the Classic Water Balance (free drainage).	Water-limited	Classic	N/A
Wofost73_PP	WOFOST 7.3 (Potential Production)	Includes atmospheric CO₂ response and biomass reallocation under potential conditions.	Potential	N/A	N/A
Wofost73_WLP_CWB	WOFOST 7.3 (Water-Limited, Classic)	Includes CO₂ response and biomass reallocation under water-limited conditions using the Classic Water Balance.	Water-limited	Classic	N/A