The main goal of the online Muon HLT DQM is to monitor shapes and performances for filtered events during data taking directly at P5 so that we can do something immediately if we find a problem. The Muon HLT DQM will be run as a subsystem of the global HLT DQM. There are many restrictions for this monitoring, and therefore few selected histograms with basic information will be monitored.

Online GUI

All the plots documented in this twiki are available from as described in the schemat below.



Name Responsibility
Wee Don Teo, Hwidong Yoo Overall online DQM
Lorenzo Agostino, Peter Wittich Global DQM & Trigger experts
Jean-Roch Vlimant, Adam Everett Muon triggers

The on call experts twiki is located at MuonHLTOnCallShifter.

Local reconstruction monitoring

In order to understand possible features appearing in distributions of high level object (like L2 or L3 objects), one needs to monitor the local reconstruction from which these high level objects are reconstructed. The objects monitored and mentioned in the following should appear in the muon monitoring stream (just for information), and should be propagated to the HLTDEBUG stream description (for monte carlo) and in the definition of the trigger menu output stream "out4DQM" (navigate to the correct menu).

Local drift tube (barrel) reconstruction

product label status
hltDt1DRecHits to be implement
hltDt4DSegments to be implement

Local cathod strip chamber (endcap) reconstruction

product label status
hltCsc2DRecHits to be implement
hltCscSegments to be implement

Local resistive plate chambers (barrel and endcap) reconstruction

product label status
hltRpcRecHits to be implement

Local pixel reconstruction (L3)

product label status
hltSiPixelClusters to be implement
hltSiPixelRecHits to be implement

Local strip reconstruction (L3)

product label status
hltSiStripRawToClustersFacility to be implement

Trigger objects monitoring

