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

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

{
    "ob_id": 31768,
    "uuid": "bbd0a00c3d7f42f7bbd7ca69a8a9f4e6",
    "title": "ICECAPS-ACE: surface turbulent heat flux estimates",
    "abstract": "This dataset contains estimates of turbulent heat and momentum fluxes calculated by applying the eddy covariance technique to the flux-components data product. Estimates are calculated over 15-minute and 30-minute averaging intervals, at two heights on the 15 m tower at Summit Station, Greenland.\r\n\r\n- ace-flux-1 are the lower level (~2 m above surface) calculations, from a Metek uSonic-3 scientific 3D sonic anemometer and Licor Li-7500 gas analyzer.\r\n- ace-flux-2 are the higher level measurements (~14 m above surface), from a Metek uSonic-3 scientific 3D sonic anemometer only (no latent heat flux).\r\n\r\nAlso see the ICECAPS-ACE: surface turbulent heat flux components data product for the high resolution (10 Hz) data used to make these calculations.\r\n\r\nThese data were collected as part of the joint Natural Environmental Research Council (NERC) and US National Science Foundation (NSF) -funded Integrated Characterisation of Energy, Clouds, Atmospheric state, and Precipitation at Summit - Aerosol Cloud Experiment (ICECAPS-ACE) project.\r\n\r\nThese data were continued through the 3 year extension to the ICECAPS-ACE project called ICECAPS-MELT.",
    "keywords": "ICECAPS-ACE, turbulence, sensible heat flux, latent heat flux, surface energy budget, momentum head flux, boundary layer, Summit station, Greenland Ice Sheet",
    "publicationState": "published",
    "dataPublishedTime": "2020-07-28T14:34:57",
    "doiPublishedTime": null,
    "updateFrequency": "asNeeded",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/31764/?format=api",
        "dataPath": "/badc/icecaps-ace/data/flux-estimates",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 594310338,
        "numberOfFiles": 7868,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8685/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2625/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22987/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/23038/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/28887/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/28888/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30057/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30060/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30062/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30063/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30064/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30065/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30067/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30068/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30069/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30070/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30071/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30094/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30108/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30109/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30111/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30112/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30113/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30114/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Leeds in collaboration with the ICECAPS project team and deposited at the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/30502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/38309/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30507/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140173/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140176/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140177/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140178/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140179/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140180/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140181/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140175/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140185/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140186/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182380/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/31767/?format=api",
    "procedureCompositeProcess": null,
    "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"
        }
    ]
}