Config.Modifier Class Reference

Inheritance diagram for Config.Modifier:

Public Member Functions
def	__and__ (self, other)
def	__init__ (self)
def	__invert__ (self)
def	__or__ (self, other)
def	isChosen (self)
def	makeProcessModifier (self, func)
def	toModify (self, obj, func=None, kw)
def	toReplaceWith (self, toObj, fromObj)

Private Member Functions
def	_isOrContains (self, other)
def	_setChosen (self)

Static Private Member Functions
def	_toModify (obj, func, kw)
def	_toModifyCheck (obj, func, kw)
def	_toReplaceWith (toObj, fromObj)
def	_toReplaceWithCheck (toObj, fromObj)

Private Attributes
	__chosen
	__processModifiers

Detailed Description

This class is used to define standard modifications to a Process.
An instance of this class is declared to denote a specific modification,e.g. era2017 could
reconfigure items in a process to match our expectation of running in 2017. Once declared,
these Modifier instances are imported into a configuration and items that need to be modified
are then associated with the Modifier and with the action to do the modification.
The registered modifications will only occur if the Modifier was passed to 
the cms.Process' constructor.

Definition at line 1331 of file Config.py.

Constructor & Destructor Documentation

def Config.Modifier.__init__

(

self

)

Definition at line 1340 of file Config.py.

  def __init__(self):
    self.__processModifiers = []
    self.__chosen = False

Member Function Documentation

def Config.Modifier.__and__	(		self,
			other
	)

Definition at line 1412 of file Config.py.

  def __and__(self, other):
    return _AndModifier(self,other)

def Config.Modifier.__invert__

(

self

)

Definition at line 1414 of file Config.py.

  def __invert__(self):
    return _InvertModifier(self)

def Config.Modifier.__or__	(		self,
			other
	)

Definition at line 1416 of file Config.py.

Referenced by LumiList.LumiList.__add__().

  def __or__(self, other):
    return _OrModifier(self,other)

def Config.Modifier._isOrContains (   self,   other  )

private

Definition at line 1418 of file Config.py.

Referenced by Config.ModifierChain.__copyIfExclude().

  def _isOrContains(self, other):
    return self == other

def Config.Modifier._setChosen (   self )

private

Should only be called by cms.Process instances

Definition at line 1407 of file Config.py.

References Config.Modifier.__chosen.

  def _setChosen(self):
    """Should only be called by cms.Process instances"""
    self.__chosen = True

def Config.Modifier._toModify (   obj,   func,   kw  )

staticprivate

Definition at line 1371 of file Config.py.

References patCandidates_cff.func, and groupFilesInBlocks.temp.

  def _toModify(obj,func,**kw):
    if func is not None:
      func(obj)
    else:
      temp =_ParameterModifier(kw)
      temp(obj)

def Config.Modifier._toModifyCheck (   obj,   func,   kw  )

staticprivate

Definition at line 1350 of file Config.py.

  def _toModifyCheck(obj,func,**kw):
    if func is not None and len(kw) != 0:
      raise TypeError("toModify takes either two arguments or one argument and key/value pairs")

def Config.Modifier._toReplaceWith (   toObj,   fromObj  )

staticprivate

Definition at line 1389 of file Config.py.

References str.

  def _toReplaceWith(toObj,fromObj):
    if isinstance(fromObj,_ModuleSequenceType):
        toObj._seq = fromObj._seq
        toObj._tasks = fromObj._tasks
    elif isinstance(fromObj,Task):
        toObj._collection = fromObj._collection
    elif isinstance(fromObj,_Parameterizable):
        #clear old items just incase fromObj is not a complete superset of toObj
        for p in toObj.parameterNames_():
            delattr(toObj,p)
        for p in fromObj.parameterNames_():
            setattr(toObj,p,getattr(fromObj,p))
        if isinstance(fromObj,_TypedParameterizable):
            toObj._TypedParameterizable__type = fromObj._TypedParameterizable__type
            
    else:
        raise TypeError("toReplaceWith does not work with type "+str(type(toObj)))

def Config.Modifier._toReplaceWithCheck (   toObj,   fromObj  )

staticprivate

