python.TileBchTools.TileBchMgr Class Reference

Inheritance diagram for python.TileBchTools.TileBchMgr:

Collaboration diagram for python.TileBchTools.TileBchMgr:

Public Member Functions
def	__init__ (self)
def	getComment (self)
def	updateFromDb (self, db, folderPath, tag, runLumi, fillTable=1, mode=None, ros=-1, module=-1)
def	initialize (self, db, folderPath, tag="", runLumi=(MAXRUN, MAXLBK-1), mode=None, ros=-1, module=-1)
def	getAdcStatus (self, ros, drawer, channel, adc)
def	setAdcStatus (self, ros, drawer, channel, adc, status)
def	getAdcProblems (self, ros, drawer, channel, adc)
def	setAdcProblems (self, ros, drawer, channel, adc, problems)
def	addAdcProblem (self, ros, drawer, channel, adc, problem)
def	delAdcProblem (self, ros, drawer, channel, adc, problem)
def	decodeModule (self, module)
def	getADCStatus (self, module, channel, adc)
def	setADCStatus (self, module, channel, adc, status)
def	getADCProblems (self, module, channel, adc)
def	setADCProblems (self, module, channel, adc, problems)
def	addADCProblem (self, module, channel, adc, problem)
def	delADCProblem (self, module, channel, adc, problem)
def	listBadAdcs (self, rosBeg=0, modBeg=0, rosEnd=5, modEnd=64)
def	checkModuleForChanges (self, ros, drawer)
def	updateFromFile (self, fileName)
def	commitToDb (self, db, folderPath, tag, bitPatVer, author, comment, since, until=(MAXRUN, MAXLBK), untilCmt=None, moduleList=[])
def	getBadDefinition (self)
def	getBadTimingDefinition (self)

Private Member Functions
def	__getAdcIdx (self, ros, drawer, channel, adc)
def	__updateFromDb (self, db, folderPath, tag, runLumi, fillTable=1, ros=-1, module=-1)

Private Attributes
	__newStat
	__oldStat
	__comment
	__mode
	__runLumi
	__multiVersion

Detailed Description

This class manages updates to the Tile Calorimeter bad channel database.
The usual mode of operation should start with initializing this manager
with a current set of bad channels from an existing database.
The status of individual ADCs can then be modified using the setAdcStatus,
updateFromFile or updateFromDb methods.
In a final step, the changes are commited to the database using the commit
method.

Definition at line 25 of file TileBchTools.py.

Constructor & Destructor Documentation

__init__()

def python.TileBchTools.TileBchMgr.__init__

(

self

)

Definition at line 36 of file TileBchTools.py.

    def __init__(self):
 
        #=== initialize base class
        TileCalibLogger.__init__(self,"TileBchMgr")
 
        #=== initialize all channel status to "good"
        self.__newStat = [ TileBchStatus() for _ in range(self.__getAdcIdx(4, 63, 47, 1) + 1) ]
        self.__oldStat = [ TileBchStatus() for _ in range(self.__getAdcIdx(4, 63, 47, 1) + 1) ]
 
        self.__comment = ""
        self.__mode = 1
        self.__runLumi = (MAXRUN,MAXLBK-1)
        self.__multiVersion = True
 

Member Function Documentation

__getAdcIdx()

def python.TileBchTools.TileBchMgr.__getAdcIdx (   self,   ros,   drawer,   channel,   adc  )

private

Private function, calculating the index of a given ADC
for the internal cache.

Definition at line 51 of file TileBchTools.py.

    def __getAdcIdx(self, ros, drawer, channel, adc):
        """
        Private function, calculating the index of a given ADC
        for the internal cache.
        """
        return TileCalibUtils.getAdcIdx(ros,drawer,channel,adc)
 

__updateFromDb()

def python.TileBchTools.TileBchMgr.__updateFromDb (   self,   db,   folderPath,   tag,   runLumi,   fillTable = 1,   ros = -1,   module = -1  )

private

Updates the internal bad channel cache with the content
found in the database. An open database instance (db) has to
be provided. Tag and runNum are used to locate the set of
bad channels to be read from the database.

