cropforge 0.2.0__tar.gz

cropforge-0.2.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: cropforge
+Version: 0.2.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.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

cropforge-0.2.0/README.md

@@ -0,0 +1,18 @@
+# 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.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

cropforge-0.2.0/cropforge/__init__.py

@@ -0,0 +1,31 @@
+"""
+CropForge — Virtual Farm Runtime for Agricultural Researchers.
+
+Open-source, code-first simulation engine. Researchers write the model;
+CropForge faithfully executes it and visualises the result.
+
+Public API (PRD Section 6.1):
+    from cropforge import Farm, Field, Crop
+
+Maintainer : Saswat Sundar Rath, ICAR-IARI Jharkhand
+Licence    : MIT
+"""
+
+__version__ = "0.2.0"
+
+# Core public API — matches `from cropforge import Farm, Field, Crop, Weather, Soil, ...`
+from cropforge.crop import Crop
+from cropforge.farm import Farm, Field
+from cropforge.loaders import Soil, Weather
+from cropforge.runtime import CropForgeStepError, CropForgeVisualizeError
+
+__all__ = [
+    "Farm",
+    "Field",
+    "Crop",
+    "Weather",
+    "Soil",
+    "CropForgeStepError",
+    "CropForgeVisualizeError",
+    "__version__",
+]

cropforge-0.2.0/cropforge/crop.py

@@ -0,0 +1,77 @@
+"""
+cropforge/crop.py
+=================
+Crop metadata class.
+
+The ``Crop`` object carries species identity, variety, and sowing calendar.
+It is **not** a model — it holds no physiological equations. The researcher's
+``@farm.step`` functions are the model.  ``Crop`` is attached to a ``Field``
+via ``Field.set_crop()`` and made available to step functions through the
+field's state so they can make phenology decisions (e.g. days since sowing).
+
+PRD Reference: Section 6.1 — Basic Usage Example.
+
+Author : Saswat Sundar Rath, ICAR-IARI Jharkhand
+Licence: MIT
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any, Dict
+
+
+@dataclass
+class Crop:
+    """Metadata describing a crop planted in a field.
+
+    Parameters
+    ----------
+    species:
+        Common species name, e.g. ``"wheat"``, ``"maize"``, ``"chickpea"``.
+        CropForge imposes no controlled vocabulary — the string is passed
+        through to the state log and is entirely researcher-defined.
+    variety:
+        Cultivar or variety identifier, e.g. ``"HD-2967"``, ``"custom"``.
+        Defaults to ``"generic"`` when the researcher does not distinguish
+        varieties.
+    sowing_doy:
+        Calendar day-of-year (1–366) on which sowing occurs.  The runtime
+        engine uses this to determine when to set ``PlantState.age_days = 0``
+        for each plant in the field.  Plants are placed in the field on the
+        first simulation day whose ``EnvironmentState.doy`` matches or
+        exceeds ``sowing_doy``.
+    custom:
+        Arbitrary researcher-defined crop metadata (e.g. base temperature,
+        photoperiod sensitivity).  Not used by the engine directly; accessible
+        inside step functions via ``field.crop.custom``.
+
+    Examples
+    --------
+    >>> crop = Crop(species="wheat", variety="HD-2967", sowing_doy=290)
+    >>> crop.species
+    'wheat'
+    >>> crop.sowing_doy
+    290
+    """
+
+    species: str
+    variety: str = "generic"
+    sowing_doy: int = 1
+
+    # Extensibility hook — keeps the same pattern as SimulationState objects
+    custom: Dict[str, Any] = field(default_factory=dict)
+
+    def __post_init__(self) -> None:
+        if not isinstance(self.species, str) or not self.species.strip():
+            raise ValueError("Crop.species must be a non-empty string.")
+        if not (1 <= self.sowing_doy <= 366):
+            raise ValueError(
+                f"Crop.sowing_doy must be between 1 and 366, got {self.sowing_doy}."
+            )
+
+    def __repr__(self) -> str:
+        return (
+            f"Crop(species={self.species!r}, variety={self.variety!r}, "
+            f"sowing_doy={self.sowing_doy})"
+        )

cropforge-0.2.0/cropforge/environment.py

@@ -0,0 +1,3 @@
+# cropforge/environment.py
+# Environment resolver — Phase 1 implementation target.
+# Stub created in Phase 0 to satisfy package import structure.