Observation Instance
Get a list of Observation objects.
### Available end points:
- `/observations/` - Will list all Results in the database
- `/observations.json` - Will return all Results in json format. This can
also be achieved by using the accept header. `application/json`
- `/observations/<object_id>/` - Returns Results object with that id
### Available Methods:
- `GET`
- `HEAD`
### Available filters:
- `title`
- `uuid`
- `keywords`
- `status`
- `result_field`
- `discoveryKeywords`
- `updateFrequency`
- `nonGeographicFlag`
- `publicationState`
- `permissions`
### How to use filters:
These filters can be used like django query filters using __ for related model relationships.
- `/observations/?uuid=d594d53df2612bbd89c2e0e770b5c1a0`
- `/observations/?status=completed`
- `/observations/?results_field__dataPath__startswith=/neodc/esacci`
- `/observations/?discoveryKeywords__name=ESACCI`
- `/observations/?nonGeographicFlag=True`
Filters can be stacked to build an 'AND' relationship. E.g.
- `/observations/?publicationState__in=published,citable&nonGeographicFlag=True`
- `/observations/?publicationState__in=published,citable&discoveryKeyword__name=NDGO0003`
GET /api/v2/observations/40354/?format=api
{ "ob_id": 40354, "uuid": "80567d38de3f4b038ee6e6e53ed1af8a", "title": "ESA Snow Climate Change Initiative (Snow_cci): Daily global Snow Cover Fraction - snow on ground (SCFG) from MODIS (2000-2022), version 3.0", "abstract": "This dataset contains Daily Snow Cover Fraction (snow on ground) from MODIS, produced by the Snow project of the ESA Climate Change Initiative programme.\r\n\r\nSnow cover fraction on ground (SCFG) indicates the area of snow observed from space on land surfaces, in forested areas corrected for the masking effect of the forest canopy. The SCFG is given in percentage (%) per pixel. \r\n\r\nThe global SCFG product is available at about 1 km pixel size for all land areas, excluding Antarctica and Greenland ice sheets and permanent snow and ice areas. The coastal zones of Greenland are included. \r\n\r\nThe SCFG time series provides daily products for the period 2000 – 2022. \r\n\r\nThe SCFG product is based on Moderate resolution Imaging Spectroradiometer (MODIS) data on-board the Terra satellite. \r\n\r\nThe retrieval method of the snow_cci SCFG product from MODIS data has been further developed and improved based on the ESA GlobSnow approach described by Metsämäki et al. (2015) and complemented with a pre-classification module developed by ENVEO (ENVironmental Earth Observation IT GmbH). For the SCFG product generation from MODIS, multiple reflective and emissive spectral bands are used. In a first step, clouds are masked using an adapted version of the Simple Cloud Detection Algorithm version 2.0 (SCDA2.0) (Metsämäki et al., 2015). All cloud free pixels are then used for the snow extent mapping, using spectral bands centred at about 0.55 µm and 1.6 µm, and an emissive band centred at about 11 µm. The Snow_cci snow cover mapping algorithm is a two-step approach: first, a strict pre-classification is applied to identify all cloud free pixels which are certainly snow free. For all remaining pixels, the snow_cci SCFG retrieval method is applied. \r\n\r\nThe main differences of the snow_cci snow cover mapping algorithm compared to the GlobSnow algorithm described in Metsämäki et al. (2015) are (i) improvements of the cloud screening approach applicable on a global scale, (ii) the pre-classification of snow free areas on global land areas, (iii) the usage of spatially variable background reflectance and forest reflectance maps instead of global constant values for snow free land and forest, (iv) the update of the constant value for wet snow based on analyses of spatially distributed reflectance time series of MODIS data, and (v) the update of the global forest canopy transmissivity based on forest density from Hansen et al. (2013) and forest type layers from Land Cover CCI (Defourny, 2019) to assure in forested areas consistency of the SCFG and the SCFV CRDP v3.0 from MODIS data (https://catalogue.ceda.ac.uk/uuid/e955813b0e1a4eb7af971f923010b4a3) using the same retrieval approach.\r\n\r\nPermanent snow and ice, and water areas are masked based on the Land Cover CCI data set of the year 2000. Both classes were separately aggregated to the pixel spacing of the SCFG product. Water areas are masked if more than 30 percent of the pixel is classified as water, permanent snow and ice areas are masked if more than 50 percent are identified as such areas in the aggregated map. Salt lakes are masked based on a manual delineation from MODIS data. The product uncertainty for observed land pixels is provided as unbiased root mean square error (RMSE) per pixel in the ancillary variable.\r\n\r\nCompared to the SCFG CRDP v2.0 (https://catalogue.ceda.ac.uk/uuid/8847a05eeda646a29da58b42bdf2a87c/) the following improvements were applied for the generation of the SCFG CRDP v3.0: \r\n1) the pre-classification module to identify snow free areas has been relaxed to consider more pixels for the SCFG retrieval; \r\n2) the SCFG retrieval has been improved adapting the spectral reflectance value for wet snow;\r\n3) the uncertainty estimation of the SCFG has been updated to account for the changes in the retrieval algorithm;\r\n4) salt lakes retrieved by manual delineation from Terra MODIS data are masked in the SCFG CRDP v3.0 and a new class for salt lakes is added in the coding;\r\n5) the time series, starting in February 2000, was extended from December 2020 to December 2022;\r\n6) two additional layers are provided for each daily product: \r\n•\tthe sensor zenith angle in degree per pixel;\r\n\tthe image acquisition time per pixel referring to the scanline time of the MODIS granule used for the classification of the pixel. \r\n\r\nThe SCFG product is aimed to serve the needs for users working in the cryosphere and climate research and monitoring activities, including the detection of variability and trends, climate modelling and aspects of hydrology, meteorology, and biology.\r\nENVEO is responsible for the SCFG product development and generation from MODIS data, SYKE supported the development.\r\n\r\nThere are a few days without any MODIS acquisitions in the years 2000, 2001, 2002, 2003, 2008, 2016 and 2022. On several days in the years 2000 to 2006, and on a few days in the years 2012, 2015 and 2016, the acquired MODIS data have either only limited coverage, or some of the MODIS data were corrupted during the download process. For these days, the SCFG products are available but have data gaps.", "keywords": "ESA, CCI, Snow, Snow Cover Fraction", "publicationState": "citable", "dataPublishedTime": "2024-10-15T12:46:03", "doiPublishedTime": "2024-10-15T16:45:25.166384", "updateFrequency": "notPlanned", "status": "completed", "result_field": { "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43047/?format=api", "dataPath": "/neodc/esacci/snow/data/scfg/MODIS/v3.0", "oldDataPath": [], "storageLocation": "internal", "storageStatus": "online", "volume": 861587059895, "numberOfFiles": 8278, "fileFormat": "NetCDF" }, "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11202/?format=api", "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2614/?format=api", "nonGeographicFlag": false, "phenomena": [ "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6021/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/32072/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61130/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61131/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61132/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62644/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62645/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74106/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74107/?format=api" ], "dataLineage": "The snow_cci SCFG products from MODIS are based on the MODIS/Terra Calibrated Radiances 5-Min L1B Swath 1km (MOD021KM) and the MODIS/Terra Geolocation Fields 5-Min L1A Swath 1km (MOD03) Collection 6.1 data sets, provided by NASA.\r\n\r\nThe snow_cci SCF processing chain for MODIS includes the masking of clouds, the identification of certainly snow free areas, and the classification of snow cover fraction per pixel for all remaining observed pixels. Finally, permanent snow and ice areas as well as water bodies are masked in the SCFG products using the corresponding classes from the Land Cover CCI map of the year 2000 as auxiliary layers. Salt lakes are masked based on a manual delineation of such areas from Terra MODIS data. All SCFG products are prepared according to the CCI data standards.\r\n\r\nAn automated and a manual quality check was performed on the full time series.\r\n\r\nWe acknowledge Norsk Regnesentral (Norwegian Computing Center, NR) for downloading the MODIS data from NASA, and UNINETT Sigma2 AS (Sigma2, The Norwegian e-infrastructure for Research & Education) for providing the processing infrastructure for the CRDP generation from MODIS.", "removedDataTime": null, "removedDataReason": "", "language": "English", "identifier_set": [ "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13199/?format=api" ], "projects": [ "https://api.catalogue.ceda.ac.uk/api/v2/projects/30229/?format=api" ], "observationcollection_set": [], "responsiblepartyinfo_set": [ "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196675/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196678/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196676/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196673/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196670/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203906/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196674/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196677/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196671/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196672/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196681/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196679/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196682/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205570/?format=api" ], "procedureAcquisition": null, "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/43064/?format=api", "procedureComputation": null, "permissions": [ { "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2571/?format=api", "useLimitation": null, "accessConstraints": null, "accessCategory": "public", "accessRoles": null, "label": "public: None group", "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_snow_terms_and_conditions.pdf", "licenceClassifications": "any" } ], "discoveryKeywords": [ { "ob_id": 1140, "name": "ESACCI" } ] }