L1GctInternHtMiss Class Reference

L1 GCT internal Ht Miss component(s) Ht_x and/or Ht_y. More...

#include <L1GctInternHtMiss.h>

Public Types
enum	L1GctInternHtMissType {   nulltype, miss_htx, miss_hty, miss_htx_and_hty,   jf_miss_htx_and_hty }
	Enum for the variants of Internal HtMiss. More...
enum	numberOfBits { kJetMissHtNBits = 12, kMissHxAndHyNBits = 14, kMissHxOrHyNBits = 16 }

Public Member Functions
int16_t	bx () const
	Get BX number. More...
uint16_t	capBlock () const
	Get capture block. More...
uint16_t	capIndex () const
	Get index within capture block. More...
int16_t	htx () const
	Get Ht x-component value. More...
int16_t	hty () const
	Get Ht y-component. More...
bool	isThereHtx () const
	Is there a valid Ht x-component stored? More...
bool	isThereHty () const
	Is there a valid Ht y-component stored? More...
	L1GctInternHtMiss ()
	default constructor (for vector initialisation etc.) More...
bool	operator!= (const L1GctInternHtMiss &rhs) const
	Inequality operator. More...
bool	operator== (const L1GctInternHtMiss &rhs) const
	Equality operator. More...
bool	overflow () const
	Get overflow. More...
uint32_t	raw () const
	Get the raw data. More...
L1GctInternHtMiss::L1GctInternHtMissType	type () const
	'type' of object? More...
	~L1GctInternHtMiss ()
	destructor More...

Static Public Member Functions
static L1GctInternHtMiss	emulatorJetMissHt (const int htx, const int hty, const bool overFlow, const int16_t bx)
	Named ctor for making missing Ht x & y components object from emulator (jetFinder output). More...
static L1GctInternHtMiss	emulatorMissHtx (const int htx, const bool overFlow, const int16_t bx)
	Named ctor for making missing Ht x component object from emulator. More...
static L1GctInternHtMiss	emulatorMissHtxHty (const int htx, const int hty, const bool overFlow, const int16_t bx)
	Named ctor for making missing Ht x & y components object from emulator (wheel input). More...
static L1GctInternHtMiss	emulatorMissHty (const int hty, const bool overFlow, const int16_t bx)
	Named ctor for making missing Ht y component object from emulator. More...
static L1GctInternHtMiss	unpackerMissHtx (const uint16_t capBlock, const uint16_t capIndex, const int16_t bx, const uint32_t data)
	Named ctor for making missing Ht x-component object from unpacker raw data. More...
static L1GctInternHtMiss	unpackerMissHtxHty (const uint16_t capBlock, const uint16_t capIndex, const int16_t bx, const uint32_t data)
	Named ctor for making missing Ht x & y components object from unpacker raw data (wheel input). More...
static L1GctInternHtMiss	unpackerMissHty (const uint16_t capBlock, const uint16_t capIndex, const int16_t bx, const uint32_t data)
	Named ctor for making missing Ht y-component object from unpacker raw data. More...

Private Types
enum	ShiftsAndMasks {   kDoubleComponentHtyShift = 16, kSingleComponentOflowMask = (1 << 30), kDoubleComponentOflowMask = (1 << 15), kSingleComponentHtMask = 0xffff,   kDoubleComponentHtMask = 0x3fff, kJetFinderComponentHtMask = 0x0fff, kSingleComponentRawMask, kDoubleComponentRawMask }
	Useful bit masks and bit shifts. More...

Private Member Functions
int16_t	convert14BitTwosCompTo16Bit (const uint16_t data) const
	Converts 14-bit two's complement numbers to 16-bit two's complement (i.e. an int16_t) More...
	L1GctInternHtMiss (const L1GctInternHtMissType type, const uint16_t capBlock, const uint16_t capIndex, const int16_t bx, const uint32_t data)
	Private constructor that the named ctors use. More...

Private Attributes
int16_t	bx_
uint16_t	capBlock_
uint16_t	capIndex_
uint32_t	data_
	The captured raw data. More...
L1GctInternHtMissType	type_
	'Type' of the data More...

Detailed Description

L1 GCT internal Ht Miss component(s) Ht_x and/or Ht_y.

Author

Robert Frazier

Date

March 2009

Definition at line 16 of file L1GctInternHtMiss.h.

Member Enumeration Documentation

L1GctInternHtMissType

enum L1GctInternHtMiss::L1GctInternHtMissType

Enum for the variants of Internal HtMiss.