Definition at line 1378 of file Config.py.

  def _toReplaceWithCheck(toObj,fromObj):
    if not isinstance(fromObj, type(toObj)):
        raise TypeError("toReplaceWith requires both arguments to be the same class type")

def Config.Modifier.isChosen

(

self

)

Definition at line 1410 of file Config.py.

References Config.Modifier.__chosen.

Referenced by Config._BoolModifierBase.toModify(), Config.Modifier.toModify(), Config._BoolModifierBase.toReplaceWith(), and Config.Modifier.toReplaceWith().

  def isChosen(self):
    return self.__chosen

def Config.Modifier.makeProcessModifier	(		self,
			func
	)

This is used to create a ProcessModifer that can perform actions on the process as a whole.
   This takes as argument a callable object (e.g. function) that takes as its sole argument an instance of Process.
   In order to work, the value returned from this function must be assigned to a uniquely named variable.

Definition at line 1343 of file Config.py.

  def makeProcessModifier(self,func):
    """This is used to create a ProcessModifer that can perform actions on the process as a whole.
       This takes as argument a callable object (e.g. function) that takes as its sole argument an instance of Process.
       In order to work, the value returned from this function must be assigned to a uniquely named variable.
    """
    return ProcessModifier(self,func)

def Config.Modifier.toModify	(		self,
			obj,
			func = None,
			kw
	)

This is used to register an action to be performed on the specific object. Two different forms are allowed
Form 1: A callable object (e.g. function) can be passed as the second. This callable object is expected to take one argument
that will be the object passed in as the first argument.
Form 2: A list of parameter name, value pairs can be passed
   mod.toModify(foo, fred=cms.int32(7), barney = cms.double(3.14))
This form can also be used to remove a parameter by passing the value of None
#remove the parameter foo.fred       
mod.toModify(foo, fred = None)
Additionally, parameters embedded within PSets can also be modified using a dictionary
#change foo.fred.pebbles to 3 and foo.fred.friend to "barney"
mod.toModify(foo, fred = dict(pebbles = 3, friend = "barney)) )

Definition at line 1353 of file Config.py.

References Config._AndModifier.isChosen(), Config._InvertModifier.isChosen(), Config._OrModifier.isChosen(), and Config.Modifier.isChosen().

  def toModify(self,obj, func=None,**kw):
    """This is used to register an action to be performed on the specific object. Two different forms are allowed
    Form 1: A callable object (e.g. function) can be passed as the second. This callable object is expected to take one argument
    that will be the object passed in as the first argument.
    Form 2: A list of parameter name, value pairs can be passed
       mod.toModify(foo, fred=cms.int32(7), barney = cms.double(3.14))
    This form can also be used to remove a parameter by passing the value of None
        #remove the parameter foo.fred       
        mod.toModify(foo, fred = None)
    Additionally, parameters embedded within PSets can also be modified using a dictionary
        #change foo.fred.pebbles to 3 and foo.fred.friend to "barney"
        mod.toModify(foo, fred = dict(pebbles = 3, friend = "barney)) )
    """
    Modifier._toModifyCheck(obj,func,**kw)
    if not self.isChosen():
        return
    Modifier._toModify(obj,func,**kw)

def Config.Modifier.toReplaceWith	(		self,
			toObj,
			fromObj
	)

If the Modifier is chosen the internals of toObj will be associated with the internals of fromObj

Definition at line 1381 of file Config.py.

References Config._AndModifier.isChosen(), Config._InvertModifier.isChosen(), Config._OrModifier.isChosen(), and Config.Modifier.isChosen().

  def toReplaceWith(self,toObj,fromObj):
    """If the Modifier is chosen the internals of toObj will be associated with the internals of fromObj
    """
    Modifier._toReplaceWithCheck(toObj,fromObj)
    if not self.isChosen():
        return
    Modifier._toReplaceWith(toObj,fromObj)

Member Data Documentation

Config.Modifier.__chosen

private

Definition at line 1342 of file Config.py.

Referenced by Config.Modifier._setChosen(), Config.ModifierChain._setChosen(), Config.Modifier.isChosen(), and Config.ModifierChain.isChosen().

Config.Modifier.__processModifiers

private

Definition at line 1341 of file Config.py.