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

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

{
    "ob_id": 30085,
    "uuid": "3f2f92ad04f84e65a2399deeafd8bbbc",
    "title": "INTEGRATE: climate model simulations data to study the Asian climate response to Atlantic Multidecadal Oscillation (AMO) using the Intermediate General Circulation Model version 4 (IGCM4)",
    "abstract": "This dataset contains model simulated data to study the response of Asian summer climate to AMO-like (Atlantic Multidecadal Oscillation) sea surface temperature (SST) anomalies using the Intermediate General Circulation Model version 4 (IGCM4; Joshi et al., 2015). This dataset also contains the AMO SST patterns from seven Coupled Model Intercomparison Project (CMIP5)/Paleoclimate Modelling Intercomparison Project Phase (PMIP3) global climate models (Ratna et al., 2019), which are used to explore the sensitivity of the atmospheric response to the SST pattern.\r\n\r\nThese data were collected as part of the Natural Environment Research Council (NERC) funded 'An integrated data-model study of interactions between tropical monsoons and extra-tropical climate variability and extremes (INTEGRATE)' project (2016-2020) at the Climatic Research Unit, University of East Anglia. The project studied the interactions between tropics and extratropical climate variability.",
    "keywords": "INTEGRATE, AMO, model, IGCM4",
    "publicationState": "citable",
    "dataPublishedTime": "2020-02-25T10:16:43",
    "doiPublishedTime": "2020-06-17T14:17:56",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30086/?format=api",
        "dataPath": "/badc/deposited2020/integrate/data/v1/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 14925928761,
        "numberOfFiles": 706,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": null,
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2581/?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/28417/?format=api",
        "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/53109/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70655/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70656/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70657/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70658/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70659/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70660/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70661/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70662/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70663/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70664/?format=api"
    ],
    "dataLineage": "This data were generated using the Intermediate General Circulation Model version 4 (IGCM4; Joshi et al., 2015). The model is integrated for 55 years (idealised years) and monthly mean output are generated for the analysis and saved as NetCDF format using Climate Data Operator (CDO). The data were then sent to the Centre for Environmental Data Anaylsis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10724/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/30087/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129982/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129983/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129984/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129985/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129986/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129987/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129989/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129988/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168903/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129991/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/30088/?format=api",
    "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"
        }
    ]
}