Developer API#

The functions and methods documented in this section are the internal workings of the OpenGHG library. They are subject to change, we’ll add deprecation warnings to functions if we’re going to phase them out in the next few releases.

Warning

Normal users should not use any of the functions shown here directly as they may be removed or their functionality may change.

Cloud#

Handles the packaging of data and the calling of serverless functions for the cloud platform.

Dataclasses#

These dataclasses are used to return data and metadata from the object store. Some of them also contain helper functions to quickly plot data, modify metadata and delete data in the object store.

Data objects

Object Store#

These functions handle the storage of data in the object store, in JSON or binary format. Each object and piece of data in the object store is stored at a specific key, which can be thought of as the address of the data. The data is stored in a bucket which in the cloud is a section of the OpenGHG object store. Locally a bucket is just a normal directory in the user’s filesystem specified by the path given in the configuration file at ~/.config/openghg/openghg.conf.

Objectstore
- Local

Retrieval functions#

These handle the retrieval of data from the object store.

Retrieve

Standardisation#

Surface measurements#

These functions take surface measurement data and standardise it for storage in the object store. They ensure the correct metadata and attributes are recorded with the data, and that the data is CF compliant. They are called by the ObsSurface class.