ATLAS Offline Software
Loading...
Searching...
No Matches
Public Member Functions | Private Member Functions | Private Attributes | Static Private Attributes | List of all members
LVL1::CrateEnergy Class Reference

CrateEnergy class declaration Simulates behaviour of the Crate-CMM System CMM logic is done in EnergyTrigger. More...

#include <CrateEnergy.h>

Collaboration diagram for LVL1::CrateEnergy:

Public Member Functions

 CrateEnergy (unsigned int crate, const DataVector< ModuleEnergy > *modules, uint32_t maskXE=0xff, uint32_t maskTE=0xff, bool restricted=false)
 CrateEnergy (unsigned int crate, const DataVector< EnergyCMXData > *modules, uint32_t maskXE=0xff, uint32_t maskTE=0xff, bool restricted=false)
 CrateEnergy (unsigned int crate, unsigned int et, unsigned int exTC, unsigned int eyTC, unsigned int overflowT, unsigned int overflowX, unsigned int overflowY, bool restricted=false)
 ~CrateEnergy ()
unsigned int crate () const
 return crate number
int et () const
 return et, ex, ey sums
int ex () const
 return crate Ex
int ey () const
 return crate Ey
unsigned int exTC () const
 15 bit twos-complement format
unsigned int eyTC () const
 return crate Ey in 15-bit twos-complement format (hardware format)
unsigned int exOverflow () const
 Overflow bits.
unsigned int eyOverflow () const
 return Ey overflow bit
unsigned int etOverflow () const
 return Et overflow bit
bool restricted () const
 Full or restricted eta range?

Private Member Functions

unsigned int encodeTC (int input) const
 encode int as 15-bit twos-complement format (hardware Ex/Ey format)
int decodeTC (unsigned int input) const
 decode 15-bit twos-complement format (hardware Ex/Ey format) as int

Private Attributes

unsigned int m_crate
unsigned int m_crateEt
int m_crateEx
int m_crateEy
unsigned int m_overflowT
unsigned int m_overflowX
unsigned int m_overflowY
bool m_restricted
bool m_debug

Static Private Attributes

static const unsigned int m_sumBitsTC =15
static const unsigned int m_sumBits =14
static const unsigned int m_jemEtSaturation = 0x3fff

Detailed Description

CrateEnergy class declaration Simulates behaviour of the Crate-CMM System CMM logic is done in EnergyTrigger.

Definition at line 29 of file CrateEnergy.h.

Constructor & Destructor Documentation

◆ CrateEnergy() [1/3]

LVL1::CrateEnergy::CrateEnergy ( unsigned int crate,
const DataVector< ModuleEnergy > * modules,
uint32_t maskXE = 0xff,
uint32_t maskTE = 0xff,
bool restricted = false )

Check crate in range

Added for restricted eta triggers in Run 2

Summing within a crate proceeds as follows:
unsigned 14 bit Ex, Ey, Et sums are formed for each half crate
these sums (= opposite quadrants) are added (Et) or subtracted (Ex, Ey)
to give the crate totals
overflows are propagated using separate bits

Sum ET from modules belonging to this crate in two halves

Check for overflows then truncate quadrant sums

Form crate sums

For total ET we must check for further overflows

Definition at line 16 of file CrateEnergy.cxx.

