Warning, /L1Trigger/RegionalCaloTrigger/test/README is written in an unsupported language. File is not indexed.
0001 L1RCT Mini-Tutorial and readme
0002 Creighton Hogg
0003
0004 The Level 1 Regional Calo Trigger emulator is actually a fairly simple
0005 piece of work.
0006
0007 The main classes are as follows
0008
0009 L1RCT --> Is the main controlling class that handles all the input,
0010 configuring the cards and crates as neighbors, handles data
0011 sharing and runs all of the processing.
0012
0013 L1RCTCrate --> This is the class representing a single crate
0014 It's main functions are to feed the data into
0015 the RCs, and properly pass data from the RCs
0016 to the EICs and eventually to the JSCs
0017
0018 L1RCTJetSummaryCard --> This is the end of the L1RCT and where the
0019 GCT will have to pick up. The "jet" summary card
0020 contains within it all the important output
0021 information from the eics and the rcs.
0022 Namely, it includes regions sums from the rcs
0023 and the hf regions, as well as the electron
0024 candidates from the eics, the tau bits and muon
0025 bits from each region.
0026 The hf energies go direction into jsc rather
0027 than into some form of receiver card first.
0028
0029 L1RCTElectronIsolationCard --> This card has only one real purpose:
0030 To *find electrons at all cost*!!!11one
0031 The highest energy electron candidate of
0032 each type from each region is kept
0033 and passed along to the jsc.
0034 The two types of electrons are isolated
0035 and nonisolated electrons.
0036
0037 L1RCTReceiverCard --> This card takes in the input and fills the regions
0038 with the appropriate values after sending the
0039 input through a lookuptable first.
0040 It calculates regions sums, tau bits, and muon bits.
0041
0042 L1RCTRegion --> This is the most fundamental data structure in the
0043 emulator. It holds the h/e||fg bits for each tower
0044 as well as the seven bit et, nine bit et, activity bit
0045 and muon bit.
0046
0047 -- The following classes act as support for the main data types
0048
0049 L1RCTLookupTables --> This contains the lookuptable functions for
0050 both the jsc and the rcs.
0051
0052 L1RCTNeighborMap --> This contains the information needed in order to
0053 determine the location of the neighbors of a given
0054 region. This is necessary for electron finding.
0055
0056 L1RCTORCAMap --> This is an interface between the arrays where
0057 data is stored in the old RCT simulation and
0058 the input of the new emulator.
0059
0060
0061
0062
0063 Data Flow: The overall data flow is also fairly straight forward
0064
0065 A vector of vectors of vectors of unsigned shorts
0066 type vector<vector<vector<unsigned short> > > represents the barrel data
0067 This is mostly for convenience for distributing the data to the crates
0068 and to the rcs, but in theory it wouldn't be difficult to change to a
0069 different representation.
0070 For similar reasons the hf energy is represented as a vector of vectors
0071 of unsigned shorts, i.e. type vector<vector<unsigned short> >
0072
0073 This data is used to fill the regions of the trigger system.
