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

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

{
    "ob_id": 38871,
    "uuid": "ed9156e1697343e4ad82e83ed550e345",
    "title": "Terrestrial laser scanning data Wytham Woods: leaf-off raw data 2015/16",
    "abstract": "This dataset is comprised of terrestrial laser scanning (TLS) data collected at the Wytham Woods, Oxfordshire during the winter period of 2015/16 when leaves were off the deciduous trees. The data underpins the study into laser scanning potential underestimation of biomass carbon in a temperate forest.\r\n\r\nTLS data were collected on a 20 m x 20 m grid where at each position the scanner captured data in an upright and tilted position. The scanner was set to an angular step of 0.04 degrees.  In between each scan position, a set of retro-reflective targets were positioned to be used as tie-points between scans. Scan data were coregistered using the RiSCAN Pro software package, the 4x4 rotation transformation matrices to transform the point cloud data into a common reference coordinate system can be found in the \"matrix\" directory",
    "keywords": "Terrestrial laser scan, Wytham Woods, Biomass",
    "publicationState": "citable",
    "dataPublishedTime": "2022-11-15T14:44:09",
    "doiPublishedTime": "2022-11-15T15:18:17",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/38873/?format=api",
        "dataPath": "/neodc/tls/data/raw/uk/WHY/2015-11-26.001.riproject",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 159827491945,
        "numberOfFiles": 28441,
        "fileFormat": "Point cloud data in RIEGL proprietary .rxp format, image data in .jpg format and matrix data in text file"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10869/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3682/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data were produced by the project team and supplied for archiving at the Centre for Environmental Data Analysis (CEDA).",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12293/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/5002/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/39188/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/186962/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/186963/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/186964/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/186965/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/186966/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/186967/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190805/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190815/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190806/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190807/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190809/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190810/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190811/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190812/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190813/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/190814/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/39192/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}