Emulates the energy summing on a GCT Wheel card. More...

#include <L1GctWheelEnergyFpga.h>

Inheritance diagram for L1GctWheelEnergyFpga:

Public Types
typedef L1GctTwosComplement < L1GctInternEtSum::kMissExOrEyNBits >	etComponentType

typedef L1GctUnsignedInt < L1GctInternEtSum::kTotEtOrHtNBits >	etHadType

typedef L1GctUnsignedInt < L1GctInternEtSum::kTotEtOrHtNBits >	etTotalType
	typedefs for energy values in fixed numbers of bits More...

enum	maxValues { etTotalMaxValue = L1GctInternEtSum::kTotEtOrHtMaxValue, htTotalMaxValue = L1GctInternEtSum::kTotEtOrHtMaxValue }

Public Member Functions
virtual void	fetchInput ()
	get input data from sources; this is the standard way to provide input More...

etTotalType	getInputEt (unsigned leafnum) const
	get input Et value from a Leaf card (0-2) More...

etComponentType	getInputEx (unsigned leafnum) const
	get input Ex value from a Leaf card (0-2) More...

etComponentType	getInputEy (unsigned leafnum) const
	get input Ey value from a Leaf card (0-2) More...

L1GctJetLeafCard *	getinputLeafCard (unsigned leafnum) const
	provide access to input Leaf card pointer (0-2) More...

std::vector< L1GctInternEtSum >	getInternalEtSums () const
	get the Et sums in internal component format More...

etTotalType	getOutputEt () const
	get output Et value More...

etComponentType	getOutputEx () const
	get output Ex value More...

etComponentType	getOutputEy () const
	get output Ey value More...

etHadType	getOutputHt () const
	get the output Ht More...

etHadType	inputHt (unsigned leafnum) const
	get input Ht value from a Leaf card (0-2) More...

	L1GctWheelEnergyFpga (int id, std::vector< L1GctJetLeafCard * > leafCards)
	Constructor, needs the Leaf cards to be set up first. id should be 0 or 1. More...

virtual void	process ()
	process the data, fill output buffers More...

void	setInputEnergy (unsigned i, int ex, int ey, unsigned et, unsigned ht)
	set input data; not used in normal operation More...

bool	setupOk () const
	check the setup More...

	~L1GctWheelEnergyFpga ()
	Destructor. More...

Public Member Functions inherited from L1GctProcessor
	L1GctProcessor ()

void	reset ()
	complete reset of processor More...

void	setBxRange (const int firstBx, const int numberOfBx)
	define the bunch crossing range to process More...

void	setNextBx (const int bxnum)
	clear input data buffers and process a new bunch crossing More...

void	setTerse ()

bool	setupOk () const
	Method to check the setup for this processor. Returns true by default. More...

void	setVerbose ()
	control output messages More...

virtual	~L1GctProcessor ()

Static Public Attributes
static const unsigned int	MAX_LEAF_CARDS = L1GctWheelJetFpga::MAX_LEAF_CARDS
	Max number of leaf card pointers. More...

Protected Member Functions
virtual void	resetPipelines ()

virtual void	resetProcessor ()
	Separate reset methods for the processor itself and any data stored in pipelines. More...

virtual void	setupObjects ()
	Initialise inputs with null objects for the correct bunch crossing if required. More...

Protected Member Functions inherited from L1GctProcessor
int	bxAbs () const

int	bxMax () const

int	bxMin () const
	Support for multiple beam crossing operation. More...

int	bxRel () const

int	numOfBx () const

Private Attributes
int	m_id
	algo ID More...

std::vector< etTotalType >	m_inputEt

std::vector< etComponentType >	m_inputEx
	the input components from each input card More...

std::vector< etComponentType >	m_inputEy

std::vector< etHadType >	m_inputHt

std::vector< L1GctJetLeafCard * >	m_inputLeafCards
	the jet leaf card More...

etTotalType	m_outputEt

Pipeline< etTotalType >	m_outputEtPipe

etComponentType	m_outputEx
	output data More...

