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

{
    "ob_id": 37892,
    "uuid": "568fb4b2e6464a50a30c7140bb88a497",
    "title": "Chapter 7 of the Working Group I Contribution to the IPCC Sixth Assessment Report - Input data for Box 7.2, Figure 1. (v20220817)",
    "abstract": "Input Data for Box 7.2, Figure 1 from Chapter 7 of the Working Group I (WGI) Contribution to the Intergovernmental Panel on Climate Change (IPCC) Sixth Assessment Report (AR6).\r\n\r\nBox 7.2, Figure 1 shows estimates of the net cumulative energy change (ZJ = 1021 Joules) for the period 1971–2018 associated with: (a) observations of changes in the Global Energy Inventory (b) Integrated Radiative Forcing; (c) 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\nForster, P., T. Storelvmo, K. Armour, W. Collins, J.-L. Dufresne, D. Frame, D.J. Lunt, T. Mauritsen, M.D. Palmer, M. Watanabe, M. Wild, and H. Zhang, 2021: The Earth’s Energy Budget, Climate Feedbacks, and Climate Sensitivity. 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. 923–1054, doi:10.1017/9781009157896.009.\r\n\r\n---------------------------------------------------\r\n Figure subpanels\r\n ---------------------------------------------------\r\n The figure has 6 subpanels, with input data provided for panels a-f.\r\n\r\n---------------------------------------------------\r\n List of data provided\r\n ---------------------------------------------------\r\n This 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\n Data provided in relation to figure\r\n ---------------------------------------------------\r\n Data provided in relation to Box 7.2, Figure 1:\r\n \r\n - Data file: AR6_ERF_1750-2019.csv\r\n - Data file: AR6_energy_GMSL_timeseries_FGD_1971to2018_IMBIEupdate.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\n Notes 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 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 7)\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, net cumulative energy change, radiative forcing, radiative response",
    "publicationState": "citable",
    "dataPublishedTime": "2023-06-07T09:38:05",
    "doiPublishedTime": "2023-07-10T15:14:20.512246",
    "updateFrequency": "",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/38057/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_07/inputdata_ch7_BOX2_fig1/v20220817",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 190006,
        "numberOfFiles": 10,
        "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).\r\nData converted to CSV from pickle format for archival by CEDA staff.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12647/?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/32722/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180895/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180896/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180897/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180898/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180899/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180946/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180968/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180969/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195481/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/39600/?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": []
}