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/26102/?format=api
{ "ob_id": 26102, "uuid": "cf97ccc802d348ec8a3b6f2995dfbbff", "title": "Daily MODIS (MODerate Imaging Spectroradiometer) derived cloud droplet number concentration global dataset for 2003-2015", "abstract": "Daily global cloud droplet number concentrations (Nd) have been calculated at 1x1 degree resolution from pixel-level MODIS (MODerate Imaging Spectroradiometer) Collection 5.1 Joint Level-2 (Aqua satellite) optical depth (tau) and the 3.7 micron effective radius (reff) data (and other supporting data) using the adiabatic cloud assumption (liquid water content increases linearly with height, Nd is constant throughout the cloud depth and the ratio of the volumne mean radius to the effective radius is assumed constant). \r\n\r\nThe Nd data is contained in separate NetCDF files for each year for the period 2003-2015. Nd is contained in the \"Nd\" variable and has units of cm^{-3}. This is a 360x180xNdays (lon x lat x Ndays) sized array, where Ndays is the number of days in the year. The lon x lat grid is a regular 1x1 degree grid. The time is provided as both a 1D array of size Ndays (\"time\") with units of days since 1st Jan, 1970 and an array of size Ndays x 3 (\"time_vec\") that contains numbers for the year month and day for each of the Ndays entries.\r\n \r\nA number of filters have been applied to the data in order to remove retrievals that are likely to be problematic, or to violate the adiabatic cloud assumptions. Data is only included if:\r\n\r\n 1) Pixels are determined to be liquid pixels by MODIS.\r\n 2) The 1x1 degree mean cloud top height (calculated using the MODIS cloud top temperature and the sea surface temperature) is below 3.2km.\r\n 3) The 1x1 degree liquid cloud fraction was larger than 80%.\r\n 4) The 1x1 degree mean solar zenith angle was 65 degrees or less to avoid biases at high angles (Grosvenor and Wood, 2014).\r\n\t\t\t\t\t\t\r\n Note, that the filtering is different to that described in Grosvenor, AMTD, 2018 in the following ways :-\r\n\r\n 1) 1km resolution tau and reff are used to calculate Nd, which is then aggregated to 1x1 degree resolution (rather than using 1x1 degree tau and reff).\r\n 2) Only Nd based on the 3.7 micron reff retrieval is provided here.\r\n 3) No filtering for the presence of sea-ice is done here - it is recommended that this is done if using for high latitudes.\r\n 4) The data here is not restricted to tau>5.\r\n\t\t\t\t\t\t\t\t\t\t\t\t\r\nAlso note that the vertical penetration bias correction described in Grosvenor, AMTD, 2018 is NOT applied here. In addition, as described in the latter paper, further pixel-level screening is performed in order to select high quality data.\r\n\r\nDetails on the reasons for restricting to low solar zenith angles can be found in Grosvenor and Wood, ACP, 2014. Information on the pixel level filtering applied can be found in Grosvenor et al., AMTD, 2018 (noting the differences explained above). A comparison of this dataset with others can be found in Grosvenor et al., Reviews of Geophysics, 2018.\r\n\r\nThis dataset calculates a product that is not provided as standard by MODIS. It uses improved optical depth and effective radius data compared to the standard MODIS Level-3 data since situations (e.g., high solar zenith angles, broken clouds) that have been shown to cause retrieval issues have been filtered out at the Level-2 stage before being averaged into Level-3 droplet concentration data.\r\n", "keywords": "", "publicationState": "published", "dataPublishedTime": "2018-05-23T15:54:22", "doiPublishedTime": null, "updateFrequency": "notPlanned", "status": "completed", "result_field": { "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/26100/?format=api", "dataPath": "/badc/deposited2018/grosvenor_modis_droplet_conc/data", "oldDataPath": [], "storageLocation": "internal", "storageStatus": "online", "volume": 2461071312, "numberOfFiles": 14, "fileFormat": "NetCDF" }, "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7051/?format=api", "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2203/?format=api", "nonGeographicFlag": false, "phenomena": [ "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3894/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18405/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18408/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/24302/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/24303/?format=api" ], "dataLineage": "The data upon which this dataset was based was downloaded in the form of Collection 5.1 Joint Level-2 cloud product swaths (MYDATML files) from the MODIS-Aqua satellite instrument via the MODIS FTP service. They were then processed using Matlab following the methods described above onto a regular 1x1 degree grid with separate values stored for each overpass of a given gridbox. Overpasseses with a solar zenith angles larger than 65 degrees were not included in the subsequent averaging to daily values.\r\n", "removedDataTime": null, "removedDataReason": "", "language": "English", "identifier_set": [], "projects": [ "https://api.catalogue.ceda.ac.uk/api/v2/projects/26101/?format=api" ], "observationcollection_set": [ "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30129/?format=api" ], "responsiblepartyinfo_set": [ "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109321/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109316/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109318/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109319/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109320/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109322/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109323/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109324/?format=api", "https://api.catalogue.ceda.ac.uk/api/v2/rpis/109317/?format=api" ], "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/26034/?format=api", "procedureCompositeProcess": null, "procedureComputation": null, "permissions": [ { "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api", "useLimitation": null, "accessConstraints": null, "accessCategory": "public", "accessRoles": null, "label": "public: None group", "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/", "licenceClassifications": "any" } ], "discoveryKeywords": [ { "ob_id": 1138, "name": "NDGO0003" } ] }