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

{
    "ob_id": 41662,
    "uuid": "667a2328d2b04f02b653569975f53f55",
    "title": "Greenland 1980 and 2010s landcover grids from Landsat 5 and Landsat 8",
    "abstract": "This dataset consists of two landcover grids representing Greenland in the late 1980s and late 2010s, utilising Landsat 5 Thematic Mapper Top-Of-Atmosphere (TM TOA) and Landsat 8 Operational Land Imager Top-Of-Atmosphere (OLI TOA) imagery respectively. \r\nThe data creation involved rigorous preprocessing and image classification methodologies, detailed extensively in the paper by Grimes, M., Carrivick, J.L., Smith, M.W., et al. (2024), \"Land cover changes across Greenland dominated by a doubling of vegetation in three decades,\" Sci Rep, 14, 3120. DOI: 10.1038/s41598-024-52124-1. The full methodology is also discussed in the supplementary material of the publication.\r\n\r\nThe resultant .tif grids are in integer format with values from 1 to 9 representing landcover class:\r\n1 - Bad data/Cloud/Shadow\r\n2 - Snow and Ice\r\n3 - Wet ice and meltwater\r\n4 - Freshwater\r\n5 - Coarse sediment\r\n6 - Fine-grained sediment\r\n7 - Bedrock\r\n8 - Tundra vegetation\r\n9 - Dense/wet vegetation\r\nThe tif grids were produced using Google Earth Engine. All summer Landsat imagery was filtered by metadata, followed by topographical correction, resulting in a best-pixel mosaic for Greenland's periphery. Band ratios (NDSI, NDVI, NDWI) were computed and stacked with visible, NIR, and SWIR bands. A principal component analysis was conducted, retaining the first six principal components as bands, which were subsequently classified using a K-means clusterer and refined with a supervised random-forest classifier and a slope threshold was applied to discriminate shadows from dark water bodies more effective.\r\nThis dataset was generated through a NERC-funded PhD project at the University of Leeds (Grant NE/L002574/1).",
    "keywords": "landcover,classification,greenland,climate",
    "publicationState": "published",
    "dataPublishedTime": "2024-06-13T15:43:14",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/42318/?format=api",
        "dataPath": "/badc/deposited2024/Greenland_Landcover_Grids/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 924202091,
        "numberOfFiles": 3,
        "fileFormat": "TIF files"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11665/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4396/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "The data creation involved rigorous preprocessing and image classification methodologies and the full methodology is discussed in the supplementary material of the publication Grimes, M., Carrivick, J.L., Smith, M.W., et al. (2024), \"Land cover changes across Greenland dominated by a doubling of vegetation in three decades,\" Sci Rep, 14, 3120. DOI: 10.1038/s41598-024-52124-1.\r\nBriefly, the tif grids were produced using Google Earth Engine. All summer Landsat imagery was filtered by metadata, followed by topographical correction, resulting in a best-pixel mosaic for Greenland's periphery. Band ratios (NDSI, NDVI, NDWI) were computed and stacked with visible, NIR, and SWIR bands. A principal component analysis was conducted, retaining the first six principal components as bands, which were subsequently classified using a K-means clusterer and refined with a supervised random-forest classifier and a slope threshold was applied to discriminate shadows from dark water bodies more effective.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/41663/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203927/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203011/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/203021/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/42320/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}