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

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

{
    "ob_id": 4703,
    "uuid": "80b73e32ea38dd42f08b21a46f763083",
    "title": "Convective Storm Initiation Project (CSIP): Vertical wind profile data from the Universities' Facility for Atmospheric Measurement's (UFAM) 1290mhz Degreane Mobile Wind Profiler from Ashmansworth, Hampshire, UK",
    "abstract": "The University of Wales, Aberystwyth 1290 MHz mobile wind profiler, deployed as part of a suite of instrument from NCAS's Universities Facility for Atmospheric Measurements (UFAM), was sited at Ashmansworth for the duration of the Convective Storm Initiation Project (CSIP)'s pilot field campaign. The instrument was operated throughout the campaign, producing vertical profiles of wind speed and direction (horizontal and vertical components), signal to noise ratio and spectral width measurements 6th to 22nd July 2004 . This instrument is now referred to as the University of Manchester mobile wind profiler (man-radar-1290mhz).",
    "keywords": "UFAM, NCAS, AMF, radar, wind profiler, boundary layer wind profiler, turbulence, thermals, boundary layer structure, radar wind profiler, Doppler radar, UHF radar, 'Clear' air radar, morning transition, convective boundary layer, mixed layer, entrainment zone, transitional boundary layer, nocturnal boundary layer, lower level jet, nocturnal jet, weather fronts, sting jets",
    "publicationState": "published",
    "dataPublishedTime": "2006-02-06T12:59:13",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/4704/?format=api",
        "dataPath": "/badc/csip/data/aber-radar-1290mhz/csip_pilot/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 22970836,
        "numberOfFiles": 295,
        "fileFormat": "Data are netCDF formatted, whilst plots are in PNG format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1335/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/87/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3038/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/3039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/22318/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52194/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52195/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52196/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52197/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52198/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52199/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52200/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52201/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52202/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52203/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52204/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52205/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52206/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52207/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52208/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52209/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52210/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52211/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52212/?format=api"
    ],
    "dataLineage": "Data were collected by the Universities' Facility for Atmospheric Measurement (UFAM) mobile wind profiler instrument, prepared by the instrument scientist and delivered to the BADC for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/3160/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/4705/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/4611/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/11685/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21611/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21607/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42715/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/21605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/42714/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/46946/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/4707/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "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"
        }
    ]
}