RunLumiTime.RunLumiTime Class Reference

Collaboration diagram for RunLumiTime.RunLumiTime:

Public Member Functions
def	__init__ (self)
def	__enter__ (self)
def	__exit__ (self, exc_type, exc_value, exc_traceback)
def	__del__ (self)
def	closeDb (self)
def	parseArgs (self)
def	execute (self)

Public Attributes
	onlLumiDB
	onlLBLBFolder
	dbHandler
	verbose
	outFile
	runList

Detailed Description

Definition at line 17 of file RunLumiTime.py.

Constructor & Destructor Documentation

__init__()

def RunLumiTime.RunLumiTime.__init__

(

self

)

Definition at line 19 of file RunLumiTime.py.

    def __init__(self):
 
        # online luminosity database
        self.onlLumiDB = 'COOLONL_TRIGGER/CONDBR2'
 
        # folder with LB -> time conversion
        self.onlLBLBFolder = '/TRIGGER/LUMI/LBLB'
 
        # the LumiDBHandler
        self.dbHandler = None
 
        # parse command-line input
        args = self.parseArgs()
 
        # output level
        self.verbose = args.verbose
 
        # output file (default stdout)
        self.outFile = args.outfile
 
        # List of (integer) run numbers specified on the command line
        self.runList = args.runlist
 
        print(f"Finished parsing run list: {', '.join([str(run) for run in self.runList])}")
 

__del__()

def RunLumiTime.RunLumiTime.__del__

(

self

)

Definition at line 52 of file RunLumiTime.py.

    def __del__(self):
        self.closeDb()
 

Member Function Documentation

__enter__()

def RunLumiTime.RunLumiTime.__enter__

(

self

)

Definition at line 44 of file RunLumiTime.py.

    def __enter__(self):
        # Instantiate the LumiDBHandler, so we can cleanup all COOL connections at exit
        self.dbHandler = LumiDBHandler()
        return self
 

__exit__()

def RunLumiTime.RunLumiTime.__exit__	(		self,
			exc_type,
			exc_value,
			exc_traceback
	)

Definition at line 49 of file RunLumiTime.py.

    def __exit__(self, exc_type, exc_value, exc_traceback):
        self.closeDb()
 

closeDb()

def RunLumiTime.RunLumiTime.closeDb

(

self

)

Definition at line 55 of file RunLumiTime.py.

    def closeDb(self):
        if self.dbHandler is not None:
            self.dbHandler.closeAllDB()
 

execute()

def RunLumiTime.RunLumiTime.execute

(

self

)

Definition at line 76 of file RunLumiTime.py.

    def execute(self):
        # Instantiate the LumiDBHandler, so we can cleanup all COOL connections in the destructor
        if self.dbHandler is None:
            self.dbHandler = LumiDBHandler()
 
        # Open outfile if desired
        fp = None
        format = "stdout"
        if self.outFile is not None:
            fp = open(self.outFile, 'w')
            format = "txt"
            if self.outFile.endswith(".json"):
                format = "json"
                output = {}
            if self.outFile.endswith(".csv"):
                format = "csv"
 
 
        # Get our COOL folder
        lblb = CoolDataReader(self.onlLumiDB, self.onlLBLBFolder)
        
        # Load data for each run specified
        for run in self.runList:
 
            lblb.setIOVRangeFromRun(run)
            if not lblb.readData():
                print(f'RunLumiTime - No LBLB data found for run {run}!')
                continue
 
            for obj in lblb.data:
                # IOV is equal to (Run << 32) + LB number.
                run = obj.since() >> 32
                lb = obj.since() & 0xFFFFFFFF
                # Time is UTC nanoseconds
                startTime = obj.payload()['StartTime']
                endTime = obj.payload()['EndTime']
                if format == "json":
                    if not run in output:
                        output[run] = []
                    output[run] += [{
                        "lb":lb,
                        "begin": startTime/1.e9,
                        "end": endTime/1.e9
                    }]
                else:
                    entry = (run, lb, startTime/1.e9, endTime/1.e9)
                    separator = ',' if format=='csv' else ' '
                    print(separator.join([str(v) for v in entry]), file=fp)
 
        if format=="json":
            import json
            json.dump(output, fp, indent=4)
        
        # close the file
        if fp is not None:
            fp.close()
            print(f"Wrote file {self.outFile}")
 
# Executed from the command line

parseArgs()

def RunLumiTime.RunLumiTime.parseArgs

(

self

)

Definition at line 59 of file RunLumiTime.py.

    def parseArgs(self):
        parser = ArgumentParser()
 
        parser.add_argument("-v", "--verbose",
                            action="store_true", dest="verbose",
                            help="turn on verbose output")
 
        parser.add_argument("-r", "--run", nargs='*', required=True, type=int,
                            dest="runlist", metavar="RUN",
                            help="show specific run(s)")
 
        parser.add_argument('-o', '--output',
                            dest='outfile', metavar = "FILE", default=None, type=str,
                            help="write results to output file (default stdout). If filename ends in csv or json those formats are used.")
        
        return parser.parse_args()
 

Member Data Documentation

dbHandler

RunLumiTime.RunLumiTime.dbHandler

Definition at line 28 of file RunLumiTime.py.

onlLBLBFolder

RunLumiTime.RunLumiTime.onlLBLBFolder

Definition at line 25 of file RunLumiTime.py.

onlLumiDB

RunLumiTime.RunLumiTime.onlLumiDB

Definition at line 22 of file RunLumiTime.py.

outFile

RunLumiTime.RunLumiTime.outFile

Definition at line 37 of file RunLumiTime.py.

runList

RunLumiTime.RunLumiTime.runList

Definition at line 40 of file RunLumiTime.py.

verbose

RunLumiTime.RunLumiTime.verbose

Definition at line 34 of file RunLumiTime.py.

---

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

• RunLumiTime.py