Mods/interface/MuonIDMod.h

//--------------------------------------------------------------------------------------------------
// $Id: MuonIDMod.h,v 1.43 2012/05/02 16:33:50 fabstoec 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"

#include "MitPhysics/Utils/interface/RhoUtilities.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; }

      void               SetRhoType(RhoUtilities::RhoType type)
        { fTheRhoType = type; };

      void               SetVertexName(const char* name) { fVertexName = name; }
      
      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"
        kPFRadialIso,                       //"PFRadialIso"
        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
      const PFCandidateCol *fPFNoPileUpCands;  //!pfnpu collection
      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;

      RhoUtilities::RhoType fTheRhoType;
      
    ClassDef(MuonIDMod, 1) // Muon identification module
  };
}
#endif
Revision:	1.44
Committed:	Thu May 3 08:45:30 2012 UTC (13 years ago) by fabstoec
Content type:	text/plain
Branch:	MAIN
Changes since 1.43:	+3 -1 lines
Log Message:	small update on RhoUtilities (changed default from NONE to DEFAULT)
#	User	Rev	Content
1	loizides	1.1	//--------------------------------------------------------------------------------------------------
2	fabstoec	1.44	// $Id: MuonIDMod.h,v 1.43 2012/05/02 16:33:50 fabstoec 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	fabstoec	1.43	#include "MitPhysics/Utils/interface/RhoUtilities.h"
29
30	loizides	1.1	namespace mithep
31			{
32			class MuonIDMod : public BaseMod
33			{
34			public:
35			MuonIDMod(const char *name="MuonIDMod",
36	loizides	1.6	const char *title="Muon identification module");
37
38	loizides	1.11	Double_t GetCaloIsoCut() const { return fCaloIsolationCut; }
39			const char *GetClassType() const { return fMuonClassType; }
40			const char *GetCleanName() const { return GetCleanMuonsName(); }
41			const char *GetCleanMuonsName() const { return fCleanMuonsName; }
42			Double_t GetCombIsoCut() const { return fCombIsolationCut; }
43			const char *GetIDType() const { return fMuonIDType; }
44			const char *GetInputName() const { return fMuonBranchName; }
45			const char *GetIsoType() const { return fMuonIsoType; }
46			const char *GetOutputName() const { return GetCleanMuonsName(); }
47	ceballos	1.24	Double_t GetPtMin() const { return fMuonPtMin; }
48	loizides	1.11	Double_t GetTrackIsoCut() const { return fTrackIsolationCut; }
49	sixie	1.38	Bool_t PassMuonMVA_BDTG_IdIso(const Muon mu, const Vertex vertex,
50	sixie	1.39	const PileupEnergyDensityCol *PileupEnergyDensity) const;
51	sixie	1.41	void SetPrintMVADebugInfo(Bool_t b) { fPrintMVADebugInfo = b; }
52	loizides	1.20	void SetApplyD0Cut(Bool_t b) { fApplyD0Cut = b; }
53	ceballos	1.32	void SetApplyDZCut(Bool_t b) { fApplyDZCut = b; }
54	loizides	1.11	void SetCaloIsoCut(Double_t cut) { fCaloIsolationCut = cut; }
55			void SetClassType(const char *type) { fMuonClassType = type; }
56	loizides	1.18	void SetCleanMuonsName(const char *name) { fCleanMuonsName = name; }
57	sixie	1.35	void SetOldMuonsName(const char *n) { fNonIsolatedMuonsName = n; }
58			void SetOldElectronsName(const char *n) { fNonIsolatedElectronsName = n; }
59	loizides	1.11	void SetCleanName(const char *name) { SetCleanMuonsName(name); }
60	loizides	1.18	void SetCombIsoCut(Double_t cut) { fCombIsolationCut = cut; }
61	sixie	1.35	void SetCombRelativeIsoCut(Double_t cut) { fCombRelativeIsolationCut = cut; }
62			void SetPFIsoCut(Double_t cut) { fPFIsolationCut = cut; }
63	loizides	1.20	void SetD0Cut(Double_t cut) { fD0Cut = cut; }
64	ceballos	1.32	void SetDZCut(Double_t cut) { fDZCut = cut; }
65			void SetWhichVertex(Int_t d) { fWhichVertex = d; }
66	ceballos	1.25	void SetEtaCut(Double_t cut) { fEtaCut = cut; }
67	loizides	1.11	void SetIDType(const char *type) { fMuonIDType = type; }
68			void SetInputName(const char *name) { fMuonBranchName = name; }
69			void SetIsoType(const char *type) { fMuonIsoType = type; }
70			void SetOutputName(const char *name) { SetCleanMuonsName(name); }
71			void SetPtMin(Double_t pt) { fMuonPtMin = pt; }
72			void SetTrackIsoCut(Double_t cut) { fTrackIsolationCut = cut; }
73	ceballos	1.36	void SetIntRadius(Double_t dr) { fIntRadius = dr; }
74	sixie	1.38	void SetMuonMVAWeightsSubdet0Pt10To14p5(TString s)
75			{ fMuonMVAWeights_Subdet0Pt10To14p5 = s; }
76			void SetMuonMVAWeightsSubdet1Pt10To14p5(TString s)
77			{ fMuonMVAWeights_Subdet1Pt10To14p5 = s; }
78			void SetMuonMVAWeightsSubdet0Pt14p5To20(TString s)
79			{ fMuonMVAWeights_Subdet0Pt14p5To20 = s; }
80			void SetMuonMVAWeightsSubdet1Pt14p5To20(TString s)
81			{ fMuonMVAWeights_Subdet1Pt14p5To20 = s; }
82			void SetMuonMVAWeightsSubdet0Pt20ToInf(TString s)
83			{ fMuonMVAWeights_Subdet0Pt20ToInf = s; }
84			void SetMuonMVAWeightsSubdet1Pt20ToInf(TString s)
85			{ fMuonMVAWeights_Subdet1Pt20ToInf = s; }
86	loizides	1.6
87	fabstoec	1.43	void SetRhoType(RhoUtilities::RhoType type)
88			{ fTheRhoType = type; };
89
90	fabstoec	1.44	void SetVertexName(const char* name) { fVertexName = name; }
91
92	loizides	1.6	enum EMuIdType {
93			kIdUndef = 0, //not defined
94	ceballos	1.26	kWMuId, //"WMuId"
95			kZMuId, //"ZMuId"
96	loizides	1.6	kTight, //"Tight"
97			kLoose, //"Loose"
98	ceballos	1.34	kWWMuIdV1, //"WWMuIdV1"
99			kWWMuIdV2, //"WWMuIdV2"
100	ceballos	1.37	kWWMuIdV3, //"WWMuIdV3"
101	sixie	1.38	kNoId, //"NoId"
102			kCustomId, //"Custom"
103			kMVAID_BDTG_IDIso //"BDTG ID + Iso03, Iso04 Combined"
104	loizides	1.6	};
105			enum EMuIsoType {
106	sixie	1.35	kIsoUndef = 0, //"not defined"
107			kTrackCalo, //"TrackCalo"
108			kTrackCaloCombined, //"TrackCaloCombined"
109			kTrackCaloSliding, //"TrackCaloSliding"
110			kTrackCaloSlidingNoCorrection, //"TrackCaloSlidingNoCorrection"
111			kCombinedRelativeConeAreaCorrected, //"CombinedRelativeConeAreaCorrected"
112	sixie	1.40	kCombinedRelativeEffectiveAreaCorrected,
113	sixie	1.35	kCustomIso, //"Custom"
114			kPFIso, //"PFIso"
115	ceballos	1.42	kPFRadialIso, //"PFRadialIso"
116	sixie	1.38	kPFIsoEffectiveAreaCorrected, //"PFIso with EffectiveArea Pileup Correction"
117	sixie	1.35	kPFIsoNoL, //"PFIsoNoL"
118	sixie	1.38	kNoIso, //"NoIso"
119			kMVAIso_BDTG_IDIso //"BDTG ID + Iso03, Iso04 Combined"
120	loizides	1.6	};
121			enum EMuClassType {
122			kClassUndef = 0, //not defined
123			kAll, //"All"
124			kGlobal, //"Global"
125	ceballos	1.34	kGlobalTracker, //"GlobalTracker"
126	loizides	1.6	kSta, //"Standalone"
127	loizides	1.23	kTrackerMuon, //"TrackerMuon"
128			kCaloMuon, //"CaloMuon"
129			kTrackerBased //"TrackerMuon or CaloMuon"
130	sixie	1.38
131	loizides	1.6	};
132
133	loizides	1.1	protected:
134	loizides	1.11	void Process();
135			void SlaveBegin();
136	loizides	1.10
137	sixie	1.41	Bool_t fPrintMVADebugInfo; //print MVA debug information
138	loizides	1.11	TString fMuonBranchName; //name of muon collection (input)
139			TString fCleanMuonsName; //name of exported "good muon" collection
140	ceballos	1.29	TString fNonIsolatedMuonsName; //name of imported "old muon" collection
141			TString fNonIsolatedElectronsName;//name of imported "old electron" collection
142	ceballos	1.15	TString fVertexName; //name of vertex collection
143	ceballos	1.32	TString fBeamSpotName; //name of beamspot collection
144	ceballos	1.28	TString fTrackName; //name of track collection
145			TString fPFCandidatesName; //name of pfcandidates collection
146	loizides	1.11	TString fMuonIDType; //type of muon id scheme we impose
147			TString fMuonIsoType; //type of muon isolations scheme we impose
148			TString fMuonClassType; //type of muon class we impose
149			Double_t fTrackIsolationCut; //cut value for track isolation
150			Double_t fCaloIsolationCut; //cut value for calo isolation
151			Double_t fCombIsolationCut; //cut value for combined isolation
152	sixie	1.35	Double_t fCombRelativeIsolationCut; //cut value for combined relative isolation
153			Double_t fPFIsolationCut; //cut value for combined isolation
154	loizides	1.11	Double_t fMuonPtMin; //min muon pt
155	loizides	1.20	Bool_t fApplyD0Cut; //=true then apply d0 cut (def=1)
156	ceballos	1.32	Bool_t fApplyDZCut; //=true then apply dz cut (def=1)
157	loizides	1.16	Double_t fD0Cut; //max d0
158	ceballos	1.32	Double_t fDZCut; //max dz
159			Int_t fWhichVertex; //vertex to use (-2: beamspot, -1: closest in Z)
160	ceballos	1.25	Double_t fEtaCut; //max eta, absolute value
161	loizides	1.11	EMuIdType fMuIDType; //!muon id type (imposed)
162			EMuIsoType fMuIsoType; //!muon iso type (imposed)
163			EMuClassType fMuClassType; //!muon class type (imposed)
164	loizides	1.16	const MuonCol *fMuons; //!muon collection
165			const VertexCol *fVertices; //!vertices branch
166	ceballos	1.32	const BeamSpotCol *fBeamSpot; //!beamspot branch
167	ceballos	1.28	const TrackCol *fTracks; //!track branch
168			const PFCandidateCol *fPFCandidates; //!pfcandidate branch
169	ceballos	1.42	const PFCandidateCol *fPFNoPileUpCands; //!pfnpu collection
170	ceballos	1.36	Double_t fIntRadius; //!min IntRadius cut in pf isolation
171	ceballos	1.29	MuonCol *fNonIsolatedMuons; //!pointer to old muon collection
172			ElectronCol *fNonIsolatedElectrons;//!pointer to old electron collection
173	ceballos	1.31	TString fPileupEnergyDensityName;
174			const PileupEnergyDensityCol *fPileupEnergyDensity;
175	sixie	1.38	MuonTools *fMuonTools; // interface to tools for muon ID
176			MuonIDMVA *fMuonIDMVA; // helper class for MuonMVA
177			TString fMuonMVAWeights_Subdet0Pt10To14p5;
178			TString fMuonMVAWeights_Subdet1Pt10To14p5;
179			TString fMuonMVAWeights_Subdet0Pt14p5To20;
180			TString fMuonMVAWeights_Subdet1Pt14p5To20;
181			TString fMuonMVAWeights_Subdet0Pt20ToInf;
182			TString fMuonMVAWeights_Subdet1Pt20ToInf;
183	ceballos	1.28
184	fabstoec	1.43	RhoUtilities::RhoType fTheRhoType;
185
186	loizides	1.11	ClassDef(MuonIDMod, 1) // Muon identification module
187	loizides	1.1	};
188			}
189			#endif