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

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

{
    "ob_id": 32224,
    "uuid": "be40716c1036498cb6b16b0ef25c5535",
    "title": "ESA Cloud Climate Change Initiative (Cloud_cci): Obs4MIPs format monthly gridded cloud products from ATSR2 and AATSR, version 3",
    "abstract": "This dataset provides a version of the Cloud_cci ATSR2-AATSRv3 monthly gridded dataset  in Obs4MIPs format.   The Cloud_cci ATSR2-AATSRv3 dataset (covering 1995-2012) was generated within the Cloud_cci project, which was funded by the European Space Agency (ESA) as part of the ESA Climate Change Initiative (CCI) programme (Contract No.: 4000109870/13/I-NB). \r\n\r\nThis dataset is based on measurements taken by the Along-Track  Scanning  Radiometer (ATSR-2)  on-board  the  European  Remote Sensing Satellite -2 (ERS-2),  and by the Advanced  Along-Track  Scanning  Radiometer (AATSR) on-board  the  Environmental Satellite (Envisat).  It contains a variety of cloud properties which were derived employing the Community Cloud retrieval for Climate (CC4CL) retrieval framework.     \r\n\r\nThis particular Obs4MIPS product has been generated for inclusion in Obs4MIPs (Observations for Model Intercomparisons Project), which is an activity to make observational products more accessible for climate model intercomparisons.   \r\n\r\nIndividual files are provided covering seven cloud variables:\r\nCloud area fraction in atmospheric layer (clCCI);\r\nAtmospheric cloud ice content (clivi);\r\nCloud area fraction (cltCCI);\r\nLiquid water cloud area fraction in atmospheric layer(clwCCI);\r\nLiquid water cloud area fraction (clwtCCI);\r\nAtmosphere mass content of cloud condensed water (clwvi);\r\nAir pressure at cloud top (pctCCI)",
    "keywords": "cloud, CCI, obs4mips",
    "publicationState": "citable",
    "dataPublishedTime": "2021-04-29T15:45:16",
    "doiPublishedTime": "2021-04-29T15:57:34",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32234/?format=api",
        "dataPath": "/neodc/esacci/cloud/data/obs4MIPs/DWD/ESACCI-CLOUD-ATSR2-AATSR-3-0/mon/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 7568311564,
        "numberOfFiles": 134,
        "fileFormat": "Data are in NetCDF format.    Data has been formatted according to Obs4MIPs specifications"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8832/?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/6021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/7795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/10024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54333/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54389/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69544/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69545/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69546/?format=api"
    ],
    "dataLineage": "Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).  \r\n\r\nThe data in this dataset are a subset of the ATSR2-AATSR L3C / L3U cloud products version 3.0 dataset produced by the ESA Cloud_cci project available from https://dx.doi.org/10.5676/DWD/ESA_Cloud_cci/ATSR2-AATSR/V003.    This version of the data has been produced for submission to Obs4MIPS.\r\n\r\nTo cite the full dataset, please use the following citation: Poulsen, Caroline; McGarragh, Greg; Thomas, Gareth; Stengel, Martin; Christensen, Matthew; Povey, Adam; Proud, Simon; Carboni, Elisa; Hollmann, Rainer; Grainger, Don (2019): ESA Cloud Climate Change Initiative (ESA Cloud_cci) data: Cloud_cci ATSR2-AATSR L3C/L3U CLD_PRODUCTS v3.0, Deutscher Wetterdienst (DWD) and Rutherford Appleton Laboratory (Dataset Producer), DOI:10.5676/DWD/ESA_Cloud_cci/ATSR2-AATSR/V003",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10862/?format=api"
    ],
    "projects": [],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143309/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143308/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143306/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143305/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143304/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143344/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143345/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143307/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143346/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143347/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143348/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143354/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143349/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143350/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143351/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143352/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143353/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/32286/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2524/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_cloud_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}