GET

Observation Instance

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

{
    "ob_id": 31969,
    "uuid": "69b2c9c6c4714517ba10dab3515e4ee6",
    "title": "BICEP / NCEO: Monthly global Marine Phytoplankton Primary Production, between 1998-2020 at 9 km resolution (derived from the Ocean Colour Climate Change Initiative v4.2 dataset)",
    "abstract": "This dataset contains global, monthly marine phytoplankton primary production products (in mg C m-2 d-1) for the period of 1998 to 2018 at 9 km spatial resolution.  Data are provided in NetCDF format.\r\n\r\nPrimary production by marine phytoplankton was modelled using ocean-colour remote sensing products and a spectrally-resolved primary production model that incorporates the vertical structure of phytoplankton and simulates changes in photosynthesis as a function of irradiance using a two-parameter photosynthesis versus irradiance (P-I) function (see Kulk et al. 2020, Sathyendranath et al. 2020a, and references therein for details). Chlorophyll-a products were obtained from the European Space Agency (ESA) Ocean Colour Climate Change Initiative (OC-CCI v4.2 dataet). Photosynthetic Active Radiation (PAR) products were obtained from the National Aeronautics and Space Administration (NASA) and were corrected for inter-sensor bias in products. In situ datasets of chlorophyll-a profile parameters and P-I parameters were incorporated as described in Kulk et al. (2020). \r\n\r\nThe primary production products were generated as part of the ESA Living Planet Fellowship programme ‘Primary production, Index of Climate Change in the Ocean: Long-term Observations’\r\n(PICCOLO). Support from the Simons Foundation grant ‘Computational Biogeochemical Modeling of Marine Ecosystems’ (CBIOMES, number 549947), from the ESA Biological Pump and Carbon\r\nExchange Processes (BICEP) project and from the National Centre of Earth Observation (NCEO) is acknowledged.\r\n\r\nData are provided as netCDF files containing global, monthly marine phytoplankton primary production products (in mg C m-2 d-1) for the period of 1998 to 2020 at 9 km spatial resolution.\r\n\r\nReferences:\r\n\r\nKulk, G.; Platt, T.; Dingle, J.; Jackson, T.; Jönsson, B.F.; Bouman, H.A., Babin, M.; Doblin, M.; Estrada, M.; Figueiras, F.G.; Furuya, K.; González, N.; Gudfinnsson, H.G.; Gudmundsson, K.; Huang, B.; Isada, T.; Kovac, Z.; Lutz, V.A.; Marañón, E.; Raman, M.; Richardson, K.; Rozema, P.D.; Van de Poll, W.H.; Segura, V.; Tilstone, G.H.; Uitz, J.; van Dongen-Vogels, V.; Yoshikawa, T.; Sathyendranath S. Primary production, an index of climate change in the ocean: Satellite-based estimates over two decades. Remote Sens. 2020, 12, 826. doi:10.3390/rs12050826\r\n\r\nSathyendranath, S.; Platt, T.; Žarko K.; Dingle, J.; Jackson, T.; Brewin, R.J.W.; Franks, P.; Nón, E.M.; Kulk, G.; Bouman, H. Reconciling models of primary production and photoacclimation. Appl. Opt.\r\n2020a, 59, C100-C114. doi.org/10.1364/AO.386252.",
    "keywords": "Marine phytoplankton, primary production",
    "publicationState": "citable",
    "dataPublishedTime": "2021-12-21T14:04:32",
    "doiPublishedTime": "2021-12-22T15:41:31",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/33314/?format=api",
        "dataPath": "/neodc/bicep/data/marine_primary_production/v4.2/monthly/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 20623346126,
        "numberOfFiles": 277,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9192/?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/18405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/18408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69035/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69036/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69037/?format=api"
    ],
    "dataLineage": "The primary production products were generated as part of the ESA Living Planet Fellowship programme ‘Primary production, Index of Climate Change in the Ocean: Long-term Observations’ (PICCOLO).  They were delivered by project participants for long-term archiving to the Centre for Environmental Data Analysis (CEDA) archive.\r\n\r\nSupport from the Simons Foundation grant ‘Computational Biogeochemical Modeling of Marine Ecosystems’ (CBIOMES, number 549947), from the ESA Biological Pump and Carbon Exchange Processes (BICEP) project and from the National Centre of Earth Observation (NCEO) is acknowledged.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10974/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/31968/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/31975/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30127/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141478/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141507/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141476/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141477/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141472/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141473/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141474/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141475/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141508/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141479/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141480/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141481/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141482/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141483/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141924/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141484/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141485/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141486/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141487/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141488/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141489/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141490/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141491/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141492/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141493/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141494/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141495/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141496/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141497/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141498/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141499/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141500/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141501/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141502/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141503/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141504/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141505/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141506/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/31976/?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"
        }
    ]
}