Derives phenology parameters and statistics for a defined observation period (season).
Please see full documentation: https://docs.geocledian.com/product-overview/crop-performance/phenology-package/
Resource associated to parcels:
Resource URL: /parcels/<id>/phenology
Path Parameters
| parcel-id | id of parcel |
| product_name | valid value: „phenology“ |
Required parameters
| key | registered user key to authorize user default: „“ |
| startdate | beginning of the observation period, date: 20181010 |
| enddate | end of the observation period, date: 20190401 |
Example
GET https://geocledian.com/agknow/api/v3/parcels/4483/phenology?key=39553fb7-7f6f-4945-9b84-a4c8745bdbec&startdate=20180401&enddate=20181231Response Elements
| status | „number_of_seasons“: numerical value of cropping intensity (how many seasons or harvests during the observation period)“active_cropland_ratio“: percentage of time in which the parcel was agriculturally cultivated in relation to total observation period duration“active_cropland“: boolean „True“ or „False“ whether the parcel has been cultivated during the observation period or stayed fallow (or even abandoned) |
| performance | „gradient“: indicating the steepness or speed of crop growth based on the NDVI curve“growth_rate“: increase of NDVI per day“crop_performance“: performance indicator indicating high, medium or low crop performance“duration_of_season“: days between emergence/greenup and scenescence/harvest |
| statistics | „area_under_curve“: integral of NVDI time series for the observation period“min“: minimum of NDVI time series for the observation period“max“: maximum of NDVI time series for the observation period“median“: median of NDVI time series for the observation period“mean“: mean of NDVI time series for the observation period“sum“: sum of NDVI time series for the observation period“first_quartile“: 1st quartile of NDVI time series for the observation period“third_quartile“: 3rd quartile of NDVI time series for the observation period“skewness“: skewness of NDVI time series for the observation period“kurtosis“: kurtosis of NDVI time series for the observation period“stddev“: standard deviation of NDVI time series for the observation period“variation“: variation of of NDVI time series for the observation period |
| markers | „status“: indicating the quality of the derived marker“date“: date of the derived marker“name“: SOS (Start of Season), POS (Peak of Season) or EOS (End of Season)“mean“: mean NDVI value for the respective marker |
Response
{
"phenology":{
"status":{
"number_of_seasons":2,
"active_cropland_ratio":0.71299,
"active_cropland":"True"
},
"performance":{
"gradient":0.49484,
"duration_of_season":237,
"crop_performance":"",
"growth_rate":0.00626
},
"statistics":{
"area_under_curve":271.3721,
"first_quartile":0.3616,
"skewness":-0.07519,
"min":0.20562,
"max":0.69182,
"sum":109.92823,
"median":0.48031,
"third_quartile":0.54452,
"stddev":0.13082,
"variance":0.01711,
"kurtosis":-0.77905,
"mean":0.4658
},
"markers":[
{
"status":"green",
"date":"2019-07-25",
"name":"SOS",
"mean":0.1969782043543062
},
{
"status":"green",
"date":"2020-03-18",
"name":"EOS",
"mean":0.1956514564194908
},
{
"status":"green",
"date":"2019-10-12",
"name":"POS",
"mean":0.691820075327746
}
]
},
"summary":{
"crop_parcel":"rashi",
"enddate":"2020-12-31",
"name":"MH/KH/2019/CCE/1084294",
"area":5827.79120109603,
"startdate":"2019-06-01",
"parcel_id":15185,
"crop":"rashi",
"entity":"aurungabad",
"centroid":{
"type":"Point",
"coordinates":[
75.6995253441445,
20.5278042038414
]
}
}
}Remarks
- phenology parameter derivation only meaningful during the respective crop growth season (defined through startdate and enddate)
- therefore: prior knowledge of crop calendars and crop seasons may be necessary
- number of seasons and identification of active cropland, however, can be also used as a multi-seasonal function