Description of Muon HLT DQM

  • Sources:
    • DQM/HLTEvF/plugins/HLTMuonDQMSource.cc (kinematic info)
    • DQM/HLTEvF/plugins/HLTMonBitSummary.cc (trigger path and subfilter info)

  • Modules:
    • DQM/HLTEvF/python/HLTMonMuonDQM_cfi.py (for HLTMuonDQMSource)
    • DQM/HLTEvF/python/HLTMonMuonBits_cfi.py (for HLTMonBitSummary)
      • You can setup filtering parameters in HLTMuonDQM_cfi.py.
      • Filtering means to only select the events which passes the Muon High Level Trigger only (not other object triggers).
                 filters = cms.VPSet(
                   # L1 muon
                           HLTCollectionLevel = cms.string("L1"),
                           HLTCollectionLabels = cms.string("HLT_L1Mu")
                   # L2 muon
                           HLTCollectionLevel = cms.string("L2"),
                           HLTCollectionLabels = cms.string("HLT_L2Mu9")
                   # L3 muon
                           HLTCollectionLevel = cms.string("L3"),
                           HLTCollectionLabels = cms.string("HLT_Mu3")
                           HLTCollectionLevel = cms.string("L3"),
                           HLTCollectionLabels = cms.string("HLT_IsoMu3")
      • You can add any other Muon HLT paths, which are defined in Muon HLT webpage. For example, if you want to read the results of HLT_Mu7 trigger path, you can add as follows:
                 filters = cms.VPSet(
                           HLTCollectionLevel = cms.string("L3"),
                           HLTCollectionLabels = cms.string("HLT_Mu7")
        then, the results will be stored in "HLT_Mu7" directory in output file.

  • Data products to run the source code. Please refer to the table defined here.

  • The current output directory structure and histograms are:

Directory Name Subdirectory Name Histograms
L1PassThrough, L2PassThrough, L3Triggers, JetStream Level1 (38 hists) L1Quality, L1_NMu, L1_charge, L1_eta, L1_phi, L1_pt, L1_pteta, L1_etaphi, L1_ptphi, L1toL2_etares, L1toL2_phires, L1toL2_ptres, L1toL2_etareseta, L1toL2_phiresphi, L1toL2_ptrespt, L1toL3_etares, L1toL3_phires, L1toL3_ptres, L1toL3_etareseta, L1toL3_phiresphi, L1toL3_ptrespt, L1toL2_chargeconvers, L1toL2_etarelres, L1toL2_phirelres, L1toL2_ptrelres, L1toL2_etarelreseta, L1toL2_phirelresphi, L1toL2_ptrelrespt, L1toL2_fraceta, L1toL2_fracphi, L1toL2_fracpt, L1toL3_chargeconvers, L1toL3_etarelres, L1toL3_phirelres, L1toL3_ptrelres, L1toL3_etarelreseta, L1toL3_phirelresphi, L1toL3_ptrelrespt
Level2Seed (15 hists) L2Seed_NMu, L2Seed_charge, L2Seed_eta, L2Seed_phi, L2Seed_pt, L2Seed_etaphi, L2Seed_pteta, L2Seed_ptphi, L2SeedtoL1_etares, L2SeedtoL1_phires, L2SeedtoL1_ptres, L2SeedtoL1_etareseta, L2SeedtoL1_phiresphi, L2SeedtoL1_ptrespt, L2Seed_NMuperL1
Level2 (43 hists) L2_NMu, L2_DiMuMass, L2_charge, L2_d0, L2_dr, L2_dz0, L2_dz, L2_err0, L2_eta, L2_phi, L2_pt, L2_iso, L2_etares, L2_phires, L2_ptres, L2_etareseta, L2_phiresphi, L2_ptrespt, L2_d0phi, L2_drphi, L2_dz0eta, L2_dzeta, L2_etaphi, L2_pteta, L2_ptphi, L2_nHits, L2_nValidHits, L2toL3_chargeconvers, L2toL3_fracpt, L2toL3_fraceta, L2toL3_fracphi, L2toL3_etarelres, L2toL3_phirelres, L2toL3_ptrelres, L2toL3_etarelreseta, L2toL3_phirelresphi, L2toL3_ptrelrespt, L2toL3_etapull, L2toL3_phipull, L2toL3_ptpull, L2toL3_etapulleta, L2toL3_phipullphi, L2toL3_ptpullpt
Level2Isolation (18 hists) HLTCaloTower_EmEnergy, HLTCaloTower_EmEt, HLTCaloTower_Et, HLTCaloTower_Eta, HLTCaloTower_EtaEmEt, HLTCaloTower_EtaHadEt, HLTCaloTower_EtaOuterEt, HLTCaloTower_HadEnergy, HLTCaloTower_HadEt, HLTCaloTower_OuterEnergy, HLTCaloTower_OuterEt, HLTCaloTower_Phi, HLTCaloTower_PhiEmEt, HLTCaloTower_PhiHadEt, HLTCaloTower_PhiOuterEt, HLTCaloTower_dRwithL2, HLTCaloTower_dRwithL3, HLTMuonL2_driso
Level3Seed (15 hists) L3Seed_NMu, L3Seed_charge, L3Seed_eta, L3Seed_phi, L3Seed_pt, L3Seed_etaphi, L3Seed_pteta, L3Seed_ptphi, L3SeedtoL2_etares, L3SeedtoL2_phires, L3SeedtoL2_ptres, L3SeedtoL2_etareseta, L3SeedtoL2_phiresphi, L3SeedtoL2_ptrespt, L3Seed_NMuperL2
Level3 (22 hists) L3_NMu, L3_DiMuMass, L3_charge, L3_d0, L3_dr, L3_dz0, L3_dz, L3_err0, L3_eta, L3_phi, L3_pt, L3_iso, L3_nHits, L3_nMuValidHits, L3_nTkValidHits, L3_d0phi, L3_drphi, L3_dz0eta, L3_dzeta, L3_etaphi, L3_pteta, L3_ptphi
Summary   Efficiency_Summary, PassingBits_Correlation, PassingBits_Summary, Ratio_HLT_L1MuOpen
Trigger_Filters Filters_<triggerpath>
Trigger_Efficiencies Efficiency_<triggerpath>

  • Histograms produced by Muon HLT DQM with cosmicMC and CRAFT samples

Bandwidth of Muon HLT DQM for each trigger path

  • Recently, Don has estimated the size of products for Muon HLT DQM and determined bandwidth for each trigger path.
  • He used minbias MC samples which TSG group used to estimate the trigger rate for 8E29 and 1E31.
  • Bandwidth table

Quality Test (QT) on Muon HLT DQM

  • QT will be monitored by DQM shifter at P5 and will let the shift warn if the data quality is not much good as we expected (using the threshhold for each QT)

  • Basic QT is implemented
    • QT's are performed at the end of every lumisection
    • Status and results of QTs are stored in output
    • Tested with both MC and CRAFT data samples
    • Phi flatness on phi distribution
    • KS test
  • Implemented QTs for March 2009 GR
    • Phi flatness: L1phi, L2phi, L3phi (3 histograms)
    • Residual fits: L1(2)toL3_etareseta, L1(2)toL3_phiresphi, L1(2)toL3_ptrespt (6 histograms)
    • KS test: L*eta, L*phi, L*pt, L*charge, L2(3)_d0, L2(3)_dr, L2(3)_dz0, L2(3)_dz (20 histograms)
    • Parameters are set up and committed in CVS by Don (Don's presentation in Muon HLT meeting)
    • Reference plots are produced by Hwidong
    • GUI screenshot of overlaying reference histos (grey) that are used for KS test
  • QT's are defined in: /DQM/HLTEvF/data/HLTMonMuon_QualityTests.xml
  • For more on DQM quality tests, see CMS.DQMQualityTests

Updates since 2008 CRAFT Global Run (GR)

  • Many output histograms were empty during CRAFT GR
    • Can't read Ref or Pointer from the streamer file correctly
    • Fix this problem (being confirmed)
  • Missing products in HLTDEBUG
    • Added from V01-05-23 HLTrigger/Configuration
    • HLTMuonDQMSource.cc works perfectly (no empty histogram) with this or higher version samples (run well with CMSSW_2_2_0 or higher version MC samples)

Running the Muon HLT DQM

To set up your own DQM GUI, follow the instructions here. To view the GUI on your browser, follow the instructions here.

  • To run the Muon HLT DQM on the .CMS network (P5):
    • You need an online account and authority to access online machine (cmsusr*)
    • /castor is not visible. Therefore, you should copy samples to online machine
            ssh srv-c2d05-12 (online machine for HLT DQM)
            source "/nfshome0/cmssw2/scripts/setup.sh"
            scramv1 project CMSSW CMSSW_3_2_5 (for example)
            cd CMSSW_3_2_5/src
            eval `scramv1 runtime -sh`
            export CVSROOT=:pserver:anonymous@cmscvs.cern.ch:/cvs/CMSSW
            cvs co -r V05-00-16 DQM/HLTEvF (or higher version)
            scramv1 b
            cd DQM/HLTEvF/test
            cmsRun hlt_muon_dqm-file_cfg.py
    • Before running, you should replace the input file (usually HLTDEBUG which contains data products described in above) in hlt_muon_dqm-file_cfg.py

  • To run on an lxplus machine:
          scramv1 p CMSSW CMSSW_3_2_5
          cd CMSSW_3_2_5
          cvs co -r V05-00-16 DQM/HLTEvF/
          scramv1 b
          cd DQM/HLTEvF/test
          cmsRun hlt_muon_dqm-file_cfg.py
    If you have the DQM GUI running on a lxplus machine (say, lxplus200), be sure to edit the following line in the cfg:
          process.DQM.collectorHost = 'lxplus200'
    and to create a tunnel from your machine to the lxplus machine, e.g.:
          ssh -ND 11080 username@lxplus200.cern.ch

Summary of Muon HLT Monitor Elements (old Muon HLT DQM, replaced by new one since Oct. 2008)

All files related to the muon HLT DQM can be found in the DQM/HLTEvF package. Currently, there are 17 filters that are monitored for each event. The filters are:

  • hltZMML2Filtered
  • hltEMuL1MuonFilter
  • hltSingleMuNoIsoL1Filtered
  • hltSingleMuIsoL2IsoFiltered
  • hltSingleMuIsoL3IsoFiltered

  • hltSingleMuNoIsoL1Filtered10
  • hltSingleMuIsoL2IsoFiltered13
  • hltSingleMuIsoL3IsoFiltered13
  • hltSingleMuIsoL2IsoFiltered15
  • hltSingleMuIsoL3IsoFiltered15
  • hltSingleMuIsoL2IsoFiltered9
  • hltSingleMuIsoL3OIstateIsoFiltered

  • hltMuLevel1PathL1OpenFiltered
  • hltMuLevel1PathL1Filtered
  • hltSingleMuPrescale5L1Filtered
  • hltSingleMuPrescale710L1Filtered
  • hltSingleMuPrescale77L1Filtered

For each of the filters above, the vector of particle candidates that have passed the filter is obtained, and from there, integrated histograms of the quantites pt, eta, and phi are filled. For each quantity, there is also a histogram showing the isolation deposit maps of the candidates. In addition, a general phi vs eta occupancy plot for the filter is filled. Finally, a single histogram tallying the total number of candidates found for all the filters is filled.


Editor Date
WeeDonTeo 07 Oct 2008
Hwidong Yoo 27 Jan 2009
Hwidong Yoo 28 Feb 2009
Topic attachments
I Attachment History Action Size Date Who Comment
PDFpdf MuonHLTDQM_productsize210209.pdf r1 manage 57.8 K 2009-03-02 - 11:11 HwidongYoo  
PNGpng Screenshot-6.png r1 manage 199.1 K 2009-03-02 - 11:12 HwidongYoo  
JPEGjpg qt_ks.jpg r1 manage 43.1 K 2009-01-28 - 09:46 HwidongYoo  
JPEGjpg qt_phiflatness.jpg r1 manage 53.8 K 2009-01-28 - 09:46 HwidongYoo  
Edit | Attach | Watch | Print version | History: r18 < r17 < r16 < r15 < r14 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r18 - 2009-10-02 - WeeDonTeo
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    CMSPublic All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback