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

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

{
    "ob_id": 25029,
    "uuid": "2499ca660bc448f281ff1a1de1d20970",
    "title": "The Organization of Tropical Rainfall: Idealised MetUM model output for convective aggregation studies",
    "abstract": "This dataset comprises of model output from 11 runs of the Met Office Unified Model (MetUM) in idealised radiative-convective equilibrium mode. All runs have fixed constant sea surface temperature (SST) and doubly-periodic lateral boundary conditions. These runs were used in several papers on convective self-aggregation: principally in Holloway and Woolnough (2016, Journal of Advances in Modeling Earth Systems) but also in Holloway (2017, Journal of Advances in Modeling Earth Systems).\r\n\r\nAll runs use the \"New Dynamics\" dynamical core, MetUM version 7.5, as described in Holloway and Woolnough (2016). The simulations are run with 4-km horizontal grid spacing. They all have a horizontal domain size of 576 km X 576 km (or 144 X 144 grid points), with 70 vertical levels. They were all run for 40 days except for the two runs with lower Sea Surface Temperatures, SSTs (295 K and 290 K) which were run for only 20 days.\r\n\r\nThe model output includes hourly model-level prognostic variables (temperature, specific humidity, pressure, wind components, liquid water, ice water) as well as some model-level increments to temperature and specific humidity. There are also many fields containing surface variables and fluxes (averaged over each hour or every 15 minutes).\r\n",
    "keywords": "tropical convection, Tropics, MetUM",
    "publicationState": "published",
    "dataPublishedTime": "2018-06-14T11:05:54",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/26162/?format=api",
        "dataPath": "/badc/deposited2017/tropical_rainfall/data/idealised",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 2160333196526,
        "numberOfFiles": 36853,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": null,
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1864/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13296/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51580/?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/51583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51585/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51594/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51600/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51601/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51602/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51604/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51607/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51610/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51611/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51613/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51614/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51615/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51616/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51617/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51618/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51619/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51620/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51621/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51627/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51628/?format=api"
    ],
    "dataLineage": "The data were delivered to 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/12144/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/25021/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102487/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102488/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102489/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102491/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102492/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102494/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102495/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102490/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/25030/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2543/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}