Definition at line 59 of file TileBchTools.py.

    def __updateFromDb(self, db, folderPath, tag, runLumi, fillTable=1, ros=-1, module=-1):
        """
        Updates the internal bad channel cache with the content
        found in the database. An open database instance (db) has to
        be provided. Tag and runNum are used to locate the set of
        bad channels to be read from the database.
        """
 
        #=== try to open the db
        try:
            if not db.isOpen():
                raise Exception ("DB not open: ", db.databaseId())
        except Exception as e:
            self.log().critical( e )
            return
 
        #=== print status information
        reader = TileCalibTools.TileBlobReader(db,folderPath,tag)
        if ros==-2:
            ros=0
            module=TileCalibUtils.definitions_draweridx()
            self.log().info("Updating dictionary from \'%s\'", db.databaseName())
            self.log().info("... using tag \'%s\', run-lumi=%s", tag,runLumi)
            self.__multiVersion = reader.folderIsMultiVersion()
            self.__comment = reader.getComment(runLumi)
            self.log().info("... comment: %s", self.__comment)
 
        #=== loop over the whole detector
        rosmin = ros if ros>=0 else 0
        rosmax = ros+1 if ros>=0 else TileCalibUtils.max_ros()
        for ros in range(rosmin,rosmax):
            modmin = module if module>=0 else 0
            modmax = module+1 if module>=0 else TileCalibUtils.getMaxDrawer(ros)
            for mod in range(modmin,modmax):
                bch = reader.getDrawer(ros, mod, runLumi, False)
                if bch is None:
                    if fillTable>=0:
                        self.log().warning("Missing IOV in condDB: ros=%i mod=%i runLumi=%s", ros,mod,runLumi)
                    continue
                bchDecoder = TileBchDecoder(bch.getBitPatternVersion())
                for chn in range(TileCalibUtils.max_chan()):
                    for adc in range(TileCalibUtils.max_gain()):
                        #=== adc bits
                        adcBits = bch.getData(chn,adc,0)
                        #=== channel bits (works always due to default policy)
                        chnBits = bch.getData(chn,  2,0)
                        #=== build status from both adc and channel bits
                        status = TileBchStatus( bchDecoder.decode(chnBits,adcBits) )
                        if fillTable==0:
                            self.__oldStat[self.__getAdcIdx(ros,mod,chn,adc)] = status
                        elif fillTable==1 or fillTable==-1:
                            self.__newStat[self.__getAdcIdx(ros,mod,chn,adc)] = status
                        elif fillTable==2 or fillTable==-2:
                            self.__oldStat[self.__getAdcIdx(ros,mod,chn,adc)] = status
                            self.__newStat[self.__getAdcIdx(ros,mod,chn,adc)] = status
                        else:
                            self.__newStat[self.__getAdcIdx(ros,mod,chn,adc)] = status
                            status1 = TileBchStatus( bchDecoder.decode(chnBits,adcBits) )
                            self.__oldStat[self.__getAdcIdx(ros,mod,chn,adc)] = status1
 

addADCProblem()

def python.TileBchTools.TileBchMgr.addADCProblem	(		self,
			module,
			channel,
			adc,
			problem
	)

Sets a specific problem

Definition at line 290 of file TileBchTools.py.

    def addADCProblem(self, module, channel, adc, problem):
        """
        Sets a specific problem
        """
        (ros,drawer) = self.decodeModule(module)
        status = self.getAdcStatus(ros,drawer,channel,adc)
        status += problem
        self.setAdcStatus(ros,drawer,channel,adc,status)
 

addAdcProblem()

def python.TileBchTools.TileBchMgr.addAdcProblem	(		self,
			ros,
			drawer,
			channel,
			adc,
			problem
	)

Sets a specific problem

Definition at line 213 of file TileBchTools.py.

    def addAdcProblem(self, ros, drawer, channel, adc, problem):
        """
        Sets a specific problem
        """
        status = self.getAdcStatus(ros,drawer,channel,adc)
        status += problem
        self.setAdcStatus(ros,drawer,channel,adc,status)
 

checkModuleForChanges()

def python.TileBchTools.TileBchMgr.checkModuleForChanges	(		self,
			ros,
			drawer
	)

Returns:
- if nothing changed                                    :  0
- if something changed and complete drawer is now good  : -1
- if something changed but drawer is not completely good: >0

