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

{
    "ob_id": 37785,
    "uuid": "ef3dd7efa4f442b2812c4ee905f794c2",
    "title": "Chapter 8 of the Working Group I Contribution to the IPCC Sixth Assessment Report - data for Figure 8.26 (v20220718)",
    "abstract": "Data for Figure 8.26 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\nFigure 8.26 shows the rate of change in basin-scale annual mean runoff with increasing global warming levels.\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 There is one single NetCDF file for data for all panels.\r\n\r\n---------------------------------------------------\r\n List of data provided\r\n ---------------------------------------------------\r\n This dataset contains relative changes (%) in basin-averaged annual mean runoff estimated as multi-model ensemble median from a variable subset of CMIP6 models for each SSP over nine major river basins:\r\n \r\n - Mississippi (a),\r\n - Danube (b),\r\n - Lena (c),\r\n - Amazon (d),\r\n - Euphrates (e),\r\n - Yangtze (f),\r\n - Niger (f),\r\n - Indus (g),\r\n - Murray (h).\r\n\r\n---------------------------------------------------\r\n Data provided in relation to figure\r\n ---------------------------------------------------\r\n The NetCDF file contains a multi-dimensionnal variable 'mrro_mean' which matches the various curves showing in the figure. These are parametric curves, and the parameter is a period index. The file also contains a variable 'tas' for the value of global warming for the period, for each scenario.\r\n  \r\n Dimension 'period' is a period index, which is the parameter for the parametric curves linking variables 'mrro_mean' and 'tas'. Period value 1 stands for 1901-1920, 2 for 1911-1920 ...,\r\n \r\n Dimension ssp is the SSP index, for that order : ssp585 ,  ssp245 , ssp126.\r\n \r\n Variable 'tas' is the change of globally averaged surface temperature w.r.t. 1850-1900 average, indexed by period.\r\n \r\n Variable mrro_mean provide statistics of relative changes (%) of runoff in basin-averaged annual mean runoff. The basin averages have been estimated after a first-order conservative remapping of the model outputs on the 0.5° by 0.5° river network of  (Decharme et al., 2019). It is indexed by  :\r\n             - dimension 'stats' for statistics over a CMIP6 multi-model ensemble, in that order : percentile 5, mean, and percentile 95,\r\n             - dimension 'basin' for this ordered list : Mississippi, Danube, Lena, Amazon, Euphrates, Yangtze, Niger, Indus, Murray\r\n \r\n Variable mrro_std is not used in the figure.\r\n\r\nCMIP6 is the sixth phase of the Coupled Model Intercomparison Project.\r\n SSP stands for Shared Socioeconomic Pathway.\r\n SSP126 is the Shared Socioeconomic Pathway which represents the lower boundary of radiative forcing and development scenarios, consistent with RCP2.6.\r\n SSP245 is the Shared Socioeconomic Pathway which represents the median of radiative forcing and development scenarios, consistent with RCP4.5.\r\n SSP585 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 Notes on reproducing the figure from the provided data\r\n ---------------------------------------------------\r\n Curves are parametric curves. The parameter is the period index.\r\n\r\n So each curve for a given statistics 'stat', scenario 'ssp' and basin 'basin' is defined by varying period_index in:\r\n \r\n x=tas(ssp,period_index),\r\n \r\n y=mrro_mean(ssp, basin, stat, period_index)\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 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, runoff, runoff change, runoff rate of change, runoff change with warming, basin runoff, multi-model, scenarios, Mississipi , Danube, Lena, Amazon, Euphrates, Yangtze, Niger, Indus, Murray",
    "publicationState": "citable",
    "dataPublishedTime": "2023-01-25T15:46:36",
    "doiPublishedTime": "2023-05-15T12:37:10.660000",
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37786/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_08/ch8_fig26/v20220718",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 29728,
        "numberOfFiles": 4,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10439/?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/63567/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63568/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63569/?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\n Data 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/12486/?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/180284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180288/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180290/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180291/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/37787/?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": []
}