Skip to content

Commit 06f94d8

Browse files
committed
Add Ag Forecasting application with open Lambda
1 parent ee852d8 commit 06f94d8

1 file changed

Lines changed: 1 addition & 121 deletions

File tree

applications/ag-forecasting-api.md

Lines changed: 1 addition & 121 deletions
Original file line numberDiff line numberDiff line change
@@ -6,128 +6,8 @@ FastAPI-based ASGI service for crop disease risk forecasting using multi-source
66

77
## Overview
88

9-
The API provides geospatial agricultural intelligence for Wisconsin, combining weather data with validated agronomic models.
9+
The API provides geospatial agricultural intelligence for Wisconsin, combining weather data with validated crop disease forecasting models.
1010

11-
### Key Features
12-
- 🌽 Crop disease risk forecasting (corn & soybean)
13-
- 🌱 Winter rye biomass estimation
14-
- 🌦 Multi-source weather integration (IBM EIS, WiscoNet)
15-
- 📍 Coordinate and station-based queries
16-
- 🗺 GeoJSON outputs for GIS applications
17-
- ⚡ Async batch processing for multi-station analysis
18-
19-
---
20-
21-
## System Architecture
22-
23-
The system is structured into four main layers:
24-
25-
- **API Layer (FastAPI)**
26-
Handles incoming requests and routing (`/ibm`, `/wisconet_g`, `/models`)
27-
28-
- **Data Layer**
29-
- IBM EIS: high-resolution global weather API
30-
- WiscoNet: Wisconsin mesonet station network
31-
32-
- **Processing Layer**
33-
Weather normalization, unit conversion, GDD calculation, rolling features
34-
35-
- **Model Layer**
36-
Disease risk models and winter rye biomass model
37-
38-
---
39-
40-
## Core Modules
41-
42-
- Weather ingestion (IBM + WiscoNet)
43-
- Disease risk modeling
44-
- Winter rye biomass estimation
45-
- Async pipeline orchestration
46-
- GeoJSON response formatting
47-
48-
---
49-
50-
## API Endpoints
51-
52-
### IBM Forecasting (Coordinates)
53-
`GET /v2/ag_models_wrappers/ibm`
54-
55-
Returns disease risk + biomass using IBM weather data.
56-
57-
---
58-
59-
### WiscoNet Forecasting (Stations)
60-
`GET /v2/ag_models_wrappers/wisconet_g`
61-
62-
Returns station-based time-series disease risk and biomass.
63-
64-
---
65-
66-
### Model Metadata
67-
`GET /v2/ag_models_wrappers/models`
68-
69-
Returns available disease and biomass models.
70-
71-
---
72-
73-
## Disease Models
74-
75-
- **Tarspot (corn)** – humidity and temperature-based risk
76-
- **Gray Leaf Spot (corn)** – temperature + dew point model
77-
- **Frogeye Leaf Spot (soybean)** – GDD + rainfall model
78-
- **White Mold (soybean)** – precipitation and soil moisture model
79-
80-
---
81-
82-
## Winter Rye Biomass Model
83-
84-
Predicts dry biomass (lb/acre) using:
85-
86-
- Growing Degree Days (0°C base)
87-
- Planting date (day-of-year)
88-
- Fall precipitation
89-
- Logistic growth curve
90-
91-
### Outputs
92-
- Biomass (lb/acre)
93-
- Color class (gray / yellow / green)
94-
- Interpretation message
95-
96-
---
97-
98-
## Data Sources
99-
100-
### IBM Environmental Intelligence Suite (EIS)
101-
- High-resolution global weather data
102-
- Hourly forecasts and historical data
103-
- Requires authentication
104-
105-
### WiscoNet
106-
- Wisconsin mesonet (~100 stations)
107-
- Daily weather observations
108-
- Public API access
109-
110-
---
111-
112-
## Response Format
113-
114-
All outputs are returned as **GeoJSON FeatureCollections**, including:
115-
116-
- Weather variables
117-
- Disease risk scores
118-
- Biomass predictions
119-
- Station metadata
120-
121-
---
122-
123-
## Performance Features
124-
125-
- Async multi-station processing
126-
- Cached weather and station data (6h–7d TTL)
127-
- Parallel risk computation
128-
- Optimized data aggregation pipeline
129-
130-
---
13111

13212
## Setup
13313

0 commit comments

Comments
 (0)