Metadata-Version: 2.4
Name: cropforge
Version: 0.4.0
Summary: Open-source, code-first virtual farm runtime for agricultural researchers.
Author-email: Saswat Sundar Rath <saswat@example.com>
Maintainer-email: Saswat Sundar Rath <saswat@example.com>
License: MIT
Project-URL: Homepage, https://github.com/saswat/cropforge
Project-URL: Documentation, https://cropforge.readthedocs.io
Project-URL: Repository, https://github.com/saswat/cropforge.git
Project-URL: Bug Tracker, https://github.com/saswat/cropforge/issues
Project-URL: Changelog, https://github.com/saswat/cropforge/blob/main/CHANGELOG.md
Keywords: crop simulation,agriculture,farm runtime,agronomy,plant science,virtual farm,DSSAT,APSIM
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: pandas>=2.2
Requires-Dist: numpy>=1.26
Requires-Dist: pyarrow>=15.0
Requires-Dist: fastapi>=0.111
Requires-Dist: uvicorn[standard]>=0.29
Requires-Dist: plotly>=5.22
Requires-Dist: dash>=2.17
Provides-Extra: dev
Requires-Dist: pytest>=8.2; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: dash[testing]>=2.17; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5; extra == "docs"
Requires-Dist: mkdocs-material>=9.5; extra == "docs"

# CropForge

> Open-source, code-first virtual farm runtime for agricultural researchers.

CropForge lets you define a crop simulation entirely in Python. You write the model equations; CropForge handles time-stepping, spatial state management, logging, and visual playback.

## What's New in v0.4.0
* **Plugin Ecosystem**: Extensible architecture allowing third-party researchers to publish and install custom crop models (e.g., `cropforge-wheat`) via PyPI.
* **Multi-Season Rotations**: Preserve soil state, moisture, and nitrogen between consecutive simulation runs on the same field to study long-term soil health and crop rotations.
* **Compare Dashboard**: Visually compare multiple farm configurations on the same time-series chart and export session data directly to CSV.
* **Spatial Hydrology**: D8 lateral surface water routing across gridded fields based on elevation.

## What's New in v0.2.0
* **Opt-In Physics**: Built-in, mathematically verified FAO-56 Penman-Monteith ET0 resolution and Root Impedance models. Enabled via the `@farm.use_physics(et0=True, root_impedance=True)` decorator.
* **Multi-Field Dashboard**: Compare divergent physical environments and scenarios (GxE) directly in the UI with a new Field Selector Dropdown, filtering Heatmaps, 3D viewport, and Inspector panels per-field, while retaining a unified Time-Series comparative view.

```bash
pip install cropforge
```

See `examples/wheat_basic.py` for a minimal working simulation.

## Licence
MIT — Saswat Sundar Rath, ICAR-IARI Jharkhand, 2026
