TauDiscriminatorTools Namespace Reference

Functions
def	adaptTauDiscriminator (discriminator, newTauProducer='shrinkingConePFTauProducer', oldTauTypeMapper=recoTauTypeMapper, newTauTypeMapper=recoTauTypeMapper, preservePFTauProducer=False)
def	adaptTauDiscriminatorSequence (sequence, **kwargs)
def	recoTauTypeMapper (tauProducer)
def	setTauSource (discriminator, newTauProducer)
def	subParameterSets (pSet)

Variables
	BooleanOperator
	cut
	leadPion
	leadTrack
	leadTrackFinding
	noPrediscriminants
	Producer
	producerIsTauTypeMapper
	recoTauTypeMapperRegex
	requireLeadPion
	requireLeadTrack

Function Documentation

adaptTauDiscriminator()

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 43 of file TauDiscriminatorTools.py.

def 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
 
   '''
 
   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))
 

References subParameterSets().

Referenced by adaptTauDiscriminatorSequence(), pfTools.reconfigurePF2PATTaus(), and setTauSource().

adaptTauDiscriminatorSequence()

def TauDiscriminatorTools.adaptTauDiscriminatorSequence	(		sequence,
		**	kwargs
	)

Definition at line 89 of file TauDiscriminatorTools.py.

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

References adaptTauDiscriminator().

recoTauTypeMapper()

def TauDiscriminatorTools.recoTauTypeMapper

(

tauProducer

)

Definition at line 37 of file TauDiscriminatorTools.py.

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

References watchdog.group.

Referenced by pfTools.reconfigurePF2PATTaus().

setTauSource()

def TauDiscriminatorTools.setTauSource	(		discriminator,
			newTauProducer
	)

Same as adaptTauDiscriminator, kept for backwards compatibility

Definition at line 95 of file TauDiscriminatorTools.py.

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

References adaptTauDiscriminator().

subParameterSets()

def TauDiscriminatorTools.subParameterSets

(

pSet

)

Generator to return all sub-PSets in a PSet 

Definition at line 28 of file TauDiscriminatorTools.py.

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

Referenced by adaptTauDiscriminator().

Variable Documentation

BooleanOperator

TauDiscriminatorTools.BooleanOperator

Definition at line 12 of file TauDiscriminatorTools.py.

cut

TauDiscriminatorTools.cut

Definition at line 7 of file TauDiscriminatorTools.py.

leadPion

TauDiscriminatorTools.leadPion

Definition at line 25 of file TauDiscriminatorTools.py.

leadTrack

TauDiscriminatorTools.leadTrack

Definition at line 18 of file TauDiscriminatorTools.py.

leadTrackFinding

TauDiscriminatorTools.leadTrackFinding

Definition at line 5 of file TauDiscriminatorTools.py.

noPrediscriminants

TauDiscriminatorTools.noPrediscriminants

Definition at line 11 of file TauDiscriminatorTools.py.

Producer

TauDiscriminatorTools.Producer

Definition at line 6 of file TauDiscriminatorTools.py.

producerIsTauTypeMapper

TauDiscriminatorTools.producerIsTauTypeMapper

Definition at line 41 of file TauDiscriminatorTools.py.

Referenced by pfTools.reconfigurePF2PATTaus().

recoTauTypeMapperRegex

TauDiscriminatorTools.recoTauTypeMapperRegex

Definition at line 36 of file TauDiscriminatorTools.py.

requireLeadPion

TauDiscriminatorTools.requireLeadPion

Definition at line 23 of file TauDiscriminatorTools.py.

requireLeadTrack

TauDiscriminatorTools.requireLeadTrack

Definition at line 16 of file TauDiscriminatorTools.py.