Observation Instance – Django REST framework

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/40843/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 40843,
    "uuid": "7fc9df8070d34cacab8092e45ef276f1",
    "title": "ESA Lakes Climate Change Initiative (Lakes_cci):  Lake products, Version 2.1",
    "abstract": "This dataset contains the Lakes Essential Climate Variable, which is comprised of processed satellite observations at the global scale, over the period 1992-2022, for over 2000 inland water bodies. This dataset was produced by the European Space Agency (ESA) Lakes Climate Change Initiative (Lakes_cci) project. For more information about the Lakes_cci please visit the project website. \r\n\r\nThis is version 2.1.0 of the dataset.\r\n\r\nThe six thematic climate variables included in this dataset are:\r\n• Lake Water Level (LWL), derived from satellite altimetry, is fundamental to understand the balance between water inputs and water loss and their connection with regional and global climate change.\r\n• Lake Water Extent (LWE), modelled from the relation between LWL and high-resolution spatial extent observed at set time-points, describes the areal extent of the water body. This allows the observation of drought in arid environments, expansion in high Asia, or impact of large-scale atmospheric oscillations on lakes in tropical regions for example. .\r\n• Lake Surface Water temperature (LSWT), derived from optical and thermal satellite observations, is correlated with regional air temperatures and is informative about vertical mixing regimes, driving biogeochemical cycling and seasonality.\r\n• Lake Ice Cover (LIC), determined from optical observations, describes the freeze-up in autumn and break-up of ice in spring, which are proxies for gradually changing climate patterns and seasonality.\r\n• Lake Water-Leaving Reflectance (LWLR), derived from optical satellite observations, is a direct indicator of biogeochemical processes and habitats in the visible part of the water column (e.g. seasonal phytoplankton biomass fluctuations), and an indicator of the frequency of extreme events (peak terrestrial run-off, changing mixing conditions).\r\n• Lake Ice Thickness (LIT), containing LIT information over Great Slave lake from 2002-2022.\r\n\r\nData generated in the Lakes_cci are derived from multiple satellite sensors including: TOPEX/Poseidon, Jason, ENVISAT, SARAL, Sentinel 2-3, Landsat 4, 5, 7 and 8, ERS-1, ERS-2, Terra/Aqua and Metop-A/B.\r\n\r\nSatellite sensors associated with the thematic climate variables are as follows:\r\nLWL: TOPEX/Poseidon, Jason-1, Jason-2, Jason-3, Sentinel-6A, Envisat RA/RA-2, SARAL AltiKa, GFO, Sentinel-3A SRAL, Sentinel-3B SRAL, ERS-1 RA, ERS-2; \r\nLWE: Landsat 4 TM, 5 TM, 7 ETM+, 8 OLI, Sentinel-1 C-band SAR, Sentinel-2 MSI, Sentinel-3A SRAL, Sentinel-3B SRAL, ERS-1 AMI, ERS-2 AMI;\r\nLSWT: Envisat AATSR, Terra/Aqua MODIS, Sentinel-3A ATTSR-2, Sentinel-3B, ERS-2 AVHRR, Metop-A/B; \r\nLIC: Terra/Aqua MODIS; \r\nLWLR: Envisat MERIS, Sentinel-3A OLCI A/B, Aqua MODIS;\r\nLIT: Jason1, Jason2, Jason3, POSEIDON-2, POSEIDON-3 and POSEIDON-3B.\r\n\r\nDetailed information about the generation and validation of this dataset is available from the Lakes_cci documentation available on the project website  and in Carrea, L., Crétaux, JF., Liu, X. et al. Satellite-derived multivariate world-wide lake physical variable timeseries for climate studies. Sci Data 10, 30 (2023). https://doi.org/10.1038/s41597-022-01889-z",
    "keywords": "ESA, CCI, Lakes, ECV",
    "publicationState": "citable",
    "dataPublishedTime": "2024-04-03T07:13:21",
    "doiPublishedTime": "2024-04-04T11:18:24",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41532/?format=api",
        "dataPath": "/neodc/esacci/lakes/data/lake_products/L3S/v2.1/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 824251210976,
        "numberOfFiles": 11058,
        "fileFormat": "netCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11603/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2623/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/8143/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/8144/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12066/?format=api",
        "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/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68335/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68336/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68337/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68339/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68340/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68341/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68342/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68343/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68344/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68345/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68346/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68347/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68348/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68349/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68350/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68351/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68352/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68353/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68354/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68355/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68356/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68357/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68358/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68359/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68360/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68361/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68362/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68363/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84538/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84539/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84540/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84541/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84544/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84545/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84546/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84547/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84549/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84550/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84553/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84556/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84557/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84558/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84560/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84562/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84563/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84564/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84565/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84566/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84567/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84568/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84572/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84574/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84575/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84577/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84585/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84600/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84698/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84699/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84700/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84701/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84702/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84703/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84704/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/84705/?format=api"
    ],
    "dataLineage": "This dataset was generated in the framework of the Lakes CCI+ project, funded by ESA. Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12856/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/30309/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198627/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/202190/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198637/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198638/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198639/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198640/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198642/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198643/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198644/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198645/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/32839/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2631/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_lakes_terms_and_conditions.pdf",
            "licenceClassifications": ""
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}