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

{
    "ob_id": 41674,
    "uuid": "235e3307338c4168816871a314eada4f",
    "title": "ECMWF SEAS5 seasonal forecast output - case study of summer 2022",
    "abstract": "This dataset contains the output of three fully coupled seasonal forecast experiments performed as a case study of summer 2022, using the same model setup as ECWMF seasonal forecast system 5 (SEAS5), as presented in the paper Patterson, M., Befort, D., O'Reilly, C., Weisheimer, A. \"The ECMWF SEAS5 seasonal forecast of the hot and dry European summer of 2022\" Quarterly Journal of the Royal Meteorological Society, https://doi.org/10.1002/qj.4851\r\n​\r\n​The three experiments are:\r\n1) CONTROL\r\nA coupled hindcast ensemble with perturbed initial conditions for the 2022 summer, identical to the operational hindcast with the start date 1st May,  but for 200 members rather than 51.\r\n2) ATMOS-IC-2022\r\nSimilar to the CONTROL with 2022 initial conditions for the atmosphere and land surface and 2022 concentrations of carbon dioxide, but with ocean initial conditions taken from a year in 1981-2021. Five perturbed initial condition states taken for each year hence, 41 x 5 = 205 members.\r\n3) OCEAN-IC-2022\r\nSimilar to CONTROL with 2022 initial conditions for the ocean, but with initial atmosphere, land surface and carbon dioxide conditions taken from a year in 1981-2021. Like ATMOS-IC-2022, 41 x 5 = 205 members.\r\n​\r\nThe OCEAN-IC-2022 experiments were performed by taking the setup for hindcasts 1981-2021 and swapping the ocean initial conditions for 2022. The time dimension therefore corresponds to the time of the base hindcast taken from 1981-2021. Conversely, the ATMOS-IC-2022 were performed by running the 2022 hindcast and swapping the ocean initial conditions for other years. The time dimension for ATMOS-IC-2022 therefore is identical for all members. Hindcasts are all started on 1st May and run for four months.\r\n\r\nThe data stored is monthly-mean output from the experiments with the following directory structure\r\nfor variables on pressure levels:\r\n[experiment_name]/pl/[experiment_name]_[ensemble_member_number]_pl_[level]hPa.nc\r\n\r\nand for those on a single level or at the surface:\r\n[experiment_name]/sfc/[experiment_name]_[ensemble_member_number]_sfc.nc\r\n\r\nThe files each contain multiple variables. Variables on pressure levels are stored at 700hPa,500hPa and 250hPa levels.\r\n\r\nPressure level variables stored are:\r\nu (zonal wind), v (meridional wind), t (air temperature), z (geopotential), q (specific humidity)\r\n\r\nSurface variables stored are:\r\nsst (sea surface temperature), swvl1 (Volumetric soil water layer 1), swvl2 (Volumetric soil water layer 2), swvl3 (Volumetric soil water layer 3), swvl4 (Volumetric soil water layer 4), msl (air pressure at mean sea level), t2m (2m temperature), tprate (mean total precipitation rate).",
    "keywords": "Seasonal forecasts,Climate prediction,Climate modelling,Europe",
    "publicationState": "published",
    "dataPublishedTime": "2024-06-05T09:56:16",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41687/?format=api",
        "dataPath": "/badc/deposited2024/Seasonal_forecasts_of_JJA_2022/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 30100841472,
        "numberOfFiles": 2442,
        "fileFormat": "Contact support@ceda.ac.uk for file format information."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11681/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4400/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "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/62645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68861/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69027/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69030/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69031/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69032/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75130/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75131/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75132/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75133/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75134/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75135/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75136/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75137/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75138/?format=api"
    ],
    "dataLineage": "The data were produced using the same model setup as ECWMF seasonal forecast system 5 (SEAS5) on the ECMWF ATOS system.  Data were produced by the project team before archival at CEDA.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/41675/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203432/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203075/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203080/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203071/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203073/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203076/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203074/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203082/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203081/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203083/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/41676/?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"
        }
    ]
}