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

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

{
    "ob_id": 25916,
    "uuid": "e493802d83c846c8b76f817866fb74cc",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG_cci): Column-averaged CO2 from SCIAMACHY generated with the WFMD algorithm (CO2_SCI_WFMD), v4.0",
    "abstract": "The CO2_SCI_WFMD dataset comprises level 2, column-averaged dry-air mole fractions (mixing ratios) of carbon dioxide (XCO2) from the SCanning Imaging Absorption spectroMeter for Atmospheric CHartographY (SCIAMACHY) on board the European Space Agency's environmental research satellite ENVISAT.   It has been produced using the Weighting Function Modified DOAS (WFM-DOAS) algorithm, by the ESA Greenhouse Gases Climate Change Initiative (GHG_cci) project.\r\n\r\nThe WFM-DOAS algorithm is a least-squares method based on scaling pre-selected atmospheric vertical profiles.  Note that this has been designated as an 'alternative' algorithm for the GHG_cci and another XCO2 product has also been generated from the SCIAMACHY data using the baseline algorithm (the Bremen Optimal Estimation DOAS (BESD) algorithm).  It is advised that users who aren't sure whether to use the baseline or alternative product use the product generated with the BESD baseline algorithm. For more information regarding the differences between baseline and alternative algorithms please see the GHG-CCI data products webpage. \r\n\r\nThe data product is stored per day in seperate NetCDF-files (NetCDF-4 classic model). The product files contain the key products, i.e. the retrieved column-averaged dry air mole fractions for XCO2, several other useful parameters and additional information relevant to using the data e.g. the averaging kernels. For further information on the product, including details of the WFMD algorithm, the SCIAMACHY instrument and issues associated with the data please see the associated product user guide (PUG) or the Algorithm Theoretical Basis Documents in the documentation section.",
    "keywords": "ESA, GHG, CCI, CO2, WFMD",
    "publicationState": "published",
    "dataPublishedTime": "2018-03-19T20:57:44",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25917/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_4/SCIAMACHY/CO2_SCI_WFMD/v4.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1512877508,
        "numberOfFiles": 3301,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3602/?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/54763/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54764/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55532/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55533/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55534/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55535/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69629/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69630/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69631/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69634/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82824/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82825/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82826/?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/108330/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108324/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108325/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108326/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108327/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108328/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108329/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108323/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108332/?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"
        }
    ]
}