RTAlib-LST1

Installation

Prerequisities

• A python 3.6 virtual environment

Procedure

• Download the source code

cd ~/
git clone https://github.com/cta-rta/RTAlib-LST1
git clone https://github.com/rta-pipe/RTAlib

• Execute the following commands to create databases, users, tables and configuration files for the RTAlib.

cp RTAlib-LST1/SetupDB/mysql/setup_lst_datalayers_tables.sql RTAlib/SetupDB/mysql/
bash RTAlib/SetupDB/setup_db.sh

• Fill in the configuration files fields
• Activate the python virtual environment and execute the following commands to install the python dependencies.

cd ~/RTAlib/PyRTAlib
python setup.py install

Running the tests

In order to run the unit tests, you have to define the RTACONFIGFILE environment variable that must point the rtalibconfig_testing configuration file.

RTAlib unit tests

export RTACONFIGFILE=~/RTAlib/Configs/rtalibconfig_testing
bash RTAlib/PyRTAlib/TestEnvironment/unit_tests/run_unit_tests.sh

RTAlib-LST1 unit tests

export RTACONFIGFILE=~/RTAlib/Configs/rtalibconfig_testing
export PYTHONPATH=~/RTAlib/PyRTAlib
cd ~/RTAlib-LST1/PyRTAlib/TestEnvironment/unit_tests
python RTA_EVT1_DB_unittest.py -v

Configure the software

You can improve the software event-rate by changing the values of the batchsize and numberofthreads parameters in the configuration file. Warning: with numberofthreads > 1, the feature [B] of the RTAlib will be disabled.

Running the software

Importing the RTAlib/RTAlib-LST1 modules

You have to set the path to the RTAlib modules within the PYTHONPATH to make them globally available.

export PYTHONPATH=~/RTAlib/PyRTAlib:~/RTAlib-LST1/PyRTAlib

Now you can import modules from the RTAlib and RTAlib-LST1 libraries inside your code.

Example

Import the EVT1 interface to stream EVT1 into RTAlib database

from lst_PyRTAlib.RTAInterface import RTA_EVT1_DB

Instantiate an object and choose the database (mysql, redis)

rta_evt1_db = RTA_EVT1_DB('mysql')

Use the following method to stream the data

rta_evt1_db.insertEvent( evt2_data.evtnum[i], evt2_data.time[i], evt2_data.ra[i], ..)

Close the connection

rta_evt1_db.waitAndClose()