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

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

{
    "ob_id": 39550,
    "uuid": "dde78ab3388a4452b43ffe3e69e91fce",
    "title": "ESA Greenland Ice Sheet Climate Change Initiative (Greenland_Ice_Sheet_cci): Mass flow rate ice discharge (MFID) for Greenland from CCI IV, CCI SEC, and BedMachine v1.0",
    "abstract": "Mass flow rate ice discharge (MFID) for Greenland ice sheet sectors. This data set is part of the ESA Greenland Ice sheet CCI project. \r\n\r\nIt provides the following CSV files: \r\n- Mass flow rate ice discharge. Units are Gt yr^{-1}.\r\n- Mass flow rate ice discharge uncertainty. Units are Gt yr^{-1}.\r\n- Coverage for each sector at each timestamp. Unitless [0 to 1].\r\n\r\nIce discharge is calculated from the CCI Ice Velocity (IV) product, the CCI Surface Elevation Change (SEC) product (where it overlaps with the ice discharge gates), and ice thickness from BedMachine. Ice discharge gates are placed 10 km upstream from all marine terminating glacier termini that have baseline velocities of more than 150 m/yr. Results are summed by Zwally et al. (2012) sectors.\r\n\r\nThe methods, including description of \"coverage\", are described in Mankoff et al. 2020.",
    "keywords": "Greenland, Ice sheet, CCI, ESA",
    "publicationState": "published",
    "dataPublishedTime": "2024-07-08T15:38:25",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43051/?format=api",
        "dataPath": "/neodc/esacci/ice_sheets_greenland/data/greenland_mass_flow_rate_ice_discharge/v1.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 384604,
        "numberOfFiles": 8,
        "fileFormat": "csv, txt, png"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7282/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1650/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Ice discharge is calculated from the CCI Ice Velocity (IV) product, the CCI Surface Elevation Change (SEC) product (where it overlaps with the ice discharge gates), and ice thickness from BedMachine. Ice discharge gates are placed 10 km upstream from all marine terminating glacier termini that have baseline velocities of more than 150 m/yr. Results are summed by Zwally et al. (2012) sectors. The methods, including description of \"coverage\", are described in Mankoff et al. (2020; DOI: 10.5194/essd-12-1367-2020)",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/14317/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/14316/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192849/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192846/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192850/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192845/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/192853/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43079/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2553/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_icesheets_greenland_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}