Definition at line 337 of file TileBchTools.py.

    def checkModuleForChanges(self, ros, drawer):
        """
        Returns:
        - if nothing changed                                    :  0
        - if something changed and complete drawer is now good  : -1
        - if something changed but drawer is not completely good: >0
        """
        diffCnt = 0
        allGood = True
        for chn in range(TileCalibUtils.max_chan()):
            for adc in range(TileCalibUtils.max_gain()):
                idx = self.__getAdcIdx(ros,drawer,chn,adc)
                newStatus = self.__newStat[idx]
                #=== count differences between old and new
                if newStatus!=self.__oldStat[idx]:
                    diffCnt+=1
                #=== invalidate allGood if one ADC is not good
                if not newStatus.isGood():
                    allGood = False
        if diffCnt>0 and allGood:
            return -1
        return diffCnt
 

commitToDb()

def python.TileBchTools.TileBchMgr.commitToDb	(		self,
			db,
			folderPath,
			tag,
			bitPatVer,
			author,
			comment,
			since,
			until = (MAXRUN,MAXLBK),
			untilCmt = None,
			moduleList = []
	)

Commits the differences compared to the set of bad channels read in with the
initialze function to the provided database.
- author  : author name (string)
- comment : a comment (string)
- sinceRun, sinceLbk : start of IOV for which bad channels are valid
- untilRun, untilLbk : end   of IOV for which bad channels are valid

