Mods/interface/MuonIDMod.h

//--------------------------------------------------------------------------------------------------
// $Id: MuonIDMod.h,v 1.40 2012/01/23 20:08:30 sixie Exp $
//
// MuonIDMod
//
// This module applies muon identification criteria and exports a pointer to a collection
// of "good muons" according to the specified ID scheme.
//
// See http://indico.cern.ch/contributionDisplay.py?contribId=1&confId=45945
// See http://indico.cern.ch/getFile.py/access?contribId=1&resId=0&materialId=slides&confId=42229
//
// Authors: S.Xie
//--------------------------------------------------------------------------------------------------

#ifndef MITPHYSICS_MODS_MUONIDMOD_H
#define MITPHYSICS_MODS_MUONIDMOD_H

#include "MitAna/TreeMod/interface/BaseMod.h" 
#include "MitAna/DataTree/interface/MuonFwd.h"
#include "MitAna/DataTree/interface/VertexFwd.h"
#include "MitAna/DataTree/interface/TrackFwd.h"
#include "MitAna/DataTree/interface/PFCandidateFwd.h"
#include "MitPhysics/Utils/interface/MuonTools.h"
#include "MitPhysics/Utils/interface/MuonIDMVA.h"
#include "MitPhysics/Utils/interface/IsolationTools.h"
#include "MitAna/DataTree/interface/PileupEnergyDensityCol.h"

namespace mithep 
{
  class MuonIDMod : public BaseMod
  {
    public:
      MuonIDMod(const char *name="MuonIDMod", 
                const char *title="Muon identification module");

      Double_t           GetCaloIsoCut()                const { return fCaloIsolationCut;   }
      const char        *GetClassType()                 const { return fMuonClassType;      }
      const char        *GetCleanName()                 const { return GetCleanMuonsName(); }   
      const char        *GetCleanMuonsName()            const { return fCleanMuonsName;     }   
      Double_t           GetCombIsoCut()                const { return fCombIsolationCut;   }
      const char        *GetIDType()                    const { return fMuonIDType;         }
      const char        *GetInputName()                 const { return fMuonBranchName;     }   
      const char        *GetIsoType()                   const { return fMuonIsoType;        }
      const char        *GetOutputName()                const { return GetCleanMuonsName(); }   
      Double_t           GetPtMin()                     const { return fMuonPtMin;          }
      Double_t           GetTrackIsoCut()               const { return fTrackIsolationCut;  }
      Bool_t             PassMuonMVA_BDTG_IdIso(const Muon *mu, const Vertex *vertex, 
                                                const PileupEnergyDensityCol *PileupEnergyDensity) const;
      void               SetPrintMVADebugInfo(Bool_t b)       { fPrintMVADebugInfo = b;     }
      void               SetApplyD0Cut(Bool_t b)              { fApplyD0Cut        = b;     }
      void               SetApplyDZCut(Bool_t b)              { fApplyDZCut        = b;     }
      void               SetCaloIsoCut(Double_t cut)          { fCaloIsolationCut  = cut;   }
      void               SetClassType(const char *type)       { fMuonClassType     = type;  }
      void               SetCleanMuonsName(const char *name)  { fCleanMuonsName    = name;  }   
      void               SetOldMuonsName(const char *n)       { fNonIsolatedMuonsName  = n; }  
      void               SetOldElectronsName(const char *n)   { fNonIsolatedElectronsName  = n; }  
      void               SetCleanName(const char *name)       { SetCleanMuonsName(name);    }   
      void               SetCombIsoCut(Double_t cut)          { fCombIsolationCut  = cut;   }
      void               SetCombRelativeIsoCut(Double_t cut)  { fCombRelativeIsolationCut  = cut; }
      void               SetPFIsoCut(Double_t cut)            { fPFIsolationCut  = cut;     }
      void               SetD0Cut(Double_t cut)               { fD0Cut             = cut;   }
      void               SetDZCut(Double_t cut)               { fDZCut             = cut;   }
      void               SetWhichVertex(Int_t d)              { fWhichVertex = d;           }
      void               SetEtaCut(Double_t cut)              { fEtaCut            = cut;   }
      void               SetIDType(const char *type)          { fMuonIDType        = type;  }
      void               SetInputName(const char *name)       { fMuonBranchName    = name;  }   
      void               SetIsoType(const char *type)         { fMuonIsoType       = type;  }
      void               SetOutputName(const char *name)      { SetCleanMuonsName(name);    }   
      void               SetPtMin(Double_t pt)                { fMuonPtMin         = pt;    }
      void               SetTrackIsoCut(Double_t cut)         { fTrackIsolationCut = cut;   }
      void               SetIntRadius(Double_t dr)            { fIntRadius = dr;            }
      void               SetMuonMVAWeightsSubdet0Pt10To14p5(TString s)  
                         { fMuonMVAWeights_Subdet0Pt10To14p5  = s; }
      void               SetMuonMVAWeightsSubdet1Pt10To14p5(TString s)  
                         { fMuonMVAWeights_Subdet1Pt10To14p5  = s; }
      void               SetMuonMVAWeightsSubdet0Pt14p5To20(TString s)  
                         { fMuonMVAWeights_Subdet0Pt14p5To20  = s; }
      void               SetMuonMVAWeightsSubdet1Pt14p5To20(TString s) 
                         { fMuonMVAWeights_Subdet1Pt14p5To20 = s; }
      void               SetMuonMVAWeightsSubdet0Pt20ToInf(TString s) 
                         { fMuonMVAWeights_Subdet0Pt20ToInf = s; }
      void               SetMuonMVAWeightsSubdet1Pt20ToInf(TString s) 
                         { fMuonMVAWeights_Subdet1Pt20ToInf = s; }

