diff --git a/README.md b/README.md index b13cf57de9242a05cdf4a56873712db26afd2f04..b08998f8c15ebc46f0b64dc21e5e5d3832d93aa7 100644 --- a/README.md +++ b/README.md @@ -2,13 +2,60 @@ The model aims to be a generic model for phenology prediction of a number of species of plants and insects. It is based on the assumption that the development of the specimen is temperature driven. Its general nature requires the user to provide both weather data and the specific characteristics data for the species/variant at hand. -**© 2021** NIBIO, the Norwegian Institute of Bioeconomy Research +© 2021 NIBIO, the Norwegian Institute of Bioeconomy Research -**Authors:** Bhabesh Bhabani Mukhopadyay and Tor-Einar Skog +**Authors:** Bhabesh Bhabani Mukhopadhyay and Tor-Einar Skog Input data: * Weather data * Phenhology phases and their heat requirements * Day degree calculation method -See a full example of input data for Fall Armyworm [here](doc/input_data_example.md) \ No newline at end of file +See a full example of input data for Fall Armyworm [here](doc/input_data_example.md) + +An exerpt is found below + +```json +{ + "plantationData": { + "speciesLatinName": "FAW", + "typeName": "GENERIC", + "baseTemp": 13.0, + "optTemp": 28.0, + "upperTemp": 35.0, + "logIntervalId": 1, + "algorithmId": 2, + "startDate": 1605571200000, + "weatherParams": ["TM"], + "plantations": [{ + "typeName": "GENERIC", + "phaseName": "Egg", + "heatReq": 0.0 + }, { + "typeName": "GENERIC", + "phaseName": "Hatched egg", + "heatReq": 33.35 + }] + }, + "observations": [{ + "elementMeasurementTypeId": "TM", + "logIntervalId": 1, + "timeMeasured": "2020-11-04T08:00:00Z", + "value": 31.609090909090913 + } + +``` +Please observe these properties: +* speciesLatinName: Should be (but isn't in the example!) the latin name of the species +* typeName: If we have a variant of the species (typically for plants), write the name here +* algorithmId: Defining how we calculate the day degrees. + 1. Basic day degree model with mean temperature and base temperature + 2. Daily heat sum calculated from hourly values based on base temp, max temp, opt temp (TODO: Document the model) +* baseTemp: For the day degree calculation (at least methods 1 and 2) +* upperTemp: For the day degree calculation (at least method 2) +* optTemp: For the day degree calculation (at least method 2) +* startDate: The date (as a Unix timestamp) for when the calculation starts. Also known as biofix +* weatherParams: Array of weather parameters needed for the calculation. TM = Mean temperature +* plantations: Array of development phases of the species, in the correct order +* observations: Array of weather observations +