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/27596/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 27596,
    "uuid": "602f11d9a2034dae9d0a7356f9aeaf45",
    "title": "The Disdrometer Verification Network (DiVeN): particle diameter and fall velocity measurements from a network of Thies Laser Precipitation Monitors around the UK (2017-2019)",
    "abstract": "Starting in February 2017, a network of 14 Thies™ manufactured Laser Precipitation Monitors (LPMs) were installed at various locations around the United Kingdom to create the Disdrometer Verification Network (DiVeN). The instruments were installed for verification of radar hydrometeor classification algorithms but are valuable for much wider use in the scientific and operational meteorological community.\r\n\r\nEvery Thies LPM is able to designate each observed hydrometeor into one of 20 diameter bins from >= 0.125 mm to > 8 mm, and one of 22 speed bins from > 0.0 m s-1 to > 20.0 m s-1. A laser and diode receiver operate in tandem; a falling particle will occlude the beam. The duration of the occlusion and the maximum extent (measured by diode voltage) determines the fall velocity and diameter respectively. Using empirically-derived relationships, the instrument classifies precipitation into one of 11 possible hydrometeor classes in the form of a 'present weather code', with an associated indicator of uncertainty. To provide immediate feedback to data users, the observations are plotted in near real time (NRT) and made publicly available on a website within 7 minutes (see linked documentation section). A 'present weather code' is a World Meteorological Organisation (WMO) code used to define the present observatory weather (see linked documentation for the WMO present weather code list).\r\n\r\nThe instruments belonged to the Met Office but were loaned to the National Centre for Atmospheric Science (NCAS) for the duration of the project. NCAS handle the receiving server for real-time DiVeN data, which is the only route to this dataset. On-site collection of data are not guaranteed in all circumstances. Some of the sites rely on unreliable O2 3G dongles; whilst the Feshie instrument was solar and wind powered and the Coverhead instrument suffered from power / connectivity issues. Any missing data can be explained by these reasons, and are handled appropriately in the files. The data were collated into daily files of 1440 minutes. More information can be found in Pickering et al., 2018, see related documentation.",
    "keywords": "disdrometer, rainfall, precipitation, verification, hydrometeors",
    "publicationState": "citable",
    "dataPublishedTime": "2019-10-29T11:25:16",
    "doiPublishedTime": "2019-10-31T14:59:50.268415",
    "updateFrequency": "notPlanned",
    "status": "final",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27594/?format=api",
        "dataPath": "/badc/deposited2019/diven",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 72756447035,
        "numberOfFiles": 13483,
        "fileFormat": "Data are NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7398/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2406/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53936/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53937/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53938/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53939/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53941/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53942/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53943/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/53944/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60881/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60883/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60885/?format=api"
    ],
    "dataLineage": "The resource came into existence to fulfil a need for more reliable hydrometeor type data in the UK (compared with automated stations using a visiometer) in order to verify radar hydrometeor classification algorithms for the UK C-band dual-polarisation radar network, which was upgraded to dual-polarisation 2013-2018. \r\n\r\nThe recorded disdrometer precipitation data are uploaded in real time to an NCAS server, where it has been converted to a netCDF format. The instrument itself does all the internal processing to generate the extra variables before outputting the data to a user, but the raw particle counts are retained. Raw diode voltages are not an available product.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10643/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/27595/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/28110/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115391/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115389/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115390/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115392/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115393/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115394/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115395/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115398/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115396/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115399/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115400/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27597/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}