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

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

{
    "ob_id": 33272,
    "uuid": "b0cf5a39647e4036bd5351274c5daa5f",
    "title": "Improved high-resolution ocean reanalysis of Met Office GloSea5 data using the simple smoother algorithm, v1.0, June 2016",
    "abstract": "The dataset is a Global ¼° 0-2000m ocean reanalysis for June 2016, providing temperature and salinity data. The product is based on Met Office GloSea5 reanalysis (Blockley et al. 2014), with the simple smoother algorithm applied to improve the original reanalysis. The simple smoother is designed for smooth data adjustments in sequentially generated reanalysis products by utilizing knowledge of future assimilation increments. A decay time parameter is applied to the smoother increments to account for memory decay timescales in the ocean. Further information is available in the documentation section.",
    "keywords": "ocean reanalysis, smnoother, temperature, salinity",
    "publicationState": "citable",
    "dataPublishedTime": "2021-10-29T12:25:59",
    "doiPublishedTime": "2021-10-29T12:49:19",
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/33270/?format=api",
        "dataPath": "/neodc/ocean_reanalysis/smoother/data/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 31328941517,
        "numberOfFiles": 32,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9138/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2873/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52949/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70762/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70763/?format=api"
    ],
    "dataLineage": "Data were prepared by the NCEO DA team at the University of Reading and provided to CEDA for archival.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10959/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?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/148509/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148510/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148511/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148513/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148514/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148515/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148516/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148517/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148518/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/33271/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2521/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}