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

{
    "ob_id": 40876,
    "uuid": "40f0f38023ac40f6b40bbf96e4dc5258",
    "title": "ForestScan Project : Terrestrial Laser Scanning (TLS) of FBRMS-01: Paracou, French Guiana 1ha plot FG8c4, September to October 2022",
    "abstract": "Terrestrial laser scanning (TLS) was conducted at three ForestScan 1ha (100m x 100m) Forest Biomass Reference Measurement Site (FBRMS) plots in French Guiana from September to October 2022 by Cecilia Chavana-Bryant using a Riegl VZ-400i scanner. This data collection was part of the European Space Agency (ESA) funded ForestScan project designed to improve the use of new Earth Observation (EO) estimates of above ground biomass (AGB) by providing TLS-, unmanned airborne vehicles (UAV-LS)- and airborne (ALS) LiDAR scanning-derived AGB and tree census data to compare to allometric and EO-derived estimates.\r\n\r\nScans were acquired using chain sampling at 121 locations along a 10m Cartesian grid to ensure sufficient data overlap to produce high-quality point clouds for all ForestScan 1ha FBRMS plots. Due to the scanner's 100° field of view, capturing a complete sample of the scene at each scan location required two scans -an upright scan and a tilt scan. Upright scans are odd-numbered while tilt scans are even-numbered. The first scan at each plot is collected at the southwest corner, i.e. scan position 0,0 (unless something impedes it, e.g. stream, large tree fall, etc. or if the plot is oriented differently). To facilitate scan registration, five retro-reflective targets were located between scan positions with all tilt scans along the first sampling line were oriented towards the same sampling position along the next sampling line and tilt scans at the ends of sampling lines (i.e. tilt scans along plot edges) were oriented towards the inside of the plot. This aids scan registration as it allows tilt scans to capture the previous scan location within its field of view. A total of 242 scans were collected at each plot.\r\n\r\nThe Riegl operating and processing software RiSCAN PRO version 2.14.1 was used to generate a plot-level point cloud, scans were coarse registered using the shared retro-reflective targets located between consecutive scan positions. Coarse registration was then fine-tuned using Multi Station Adjustment 2 (MSA2).\r\n\r\nData for each of the three FBRMS plots is found within plot directories: FG5c1, FG6c2 and FG8c4. Plot directories contain a main project directory (named using the starting date of data collection, e.g. 2022-09-26_FG8c4.PROJ) with nine data subdirectories and a tile_index.dat file as shown in the  archived document /neodc/forestscan/data/french_guiana/paracou/TLS_Plot_FG8c4/ForestScan_example_data_directory_structure.pdf which details the data structure shared by all FBRSM plot TLS datasets.",
    "keywords": "ForestScan project, GEO-TREES, BIOMASS mission, European Space Agency (ESA), Earth Observation (EO) calibration/validation, Terrestrial LiDAR Scanning (TLS), Unpiloted Aerial Vehicle LiDAR Scanning (UAV-LS), Aerial LiDAR Scanning (ALS), Digital twins, Above Ground Biomass (AGB) estimates, Carbon estimates, Forest structure, Tree segmentation, 3D tree structure, Field protocols",
    "publicationState": "citable",
    "dataPublishedTime": "2025-03-27T13:51:09",
    "doiPublishedTime": "2025-03-28T16:55:10.982432",
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/43561/?format=api",
        "dataPath": "/neodc/forestscan/data/french_guiana/paracou/TLS_Plot_FG8c4/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1511278928546,
        "numberOfFiles": 1025581,
        "fileFormat": "Terrestrial LiDAR scanner data in csv, point cloud and Riegl Proprietary raw data format. Details of formats and data structure can be found in the following archived document /neodc/forestscan/data/french_guiana/paracou/TLS_Plot_FG8c4/ForestScan_example_data_directory_structure.pdf which details the data structure shared by all FBRSM plot TLS datasets. Further explanation of the files and their origin can also be found in the process computation section."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/12107/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/4701/?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/13285/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/40337/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/40623/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198833/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198834/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198835/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198836/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198837/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/198838/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/207996/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/207999/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/207997/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/207998/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208417/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208418/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208419/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208420/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208421/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208422/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208423/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208424/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208425/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208426/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208427/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208428/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208431/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208432/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208433/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208434/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208436/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208437/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208438/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208439/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208440/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208435/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208448/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208443/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208444/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208450/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208445/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208451/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208452/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208446/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208441/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208430/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208429/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208447/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208449/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208453/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/208454/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/43559/?format=api",
    "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"
        }
    ]
}