Pipeline< etComponentType >	m_outputExPipe
	record the output data history More...

etComponentType	m_outputEy

Pipeline< etComponentType >	m_outputEyPipe

etHadType	m_outputHt

Pipeline< etHadType >	m_outputHtPipe

bool	m_setupOk
	check the setup More...

Friends
std::ostream &	operator<< (std::ostream &os, const L1GctWheelEnergyFpga &fpga)
	Overload << operator. More...

Additional Inherited Members
Protected Attributes inherited from L1GctProcessor
bool	m_verbose
	Flag to control output messages. More...

Detailed Description

Emulates the energy summing on a GCT Wheel card.

This class carries out the summing of total Et, and missing Et components Ex and Ey, for a single Wheel. The inputs come from the three Leaf cards and the outputs are sent to the L1GctGlobalEnergyAlgos class.

Author: Jim Brooke & Greg Heath

Date: 20/2/2006

Definition at line 30 of file L1GctWheelEnergyFpga.h.

Member Typedef Documentation

typedef L1GctTwosComplement< L1GctInternEtSum::kMissExOrEyNBits > L1GctWheelEnergyFpga::etComponentType

Definition at line 36 of file L1GctWheelEnergyFpga.h.

typedef L1GctUnsignedInt<L1GctInternEtSum::kTotEtOrHtNBits> L1GctWheelEnergyFpga::etHadType

Definition at line 35 of file L1GctWheelEnergyFpga.h.

typedef L1GctUnsignedInt<L1GctInternEtSum::kTotEtOrHtNBits> L1GctWheelEnergyFpga::etTotalType

typedefs for energy values in fixed numbers of bits

Definition at line 34 of file L1GctWheelEnergyFpga.h.

Member Enumeration Documentation

enum L1GctWheelEnergyFpga::maxValues

Enumerator
etTotalMaxValue
htTotalMaxValue

Definition at line 38 of file L1GctWheelEnergyFpga.h.

                    {
       etTotalMaxValue = L1GctInternEtSum::kTotEtOrHtMaxValue,
       htTotalMaxValue = L1GctInternEtSum::kTotEtOrHtMaxValue
     };

Constructor & Destructor Documentation

L1GctWheelEnergyFpga::L1GctWheelEnergyFpga	(	int	id,
		std::vector< L1GctJetLeafCard * >	leafCards
	)

Constructor, needs the Leaf cards to be set up first. id should be 0 or 1.

Definition at line 15 of file L1GctWheelEnergyFpga.cc.

References i, m_id, m_inputLeafCards, m_setupOk, L1GctProcessor::m_verbose, and MAX_LEAF_CARDS.

                                                                                       :
   L1GctProcessor(),
   m_id(id),
   m_inputLeafCards(leafCards),
   m_inputEx(MAX_LEAF_CARDS),
   m_inputEy(MAX_LEAF_CARDS),
   m_inputEt(MAX_LEAF_CARDS),
   m_inputHt(MAX_LEAF_CARDS),
   m_outputEx(0), m_outputEy(0), m_outputEt(0), m_outputHt(0),
   m_setupOk(true),
   m_outputExPipe(), m_outputEyPipe(), m_outputEtPipe(), m_outputHtPipe()
 {
   //Check wheelEnergyFpga setup
   if(m_id != 0 && m_id != 1)
     {
       m_setupOk = false;
       if (m_verbose) {
     edm::LogWarning("L1GctSetupError")
       << "L1GctWheelEnergyFpga::L1GctWheelEnergyFpga() : Wheel Energy Fpga ID " << m_id << " has been incorrectly constructed!\n"
       << "ID number should be 0 or 1.\n";
       } 
     }
   
   if(m_inputLeafCards.size() != MAX_LEAF_CARDS)
     {
       m_setupOk = false;
       if (m_verbose) {
     edm::LogWarning("L1GctSetupError")
       << "L1GctWheelEnergyFpga::L1GctWheelEnergyFpga() : Wheel Energy Fpga ID " << m_id << " has been incorrectly constructed!\n"
       << "This class needs " << MAX_LEAF_CARDS << " leaf card pointers, yet only " << m_inputLeafCards.size()
       << " leaf card pointers are present.\n";
       }
     }
   
   for(unsigned int i = 0; i < m_inputLeafCards.size(); ++i)
     {
       if(m_inputLeafCards.at(i) == 0)
     {
       m_setupOk = false;
       if (m_verbose) {
         edm::LogWarning("L1GctSetupError")
           << "L1GctWheelEnergyFpga::L1GctWheelEnergyFpga() : Wheel Energy Fpga ID " << m_id << " has been incorrectly constructed!\n"
           << "Input Leaf card pointer " << i << " has not been set!\n";
       }
     }
     }
   if (!m_setupOk && m_verbose) {
     edm::LogError("L1GctSetupError") << "L1GctWheelEnergyFpga has been incorrectly constructed";
   }
 }

