diff --git a/input_data.md b/input_data.md index df1e76042eed91e9562a956e330bbbf36b3024e8..81af664001c2370d32c62922d07dd244e61ee036 100644 --- a/input_data.md +++ b/input_data.md @@ -30,7 +30,68 @@ Below is a minimum example of VIPS result data. This is the 10-character unique id for the specific model ## configParameters -Here are the input data, which are free-form, but by convention weather data are to be found in the `observations` property, and they must follow the [VIPS weather data format](./weather_data.md). Here, we also have a `sowingDate` that this specific model requires. +Here are the input data, which are free-form. The first one is the `sowingDate` that this specific model requires. + +### Weather data +By convention weather data are to be found in the `observations` property, and they must follow the [VIPS weather data format](./weather_data.md). With observations, we actually mean **all weather data that the model uses; past, present and future**. A typical model expects all weather data to be in one continuous list of observations combining measured data and forecasts. + + +### PestObservation: Observations/registrations of pests and diseases in the field +The weather observations follow a standard pattern, and so do the field observations: + +```json +{ + "pestObservations": [{ + "timeOfObservation": 1461103200000, + "observationData": "{\"trapCountCropEdge\":3,\"trapCountCropInside\":0}", + "name": "Lorem Ipsum", + "geoinfo": { + "type": "FeatureCollection", + "features": [ + { + "type": "Feature", + "properties": {}, + "geometry": { + "coordinates": [ + 10.44766117815368, + 59.22486514003208 + ], + "type": "Point" + } + } + ] + } + }, { + "timeOfObservation": 1461448800000, + "observationData": "{\"trapCountCropEdge\":1,\"trapCountCropInside\":5}", + "name": "Lorem Ipsum", + "geoinfo": { + "type": "FeatureCollection", + "features": [ + { + "type": "Feature", + "properties": {}, + "geometry": { + "coordinates": [ + 10.44766117815368, + 59.22486514003208 + ], + "type": "Point" + } + } + ] + } + }], +} +``` + +The properties are: +* timeOfObservation - timestamp when the obervation was made [REQUIRED] +* geoinfo: GeoJson describing the location. May or may not be required by the model +* name: Title of the observation (not important in models) +* observationData: Json formatted data quantifying the observation. **The properties vary greatly between the pests**. For each pest observation based models, there is a Json schema for this. + +Pest observations may be only one or a series, depending on the model. If no observations available, the model should handle NULL. ## Usage in a VIPS model ### Java