python.EventCleaningConfig.EventCleaningBlock Class Reference

Inheritance diagram for python.EventCleaningConfig.EventCleaningBlock:

Collaboration diagram for python.EventCleaningConfig.EventCleaningBlock:

Public Member Functions
	__init__ (self)
	instanceName (self)
	getDefaultGRLs (self, data_year)
	makeAlgs (self, config)

Public Attributes
	userGRLFiles
	useRandomRunNumber
	noFilter
	GRLDict
	runPrimaryVertexSelection
	runEventCleaning

Detailed Description

the ConfigBlock for event cleaning

Definition at line 8 of file EventCleaningConfig.py.

Constructor & Destructor Documentation

__init__()

python.EventCleaningConfig.EventCleaningBlock.__init__

(

self

)

Definition at line 11 of file EventCleaningConfig.py.

    def __init__ (self) :
        super (EventCleaningBlock, self).__init__ ()
        self.addOption ('runPrimaryVertexSelection', True, type=bool,
            info="whether to run primary vertex selection.")
        self.addOption ('runEventCleaning', False, type=bool,
            info="whether to run event cleaning (sets up an instance of "
            "`CP::EventFlagSelectionAlg`).")
        self.addOption ('runGRL', True, type=bool,
            info="whether to run GRL decoration/selection.")
        self.addOption ('userGRLFiles', [], type=None,
            info="a list of GRL files (list of strings) to select data from.")
        self.addOption ('minTracksPerVertex', 2, type=int,
            info="minimum number of tracks per vertex.")
        self.addOption ('selectionFlags', ['DFCommonJets_eventClean_LooseBad'], type=None,
            info="flags (list of strings) to use for jet cleaning.")
        # This is a vector<bool>, so parsing True/False is not handled
        # in AnalysisBase, but we can evade this with numerical values
        self.addOption ('invertFlags', [0], type=None,
            info="list of booleans determining whether to invert the cut of the "
            "above selectionFlags. In AnalysisBase, use 0/1 values instead.")
        self.addOption ('GRLDict', {}, type=None, info="a custom GRL dictionary with key some name and value a GRL file. Leaving it empty will use the recommended values.")
        self.addOption ('noFilter', False, type=bool,
            info="whether to toggle off event filtering.")
        self.addOption ('useRandomRunNumber', False, type=bool,
            info="use `RandomRunNumber` to compute GRL info. Only supported for MC")
 
        if self.runGRL and self.userGRLFiles:
            raise ValueError("No userGRLFiles should be specified if runGRL=False")
 

Member Function Documentation

getDefaultGRLs()

python.EventCleaningConfig.EventCleaningBlock.getDefaultGRLs	(		self,
			data_year )

returns a reasonable set of GRLs that should be suited for most analyses 

Definition at line 44 of file EventCleaningConfig.py.

    def getDefaultGRLs (self, data_year) :
        """ returns a reasonable set of GRLs that should be suited for most analyses """
        from GoodRunsLists.GoodRunsListsDictionary import getGoodRunsLists
        GRLDict = getGoodRunsLists()
 
        GRLKey = 'GRL' + str(data_year)
        if data_year==2017 or data_year==2018:
            GRLKey = GRLKey + '_Triggerno17e33prim'
        return GRLDict[GRLKey]
 

instanceName()

python.EventCleaningConfig.EventCleaningBlock.instanceName

(

self

)

Return the instance name for this block

Definition at line 40 of file EventCleaningConfig.py.

    def instanceName (self) :
        """Return the instance name for this block"""
        return '' # no instance name needed for singleton block
 

makeAlgs()

python.EventCleaningConfig.EventCleaningBlock.makeAlgs	(		self,
			config )

