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

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

{
    "ob_id": 3557,
    "uuid": "4918af56410c6af1890950ae8f3c04ec",
    "title": "ITALSAT radio propagation measurements at 50GHz in the United Kingdom",
    "abstract": "Measurements of troposhperic attenuation (excess and total) made at Sparsholt in Hampshire, UK using the ITALSAT satellite F1 beacon signal at 50 GHz.\r\n\r\nITALSAT F1 (owned and operated by the Italian Space Agency) was in geostationary orbit at 13 degrees east, and it could be seen from the receiving station at an elevation angle of 30 degrees. The received signal was vertically polarised and was sampled once a second. North-south tracking of the satellite with the beacon receiver maintained ~20dB of dynamic range thought of the measurement period. \r\n\r\nThe method applied to remove the nonatmospheric changes of the beacon signal and to establish the reference level from which to measure the excess and total attenuation is described in [Ventouras et.al., Long-term statistics of tropospheric attenuation from the Ka/U band ITALSAT satellite experiment in the United Kingdom, Radio Sci.,41,RS2007,doi:10.1029/2005RS003252]. The accuracy of fade level retrieval is estimated to be ~+/-0.5dB",
    "keywords": "CFARR, Chilbolton, radio propagation, 50 GHz",
    "publicationState": "citable",
    "dataPublishedTime": "2012-05-25T12:27:11",
    "doiPublishedTime": "2012-05-27T23:00:00",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/3558/?format=api",
        "dataPath": "/badc/chilbolton/data/italsat/italsat-50ghz-beacon",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1898632949,
        "numberOfFiles": 1372,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1006/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/61/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55384/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55386/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/55387/?format=api"
    ],
    "dataLineage": "Data are prepared by Chilbolton Facility for Atmospheric and Radio Research (CFARR) staff prior to submission to BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/2409/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/3559/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/3461/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15068/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15070/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15071/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15072/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15078/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/15069/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/44861/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/3561/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}