Connectors.py

Go to the documentation of this file.

# Copyright (C) 2002-2024 CERN for the benefit of the ATLAS collaboration
 
from enum import Enum
 
from AthenaCommon.Logging import logging
 
from .TopoAlgorithms import AlgCategory
 
log = logging.getLogger(__name__)
 
class CType(Enum):
    CTPIN = (1, 'ctpin')
    ELEC = (2, 'electrical')
    OPT = (3, 'optical')
    def __init__(self, _, ctype ):
        self.ctype = ctype
 
    def __str__(self):
        return self.ctype
 
    @staticmethod
    def from_str(label):
        if label == 'ctpin':
            return CType.CTPIN
        elif label == 'electrical':
            return CType.ELEC
        elif label == 'optical':
            return CType.OPT
        else:
            raise NotImplementedError("Connector of type %s does't exist" % label)
 
 
class CFormat(Enum):
    MULT = (1, 'multiplicity')
    TOPO = (2, 'topological')
    SIMPLE = (3, 'simple')
    def __init__(self, _, cformat ):
        self.cformat = cformat
 
    @staticmethod
    def from_str(label):
        if label == 'multiplicity':
            return CFormat.MULT
        elif label == 'topological':
            return CFormat.TOPO
        elif label == 'simple':
            return CFormat.SIMPLE
        else:
            raise NotImplementedError
 
 
 
class MenuConnectorsCollection:
    def __init__(self):
        self.connectors = {}
 
    def __iter__(self):
        return iter(self.connectors.values())
 
    def __contains__(self, name):
        return name in self.connectors
 
    def __getitem__(self, name):
        return self.connectors[name]
 
    def addConnector(self, connDef):
        name, cformat, ctype, legacy, boardName = map(connDef.__getitem__,["name", "format", "type", "legacy", "board"])
 
        if name in self.connectors:
            raise RuntimeError("Connector %s has already been defined" % name)
 
        log.debug("Adding connector %s, format %s, legacy set to %s, and connType %s", name, cformat, legacy, ctype)
        if CType.from_str(ctype) is CType.ELEC:
            newConnector = ElectricalConnector(name, cformat, legacy, connDef)
        elif CType.from_str(ctype) is CType.CTPIN:
            newConnector = CtpinConnector(name, legacy, connDef)
        else:
            newConnector = OpticalConnector(name, cformat, ctype, legacy, connDef)
        self.connectors[name] = newConnector
 
    def json(self):
        confObj = {}
        for conn in self.connectors.values():
            confObj[conn.name] = conn.json()
        return confObj
 
 
 
 
class Connector:
    __slots__ = ['name', 'cformat', 'ctype', 'legacy', 'boardName', 'triggerLines', 'emptyTriggerLines']
    def __init__(self, connDef):
        """
        @param name name of the connector
        @param cformat can be 'topological' or 'multiplicity'
        @param ctype can be 'ctpin', 'electrical', or 'optical'
        """
        name, cformat, ctype, legacy, boardName = map(connDef.__getitem__,["name", "format", "type", "legacy", "board"])
        self.name    = name
        self.cformat = CFormat.from_str(cformat)
        self.ctype   = CType.from_str(ctype)
        self.legacy  = bool(legacy)
        self.boardName = boardName
        self.triggerLines = []
        self.emptyTriggerLines = [] # Empty placeholders in the output fibers/cables, to ensure correst alignment of the triggerLines bits
 
    def addTriggerLine(self, tl):
        self.triggerLines.append(tl)
 
    def addEmptyTriggerLine(self, tl):
        self.emptyTriggerLines.append(tl)
 
    def isLegacy(self):
        return self.legacy
 
    def triggerThresholds(self):
        return [x.name for x in self.triggerLines]
 
    def json(self):
        confObj = {}
        confObj["type"] = str(self.ctype)
        if self.legacy:
            confObj["legacy"] = self.legacy
        confObj["triggerlines"] = [tl.json() for tl in self.triggerLines]
        return confObj
 
 
class CtpinConnector(Connector):
    __slots__ = ['name', 'legacy', 'triggerLines', 'emptyTriggerLines']
    def __init__(self, name, legacy, connDef):
        """
        @param name name of the connector
        @param legacy is 'true' for legacy L1Calo connectors
        """
        super(CtpinConnector,self).__init__(connDef = connDef)
 
        # connectors contain all the triggerlines in a flat "thresholds" list
        startbit = 0
        for thrName in connDef["thresholds"]:
            nbits = connDef["nbitsDefault"]
            if type(thrName)==tuple:
                (thrName, nbits) = thrName
 
            if thrName is None:
                self.addEmptyTriggerLine(EmptyTriggerLine(startbit, nbits))
            else:
                self.addTriggerLine(TriggerLine(name=thrName, startbit=startbit, flatindex=startbit, nbits=nbits))
 
            startbit += nbits
 
 
