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

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

{
    "ob_id": 33034,
    "uuid": "dae723e78f9f4a0b9712f352f0a0231d",
    "title": "weather@home 2010 global simulations and climatology (1986-2016)",
    "abstract": "This dataset contains atmospheric data, such as wind field and surface air temperature,  obtained by running the weather@home general circulation model for the year 2010. The aim of this dataset is to study the 2010 weather extremes which have affected Western Russian and Pakistan. The dataset contains data for both the regional and global GCM models provided as NetCDF v3 files.  The gridded global model output is at 1.25°x1.875° (N96) horizontal resolution. The regional model output is provided on a rotated longitude-latitude grid at a 50 km (0.44°x0.44°) horizontal resolution centred over South Asia. In order to compare 2010 data to the climatology of the model, the climatology is calculated for the years 1986 to 2016. This dataset has been produced by the University of Oxford, in cooperation the Potsdam Institute for Climate Impact Research and the VU University of Amsterdam in the context of the GOTHAM project, funded by the Belmont Forum through the Natural Environment Research Council (NE/P006779/1). The weather@home model runs on the climateprecictions.net platform, which provides a volunteer distributed computational system.\r\n\r\nThis dataset contains weather@home global and regional simulations for the year 2010 and for the climatology of both models for the period 1986-2016.\r\n\r\nThe data comprises of:\r\n~700 ensemble members for weather@home (global model) for 2010 (batch 778)\r\n~700 ensemble members for weather@home (regional model, South Asia) for 2010 (nested on batch 778)\r\n~170 ensemble members per year for the period (1987-2016) for weather@home (global model) (batch 845)\r\n~100 ensemble members per year for the period (1986-2015) for weather@home (regional model, South Asia) (batch 697, not nested on batch 845)\r\nextracted variables:\r\nAt daily resolution: geopotential height 300 hPa (item16202), meridional wind velocity at 300 hPa (item15202), surface air temperature at 1.5m (item 3236), precipitation (item5216)\r\nAt monthly resolution: soil moisture (item8208)",
    "keywords": "weather@home, climatology",
    "publicationState": "citable",
    "dataPublishedTime": "2021-09-08T07:55:42",
    "doiPublishedTime": "2021-09-08T10:45:27.457071",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/33035/?format=api",
        "dataPath": "/badc/weather_at_home/data/b778-845_archive",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 5355157184461,
        "numberOfFiles": 41213,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9075/?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/4240/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60533/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60534/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60535/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60536/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60537/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60538/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60539/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60540/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60541/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60542/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60543/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60544/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60545/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60546/?format=api"
    ],
    "dataLineage": "GOTHAM Project weather@home platform (ClimatePrediction.Net) Data archived at Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10945/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/33036/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147500/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147499/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147501/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147503/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147504/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147509/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147510/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168965/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147511/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147513/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147514/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147515/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147516/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/147517/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/33037/?format=api",
    "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"
        }
    ]
}