Ecal TP emulator TWiki

Complete:

Introduction

The EcalTrigPrimProducer class takes EBDataFrame and EEdataFrame collections and constructs one EcalTriggerPrimitiveDigi for each trigger tower found in input. The software design aimed at reflecting the hardware as far as possible/reasonable.

Detailed Description

Packages and dependencies

Barrel part

2 main classes:

• EcalBarrelFenixStrip containing 5 subclasses:
  • EcalFenixLinearizer
  • EcalFenixEtStrip
  • EcalFenixAmplitudeFilter
  • EcalFenixPeakFinder
  • EcalFenixStripFormat
• EcalBarrelFenixTcp
  • EcalFenixBypassLin
  • EcalFenixEtTot
  • EcalFenixMaxof2
  • EcalFenixTcpFormat
  • EcalFenixFgvbEB

Endcap part

to come...

Endcap particularities:

In the endcap:

• the 2 inner rings (ieta =27,28) contain half number of real trigger towers. Each existing trigger tower gives rise to 2 virtuel tirgger towers and so 2 trigger primitives where each of them contains half the energy of the real trigger tower. This is taken into account in the EcalTrigPrimAnalyzer.
• EEDataFrames come with a scaling (AdcToGeV= 0.060) different from EBDataFrames (AdcToGeV= 0.035;). As a workaround, as long as the endcap emulation does not use calibration parameters, the endcap TP-s have been rescaled to the barrel TP-s.

How to run the emulator

• Using TPG.txt file

1) Please put your TPG.txt file into the "/data" directory of the SimCalorimetry/EcalTrigPrimProducers package. The TPG.txt file should be compressed (format *.gz).

2) Addapt ecalTrigPrimESProducer_cff.py file from SimCalorimetry/EcalTrigPrimProducers/python putting the TPG.txt file's name.

3) Include ecalTrigPrimESProducer_cff.py into SimCalorimetry/EcalTrigPrimProducers/python/ecalTriggerPrimitiveDigis_cff.py configuration file adding the following command from EcalTrigPrimProducers.ecalTrigPrimESProducer_cff import *

4) Include SimCalorimetry/EcalTrigPrimProducers/python/ecalTriggerPrimitiveDigis_cff.py into your main configuration file process.load("SimCalorimetry.EcalTrigPrimProducers.ecalTriggerPrimitiveDigis_cff")

Please note that several examples are avalaible in the SimCalorimetry/EcalTrigPrimProducers package under the "/test" directory.

• Reading the offline db

Example to be addapted : SimCalorimetry/EcalTrigPrimProducers/test/writeTP_DBOffline_cfg.py

1) Addapt the name of records and the tags

2) Connect to the right database (could be orcoff db or local sqlite file)

Offline software validation

Description

The original validation code for the Ecal TPG is situated in the package Validation/EcalTriggerPrimitives. This code has been updated for the automatic CMS.RelVal validation and copied to the package Validation/L1Trigger.

To execute the validation

• In the Validation/EcalTriggerPrimitives: run the script file validateTPG.csh.
• In the Validation/L1Trigger: run the python configuration file ecaltpgvalidation_cfg.py.

Plots done by the validation

• Transverse energy for the Ecal barrel and endcap
• Fine grain veto bit for the Ecal barrel and endcap
• Trigger Tower Flag Ecal barrel and endcap

The results for the offline software validation of the ECAL TPG are available for various releases in EcalTPGOfflineSoftwareValidationResults.

Review Status

Editor/Reviewer and date	Comments
Main.uberthon - 07 Nov 2006	page content last edited
CMSUserSupport - 12 Mar 2007	moved page into swguide
JennyWilliams - 13 Mar 2007	editing to match swguide layout

Responsible: Main.emiliabecheva
Last reviewed by: MostRecentReviewer and date