EVBC::initialize

Name

EVBC::initialize -- Initialize the EZBuilder layer.

Synopsis

EVBC::initialize options

DESCRIPTION

Intended to be called from your OnStart proc. This initializes the EZBuilder and controls how it will behave. The parameters to this command are option value pairs. See EXAMPLES below for some typical option sets.

For information about the specific options, see OPTIONS below and EVBC::start.

OPTIONS

The EVBC::initialize command accepts all options that the EVBC::start understands as well as the following additional options:

-gui on | off

If -gui is true, EZBuilder will add a control strip to the bottom of the ReadoutGUI control panel. This control strip will give you dynamic control over the options controlled by EVBC::initialize.

Only do this if you trust your users to be able to set sensible values in this user interface. If you don't you will sleep better at night choosing the options you want and disabling the GUI strip.

-restart yes | no

If -restart is yes, the event builder pipeline is restarted at the beginning of each run (See EVBC::onBegin). Otherwise, the event builder timstamp memory is just reset at the beginning of each run and the event builder pipline is only started at the beginning of the first run.

EXAMPLES

The example below does not allow event builder parameters to be modified between runs. It requests a new instance of the event builder for each run. Note that this implies that the begin run will invoke startEVBSources if that command/proc has been defined. That allows you to start fragment sources after the event builder pipeline has been started.


EVBC::initialize -glombuild yes -glomdt 200 -destring built -restart yes -gui off
                

The exmple below initially requests a restart before each run but, since the GUI is enabled, this can be modified by the user.


EVBC::initialize -glombuild yes -glomdt 200 -destrign built -restart yes -gui on