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

{
    "ob_id": 43167,
    "uuid": "3889a9e536c04057a98a47db21602b62",
    "title": "GCHP global modelling output dataset for OH + NO2 (2021-2022)",
    "abstract": "These files contain model output for “Water dependence of OH+NO2 reaction reduces atmospheric oxidation” Winiberg et al., 2024. It was funded by the NERC BLEACH project (NE/W00724X/1).\r\n\r\nThe datasets are GEOS-Chem High Performance (GCHP) global model simulations of monthly mean or hourly mean of volume mixing ratios of atmospheric chemical species (e.g. Ozone (O3), PM2.5, hydroxide (OH), nitrogen dioxide (NO2) etc.) and of reaction rates of chemical reaction OH + NO2. For example, simulated O3 mixing ratio is represented by SpeciesConcVV_O3 in the netCDF files. \r\n\r\nFiles are COARDS compliant NetCDF generated by GEOS-Chem v14.2.2 to explore the global and regional impacts of changes to the OH+NO2 rate. There are 3 sets of data which each contain model output driven by two chemical mechanisms: standard mechanism in GCHP14.2.2 (directories starting 'STD_') and new mechanism with an updated rate constant (directories starting 'New_'). The calculation of reaction rate of OH+NO2 in new mechanism is updated based on the most recent measurements from JPL (NASA Jet Propulsion Laboratory). More details can be found in Winiberg et al., 2024.\r\n\r\nThe 3 sets of data included:\r\n1) Global monthly means from July 2021 to June 2022 at C48 resolution (~200km grid resolution) on 72 vertical levels (directories STD_Global/, New_Global/)\r\n\r\n2) The same but with anthropogenic emissions switched off to represent the preindustrial (directories STD_Global_anthOFF/, New_Global_anthOFF/)\r\n\r\n3) Global hourly values at the surface for July 2022 at C200 with a Stretch Factor of 2 centred on Asia (20°N 98°E)  (~25km grid resolution)  (directories STD_nested_surface_level/, New_nested_surface_level/)\r\n\r\nThe file names generally follows GEOS-Chem naming convention GEOSChem.DefaultCollection.YYYYMMDD_HHMMz.nc4. YYYY, MM, DD, HH, MM represent year, month, day, hour and minute. Z means UTC here. Surface data file has an extension (Surface_level_) at the beginning of the filename, which is manually added by Hansen Cao et al. to differentiate from the files for all vertical layers.\r\n\r\nThe modelling was done by Hansen Cao, Killian Murphy and Mat Evans at the University of York.\r\n\r\nCOARDS stands for the Cooperative Ocean/Atmosphere Research Data Service and are a set of conventions for the standardization of NetCDF files.",
    "keywords": "OH, NO2, BLEACH, GEOSChem",
    "publicationState": "citable",
    "dataPublishedTime": "2024-09-05T14:54:58",
    "doiPublishedTime": "2024-09-06T07:59:53.682902",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43170/?format=api",
        "dataPath": "/badc/deposited2024/BLEACH/v20240830/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 93502422864,
        "numberOfFiles": 1490,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11869/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4581/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "The data was generated by Hansen Cao, Killian Murphy and Mat Evans at University of York on the University of York Viking cluster.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/13181/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/43168/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205122/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205109/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205111/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205112/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205113/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205114/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205116/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205117/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/205118/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43169/?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": []
}