L1GctWheelEnergyFpga::~L1GctWheelEnergyFpga ( )

Destructor.

Definition at line 66 of file L1GctWheelEnergyFpga.cc.

67 {

68 }

Member Function Documentation

void L1GctWheelEnergyFpga::fetchInput ( )

virtual

get input data from sources; this is the standard way to provide input

Implements L1GctProcessor.

Definition at line 129 of file L1GctWheelEnergyFpga.cc.

References i, m_inputEt, m_inputEx, m_inputEy, m_inputHt, m_inputLeafCards, m_setupOk, and MAX_LEAF_CARDS.

 {
   if (m_setupOk) {
     // Fetch the output values from each of our input leaf cards.
     for (unsigned int i=0; i<MAX_LEAF_CARDS; i++) {
       m_inputEx.at(i) = m_inputLeafCards.at(i)->getOutputEx();
       m_inputEy.at(i) = m_inputLeafCards.at(i)->getOutputEy();
       m_inputEt.at(i) = m_inputLeafCards.at(i)->getOutputEt();
       m_inputHt.at(i) = m_inputLeafCards.at(i)->getOutputHt();
     }
   }
 }

etTotalType L1GctWheelEnergyFpga::getInputEt ( unsigned leafnum ) const

inline

get input Et value from a Leaf card (0-2)

Definition at line 71 of file L1GctWheelEnergyFpga.h.

References m_inputEt.

71 { return m_inputEt.at(leafnum); }

L1GctWheelEnergyFpga::m_inputEt

std::vector< etTotalType > m_inputEt

Definition: L1GctWheelEnergyFpga.h:111

etComponentType L1GctWheelEnergyFpga::getInputEx ( unsigned leafnum ) const

inline

get input Ex value from a Leaf card (0-2)

Definition at line 67 of file L1GctWheelEnergyFpga.h.

References m_inputEx.

67 { return m_inputEx.at(leafnum); }

L1GctWheelEnergyFpga::m_inputEx

std::vector< etComponentType > m_inputEx

the input components from each input card

Definition: L1GctWheelEnergyFpga.h:109

etComponentType L1GctWheelEnergyFpga::getInputEy ( unsigned leafnum ) const

inline

get input Ey value from a Leaf card (0-2)

Definition at line 69 of file L1GctWheelEnergyFpga.h.

References m_inputEy.

69 { return m_inputEy.at(leafnum); }

L1GctWheelEnergyFpga::m_inputEy

std::vector< etComponentType > m_inputEy

Definition: L1GctWheelEnergyFpga.h:110

L1GctJetLeafCard* L1GctWheelEnergyFpga::getinputLeafCard ( unsigned leafnum ) const

inline

provide access to input Leaf card pointer (0-2)

Definition at line 64 of file L1GctWheelEnergyFpga.h.

References m_inputLeafCards.

64 { return m_inputLeafCards.at(leafnum); }

L1GctWheelEnergyFpga::m_inputLeafCards

std::vector< L1GctJetLeafCard * > m_inputLeafCards

the jet leaf card

Definition: L1GctWheelEnergyFpga.h:106