Enumerator
nulltype
miss_htx
miss_hty
miss_htx_and_hty
jf_miss_htx_and_hty

Definition at line 19 of file L1GctInternHtMiss.h.

{ nulltype, miss_htx, miss_hty, miss_htx_and_hty, jf_miss_htx_and_hty };

numberOfBits

enum L1GctInternHtMiss::numberOfBits

Enumerator
kJetMissHtNBits
kMissHxAndHyNBits
kMissHxOrHyNBits

Definition at line 21 of file L1GctInternHtMiss.h.

                    {
    // TODO - tidy up all these enums.
    // These numbers of bits are needed to specify data sizes in the emulator
    // Other masks are below in the private section.
    kJetMissHtNBits = 12,
    kMissHxAndHyNBits = 14,
    kMissHxOrHyNBits = 16
  };

ShiftsAndMasks

enum L1GctInternHtMiss::ShiftsAndMasks

private

Useful bit masks and bit shifts.

Enumerator
kDoubleComponentHtyShift
kSingleComponentOflowMask
kDoubleComponentOflowMask
kSingleComponentHtMask
kDoubleComponentHtMask
kJetFinderComponentHtMask
kSingleComponentRawMask
kDoubleComponentRawMask

Definition at line 116 of file L1GctInternHtMiss.h.

                      {
    kDoubleComponentHtyShift = 16,          // Bit shift for Hty in miss_htx_and_hty
    kSingleComponentOflowMask = (1 << 30),  // Overflow bit mask in miss_htx or miss_hty
    kDoubleComponentOflowMask = (1 << 15),  // Overflow bit mask in miss_htx_and_hty
    kSingleComponentHtMask = 0xffff,        // Ht component mask in miss_htx or miss_hty
    kDoubleComponentHtMask = 0x3fff,        // Ht component mask in miss_htx_and_hty
    kJetFinderComponentHtMask = 0x0fff,     // Ht component mask in jf_miss_htx_and_hty
    kSingleComponentRawMask = kSingleComponentOflowMask |
                              kSingleComponentHtMask,  // To mask off all the non-data bits in raw data (e.g. BC0, etc)
    kDoubleComponentRawMask =
        (kDoubleComponentHtMask << kDoubleComponentHtyShift) | kDoubleComponentOflowMask | kDoubleComponentHtMask
  };

Constructor & Destructor Documentation

L1GctInternHtMiss() [1/2]

L1GctInternHtMiss::L1GctInternHtMiss

(

)

default constructor (for vector initialisation etc.)

Definition at line 6 of file L1GctInternHtMiss.cc.

Referenced by emulatorJetMissHt(), emulatorMissHtx(), emulatorMissHtxHty(), emulatorMissHty(), unpackerMissHtx(), unpackerMissHtxHty(), and unpackerMissHty().

: type_(nulltype), capBlock_(0), capIndex_(0), bx_(0), data_(0) {}

~L1GctInternHtMiss()

L1GctInternHtMiss::~L1GctInternHtMiss

(

)

destructor

Definition at line 9 of file L1GctInternHtMiss.cc.

{}

L1GctInternHtMiss() [2/2]

L1GctInternHtMiss::L1GctInternHtMiss ( const L1GctInternHtMissType  type, const uint16_t  capBlock, const uint16_t  capIndex, const int16_t  bx, const uint32_t  data  )

private

Private constructor that the named ctors use.

Definition at line 116 of file L1GctInternHtMiss.cc.

    : type_(type), capBlock_(capBlock), capIndex_(capIndex), bx_(bx), data_(data) {}

Member Function Documentation

bx()

int16_t L1GctInternHtMiss::bx ( ) const

inline

Get BX number.

Definition at line 80 of file L1GctInternHtMiss.h.

References bx_.

Referenced by emulatorJetMissHt(), emulatorMissHtx(), emulatorMissHtxHty(), emulatorMissHty(), operator<<(), unpackerMissHtx(), unpackerMissHtxHty(), and unpackerMissHty().

{ return bx_; }

capBlock()

uint16_t L1GctInternHtMiss::capBlock ( ) const

inline

Get capture block.

Definition at line 74 of file L1GctInternHtMiss.h.

References capBlock_.

Referenced by operator<<(), unpackerMissHtx(), unpackerMissHtxHty(), and unpackerMissHty().

{ return capBlock_; }

capIndex()

uint16_t L1GctInternHtMiss::capIndex ( ) const

inline

Get index within capture block.

