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

{
    "ob_id": 38244,
    "uuid": "572c9744ddab47fc8a5b938c4a4f7387",
    "title": "Chapter 6 of the Working Group I Contribution to the IPCC Sixth Assessment Report - data for Figure 6.21 (v20220928)",
    "abstract": "Data for Figure 6.21 from Chapter 6 of the Working Group I (WGI) Contribution to the Intergovernmental Panel on Climate Change (IPCC) Sixth Assessment Report (AR6).\r\n\r\nFigure 6.21 shows future changes in regional five-year mean surface PM2.5 from 2015 to 2100 in different shared socio-economic pathways (SSPs).\r\n\r\n\r\n---------------------------------------------------\r\n How to cite this dataset\r\n ---------------------------------------------------\r\n When citing this dataset, please include both the data citation below (under 'Citable as') and the following citation for the report component from which the figure originates:\r\n Szopa, S., V. Naik, B. Adhikary, P. Artaxo, T. Berntsen, W.D. Collins, S. Fuzzi, L. Gallardo, A. Kiendler-Scharr, Z. Klimont, H. Liao, N. Unger, and P. Zanis, 2021: Short-Lived Climate Forcers. In Climate Change 2021: The Physical Science Basis. Contribution of Working Group I to the Sixth Assessment Report of the Intergovernmental Panel on Climate Change [Masson-Delmotte, V., P. Zhai, A. Pirani, S.L. Connors, C. Péan, S. Berger, N. Caud, Y. Chen, L. Goldfarb, M.I. Gomis, M. Huang, K. Leitzell, E. Lonnoy, J.B.R. Matthews, T.K. Maycock, T. Waterfield, O. Yelekçi, R. Yu, and B. Zhou (eds.)]. Cambridge University Press, Cambridge, United Kingdom and New York, NY, USA, pp. 817–922, doi:10.1017/9781009157896.008.\r\n\r\n\r\n---------------------------------------------------\r\n Figure subpanels\r\n ---------------------------------------------------\r\n The figure has 11 panels with data provided for all panels in three files placed in the main directory.\r\n\r\n\r\n---------------------------------------------------\r\n List of data provided\r\n ---------------------------------------------------\r\n This dataset contains precomputed values of surface PM2.5 concentrations across world regions for:\r\n \r\n - A 10-year mean period (2005 to 2014) from the historical simulation to represent present day regional mean values. Regional multi-model annual mean and standard deviation values are calculated across 5 different CMIP6 models\r\n - Annual 5-year multi-model mean values of surface PM2.5 from 5 different CMIP6 models projected for 7 different future scenarios covering the period 2015 to 2100\r\n - Standard deviation values of surface PM2.5 from 5 different CMIP6 models projected for 7 different future scenarios covering 5-year mean periods from 2015 to 2100\r\n\r\nCMIP6 is the sixth phase of the Coupled Model Intercomparison Project.\r\nPM2.5 refers to fine particulate matter air pollution with diameter of less than 2.5 microns.\r\nSSP stands for Shared Socioeconomic Pathway.\r\n\r\n---------------------------------------------------\r\n Data provided in relation to figure\r\n ---------------------------------------------------\r\n All the data files provided are used to create the time series plots for each region. The numbers in each panel for each region are obtained from 'Surf_PM2pt5_data_05_14_mean_for_IPCC_figure_V1_5mods.csv', with the time series line for each scenario from 'Surf_PM2pt5_data_fut_mean_for_IPCC_figure_V1_5mods.csv' and the shading obtained by using the values in 'Surf_PM2pt5_SD_data_fut_mean_for_IPCC_figure_V1_5mods.csv'.\r\n\r\n\r\n---------------------------------------------------\r\n Notes on reproducing the figure from the provided data\r\n ---------------------------------------------------\r\n The plotting code that is provided along with this dataset should just be able to read in each of the precomputed regional mean .csv files and then reproduce the time series figures.\r\n\r\n\r\n---------------------------------------------------\r\n Sources of additional information\r\n ---------------------------------------------------\r\n The following weblinks are provided in the Related Documents section of this catalogue record:\r\n - Link to the figure on the IPCC AR6 website\r\n - Link to the report component containing the figure (Chapter 6)\r\n - Link to the Supplementary Material for Chapter 6, which contains details on the input data used in Table 6.SM.3\r\n - Link to the code for the figure, archived on Zenodo.",
    "keywords": "IPCC-DDC, IPCC, AR6, WG1, WGI, Sixth Assessment Report, Working Group 1, Physical Science Basis, Air quality, Climate, PM2.5, CMIP6, Models",
    "publicationState": "citable",
    "dataPublishedTime": "2023-02-14T10:17:21",
    "doiPublishedTime": "2023-03-22T10:27:44.389307",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/38245/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_06/ch6_fig21/v20220928",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 44000,
        "numberOfFiles": 6,
        "fileFormat": "Data are csv formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10538/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3651/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data produced by Intergovernmental Panel on Climate Change (IPCC) authors and supplied for archiving at the Centre for Environmental Data Analysis (CEDA) by the Technical Support Unit (TSU) for IPCC Working Group I (WGI).\r\nData curated on behalf of the IPCC Data Distribution Centre (IPCC-DDC).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12423/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/32705/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/32721/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182127/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182128/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182129/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182130/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182131/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182132/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182133/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182134/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182135/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182136/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/38246/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}