DDASReadout

Name

DDASReadout -- Read data from XIA digitizer modules.

Synopsis

$DAQBIN/DDASReadout [options....]

DESCRIPTION

Unlike NSCLDAQ 11.3, you will not normally need to directly run this program. Instead, specifying $DAQBIN/ddasReadout (rather than $DAQBIN/DDASReadout) as the data source will run both the DDASReadout and associated ddasSort programs.

Since NSCLDAQ 11.4, DDASReadout does not internally sort data from the DDAS modules. Deferring the sort to another process substantially improves performance by allowing that sort to run in parallel with the readout itself.

This version of DDASReadout is an upstream readout program. It reads data directly from XIA modules and outputs that data to a ringbuffer. Each module is read out in chunks, such that each output ring item contains multiple unsorted hits all coming from a single module.

Program options

--port integer

If Tcl server functionality is needed, this is the port on which that server will be listening for connections. If not specified, DDASReadout will have its Tcl server functionality disabled.

--ring ringname(default=tcp://localhost/$USER)

The output ringbuffer name on the host machine where DDASReadout is run. This specifies the name of the ringbuffer into which DDASReadout reads data. Defaults to your username.

--sourceid value (default=0)

This determines the source ID value used to tag ring items from the readout program.

--init-script path

The value should be a path to a Tcl script that will be run as the readout program starts.

--log path

This specifies the path into which the readout program logs interesting information. If the file does not exist it is created. The path prefix must be a directory that's writable by the user.

--debug log-level (default=0)

This parameter is an integer in the range 0-2 inclusive and determines the sort of information written to the log file. The higher the number, the more verbose the logging.