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/12370/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 12370,
    "uuid": "c92a088715184487a2eab79949dfe497",
    "title": "MINERVA: North-West European shelf seas marine climate projections data: spatial two-dimensional 30-year mean climatology ensemble statistics",
    "abstract": "These climate projections for the North-West European Shelf Seas update the shelf seas component of UKCP09 Marine Report (Lowe et al, 2009) and were funded by the MINERVA project.\r\n\r\nThis dataset contains ensemble statistics for model output based on the QUMP (Quantifying Uncertainties in Model Projections) ensemble of HadCM3 (Hadley Centre Coupled Model version 3) runs downscaled with the POLCOMS (Proudman Oceanographic Laboratory Coastal Ocean Modelling System) under SRES A1B (Special Report on Emissons Scenarios - A1B business-as-usual with medium emissions) conditions, from 1952-2098 for which 30-year means anomalies have been calculated from monthly mean data for each of the 12 months. \r\n\r\nA Perturbed Physics Ensemble (PPE) of HadCM3 has been downscaled with the shelf seas model POLCOMS. Each of the 11 ensemble members has been downscaled as transient simulations (from 1952-2098) under the SRES A1B emissions scenario.  The PPE (QUMP) was designed to span the range of uncertainty associated with model parameter uncertainty in the atmosphere of the driving global climate model.  POLCOMS was run at 12 km resolution, with 32 vertical levels using s-coordinates over the NW European Shelf Seas domain (-18.3 to 14 degrees East, 43 to 63.56 degrees North).  Monthly statistics of the model results were recorded.  \r\nFurther details can be found in Tinker et al (2015).\r\n",
    "keywords": "MINERVA, UKCP, Marine Climate, Climate Projection, Uncertainty, Climate Downscaling, Shelf Seas, Temperature, SST, Salinity, Stratification, Sea Surface Temperature",
    "publicationState": "citable",
    "dataPublishedTime": "2016-09-05T11:26:35",
    "doiPublishedTime": "2016-09-20T09:08:24",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/19815/?format=api",
        "dataPath": "/badc/ukcp09/data/marine/minerva/dataset_1/ens_stats",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 343215532,
        "numberOfFiles": 385,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3335/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/537/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/7563/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11390/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11391/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11392/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11394/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11396/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11398/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11399/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11400/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11401/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11402/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11404/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25149/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25150/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25151/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25152/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25153/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25900/?format=api"
    ],
    "dataLineage": "A Perturbed Physics Ensemble (PPE) of the Atmosphere-Ocean General Circulation Model (AO-GCM, or GCM) HadCM3 is downscaled by the shelf seas model POLCOMS.  Monthly mean (and time-step minimum, maximum and variance) 3D (temperature, salinity, u- and v- components of currents) and 2D (surface elevation) fields were saved and the following variables were calculated: \r\n        SST: Sea Surface Temperature – surface model layer\r\n\tSSS: Sea Surface Salinity – surface model layer\r\n\tNBT: Near-Bed Temperature – bottom model layer\r\n\tNBS: Near-Bed Salinity – bottom model layer\r\n\tDFT: Difference between SST and NBT – surface model layer minus bottom model layer\r\n\tDFS: Difference between SSS and NBS – surface model layer minus bottom model layer\r\n\tPEA: Potential Energy Anomaly (a measure of stratification).\r\n\tMLD: Mixed Layer Depth\r\n\r\nFor the present day and the future:\r\nThe ensemble mean (ens_mean) is the average of the 30-year means from each of the 11 ensemble members.\r\nThe ensemble variance (ens_var) is the variance of the 30-year means from each of the 11 ensemble members.\r\nThe interannual variance (int_var) is the mean of the 30-year variances from each of the 11 ensemble members.\r\nThe ensemble standard deviation (std_dev) is the standard deviation of the 30-year means from each of the 11 ensemble members. This is the square root of the ensemble variance, and is redundant in the present day and future period – it is included for completeness.\r\n\r\nFor the difference fields (future minus present day):\r\nThe ensemble mean, ensemble variance and interannual variance are simply the difference between the future and present day fields.\r\nThe ensemble standard deviation is different - the differences in the future and present day 30-year means from each of the 11 ensemble members are calculated, and these differences are used to calculated the anomaly ensemble standard deviation. It is included to allow the ensemble spread to be given for a warming, or freshening.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/8995/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12372/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12371/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47193/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47185/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48404/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48406/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/48402/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/47183/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/76014/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/19988/?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"
        }
    ]
}