class OpticalConnector(Connector):
    __slots__ = ['name', 'cformat', 'ctype', 'legacy', 'triggerLines', 'emptyTriggerLines']
    def __init__(self, name, cformat, ctype, legacy, connDef):
        """
        @param name name of the connector
        @param cformat can be 'topological' or 'multiplicity'
        @param ctype can be 'ctpin', 'electrical', or 'optical'
        """
        super(OpticalConnector,self).__init__(connDef = connDef)
 
        # treat differently depending on the "format", which can be: 'topological' or 'multiplicity' 
        if self.cformat == CFormat.MULT:
            # multiplicity connectors contain all the triggerlines in a flat "thresholds" list
            startbit = 0
            for thrName in connDef["thresholds"]:
                nbits = connDef["nbitsDefault"]
                if type(thrName)==tuple:
                    (thrName, nbits) = thrName
 
                if thrName is None:
                    self.addEmptyTriggerLine(EmptyTriggerLine(startbit, nbits))
                else:
                    self.addTriggerLine(TriggerLine(name=thrName, startbit=startbit, flatindex=startbit, nbits=nbits))
 
                startbit += nbits
 
        else:
            raise RuntimeError("Property 'format' of connector %s is '%s' but must be either 'multiplicity' or 'topological', however 'topological' is not yet implemented" % (name,connDef["format"]))
 
 
class ElectricalConnector(Connector):
    def __init__(self, name, cformat, legacy, connDef):
        """
        @param name name of the connector
        @param cformat can be 'topological' or 'simple'
        """
        super(ElectricalConnector,self).__init__(connDef = connDef)
        self.triggerLines = { 0 : {0:[],1:[]}, 1 : {0:[],1:[]} }
 
        if self.cformat == CFormat.TOPO:
            # topological connectors when they are electrical
            # connectors contain the triggerlines in up to four
            # algorithm groups, each corresponding to a different (fpga,clock) setting
            currentTopoCategory = AlgCategory.getCategoryFromBoardName(self.boardName)
            for thrG in connDef["algorithmGroups"]:
                fpga,clock = map(thrG.__getitem__,["fpga","clock"])
                for topo in thrG["algorithms"]:
                    bit = topo.outputbits[0] if isinstance(topo.outputbits, tuple) else topo.outputbits
                    for (i, tl) in enumerate(topo.outputlines):
                        # for topological triggerlines the names have to be prefixed as they are in the item definitions
                        tlname = currentTopoCategory.prefix + tl
                        startbit = bit+i
                        flatindex = 32*fpga + 2*startbit + clock
                        self.addTriggerLine( TriggerLine( name = tlname, startbit = startbit, flatindex = flatindex, nbits = 1, fpga = fpga, clock = clock ), fpga, clock )
        elif self.cformat == CFormat.SIMPLE:
            for sigG in connDef["signalGroups"]:
                clock = sigG["clock"]
                startbit = 0
                for signal in sigG["signals"]:
                    nbits = connDef["nbitsDefault"]
                    if type(signal)==tuple:
                        (signal,nbits) = signal
                    if signal is None:
                        startbit += nbits
                        continue
                    # use a single flatindex value for the Topo legacy boards
                    flatindex = 2*startbit + clock
                    tl = TriggerLine( name = signal, startbit = startbit, flatindex = flatindex, nbits = nbits, fpga = None, clock = clock)
                    startbit += nbits
                    self.addTriggerLine(tl, 0, clock)
        else:
            raise RuntimeError("Property 'format' of connector %s is '%s' but must be either 'simple' or 'topological'" % (name,connDef["format"]))
 
 
    def addTriggerLine(self, tl, fpga, clock):
        self.triggerLines[fpga][clock].append( tl )
 
    def triggerThresholds(self):
        thr = self.triggerLines[0][0] + self.triggerLines[0][1] + self.triggerLines[1][0] + self.triggerLines[1][1]
        return [x.name for x in thr]
 
    def json(self):
        confObj = {}
        confObj["type"] = str(self.ctype)
        if self.legacy:
            confObj["legacy"] = self.legacy
        confObj["triggerlines"] = {}
        if self.cformat == CFormat.TOPO:
            _triggerLines = []
            for fpga in [0,1]:
                for clock in [0,1]:
                     _triggerLines += [tl.json() for tl in self.triggerLines[fpga][clock]]
            confObj["triggerlines"] = _triggerLines
        elif self.cformat == CFormat.SIMPLE:
            _triggerLines = []
            for clock in [0,1]:
                _triggerLines += [tl.json() for tl in self.triggerLines[0][clock]]
            confObj["triggerlines"] = _triggerLines
        return confObj
 
 
class TriggerLine:
    def __init__(self, name, startbit, nbits, flatindex=None, fpga=None, clock=None):
        self.name      = name    
        self.startbit  = startbit
        self.flatindex = flatindex # for electrical cables
        self.nbits     = nbits  
        self.fpga      = fpga
        self.clock     = clock 
         
    def json(self):
        confObj = {}
        confObj["name"]     = self.name
        confObj["startbit"] = self.startbit
        if self.flatindex is not None: 
           confObj["flatindex"] = self.flatindex
        confObj["nbits"]    = self.nbits
        if self.fpga is not None:
           confObj["fpga"]  = self.fpga
        if self.clock is not None:
           confObj["clock"] = self.clock
        return confObj
 
    @property
    def endbit(self) -> int:
        return self.startbit + self.nbits - 1
 
 
 
class EmptyTriggerLine:
    def __init__(self, startbit: int, nbits: int):
        self.startbit  = startbit
        self.nbits     = nbits
 
    @property
    def endbit(self) -> int:
        return self.startbit + self.nbits - 1