16 :
17 m_crate(crate),
18 m_crateEt(0),
19 m_crateEx(0),
20 m_crateEy(0),
21 m_overflowT(0),
22 m_overflowX(0),
23 m_overflowY(0),
24 m_restricted(restricted),
25 m_debug(false)
26 {
28 if (m_crate > 1) return;
29
31 if ((maskXE&0xff) != 0xff || (maskTE&0xff) != 0xff) m_restricted = true;
32
38
40 unsigned int eT[2] = {0,0};
41 unsigned int eX[2] = {0,0};
42 unsigned int eY[2] = {0,0};
43 for ( const ModuleEnergy* jem : *JEMs ) {
44 int moduleInQuad = jem->module() % 8;
45 if (jem->crate() == m_crate) {
46 int quad = ( jem->module() < 8 ? 0 : 1 );
47 if ((maskTE>>moduleInQuad)&1) {
48 eT[quad] += jem->et();
49 if ( jem->et() >= m_jemEtSaturation ) m_overflowT = 1;
50 }
51 if ((maskXE>>moduleInQuad)&1) {
52 eX[quad] += jem->ex();
53 eY[quad] += jem->ey();
54 if ( jem->ex() >= m_jemEtSaturation ) m_overflowX = 1;
55 if ( jem->ey() >= m_jemEtSaturation ) m_overflowY = 1;
56 }
57 } // Right crate?
58 } // Loop over JEMs
59
61 unsigned int mask = (1 << m_sumBits) - 1;
62
65 m_crateEt = eT[0] + eT[1];
66 if (m_crateEt >= mask){
67 m_overflowT = 1;
68 m_crateEt = mask;
69 }
70
71
72 if (!m_overflowX){
73 m_crateEx = eX[0] - eX[1];
74 } else{
75 m_crateEx = -(mask + 1);
76 }
77 if (!m_overflowY){
78 m_crateEy = eY[0] - eY[1];
79 }else{
80 m_crateEy = -(mask + 1);
81 }
82
83
84 if (m_debug) {
85 std::cout << "CrateEnergy: crate " << m_crate << " results " << std::endl
86 << " Et " << m_crateEt << " overflow " << m_overflowT << std::endl
87 << " Ex " << m_crateEx << " overflow " << m_overflowX << std::endl
88 << " Ey " << m_crateEy << " overflow " << m_overflowY << std::endl;
89
90 }
91
92}
LVL1::CrateEnergy::crate
unsigned int crate() const
return crate number
Definition CrateEnergy.cxx:208
LVL1::CrateEnergy::m_overflowT
unsigned int m_overflowT
Definition CrateEnergy.h:59
LVL1::CrateEnergy::m_sumBits
static const unsigned int m_sumBits
Definition CrateEnergy.h:65
LVL1::CrateEnergy::m_overflowY
unsigned int m_overflowY
Definition CrateEnergy.h:61
LVL1::CrateEnergy::restricted
bool restricted() const
Full or restricted eta range?
Definition CrateEnergy.cxx:243
LVL1::CrateEnergy::m_crate
unsigned int m_crate
Definition CrateEnergy.h:55
LVL1::CrateEnergy::m_crateEt
unsigned int m_crateEt
Definition CrateEnergy.h:56
LVL1::CrateEnergy::m_overflowX
unsigned int m_overflowX
Definition CrateEnergy.h:60
LVL1::CrateEnergy::m_jemEtSaturation
static const unsigned int m_jemEtSaturation
Definition CrateEnergy.h:66
IDTPM::eT
float eT(const U &p)
Accessor utility function for getting the value of Tranverse energy.
Definition TrackParametersHelper.h:122

◆ CrateEnergy() [2/3]

LVL1::CrateEnergy::CrateEnergy ( unsigned int crate,
const DataVector< EnergyCMXData > * modules,
uint32_t maskXE = 0xff,
uint32_t maskTE = 0xff,
bool restricted = false )

Check crate in range

Added for restricted eta triggers in Run 2

Summing within a crate proceeds as follows:
unsigned 14 bit Ex, Ey, Et sums are formed for each half crate
these sums (= opposite quadrants) are added (Et) or subtracted (Ex, Ey)
to give the crate totals
overflows are propagated using separate bits

Sum ET from modules belonging to this crate in two halves

Check for overflows then truncate quadrant sums

Form crate sums

For total ET we must check for further overflows

Definition at line 94 of file CrateEnergy.cxx.

94 :
95 m_crate(crate),
96 m_crateEt(0),
97 m_crateEx(0),
98 m_crateEy(0),
99 m_overflowT(0),
100 m_overflowX(0),
101 m_overflowY(0),
102 m_restricted(restricted),
103 m_debug(false)
104 {
106 if (m_crate > 1) return;
107
109 if ((maskXE&0xff) != 0xff || (maskTE&0xff) != 0xff) m_restricted = true;
110
116
118 unsigned int eT[2] = {0,0};
119 unsigned int eX[2] = {0,0};
120 unsigned int eY[2] = {0,0};
121 for ( const EnergyCMXData* jem : *JEMs ) {
122 int moduleInQuad = jem->module() % 8;
123 if ((unsigned int)jem->crate() == m_crate) {
124 int quad = ( jem->module() < 8 ? 0 : 1 );
125
126 if ((maskTE>>moduleInQuad)&1) {
127 eT[quad] += jem->Et();
128 if ( jem->Et() >= m_jemEtSaturation ) m_overflowT = 1;
129 }
130 if ((maskXE>>moduleInQuad)&1) {
131 eX[quad] += jem->Ex();
132 eY[quad] += jem->Ey();
133 if ( jem->Ex() >= m_jemEtSaturation ) m_overflowX = 1;
134 if ( jem->Ey() >= m_jemEtSaturation ) m_overflowY = 1;
135 }
136 }
137 }
138
140 unsigned int mask = (1<<m_sumBits) - 1;
141
142
145 m_crateEt = eT[0] + eT[1];
146 if (m_crateEt >= mask){
147 m_overflowT = 1;
148 m_crateEt = mask;
149 }
150
151 if (!m_overflowX){
152 m_crateEx = eX[0] - eX[1];
153 } else{
154 m_crateEx = -(mask + 1);
155 }
156 if (!m_overflowY){
157 m_crateEy = eY[0] - eY[1];
158 }else{
159 m_crateEy = -(mask + 1);
160 }
161
162 if (m_debug) {
163 std::cout << "CrateEnergy: crate " << m_crate << " results " << std::endl
164 << " Et " << m_crateEt << " overflow " << m_overflowT << std::endl
165 << " Ex " << m_crateEx << " overflow " << m_overflowX << std::endl
166 << " Ey " << m_crateEy << " overflow " << m_overflowY << std::endl;
167
168 }
169
170}

