SWGuideMuonHLTOfflineDQM < CMSPublic

CMSPublic Web>SWGuide>SWGuideOnSel>SWGuideTriggerStudiesHowTo>SWGuideMuonHLT>SWGuideMuonHLTOfflineDQM (2011-08-29, JeffKlukasExCern) (raw view)
EditAttachPDF
%TOC%

---+ Purpose of this twiki
Document the implementation, configuration, tests and content of the muon HLT offline !DQM.

---+ Trigger objects monitoring

---++ Quickstart Guide


---+++ See the plots in the Gui

On the [[https://cmsweb.cern.ch/dqm/offline/][DQM Offline GUI]], choose the "Workspace" (top of the GUI screen) called "HLT", then navigate to "(Top)/HLT/Muon/Distributions".

---+++ Collision Reference Plots

Last Update: June 23 2010

Current Collision Reference: 137028 


%RED% NOTE: %ENDCOLOR% Please choose to look at these plots in the =/StreamExpress/= dataset. If you choose another dataset, the plots will look different due to trigger bias.


---++++ 01 HLT_Mu3 Pt

%TABLE{ sort="off" tableborder="0" cellborder="0"  valign="top" tablewidth="100%" columnwidths="100%,0%" }%
| *HLT_Mu3 Pt*  | <img src="https://cmsweb.cern.ch/dqm/offline/plotfairy/archive/137028/StreamExpress/Run2010A-Express-v2/DQM/HLT/Muon/Distributions/HLT_Mu3/allMuons/recEffPt_L3Filtered?session=owLgo3;v=1275804492664229000;xtype=log;w=739;h=277"><br/> |
| *Description:* Shows Eff vs Pt.  <br/> *Evaluation:* Check for significant deviations against reference  |^|^|

---++++ 02 HLT_Mu3 Phi vs Eta

%TABLE{ sort="off" tableborder="0" cellborder="0"  valign="top" tablewidth="100%" columnwidths="100%,0%" }%
| *HLT_Mu3 Phi vs eata*  | <img src="https://cmsweb.cern.ch/dqm/offline/plotfairy/archive/137028/StreamExpress/Run2010A-Express-v2/DQM/HLT/Muon/Distributions/HLT_Mu3/allMuons/recEffPhiVsEta_L3Filtered?session=owLgo3;v=1275804492664229000;w=739;h=277"><br/> |
| *Description:* Shows Eff vs Pt.  <br/> *Evaluation:* Check for significant deviations against reference  |^|^|


---++++ 03 HLT_Mu5 Pt

%TABLE{ sort="off" tableborder="0" cellborder="0"  valign="top" tablewidth="100%" columnwidths="100%,0%" }%
| *HLT_Mu5 Pt*  | <img src="https://cmsweb.cern.ch/dqm/offline/plotfairy/archive/137028/StreamExpress/Run2010A-Express-v2/DQM/HLT/Muon/Distributions/HLT_Mu5/allMuons/recEffPt_L3Filtered?session=owLgo3;v=1275804492664229000;xtype=log;w=739;h=277"><br/> |
| *Description:* Shows Eff vs Pt.  <br/> *Evaluation:* Check for significant deviations against reference  |^|^|


---++++ 04 HLT_Mu5 Phi vs Eta

%TABLE{ sort="off" tableborder="0" cellborder="0"  valign="top" tablewidth="100%" columnwidths="100%,0%" }%
| *HLT_Mu5 Phi vs Eta*  | <img src="https://cmsweb.cern.ch/dqm/offline/plotfairy/archive/137028/StreamExpress/Run2010A-Express-v2/DQM/HLT/Muon/Distributions/HLT_Mu5/allMuons/recEffPhiVsEta_L3Filtered?session=owLgo3;v=1275804492664229000;w=739;h=277"><br/> |
| *Description:* Shows Eff vs Pt.  <br/> *Evaluation:* Check for significant deviations against reference  |^|^|

---++++ 05 HLT_Mu9 Pt

%TABLE{ sort="off" tableborder="0" cellborder="0"  valign="top" tablewidth="100%" columnwidths="100%,0%" }%
| *HLT_Mu9 Pt*  | <img src="https://cmsweb.cern.ch/dqm/offline/plotfairy/archive/137028/StreamExpress/Run2010A-Express-v2/DQM/HLT/Muon/Distributions/HLT_Mu9/allMuons/recEffPt_L3Filtered?session=owLgo3;v=1275804492664229000;xtype=log;w=739;h=277"><br/> |
| *Description:* Shows Eff vs Pt.  <br/> *Evaluation:* Check for significant deviations against reference  |^|^|


---++++ 06 HLT_Mu9 Phi vs Eta

%TABLE{ sort="off" tableborder="0" cellborder="0"  valign="top" tablewidth="100%" columnwidths="100%,0%" }%
| *HLT_Mu9 Phi vs Eta*  | <img src="https://cmsweb.cern.ch/dqm/offline/plotfairy/archive/137028/StreamExpress/Run2010A-Express-v2/DQM/HLT/Muon/Distributions/HLT_Mu9/allMuons/recEffPhiVsEta_L3Filtered?session=owLgo3;v=1275804492664229000;w=739;h=277"><br/> |
| *Description:* Shows Eff vs Pt.  <br/> *Evaluation:* Check for significant deviations against reference  |^|^|



---+++ See Some CMS.RelVal Plots

Plots for a few CMS.RelVal samples in 3_1_X releases are available from the following link:
[[http://slaunwhj.web.cern.ch/slaunwhj/MuonOfflineDQMPlots/][http://slaunwhj.web.cern.ch/slaunwhj/MuonOfflineDQMPlots/]].


---+++ Software structure

The software is structured according to the following diagram:

%ATTACHURL%/dqmOfflineMuonStructure.002.jpg

The inputs are a list of triggers to monitor and a list of selections. The selections apply to both muon quantities (z0, d0, pt, etc) and event quantities (require a certain trigger to fire). The selections determine 

   * Which events to compare 
   * Which HLT and RECO muons to compare

---+++ Which plots are produced?

The muon offline DQM produces ~1000 histograms using an average of 28 bins per histogram. 
The breakdown of the plots is:

<verbatim>

Each muon triggers matching a regular expression have an associated directory with the following plots:

3 Selections (Global, Tracker, and !VBTF)
~50 plots per selection

For each selection, the plots are 

24 Efficiency related plots: 
     D0Beam, Z0, Charge, eta, phi, pt, pt_max, pt_exactly_one_muon,
     8 distributions * 3 histos/distrib = 24 plots
9   Fake related plots: pt, eta, phi (ONLY produced for HLT Triggers)
1 Charge Flip
2 isolation
4 track wrt (0,0,0) Z0Beam, d0 detector 
4 Beamspot track parameters: D0, Z0 eff from beamspot
2 Phi Vs Eta
3 Resolution: Pt, eta phi
</verbatim>

To see the most current selections, look at the following configuration files:
[[http://cmssw.cvs.cern.ch/cgi-bin/cmssw.cgi/CMSSW/DQMOffline/Trigger/python/HLTMuonOfflineAnalyzer_cfi.py.py][Collisions]]

---+++ Where are the plots located in the DQM plot directory structure?

The base directory is =DQMData/HLT/Muon/=.  Each muon selection has a separate =Distributions= directory.
There is a separate directory for each trigger. So the path for trigger "HLT_Mu9", considering
selection "Global" is =DQMData/HLT/Muon/DistributionsGlobal/HLT_Mu9/=.



---++ Run The Code

Follow these steps to get started running the DQM right away. 

   1. Log into one of the pool machines
       <verbatim>
       ssh lxplus
       </verbatim>
   1. Check out your favorite release of CMSSW. 
      We will refer to your release as CMSSW_X_Y_Z.
      <verbatim>
      Example:
     cmsrel CMSSW_4_2_9
     cmsenv
      </verbatim>
   1. Check out the DQMOffline Package using cvs
       <verbatim>addpkg DQMOffline/Trigger</verbatim>
   1. Build your version of CMSSW with =scram b=
       <verbatim>
         scram b -j 4
       </verbatim>
   1. Run the DQM analysis step.
 <verbatim>
Example:
cd DQMOffline/Trigger/test/
# Change the input files to whatever you like and run
cmsRun muonTest_cfg.py
</verbatim>

   1. Run the DQM harveting step
   <verbatim>
    Example:
    # make sure that the input files in the script match the output from your previous script
     cmsRun muonPostProcessor_cfg.py
   </verbatim>
   1. Look at the histograms in the TBrowser. The histograms are in =DQMData/HLT/Muon/Distributions/=. Each trigger has its own sub-directory.

---++ Four vector dqm source

There exists a generic monitoring tool for !HLT performance giving insights to the performance of the muon triggers.
Documentation is available under SWGuideFourVector .
The directory for the plots is !HLT/CMS.FourVector/client/ _trigger path_ /custom-eff


---+ Local reconstruction monitoring

There is currently no specific local reconstruction monitoring in the offline DQM.


---+ PAG trigger monitoring

---++ Top PAG Muon Trigger Monitoring

The top group is concerned about monitoring muon trigger efficiencies in high-occupancy events.
The have supplemental monitoring under development documented here: [[SWGuideMuonHLTTopPAGDQM]].

---++ Tag and Probe Muon Trigger Monitoring

The B-physics group is interested in tag-and-probe with low-mass di-muon resonances such as J/Psi and Upsilon. 
They have supplemental monitoring under development documented here: [[SWGuideMuonHLTBPAGDQM]].

---+ Muon HLT Offline Analysis

There are some instructions for offline analysis that extends beyond offline DQM available on the [[SWGuideMuonHLTOfflineAnalysis]].

-- Main.JasonSlaunwhite - 29 Apr 2009
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who	Comment
jpg	Composite.001.jpg	r2 r1	manage	110.3 K	2009-08-31 - 22:29	JasonSlaunwhite
jpg	WhereArePlots.003.jpg	r2 r1	manage	151.3 K	2010-06-23 - 10:49	JasonSlaunwhite
jpg	dqmOfflineMuonStructure.002.jpg	r2 r1	manage	66.7 K	2009-08-31 - 22:30	JasonSlaunwhite	Strucutre of Muon Offline DQM
Topic revision: r26 - 2011-08-29 - JeffKlukasExCern
CMSPublic
Create a LeftBar
Public webs
- Cern Search
- TWiki Search
- Google Search
CMSPublic All webs
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