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

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

{
    "ob_id": 41005,
    "uuid": "e3dcd4b7f6f94e38ab355fb502dafc9b",
    "title": "Total Carbon Column Observing Network (TCCON): TCCON data from Park Falls (US), Release GGG2020.R1",
    "abstract": "The Total Carbon Column Observing Network (TCCON) is a network of ground-based Fourier Transform Spectrometers that record direct solar absorption spectra of the atmosphere in the near-infrared. From these spectra, accurate and precise column-averaged abundances of atmospheric constituents including carbon dioxide (CO2), methane (CH4), nitrous oxide (N2O), hydrogen fluoride (HF), carbon monoxide (CO), water vapour (H2O), and deuterated water vapour (HDO), are retrieved. This is the GGG2020 data release of observations from the TCCON station at Park Falls, Wisconsin, USA.",
    "keywords": "TCCON, Greenhouse gases, carbon dioxide, methane, carbon monoxide, nitrous oxide, ground-based, atmospheric trace gases, column-averaged dry-air mole fractions, remote sensing, FTIR spectroscopy",
    "publicationState": "published",
    "dataPublishedTime": "2023-12-08T09:49:15",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/41051/?format=api",
        "dataPath": "/neodc/tccon/tccon_mirror/data/parkfalls01/ggg2020",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1153691772,
        "numberOfFiles": 7,
        "fileFormat": "netcdf"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/11850/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4044/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50559/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/63576/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73968/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73969/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73970/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73971/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73972/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73973/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73974/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73975/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73976/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73977/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73978/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73979/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73980/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73981/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73982/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73983/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73984/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73985/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73986/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73987/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73988/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73989/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73990/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73991/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73992/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73993/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73994/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73995/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73996/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73997/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73998/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/73999/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74000/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74001/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74003/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74004/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74005/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74006/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74007/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74008/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74009/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74010/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74011/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74012/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74013/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74014/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74015/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74016/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74017/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74018/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74019/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74020/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74023/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74024/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74025/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74026/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74027/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74028/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74029/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74030/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74031/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74032/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74033/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74034/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74035/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74036/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74037/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74038/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74039/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74040/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74041/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74042/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74043/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74044/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74045/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74046/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74047/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74048/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74049/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74051/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74052/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74053/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74054/?format=api"
    ],
    "dataLineage": "Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).This dataset is part of a mirror archive of the Caltech TCCON network. The Caltech page for this dataset can be found here: https://doi.org/10.14291/tccon.ggg2020.parkfalls01.R1",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/40019/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/41059/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199622/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199614/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199615/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199616/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199617/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199618/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199619/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199620/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199621/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199624/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199625/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199626/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199627/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199628/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/199629/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/41200/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2562/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/TCCON_data_license.pdf",
            "licenceClassifications": ""
        }
    ],
    "discoveryKeywords": []
}