Reference Manual

## Runs

Public Member Functions
def	__del__

def	__init__

def	__iter__

def	aux

def	getByLabel

def	runAuxiliary

Private Member Functions
def	_createFWLiteRun
	Private Member Functions ##. More...

def	_next

Private Attributes
	_currFilename

	_filenames

	_maxRuns
	Parse optional arguments ##. More...

	_run

	_runCounts

	_secondaryFilenames

	_tfile

	_veryFirstTime

Detailed Description

## Runs

Python interface to FWLite LuminosityBlock

Definition at line 299 of file __init__.py.

Constructor & Destructor Documentation

def python.Runs.__init__	(	self,
		inputFiles = `''`,
		kwargs
	)

Definition at line 301 of file __init__.py.

 
     def __init__ (self, inputFiles = '', **kwargs):
         self._run = None
         self._runCounts = 0
         self._tfile = None
         self._maxRuns = 0
         if isinstance (inputFiles, list):
             # it's a list
             self._filenames = inputFiles[:]
         elif isinstance (inputFiles, VarParsing):
             # it's a VarParsing object
             options = inputFiles
             self._maxRuns           = options.maxEvents
             self._filenames           = options.inputFiles
         else:
             # it's probably a single string
             self._filenames = [inputFiles]
         ##############################
         ## Parse optional arguments ##
         ##############################
         if 'maxEvents' in kwargs:
             self._maxRuns = kwargs['maxEvents']
             del kwargs['maxEvents']
         if 'options' in kwargs:
             options = kwargs ['options']
             self._maxRuns           = options.maxEvents
             self._filenames           = options.inputFiles
             self._secondaryFilenames  = options.secondaryInputFiles
             del kwargs['options']
         # Since we deleted the options as we used them, that means
         # that kwargs should be empty.  If it's not, that means that
         # somebody passed in an argument that we're not using and we
         # should complain.
         if len (kwargs):
             raise RuntimeError("Unknown arguments %s" % kwargs)
         if not self._filenames:
             raise RuntimeError("No input files given")
         if not self._createFWLiteRun():
             # this shouldn't happen as you are getting nothing the
             # very first time out, but let's at least check to
             # avoid problems.
             raise RuntimeError("Never and information about Run")
 

python.Runs._secondaryFilenames

_secondaryFilenames

Definition: __init__.py:327

python.Runs._run

_run

Definition: __init__.py:302

python.Runs._maxRuns

_maxRuns

Parse optional arguments ##.

Definition: __init__.py:305

python.Runs._tfile

_tfile

Definition: __init__.py:304

python.Runs._createFWLiteRun

def _createFWLiteRun

Private Member Functions ##.

Definition: __init__.py:417

python.Runs._filenames

_filenames

Definition: __init__.py:308

python.Runs._runCounts

_runCounts

Definition: __init__.py:303

python.Runs.__init__

def __init__

Definition: __init__.py:301

def python.Runs.__del__ ( self )

(Internal) Destructor

Definition at line 344 of file __init__.py.

References MELaserPrim._run, and python.Runs._run.

 
     def __del__ (self):
         """(Internal) Destructor"""
         # print "Goodbye cruel world, I'm leaving you today."
         del self._run
         # print "Goodbye, goodbye, goodbye."
 

python.Runs._run

_run

Definition: __init__.py:302

python.Runs.__del__

def __del__

Definition: __init__.py:344

Member Function Documentation

def python.Runs._createFWLiteRun ( self )

private

Private Member Functions ##.

(Internal) Creates an FWLite Run

Definition at line 417 of file __init__.py.

References python.Lumis._filenames, python.Runs._filenames, MELaserPrim._run, and python.Runs._run.

Referenced by python.Runs._next().

 
     def _createFWLiteRun (self):
         """(Internal) Creates an FWLite Run"""
         # are there any files left?
         if not self._filenames:
             return False
         if self._run:
             del self._run
             self._run = None
         self._veryFirstTime = False
         self._currFilename = self._filenames.pop(0)
         #print "Opening file", self._currFilename
         if self._tfile:
             del self._tfile
         self._tfile = ROOT.TFile.Open (self._currFilename)
         self._run = ROOT.fwlite.Run (self._tfile);
         self._run.toBegin()
         return True
 

