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

{
    "ob_id": 39197,
    "uuid": "b839ae53abf94e23b0f61560349ccda1",
    "title": "DCMEX: cloud images from the NCAS Camera 11 from the New Mexico field campaign 2022",
    "abstract": "This dataset contains cloud images from the NCAS Camera 11, one of two identical cameras (designated as ncas-cam-11 and ncas-cam-12) captured at various sites around the Magdalena Mountains, New Mexico, USA, as part of the Deep Convective Microphysics Experiment (DCMEX). DCMEX examined the formation and development of clouds over mountains during July and August 2022.\r\n\r\nThese cameras were designed to take simultaneous images of the same object while placed a distance apart to create a stereo image, but this was not always possible; on some days only one camera was used or the two cameras were deployed in separate locations.\r\n\r\nThe images from this camera were taken during the duration of the DCMEX campaign of clouds from a range of sites. These are accompanied by similar images from a sibling camera (see connected dataset). Where the two cameras were operated at the same site they were synchronised in terms of camera settings (exposure, etc) and camera pointing directions to facilitate the onward use of images as stereoscopic imagery. For those latter instances files have been marked with stereo-a or stereo-b within the filename to denote where the images form the left of right image for such images. Other images do not contain these additional filename fields to denote when the cameras were used in stand-along mode. Note, due to the nature of coordinating images between the two cameras one was designated as the primary camera from which the settings were then conveyed to the secondary camera by the coordinating software. As a result exact image synchronisation wasn't possible and thus the secondary camera image may have a timestamp that is a second or so later.",
    "keywords": "DCMEX, Camera, Images, AMOF, stereoscopic",
    "publicationState": "citable",
    "dataPublishedTime": "2023-12-15T14:20:20",
    "doiPublishedTime": "2023-12-15T14:30:29.474163",
    "updateFrequency": "notPlanned",
    "status": "final",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/42894/?format=api",
        "dataPath": "/badc/ncas-mobile/data/ncas-cam-11/20220621_dcmex/v1.0",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 56752573539,
        "numberOfFiles": 10093,
        "fileFormat": "Data are JPG formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10873/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3686/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data were collected by scientists on the DCMEX field campaign, with metadata added in accordance with the NCAS-IMAGE-1.0 metadata standard before archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12791/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/38131/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/38137/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190849/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190850/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/200351/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198604/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198607/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198610/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198611/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198613/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/41070/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}