GAPS Online Software documentation#

GAPS Online Software ("gondola") compriseses several components.

  • liftof system - flight software for the TOF computer, data acquisition

    GAPS run scheduling, RB communication, calibration, MTB interaction. It contains several binaries to be run on various components of the TOF system.

  • gondola-core - core library with dataclasses to read data structures.

    This included TOF only structures, data sent over telemetry, TOF data from disk, etc. Gondola core allows to calibrate the event data as well

  • gondola - The actual name of the python packet on pypi

  • gondola_cxx - Another python packet on pypi, built from the CXX implementation

    of gondola-core. This is typically not needed to be installed or used in any way, it is designed for internal testing. However, this will expose some further functionality related to the interplay with SimpleDet, ROOT and Geant4 in the future.

  • gander - a streamlit app which allows to have a quick look into

    recorded data on disk or hook up to a telemetry stream

The code is mainly written in RUST and exposed to python through pyo3. There is additional C++ code which implements the same API, and can be used for compatiblity with C++ applications.

The python API of gaps-online-software wraps the gondoala-core rust API with pyO3. The python module is called gondola.

PYTHON API Software documentation#

Installation#

The oython code can be install through pip/uv e.g.

pip install gondola

or when using rye

rye add gondola

API docs#

gondola

gondola - GAPS online software core suite for python.

RUST API Software documentation#

The "heart" of the project - implementes necessarry dataclasses and i/o operations

gondola-core (common library)

TOF flight computer code for data acquisition and control in-flight

liftof-cc

TOF RB data acquisition/control code to be controled by liftof-cc

liftof-rb

Run scheduler to manage settings and do bookkeeping of them

liftof-scheduler

Terminal application to monitor TOF activity

liftof-tui

CXX API Software documentation#

Doxygen API docs