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

{
    "ob_id": 30050,
    "uuid": "77d63a69e3554412a40c9a9ba564e3f9",
    "title": "SWIGS: Gorgon Magnetohydrodyamic Code Simulation Data: Magnetospheric and Ionospheric Conditions under Southward IMF for 0-90 degree Dipole Tilts",
    "abstract": "This dataset contains data outputs generated using the Gorgon Magnetohydrodynamic (MHD) code, for simulations of the steady-state magnetosphere-ionosphere system during southward interplanetary magnetic field (IMF) with dipole tilt angles from 0-90 degrees. This data were collected as part of the NERC project Space Weather Impacts on Ground-based Systems (SWIGS).\r\n\r\nThe MHD equations were solved in the magnetosphere on a regular 3-D cartesian grid of resolution 0.5 RE (Earth radii), covering a domain of dimensions (-30,90) RE in X, (-40,40) RE in Y and (-40,40) RE in Z with an inner boundary at 4 RE. In this coordinate system the Sun lies in the negative X-direction, the Z axis is aligned to the dipole in the 0 degree tilt case (where positive tilt points the north magnetic pole towards the Sun), and Y completes the right-handed set. The ionospheric variables were calculated on a separate 2-D spherical grid of dimensions 66x128 in latitude and longitude (with the north pole at 90 degrees latitude and the sun at 180 degrees longitude), coupled to the magnetospheric domain at the inner boundary. \r\n\r\nOutput data is timestamped in seconds and is defined at the centre of the grid cells. The simulation data corresponding to each dipole tilt are stored in separate directories 'XXdeg', e.g. in '00deg' for a 0 degree tilt angle. The data are stored in hdf5 format.\r\n\r\nThe magnetospheric variables are stored in the files 'Gorgon_[YYYYMMDD]_[XX]deg_MS_params_[XXXXX]s.hdf5' where XX is the tilt angle in degrees and XXXXX is the simulation time in seconds. The magnetospheric data includes the magnetic field ('Bvec_c'), plasma bulk velocity ('vvec') and electric current density ('jvec') after 4h of simulation, as well as the magnetic field and velocity in 5 minute intervals for the preceding 30 minutes. The dataset for each magnetospheric variable is of shape (240,160,160,3) where the first 3 dimensions are the grid indices in (X,Y,Z) indexed from negative to positive, and the final dimension is the cartesian vector components in (i,j,k). \r\n\r\nSimilarly, the ionospheric data are stored as 'Gorgon_[YYYYMMDD]_[XX]deg_IS_params_[XXXXX]s.hdf5', containing the field-aligned current ('FAC') and electric potential ('phi') after 4h of simulation, as well as the potential in 5 minute intervals for the preceding 30 minutes. The dataset for each ionospheric variable is of shape (66, 128) where the first dimension is the grid index in colatitude, indexed from the north towards the south (i.e. 0 to 180 degrees), and the second dimension is the grid index in longitude, indexed from midnight towards noon via dawn (i.e. 0 to 360 degrees).",
    "keywords": "SWIGS, Space, weather, Gorgon Magnetohydrodyamic Code",
    "publicationState": "citable",
    "dataPublishedTime": "2020-02-26T14:16:38",
    "doiPublishedTime": "2020-04-09T13:23:57",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/30051/?format=api",
        "dataPath": "/badc/deposited2020/swigs/data/gorgon-dip-tilt/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 22124097315,
        "numberOfFiles": 142,
        "fileFormat": "Data are HDF5 formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10269/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data collected by the project participants and sent to the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10709/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/30053/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129842/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129849/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129851/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129850/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129847/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129848/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129843/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168900/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129844/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129845/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/129846/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/30052/?format=api",
    "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"
        }
    ]
}