python.Runs._currFilename

_currFilename

Definition: __init__.py:426

python.Runs._run

_run

Definition: __init__.py:302

python.Runs._veryFirstTime

_veryFirstTime

Definition: __init__.py:425

python.Runs._tfile

_tfile

Definition: __init__.py:304

python.Runs._createFWLiteRun

def _createFWLiteRun

Private Member Functions ##.

Definition: __init__.py:417

python.Runs._filenames

_filenames

Definition: __init__.py:308

def python.Runs._next ( self )

private

(Internal) Iterator internals

Definition at line 436 of file __init__.py.

References python.Runs._createFWLiteRun(), python.Runs._maxRuns, and python.Runs._runCounts.

Referenced by python.Runs.__iter__(), and python.Events.__iter__().

 
     def _next (self):
         """(Internal) Iterator internals"""
         while True:
             if self._run.atEnd():
                 if not self._createFWLiteRun():
                     # there are no more files here, so we are done
                     break
             yield self
             self._runCounts += 1
             if self._maxRuns > 0 and self._runCounts >= self._maxRuns:
                 break
             self._run.__preinc__()
             

python.Runs._maxRuns

_maxRuns

Parse optional arguments ##.

Definition: __init__.py:305

python.Runs._next

def _next

Definition: __init__.py:436

python.Runs._createFWLiteRun

def _createFWLiteRun

Private Member Functions ##.

Definition: __init__.py:417

python.Runs._runCounts

_runCounts

Definition: __init__.py:303

def python.Runs.getByLabel	(	self,
		args
	)

Calls FWLite's getByLabel.  Called:
getByLabel (moduleLabel, handle)
getByLabel (moduleLabel, productInstanceLabel, handle),
getByLabel (moduleLabel, productInstanceLabel, processLabel, handle),
or
getByLabel ( (mL, pIL,pL), handle)

Definition at line 369 of file __init__.py.

References submitPVResolutionJobs.count, if(), join(), and submitPVValidationJobs.split().

 
     def getByLabel (self, *args):
         """Calls FWLite's getByLabel.  Called:
         getByLabel (moduleLabel, handle)
         getByLabel (moduleLabel, productInstanceLabel, handle),
         getByLabel (moduleLabel, productInstanceLabel, processLabel, handle),
         or
         getByLabel ( (mL, pIL,pL), handle)
         """
         length = len (args)
         if length < 2 or length > 4:
             # not called correctly
             raise RuntimeError("Incorrect number of arguments")
         # handle is always the last argument
         argsList = list (args)
         handle = argsList.pop()
         if len(argsList)==1 :
             if( isinstance (argsList[0], tuple) or
                 isinstance (argsList[0], list) ) :
                 if len (argsList[0]) > 3:
                     raise RuntimeError("getByLabel Error: label tuple has too " \
                         "many arguments '%s'" % argsList[0])
                 argsList = list(argsList[0])
             if( isinstance(argsList[0], str) and ":" in argsList[0] ):
                 if argsList[0].count(":") > 3:
                     raise RuntimeError("getByLabel Error: label tuple has too " \
                         "many arguments '%s'" % argsList[0].split(":"))
                 argsList = argsList[0].split(":")
         while len(argsList) < 3:
             argsList.append ('')
         (moduleLabel, productInstanceLabel, processLabel) = argsList
         labelString = "'" + "', '".join(argsList) + "'"
         if not handle._wrapper :
             handle._resetWrapper()
         handle._setStatus ( self._run.getByLabel( handle._typeInfoGetter(),
                                                    moduleLabel,
                                                    productInstanceLabel,
                                                    processLabel,
                                                    handle._addressOf() ),
                             labelString )
         return handle.isValid()
 
                     
        