Utilities Namespace Reference

Namespaces
namespace	ReleaseScripts
Classes
class	InputTagLabelSet
class	TestModuleCommand
Functions
def	_build_options
def	convertToUnscheduled
def	getHltConfiguration
def	loadHltConfiguration
def	removeModulesNotOnAPathExcluding
def	traverseInputTags

---

Function Documentation

def Utilities::_build_options

(

args

)

[private]

Definition at line 6 of file Utilities.py.

                          :
  options = _options.HLTProcessOptions()
  for key, val in args.iteritems():
    setattr(options, key, val)
  return options

def Utilities::convertToUnscheduled

(

proc

)

Definition at line 69 of file Utilities.py.

                              :
  import FWCore.ParameterSet.Config as cms
  """Given a 'Process', convert the python configuration from scheduled execution to unscheduled. This is done by
    1. Removing all modules not on Paths or EndPaths
    2. Pulling EDProducers not dependent on EDFilters off of all Paths
    3. Dropping any Paths which are now empty
    4. Fixing up the Schedule if needed
  """
  # Warning: It is not always possible to convert a configuration
  # where EDProducers are all run on Paths to an unscheduled
  # configuration by modifying only the python configuration.
  # There is more than one kind of pathological condition
  # that can cause this conversion to produce a configuration
  # that gives different results than the original configuration
  # when run under cmsRun. One should view the converted configuration
  # as a thing which needs to be validated. It is possible for there
  # to be pathologies that cannot be resolved by modifying only the
  # python configuration and may require redesign inside the C++ code
  # of the modules and redesign of the logic. For example,
  # an EDAnalyzer might try to get a product and check if the
  # returned handle isValid. Then it could behave differently
  # depending on whether or not the product was present.
  # The behavior when the product is not present could
  # be meaningful and important. In the unscheduled case,
  # the EDProducer will always run and the product could
  # always be there.

  # Remove all modules not on Paths or EndPaths
  proc.prune()

  # Turn on unschedule mode
  if not hasattr(proc,'options'):
    proc.options = cms.untracked.PSet()
  proc.options.allowUnscheduled = cms.untracked.bool(True)

  l = proc.paths
  droppedPaths =[]
  #have to get them now since switching them after the
  # paths have been changed gives null labels
  if proc.schedule:
    pathNamesInScheduled = [p.label_() for p in proc.schedule]
  else:
    pathNamesInScheduled = False

  # Look for EDProducers that depend on an EDFilter, either
  # directly or indirectly through another EDProducer. These
  # EDProducers must stay in a path and run scheduled. The
  # first loop will find all the direct dependencies, but then
  # the loop must be repeated until no more dependencies
  # are found in order to find the indirect dependencies.
  # Note that here we are assuming that if a module
  # has a configuration parameter that is an InputTag, then
  # it depends on the module with the same module label as in
  # the InputTag. In addition, there are a number of special
  # cases where we have identified specific types of modules
  # which use particular string parameters like InputTag
  # module labels. And so we have some special code to
  # handle those cases also. If there are other cases where
  # the module gets things without using InputTags, then this
  # conversion script can fail, which might result in ProductNotFound
  # exceptions or other problems when the converted configuration is run.

  # The dictionary keys are are the types of the EDProducers
  # The dictionary values are lists of parameter names that are strings
  # used like InputTags.
  knownStringInputLabels = {}
  knownStringInputLabels['KProd'] = ['xSrc'] # a fake entry for a unit test below
  knownStringInputLabels['SeedGeneratorFromRegionHitsEDProducer'] = ['vertexSrc']
  knownStringInputLabels['PixelTrackProducer'] = ['vertexSrc']
  knownStringInputLabels['SimpleTrackListMerger'] = ['TrackProducer1', 'TrackProducer2']

  allEDFilters = set(proc.filters_().keys())
  allEDProducers = set(proc.producers_().keys())

  dependentProducers = set()
  firstPass = True

  while True :

    dependentsFoundThisPass = False

    for producer in allEDProducers :
      if producer not in dependentProducers :
        iModule = getattr(proc,producer)

        stringInputLabels = []
        moduleType = iModule.type_()
        if moduleType in knownStringInputLabels :
          stringInputLabels = knownStringInputLabels[moduleType]

        inputTagLabels = InputTagLabelSet()
        traverseInputTags(getattr(proc,producer), inputTagLabels, stringInputLabels)

        if firstPass :
          if not inputTagLabels.labels.isdisjoint(allEDFilters) :
            dependentProducers.add(producer)
            dependentsFoundThisPass = True

        if not inputTagLabels.labels.isdisjoint(dependentProducers) :
          dependentProducers.add(producer)
          dependentsFoundThisPass = True

    if not dependentsFoundThisPass :
      break
    firstPass = False

  # Loop over paths
  # On each path we drop EDProducers except we
  # keep the EDProducers that depend on EDFilters
  for pName,p in l.iteritems():
    nodes = []
    v = cms.ModuleNodeVisitor(nodes)
    p.visit(v)
    names = [node.label_() for node in nodes]
    remaining =[]

    for n in names:
      if not isinstance(getattr(proc,n), cms.EDProducer):
        remaining.append(n)
      else :
        if n in dependentProducers :
          remaining.append(n)

    if remaining:
      p=getattr(proc,remaining[0])
      for m in remaining[1:]:
        p+=getattr(proc,m)
      setattr(proc,pName,cms.Path(p))
    # drop empty paths
    else:
      setattr(proc,pName,cms.Path())

  # If there is a schedule then it needs to point at
  # the new Path objects
  if proc.schedule:
    proc.schedule = cms.Schedule([getattr(proc,p) for p in pathNamesInScheduled])
  return proc

