sstcam-tio 2.0.1

Pure Python reader of SST camera waveform files.

tio

Python Reader for sstcam-waveform/TargetIO waveform files, utilising fitsio and numba.

These files are FITS containing binary tables, which have been used as an intermediate format to store waveforms from the SST (Small-Sized Telescope) camera of CTAO (Cherenkov Telescope Array Observatory), and are generated by the sstcam-waveform or the TargetIO packages.

This package provides convenient read-only access to the waveform files, with support for both R0 (uncalibrated) and R1 (calibrated) data, as full-camera and single-module files. The reader is designed for efficient access to waveform data and event properties, with support for iterating through events in a file.

• Supported Python versions: 3.10+
• Supported platforms: Linux, OSX
• Source: https://gitlab.cta-observatory.org/cta-array-elements/sst/camera/analysis/tio
• License: BSD-3-Clause

Installation

This package is installable via pip from PyPI:

pip install sstcam-tio

This package is also installable via pip directly from this repository (via https or ssh), e.g.:

pip install 'git+https://gitlab.cta-observatory.org/cta-array-elements/sst/camera/analysis/tio.git'

Optional Dependencies

Utilisation of Intel's short vector math library (SVML) for improved performance provided by numba:

conda install intel-cmplr-lib-rt

Usage

from tio import Reader
import numpy as np

path = "path/to/file_r0.tio"
event_index = 2
with Reader(path) as reader:

    # Read a single event
    event = reader[event_index]
    wfs = event.waveforms  # Access waveforms
    print(wfs.shape)  # Shape: (n_pixel, n_samples)
    first_cell_id = event.first_cell_id  # Access event properties

    # Iterate through file
    for event in reader:
        pass