InputFileFormat

Input File Format

The input to the trigger test framework are two files per subdetector:

Header File

This file stores the information needed to access the data in the raw data file

Raw data file

A binary file which stores all the simulated raw data (timestamps) of the subdetector

The header file is a colon- and line break separated file. The first two lines store general information on the binary file. The following lines store relative pointers to the binary files to separate events and read out boards (ROBs), one event per line.

$dataFileName
$sourceID:$numberOfReadOutBoards:$numberOfEvents
$eventLength1,$timeStamp1,$eventFineTime1:$listOfROBDataLengths1
$eventLength2,$timeStamp1,$eventFineTime2:$listOfROBDataLengths2
...
$eventLengthN,$timeStampN,$eventFineTimeN:$listOfROBDataLengthsN

Note: The header is different for SDEs

In this case the header keeps track of the number of SDEs that were generated per event rather than the number of read out boards. This is because a single SDE can back together multiple read out boards.

$dataFileName
$sourceID:$numberOfSDEs:$numberOfEvents
$eventLength1,$timeStamp1,$eventFineTime1:$listOfSDEDataLengths1
$eventLength2,$timeStamp1,$eventFineTime2:$listOfSDEDataLengths2
...
$eventLengthN,$timeStampN,$eventFineTimeN:$listOfSDEDataLengthsN

General information

The first two lines of the header file:

dataFileName

The name of the binary file this header file stores information on

sourceID

The detector sourceID of the data

numberOfReadOutBoards

The number of simulated readout boards (ROB) in the data

numberOfSDEs

The number of SDEs required to handle the number of simulated PCs. 1 PC = 1 SDE.

numberOfEvents

The number of simulated events in the data

Event based information

The following lines store information on the events within the binary file:

eventLength

Number of long words (32 bit) used to store the current event

timestamp (since version 0.10.0)

The timestamp of the event

listOfROBDataLengths

A comma separated list of data lengths. The n'th length defines the number of 32-bit words storing raw data for the n'th ROB. Therefore the sum of all length must be equal to eventLength

listOfSDEDataLengthsN

A comma separated list of data length.s The n'th length defines the number of 32-bit words storing raw data in the n'th SDE. The sum of all SDE lengths must equal the eventLength