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

{
    "ob_id": 38908,
    "uuid": "f3b6afe197d24d7eb58ed2364ac0f18e",
    "title": "Technical Summary of the Working Group I Contribution to the IPCC Sixth Assessment Report - Input data for Figure TS.13 v20221111",
    "abstract": "Input data for Figure TS.13 from the Technical Summary of the Working Group I (WGI) Contribution to the Intergovernmental Panel on Climate Change (IPCC) Sixth Assessment Report (AR6).\r\n\r\nFigure TS.13 shows estimates of the net cumulative energy change for the period 1971–2018 associated with observations of changes in the Global Energy Inventory, Integrated Radiative Forcing and Integrated Radiative Response.\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\nArias, P.A., N. Bellouin, E. Coppola, R.G. Jones, G. Krinner, J. Marotzke, V. Naik, M.D. Palmer, G.-K. Plattner, J. Rogelj, M. Rojas, J. Sillmann, T. Storelvmo, P.W. Thorne, B. Trewin, K. Achuta Rao, B. Adhikary, R.P. Allan, K. Armour, G. Bala, R. Barimalala, S. Berger, J.G. Canadell, C. Cassou, A. Cherchi, W. Collins, W.D. Collins, S.L. Connors, S. Corti, F. Cruz, F.J. Dentener, C. Dereczynski, A. Di Luca, A. Diongue Niang, F.J. Doblas-Reyes, A. Dosio, H. Douville, F. Engelbrecht, V. Eyring, E. Fischer, P. Forster, B. Fox-Kemper, J.S. Fuglestvedt, J.C. Fyfe, N.P. Gillett, L. Goldfarb, I. Gorodetskaya, J.M. Gutierrez, R. Hamdi, E. Hawkins, H.T. Hewitt, P. Hope, A.S. Islam, C. Jones, D.S. Kaufman, R.E. Kopp, Y. Kosaka, J. Kossin, S. Krakovska, J.-Y. Lee, J. Li, T. Mauritsen, T.K. Maycock, M. Meinshausen, S.-K. Min, P.M.S. Monteiro, T. Ngo-Duc, F. Otto, I. Pinto, A. Pirani, K. Raghavan, R. Ranasinghe, A.C. Ruane, L. Ruiz, J.-B. Sallée, B.H. Samset, S. Sathyendranath, S.I. Seneviratne, A.A. Sörensson, S. Szopa, I. Takayabu, A.-M. Tréguier, B. van den Hurk, R. Vautard, K. von Schuckmann, S. Zaehle, X. Zhang, and K. Zickfeld, 2021: Technical Summary. 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. 33−144, doi:10.1017/9781009157896.002.\r\n\r\n---------------------------------------------------\r\nFigure subpanels\r\n---------------------------------------------------\r\nThe figure has 6 subpanels, with input data provided for panels a-f.\r\n\r\n---------------------------------------------------\r\nList of data provided\r\n---------------------------------------------------\r\nThis dataset contains:\r\n\r\n- Estimates of the net cumulative energy change (ZJ = 1021 Joules) for the period 1971–2018 associated with:\r\n(a) observations of changes in the Global Energy Inventory\r\n(b) Integrated Radiative Forcing;\r\n(c) Integrated Radiative Response.\r\n\r\nBlack dotted lines indicate the central estimate with likely and very likely ranges as indicated in the legend. The grey dotted lines indicate the energy change associated with an estimated pre-industrial Earth energy imbalance of 0.2 W m–2 (a), and an illustration of an assumed pattern effect of –0.5 W m–2 °C–1 (c).\r\n\r\nBackground grey lines indicate equivalent heating rates in W m–2 per unit area of Earth’s surface.\r\nPanels (d) and (e) show the breakdown of components, as indicated in the legend, for the global energy inventory and integrated radiative forcing, respectively. Panel (f) shows the global energy budget assessed for the period 1971–2018, that is, the consistency between the change in the global energy inventory relative to pre-industrial and the implied energy change from integrated radiative forcing plus integrated radiative response under a number of different assumptions, as indicated in the legend, including assumptions of correlated and uncorrelated uncertainties in forcing plus response.\r\n\r\nShading represents the very likely range for observed energy change relative to pre-industrial levels and likely range for all other quantities.\r\nForcing and response time series are expressed relative to a baseline period of 1850–1900.\r\n\r\nFurther details on data sources and processing are available in the chapter data table (Table 7.SM.14).\r\n\r\n---------------------------------------------------\r\nData provided in relation to figure\r\n---------------------------------------------------\r\nData provided in relation to Figure TS.13:\r\n\r\n- Data file: AR6_ERF_1750-2019.csv\r\n- Data file: AR6_energy_GMSL_timeseries_FGD_1971to2018_corrigendum.csv\r\n- Data file: Box7.2_ERF_ZJ_percentiles_FGD_1971to2018.csv\r\n- Data file: Box7.2_Response_ZJ_percentiles_FGD_1971to2018.csv\r\n- Data file: Box7.2_ERFResp_uncorrelated_ZJ_percentiles_FGD_1971to2018.csv\r\n- Data file: Box7.2_ERFResp_correlated_ZJ_percentiles_FGD_1971to2018.csv\r\n\r\nData files are converted to csv from pickle format for archival. A link to the original files on GitHub is provided in the 'Related Documents' section.\r\n\r\n---------------------------------------------------\r\nNotes on reproducing the figure from the provided data\r\n---------------------------------------------------\r\nData and figures are produced by the Jupyter Notebooks that live inside the notebooks directory. Also listed on the 'master' GitHub page linked in the documentation of this catalogue record are external GitHub repositories and locations within the contributed directory where code for figures have been supplied by other authors. These are provided \"as-is\" and are not guaranteed to be reproducible within this environment. For external GitHub locations, check out the relevant repository READMEs.\r\n\r\nThe data provided here is converted from pickle files which are used in the plotting script. The link to the original pickle files on GitHub is provided. To reproduce the figure from the input data provided, you will need to edit the filepaths within the notebook based on your local directory structure.\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 (Technical Summary)\r\n - Link to the Supplementary Material for Chapter 7, which contains details on the input data used in Table 7.SM.1 to 7.SM.7.\r\n - Link to the notebook to plot the figure on the Chapter 7 GitHub repository\r\n - Link to the original pickle files on GitHub\r\n - Link to the code for the figure, archived on Zenodo.\r\n - Link to Cross-Chapter Box 9.1, Figure 1",
    "keywords": "IPCC-DDC, IPCC, AR6, WG1, WGI, Sixth Assessment Report, Working Group 1, Physical Science Basis, ocean heat content, energy budget, ocean, cryosphere, land, effective radiative forcing, ERF",
    "publicationState": "citable",
    "dataPublishedTime": "2023-06-07T12:59:23",
    "doiPublishedTime": "2023-07-27T13:57:55.161597",
    "updateFrequency": "",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/40155/?format=api",
        "dataPath": "/badc/ar6_wg1/data/TS/inputdata_ts_13/v20221111/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 165019,
        "numberOfFiles": 9,
        "fileFormat": "CSV"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10474/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?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/12656/?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/39213/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187078/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187083/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187079/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187080/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187081/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187082/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187084/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187085/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187086/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/187087/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/40098/?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": []
}