JetMonitoringConfig Namespace Reference

Classes
class	ConfigDict
class	EventHistoSpec
class	HistoSpec
class	JetMonAlgSpec
class	JetMonSpecException
class	SelectSpec
class	ToolSpec
class	VarSpec

Functions
	interpretManySelStr (selStr)
	interpretSelStr (selStr)
	findSelectIndex (name)
	retrieveVarToolConf (alias)
	retrieveEventVarToolConf (alias)
	retrieveHistoToolConf (alias)

Function Documentation

findSelectIndex()

JetMonitoringConfig.findSelectIndex

(

name

)

interprets 'varName[X]' into ('varName',x) 

Definition at line 144 of file JetMonitoringConfig.py.

def findSelectIndex( name):
    """ interprets 'varName[X]' into ('varName',x) """
    try:
        name, index = name.split('[')
    except ValueError:
        name, index = name, ''
    if not index.endswith(']'):
        return name, -1
    index = int(index[:-1])
    return name, index
 
# **********************************************************
 
 

interpretManySelStr()

JetMonitoringConfig.interpretManySelStr

(

selStr

)

Definition at line 105 of file JetMonitoringConfig.py.

def interpretManySelStr(selStr):
    selL = selStr.split('&')
    interpL = [interpretSelStr( s ) for s in selL]
    # interpL is in the form [ (min1,v1,max1), (min2,v2,max2),..]
    # unpack it into 3 lists :
    minL, varL, maxL = zip(*interpL)
    return minL, varL, maxL
    

interpretSelStr()

JetMonitoringConfig.interpretSelStr

(

selStr

)

Interpret a selection string in the form '12.3<var<42.0'
and returns a tuple.
 '12.3<var<42.0' -> returns (12.3, 'var', 42.)
 'var<42.0' -> returns (None, 'var', 42.)
 '12.3<var' -> returns (12.3, 'var', None)

Definition at line 113 of file JetMonitoringConfig.py.

def interpretSelStr(selStr):
    """Interpret a selection string in the form '12.3<var<42.0'
    and returns a tuple.
     '12.3<var<42.0' -> returns (12.3, 'var', 42.)
     'var<42.0' -> returns (None, 'var', 42.)
     '12.3<var' -> returns (12.3, 'var', None)
    """
 
    if '>' in selStr:
        print("JetMonitoring ERROR interpreting selection string ", selStr)
        print("JetMonitoring ERROR  can not interpret '>', please use only '<' ")
 
    parts = selStr.split('<')
    cmin, cmax = -3.4e38, 3.4e38 #we declare std::vector<float> for both on the c++ side, but will not necessarily pass actual values for them, so we use min/max float values in python as default (hardcoded numbers, because not easily accessible)
    var = selStr
    if len(parts)==2:
        ismin = False
        try :
            var, cut = parts[0] , float(parts[1])
        except ValueError:
            cut, var = float(parts[0]) ,parts[1]
            ismin=True
        if ismin : cmin = cut
        else: cmax = cut
    elif len(parts)==3:
        cmin, var, cmax = parts
        cmin = float(cmin)
        cmax = float(cmax)
 
    return cmin, var, cmax
 

retrieveEventVarToolConf()

JetMonitoringConfig.retrieveEventVarToolConf

(

alias

)

Return a ToolSpec from alias : (now with EventInfo or JetContainer variables) 
    * if alias is a string build a ToolSpec, assuming alias is an attribute of type float.
    * if alias is a ToolSpec, returns it directly

Definition at line 605 of file JetMonitoringConfig.py.

def retrieveEventVarToolConf(alias):
    """Return a ToolSpec from alias : (now with EventInfo or JetContainer variables) 
        * if alias is a string build a ToolSpec, assuming alias is an attribute of type float.
        * if alias is a ToolSpec, returns it directly
    """
    from JetMonitoring.JetStandardHistoSpecs import knownEventVar
    if isinstance(alias, str): #check for existing event or jetcontainer specs
        conf = knownEventVar.get(alias,None) 
        if conf is None: #assume it's an eventInfo variable
          conf = ToolSpec('EventHistoVarTool', alias, Attribute=alias) 
    else: # assume it's a config dict
        conf = alias
    return conf
 
 

retrieveHistoToolConf()

JetMonitoringConfig.retrieveHistoToolConf

(

alias

)

Return a HistoSpec from alias : 
    * if alias is a string look up in JetStandardHistoSpecs.knownHistos
      --> if found, return a full clone (so client can modify it safely)
      --> if not found and contain a ';' build a HistoSpec for a 2D histograms
    * if alias is a ToolSpec, returns it directly

Definition at line 620 of file JetMonitoringConfig.py.

def retrieveHistoToolConf(alias):
    """Return a HistoSpec from alias : 
        * if alias is a string look up in JetStandardHistoSpecs.knownHistos
          --> if found, return a full clone (so client can modify it safely)
          --> if not found and contain a ';' build a HistoSpec for a 2D histograms
        * if alias is a ToolSpec, returns it directly
    """
    if isinstance(alias, ToolSpec):
        return alias
    elif isinstance(alias,str):        
        from JetMonitoring.JetStandardHistoSpecs import knownHistos
        # get it from knownHistos
        c = knownHistos.get(alias,None)
        if c :
            # found a knownHistos.
            # we return a *clone* so that it can be modified without changing the standard spec.
            return c.clone(c.name) 
        if ';' not in alias:
            raise JetMonSpecException(" Unknown Histo specification : '{}' ".format(alias))
            # print 'ERROR unknown Histo Filler specification ', alias
            # return None
        # we have a ';' : try to generate a 2D histo
        aliases = alias.split(';')
        aliasX, aliasY = aliases[0], aliases[1]
        cX = knownHistos.get(aliasX,None)
        cY = knownHistos.get(aliasY,None)
        if len(aliases) == 2:
            if None in (cX,cY):
                print("ERROR unknown Histo Filler specification  ", cX if cX is None else cY)
                return None
            # merge the spec            
            return cX.to2DSpec(cY)
        else: # must be 3
            aliasZ = aliases[2]
            cZ = knownHistos.get(aliasZ,None)
            if cZ is None:
                # then we can try to build a dummy HistoSpec from a variable
                #  this is ok, since we're building a TProfile2D and we don't need
                #  binning info on the xAxis
                vZ = retrieveVarToolConf(aliasZ)
                cZ = HistoSpec(vZ.Name, (10,0,1) , title=vZ.Name+';'+vZ.Name+';', xvar=vZ )
            return cX.to2DSpec(cY, zspec=cZ)
        
    else:
        # What is this :
        print('ERROR can not instantiate a tool from ', alias)
        return None
 
 

retrieveVarToolConf()

JetMonitoringConfig.retrieveVarToolConf

(

alias

)

Return a VarSpec from alias : 
    * if alias is a string look up in JetStandardHistoSpecs.knownVar
      --> if not found build a VarSpec, assuming alias is an attribute of type float.
    * if alias is a VarSpec, returns it directly

Definition at line 589 of file JetMonitoringConfig.py.

def retrieveVarToolConf(alias):
    """Return a VarSpec from alias : 
        * if alias is a string look up in JetStandardHistoSpecs.knownVar
          --> if not found build a VarSpec, assuming alias is an attribute of type float.
        * if alias is a VarSpec, returns it directly
    """
    from JetMonitoring.JetStandardHistoSpecs import knownVar
    if isinstance(alias, str):
        conf = knownVar.get(alias,None)
        if conf is None:
            conf=VarSpec( Name=alias, Type='float')
    else: # assume it's a config dict
        conf = alias
    return conf