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/40358/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 40358,
    "uuid": "b06c4c5ea7694d30b33e1db04f0ecb6a",
    "title": "ESA Snow Climate Change Initiative (Snow_cci): Snow Water Equivalent (SWE) level 3C daily global climate research data package (CRDP)  (1979 - 2022), version 3.0",
    "abstract": "This dataset contains v3.0 of the Daily Snow Water Equivalent (SWE) product from the ESA Climate Change Initiative (CCI) Snow project, at 0.1 degree resolution.\r\n\r\nSnow water equivalent (SWE) indicates the amount of accumulated snow on land surfaces, in other words the amount of water contained within the snowpack. The SWE product time series covers the period from 1979/01 to 2022/12. Northern Hemisphere SWE products are available at daily temporal resolution with alpine areas masked. \r\n\r\nThe product is based on data from the Scanning Multichannel Microwave Radiometer (SMMR) operated on National Aeronautics and Space Administration’s (NASA) Nimbus-7 satellite, the  Special Sensor Microwave / Imager (SSM/I) and the Special Sensor Microwave Imager / Sounder (SSMI/S) carried onboard the Defense Meteorological Satellite Program (DMSP) 5D- and F-series satellites. The satellite bands provide spatial resolutions between 15 and 69 km.  The retrieval methodology combines satellite passive microwave radiometer (PMR) measurements with ground-based synoptic weather station observations by Bayesian non-linear iterative assimilation. A background snow-depth field from re-gridded surface snow-depth observations and a passive microwave emission model are required components of the retrieval scheme.\r\n\r\nThe dataset is aimed to serve the needs of users working on climate research and monitoring activities, including the detection of variability and trends, climate modelling, and aspects of hydrology and meteorology.\r\n\r\nThe Finnish Meteorological Institute is responsible for the SWE product development and generation. \r\n\r\nFor the period from 1979 to May 1987, the products are available every second day. From October 1987 till December 2022, the products are available daily. Products are only generated for the Northern Hemisphere winter seasons, usually from beginning of October till the middle of May. A limited number of SWE products are available for days in June and September; products are not available for the months July and August as there is usually no snow information reported on synoptic weather stations, which is required as input for the SWE retrieval. Because of known limitations in alpine terrain, a complex-terrain mask is applied based on the sub-grid variability in elevation determined from a high-resolution digital elevation model. All land ice and large lakes are also masked; retrievals are not produced for coastal regions of Greenland.\r\n\r\nPassive microwave radiometer data are obtained from the recalibrated enhanced resolution CETB ESDR dataset (MEaSUREs Calibrated Enhanced-Resolution Passive Microwave Daily EASE-Grid 2.0 Brightness Temperature (CETB) Earth System Data Record (ESDR) https://nsidc.org/pmesdr/data-sets/) Spatially and temporally varying snow density fields are implemented into the SWE retrieval, dry snow detection algorithm has been updated and snow masking in post-production has been improved. The time series has been extended from snow_cci version 2 by two years with data from 2020 to 2022 added.\r\n\r\nThe ESA CCI phased product development framework allowed for a systematic analysis of these changes in the snow density parameterization, snow dry detection and snow masking that occurred between v2 and v3 using a series of step-wise developmental datasets. In comparison with in-situ snow courses, the correlation and RMSE of v3 improved 0.014 and 0.6 mm, respectively, relative to v2. The timing of peak snow mass is shifted two weeks later compared to v1 and reduction in peak snow mass presented in v2 is removed in v3.\r\n\r\nThis dataset has been deprecated due to data errors in the v3.0 product.",
    "keywords": "ESA, CCI, Snow, SWE",
    "publicationState": "published",
    "dataPublishedTime": "2024-11-18T13:57:37",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "deprecated",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43050/?format=api",
        "dataPath": "/neodc/esacci/snow/data/swe/MERGED/v3.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 12968625940,
        "numberOfFiles": 8899,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11866/?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/62645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73925/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73926/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73927/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73928/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73929/?format=api"
    ],
    "dataLineage": "Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA) as part of the CCI Knowledge Exchange project.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "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/196726/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196727/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196728/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196729/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196730/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196731/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196732/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196733/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196734/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196735/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196736/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196737/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196738/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196739/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196740/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196741/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/196742/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/41960/?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": []
}