Observation Instance – Django REST framework

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/27366/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 27366,
    "uuid": "d40bf62899014582a72d24154a94d8e2",
    "title": "IASI retrieval of sulphur dioxide (SO2) column amounts and altitude, 2014-09 to 2015-02, version 1.0",
    "abstract": "This dataset contains global retrieval of sulphur dioxide (SO2) column amounts and altitudes derived from the Infrared Atmospheric Sounding Interferometer (IASI) instrument on the METOP-A satellite. The data have been produced by the University of Oxford as part of the NERC Centre for the Observation and Modelling of Earthquakes, Volcanoes and Tectonics (COMET). \r\n\r\nThis dataset has been produced using the Carboni et al. (2012,2016) retrieval algorithm for the Infrared Atmospheric Sounding Interferometer which retrieve column amount and altitude (together with a comprehensive error budget for every pixel) using simultaneously all the IASI channels between 1000–1200 and 1300–1410 cm−1.   It has a global coverage and includes the six-month-long Holuhraun eruption, from September 2014 to February 2015, together with other events during the same periods such as: volcanic activity on the Kamchatka peninsula, Etna  and Capo verde eruptions, anthropogenic SO2 emissions from China.\r\n\r\nThe data presents the results of the retrieval for every IASI 'plume' pixels (e.g. that result positive to the IASI SO2 detection) including: column amount (in Dobson Unit - DU), altitude (in millibar and successively converted in km using meteorological profile), surface temperature.  It also includes quality control parameters and quality flags: for generic use we recommend  using data with flag = 1. Quality control parameters available are: degree of freedom, cost function, convergence. These quality control paramenters are also summarized in two 'stricted' and 'relaxed' quality control flags.  \r\n\r\nThis dataset also includes location of all IASI pixels in the same orbit (non plume pixel) to allow regridding and comparison with other instruments and models.",
    "keywords": "IASI, SO2, volcanic emissions, satellite observation,",
    "publicationState": "published",
    "dataPublishedTime": "2019-03-04T15:54:19",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27367/?format=api",
        "dataPath": "/neodc/iasi_so2_oxford/data/orbit-by-orbit/paper-sep14-sep15",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3797560623,
        "numberOfFiles": 2549,
        "fileFormat": "Data are NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7341/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2389/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13238/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52025/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52026/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52027/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52030/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52031/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52032/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52033/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52034/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52035/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52036/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52038/?format=api"
    ],
    "dataLineage": "These data were produced by the Earth Observation Data Group, Atmospheric, Oceanic and Planetary Physics, University of Oxford, as part of the NERC Centre for the Observation and Modelling of Earthquakes, Volcanoes and Tectonics (COMET). These data were then supplied to the Centre for Environmental Data Analysis (CEDA) to be archived.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/11687/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114451/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114447/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114448/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114449/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114450/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114452/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114445/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114446/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114453/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114454/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/25889/?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"
        }
    ]
}