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

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

{
    "ob_id": 44140,
    "uuid": "8bfc884852f34c60ab5f97bedde5e661",
    "title": "SSP370-SAS126ca data produced by the GISS-E2-1-G model for the Regional Aerosol Model Intercomparison Project (RAMIP)",
    "abstract": "This record contains data for the SSP370-SAS126ca experiment simulations from the Regional Aerosol Model Intercomparison Project (RAMIP), produced using GISS-E2-1-G. It contains NetCDF output from coupled transient simulations with regional carbonaceous aerosol reductions over South Asia. For a full description of the experiments, see: https://gmd.copernicus.org/articles/16/4451/2023/.\r\n\r\nThe SSP370-SAS126ca coupled transient experiment runs from January 2015 to at least February 2051. Carbonaceous aerosol emissions (black carbon and organic carbon) over South Asia are taken from SSP1-2.6, while all other anthropogenic emissions and land use follow SSP3-7.0. South Asia is the region bounded by 65 and 95E and 5 and 35N.\r\n\r\nThe simulations are initialised from the CMIP6 historical experiment. Anthropogenic emissions designed for the ScenarioMIP experiments SSP3-7.0 and SSP1-2.6 are used. All experiments follow SSP3-7.0, with perturbations to regional aerosol and precursor emissions using SSP1-2.6 emissions, following the RAMIP protocol. Data are provided for a subset of CMIP6 variables, following their CMIP6 definitions. Some 3D variables are produced at reduced vertical resolution compared to CMIP6. These are identified with new variable names, as set out in the RAMIP data request: https://gmd.copernicus.org/articles/16/4451/2023/\r\n\r\nAcronyms\r\n------------\r\nSSP1-2.6: experiment based on Shared Socioeconomic Pathway SSP1 with low climate change mitigation and adaptation challenges and RCP2.6, a future pathway with a radiative forcing of 2.6 W/m2 in the year 2100.\r\nSSP3-7.0: experiment based on Shared Socioeconomic Pathway SSP3 which is characterised by high challenges to both mitigation and adaptation and RCP7.0, a future pathway with a radiative forcing of 7.0 W/m2 in the year 2100.\r\nScenarioMIP: the Scenario Model Intercomparison Project simulates climate outcomes based on alternative plausible future scenarios.\r\nCMIP6: is the sixth phase of the Coupled Model Intercomparison Project, a global collaboration of climate modellers.",
    "keywords": "aerosol, extremes, near-term projections, RAMIP",
    "publicationState": "working",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "pending",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/44141/?format=api",
        "dataPath": "/badc/cmip6/data/CMIP6Plus/RAMIP/NASA-GISS/GISS-E2-1-G/ssp370-sas126ca",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 300015843552,
        "numberOfFiles": 774,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12049/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4682/?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/6023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6255/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50420/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50424/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50425/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50426/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50427/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50428/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50437/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50445/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50468/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50475/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50481/?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/50551/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50552/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50553/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50554/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50555/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50557/?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/50566/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50568/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50569/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50570/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50578/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50579/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50580/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50600/?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/50609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50610/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50614/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50615/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50616/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52755/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54215/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54242/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54252/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54265/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54268/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54300/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54302/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54340/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54829/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62736/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71572/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71574/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71615/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71632/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71633/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71648/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71659/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71666/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71677/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71681/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71687/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71732/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71802/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71825/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/71854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/79857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/79858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/79861/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/79862/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/79864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/79865/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82132/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82133/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82134/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82135/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82136/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82138/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82139/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82140/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82141/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82142/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82143/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82144/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82146/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82148/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82150/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82151/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/82152/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/83905/?format=api"
    ],
    "dataLineage": "The coupled transient simulations are initialised from the CMIP6 historical experiment. Anthropogenic emissions designed for the ScenarioMIP experiments SSP3-7.0 and SSP1-2.6 are used. All experiments follow SSP3-7.0, with perturbations to regional aerosol and precursor emissions using SSP1-2.6 emissions, following the RAMIP protocol. \r\n\r\nFixed sea surface temperature (piClim) simulations are copies of the piClim-aer experiment performed for RFMIP (for CMIP6), but with RAMIP emissions for 2050. \r\n\r\nData are provided for a subset of CMIP6 variables, following their CMIP6 definitions. Some 3D variables are produced at reduced vertical resolution compared to CMIP6. These are identified with new variable names, as set out in the RAMIP data request:  https://gmd.copernicus.org/articles/16/4451/2023/ \r\n\r\nThe data were post-processed after CMORization to follow CMIP6Plus naming conventions.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/43444/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/44057/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211116/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211117/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211120/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211118/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211122/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211119/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211121/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211123/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211124/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/211125/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/43452/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2519/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ramip",
            "label": "restricted: ramip group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/rugl_versions/rugl_v1-0.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}