RunLumiTime.RunLumiTime Class Reference

Collaboration diagram for RunLumiTime.RunLumiTime:

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

Public Attributes
str	onlLumiDB = 'COOLONL_TRIGGER/CONDBR2'
str	onlLBLBFolder = '/TRIGGER/LUMI/LBLB'
	dbHandler = None
	verbose = args.verbose
	outFile = args.outfile
	runList = args.runlist

Detailed Description

Definition at line 17 of file RunLumiTime.py.

Constructor & Destructor Documentation

__init__()

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

RunLumiTime.RunLumiTime.__del__

(

self

)

Definition at line 52 of file RunLumiTime.py.

    def __del__(self):
        self.closeDb()
 

Member Function Documentation

__enter__()

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

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

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

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

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 = None

Definition at line 28 of file RunLumiTime.py.

onlLBLBFolder

str RunLumiTime.RunLumiTime.onlLBLBFolder = '/TRIGGER/LUMI/LBLB'

Definition at line 25 of file RunLumiTime.py.

onlLumiDB

str RunLumiTime.RunLumiTime.onlLumiDB = 'COOLONL_TRIGGER/CONDBR2'

Definition at line 22 of file RunLumiTime.py.

outFile

RunLumiTime.RunLumiTime.outFile = args.outfile

Definition at line 37 of file RunLumiTime.py.

runList

RunLumiTime.RunLumiTime.runList = args.runlist

Definition at line 40 of file RunLumiTime.py.

verbose

RunLumiTime.RunLumiTime.verbose = args.verbose

Definition at line 34 of file RunLumiTime.py.

---

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

• RunLumiTime.py