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

{
    "ob_id": 37354,
    "uuid": "2e36fe8eb7ee4bd0a0833d3e1edd795a",
    "title": "Data to support Below-cloud scavenging of aerosol by rain: A review of numerical modelling approaches and sensitivity simulations with mineral dust",
    "abstract": "This dataset contains all the UM-GA8.0 climate model output needed to reproduce Table 2 and Figures 7-10 in the paper Below-cloud scavenging of aerosol by rain: A review of numerical modelling approaches and sensitivity simulations with mineral dust by Anthony C. Jones, Adrian Hill, John Hemmings, Pascal Lemaitre, Arnaud Querel, Claire L. Ryder, and Stephanie Woodward, Submitted to Atmospheric Chemistry and Physics, May 2022, as well as Figures S7-S13 in the Supplementary material. UM-GA8.0 is the Met Office Unified Model General Atmosphere vn8.0 in a climate configuration (N96L85) and using AMIP protocol (see Jones et al., 2022 for more details).\r\n\r\nAll files are CF-1.7 compliant and in NetCDF format with appropriate metadata. Each file contains monthly mean data for the 15 simulated years used in the paper (the 5 year spin up is not provided).\r\n\r\nThe files are separated into folders by experiment name:\r\n\r\nFolder      | Simulation name (Table 1 in Jones et al., 2022)\r\n-------------------------------------------------------------\r\nSlinn       | Slinn\r\nSlinnph     | Slinn+ph\r\nSlinnphrc   | Slinn+ph+rc\r\nWang        | Wang\r\nLaakso      | Laakso\r\nSlinnPhRc1M | Slinn+ph+rc(1M)\r\nSlinnPhRcDm | Slinn+ph+rc(dm)\r\nLaaksoDm    | Laakso(dm)\r\n\r\nThe files use standard CMIP naming conventions with one slight modification: before the 'nc' suffix, the aerosol mode that the variable applies to is generally given (either coarse (cor) or accumulation (acc) mode). The STARTDATE and ENDDATES are the same for all files (12/1993 and 11/2008 respectively). As is the TIMEPERIOD (Amon, i.e., monthly mean data) and the MODEL (MetUM, else known as UM-GA8.0). \r\n\r\nVARIABLE_TIMEPERIOD_MODEL_EXPERIMENT_STARTDATE_ENDDATE.MODE.nc\r\n\r\nThe variables comprise:\r\n\r\nShort name  | Description (units, if any)\r\n-------------------------------------------------------------\r\nconccn      | Particle number concentration (m-3)\r\nconcdust    | Particle mass concentration (kg.m-3)\r\ndiamdust    | Modal median diameter (m)\r\ndrydust     | Dust dry deposition rate (kg.m-2.s-1)\r\nemidust     | Dust surface emission rate (kg.m-2.s-1)\r\nloaddust    | Vertically integrated dust load (kg.m-2)\r\nmmratedust  | Dust mode-merging (cor->acc) rate (kg.m-3.s-1)\r\nod443dust   | Dust optical depth at 443 nm\r\nod550dust   | Dust optical depth at 443 nm\r\norog        | Surface Altitude (m)\r\nwetdust     | Dust wet deposition rate (kg.m-2.s-1)\r\nzfull       | Model altitude at the top of the gridcell (m)\r\n\r\nThe mass concentration (concdust), number concentration (conccn), and mass burden (loaddust) were calculated from monthly-mean mass or number mixing ratios and monthly mean potential temperature, pressure, and specific humidity fields (not supplied). The mode mixing rate (mmratedust) is only available for the downard mode merging simulations (SlinnPhRcDm and LaaksoDm).\r\n\r\nAll figures in the paper were produced using Python (3.6) and Iris scientific analysis software.\r\n\r\nAll data is Crown Copyright, Met Office, and is made available under the terms of the Non-Commercial Government Licence: http://www.nationalarchives.gov.uk/doc/non-commercial-government-licence/version/2/",
    "keywords": "",
    "publicationState": "citable",
    "dataPublishedTime": "2022-06-06T11:36:02",
    "doiPublishedTime": "2022-06-06T13:13:03",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37355/?format=api",
        "dataPath": "/badc/deposited2022/below-cloud-scavenging-aerosol/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 86597715864,
        "numberOfFiles": 165,
        "fileFormat": "Data are NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10315/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3464/?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/6107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/7026/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/7028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/9042/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/9043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12567/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/19559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22005/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22142/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22172/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27776/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27906/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27993/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/28018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30325/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46686/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49220/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49221/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49222/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49223/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49224/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/49225/?format=api"
    ],
    "dataLineage": "The data is model output from MetUM simulations performed on the Met Office Cray XC40 supercomputer. The output was then processed and made CF-compliant using Python with the Iris module.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12141/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/37356/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178445/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178446/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178447/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178448/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178449/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178450/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178455/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178456/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178457/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178458/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178459/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178462/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/475/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}