Python Bindings for the SWGO Waveform Library

This are the Python bindings for the SWGO Waveform Library. The bindings can be installed from PyPI:

pip install swgo-wave

If your operating system is not supported, you can install them manually:

git clone --recursive git@gitlab.com:swgo-collaboration/simulation/swgo-waveform-python-bindings.git
cd swgo-waveform-python-bindings
python -m pip install .

FlashCam Simulation

To simulate the FlashCam electronics, use:

import libwaveform as wf

fc = wf.make_flashcam()
triggers = fc.simulate([...],1)

for t in triggers:
    # t.channel - int
    # t.trigger_time_s - int (seconds since run start)
    # t.trigger_time_ticks - int (ticks since last full second, tick = 4ns)
    # t.baseline - float (ADC baseline)
    # t.intsum - float (sum of waveform)
    # t.waveform - list* of int

make_flashcam() creates a FlashCam object with the FlashCam default settings. You can directly create FlashCam instances by invoking its constructor wf.FlashCam(). Use help(wf.FlashCam) for the documentation of the constructor parameters.

The trigger and waveform objects are native C++ objects. The waveform objects support the python list interface for integers.

MultiPMT Simulation

The MultiPMT electronics (which is not fully supported yet) can be simulated with:

import libwaveform as wf

mp = wf.make_multipmt()
triggers = mp.simulate([...],1)

for t in triggers:
    # t.channel - int
    # t.time - float (trigger time in seconds)
    # t.time_over_threshold - float (in seconds)
    # t.adc_sample - float (in LSB)

make_multipmt() creates a MultiPMT object with the MultiPMT default settings. You can directly create MultiPMT instances by invoking its constructor wf.MultiPMT(). Use help(wf.MultiPMT) for the documentation of the constructor parameters.

Electronics Interface

The bindings provide access to the Electronics interface:

import libwaveform as wf

electronics = wf.Electronics("settings.yaml")
triggers = electronics.simulate([...])

The input is a list of (int, PE) tuples.

Settings can be generated with python -m libwaveform.generate_settings (use --help for documentation). You might need to change the path to the channel map (channel_maps.main_map.config). All other files can be generated with the --files option.