std::vector< L1GctInternEtSum > L1GctWheelEnergyFpga::getInternalEtSums ( ) const

get the Et sums in internal component format

Definition at line 175 of file L1GctWheelEnergyFpga.cc.

References L1GctProcessor::bxMin(), L1GctInternEtSum::fromEmulatorMissEtxOrEty(), L1GctInternEtSum::fromEmulatorTotalEtOrHt(), m_outputEtPipe, m_outputExPipe, m_outputEyPipe, m_outputHtPipe, L1GctProcessor::numOfBx(), and query::result.

 {
 
   std::vector< L1GctInternEtSum > result;
   for (int bx=0; bx<numOfBx(); bx++) {
     result.push_back( L1GctInternEtSum::fromEmulatorMissEtxOrEty( m_outputExPipe.contents.at(bx).value(),
                                   m_outputExPipe.contents.at(bx).overFlow(),
                                   static_cast<int16_t> (bx-bxMin()) ) );
     result.push_back( L1GctInternEtSum::fromEmulatorMissEtxOrEty( m_outputEyPipe.contents.at(bx).value(),
                                   m_outputEyPipe.contents.at(bx).overFlow(),
                                   static_cast<int16_t> (bx-bxMin()) ) );
     result.push_back( L1GctInternEtSum::fromEmulatorTotalEtOrHt( m_outputEtPipe.contents.at(bx).value(),
                                  m_outputEtPipe.contents.at(bx).overFlow(),
                                  static_cast<int16_t> (bx-bxMin()) ) );
     result.push_back( L1GctInternEtSum::fromEmulatorTotalEtOrHt( m_outputHtPipe.contents.at(bx).value(),
                                  m_outputHtPipe.contents.at(bx).overFlow(),
                                  static_cast<int16_t> (bx-bxMin()) ) );
   }
   return result;
 }

etTotalType L1GctWheelEnergyFpga::getOutputEt ( ) const

inline

get output Et value

Definition at line 80 of file L1GctWheelEnergyFpga.h.

References m_outputEt.

Referenced by L1GctGlobalEnergyAlgos::fetchInput().

80 { return m_outputEt; }

L1GctWheelEnergyFpga::m_outputEt

etTotalType m_outputEt

Definition: L1GctWheelEnergyFpga.h:117

etComponentType L1GctWheelEnergyFpga::getOutputEx ( ) const

inline

get output Ex value

Definition at line 76 of file L1GctWheelEnergyFpga.h.

References m_outputEx.

Referenced by L1GctGlobalEnergyAlgos::fetchInput().

76 { return m_outputEx; }

L1GctWheelEnergyFpga::m_outputEx

etComponentType m_outputEx

output data

Definition: L1GctWheelEnergyFpga.h:115

etComponentType L1GctWheelEnergyFpga::getOutputEy ( ) const

inline

get output Ey value

Definition at line 78 of file L1GctWheelEnergyFpga.h.

References m_outputEy.

Referenced by L1GctGlobalEnergyAlgos::fetchInput().

78 { return m_outputEy; }

L1GctWheelEnergyFpga::m_outputEy

etComponentType m_outputEy

Definition: L1GctWheelEnergyFpga.h:116

etHadType L1GctWheelEnergyFpga::getOutputHt ( ) const

inline

get the output Ht

Definition at line 82 of file L1GctWheelEnergyFpga.h.

References m_outputHt.

Referenced by L1GctGlobalEnergyAlgos::fetchInput().

82 { return m_outputHt; }

L1GctWheelEnergyFpga::m_outputHt

etHadType m_outputHt

Definition: L1GctWheelEnergyFpga.h:118

etHadType L1GctWheelEnergyFpga::inputHt ( unsigned leafnum ) const

inline

get input Ht value from a Leaf card (0-2)

Definition at line 73 of file L1GctWheelEnergyFpga.h.

References m_inputHt.

73 { return m_inputHt.at(leafnum); }

L1GctWheelEnergyFpga::m_inputHt

std::vector< etHadType > m_inputHt