Definition at line 77 of file L1GctInternHtMiss.h.

References capIndex_.

Referenced by operator<<(), unpackerMissHtx(), unpackerMissHtxHty(), and unpackerMissHty().

{ return capIndex_; }

convert14BitTwosCompTo16Bit()

int16_t L1GctInternHtMiss::convert14BitTwosCompTo16Bit ( const uint16_t  data ) const

private

Converts 14-bit two's complement numbers to 16-bit two's complement (i.e. an int16_t)

The input is the raw bits of the 14-bit two's complement in a 16-bit unsigned number.

Definition at line 123 of file L1GctInternHtMiss.cc.

References data.

Referenced by htx(), and hty().

                                                                                {
  // If bit 13 is high, set bits 13, 14, 15 high.
  if ((data & 0x2000) != 0) {
    return static_cast<int16_t>(data | 0xe000);
  }

  // Else, bit 13 must be low, so set bits 13, 14, 15 low.
  return static_cast<int16_t>(data & 0x1fff);
}

emulatorJetMissHt()

L1GctInternHtMiss L1GctInternHtMiss::emulatorJetMissHt ( const int  htx, const int  hty, const bool  overFlow, const int16_t  bx  )

static

Named ctor for making missing Ht x & y components object from emulator (jetFinder output).

Definition at line 36 of file L1GctInternHtMiss.cc.

References bx(), htx(), hty(), jf_miss_htx_and_hty, kDoubleComponentHtyShift, kDoubleComponentOflowMask, kJetFinderComponentHtMask, and L1GctInternHtMiss().

Referenced by L1GctJetFinderBase::getInternalHtMiss().

                                                                         {
  int32_t xdata = (htx & kJetFinderComponentHtMask);
  int32_t ydata = (hty & kJetFinderComponentHtMask) << kDoubleComponentHtyShift;
  int32_t odata = 0;
  if (overFlow || (htx >= kJetFinderComponentHtMask / 2) || (htx < -kJetFinderComponentHtMask / 2) ||
      (hty >= kJetFinderComponentHtMask / 2) || (hty < -kJetFinderComponentHtMask / 2))
    odata = kDoubleComponentOflowMask;
  return L1GctInternHtMiss(jf_miss_htx_and_hty, 0, 0, bx, xdata | ydata | odata);
}

emulatorMissHtx()

L1GctInternHtMiss L1GctInternHtMiss::emulatorMissHtx ( const int  htx, const bool  overFlow, const int16_t  bx  )

static

Named ctor for making missing Ht x component object from emulator.

Definition at line 64 of file L1GctInternHtMiss.cc.

References bx(), htx(), kSingleComponentHtMask, kSingleComponentOflowMask, L1GctInternHtMiss(), and miss_htx.

Referenced by L1GctWheelJetFpga::getInternalHtMiss().

                                                                                                         {
  int32_t xdata = (htx & kSingleComponentHtMask);
  int32_t odata = 0;
  if (overFlow || (htx >= kSingleComponentHtMask / 2) || (htx < -kSingleComponentHtMask / 2))
    odata = kSingleComponentOflowMask;
  return L1GctInternHtMiss(miss_htx, 0, 0, bx, xdata | odata);
}

emulatorMissHtxHty()

L1GctInternHtMiss L1GctInternHtMiss::emulatorMissHtxHty ( const int  htx, const int  hty, const bool  overFlow, const int16_t  bx  )

static

Named ctor for making missing Ht x & y components object from emulator (wheel input).

Definition at line 50 of file L1GctInternHtMiss.cc.

References bx(), htx(), hty(), kDoubleComponentHtMask, kDoubleComponentHtyShift, kDoubleComponentOflowMask, L1GctInternHtMiss(), and miss_htx_and_hty.

Referenced by L1GctJetLeafCard::getInternalHtMiss().

                                                                          {
  int32_t xdata = (htx & kDoubleComponentHtMask);
  int32_t ydata = (hty & kDoubleComponentHtMask) << kDoubleComponentHtyShift;
  int32_t odata = 0;
  if (overFlow || (htx >= kDoubleComponentHtMask / 2) || (htx < -kDoubleComponentHtMask / 2) ||
      (hty >= kDoubleComponentHtMask / 2) || (hty < -kDoubleComponentHtMask / 2))
    odata = kDoubleComponentOflowMask;
  return L1GctInternHtMiss(miss_htx_and_hty, 0, 0, bx, xdata | ydata | odata);
}

emulatorMissHty()