      enum EMuIdType {
        kIdUndef = 0,       //not defined
        kWMuId,             //"WMuId"
        kZMuId,             //"ZMuId"
        kTight,             //"Tight"
        kLoose,             //"Loose"
        kWWMuIdV1,          //"WWMuIdV1"
        kWWMuIdV2,          //"WWMuIdV2"
        kWWMuIdV3,          //"WWMuIdV3"
        kNoId,              //"NoId"        
        kCustomId,          //"Custom"
        kMVAID_BDTG_IDIso   //"BDTG ID + Iso03, Iso04 Combined"
      };
      enum EMuIsoType {
        kIsoUndef = 0,                      //"not defined"
        kTrackCalo,                         //"TrackCalo"
        kTrackCaloCombined,                 //"TrackCaloCombined"
        kTrackCaloSliding,                  //"TrackCaloSliding"
        kTrackCaloSlidingNoCorrection,      //"TrackCaloSlidingNoCorrection"
        kCombinedRelativeConeAreaCorrected, //"CombinedRelativeConeAreaCorrected"
        kCombinedRelativeEffectiveAreaCorrected,
        kCustomIso,                         //"Custom"
        kPFIso,                             //"PFIso"
        kPFIsoEffectiveAreaCorrected,       //"PFIso with EffectiveArea Pileup Correction"
        kPFIsoNoL,                          //"PFIsoNoL"
        kNoIso,                             //"NoIso"
        kMVAIso_BDTG_IDIso                  //"BDTG ID + Iso03, Iso04 Combined"
      };
      enum EMuClassType {
        kClassUndef = 0,    //not defined
        kAll,               //"All"
        kGlobal,            //"Global"
        kGlobalTracker,     //"GlobalTracker"
        kSta,               //"Standalone"
        kTrackerMuon,       //"TrackerMuon"
        kCaloMuon,          //"CaloMuon"
        kTrackerBased       //"TrackerMuon or CaloMuon"

      };

    protected:
      void               Process();
      void               SlaveBegin();

