offlinereglom

Name

offlinereglom -- Offline event rebuilder.

Synopsis

$DAQBIN/offlinereglom

DESCRIPTION

reglom is a utility that has at least two use cases:

  1. If you have an event built run with data late conditions, reglom can rebuild the event file with properly ordered data. This can happen with, e.g. DDAS if the FIFO_THRESHOLD values are not set properly to allow for differing rates in different readout systems.

  2. If you find that you want to rebuild event built data using a different coincidence window, reglom can do that as well.

reglom is actually a script that accepts event building parameters, a run to reglom and an output file. Reglomming occurs in two stages:

  1. The input run is unglommed into event files consisting of data from each of the source ids. These files are temporary and have names like sid-sid where sid is the input source id of the data in that file. These files are written in the current working directory. You must therefore have write access to this directory and sufficient quota to allow these files to be written.

  2. The files generated by the unglom stage are then fed as ordered fragments into the NSCLDAQ glom command which produces, as output, the rebuilt event file.

Note that while NSCLDAQ must be installed on the system running reglom, it need to be running (that is the servers that manage ringbuffers don't have to be running as no ring buffers are created or used).

The GUI

reglom provides a GUI to steer the reglomming process. The top part of the GUI accepts parameters used by glom, specifically the coincidence interval used to build fragments into events, the output sourceid and the policy used to provide timestamps to the output events.

The middle part of the GUI allows you to select the run to reglom. If your run is a multi-segmented run, choose any segment file in the run. All files will be reglommed into a single output event file that combines all the event fragments in all segments. The values accepted here are saved in the file ~/.reglom. If that file is present, default values are loaded from that file, allowing you to perform several reglom operations using the same settings.

The bottom part of the GUI allows you to select the output event file name. This is the file created by reglom that will contain the rebuilt data.

To proceed with the reglom, click the Ok button. To do nothing, click Cancel.

As the unglom phase runs, the script shows the size of each of the segment files and any messages emitted by the unglom program. Similarly, as the glom phase runs, the script shows how the size of the output file grows and any messages from the reglom/glom pipeline