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

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

{
    "ob_id": 40884,
    "uuid": "9eb19fc1b1384fa4b7619e83254d4a96",
    "title": "HadCM3 Climate Simulation - time varying forcing of major and minor green house gases from 1859-2100",
    "abstract": "The AFHa forcings simulation contained in this dataset includes time varying forcing from historical concentrations of major and minor greenhouse gases from 1859 to 2100. After 1990 the forcing follows the IPCC IS92a emissions scenario.\r\n \r\n This is an \"all-forcings\" experiment designed to investigate the sensitivity of HadCM3 to various forcings, in this case the forcings are limited to anthropogenic green house gases. It is a partner experiment to HadCM3-AFHb which includes a wider range of anthropogenic forcings. The HadCM3 model was used by the Hadley Centre to provide input for the IPCC Third Assessment Report.\r\n \r\n Data members run for this experiment: aaxze\r\n\r\n Boundary conditions: All anthropogenic forcing from multiple species of greenhouse gases including various minor species specified to represent the IPCC IS92a emissions scenario.\r\n\r\n Initial conditions: Initialised from year 100 of the HadCM3 control run. (i.e. 2091)\r\n\r\n More detailed metadata on the model configuration and parameters is available in XML format.",
    "keywords": "HadCM3-AFHa, HadCM3, forcings",
    "publicationState": "published",
    "dataPublishedTime": "2024-04-16T08:07:34",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/40885/?format=api",
        "dataPath": "/badc/hadcm3/data/HadCM3_AFHa/",
        "oldDataPath": [
            "https://api.catalogue.ceda.ac.uk/api/v2/results/3805/?format=api"
        ],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 114529145851,
        "numberOfFiles": 5789,
        "fileFormat": "HadCM3 data is provided in PP (post processing) format."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11356/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3996/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71375/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71376/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71379/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71383/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71384/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71386/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71388/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71390/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71392/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71393/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71395/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71398/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71399/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71400/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71402/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71404/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71410/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71411/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71413/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71414/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71415/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71417/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71420/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71421/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71424/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71426/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71427/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71429/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71430/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71431/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71433/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71435/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71437/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71439/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71440/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71441/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71442/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71443/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71445/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71446/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71447/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71448/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71449/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71450/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71451/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71453/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71454/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71455/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71456/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71457/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71458/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71459/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71462/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71463/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71464/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71465/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71466/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71468/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71470/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71471/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71472/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71473/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71474/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71475/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71476/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71478/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71479/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71480/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71481/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71482/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71483/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71484/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71485/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71487/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71488/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71490/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/72150/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/72151/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/72152/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/72153/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/72154/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/72155/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/72156/?format=api"
    ],
    "dataLineage": "Data from the UK Met Office Hadley Centre. Dataset directory structure was reordered by CEDA staff in November 2023 to place experiment runs within a directory of their associated experiment.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12727/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12728/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13847/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3791/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198881/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198882/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/40886/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2613/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "link",
            "label": "restricted: link group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ukmo_agreement.pdf",
            "licenceClassifications": "academic"
        }
    ],
    "discoveryKeywords": []
}