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

{
    "ob_id": 25099,
    "uuid": "d269d748cafe40ec8601125caf5cb2fa",
    "title": "CMIP5 20-Year AR5 Climatology Data for the IPCC DDC",
    "abstract": "CMIP5 monthly mean climatology fields matching those given in IPCC WG1 AR5 Annex I: Atlas of Global and Regional Climate Projections in Climate Change 2013, the Fifth Assessment Report (AR5) of the United Nations Intergovernmental Panel on Climate Change (IPCC). \r\nClimatologies have been calculated for global fields of Specific Humidity, Precipitation, Sea Level Pressure, Temperature, Wind and Downwelling Shortwave Radiation (Stoker et. al., 2013).  The CMIP5 climatologies, calculated by the Centre for Environmental Data Analysis (CEDA), match those described in table AI.1 in Stoker et al (2013).  Twenty-year AR5 climatologies and climatological anomalies are calculated for the averaging periods 2016-2035, 2046-2065, 2081-2100 for the CMIP5 scenario experiments rcp26, rcp45, rcp60 and rcp85. The climatologies are of global scope and are provided on latitude-longitude grids.",
    "keywords": "IPCC, AR5, CMIP5, Climatologies, piControl, 1pctCO2, historical, scenarios, rcp26, rcp45, rcp60, rcp85",
    "publicationState": "published",
    "dataPublishedTime": "2018-05-22T12:47:39",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25098/?format=api",
        "dataPath": "/badc/ipcc-ddc/data/CMIP5-climatologies-AR5",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 28762282734,
        "numberOfFiles": 4842,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/6789/?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/6021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/7795/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25892/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50429/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50431/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50475/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50496/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50498/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50549/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50561/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50564/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52741/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52755/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/56259/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60438/?format=api"
    ],
    "dataLineage": "Climatologies and climatological anomalies have been calculated at CEDA from CMIP5 model output.\r\n\r\nTime Periods:\r\n- AR5 averaging periods: 2016-2035, 2046-2065, 2081-2100\r\n\r\nAnomaly Specification: \r\nAll values are taken as anomalies from the 1986->2005 mean (base line values).\r\n\r\nOutput:\r\n- Period mean of the monthly mean of the variables\r\n- 12 monthly values per climatology\r\n- Climatology is a 2D field\r\n- One climatology per model per scenario per variable per time period\r\n- CF compliant netCDF files\r\n\r\nDirectory Structure:\r\nThe output directory structure follows the DRS specification with the root directory being /derived.\r\nEach file has the extended attribute: clim-anom-ref5.  This indicates that it is a climatological mean anomaly (clim-anom) and that the reference period matches the AR5 reference period (ref5).\r\n\r\nMethod:\r\nThe algorithm follows the process below:\r\n\r\n- For every model:\r\n  - For every variable (if available):\r\n      calculate the 1986->2005 climatological (period average) monthly means (baseline) for the Historical experiment\r\n\r\n- For every model:\r\n  - For every variable (if available):\r\n      calculate the period average monthly means (baseline) of the last 20 years of the piControl run\r\n\r\n- For every model:\r\n  - For every experiment:\r\n    - For every time period:\r\n      - For every variable (if available):\r\n        calculate the climatological monthly mean for this (model, experiment, time period, variable) and subtract the relevant baseline\r\n\r\nCode:\r\nhttps://github.com/cedadev/ipcc_ddc_cmip5_clim_anoms/releases/tag/1.0",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/5525/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/25092/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111739/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/102851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/111740/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}