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

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

{
    "ob_id": 24914,
    "uuid": "acf1f55cd92a41fa9a97949b2066ad07",
    "title": "Poles Apart: Why has Antarctic sea ice increased and why don't coupled climate models reproduce observations, climate model data",
    "abstract": "Data produced in support of the NERC project Poles Apart (2014 - 2017) that investigated the atmospheric drivers of changes in surface wind forcing using the UK Chemistry and Aerosols (UKCA) model. \r\n\r\nTen HadGEM3 model simulations were undertaken. Monthly model data was taken from the final 30 years of each simulation and a number of variables of interest, e.g. temperature and precipitation were extracted and analysed. \r\n\r\nThe temporal range for the perturbed simulations is 1980-2013, and the control simulations are valid between 1841-1900.\r\n\r\nSee the detailed experiment documentation for the Unified Model experiment ids and their corresponding description (these have been used to organise the data).",
    "keywords": "Climate, Ozone, GHG, Aerosol, HadGEM3, UKCA",
    "publicationState": "citable",
    "dataPublishedTime": "2017-08-07T09:12:43",
    "doiPublishedTime": "2017-08-25T10:54:19",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/24915/?format=api",
        "dataPath": "/badc/deposited2017/poles-apart/data",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 273217365050,
        "numberOfFiles": 359,
        "fileFormat": "The data are NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6743/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51581/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55676/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56955/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56961/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56967/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56969/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56972/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61259/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61264/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62186/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62187/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62188/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62189/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62190/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62191/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62193/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62194/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62195/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62196/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62197/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62198/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62199/?format=api"
    ],
    "dataLineage": "UK Chemistry and Aerosol (UKCA) climate model data extracted using Convsh and converted to NetCDF. The data were provided by the Poles Apart project from the British Antarctic Survey and were passed to CEDA for archival.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/9327/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/24917/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/24918/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101963/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102176/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101961/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101959/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101958/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101957/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101956/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101955/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/101962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/169543/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/24916/?format=api",
    "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"
        }
    ]
}