succobt

This is succobt, a set of tools for early manipulation and online analysis of the data collected at INSULAb-like beamtests — see, e.g., this presentation and this other project. In particular

• asciinroot_to_root_pp/ takes the data output of the DAQ system (both waveform ROOT files and ASCII files with tracking data and digitizer fast analysis) and merges all the single-event information in dedicated level-2 ROOT files;
• ascii_stripper_merger/ takes the DAQ output ASCII files (typically one file per spill) and merges all the files of a single run into a single ASCII file;
• wf_analysis_preliminary/ takes the level-2 ROOT files and performs preliminary waveform analysis of a digitizer channel.

Notes on asciinroot_to_root_pp/

This project was developed starting from the TBtools project (on GitLab) by vmascagna, to whom I am deeply indebited.

Two versions of the tool are available:

• "_NOASCII" only merges single-digitizer waveform ROOT files, without any information from tracking or fast analysis;
• "_ASCIINROOT" takes the single-digitizer waveform information for the events available in the ASCII files and combines it with the information in the corresponding ASCII entries.

Either way, the core of the event reconstruction is in the asciinroot_to_root_pp_[VERSION].cc file. It can be run automatically as the data are collected and the DAQ output is produced (auto_update_root_files_[VERSION].sh) or manually on a selected set of data runs (manual_run_select_root_files_[VERSION].sh). Further details can be found in the comments to the source code.

Notes on wf_analysis_preliminary/

The analysis runs in a Jupyter notebook, wf_analysis_preliminary.ipynb. If explicitly required in the notebook, all the generated output (plots and text files) go into the output/ folder.

The analysis dependencies are:

Found a bug? Or simply have any questions, comments or suggestions you'd like to talk about? Feel free to contact me at [email protected]. And brace yourself, for the best is yet to come!