Definition at line 396 of file TileBchTools.py.

    def commitToDb(self, db, folderPath, tag, bitPatVer, author, comment,
                   since, until=(MAXRUN,MAXLBK), untilCmt=None, moduleList=[]):
        """
        Commits the differences compared to the set of bad channels read in with the
        initialze function to the provided database.
        - author  : author name (string)
        - comment : a comment (string)
        - sinceRun, sinceLbk : start of IOV for which bad channels are valid
        - untilRun, untilLbk : end   of IOV for which bad channels are valid
        """
        #=== check db status
        try:
            if not db.isOpen():
                raise Exception ("DB not open: ", db.databaseId())
        except Exception as e:
            raise( e )
 
        multiVersion = self.__multiVersion
        writer = TileCalibTools.TileBlobWriter(db,folderPath,'Bch',multiVersion)
        if len(comment) or isinstance(author,tuple):
            writer.setComment(author, comment)
        nUpdates = 0
        goodComment = True
        #=== get latest state from db
        if moduleList!=['CMT']:
            if since != (MINRUN,MINLBK):
                justBefore = list(since)
                if justBefore[1]>MINLBK:
                    justBefore[1] = justBefore[1]-1
                else:
                    justBefore[0] = justBefore[0]-1
                    justBefore[1] = MAXLBK
                justBefore = tuple(justBefore)
                if self.__mode!=2:
                    self.log().info("Reading db state just before %s, i.e. at %s", since,justBefore)
                    self.__updateFromDb(db, folderPath, tag, justBefore, 0)
                else:
                    self.log().info("Using previous bad channel list from input DB")
                self.log().info("And comparing it with new list of bad channels")
            else:
                if self.__mode!=2:
                    reader = TileCalibTools.TileBlobReader(db,folderPath,tag)
                    multiVersion = reader.folderIsMultiVersion()
                self.log().info("Filling db from %s, resetting old status cache", list(since))
                self.__oldStat = len(self.__oldStat) * [TileBchStatus()]
 
            #=== print status information
            self.log().info("Committing changes to DB \'%s\'", db.databaseId())
            self.log().info("... using tag \'%s\' and [run,lumi] range: [%i,%i] - [%i,%i]",
                     tag,since[0],since[1],until[0],until[1])
            if isinstance(author,tuple) and len(author)==3:
                self.log().info("... author : \'%s\'", author[0] )
                self.log().info("... comment: \'%s\'", author[1] )
            else:
                self.log().info("... author : \'%s\'", author  )
                self.log().info("... comment: \'%s\'", comment )
 
            #=== default for drawer initialization
            loGainDefVec = cppyy.gbl.std.vector('unsigned int')()
            loGainDefVec.push_back(0)
            hiGainDefVec = cppyy.gbl.std.vector('unsigned int')()
            hiGainDefVec.push_back(0)
            comChnDefVec = cppyy.gbl.std.vector('unsigned int')()
            comChnDefVec.push_back(0)
            defVec = cppyy.gbl.std.vector('std::vector<unsigned int>')()
            defVec.push_back(loGainDefVec)
            defVec.push_back(hiGainDefVec)
            defVec.push_back(comChnDefVec)
 
            #=== loop over the whole detector
            bchDecoder = TileBchDecoder(bitPatVer)
            for ros in range(0,TileCalibUtils.max_ros()):
                for mod in range(TileCalibUtils.getMaxDrawer(ros)):
                    modName = TileCalibUtils.getDrawerString(ros,mod)
                    nChange = self.checkModuleForChanges(ros,mod)
                    if nChange == 0 and (len(moduleList)==0 or modName not in moduleList or 'ALL' not in moduleList):
                        #=== do nothing if nothing changed
                        continue
                    if nChange==-1:
                        nUpdates += 1
                        self.log().info("Drawer %s reset to GOOD", modName)
                        if modName not in comment and ("ONL" not in folderPath or "syncALL" not in comment):
                            goodComment = False
                            self.log().error("Comment string - '%s' - doesn't contain drawer %s", comment,modName)
                        writer.zeroBlob(ros,mod)
                    else:
                        nUpdates += 1
                        self.log().info("Applying %2i changes to drawer %s", nChange,modName)
                        if modName not in comment and ("ONL" not in folderPath or "syncALL" not in comment):
                            goodComment = False
                            self.log().error("Comment string - '%s' - doesn't contain drawer %s", comment,modName)
                        drawer = writer.getDrawer(ros,mod)
                        drawer.init(defVec,TileCalibUtils.max_chan(),bitPatVer)
                        for chn in range(TileCalibUtils.max_chan()):
                            #=== get low gain bit words
                            wordsLo = bchDecoder.encode(self.getAdcStatus(ros,mod,chn,0))
                            chBits = wordsLo[0]
                            loBits = wordsLo[1]
                            #=== get high gain bit words
                            wordsHi = bchDecoder.encode(self.getAdcStatus(ros,mod,chn,1))
                            chBits = wordsHi[0] | chBits
                            hiBits = wordsHi[1]
                            #=== set low, high and common channel word in calibDrawer
                            drawer.setData(chn,0,0, loBits)
                            drawer.setData(chn,1,0, hiBits)
                            drawer.setData(chn,2,0, chBits)
                            #=== synchronizing channel status in low and high gain
                            if wordsLo[0] != chBits:
                                self.log().info("Drawer %s ch %2d - sync LG status with HG ", modName,chn)
                                status = TileBchStatus( bchDecoder.decode(chBits,loBits) )
                                self.setAdcStatus(ros,mod,chn,0,status)
                            if wordsHi[0] != chBits:
                                self.log().info("Drawer %s ch %2d - sync HG status with LG ", modName,chn)
                                status = TileBchStatus( bchDecoder.decode(chBits,hiBits) )
                                self.setAdcStatus(ros,mod,chn,1,status)
 
        #=== register
        if nUpdates>0 or moduleList==['CMT']:
            if goodComment:
                self.log().info("Attempting to register %i modified drawers..." , nUpdates)
                if untilCmt is not None and untilCmt!=until:
                    if moduleList!=['CMT'] and until>since:
                        writer.register(since,until,tag,1)
                    if untilCmt>since:
                        writer.register(since,untilCmt,tag,-1)
                else:
                    writer.register(since,until,tag)
            else:
                self.log().error("Aborting update due to errors in comment string")
        else:
            self.log().warning("No drawer modifications detected, ignoring commit request")
 
 

decodeModule()

def python.TileBchTools.TileBchMgr.decodeModule	(		self,
			module
	)

convert module name to ros,drawer

Definition at line 231 of file TileBchTools.py.

    def decodeModule(self, module):
        """
        convert module name to ros,drawer
        """
        try:
            part_dict = {'LBA':1,'LBC':2,'EBA':3,'EBC':4}
            partname = str(module[0:3])
            ros = part_dict[partname]
            drawer = int(module[3:])-1
        except Exception:
            drawer = -1
        if drawer<0 or drawer>63:
            self.log().critical( "Invalid module name %s" % module )
            raise SystemExit
 
        return (ros,drawer)
 

delADCProblem()

def python.TileBchTools.TileBchMgr.delADCProblem	(		self,
			module,
			channel,
			adc,
			problem
	)

Removes a specific problem

