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

{
    "ob_id": 37779,
    "uuid": "b03a4577108545c2a05bbae2d9759f9d",
    "title": "Chapter 8 of the Working Group I Contribution to the IPCC Sixth Assessment Report - data for Figure 8.21 (v20220718)",
    "abstract": "Data for Figure 8.21 from Chapter 8 of the Working Group I (WGI) Contribution to the Intergovernmental Panel on Climate Change (IPCC) Sixth Assessment Report (AR6).\r\n\r\n\r\nFigure 8.21 is a schematic depicting understanding of large-scale circulation changes and effects of the regional water cycle.\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 Douville, H., K. Raghavan, J. Renwick, R.P. Allan, P.A. Arias, M. Barlow, R. Cerezo-Mota, A. Cherchi, T.Y. Gan, J. Gergis, D. Jiang, A. Khan, W. Pokam Mba, D. Rosenfeld, J. Tierney, and O. Zolina, 2021: Water Cycle Changes. 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. 1055–1210, doi:10.1017/9781009157896.010.\r\n\r\n---------------------------------------------------\r\n Figure subpanels\r\n ---------------------------------------------------\r\n The three maps subpanels in the middle of the figure have data provided in panel-specific sub-directories.\r\n\r\n---------------------------------------------------\r\n List of data provided\r\n ---------------------------------------------------\r\n This dataset contains:\r\n \r\n - Precipitation minus evaporation (P–E) changes at 3°C of global warming relative to an 1850–1900 base period (mean of 23 CMIP6 SSP5-8.5 simulations) for:\r\n . Annual mean changes\r\n . Seasonal mean changes (DJF, JJA)\r\n \r\n - Precipitation minus evaporation (P–E) climatology (annual mean, 1850-1900).\r\n\r\n---------------------------------------------------\r\n Data provided in relation to figure\r\n ---------------------------------------------------\r\n The map for the annual case (subdir ANN) has two data files :\r\n 1. One for the colored , P-E change, field :\r\n - Fig8-21_ANN_P-E_mean-change_ssp585_ANN_1850-1900_plus3K.nc\r\n \r\n 2. One for the P-E climatology (for red isoline 0) :\r\n - Fig8-21_ANN_P-E_mean_piControl_ANN_1850-1900_.nc. The solid and dashed contours are isolines 0 of that data, masked out over continents. The decision between solid and dashed line is a manual one, based on the latitude of the line. \r\n\r\nThe seasonal panels (subdirs DJF and JJA) have a single file for the colored, P-E change, field.\r\npanel_DJF: Fig8-21_DJF_P-E_mean-change_ssp585_DJF_1850-1900_plus3K.nc\r\npanel_JJA: Fig8-21_JJA_P-E_mean-change_ssp585_JJA_1850-1900_plus3K.nc\r\n\r\nCLARIFICATION: The following file names have been changed from the original, for the purposes of conforming to the file naming standards for the CEDA catalogue. \r\n- panel_ANN: Fig8-21_ANN_P-E_mean-change_ssp585_ANN_1850-1900_+3K.nc ->  Fig8-21_ANN_P-E_mean-change_ssp585_ANN_1850-1900_plus3K.nc\r\n- panel_DJF: Fig8-21_DJF_P-E_mean-change_ssp585_DJF_1850-1900_+3K.nc -> Fig8-21_DJF_P-E_mean-change_ssp585_DJF_1850-1900_plus3K.nc\r\n- panel_JJA: Fig8-21_JJA_P-E_mean-change_ssp585_JJA_1850-1900_+3K.nc -> Fig8-21_JJA_P-E_mean-change_ssp585_JJA_1850-1900_plus3K.nc\r\n\r\nCMIP6 is the sixth phase of the Coupled Model Intercomparison Project.\r\nSSP585 is the Shared Socioeconomic Pathway which represents the upper boundary of radiative forcing and development scenarios, consistent with RCP8.5.\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 8)\r\n - Link to the Supplementary Material for Chapter 8, which contains details on the input data used in Table 8.SM.1\r\n - Link to the code for all figures in Chapter 8, archived on Zenodo.\r\n - Link to the documentation for CAMMAC, the tool used for AR6 analysis.",
    "keywords": "IPCC-DDC, IPCC, AR6, WG1, WGI, Sixth Assessment Report, Working Group 1, Physical Science Basis, precipitation, evaporation, change, scenario, P-E",
    "publicationState": "citable",
    "dataPublishedTime": "2023-01-25T15:28:05",
    "doiPublishedTime": "2023-05-15T12:30:42.127715",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37780/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_08/ch8_fig21/v20220718",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1092598,
        "numberOfFiles": 7,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10437/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63570/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63571/?format=api"
    ],
    "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/12484/?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/32723/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180264/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180265/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180266/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180267/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180268/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180269/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180270/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180271/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/37781/?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": []
}