TauDiscriminatorTools Namespace Reference

Functions
def	adaptTauDiscriminator
def	adaptTauDiscriminatorSequence
def	recoTauTypeMapper
def	setTauSource
def	subParameterSets
Variables
tuple	leadTrackFinding
tuple	noPrediscriminants
	producerIsTauTypeMapper = lambdatauProducer:tauProducer
tuple	recoTauTypeMapperRegex = re.compile("(\w*)Producer")
tuple	requireLeadPion
tuple	requireLeadTrack
tuple	requireLeadTrackCalo

---

Function Documentation

def TauDiscriminatorTools::adaptTauDiscriminator	(		discriminator,
			newTauProducer = 'shrinkingConePFTauProducer',
			oldTauTypeMapper = recoTauTypeMapper,
			newTauTypeMapper = recoTauTypeMapper,
			preservePFTauProducer = False
	)

Change a TauDiscriminator to use a different tau/prediscriminant sources

Tau discriminators use the following convention: 
     [tauType]DiscriminationByXXX

i.e. fixedConePFTauDiscriminationByIsolation,
allLayer1TausDiscriminationByIsolation, etc

However, the mapping of tauType to tau producer name is not constant.  In
RECO, the form is [tauType]Producer.  In PAT, the producer is just named
[tauType].  To manage this oldTauTypeMapper and newTauTypeMapper are
functions with signature f(str) that translate a TauProducer name (like
shrinkingConePFTauProducer) to its type (shrinkingConePFTau).  Two types of
mapping are provided, 
     * recoTauTypeMapper
           shrinkingConePFTauProducer->shrinkingConePFTau
     * producerIsTauTypeMapper
           allLayer1Taus->allLayer1Taus

Definition at line 51 of file TauDiscriminatorTools.py.

                                    :
   ''' Change a TauDiscriminator to use a different tau/prediscriminant sources

   Tau discriminators use the following convention: 
        [tauType]DiscriminationByXXX

   i.e. fixedConePFTauDiscriminationByIsolation,
   allLayer1TausDiscriminationByIsolation, etc

   However, the mapping of tauType to tau producer name is not constant.  In
   RECO, the form is [tauType]Producer.  In PAT, the producer is just named
   [tauType].  To manage this oldTauTypeMapper and newTauTypeMapper are
   functions with signature f(str) that translate a TauProducer name (like
   shrinkingConePFTauProducer) to its type (shrinkingConePFTau).  Two types of
   mapping are provided, 
        * recoTauTypeMapper
              shrinkingConePFTauProducer->shrinkingConePFTau
        * producerIsTauTypeMapper
              allLayer1Taus->allLayer1Taus

   '''

   oldTauProducer = discriminator.PFTauProducer
   if isinstance(newTauProducer, str):
      newTauProducer = cms.InputTag(newTauProducer)

   # This is useful for the PF2PAT case where you wish to set the producer name
   # seperately
   if not preservePFTauProducer: 
      discriminator.PFTauProducer = newTauProducer

   oldTauType = oldTauTypeMapper(oldTauProducer.value())
   newTauType = newTauTypeMapper(newTauProducer.value())

   replacementRegex = re.compile(oldTauType)

   # Adapt all the prediscriminants
   for prediscriminant in subParameterSets(discriminator.Prediscriminants):
      oldProducer = prediscriminant.Producer.value() 
      # Replace the old tau type by the new tau type in the prediscrimant
      # producer
      prediscriminant.Producer = cms.InputTag(replacementRegex.sub(newTauType,
         oldProducer))

def TauDiscriminatorTools::adaptTauDiscriminatorSequence	(		sequence,
			kwargs
	)

Definition at line 97 of file TauDiscriminatorTools.py.

                                                     :
   def fixer(discriminator):
      if hasattr(discriminator, "Prediscriminants"):
         adaptTauDiscriminator(discriminator, **kwargs)
   sequence.visit(fixer)

def TauDiscriminatorTools::recoTauTypeMapper

(

tauProducer

)

Definition at line 45 of file TauDiscriminatorTools.py.

00046                                   :
00047    return recoTauTypeMapperRegex.match(tauProducer).group(1)
00048 
# For taus where the producer name is the type, like "allLayer1Taus", etc

def TauDiscriminatorTools::setTauSource	(		discriminator,
			newTauProducer
	)

Same as adaptTauDiscriminator, kept for backwards compatibility

Definition at line 103 of file TauDiscriminatorTools.py.

                                               :
   ''' Same as adaptTauDiscriminator, kept for backwards compatibility'''
   adaptTauDiscriminator(discriminator, newTauProducer)

def TauDiscriminatorTools::subParameterSets

(

pSet

)

Generator to return all sub-PSets in a PSet 

Definition at line 36 of file TauDiscriminatorTools.py.

00037                           :
00038    ''' Generator to return all sub-PSets in a PSet '''
00039    for name, value in pSet.parameters_().iteritems():
00040       if isinstance(value, cms.PSet):
00041          yield getattr(pSet, name)
00042 
# For RECO type taus, where the tau producer is [tauType]Producer 

---

Variable Documentation

tuple TauDiscriminatorTools::leadTrackFinding

Initial value:

cms.PSet(
      Producer = cms.InputTag('pfRecoTauDiscriminationByLeadingTrackFinding'),
      cut = cms.double(0.5)
)

Definition at line 4 of file TauDiscriminatorTools.py.

tuple TauDiscriminatorTools::noPrediscriminants

Initial value:

cms.PSet(
      BooleanOperator = cms.string("and"),
      )

Definition at line 10 of file TauDiscriminatorTools.py.

TauDiscriminatorTools::producerIsTauTypeMapper = lambdatauProducer:tauProducer

Definition at line 49 of file TauDiscriminatorTools.py.

tuple TauDiscriminatorTools::recoTauTypeMapperRegex = re.compile("(\w*)Producer")

Definition at line 44 of file TauDiscriminatorTools.py.

tuple TauDiscriminatorTools::requireLeadPion

Initial value:

cms.PSet(
      BooleanOperator = cms.string("and"),
      leadPion = leadTrackFinding,
      )

Definition at line 31 of file TauDiscriminatorTools.py.

tuple TauDiscriminatorTools::requireLeadTrack

Initial value:

cms.PSet(
      BooleanOperator = cms.string("and"),
      leadTrack = leadTrackFinding,
      )

Definition at line 15 of file TauDiscriminatorTools.py.

tuple TauDiscriminatorTools::requireLeadTrackCalo

Initial value:

cms.PSet(
      BooleanOperator = cms.string("and"),
      leadTrack = cms.PSet(
         Producer = cms.InputTag('caloRecoTauDiscriminationByLeadingTrackFinding'),
         cut = cms.double(0.5)
         )
      )

Definition at line 21 of file TauDiscriminatorTools.py.