From 16ef0730c942a0fb6a267d919fd7fcf183f8e683 Mon Sep 17 00:00:00 2001
From: Tor-Einar Skog <tor-einar.skog@nibio.no>
Date: Mon, 6 Sep 2021 13:29:43 +0200
Subject: [PATCH] Updated docs

---
 README.md | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 50 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index b13cf57..b08998f 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.
 
-**&copy; 2021** NIBIO, the Norwegian Institute of Bioeconomy Research
+&copy; 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
+
-- 
GitLab