L1GctInternHtMiss L1GctInternHtMiss::emulatorMissHty ( const int  hty, const bool  overFlow, const int16_t  bx  )

static

Named ctor for making missing Ht y component object from emulator.

Definition at line 73 of file L1GctInternHtMiss.cc.

References bx(), hty(), kSingleComponentHtMask, kSingleComponentOflowMask, L1GctInternHtMiss(), and miss_hty.

Referenced by L1GctWheelJetFpga::getInternalHtMiss().

                                                                                                         {
  int32_t ydata = (hty & kSingleComponentHtMask);
  int32_t odata = 0;
  if (overFlow || (hty >= kSingleComponentHtMask / 2) || (hty < -kSingleComponentHtMask / 2))
    odata = kSingleComponentOflowMask;
  return L1GctInternHtMiss(miss_hty, 0, 0, bx, ydata | odata);
}

htx()

int16_t L1GctInternHtMiss::htx

(

)

const

Get Ht x-component value.

Definition at line 82 of file L1GctInternHtMiss.cc.

References convert14BitTwosCompTo16Bit(), kDoubleComponentHtMask, kSingleComponentHtMask, miss_htx, miss_htx_and_hty, raw(), and type().

Referenced by emulatorJetMissHt(), emulatorMissHtx(), emulatorMissHtxHty(), and operator<<().

                                     {
  if (type() == miss_htx) {
    return static_cast<int16_t>(raw() & kSingleComponentHtMask);
  }
  if (type() == miss_htx_and_hty) {
    return convert14BitTwosCompTo16Bit(raw() & kDoubleComponentHtMask);
  }
  return 0;
}

hty()

int16_t L1GctInternHtMiss::hty

(

)

const

Get Ht y-component.

Definition at line 93 of file L1GctInternHtMiss.cc.

References convert14BitTwosCompTo16Bit(), kDoubleComponentHtMask, kDoubleComponentHtyShift, kSingleComponentHtMask, miss_htx_and_hty, miss_hty, raw(), and type().

Referenced by emulatorJetMissHt(), emulatorMissHtxHty(), emulatorMissHty(), and operator<<().

                                     {
  if (type() == miss_hty) {
    return static_cast<int16_t>(raw() & kSingleComponentHtMask);
  }
  if (type() == miss_htx_and_hty) {
    return convert14BitTwosCompTo16Bit((raw() >> kDoubleComponentHtyShift) & kDoubleComponentHtMask);
  }
  return 0;
}

isThereHtx()

bool L1GctInternHtMiss::isThereHtx ( ) const

inline

Is there a valid Ht x-component stored?

Definition at line 83 of file L1GctInternHtMiss.h.

References jf_miss_htx_and_hty, miss_htx, miss_htx_and_hty, and type().

Referenced by operator<<().

                          {
    return (type() == miss_htx || type() == miss_htx_and_hty || type() == jf_miss_htx_and_hty);
  }

isThereHty()

bool L1GctInternHtMiss::isThereHty ( ) const

inline

Is there a valid Ht y-component stored?

Definition at line 88 of file L1GctInternHtMiss.h.

References jf_miss_htx_and_hty, miss_htx_and_hty, miss_hty, and type().

Referenced by operator<<().

                          {
    return (type() == miss_hty || type() == miss_htx_and_hty || type() == jf_miss_htx_and_hty);
  }

operator!=()

bool L1GctInternHtMiss::operator!= ( const L1GctInternHtMiss &  rhs ) const

inline

Inequality operator.

Definition at line 112 of file L1GctInternHtMiss.h.

{ return !(*this == rhs); }

operator==()

bool L1GctInternHtMiss::operator== ( const L1GctInternHtMiss &  rhs ) const

inline

Equality operator.

Definition at line 109 of file L1GctInternHtMiss.h.

References raw(), and type().

{ return (type() == rhs.type() && raw() == rhs.raw()); }

overflow()

bool L1GctInternHtMiss::overflow

(

)

const

Get overflow.

Definition at line 104 of file L1GctInternHtMiss.cc.

References kDoubleComponentOflowMask, kSingleComponentOflowMask, miss_htx, miss_htx_and_hty, miss_hty, raw(), and type().

Referenced by operator<<().

                                       {
  if (type() == miss_htx || type() == miss_hty) {
    return (raw() & kSingleComponentOflowMask) != 0;
  }
  if (type() == miss_htx_and_hty) {
    return (raw() & kDoubleComponentOflowMask) != 0;
  }
  return false;
}

raw()

