Level-1 DT Trigger Primitives emulator TWiki

This page describes the code of the DT Trigger Primitives emulator in CMSSW. Below is included the description of each subpackage and of the EDProducer/EDAnalyzer used by DTTPG.

Description of the packages

Each electronic part of the L1 DT Local Trigger (BTI,TRACO...) has its CMSSW counterpart in a separated package, in addition the DTTPG emulator includes a L1Trigger/DTUtilities package that contains some general-pourpose classes, not strictly related with the emulation of a specific part of the trigger electronics. A L1Trigger/DTTrigger package with the trigger steering (as well as the various EDAnalyzer/EDProducer) is also included.

L1Trigger/DTUtilities

This package includes some helpful classes that are not strictly related to the emulations of the trigger electronics. The most important class included is DTConfig that contains the interface to configure various trigger working parameters. Below is given a brief description of every class included in the package.

• DTBtiId : a BTI identifier class, includes methods that returns BTIs station, sector, wheel, superlayer and BTI number in SL.
• DTCache : a virtual class that includes the general cache structure used by each L1 DT local trigger subsystem to store trigger data.
• DTConfig: this class contains every parameter used to configure the various trigger station. A more detailed description of these parameter can be found in DTConfig parameters page.
• DTGeomSupplier : a virtual class that defines the ability to calculate coordinates for DTTPG objects.
• DTParameter : defines the parameter interface used in DTConfig.
• DTParameterValue : contains the the value of a parameter and is used by DTParameter interface.
• DTTracoId : a TRACO identifier class, the same as DTBtiId but for TRACOs.
• DTTrigData : a virtual class common to all DTTPG trigger objects.
• DTTrigGeom : a Geometry package used to calculate DTTPG geometry stuffs (TRACOs and BTI coordinates ...).
• L1TriggerLutFile : a look up table class.

L1Trigger/DTBti

This package includes the BTI electronics description.

• DTBtiCard : contains the list of single DTBtiChips that generated a trigger signal.
• DTBtiChip : this class describes the single BTI chip.
• DTBtiHit : contains the hit generated from digis for BTIs.
• DTBtiTrig : a class derived from DTBtiTrigData contains trigger data and info from the BTI Chip that generated the data.
• DTBtiTrigData : BTI data generated from a trigger (step, code, K, X ...).

L1Trigger/DTTraco

This package contains the TRACO electronics description.

• DTTracoCand : description of the TRACO candidate used while TRACO algorithm is processed.
• DTTracoCard : contains the list of all DTTracoChips that generated a trigger signal.
• DTTracoChip : describes the single TRACO chip and runs TRACO algorithm.
• DTTracoLuts : TRACO look up tables inside the detector.
• DTTracoTrig : contains trigger data and info from the TRACO that generated the data (useful for debbugging).
• DTTracoTrigData : TRACO data generated from a trigger (code, step, position ...).
• Lut : TRACO luts used in Test Beams.

L1Trigger/DTTriggerServerTheta

This package describes the Trigger Server Theta electronics

• DTChambThSegm : theta segment candidate data.
• DTTSTheta : description of the TS theta algorithm.

L1Trigger/DTTriggerServerPhi

This package describes the Trigger Server Phi electronics.

• DTChambPhSegm : contains the TS Phi trigger data.
• DTTSCand : description of the candidate for the TS.
• DTTSM : implementation of the TSM algorithm.
• DTTSPhi : implementation of the whole TS algorithm.
• DTTSS : implementation of the TSS algorithm.

L1Trigger/DTSectorCollector

This package contains the Sector Collector electronics description.

• ???????????????????????????

L1Trigger/DTTrigger

This package contains the main DTTPG steering and the various EDProducer/EDAnalyzer.

• DTTrig : this is the DTTPG steering.
• DTTrigProd : EDProducer used to generate data for the DTTF (Description of its usage is below).
• DTTrigTest : EDAnalyzer used to study trigger output and compare it with ORCA products (Description of its usage is below).
• DTTrigFineSync : EDAnalyzer used to generate the .cfi file used for station by station fine synchronization (to be used by trigger experts!!!)

DTTPG Data Formats

• The emulator are collections of the input drift tubes digis format present in DataFormats/DTDigi ( DTDigi and DTDigiCollection classes).

• The DTTPG produces two different kind of collections, one for the theta segments (L1MuDTChambThDigi and L1MuDTChambThDigiContainer ) and one for the phi segments (L1MuDTChambPhDigi and L1MuDTChambPhDigiContainer). All the DataFormats are in the DataFormats/L1DTTrackFinder).

All the intermediate-step formats (such as DTBtiTrigData, DTTracoTrigData ...) are not saved into the event and are just used by the intermediate steps of the DTTPG.

DTTPG Producer and Analyzer

Into the L1Trigger/DTTrigger package are included some instruments to analyze trigger data and produce DT trigger primitives.

1. PrimitivesProd.cfg runs an EDProducer that generates the trigger primitives used to feed the DTTF.
2. treeGen.cfg runs ans EDAnalyzer that generates a rootfile with trigger related results useful for analysis (eg. to compare DTTPG performance in CMSSW and ORCA).

Both the modules can be configured through a set of parameters:

In addition the untracked string outputFileName allow to select the output filename for the EDAnalyzer.

Useful Links

• Level-1 Local trigger emulator discussion forum.
• DTTPG code is present into the CMSSW Repository at CERN.

-- CarloBattilana - 06 Sep 2006