SWGuideL1Trigger < CMSPublic

---+!! L1 Trigger Offline Software
%COMPLETE2%

%TOC{depth="6" title="Contents:"}%

---++ Goal of this page

This chapter documents the L1 trigger offline software. The hardware is documented in the [[http://cmsdoc.cern.ch/cms/TDR/TRIGGER-public/trigger.html][Trigger TDR]] and via some subsystem wiki pages at [[https://twiki.cern.ch/twiki/bin/view/CMS/L1Trigger][L1Trigger]]. 

This page, as well as the linked pages, are under active restructuring.


---++ Introduction

The L1 Trigger offline software includes packages that provide: 
   * data formats for all the L1 EDM products
   * bit-level emulation of the trigger electronics
   * tools for interpreting, monitoring, analysing and validating L1 data.

---+++ L1 Trigger Offline Software: Developers, Packages, Development Plans, Tags and Releases

A complete list of L1 Trigger offline packages and the list of persons responsible for these packages, as well as a developer list can be found in the wiki  page [[SWGuideL1OfflineDevelopers][L1 Trigger Offline Software: Developers and Packages]].


Coordination links:
   * [[SWGuideL1TOfflineDev][L1 Trigger Offline Software Development Planning Web Page]]
   * [[SWGuideL1OfflineDevelopers][L1 Trigger Offline Software: Developers and Packages]]
   * [[SWGuideL1TriggerDev][Development plans for L1 offline software]]
   * [[CMS.L1SoftwareMilestones][L1 Software milestones]]
      * [[CMS.L1SoftwareStatusVsCmsswReleaseDeadline][Status of L1 offline software vs 31X deadline]] 
   * [[SWGuideL1ReleaseNotes][L1 offline software release notes]]
   * [[SWGuideL1TriggerTagList][L1 trigger offline software tags]]
   * [[SWGuideL1TriggerTagRequirements][Requirements for submitting new L1 trigger tags to integration builds]]


---++ L1 Trigger offline software components

---+++ L1 Trigger subsystems offline software
   * [[SWGuideEcalTPEmulation][ECAL Trigger Primitive Generator]]
   * [[SWGuideHcalTPG][HCAL Trigger Primitive Generator]] 
   * [[SWGuideRegionalCaloTrigger][Regional Calorimeter Trigger]]
   * [[SWGuideGlobalCaloTrigger][Global Calorimeter Trigger]]
   * [[SWGuideDTTPG][DT Trigger Primitive Generator]]
   * [[SWGuideL1DTTrackFinder][DT Track Finder]]
   * [[SWGuideCSCTPGEmulator][CSC Trigger Primitive Generator]]
   * [[SWGuideL1CSCTrackFinder][CSC Track Finder]]
   * [[SWGuideL1RPCTrigger][RPC Trigger]]
   * [[SWGuideL1GMTEmulator][Global Muon Trigger]]
   * [[SWGuideGlobalTrigger][Global Trigger]]

   * [[SWGuideL1TStage1Instructions][Stage 1 calorimeter trigger upgrade]]

---+++ L1 Trigger technical triggers
   * [[https://twiki.cern.ch/twiki/bin/view/CMS/RpcTTUemulator][RPC Technical Trigger]]
   * [[https://twiki.cern.ch/twiki/bin/view/CMS/SWGuideBSC][Beam Scintillation Counters technical triggers]]

---+++ L1 Trigger common offline software tasks

   * [[SWGuideL1EmulatorConfiguration][Condition formats and O2O]] and [[SWGuideL1CondFormats][L1 Configuration Objects ]].
   * [[SWGuideL1DQM][L1 Data Quality Monitoring ]]
   * [[SWGuideL1SoftwareValidation][L1 Offline Software Validation]].
   * [[SWGuideL1TriggerHardwareValidation]]
   * [[L1TNtuples]]
   * [[L1TRawToDigi]]


---+++ Accessing L1 Trigger Data

   * [[SWGuideL1TriggerFAQ][L1Trigger Offline FAQ]] - FAQ about using/accessing L1 results READ IT
   * [[SWGuideL1TriggerL1GtUtils][L1GtUtils utility class]] - : easy access to main L1 trigger quantities 
   * [[SWGuideL1TriggerDigis][L1 Trigger "digis"]] - L1 trigger input tags in various workflows
   * [[CMS.L1TriggerEventContent][L1 Trigger event content ]] - event content for L1 in various data tiers
   * [[SWGuideL1Extra][L1Extra]] - physical representation of the L1 hardware output, and interface to the HLT

---+++ Trigger Studies Recipes

   * [[SWGuideL1SoftwareIntegration][L1SoftwareIntegration]] - how to run basic integration tests of L1 software
   * [[CMS.L1ValidationGlobalRun][CMS.L1ValidationGlobalRun]] - how to run emulator-based hardware validation
   * [[CMS.OnlineWBL1FastAnalyzer][CMS.OnlineWBL1FastAnalyzer]] - how to run prompt analysis
   * [[SWGuideReRunningL1][SWGuideReRunningL1]] - how to re-run the L1 emulator on raw data
   * [[SWGuideL1MinBiasTriggers][L1MinBiasTriggers]] - how to use new minbias trigger quantities
   * [[SWGuideL1EmulatorParameters][L1EmulatorParameters]] - how to use various configurable parameters

---++ Other useful L1 modules 
(to be redistributed to specific tasks)

   * [[SWGuideL1TextToDigi][L1TextToDigi]] - modules for converting hardware output files to digis, and vice versa
   * [[SWGuideL1Comparator][L1Comparator]] - templated comparator code for comparing hardware and emulator digis
   * [[SWGuideL1CondDBTools][L1CondDBTools]] - custom DB modules for use with the L1 !CondDB
   * [[SWGuideL1Analyzer][L1Analyzer]] - for comparison of L1 objects with MC truth or Reco candidates

---++ Related links

---+++ [[https://twiki.cern.ch/twiki/bin/view/CMS/L1TriggerDPG][ L1 DPG Group]]
---+++ [[https://twiki.cern.ch/twiki/bin/view/CMS/GlobalTriggerConfiguration][ L1 Trigger Menu]]
   * [[https://twiki.cern.ch/twiki/bin/view/CMS/GlobalTriggerAvailableMenus  Available L1 Trigger Menus]]
   * [[https://twiki.cern.ch/twiki/bin/view/CMS/GlobalTriggerTriggerMenuEditor   L1 Global Trigger: Trigger Menu Editor]]
   * %N%[[CMS.GlobalTriggerTriggerMenuHistory][GT Trigger Menu History for Global Runs]]
---+++ [[https://twiki.cern.ch/twiki/bin/view/CMS/TriggerStudies][ Trigger Studies Group]]

---++ Contacts

Conveners : 
   * [[Main.VasileGhete][Vasile Ghete]] - L1 Offline Software Coordinator
   * Werner Sun - L1 !O2O & offline database

Full list of L1 developers
   * [[SWGuideL1OfflineDevelopers][L1 Trigger Offline Software: Developers and Packages]]

Communication
   * [[https://hypernews.cern.ch/HyperNews/CMS/get/L1Trigger.html][L1 Trigger hypernews]] - general L1 Trigger  forum
   * [[https://hypernews.cern.ch/HyperNews/CMS/get/L1TriggerSW.html][L1 Trigger offline software hypernews]] - general L1 trigger offline software forum
   * [[https://hypernews.cern.ch/HyperNews/CMS/get/L1TrigEmulator.html][L1 Trigger emulator hypernews]] - dedicated L1 trigger emulator forum
   * [[https://hypernews.cern.ch/HyperNews/CMS/get/trigMon.html][Trigger Monitoring hypernews]]


#ReviewStatus
---++!! Review status 

| *Reviewer/Editor and Date (copy from screen)* | *Comments* |
| Main.KatiLassilaPerini - 23 Jan 2007 | created template page  |
| Main.JimBrooke - 29 Jan 2007 | page last content editor |
| Main.JennyWilliams - 07 Feb 2007 | tidied twiki text |
| Main.VasileGhete - 30 Jan 2009 | restructured content |

%RESPONSIBLE% Vasile Ghete%BR%
This topic: CMSPublic > CMSCommunicationsGroup > CMSCommunicationsProjects > WebHome > SWGuide > SWGuideOnSel > SWGuideL1Trigger
Topic revision: r71 - 2015-06-08 - JimBrooke
Copyright &© 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