Eudaq integration

---

WARNING

This is work in progress. Pymosa integration into EUDAQ is not finished or even working yet.

Introduction

Pymosa can connect to the data acquisition framework EUDAQ, which is the common run control software used at pixel test beams.

EUDAQ 1.x

For the installation of EUDAQ 1.x please follow this wiki. To use the EUDAQ libraries within Pymosa a python wrapper is used. This wrapper is not build with default settings, thus the following cmake option must be specified when building EUDAQ -DBUILD_python=ON.

Example minimal installation

The following commands setup EUDAQ 1.x development version for Pymosa with minimum requirements (no ROOT, no Qt) and are tested on Ubuntu 14.04 LTS. This installation is sufficient to use and test the Pymosa Eudaq producer. The paths /home/user/git have to be adjusted to your system, of cause.

Install dependencies

EUDAQ needs a recent cmake3 version that might not be shipped with your distribution. This is a known issue. To install a recent version under Ubuntu do

wget https://cmake.org/files/v3.11/cmake-3.11.1.tar.gz
tar xf cmake-3.11.1.tar.gz
cd cmake-3.11.1
./configure
make -j 4
sudo apt-get install checkinstall
sudo checkinstall

Install eudaq 1.x

git clone -b v1.x-dev https://github.com/eudaq/eudaq
cd eudaq/build
cmake -DBUILD_python=ON -DBUILD_gui=OFF -DBUILD_onlinemon=OFF -DBUILD_runsplitter=OFF -DUSE_ROOT=OFF ..
make -j 4
make install

The producer has to know the installation path of EUDAQ. One way is to specify PYTHONPATH to include the python folder in the EUDAQ directory, e.g.:

export PYTHONPATH="${PYTHONPATH}:/home/user/git/eudaq/python"

This is not needed when you mention the path of the eudaq installation for every call to pymosa_eudaq (see below).

Usage of pymosa

A simple command line interface is provided to start the pymosa producer:

pymosa_eudaq --help

Please read the help output for program parameters.

If you did not add the EUDAQ directory to the PYTHONPATH explicitly after installation (see above) you can give the path when running pymosa_eudaq, e.g.:

pymosa_eudaq --path /home/user/git/eudaq

Debugging and testing

Replay feature

It is possible to replay a recorded raw data file from an external trigger scan with correct timing to test the system. This allows development and debugging without hardware. To replay e.g. the a test beam file shipped with the Mimosa26 interpretation package one has to type:

pymosa_eudaq --replay anemone_raw_data.h5

Sometimes it is not needed to replay the data in real time. You can delay the data sending for every read out by an arbitrary time by specifying a delay parameter. For example to add a delay of one second you can type:

pymosa_eudaq --replay anemone_raw_data.h5 --delay 1

Unit test

---

WARNING

Not yet implemented

A unit test is also available to test the complete chain: pymosa producer + DataConverter + Run Control. To test if everything is setup correctly open a console and make sure you added eudaq to you python path (see above). Then go to the pymosa/tests folder and type

python test_eudaq.py

This test succeeds if everything is setup correctly.