@@ -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