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

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

{
    "ob_id": 37290,
    "uuid": "54d3408edd9e41bca226924754619812",
    "title": "HadISDH.marine: gridded global monthly ocean surface humidity data version 1.3.0.2021f",
    "abstract": "This is the HadISDH.marine 1.3.0.2021f version of the Met Office Hadley Centre Integrated Surface Dataset of Humidity (HadISDH). HadISDH.marine is a near-global gridded monthly mean marine surface humidity climate monitoring product. It is created from in situ observations of air temperature and dew point temperature from ships. The observations have been quality controlled and bias-adjusted. Uncertainty estimates for observation issues and gridbox sampling are provided (see data quality statement section below). The data are provided by the Met Office Hadley Centre and this version spans 1/1/1973 to 31/12/2021.\r\n\r\nThe data are monthly gridded (5 degree by 5 degree) fields. Products are available for temperature and six humidity variables: specific humidity (q), relative humidity (RH), dew point temperature (Td), wet bulb temperature (Tw), vapour pressure (e), dew point depression (DPD).\r\n\r\nThis version extends the previous version to the end of 2021. Users are advised to read the update document in the Docs section for full details on all changes from the previous release.\r\n\r\nTo keep informed about updates, news and announcements follow the HadOBS team on twitter @metofficeHadOBS.\r\n\r\nFor more detailed information e.g bug fixes, routine updates and other exploratory analysis, see the HadISDH blog: http://hadisdh.blogspot.co.uk/\r\n\r\nReferences:\r\n\r\nWhen using the dataset in a paper please cite the following papers (see Docs for link\r\nto the publications) and this dataset (using the \"citable as\" reference):\r\n\r\nWillett, K. M., Dunn, R. J. H., Kennedy, J. J. and Berry, D. I., 2020: Development of\r\nthe HadISDH marine humidity climate monitoring dataset. Earth System Sciences Data,\r\n12, 2853-2880, https://doi.org/10.5194/essd-12-2853-2020\r\n\r\nFreeman, E., Woodruff, S. D., Worley, S. J., Lubker, S. J., Kent, E. C., Angel, W. E.,\r\nBerry, D. I., Brohan, P., Eastman, R., Gates, L., Gloeden, W., Ji, Z., Lawrimore, J.,\r\nRayner, N. A., Rosenhagen, G. and Smith, S. R., ICOADS Release 3.0: A major update to\r\nthe historical marine climate record. International Journal of Climatology.\r\ndoi:10.1002/joc.4775.",
    "keywords": "HadISDH, humidity, surface, marine, gridded, station, specific humidity, temperature, dew point temperature, wet bulb temperature, dew point temperature, vapour pressure, in-situ",
    "publicationState": "citable",
    "dataPublishedTime": "2022-05-26T13:52:23",
    "doiPublishedTime": "2022-05-26T13:52:26",
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37293/?format=api",
        "dataPath": "/badc/ukmo-hadobs/data/insitu/MOHC/HadOBS/HadISDH-marine/mon/HadISDHTable/r1/v1-3-0-2021f/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 240979716,
        "numberOfFiles": 8,
        "fileFormat": "Data are NetCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10298/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12354/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12355/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12356/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12358/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12359/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12361/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12362/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29046/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29047/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29048/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29049/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29082/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29083/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29084/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29085/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29086/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29087/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29088/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29089/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29090/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29091/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29092/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29093/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29094/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29095/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29096/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29097/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29098/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29099/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29100/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29101/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29102/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29103/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29104/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29105/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29106/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29108/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29109/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29111/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29112/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29113/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29114/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29115/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29116/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29117/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29118/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29119/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29120/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29121/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29122/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29123/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29124/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29125/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29126/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29127/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29180/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29181/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29182/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/29183/?format=api"
    ],
    "dataLineage": "HadISDH.marine is a global ocean surface (~10 m) humidity dataset and is produced by the Met Office Hadley Centre in collaboration with NOC. It is based on the sub-daily ship observations from ICOADS. It is passed to CEDA for archiving and distribution.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12132/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13164/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/13522/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178162/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178161/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178165/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178164/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178163/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178157/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178158/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178168/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178166/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178167/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178169/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/178170/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/30534/?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"
        }
    ]
}