Definition at line 300 of file TileBchTools.py.

    def delADCProblem(self, module, channel, adc, problem):
        """
        Removes a specific problem
        """
        (ros,drawer) = self.decodeModule(module)
        status = self.getAdcStatus(ros,drawer,channel,adc)
        status -= problem
        self.setAdcStatus(ros,drawer,channel,adc,status)
 

delAdcProblem()

def python.TileBchTools.TileBchMgr.delAdcProblem	(		self,
			ros,
			drawer,
			channel,
			adc,
			problem
	)

Removes a specific problem

Definition at line 222 of file TileBchTools.py.

    def delAdcProblem(self, ros, drawer, channel, adc, problem):
        """
        Removes a specific problem
        """
        status = self.getAdcStatus(ros,drawer,channel,adc)
        status -= problem
        self.setAdcStatus(ros,drawer,channel,adc,status)
 

getADCProblems()

def python.TileBchTools.TileBchMgr.getADCProblems	(		self,
			module,
			channel,
			adc
	)

Returns a dictionary with { problemEnum : 'Description'}

Definition at line 265 of file TileBchTools.py.

    def getADCProblems(self, module, channel, adc):
        """
        Returns a dictionary with { problemEnum : 'Description'}
        """
        (ros,drawer) = self.decodeModule(module)
        prbDescDict = {}
        status = self.getAdcStatus(ros,drawer,channel,adc)
        if not status.isGood():
            prbs = status.getPrbs()
            for prb in prbs:
                prbDescDict[prb] = TileBchPrbs.getDescription(prb)
        return prbDescDict
 

getAdcProblems()

def python.TileBchTools.TileBchMgr.getAdcProblems	(		self,
			ros,
			drawer,
			channel,
			adc
	)

Returns a dictionary with { problemEnum : 'Description'}

Definition at line 190 of file TileBchTools.py.

    def getAdcProblems(self, ros, drawer, channel, adc):
        """
        Returns a dictionary with { problemEnum : 'Description'}
        """
        prbDescDict = {}
        status = self.getAdcStatus(ros,drawer,channel,adc)
        if not status.isGood():
            prbs = status.getPrbs()
            for prb in prbs:
                prbDescDict[prb] = TileBchPrbs.getDescription(prb)
        return prbDescDict
 

getADCStatus()

def python.TileBchTools.TileBchMgr.getADCStatus	(		self,
			module,
			channel,
			adc
	)

Get TileBchStatus for a given ADC.

Definition at line 249 of file TileBchTools.py.

    def getADCStatus(self, module, channel, adc):
        """
        Get TileBchStatus for a given ADC.
        """
        (ros,drawer) = self.decodeModule(module)
        return self.__newStat[self.__getAdcIdx(ros,drawer,channel,adc)]
 

getAdcStatus()

def python.TileBchTools.TileBchMgr.getAdcStatus	(		self,
			ros,
			drawer,
			channel,
			adc
	)

Get TileBchStatus for a given ADC.

Definition at line 176 of file TileBchTools.py.

    def getAdcStatus(self, ros, drawer, channel, adc):
        """
        Get TileBchStatus for a given ADC.
        """
        return self.__newStat[self.__getAdcIdx(ros,drawer,channel,adc)]
 

getBadDefinition()

def python.TileBchTools.TileBchMgr.getBadDefinition

(

self

)

Returns bad status definition

Definition at line 530 of file TileBchTools.py.

    def getBadDefinition(self):
        """
        Returns bad status definition
        """
        return self.getAdcStatus(0, TileCalibUtils.definitions_draweridx(), TileCalibUtils.bad_definition_chan(), 0)
 

getBadTimingDefinition()

def python.TileBchTools.TileBchMgr.getBadTimingDefinition

(

self

)

Returns bad time status definition

Definition at line 536 of file TileBchTools.py.

    def getBadTimingDefinition(self):
        """
        Returns bad time status definition
        """
        return self.getAdcStatus(0, TileCalibUtils.definitions_draweridx(), TileCalibUtils.badtiming_definition_chan(), 0)

getComment()

def python.TileBchTools.TileBchMgr.getComment

(

self

)

Definition at line 120 of file TileBchTools.py.

    def getComment(self):
        return self.__comment
 

initialize()

def python.TileBchTools.TileBchMgr.initialize	(		self,
			db,
			folderPath,
			tag = "",
			runLumi = (MAXRUN,MAXLBK-1),
			mode = None,
			ros = -1,
			module = -1
	)

