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

{
    "ob_id": 37824,
    "uuid": "f94821849dfb4ee2bd1a367a81a6b6f7",
    "title": "Chapter 7 of the Working Group I Contribution to the IPCC Sixth Assessment Report - Input data for Figure 7.21 (v20220721)",
    "abstract": "Input Data for Figure 7.21 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\nFigure 7.21 shows emissions metrics for two short-lived greenhouse gases: HFC-32 and methane (CH4; lifetimes of 5.4 and 11.8 years). \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 4 subpanels, with data provided for panels a-d.\r\n\r\n---------------------------------------------------\r\n List of data provided\r\n ---------------------------------------------------\r\n This dataset contains:\r\n\r\n- Emissions metrics for HFC-32 and methane (CH4):\r\n(a) Temperature response to a step change in short-lived greenhouse gas emissions. \r\n(b) Temperature response to a pulse CO2 emission. \r\n(c) Conventional GTP metrics (pulse vs pulse). \r\n(d) Combined GTP metric (step versus pulse). \r\n\r\nThe temperature response function comes from Supplementary Material 7.SM.5.2. Values for non-CO2 species include the carbon cycle response (Section 7.6.1.3). Results for HFC-32 have been divided by 100 to show on the same scale. \r\n\r\nFurther details on data sources and processing are available in the chapter data table (Table 7.SM.14).\r\n\r\nGTP stands for Global Temperature-change Potential.\r\n\r\n---------------------------------------------------\r\n Data provided in relation to figure\r\n ---------------------------------------------------\r\n Data provided in relation to Figure 7.21:\r\n \r\n - Data file: cgtp.csv\r\n\r\nThe data in this files is identical to the original data in .npz format. Link to the orginal data in this format used with the code for reproducing the figure 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 of the Chapter 7 GitHub repository. The link to the input .npz file provided is used in the notebook to output figure 7.21. To reproduce the figure from the input data, you will need to run the notebook from the same directory as the input data and adjust the path to the data in box 3.\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 original data in .npz format used in the code\r\n - Link to the code for the figure, archived on Zenodo.\r\n - Link to the notebook on the Chapter 7 GitHub repository for plotting the figure",
    "keywords": "IPCC-DDC, IPCC, AR6, WG1, WGI, Sixth Assessment Report, Working Group 1, Physical Science Basis, metrics, step, pulse, GTP, CGTP, HFC-32, CH4, methane",
    "publicationState": "citable",
    "dataPublishedTime": "2023-06-01T11:01:06",
    "doiPublishedTime": "2023-07-10T14:50:20.257961",
    "updateFrequency": "",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/38065/?format=api",
        "dataPath": "/badc/ar6_wg1/data/ch_07/inputdata_ch7_fig21/v20220721",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 58873,
        "numberOfFiles": 4,
        "fileFormat": "CSV"
    },
    "timePeriod": null,
    "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 format for archival from original .npz format by CEDA Staff.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12643/?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/180460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180461/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180462/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180463/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180464/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180465/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180487/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/180609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195204/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/39595/?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": []
}