Definition at line 54 of file EventCleaningConfig.py.

    def makeAlgs (self, config) :
        
        # Apply GRL
        if self.runGRL and (config.dataType() is DataType.Data or self.useRandomRunNumber):
            if config.dataType() is DataType.Data and self.useRandomRunNumber:
                raise ValueError ("UseRandomRunNumber is only supported for MC!")
 
            if self.noFilter:
                # here we only decorate the PHYSLITE events with a boolean and don't do any cleaning
                # Set up the GRL Decoration
                if not self.GRLDict:
                    raise ValueError ("No GRLDict specified for GRL decoration, please specify a GRLDict")
 
                for GRLDecoratorName, GRLFileList in self.GRLDict.items():
                    if isinstance(GRLFileList, str):
                        GRLFileList = [GRLFileList]
 
                    alg = config.createAlgorithm("GRLSelectorAlg", GRLDecoratorName)
                    config.addPrivateTool("Tool", "GoodRunsListSelectionTool")
                    alg.Tool.UseRandomRunNumber = self.useRandomRunNumber
                    alg.Tool.GoodRunsListVec = GRLFileList
                    alg.noFilter = True
                    alg.grlKey = f"EventInfo.{GRLDecoratorName}"
 
                    config.addOutputVar("EventInfo", GRLDecoratorName, GRLDecoratorName, noSys=True, auxType="char")
            else:
                # Set up the GRL selection:
                alg = config.createAlgorithm( 'GRLSelectorAlg', 'GRLSelectorAlg' )
                config.addPrivateTool( 'Tool', 'GoodRunsListSelectionTool' )
                alg.Tool.UseRandomRunNumber = self.useRandomRunNumber
                if self.userGRLFiles:
                    alg.Tool.GoodRunsListVec = self.userGRLFiles
                else:
                    alg.Tool.GoodRunsListVec = self.getDefaultGRLs( config.dataYear() )
 
        # Skip events with no primary vertex:
        if self.runPrimaryVertexSelection:
            alg = config.createAlgorithm( 'CP::VertexSelectionAlg',
                                          'PrimaryVertexSelectorAlg',
                                           reentrant=True )
            alg.VertexContainer = 'PrimaryVertices'
            alg.MinVertices = 1
            alg.MinTracks = self.minTracksPerVertex
 
        # Set up the event cleaning selection:
        if self.runEventCleaning:
            if config.dataType() is DataType.Data:
                alg = config.createAlgorithm( 'CP::EventStatusSelectionAlg', 'EventStatusSelectionAlg' )
                alg.FilterKey = 'EventErrorState'
                alg.FilterDescription = 'selecting events without any error state set'
 
            alg = config.createAlgorithm( 'CP::EventFlagSelectionAlg', 'EventFlagSelectionAlg' )
            alg.FilterKey = 'JetCleaning'
            alg.selectionFlags = [f'{sel},as_char' for sel in self.selectionFlags]
            alg.invertFlags = self.invertFlags
            alg.FilterDescription = f"selecting events passing: {','.join(alg.selectionFlags)}"
 
 
 

Member Data Documentation

GRLDict

python.EventCleaningConfig.EventCleaningBlock.GRLDict

Definition at line 64 of file EventCleaningConfig.py.

noFilter

python.EventCleaningConfig.EventCleaningBlock.noFilter

Definition at line 61 of file EventCleaningConfig.py.

runEventCleaning

python.EventCleaningConfig.EventCleaningBlock.runEventCleaning

Definition at line 99 of file EventCleaningConfig.py.

runPrimaryVertexSelection

python.EventCleaningConfig.EventCleaningBlock.runPrimaryVertexSelection

Definition at line 90 of file EventCleaningConfig.py.

useRandomRunNumber

python.EventCleaningConfig.EventCleaningBlock.useRandomRunNumber

Definition at line 57 of file EventCleaningConfig.py.

userGRLFiles

python.EventCleaningConfig.EventCleaningBlock.userGRLFiles

Definition at line 37 of file EventCleaningConfig.py.

---

The documentation for this class was generated from the following file:

• EventCleaningConfig.py