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

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

{
    "ob_id": 31793,
    "uuid": "1d70803fab8f46ba983b730ede52421f",
    "title": "Gridded daily Agricultural Burning Emission Inventory of Eastern China, 2012 - 2015, V0.0",
    "abstract": "The Gridded daily Agricultural Burning Emission Inventory of Eastern China dataset contains a unique high Spatio-temporal resolution agricultural burning inventory for eastern China for the years 2012-2015. \r\n\r\nThe data was generated using twice daily fire radiative power (FRP) observations from the ‘small fire optimised’ VIIRS-IM FRP product, and combined with fire diurnal cycle information taken from the geostationary Himawari-8 satellite.\r\n\r\nThis dataset was designed to fully take into account small fires well below the MODIS burned area or active fire detection limit, focusing on dry matter burned (DMB) and emissions of CO2, CO, PM2.5 and black carbon. The fuel for these fires is waste straw and other agricultural residues.  Information from a crop rotation map to classify the type of agricultural residue being burned at each observed location and time, in addition to an agricultural area land map was also incorporated in consideration of this.",
    "keywords": "fire, emissions,  Agricultural Burning,  FRP, crop rotation",
    "publicationState": "citable",
    "dataPublishedTime": "2020-08-26T10:29:20",
    "doiPublishedTime": "2020-08-26T10:39:00",
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/31794/?format=api",
        "dataPath": "/neodc/fire_emissions/data/v0.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1160351270,
        "numberOfFiles": 50,
        "fileFormat": "NetCDF V4.0"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8695/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2690/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/4385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6323/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6324/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30298/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30299/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30300/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30301/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30302/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30303/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30304/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30305/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30306/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30307/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30308/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30309/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30310/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30311/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30312/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30313/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30314/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30315/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30316/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30317/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30318/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30319/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30320/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30321/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30322/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30323/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/30324/?format=api"
    ],
    "dataLineage": "Data was generated by Leverhulme Centre for Wildfires, King's College London; NERC National Centre for Earth Observation (NCEO). Data was provided to  the Centre for Environmental Data Analysis (CEDA) for publication.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10746/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140274/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140276/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140279/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140297/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140298/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140301/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140281/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140271/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140272/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140273/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140275/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140282/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140280/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140299/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140283/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/140284/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/31798/?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"
        }
    ]
}