Level-1 DT Trigger Primitives emulatror 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 varoius trigger working parameters. Below is given a brief desctription 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 tigger 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 desribes 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 alghoritm.
  • 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 synchrronization (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 that include some trigger parameters to be used in analysis (for example to compare DTTPG performance in CMSSW and ORCA)

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

Type Name Description
untracked double syncDelay Is the delay to be subtracted from the DTDigi drift time in order to take into account signal propagation (in the future this parameter will be read, indipendently for each station, from a database)
untracked bool globalSync This parameter allow to synchronize all the BTIs with the same delay. It is used to otimize trigger efficiency. Default is false (each station configured indipendently)
untracked double globalSyncValue Delay value to be used if globalSync is set to true

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

Useful Links

-- CarloBattilana - 06 Sep 2006

Edit | Attach | Watch | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r1 - 2006-09-06 - CarloBattilana
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    Sandbox All webs login

  • Edit
  • Attach
This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2021 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback