TrgRoiAsTiles.py

#!/usr/local/bin/python
#
#                               Copyright 2004
#                                     by
#                        The Board of Trustees of the
#                     Leland Stanford Junior University.
#                            All rights reserved.
#

__facility__ = "Online"
__abstract__ = "GLAST LAT Trigger Object class"
__author__   = "M. Huffer <mehsys@slac.stanford.edu> SLAC - GLAST LAT Electronics"
__date__     = "1/14/04"
__version__  = "$Revision: 2.1 $"
__release__  = "$Name: R04-12-00 $"
__credits__  = "SLAC"

import LATTE.copyright_SLAC

"""TrgRoiAsTiles: Map coincidences to Regions of Interest
"""

from TrgCoincidences import *
from NullObjects     import NullCoincidence

class TrgRoiAsTiles(TrgCoincidences):
  """\brief Class TrgRoiAsTiles
  LATTE provided class to map coincidences to ROIs
  """
  def __init__(self):
    TrgCoincidences.__init__(self)
    self.__coincidenceList = []
    for i in range(TrgObject.COINCIDENCE_NUMBER_MAX + 1):
      self.__coincidenceList.append(NullCoincidence())
    self.__roiList = []
    for i in range(TrgObject.ROI_NUMBER_MAX+1):
      self.__roiList.append(AddableRoi())
    
  def coincidence(self, coincidenceNumber):
    if coincidenceNumber < TrgObject.COINCIDENCE_NUMBER_MIN or \
       coincidenceNumber > TrgObject.COINCIDENCE_NUMBER_MAX:
      raise IndexError, "coincidenceNumber is out of range"
    return self.__coincidenceList[coincidenceNumber]

  def roi(self, roiNumber):
    if roiNumber < TrgObject.ROI_NUMBER_MIN or \
       roiNumber > TrgObject.ROI_NUMBER_MAX:
      raise IndexError, "roiNumber is out of range"
    return self.__roiList[roiNumber]

  def addCoincidence(self, cNumber, coinc):
    self.__coincidenceList[cNumber] = coinc
    self.__fillRoiList(cNumber)
    
  def __fillRoiList(self, cNumber):
    """This function fills the list of ROIs by using the defined
       list of coincident tiles.  Each coincidence pair defines
       tiles in two ROIs.  Coincidence pair 0 maps to ROI 0 and 1, 
       and so on.
    """
    rList = self.__roiList
    coin = self.coincidence(cNumber)
    for tileA in range(TrgObject.TILE_NUMBER_MAX+1):
      tileB = coin.inCoincidence(tileA)
      if tileB >= 0:
        c2 = cNumber * 2
        rList[c2].addTile(tileA)
        rList[c2+1].addTile(tileB)    
    
class AddableRoi(TrgRoi):
  """The main purpose of this class is to add the member function
     addTile(tile).  
     This function appends a tile to the list of tiles in the ROI
  """
  def __init__(self):
    TrgRoi.__init__(self)
    self.__tileList = []
    
  def addTile(self,tile):
    if tile not in self.__tileList:
      if tile >= TrgObject.TILE_NUMBER_MIN and tile <= TrgObject.TILE_NUMBER_MAX:
        self.__tileList.append(tile)
        
  def tile(self, tileNumber):
    if tileNumber < TrgObject.TILE_NUMBER_MIN or tileNumber > TrgObject.TILE_NUMBER_MAX:
      raise IndexError, "tileNumber is out of range"
    if tileNumber in self.__tileList:
      return True
    return False

---