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