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

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

{
    "ob_id": 32139,
    "uuid": "e2c223cdcb4844f9a1ffe9759b61eaf4",
    "title": "ESA Ocean Colour Climate Change Initiative (Ocean_Colour_cci): Global attenuation coefficient for downwelling irradiance (Kd490) gridded on a sinusoidal projection, Version 5.0",
    "abstract": "The ESA Ocean Colour CCI project has produced global, level 3, binned multi-sensor time-series of satellite ocean-colour data with a particular focus for use in climate studies.\r\n\r\nThis dataset contains the Version 5.0 Kd490 attenuation coefficient (m-1) for downwelling irradiance product on a sinusoidal projection at approximately 4 km spatial resolution and at a number of time resolutions (daily, 5-day, 8-day and monthly composites) covering the period 1997 - 2020. It is computed from the Ocean Colour CCI Version 5.0 inherent optical properties dataset at 490 nm and the solar zenith angle. Note, these data are also contained within the 'All Products' dataset. \r\n\r\nThis data product is on a sinusoidal equal-area grid projection, matching the NASA standard level 3 binned projection. The default number of latitude rows is 4320, which results in a vertical bin cell size of approximately 4 km. The number of longitude columns varies according to the latitude, which permits the equal area property. Unlike the NASA format, where the bin cells that do not contain any data are omitted, the CCI format retains all cells and simply marks empty cells with a NetCDF fill value. (A separate dataset is also available for data on a geographic projection).\r\n\r\nPlease note, data from December 2020 onwards are affected by an anomaly discovered after production and resulting in a spurious jump in remote sensing reflectance. The anomaly has been corrected in the version 5.0.1 of the dataset available through the Copernicus Climate Change Service (https://doi.org/10.24381/cds.f85b319d)\r\n\r\nVersion 6.0 of this data is now also available here: https://doi.org/10.5285/5011d22aae5a4671b0cbc7d05c56c4f0",
    "keywords": "ESA, CCI, Ocean Colour, Sinusoidal",
    "publicationState": "published",
    "dataPublishedTime": "2021-05-12T13:11:52",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32150/?format=api",
        "dataPath": "/neodc/esacci/ocean_colour/data/v5.0-release/sinusoidal/netcdf/kd",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1477883149412,
        "numberOfFiles": 11558,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8844/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3301/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3302/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12064/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18488/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18575/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21134/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21135/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/32028/?format=api"
    ],
    "dataLineage": "These data were produced by the ESA Ocean Colour CCI project and provided to CEDA in the context of the ESA CCI Open Data Portal project.\r\nThis dataset forms part of the v5.0 ocean colour dataset collection that can be cited with the following DOI: 10.5285/1dbe7a109c0244aaad713e078fd3059a",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13365/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/32135/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142667/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142666/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142662/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142663/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142959/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142668/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142669/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142670/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142671/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142672/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142673/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142674/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142675/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142676/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142677/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142678/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142679/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142680/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142681/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142682/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142683/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142684/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142686/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142688/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142691/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142692/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142693/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142694/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142695/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142696/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/142697/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/32326/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2538/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_oc_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}