Initializes the internal bad channel cache. Any changes applied to the
cache previous to calling this function are lost. Typically this function
is called once in the beginning to initialize the cache with a set of
current bad channels.

Definition at line 130 of file TileBchTools.py.

    def initialize(self, db, folderPath, tag="", runLumi=(MAXRUN,MAXLBK-1), mode=None, ros=-1, module=-1):
        """
        Initializes the internal bad channel cache. Any changes applied to the
        cache previous to calling this function are lost. Typically this function
        is called once in the beginning to initialize the cache with a set of
        current bad channels.
        """
        self.log().info("Initializing from database, resetting all changes!")
        #=== initialize reference to current status
        self.__runLumi = runLumi
        if mode:
            self.__mode = mode
        fT = -1
        if self.__mode<0: # silent mode
            self.__mode = -self.__mode
            if self.__mode==2:
                fT = -3
            else:
                fT = -2
        else:
            if self.__mode==2:
                fT = 3
            else:
                fT = 2
 
        if ros!=-2:
            self.__updateFromDb(db,folderPath,tag,runLumi,fT,-2)
        self.__updateFromDb(db,folderPath,tag,runLumi,fT,ros,module)
        #=== update TileBchStatus::isBad() definition from DB
        self.log().info("Updating TileBchStatus::isBad() definition from DB")
        status = self.getBadDefinition()
        if status.isGood():
            self.log().info("No TileBchStatus::isBad() definition found in DB, using defaults")
        else:
            TileBchStatus.defineBad(status)
 
        #=== update TileBchStatus::isBadTiming() definition from DB
        self.log().info("Updating TileBchStatus::isBadTiming() definition from DB")
        status = self.getBadTimingDefinition()
        if status.isGood():
            self.log().info("No TileBchStatus::isBadTiming() definition found in DB, using defaults")
        else:
            TileBchStatus.defineBadTiming(status)
 
 

listBadAdcs()

def python.TileBchTools.TileBchMgr.listBadAdcs	(		self,
			rosBeg = 0,
			modBeg = 0,
			rosEnd = 5,
			modEnd = 64
	)

Print a formatted list of all ADCs with problems.

Definition at line 310 of file TileBchTools.py.

    def listBadAdcs(self, rosBeg=0, modBeg=0, rosEnd=5, modEnd=64):
        """
        Print a formatted list of all ADCs with problems.
        """
        self.log().info("==============================================================")
        self.log().info("                 Current list of affected ADCs               " )
        self.log().info("==============================================================")
        for ros in range(rosBeg,rosEnd):
            for mod in range(modBeg, min(modEnd,TileCalibUtils.getMaxDrawer(ros))):
                modName = TileCalibUtils.getDrawerString(ros,mod)
                for chn in range(TileCalibUtils.max_chan()):
                    chnName = "channel %2i" % chn
                    for adc in range(TileCalibUtils.max_gain()):
                        gainName = "LG:"
                        if adc:
                            gainName = "HG:"
                        prbs = self.getAdcProblems(ros,mod,chn,adc)
                        for prbCode in sorted(prbs.keys()):
                            prbDesc = prbs[prbCode]
                            msg = "%s %s %s %2i (%s)" % (modName,chnName,gainName,prbCode,prbDesc)
                            self.log().info( msg )
                            modName  = " " *  5
                            chnName  = " " * 10
                            gainName = " " *  3
        self.log().info("==============================================================")
 

setADCProblems()

def python.TileBchTools.TileBchMgr.setADCProblems	(		self,
			module,
			channel,
			adc,
			problems
	)

Expects a list of TileBchPrbs::PrbS as input

Definition at line 279 of file TileBchTools.py.

    def setADCProblems(self, module, channel, adc, problems):
        """
        Expects a list of TileBchPrbs::PrbS as input
        """
        (ros,drawer) = self.decodeModule(module)
        status = TileBchStatus()
        for prb in problems:
            status += prb
        self.setAdcStatus(ros,drawer,channel,adc,status)
 

setAdcProblems()

def python.TileBchTools.TileBchMgr.setAdcProblems	(		self,
			ros,
			drawer,
			channel,
			adc,
			problems
	)

Expects a list of TileBchPrbs::PrbS as input