def Utilities::getHltConfiguration	(		menu,
			args
	)

Definition at line 13 of file Utilities.py.

                                     :
  args['menu']     = menu
  args['fragment'] = False
  options = _build_options(**args)

  hlt = _imp.new_module('hlt')
  exec _confdb.HLTProcess(options).dump() in globals(), hlt.__dict__
  return hlt.process

def Utilities::loadHltConfiguration	(		process,
			menu,
			args
	)

Definition at line 23 of file Utilities.py.

                                               :
  args['menu']     = menu
  args['fragment'] = True
  options = _build_options(**args)

  hlt = _imp.new_module('hlt')
  exec _confdb.HLTProcess(options).dump() in globals(), hlt.__dict__
  process.extend( hlt )

def Utilities::removeModulesNotOnAPathExcluding	(		process,
			keepList = ()
	)

Given a 'process', find all modules (EDProducers,EDFilters,EDAnalyzers,OutputModules)
and remove them if they do not appear on a Path or EndPath.  One can optionally pass in
a list of modules which even if they are not on a Path or EndPath you wish to have stay 
in the configuration [useful for unscheduled execution].

Definition at line 1 of file Utilities.py.

                                                            :
    """Given a 'process', find all modules (EDProducers,EDFilters,EDAnalyzers,OutputModules)
    and remove them if they do not appear on a Path or EndPath.  One can optionally pass in
    a list of modules which even if they are not on a Path or EndPath you wish to have stay 
    in the configuration [useful for unscheduled execution].
    """
    allMods=set((x for x in process.producers_().iterkeys()))
    allMods.update((x for x in process.filters_().iterkeys()))
    allMods.update((x for x in process.analyzers_().iterkeys()))
    allMods.update((x for x in process.outputModules_().iterkeys()))
    
    modulesOnPaths = set()
    for p in process.paths_():
        modulesOnPaths.update( (x for x in getattr(process,p).moduleNames()))        
    for p in process.endpaths_():
        modulesOnPaths.update( (x for x in getattr(process,p).moduleNames()))

    notOnPaths = allMods.difference(modulesOnPaths)
    
    keepModuleNames = set( (x.label_() for x in keepList) )
    
    getRidOf = notOnPaths.difference(keepModuleNames)
    
    for n in getRidOf:
        delattr(process,n)

def Utilities::traverseInputTags	(		pset,
			visitor,
			stringInputLabels
	)

Definition at line 44 of file Utilities.py.

                                                       :
  from FWCore.ParameterSet.Mixins import _Parameterizable
  from FWCore.ParameterSet.Types import VPSet, VInputTag, InputTag, string

  # Loop over parameters in a PSet
  for name in pset.parameters_().keys() :
    value = getattr(pset,name)
    # Recursive calls into a PSet in a PSet
    if isinstance(value, _Parameterizable) :
      traverseInputTags(value, visitor, stringInputLabels)
    # Recursive calls into PSets in a VPSet
    elif isinstance(value, VPSet) :
      for (n, psetInVPSet) in enumerate(value):
        traverseInputTags(psetInVPSet, visitor, stringInputLabels)
    # Get the labels from a VInputTag
    elif isinstance(value, VInputTag) :
      visitor(value)
    # Get the label from an InputTag
    elif isinstance(value, InputTag) :
      visitor(value)
    # Known module labels in string objects
    elif stringInputLabels and isinstance(value, string) and name in stringInputLabels and value.value() :
      visitor.labels.add(value.value())
    #ignore the rest