      Bool_t             fPrintMVADebugInfo;   //print MVA debug information
      TString            fMuonBranchName;      //name of muon collection (input)
      TString            fCleanMuonsName;      //name of exported "good muon" collection
      TString            fNonIsolatedMuonsName;    //name of imported "old muon" collection
      TString            fNonIsolatedElectronsName;//name of imported "old electron" collection
      TString            fVertexName;          //name of vertex collection
      TString            fBeamSpotName;        //name of beamspot collection
      TString            fTrackName;           //name of track collection
      TString            fPFCandidatesName;    //name of pfcandidates collection
      TString            fMuonIDType;          //type of muon id scheme we impose
      TString            fMuonIsoType;         //type of muon isolations scheme we impose
      TString            fMuonClassType;       //type of muon class we impose
      Double_t           fTrackIsolationCut;   //cut value for track isolation
      Double_t           fCaloIsolationCut;    //cut value for calo isolation
      Double_t           fCombIsolationCut;    //cut value for combined isolation
      Double_t           fCombRelativeIsolationCut; //cut value for combined relative isolation
      Double_t           fPFIsolationCut;      //cut value for combined isolation
      Double_t           fMuonPtMin;           //min muon pt
      Bool_t             fApplyD0Cut;          //=true then apply d0 cut (def=1)
      Bool_t             fApplyDZCut;          //=true then apply dz cut (def=1)
      Double_t           fD0Cut;               //max d0
      Double_t           fDZCut;               //max dz
      Int_t              fWhichVertex;         //vertex to use (-2: beamspot, -1: closest in Z)
      Double_t           fEtaCut;              //max eta, absolute value
      EMuIdType          fMuIDType;            //!muon id type (imposed)
      EMuIsoType         fMuIsoType;           //!muon iso type (imposed)
      EMuClassType       fMuClassType;         //!muon class type (imposed)
      const MuonCol     *fMuons;               //!muon collection
      const VertexCol   *fVertices;            //!vertices branch
      const BeamSpotCol *fBeamSpot;            //!beamspot branch
      const TrackCol    *fTracks;              //!track branch     
      const PFCandidateCol *fPFCandidates;     //!pfcandidate branch
      Double_t           fIntRadius;           //!min IntRadius cut in pf isolation
      MuonCol            *fNonIsolatedMuons;    //!pointer to old muon collection 
      ElectronCol        *fNonIsolatedElectrons;//!pointer to old electron collection
      TString             fPileupEnergyDensityName;
      const PileupEnergyDensityCol *fPileupEnergyDensity;
      MuonTools          *fMuonTools;           // interface to tools for muon ID
      MuonIDMVA          *fMuonIDMVA;           // helper class for MuonMVA
      TString             fMuonMVAWeights_Subdet0Pt10To14p5;
      TString             fMuonMVAWeights_Subdet1Pt10To14p5;
      TString             fMuonMVAWeights_Subdet0Pt14p5To20;
      TString             fMuonMVAWeights_Subdet1Pt14p5To20;
      TString             fMuonMVAWeights_Subdet0Pt20ToInf;
      TString             fMuonMVAWeights_Subdet1Pt20ToInf;