uint32_t L1GctInternHtMiss::raw ( ) const

inline

Get the raw data.

Definition at line 95 of file L1GctInternHtMiss.h.

References data_.

Referenced by htx(), hty(), operator==(), and overflow().

{ return data_; }

type()

L1GctInternHtMiss::L1GctInternHtMissType L1GctInternHtMiss::type ( ) const

inline

'type' of object?

Definition at line 71 of file L1GctInternHtMiss.h.

References type_.

Referenced by htx(), hty(), isThereHtx(), isThereHty(), operator==(), and overflow().

{ return type_; }

unpackerMissHtx()

L1GctInternHtMiss L1GctInternHtMiss::unpackerMissHtx ( const uint16_t  capBlock, const uint16_t  capIndex, const int16_t  bx, const uint32_t  data  )

static

Named ctor for making missing Ht x-component object from unpacker raw data.

Definition at line 12 of file L1GctInternHtMiss.cc.

References bx(), capBlock(), capIndex(), data, kSingleComponentRawMask, L1GctInternHtMiss(), and miss_htx.

Referenced by GctFormatTranslateV38::blockToGctInternHtMissPostWheel().

                                                                          {
  return L1GctInternHtMiss(miss_htx, capBlock, capIndex, bx, data & kSingleComponentRawMask);
}

unpackerMissHtxHty()

L1GctInternHtMiss L1GctInternHtMiss::unpackerMissHtxHty ( const uint16_t  capBlock, const uint16_t  capIndex, const int16_t  bx, const uint32_t  data  )

static

Named ctor for making missing Ht x & y components object from unpacker raw data (wheel input).

Definition at line 28 of file L1GctInternHtMiss.cc.

References bx(), capBlock(), capIndex(), data, kDoubleComponentRawMask, L1GctInternHtMiss(), and miss_htx_and_hty.

Referenced by GctFormatTranslateV38::blockToGctInternHtMissPreWheel().

                                                                             {
  return L1GctInternHtMiss(miss_htx_and_hty, capBlock, capIndex, bx, data & kDoubleComponentRawMask);
}

unpackerMissHty()

L1GctInternHtMiss L1GctInternHtMiss::unpackerMissHty ( const uint16_t  capBlock, const uint16_t  capIndex, const int16_t  bx, const uint32_t  data  )

static

Named ctor for making missing Ht y-component object from unpacker raw data.

Definition at line 20 of file L1GctInternHtMiss.cc.

References bx(), capBlock(), capIndex(), data, kSingleComponentRawMask, L1GctInternHtMiss(), and miss_hty.

Referenced by GctFormatTranslateV38::blockToGctInternHtMissPostWheel().

                                                                          {
  return L1GctInternHtMiss(miss_hty, capBlock, capIndex, bx, data & kSingleComponentRawMask);
}

Member Data Documentation

bx_

int16_t L1GctInternHtMiss::bx_

private

Definition at line 150 of file L1GctInternHtMiss.h.

Referenced by bx().

capBlock_

uint16_t L1GctInternHtMiss::capBlock_

private

Definition at line 148 of file L1GctInternHtMiss.h.

Referenced by capBlock().

capIndex_

uint16_t L1GctInternHtMiss::capIndex_

private

Definition at line 149 of file L1GctInternHtMiss.h.

Referenced by capIndex().

data_

uint32_t L1GctInternHtMiss::data_

private

The captured raw data.

Definition at line 153 of file L1GctInternHtMiss.h.

Referenced by raw().

type_

L1GctInternHtMissType L1GctInternHtMiss::type_

private

'Type' of the data

Definition at line 145 of file L1GctInternHtMiss.h.

Referenced by Modules.Service::__str__(), Modules.Service::_placeImpl(), Modules.ESSource::_placeImpl(), Modules.ESProducer::_placeImpl(), Modules.ESPrefer::copy(), Mixins._TypedParameterizable::dumpPython(), Modules.ESPrefer::dumpPythonAs(), Modules.Service::dumpSequencePython(), RandomRunSource.RandomRunSource::insertInto(), Modules.Service::insertInto(), ExternalGeneratorFilter.ExternalGeneratorFilter::insertInto(), Mixins._TypedParameterizable::insertInto(), Modules.ESSource::moduleLabel_(), Modules.ESProducer::moduleLabel_(), Modules.ESSource::nameInProcessDesc_(), Modules.ESProducer::nameInProcessDesc_(), Modules.ESPrefer::nameInProcessDesc_(), and type().