python.Runs Class Reference

## Runs

More...

Public Member Functions
def	__del__ (self)
def	__init__ (self, inputFiles='', kwargs)
def	__iter__ (self)
def	aux (self)
def	getByLabel (self, args)
def	runAuxiliary (self)

Private Member Functions
def	_createFWLiteRun (self)
	Private Member Functions ##. More...
def	_next (self)

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")

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."

Member Function Documentation

def python.Runs.__iter__

(

self

)

Definition at line 351 of file __init__.py.

References python.Lumis._next(), and python.Runs._next().

    def __iter__ (self):
        return self._next()

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

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__()
            

def python.Runs.aux

(

self

)

Definition at line 355 of file __init__.py.

    def aux (self):
        try:
            return self._run.runAuxiliary()
        except:
            raise RuntimeError("Runs.aux() called on object in invalid state")

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 KineDebug3.count(), join(), list(), and 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()

                    
       

def python.Runs.runAuxiliary

(

self

)

Definition at line 362 of file __init__.py.

    def runAuxiliary (self):
        try:
            return self._run.runAuxiliary()
        except:
            raise RuntimeError("Runs.runAuxiliary() called on object in invalid state")
        

Member Data Documentation

python.Runs._currFilename

private

Definition at line 426 of file __init__.py.

python.Runs._filenames

private

Definition at line 308 of file __init__.py.

Referenced by cfg-viewer.unscheduled._calcFilenames(), python.Events._createFWLiteEvent(), and python.Runs._createFWLiteRun().

python.Runs._maxRuns

private

Parse optional arguments ##.

Definition at line 305 of file __init__.py.

Referenced by python.Runs._next().

python.Runs._run

private

Definition at line 302 of file __init__.py.

Referenced by python.Runs.__del__(), and python.Runs._createFWLiteRun().

python.Runs._runCounts

private

Definition at line 303 of file __init__.py.

Referenced by python.Runs._next().

python.Runs._secondaryFilenames

private

Definition at line 327 of file __init__.py.

python.Runs._tfile

private

Definition at line 304 of file __init__.py.

python.Runs._veryFirstTime

private

Definition at line 425 of file __init__.py.

Referenced by python.Events._createFWLiteEvent(), python.Events._next(), python.Events.eventAuxiliary(), python.Events.getByLabel(), python.Events.size(), and python.Events.to().