GET

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

{
    "ob_id": 33460,
    "uuid": "4bbcb1722f2842c1b0a5ebc19160a863",
    "title": "STFC RAL methane retrievals from IASI on board MetOp-B, version 2.0",
    "abstract": "This Infrared Atmospheric Sounding Interferometer (IASI) methane dataset contains height-resolved and column-averaged volume mixing ratios of atmospheric methane (CH4) retrieved from the IASI instrument on the MetOp-B satellite. It also includes column-averaged water vapour (H2O), a scale factor for the HDO (water vapour isotopologue) volume mixing ratio profile, surface temperature, effective cloud fraction, effective cloud-top pressure and scale factors for two systematic residual spectra which are jointly retrieved from the spectral range 1232.25-1290.00 cm-1.   This dataset was produced by Version 2.0 of the Rutherford Appleton Laboratory's (RAL's) IASI optimal estimation scheme to retrieve methane, which takes as input temperature and water vapour profiles and surface spectral emissivity pre-retrieved by RAL's Infrared and Microwave Scheme applied to IASI, MHS and AMSU-A on MetOp-B. The dataset additionally contains selected a priori values and uncertainties adopted in the optimal estimation scheme and retrieval output diagnostics such as the retrieval cost and the averaging kernels.\r\n\r\nDevelopment of the Version 2.0 scheme and its application to MetOp-A (2007-2017, http://dx.doi.org/10.5285/f717a8ea622f495397f4e76f777349d1)  was funded by the National Centre for Earth Observation (NCEO) under the UK Natural Environment Research Council (NERC) with additional funding from EUMETSAT. Adaptation to MetOp-B and production of the IASI MetOp-B methane dataset 01/2018-03/2021 were funded by NCEO and ESA Contract No. 4000129987/20/I-DT Methane+.\r\n\r\nData were produced by the United Kingdom Research and Innovation (UKRI) Science and Technology Facilities Council (STFC) Remote Sensing Group (RSG) at the Rutherford Appleton Laboratory (RAL).",
    "keywords": "methane, IASI, optimal estimation, retrieval, averaging kernels, assimilation",
    "publicationState": "citable",
    "dataPublishedTime": "2022-01-18T18:05:28",
    "doiPublishedTime": "2022-01-20T15:39:58.056345",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/34646/?format=api",
        "dataPath": "/neodc/iasi_ch4_ral/data/metop-b/l2/tir/v2.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 802812457119,
        "numberOfFiles": 242324,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9189/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61970/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61971/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61972/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61973/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61977/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61978/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61979/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61980/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61981/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61984/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61985/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61986/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61987/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61988/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61989/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61991/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61992/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61993/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61995/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61996/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62000/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62001/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62004/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68549/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68550/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68553/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68558/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68560/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68562/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68563/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68564/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68565/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68566/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68567/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68570/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68571/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68573/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82410/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82411/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82412/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82413/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82414/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82415/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82417/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82420/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82421/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82423/?format=api"
    ],
    "dataLineage": "Data has been produced by the Rutherford Appleton Laboratory (RAL) Remote Sensing Group (RSG) at the United Kingdom Research and Innovation (UKRI) Science and Technology Facilities Council (STFC) and supplied to the Centre for Environmental Data Analysis for long term archiving.\r\n\r\nDevelopment of the Version 2.0 Infrared Atmospheric Sounding Interferometer (IASI) offline thermal infrared methane retrieval scheme and its application to MetOp-A (2007-2017, http://dx.doi.org/10.5285/f717a8ea622f495397f4e76f777349d1) were funded by the National Centre for Earth Observation (NCEO) under the UK Natural Environment Research Council (NERC) with additional funding from EUMETSAT. Adaptation to MetOp-B and production of the IASI MetOp-B methane dataset (01/2018-03/2021) were funded by NCEO and ESA Contract No. 4000129987/20/I-DT Methane+.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10981/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/34648/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/14469/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149468/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149472/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149471/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149470/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149474/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149473/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149475/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149476/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149469/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149480/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149521/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149477/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/149478/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/33464/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}