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

{
    "ob_id": 10937,
    "uuid": "dc8c9a1dfba24a0187e22740404385fd",
    "title": "NASA Solar TErrestrial RElations Observatory (STEREO) Sun Earth Connection Coronal and Heliospheric Investigation (SECCHI) data",
    "abstract": "Data from the Sun Earth Connection Coronal and Heliospheric Investigation (SECCHI) suite of instruments on board the NASA Solar TErrestrial RElations Observatory (STEREO) spacecraft, from 2006-12-13 onwards.\r\n\r\nThe UK Solar System Data Centre (UKSSDC) holds datum from the Sun Earth Connection Coronal and Heliospheric Investigtion (SECCHI). SECCHI is a suite of instruments on board NASA's twin Solar TErrestrial RElations Observatory (STEREO)spacecraft. These spacecraft monitor the Sun from two different points, making a 3D description of solar events possible. \r\n\r\nThe SECCHI suite consists of 5 cameras:\r\n\r\nEUVI\r\nExtreme UltraViolet Imager - Images the full solar disk in 4 different wavelengths [He II 30.4 nm, Fe IX 17.1 nm, Fe XII 19. 5nm, Fe XV 28.4 nm]\r\nCOR1\r\nA classic Lyot internally occulting refractive coronagraph, with a field of view is from 1.3 to 4 solar radii. A linear polarizer is used to suppress scattered light, and to extract the polarized brightness signal from the solar corona.\r\nCOR2\r\nAn externally occulted Lyot coronagraph, with a field of view from 2.5 to 15 solar radii.\r\nHI_1\r\nHeliospheric Imager 1 - white light camera with a 20 degree field of view centred 14 degrees off the Sun in the ecliptic plane.\r\nHI_2\r\nHeliospheric Imager 2 - white light camera with a 70 degree field of view centred 54 degrees off the Sun in the ecliptic plane.\r\n\r\nDatum from each of these cameras is available at processing level 0.5 (see below). \r\nDatum from the HI instruments is available at processing levels 1 (see below) and 2 (see below). The primary goal of these instruments is to detect and describe Coronal Mass Ejections (CME's), in particular halo CME's (Earth-bound CME's). \r\n\r\nProcessing Levels \r\n\r\nLevel 0.5 :\r\nData processed to level 0.5 is downloaded from the Naval Research Laboratory, Washington DC.\r\n\r\n\r\nLevel 1:\r\nHI data is then subsequently processed to level 1 by the UKSSDC. This means that the images have been processed by the SECCHI_PREP routine to remove the effects of the shutterless readout and to apply a flatfield. The treatment can be roughly broken down as follows: \r\n1. Reject corrupted images - a list is maintained of images that were badly corrupted in processing and transmission - these images are not processed to level 1. \r\n2. Extract cosmic ray report - [only present in s4 images]. The pixels are replaced by a duplicate of the line below to allow subsequent processing. \r\n3. Remove columns where saturation has occurred on the CCD - due to there being no shutter on the camera it is not in general possible to recover columns where saturation has occurred. Bright stars and planets often saturate. \r\n4. De-smear the image - by applying a matrix multiplication algorithmically remove the smear caused in clearing and readout of the CCD. This process automatically normalises the exposure time to 1 second and removes the summing effect in the s4 images. \r\n4. Remove pixels marked as having missing telemetry from the image. \r\n5. Apply a calibration factor to the image - currently this allows for the geometric effect in the lenses and for a linear production feature in the CCD. \r\nThe pointing information in the header is updated by reference to the observed starfield.\r\n\r\n\r\nLevel 2:\r\nLevel 1 images are then processed to remove light scattered from the f and k coronas. These images a dubbed level 2. \r\nLevel 2 processing involves: \r\n1. Selecting a running window of 1 or 11 days\r\n2. Selecting the lowest 25% of the data within that window\r\n3. Forming an average of that on a pixel by pixel basis\r\n4. Subtracting this from the original image\r\nThis forms the L2_1_25 and L2_11_25 data sets, depending on whether a 1 or 11 day running window has been used.",
    "keywords": "STEREO, SECCHI",
    "publicationState": "working",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/19775/?format=api",
        "dataPath": "http://www.ukssdc.ac.uk/solar/stereo/data.html",
        "oldDataPath": [],
        "storageLocation": "external",
        "storageStatus": "offline",
        "volume": 0,
        "numberOfFiles": 0,
        "fileFormat": "Unknown"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3036/?format=api",
    "geographicExtent": null,
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "needed",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/19811/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/19776/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/10936/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39312/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/74825/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39309/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39315/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39316/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39308/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39310/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39314/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39313/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39311/?format=api"
    ],
    "procedureAcquisition": null,
    "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": []
}