◆ CrateEnergy() [3/3]

LVL1::CrateEnergy::CrateEnergy ( unsigned int crate,
unsigned int et,
unsigned int exTC,
unsigned int eyTC,
unsigned int overflowT,
unsigned int overflowX,
unsigned int overflowY,
bool restricted = false )

Check crate in range

Definition at line 172 of file CrateEnergy.cxx.

174 :
175 m_crate(crate),
176 m_crateEt(0),
177 m_crateEx(0),
178 m_crateEy(0),
179 m_overflowT(0),
180 m_overflowX(0),
181 m_overflowY(0),
182 m_restricted(restricted),
183 m_debug(false)
184{
186 if (m_crate > 1) return;
187 m_crateEt = et;
188 m_crateEx = decodeTC(exTC);
189 m_crateEy = decodeTC(eyTC);
190 m_overflowT = overflowT;
191 m_overflowX = overflowX;
192 m_overflowY = overflowY;
193
194 if (m_debug) {
195 std::cout << "CrateEnergy: crate " << m_crate << " results " << std::endl
196 << " Et " << m_crateEt << " overflow " << m_overflowT << std::endl
197 << " Ex " << m_crateEx << " overflow " << m_overflowX << std::endl
198 << " Ey " << m_crateEy << " overflow " << m_overflowY << std::endl;
199
200 }
201}
LVL1::CrateEnergy::et
int et() const
return et, ex, ey sums
Definition CrateEnergy.cxx:213
LVL1::CrateEnergy::decodeTC
int decodeTC(unsigned int input) const
decode 15-bit twos-complement format (hardware Ex/Ey format) as int
Definition CrateEnergy.cxx:273
LVL1::CrateEnergy::exTC
unsigned int exTC() const
15 bit twos-complement format
Definition CrateEnergy.cxx:248
LVL1::CrateEnergy::eyTC
unsigned int eyTC() const
return crate Ey in 15-bit twos-complement format (hardware format)
Definition CrateEnergy.cxx:253

◆ ~CrateEnergy()

LVL1::CrateEnergy::~CrateEnergy ( )

Definition at line 204 of file CrateEnergy.cxx.

204 {
205}

Member Function Documentation

◆ crate()

unsigned int LVL1::CrateEnergy::crate ( ) const

return crate number

Definition at line 208 of file CrateEnergy.cxx.

208 {
209 return m_crate;
210}

◆ decodeTC()

int LVL1::CrateEnergy::decodeTC ( unsigned int input) const
private

decode 15-bit twos-complement format (hardware Ex/Ey format) as int

Definition at line 273 of file CrateEnergy.cxx.

273 {
274
275 int mask = (1<<m_sumBitsTC) - 1;
276 int value = input&mask;
277
278 if ((value >> (m_sumBitsTC - 1))) {
279 value += (~0U) << m_sumBitsTC;
280 }
281
282 return value;
283}
LVL1::CrateEnergy::m_sumBitsTC
static const unsigned int m_sumBitsTC
Definition CrateEnergy.h:64
trigbs_mixBSevents.input
input
Definition trigbs_mixBSevents.py:56

◆ encodeTC()

unsigned int LVL1::CrateEnergy::encodeTC ( int input) const
private

encode int as 15-bit twos-complement format (hardware Ex/Ey format)

Definition at line 258 of file CrateEnergy.cxx.

