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

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

{
    "ob_id": 25022,
    "uuid": "f3f8337c838c4602876d43f56d878515",
    "title": "The Organization of Tropical Rainfall: Observed convective aggregation data across the Tropics",
    "abstract": "This dataset contains about 5 years of analysed observations regarding the degree of convective aggregation, or clumping, across the tropics - these are averaged onto a large-scale grid. There are also additional variables which represent environmental fields (e.g. sea surface temperature from satellite data, or humidity profiles averaged from reanalysis data) averaged onto the same large-scale grid. The main aggregation index is the Simple Convective Aggregation Index (SCAI) originally defined in Tobin et al. 2012, Journal of Climate. The data were created during the main years of CloudSat and Cloud-Aerosol Lidar and Infrared Pathfinder Satellite Observations (CALIPSO) satellite data so that they could be compared with vertical cloud profiles from this satellite data, and the results of this analysis appear in Stein et al. 2017, Journal of Climate.\r\n\r\nEach file is one year of data (although the year may not be complete).\r\n\r\nEach variable is an array: var(nlon, nlat, [nlev], ntime)\r\nlongitude, latitude, pressure, time are variables in each file\r\nunits are attributes of each variable (except non-dimensional ones)\r\nmissing_value is 3.0E20 and is an attribute of each variable\r\n\r\nTime is in days since 19790101:00Z and is every 3hours at 00z, 03z, ... \r\nThe actual temporal frequency of the data is described for each variable below.\r\n\r\nThe data is for each 10deg X 10deg lat/lon box, 30S-30N (at outer edges of box domain), with each box defined by its centre coordinates and with boxes overlapping each other by 5deg in each direction.\r\n\r\nIn general, each variable is a spatial average over each box, with the value set to missing if more than 15% of the box is missing data.\r\nExceptions to this are given below.\r\nThe most important exception is for the brightness temperature data, used in aggregation statistics, which is filled in using neighborhood averaging if no more than 5% of the pixels are missing, but otherwise is considered to be all missing data. The percentage of missing pixels is recorded in 'bt_miss_frac'.\r\n\r\n",
    "keywords": "convective aggregation, Tropics, SCAI",
    "publicationState": "published",
    "dataPublishedTime": "2018-02-09T09:19:04",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25529/?format=api",
        "dataPath": "/badc/deposited2017/tropical_rainfall/data/observations",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 11311718931,
        "numberOfFiles": 8,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6766/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1864/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3894/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/7565/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/16668/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20957/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20958/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20959/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20960/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20961/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20963/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20964/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20965/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20966/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20968/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20969/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20970/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20971/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20972/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20973/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20974/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20975/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20976/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20977/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20978/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20979/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20980/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20981/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20982/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20983/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20984/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20985/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20986/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20987/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20988/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20989/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20991/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20992/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20993/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20995/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20996/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20997/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20998/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/20999/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21000/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21001/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21003/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21004/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21005/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21006/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21007/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21008/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/21009/?format=api"
    ],
    "dataLineage": "The data were collected from various online data repositories and analysed at the University of Reading.\r\n",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12144/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/25021/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102478/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102479/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102480/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102481/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102482/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102484/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102485/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102486/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102483/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/25825/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2543/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}