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

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

{
    "ob_id": 25926,
    "uuid": "8f5623a85d2e4b9b8ab5313f65a7c994",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): Column-averaged CH4 from SCIAMACHY generated with the IMAP-DOAS algorithm (CH4_SCI_IMAP), v7.2",
    "abstract": "The CH4_SCI_IMAP dataset is comprised of level 2, column-averaged dry-air mole fractions (mixing ratios) of methane (CH4).  It has been produced using data acquired from the SWIR spectra (channel 6) of the SCanning Imaging Absorption spectroMeter for Atmospheric CHartographY (SCIAMACHY) on board the European Space Agency's (ESA's) environmental research satellite ENVISAT using the IMAP-DOAS algorithm.   It has been generated as part of ESA Greenhouse Gases Climate Change Initiative (GHG_cci) project.   This version of the dataset is v7.2 and forms part of the Climate Research Data Package 4.\r\n\r\nThe IMAP-DOAS algorithm has been developed at the University of Heidelberg and SRON, and has been applied here to the SCIAMACHY data. This procedure and the algorithms validity are thoroughly described in Frankenberg et al (2011). A second product is also available which has been generated using the Weighting Function Modified DOAS (WFM-DOAS) algorithm. \r\n\r\nThe data product is stored per orbit in a single NetCDF4 file. Retrieval results are provided for the individual SCIAMACHY spatial footprints, no averaging having been applied. The product file contains the key products and information relevant to using the data, such as the vertical layering and averaging kernels. For further details on the product, including the IMAP algorithm and the SCIAMACHY instrument, please see the associated product user guide (PUG) or the Algorithm Theoretical Basis Document.",
    "keywords": "ESA, GHG, CCI, CH4, IMAP",
    "publicationState": "published",
    "dataPublishedTime": "2018-03-19T21:16:29",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25927/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_4/SCIAMACHY/CH4_SCI_IMAP/v7.2/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4783721146,
        "numberOfFiles": 2896,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7003/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11803/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11804/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11819/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13789/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13790/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13791/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13792/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13793/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26288/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26290/?format=api"
    ],
    "dataLineage": "Data were processed by the ESA CCI GHG project team and supplied to CEDA as part of the ESA CCI Open Data Portal Project",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13295/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12808/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108376/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108370/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108371/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108375/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108374/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108372/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108373/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108369/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108377/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/8036/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2564/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_ghg_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}