Definition: L1GctWheelEnergyFpga.h:112

void L1GctWheelEnergyFpga::process ( )

virtual

process the data, fill output buffers

Implements L1GctProcessor.

Definition at line 142 of file L1GctWheelEnergyFpga.cc.

References L1GctProcessor::bxRel(), etTotalMaxValue, htTotalMaxValue, m_inputEt, m_inputEx, m_inputEy, m_inputHt, m_outputEt, m_outputEtPipe, m_outputEx, m_outputExPipe, m_outputEy, m_outputEyPipe, m_outputHt, m_outputHtPipe, m_setupOk, L1GctUnsignedInt< nBits >::overFlow(), and L1GctUnsignedInt< nBits >::setValue().

Referenced by ConfigBuilder.ConfigBuilder.PrintAllModules::leave().

 {
   if (m_setupOk) {
     m_outputEx = m_inputEx.at(0) + m_inputEx.at(1) + m_inputEx.at(2);
     m_outputEy = m_inputEy.at(0) + m_inputEy.at(1) + m_inputEy.at(2);
     m_outputEt = m_inputEt.at(0) + m_inputEt.at(1) + m_inputEt.at(2);
     m_outputHt = m_inputHt.at(0) + m_inputHt.at(1) + m_inputHt.at(2);
     if (m_outputEt.overFlow()) m_outputEt.setValue(etTotalMaxValue);
     if (m_outputHt.overFlow()) m_outputHt.setValue(htTotalMaxValue);
 
     m_outputExPipe.store( m_outputEx, bxRel());
     m_outputEyPipe.store( m_outputEy, bxRel());
     m_outputEtPipe.store( m_outputEt, bxRel());
     m_outputHtPipe.store( m_outputHt, bxRel());
   }
 }

void L1GctWheelEnergyFpga::resetPipelines ( )

protectedvirtual

Implements L1GctProcessor.

Definition at line 121 of file L1GctWheelEnergyFpga.cc.

References m_outputEtPipe, m_outputExPipe, m_outputEyPipe, m_outputHtPipe, and L1GctProcessor::numOfBx().

 {
   m_outputExPipe.reset(numOfBx());
   m_outputEyPipe.reset(numOfBx());
   m_outputEtPipe.reset(numOfBx());
   m_outputHtPipe.reset(numOfBx());
 }

void L1GctWheelEnergyFpga::resetProcessor ( )

protectedvirtual

Separate reset methods for the processor itself and any data stored in pipelines.

Implements L1GctProcessor.

Definition at line 107 of file L1GctWheelEnergyFpga.cc.

References i, m_inputEt, m_inputEx, m_inputEy, m_inputHt, m_outputEt, m_outputEx, m_outputEy, m_outputHt, MAX_LEAF_CARDS, L1GctUnsignedInt< nBits >::reset(), and L1GctTwosComplement< nBits >::reset().

 {
   for (unsigned int i=0; i<MAX_LEAF_CARDS; i++) {
     m_inputEx.at(i).reset();
     m_inputEy.at(i).reset();
     m_inputEt.at(i).reset();
     m_inputHt.at(i).reset();
   }
   m_outputEx.reset();
   m_outputEy.reset();
   m_outputEt.reset();
   m_outputHt.reset();
 }

void L1GctWheelEnergyFpga::setInputEnergy	(	unsigned	i,
		int	ex,
		int	ey,
		unsigned	et,
		unsigned	ht
	)

set input data; not used in normal operation

set input data

Definition at line 162 of file L1GctWheelEnergyFpga.cc.

References m_inputEt, m_inputEx, m_inputEy, m_inputHt, and MAX_LEAF_CARDS.

 {
   // Set the three input values from this Leaf card
   if (i<MAX_LEAF_CARDS) { // i >= 0, since i is unsigned
     m_inputEx.at(i).setValue(ex);
     m_inputEy.at(i).setValue(ey);
     m_inputEt.at(i).setValue(et);
     m_inputHt.at(i).setValue(ht);
   }
 
 }