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

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

{
    "ob_id": 34649,
    "uuid": "fbf06d6f3c9b4469926d79be38a5cf63",
    "title": "Anomalies of Biogeochemical Parameters in the Tropical Region (TROPBGC)",
    "abstract": "This dataset contains biogeochemical parameter anomalies, calculated from Moderate Resolution Imaging Spectroradiometer (MODIS-Aqua) (Chlorophyll Concentration), GLOBAL_MULTIYEAR_BGC_001_029 and MULTIOBS_GLO_BIO_CARBON_SURFACE_REP_015_008 datasets. \r\n\r\nData was taken from existing datasets, from National Aeronautics and Space Administration (NASA) the MODIS-Aqua satellite (chlorophyll) and from Copernicus Marine System 2 biogeochemical sets called GLOBAL_MULTIYEAR_BGC_001_029 (https://doi.org/10.48670/moi -00019) and MULTIOBS_GLO_BIO_CARBON_SURFACE_REP_015_008 (https://doi.org/10.48670/moi-00047) from which the anomalies were computed and the files were created using the following Matlab functions:\r\n\r\n1- Humberto L. Varona. (2021). mNC: A tool for Oceanographers and Meteorologists to easily create their NetCDF files using Matlab (1.0). Zenodo. https://doi.org/10.5281/zenodo.5572749\r\n2- Humberto L. Varona. (2021). CalcPlotAnomaly: Matlab function set for the calculation and plotting of anomalies (1.01). Zenodo. https://doi.org/10.5281/zenodo.5576889\r\n\r\nAnomalies were computed for the entire tropic.\r\n\r\nThe parameters are: Chlorophyll concentration, pH, Surface aqueous partial pressure of CO2 , NO3, Surface downward flux of total CO2, PO4, SI, O2, Fe and concentration of phytoplankton.\r\n\r\nAll files are in NetCDF format\r\n\r\nThis dataset was produced for the project Tropical and South Atlantic climate-based marine ecosystem predictions for sustainable management, to Tropical Atlantic Interdisciplinary Laboratory on physical, biogeochemical, ecological and human dynamics (IJL TAPIOCA) and the Brazilian Research Network on Global Climate Change (Rede CLIMA).",
    "keywords": "TROPBGC, Biogeochemical",
    "publicationState": "preview",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/34650/?format=api",
        "dataPath": "/badc/deposited2022/TROPBGC/data/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 65004890065,
        "numberOfFiles": 10,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": null,
    "geographicExtent": null,
    "nonGeographicFlag": true,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6645/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46751/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46752/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46753/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46754/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46755/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46756/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46757/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46758/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46759/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46760/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46761/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46762/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46763/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46764/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46765/?format=api"
    ],
    "dataLineage": "Data deposited to the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/34652/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164410/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164411/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164412/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164413/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164414/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/164415/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168200/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168201/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168202/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168807/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168203/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/34651/?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": []
}