258 {
259 unsigned int value;
260
261 if (input > 0) {
262 value = input;
263 }
264 else {
265 value = (1<<m_sumBitsTC) + input;
266 }
267
268 int mask = (1<<m_sumBitsTC) - 1;
269 return value&mask ;
270}

◆ et()

int LVL1::CrateEnergy::et ( ) const

return et, ex, ey sums

return crate Et

Definition at line 213 of file CrateEnergy.cxx.

213 {
214 return m_crateEt;
215}

◆ etOverflow()

unsigned int LVL1::CrateEnergy::etOverflow ( ) const

return Et overflow bit

Definition at line 228 of file CrateEnergy.cxx.

228 {
229 return m_overflowT;
230}

◆ ex()

int LVL1::CrateEnergy::ex ( ) const

return crate Ex

Definition at line 218 of file CrateEnergy.cxx.

218 {
219 return m_crateEx;
220}

◆ exOverflow()

unsigned int LVL1::CrateEnergy::exOverflow ( ) const

Overflow bits.

return Ex overflow bit

Definition at line 233 of file CrateEnergy.cxx.

233 {
234 return m_overflowX;
235}

◆ exTC()

unsigned int LVL1::CrateEnergy::exTC ( ) const

15 bit twos-complement format

return crate Ex in 15-bit twos-complement format (hardware format)

Definition at line 248 of file CrateEnergy.cxx.

248 {
249 return encodeTC(m_crateEx);
250}
LVL1::CrateEnergy::encodeTC
unsigned int encodeTC(int input) const
encode int as 15-bit twos-complement format (hardware Ex/Ey format)
Definition CrateEnergy.cxx:258

◆ ey()

int LVL1::CrateEnergy::ey ( ) const

return crate Ey

Definition at line 223 of file CrateEnergy.cxx.

223 {
224 return m_crateEy;
225}

◆ eyOverflow()

unsigned int LVL1::CrateEnergy::eyOverflow ( ) const

return Ey overflow bit

Definition at line 238 of file CrateEnergy.cxx.

238 {
239 return m_overflowY;
240}

◆ eyTC()

unsigned int LVL1::CrateEnergy::eyTC ( ) const

return crate Ey in 15-bit twos-complement format (hardware format)

Definition at line 253 of file CrateEnergy.cxx.

253 {
254 return encodeTC(m_crateEy);
255}

◆ restricted()

bool LVL1::CrateEnergy::restricted ( ) const

Full or restricted eta range?

Full or Restricted eta range.

Definition at line 243 of file CrateEnergy.cxx.

243 {
244 return m_restricted;
245}

Member Data Documentation

◆ m_crate

unsigned int LVL1::CrateEnergy::m_crate
private

Definition at line 55 of file CrateEnergy.h.

◆ m_crateEt

unsigned int LVL1::CrateEnergy::m_crateEt
private

Definition at line 56 of file CrateEnergy.h.

◆ m_crateEx

int LVL1::CrateEnergy::m_crateEx
private

Definition at line 57 of file CrateEnergy.h.

◆ m_crateEy

int LVL1::CrateEnergy::m_crateEy
private

Definition at line 58 of file CrateEnergy.h.

◆ m_debug

bool LVL1::CrateEnergy::m_debug
private

Definition at line 63 of file CrateEnergy.h.

◆ m_jemEtSaturation

const unsigned int LVL1::CrateEnergy::m_jemEtSaturation = 0x3fff
staticprivate

Definition at line 66 of file CrateEnergy.h.

◆ m_overflowT

unsigned int LVL1::CrateEnergy::m_overflowT
private

Definition at line 59 of file CrateEnergy.h.

◆ m_overflowX

unsigned int LVL1::CrateEnergy::m_overflowX
private

Definition at line 60 of file CrateEnergy.h.

◆ m_overflowY

unsigned int LVL1::CrateEnergy::m_overflowY
private

Definition at line 61 of file CrateEnergy.h.

◆ m_restricted

bool LVL1::CrateEnergy::m_restricted
private

Definition at line 62 of file CrateEnergy.h.

◆ m_sumBits

const unsigned int LVL1::CrateEnergy::m_sumBits =14
staticprivate

Definition at line 65 of file CrateEnergy.h.

◆ m_sumBitsTC

const unsigned int LVL1::CrateEnergy::m_sumBitsTC =15
staticprivate

Definition at line 64 of file CrateEnergy.h.

The documentation for this class was generated from the following files:
Generated on for ATLAS Offline Software by doxygen 1.14.0