Definition at line 203 of file TileBchTools.py.

    def setAdcProblems(self, ros, drawer, channel, adc, problems):
        """
        Expects a list of TileBchPrbs::PrbS as input
        """
        status = TileBchStatus()
        for prb in problems:
            status += prb
        self.setAdcStatus(ros,drawer,channel,adc,status)
 

setADCStatus()

def python.TileBchTools.TileBchMgr.setADCStatus	(		self,
			module,
			channel,
			adc,
			status
	)

Set TileBchStatus for a given ADC.

Definition at line 257 of file TileBchTools.py.

    def setADCStatus(self, module, channel, adc, status):
        """
        Set TileBchStatus for a given ADC.
        """
        (ros,drawer) = self.decodeModule(module)
        self.__newStat[self.__getAdcIdx(ros,drawer,channel,adc)] = status
 

setAdcStatus()

def python.TileBchTools.TileBchMgr.setAdcStatus	(		self,
			ros,
			drawer,
			channel,
			adc,
			status
	)

Set TileBchStatus for a given ADC.

Definition at line 183 of file TileBchTools.py.

    def setAdcStatus(self, ros, drawer, channel, adc, status):
        """
        Set TileBchStatus for a given ADC.
        """
        self.__newStat[self.__getAdcIdx(ros,drawer,channel,adc)] = status
 

updateFromDb()

def python.TileBchTools.TileBchMgr.updateFromDb	(		self,
			db,
			folderPath,
			tag,
			runLumi,
			fillTable = 1,
			mode = None,
			ros = -1,
			module = -1
	)

Definition at line 124 of file TileBchTools.py.

    def updateFromDb(self, db, folderPath, tag, runLumi, fillTable=1, mode=None, ros=-1, module=-1):
        if mode:
            self.__mode = mode
        self.__updateFromDb(db, folderPath, tag, runLumi, fillTable, ros, module)
 

updateFromFile()

def python.TileBchTools.TileBchMgr.updateFromFile	(		self,
			fileName
	)

Updates the internal bad channel cache with the content
found in the file. The layout of the file has to follow the
TileConditions ASCII file layout.

NGO: change this at some point. In a file, not the status word (which
depends on the bit pattern version) should be encoded, but the individual problems (enums).
For this we need one line per ADC... this requires some modification in the reader.

Definition at line 361 of file TileBchTools.py.

    def updateFromFile(self, fileName):
        """
        Updates the internal bad channel cache with the content
        found in the file. The layout of the file has to follow the
        TileConditions ASCII file layout.
 
        NGO: change this at some point. In a file, not the status word (which
        depends on the bit pattern version) should be encoded, but the individual problems (enums).
        For this we need one line per ADC... this requires some modification in the reader.
        """
        parser = TileCalibTools.TileASCIIParser(fileName,'Bch')
        dict = parser.getDict()
        self.log().info("Updating dictionary from file with %i entries", len(dict))
        self.log().info("... filename: %s", fileName )
        for key, stat in list(dict.items()):
            ros = key[0]
            mod = key[1]
            chn = key[2]
            for adc in range(2):
                status = TileBchStatus()
                status+=self.getAdcStatus(ros,mod,chn,adc)
                if adc < len(stat):
                    statInt = int(stat[adc])
                else:
                    statInt=0
                #=== temporary convention
                if statInt==0:
                    pass
                elif statInt==1:
                    status += TileBchPrbs.IgnoredInHlt
                else:
                    status += int(stat[adc])
                self.setAdcStatus(ros,mod,chn,adc,status)
 

Member Data Documentation

__comment

python.TileBchTools.TileBchMgr.__comment

private

Definition at line 45 of file TileBchTools.py.

__mode

python.TileBchTools.TileBchMgr.__mode

private

Definition at line 46 of file TileBchTools.py.

__multiVersion

python.TileBchTools.TileBchMgr.__multiVersion

private

Definition at line 48 of file TileBchTools.py.

__newStat

python.TileBchTools.TileBchMgr.__newStat

private

Definition at line 42 of file TileBchTools.py.

__oldStat

python.TileBchTools.TileBchMgr.__oldStat

private

Definition at line 43 of file TileBchTools.py.

__runLumi

python.TileBchTools.TileBchMgr.__runLumi

private

Definition at line 47 of file TileBchTools.py.

---

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

• TileBchTools.py