    ClassDef(MuonIDMod, 1) // Muon identification module
  };
}
#endif
Revision:	1.41
Committed:	Fri Jan 27 11:48:23 2012 UTC (13 years, 3 months ago) by sixie
Content type:	text/plain
Branch:	MAIN
CVS Tags:	Mit_025e, Mit_025d
Changes since 1.40:	+3 -1 lines
Log Message:	add option flag to print out MVA debug information
#	User	Rev	Content
1	loizides	1.1	//--------------------------------------------------------------------------------------------------
2	sixie	1.41	// $Id: MuonIDMod.h,v 1.40 2012/01/23 20:08:30 sixie Exp $
3	loizides	1.1	//
4			// MuonIDMod
5			//
6	loizides	1.6	// This module applies muon identification criteria and exports a pointer to a collection
7	loizides	1.7	// of "good muons" according to the specified ID scheme.
8	loizides	1.1	//
9	loizides	1.16	// See http://indico.cern.ch/contributionDisplay.py?contribId=1&confId=45945
10			// See http://indico.cern.ch/getFile.py/access?contribId=1&resId=0&materialId=slides&confId=42229
11			//
12	ceballos	1.15	// Authors: S.Xie
13	loizides	1.1	//--------------------------------------------------------------------------------------------------
14
15	loizides	1.6	#ifndef MITPHYSICS_MODS_MUONIDMOD_H
16			#define MITPHYSICS_MODS_MUONIDMOD_H
17	loizides	1.1
18			#include "MitAna/TreeMod/interface/BaseMod.h"
19	loizides	1.22	#include "MitAna/DataTree/interface/MuonFwd.h"
20			#include "MitAna/DataTree/interface/VertexFwd.h"
21	ceballos	1.28	#include "MitAna/DataTree/interface/TrackFwd.h"
22			#include "MitAna/DataTree/interface/PFCandidateFwd.h"
23	ceballos	1.5	#include "MitPhysics/Utils/interface/MuonTools.h"
24	sixie	1.38	#include "MitPhysics/Utils/interface/MuonIDMVA.h"
25	ceballos	1.28	#include "MitPhysics/Utils/interface/IsolationTools.h"
26	ceballos	1.31	#include "MitAna/DataTree/interface/PileupEnergyDensityCol.h"
27	loizides	1.1
28			namespace mithep
29			{
30			class MuonIDMod : public BaseMod
31			{
32			public:
33			MuonIDMod(const char *name="MuonIDMod",
34	loizides	1.6	const char *title="Muon identification module");
35
36	loizides	1.11	Double_t GetCaloIsoCut() const { return fCaloIsolationCut; }
37			const char *GetClassType() const { return fMuonClassType; }
38			const char *GetCleanName() const { return GetCleanMuonsName(); }
39			const char *GetCleanMuonsName() const { return fCleanMuonsName; }
40			Double_t GetCombIsoCut() const { return fCombIsolationCut; }
41			const char *GetIDType() const { return fMuonIDType; }
42			const char *GetInputName() const { return fMuonBranchName; }
43			const char *GetIsoType() const { return fMuonIsoType; }
44			const char *GetOutputName() const { return GetCleanMuonsName(); }
45	ceballos	1.24	Double_t GetPtMin() const { return fMuonPtMin; }
46	loizides	1.11	Double_t GetTrackIsoCut() const { return fTrackIsolationCut; }
47	sixie	1.38	Bool_t PassMuonMVA_BDTG_IdIso(const Muon mu, const Vertex vertex,
48	sixie	1.39	const PileupEnergyDensityCol *PileupEnergyDensity) const;
49	sixie	1.41	void SetPrintMVADebugInfo(Bool_t b) { fPrintMVADebugInfo = b; }
50	loizides	1.20	void SetApplyD0Cut(Bool_t b) { fApplyD0Cut = b; }
51	ceballos	1.32	void SetApplyDZCut(Bool_t b) { fApplyDZCut = b; }
52	loizides	1.11	void SetCaloIsoCut(Double_t cut) { fCaloIsolationCut = cut; }
53			void SetClassType(const char *type) { fMuonClassType = type; }
54	loizides	1.18	void SetCleanMuonsName(const char *name) { fCleanMuonsName = name; }
55	sixie	1.35	void SetOldMuonsName(const char *n) { fNonIsolatedMuonsName = n; }
56			void SetOldElectronsName(const char *n) { fNonIsolatedElectronsName = n; }
57	loizides	1.11	void SetCleanName(const char *name) { SetCleanMuonsName(name); }
58	loizides	1.18	void SetCombIsoCut(Double_t cut) { fCombIsolationCut = cut; }
59	sixie	1.35	void SetCombRelativeIsoCut(Double_t cut) { fCombRelativeIsolationCut = cut; }
60			void SetPFIsoCut(Double_t cut) { fPFIsolationCut = cut; }
61	loizides	1.20	void SetD0Cut(Double_t cut) { fD0Cut = cut; }
62	ceballos	1.32	void SetDZCut(Double_t cut) { fDZCut = cut; }
63			void SetWhichVertex(Int_t d) { fWhichVertex = d; }
64	ceballos	1.25	void SetEtaCut(Double_t cut) { fEtaCut = cut; }
65	loizides	1.11	void SetIDType(const char *type) { fMuonIDType = type; }
66			void SetInputName(const char *name) { fMuonBranchName = name; }
67			void SetIsoType(const char *type) { fMuonIsoType = type; }
68			void SetOutputName(const char *name) { SetCleanMuonsName(name); }
69			void SetPtMin(Double_t pt) { fMuonPtMin = pt; }
70			void SetTrackIsoCut(Double_t cut) { fTrackIsolationCut = cut; }
71	ceballos	1.36	void SetIntRadius(Double_t dr) { fIntRadius = dr; }
72	sixie	1.38	void SetMuonMVAWeightsSubdet0Pt10To14p5(TString s)
73			{ fMuonMVAWeights_Subdet0Pt10To14p5 = s; }
74			void SetMuonMVAWeightsSubdet1Pt10To14p5(TString s)
75			{ fMuonMVAWeights_Subdet1Pt10To14p5 = s; }
76			void SetMuonMVAWeightsSubdet0Pt14p5To20(TString s)
77			{ fMuonMVAWeights_Subdet0Pt14p5To20 = s; }
78			void SetMuonMVAWeightsSubdet1Pt14p5To20(TString s)
79			{ fMuonMVAWeights_Subdet1Pt14p5To20 = s; }
80			void SetMuonMVAWeightsSubdet0Pt20ToInf(TString s)
81			{ fMuonMVAWeights_Subdet0Pt20ToInf = s; }
82			void SetMuonMVAWeightsSubdet1Pt20ToInf(TString s)
83			{ fMuonMVAWeights_Subdet1Pt20ToInf = s; }
84	loizides	1.6
85			enum EMuIdType {
86			kIdUndef = 0, //not defined
87	ceballos	1.26	kWMuId, //"WMuId"
88			kZMuId, //"ZMuId"
89	loizides	1.6	kTight, //"Tight"
90			kLoose, //"Loose"
91	ceballos	1.34	kWWMuIdV1, //"WWMuIdV1"
92			kWWMuIdV2, //"WWMuIdV2"
93	ceballos	1.37	kWWMuIdV3, //"WWMuIdV3"
94	sixie	1.38	kNoId, //"NoId"
95			kCustomId, //"Custom"
96			kMVAID_BDTG_IDIso //"BDTG ID + Iso03, Iso04 Combined"
97	loizides	1.6	};
98			enum EMuIsoType {
99	sixie	1.35	kIsoUndef = 0, //"not defined"
100			kTrackCalo, //"TrackCalo"
101			kTrackCaloCombined, //"TrackCaloCombined"
102			kTrackCaloSliding, //"TrackCaloSliding"
103			kTrackCaloSlidingNoCorrection, //"TrackCaloSlidingNoCorrection"
104			kCombinedRelativeConeAreaCorrected, //"CombinedRelativeConeAreaCorrected"
105	sixie	1.40	kCombinedRelativeEffectiveAreaCorrected,
106	sixie	1.35	kCustomIso, //"Custom"
107			kPFIso, //"PFIso"
108	sixie	1.38	kPFIsoEffectiveAreaCorrected, //"PFIso with EffectiveArea Pileup Correction"
109	sixie	1.35	kPFIsoNoL, //"PFIsoNoL"
110	sixie	1.38	kNoIso, //"NoIso"
111			kMVAIso_BDTG_IDIso //"BDTG ID + Iso03, Iso04 Combined"
112	loizides	1.6	};
113			enum EMuClassType {
114			kClassUndef = 0, //not defined
115			kAll, //"All"
116			kGlobal, //"Global"
117	ceballos	1.34	kGlobalTracker, //"GlobalTracker"
118	loizides	1.6	kSta, //"Standalone"
119	loizides	1.23	kTrackerMuon, //"TrackerMuon"
120			kCaloMuon, //"CaloMuon"
121			kTrackerBased //"TrackerMuon or CaloMuon"
122	sixie	1.38
123	loizides	1.6	};
124
125	loizides	1.1	protected:
126	loizides	1.11	void Process();
127			void SlaveBegin();
128	loizides	1.10
129	sixie	1.41	Bool_t fPrintMVADebugInfo; //print MVA debug information
130	loizides	1.11	TString fMuonBranchName; //name of muon collection (input)
131			TString fCleanMuonsName; //name of exported "good muon" collection
132	ceballos	1.29	TString fNonIsolatedMuonsName; //name of imported "old muon" collection
133			TString fNonIsolatedElectronsName;//name of imported "old electron" collection
134	ceballos	1.15	TString fVertexName; //name of vertex collection
135	ceballos	1.32	TString fBeamSpotName; //name of beamspot collection
136	ceballos	1.28	TString fTrackName; //name of track collection
137			TString fPFCandidatesName; //name of pfcandidates collection
138	loizides	1.11	TString fMuonIDType; //type of muon id scheme we impose
139			TString fMuonIsoType; //type of muon isolations scheme we impose
140			TString fMuonClassType; //type of muon class we impose
141			Double_t fTrackIsolationCut; //cut value for track isolation
142			Double_t fCaloIsolationCut; //cut value for calo isolation
143			Double_t fCombIsolationCut; //cut value for combined isolation
144	sixie	1.35	Double_t fCombRelativeIsolationCut; //cut value for combined relative isolation
145			Double_t fPFIsolationCut; //cut value for combined isolation
146	loizides	1.11	Double_t fMuonPtMin; //min muon pt
147	loizides	1.20	Bool_t fApplyD0Cut; //=true then apply d0 cut (def=1)
148	ceballos	1.32	Bool_t fApplyDZCut; //=true then apply dz cut (def=1)
149	loizides	1.16	Double_t fD0Cut; //max d0
150	ceballos	1.32	Double_t fDZCut; //max dz
151			Int_t fWhichVertex; //vertex to use (-2: beamspot, -1: closest in Z)
152	ceballos	1.25	Double_t fEtaCut; //max eta, absolute value
153	loizides	1.11	EMuIdType fMuIDType; //!muon id type (imposed)
154			EMuIsoType fMuIsoType; //!muon iso type (imposed)
155			EMuClassType fMuClassType; //!muon class type (imposed)
156	loizides	1.16	const MuonCol *fMuons; //!muon collection
157			const VertexCol *fVertices; //!vertices branch
158	ceballos	1.32	const BeamSpotCol *fBeamSpot; //!beamspot branch
159	ceballos	1.28	const TrackCol *fTracks; //!track branch
160			const PFCandidateCol *fPFCandidates; //!pfcandidate branch
161	ceballos	1.36	Double_t fIntRadius; //!min IntRadius cut in pf isolation
162	ceballos	1.29	MuonCol *fNonIsolatedMuons; //!pointer to old muon collection
163			ElectronCol *fNonIsolatedElectrons;//!pointer to old electron collection
164	ceballos	1.31	TString fPileupEnergyDensityName;
165			const PileupEnergyDensityCol *fPileupEnergyDensity;
166	sixie	1.38	MuonTools *fMuonTools; // interface to tools for muon ID
167			MuonIDMVA *fMuonIDMVA; // helper class for MuonMVA
168			TString fMuonMVAWeights_Subdet0Pt10To14p5;
169			TString fMuonMVAWeights_Subdet1Pt10To14p5;
170			TString fMuonMVAWeights_Subdet0Pt14p5To20;
171			TString fMuonMVAWeights_Subdet1Pt14p5To20;
172			TString fMuonMVAWeights_Subdet0Pt20ToInf;
173			TString fMuonMVAWeights_Subdet1Pt20ToInf;
174	ceballos	1.28
175	loizides	1.11	ClassDef(MuonIDMod, 1) // Muon identification module
176	loizides	1.1	};
177			}
178			#endif