TTTrack_TrackWord Class Reference

#include <TTTrack_TrackWord.h>

Inheritance diagram for TTTrack_TrackWord:

Public Types
typedef ap_uint< TrackBitWidths::kBendChi2Size >	bendChi2_t
typedef ap_uint< TrackBitWidths::kChi2RPhiSize >	chi2rphi_t
typedef ap_uint< TrackBitWidths::kChi2RZSize >	chi2rz_t
typedef ap_uint< TrackBitWidths::kD0Size >	d0_t
typedef ap_uint< TrackBitWidths::kHitPatternSize >	hit_t
typedef ap_uint< TrackBitWidths::kMVAOtherSize >	otherMVA_t
typedef ap_uint< TrackBitWidths::kPhiSize >	phi_t
typedef ap_uint< TrackBitWidths::kMVAQualitySize >	qualityMVA_t
typedef ap_uint< TrackBitWidths::kRinvSize >	rinv_t
typedef ap_uint< TrackBitWidths::kTanlSize >	tanl_t
typedef std::bitset< TrackBitWidths::kTrackWordSize >	tkword_bs_t
typedef ap_uint< TrackBitWidths::kTrackWordSize >	tkword_t
enum	TrackBitLocations {   kMVAOtherLSB = 0, kMVAOtherMSB = kMVAOtherLSB + TrackBitWidths::kMVAOtherSize - 1, kMVAQualityLSB = kMVAOtherMSB + 1, kMVAQualityMSB = kMVAQualityLSB + TrackBitWidths::kMVAQualitySize - 1,   kHitPatternLSB = kMVAQualityMSB + 1, kHitPatternMSB = kHitPatternLSB + TrackBitWidths::kHitPatternSize - 1, kBendChi2LSB = kHitPatternMSB + 1, kBendChi2MSB = kBendChi2LSB + TrackBitWidths::kBendChi2Size - 1,   kD0LSB = kBendChi2MSB + 1, kD0MSB = kD0LSB + TrackBitWidths::kD0Size - 1, kChi2RZLSB = kD0MSB + 1, kChi2RZMSB = kChi2RZLSB + TrackBitWidths::kChi2RZSize - 1,   kZ0LSB = kChi2RZMSB + 1, kZ0MSB = kZ0LSB + TrackBitWidths::kZ0Size - 1, kTanlLSB = kZ0MSB + 1, kTanlMSB = kTanlLSB + TrackBitWidths::kTanlSize - 1,   kChi2RPhiLSB = kTanlMSB + 1, kChi2RPhiMSB = kChi2RPhiLSB + TrackBitWidths::kChi2RPhiSize - 1, kPhiLSB = kChi2RPhiMSB + 1, kPhiMSB = kPhiLSB + TrackBitWidths::kPhiSize - 1,   kRinvLSB = kPhiMSB + 1, kRinvMSB = kRinvLSB + TrackBitWidths::kRinvSize - 1, kValidLSB = kRinvMSB + 1, kValidMSB = kValidLSB + TrackBitWidths::kValidSize - 1 }
enum	TrackBitWidths {   kMVAOtherSize = 6, kMVAQualitySize = 3, kHitPatternSize = 7, kBendChi2Size = 3,   kD0Size = 13, kChi2RZSize = 4, kZ0Size = 12, kTanlSize = 16,   kChi2RPhiSize = 4, kPhiSize = 12, kRinvSize = 15, kValidSize = 1,   kTrackWordSize }
typedef ap_uint< TrackBitWidths::kValidSize >	valid_t
typedef ap_uint< TrackBitWidths::kZ0Size >	z0_t

Public Member Functions
double	getBendChi2 () const
unsigned int	getBendChi2Bits () const
bendChi2_t	getBendChi2Word () const
double	getChi2RPhi () const
unsigned int	getChi2RPhiBits () const
chi2rphi_t	getChi2RPhiWord () const
double	getChi2RZ () const
unsigned int	getChi2RZBits () const
chi2rz_t	getChi2RZWord () const
double	getD0 () const
unsigned int	getD0Bits () const
d0_t	getD0Word () const
unsigned int	getHitPattern () const
unsigned int	getHitPatternBits () const
hit_t	getHitPatternWord () const
unsigned int	getMVAOther () const
unsigned int	getMVAOtherBits () const
otherMVA_t	getMVAOtherWord () const
unsigned int	getMVAQuality () const
unsigned int	getMVAQualityBits () const
qualityMVA_t	getMVAQualityWord () const
unsigned int	getNStubs () const
double	getPhi () const
unsigned int	getPhiBits () const
phi_t	getPhiWord () const
double	getRinv () const
unsigned int	getRinvBits () const
rinv_t	getRinvWord () const
double	getTanl () const
unsigned int	getTanlBits () const
tanl_t	getTanlWord () const
tkword_t	getTrackWord () const
bool	getValid () const
unsigned int	getValidBits () const
valid_t	getValidWord () const
double	getZ0 () const
unsigned int	getZ0Bits () const
z0_t	getZ0Word () const
TTTrack_TrackWord &	operator= (const TTTrack_TrackWord &word)
void	setTrackWord (unsigned int valid, const GlobalVector &momentum, const GlobalPoint &POCA, double rInv, double chi2RPhi, double chi2RZ, double bendChi2, unsigned int hitPattern, unsigned int mvaQuality, unsigned int mvaOther, unsigned int sector)
void	setTrackWord (unsigned int valid, unsigned int rInv, unsigned int phi0, unsigned int tanl, unsigned int z0, unsigned int d0, unsigned int chi2RPhi, unsigned int chi2RZ, unsigned int bendChi2, unsigned int hitPattern, unsigned int mvaQuality, unsigned int mvaOther)
void	setTrackWord (ap_uint< TrackBitWidths::kValidSize > valid, ap_uint< TrackBitWidths::kRinvSize > rInv, ap_uint< TrackBitWidths::kPhiSize > phi0, ap_uint< TrackBitWidths::kTanlSize > tanl, ap_uint< TrackBitWidths::kZ0Size > z0, ap_uint< TrackBitWidths::kD0Size > d0, ap_uint< TrackBitWidths::kChi2RPhiSize > chi2RPhi, ap_uint< TrackBitWidths::kChi2RZSize > chi2RZ, ap_uint< TrackBitWidths::kBendChi2Size > bendChi2, ap_uint< TrackBitWidths::kHitPatternSize > hitPattern, ap_uint< TrackBitWidths::kMVAQualitySize > mvaQuality, ap_uint< TrackBitWidths::kMVAOtherSize > mvaOther)
bool	singleDigitizationSchemeTest (const double floatingPointValue, const unsigned int nBits, const double lsb) const
void	testDigitizationScheme () const
	TTTrack_TrackWord ()
	TTTrack_TrackWord (unsigned int valid, const GlobalVector &momentum, const GlobalPoint &POCA, double rInv, double chi2RPhi, double chi2RZ, double bendChi2, unsigned int hitPattern, unsigned int mvaQuality, unsigned int mvaOther, unsigned int sector)
	TTTrack_TrackWord (unsigned int valid, unsigned int rInv, unsigned int phi0, unsigned int tanl, unsigned int z0, unsigned int d0, unsigned int chi2RPhi, unsigned int chi2RZ, unsigned int bendChi2, unsigned int hitPattern, unsigned int mvaQuality, unsigned int mvaOther)
	TTTrack_TrackWord (const TTTrack_TrackWord &word)

Static Public Attributes
static constexpr std::array< double, 1<< TrackBitWidths::kBendChi2Size >	bendChi2Bins
static constexpr std::array< double, 1<< TrackBitWidths::kChi2RPhiSize >	chi2RPhiBins
static constexpr std::array< double, 1<< TrackBitWidths::kChi2RZSize >	chi2RZBins
static constexpr double	minD0 = -16.
static constexpr double	minPhi0 = -0.7853981696
static constexpr double	minRinv = -0.006
static constexpr double	minTanl = -8.
static constexpr double	minZ0 = -20.46912512
static constexpr unsigned int	nSectors = 9
static constexpr double	sectorWidth = (2. * M_PI) / nSectors
static constexpr double	stepD0 = (1. / (1 << 8))
static constexpr double	stepPhi0 = (2. * std::abs(minPhi0)) / (1 << TrackBitWidths::kPhiSize)
static constexpr double	stepRinv = (2. * std::abs(minRinv)) / (1 << TrackBitWidths::kRinvSize)
static constexpr double	stepTanL = (1. / (1 << 12))
static constexpr double	stepZ0 = (2. * std::abs(minZ0)) / (1 << TrackBitWidths::kZ0Size)

Protected Member Functions
float	localPhi (float globalPhi, unsigned int sector) const

Private Member Functions
unsigned int	countSetBits (unsigned int n) const
unsigned int	digitizeSignedValue (double value, unsigned int nBits, double lsb) const
template<typename T >
constexpr unsigned int	getBin (double value, const T &bins) const
double	undigitizeSignedValue (unsigned int twosValue, unsigned int nBits, double lsb) const

Private Attributes
tkword_bs_t	trackWord_

Detailed Description

Definition at line 35 of file TTTrack_TrackWord.h.

Member Typedef Documentation

bendChi2_t

typedef ap_uint<TrackBitWidths::kBendChi2Size> TTTrack_TrackWord::bendChi2_t

Definition at line 124 of file TTTrack_TrackWord.h.

chi2rphi_t

typedef ap_uint<TrackBitWidths::kChi2RPhiSize> TTTrack_TrackWord::chi2rphi_t

Definition at line 122 of file TTTrack_TrackWord.h.

chi2rz_t

typedef ap_uint<TrackBitWidths::kChi2RZSize> TTTrack_TrackWord::chi2rz_t

Definition at line 123 of file TTTrack_TrackWord.h.

d0_t

typedef ap_uint<TrackBitWidths::kD0Size> TTTrack_TrackWord::d0_t

Definition at line 119 of file TTTrack_TrackWord.h.

hit_t

typedef ap_uint<TrackBitWidths::kHitPatternSize> TTTrack_TrackWord::hit_t

Definition at line 125 of file TTTrack_TrackWord.h.

otherMVA_t

typedef ap_uint<TrackBitWidths::kMVAOtherSize> TTTrack_TrackWord::otherMVA_t

Definition at line 127 of file TTTrack_TrackWord.h.

phi_t

typedef ap_uint<TrackBitWidths::kPhiSize> TTTrack_TrackWord::phi_t

Definition at line 116 of file TTTrack_TrackWord.h.

qualityMVA_t

typedef ap_uint<TrackBitWidths::kMVAQualitySize> TTTrack_TrackWord::qualityMVA_t

Definition at line 126 of file TTTrack_TrackWord.h.

rinv_t

typedef ap_uint<TrackBitWidths::kRinvSize> TTTrack_TrackWord::rinv_t

Definition at line 115 of file TTTrack_TrackWord.h.

tanl_t

typedef ap_uint<TrackBitWidths::kTanlSize> TTTrack_TrackWord::tanl_t

Definition at line 117 of file TTTrack_TrackWord.h.

tkword_bs_t

typedef std::bitset<TrackBitWidths::kTrackWordSize> TTTrack_TrackWord::tkword_bs_t

Definition at line 130 of file TTTrack_TrackWord.h.

tkword_t

typedef ap_uint<TrackBitWidths::kTrackWordSize> TTTrack_TrackWord::tkword_t

Definition at line 131 of file TTTrack_TrackWord.h.

valid_t

typedef ap_uint<TrackBitWidths::kValidSize> TTTrack_TrackWord::valid_t

Definition at line 112 of file TTTrack_TrackWord.h.

z0_t

typedef ap_uint<TrackBitWidths::kZ0Size> TTTrack_TrackWord::z0_t

Definition at line 118 of file TTTrack_TrackWord.h.

Member Enumeration Documentation

TrackBitLocations

enum TTTrack_TrackWord::TrackBitLocations

Enumerator
kMVAOtherLSB
kMVAOtherMSB
kMVAQualityLSB
kMVAQualityMSB
kHitPatternLSB
kHitPatternMSB
kBendChi2LSB
kBendChi2MSB
kD0LSB
kD0MSB
kChi2RZLSB
kChi2RZMSB
kZ0LSB
kZ0MSB
kTanlLSB
kTanlMSB
kChi2RPhiLSB
kChi2RPhiMSB
kPhiLSB
kPhiMSB
kRinvLSB
kRinvMSB
kValidLSB
kValidMSB

Definition at line 58 of file TTTrack_TrackWord.h.

                         {
    // The location of the least significant bit (LSB) and most significant bit (MSB) in the track word for different fields
    kMVAOtherLSB = 0,
    kMVAOtherMSB = kMVAOtherLSB + TrackBitWidths::kMVAOtherSize - 1,
    kMVAQualityLSB = kMVAOtherMSB + 1,
    kMVAQualityMSB = kMVAQualityLSB + TrackBitWidths::kMVAQualitySize - 1,
    kHitPatternLSB = kMVAQualityMSB + 1,
    kHitPatternMSB = kHitPatternLSB + TrackBitWidths::kHitPatternSize - 1,
    kBendChi2LSB = kHitPatternMSB + 1,
    kBendChi2MSB = kBendChi2LSB + TrackBitWidths::kBendChi2Size - 1,
    kD0LSB = kBendChi2MSB + 1,
    kD0MSB = kD0LSB + TrackBitWidths::kD0Size - 1,
    kChi2RZLSB = kD0MSB + 1,
    kChi2RZMSB = kChi2RZLSB + TrackBitWidths::kChi2RZSize - 1,
    kZ0LSB = kChi2RZMSB + 1,
    kZ0MSB = kZ0LSB + TrackBitWidths::kZ0Size - 1,
    kTanlLSB = kZ0MSB + 1,
    kTanlMSB = kTanlLSB + TrackBitWidths::kTanlSize - 1,
    kChi2RPhiLSB = kTanlMSB + 1,
    kChi2RPhiMSB = kChi2RPhiLSB + TrackBitWidths::kChi2RPhiSize - 1,
    kPhiLSB = kChi2RPhiMSB + 1,
    kPhiMSB = kPhiLSB + TrackBitWidths::kPhiSize - 1,
    kRinvLSB = kPhiMSB + 1,
    kRinvMSB = kRinvLSB + TrackBitWidths::kRinvSize - 1,
    kValidLSB = kRinvMSB + 1,
    kValidMSB = kValidLSB + TrackBitWidths::kValidSize - 1,
  };

TrackBitWidths

enum TTTrack_TrackWord::TrackBitWidths

Enumerator
kMVAOtherSize
kMVAQualitySize
kHitPatternSize
kBendChi2Size
kD0Size
kChi2RZSize
kZ0Size
kTanlSize
kChi2RPhiSize
kPhiSize
kRinvSize
kValidSize
kTrackWordSize

Definition at line 38 of file TTTrack_TrackWord.h.

                      {
    // The sizes of the track word components
    kMVAOtherSize = 6,    // Space for two specialized MVA selections
    kMVAQualitySize = 3,  // Width of track quality MVA
    kHitPatternSize = 7,  // Width of the hit pattern for stubs
    kBendChi2Size = 3,    // Width of the bend-chi2/dof
    kD0Size = 13,         // Width of D0
    kChi2RZSize = 4,      // Width of chi2/dof for r-z
    kZ0Size = 12,         // Width of z-position (40cm / 0.1)
    kTanlSize = 16,       // Width of tan(lambda)
    kChi2RPhiSize = 4,    // Width of chi2/dof for r-phi
    kPhiSize = 12,        // Width of phi
    kRinvSize = 15,       // Width of Rinv
    kValidSize = 1,       // Valid bit

    kTrackWordSize = kValidSize + kRinvSize + kPhiSize + kChi2RPhiSize + kTanlSize + kZ0Size + kChi2RZSize + kD0Size +
                     kBendChi2Size + kHitPatternSize + kMVAQualitySize +
                     kMVAOtherSize,  // Width of the track word in bits
  };

Constructor & Destructor Documentation

TTTrack_TrackWord() [1/4]

TTTrack_TrackWord::TTTrack_TrackWord ( )

inline

Definition at line 135 of file TTTrack_TrackWord.h.

{}

TTTrack_TrackWord() [2/4]

TTTrack_TrackWord::TTTrack_TrackWord	(	unsigned int	valid,
		const GlobalVector &	momentum,
		const GlobalPoint &	POCA,
		double	rInv,
		double	chi2RPhi,
		double	chi2RZ,
		double	bendChi2,
		unsigned int	hitPattern,
		unsigned int	mvaQuality,
		unsigned int	mvaOther,
		unsigned int	sector
	)

Definition at line 30 of file TTTrack_TrackWord.cc.

References setTrackWord(), and validateGeometry_cfg::valid.

                                                          {
  setTrackWord(valid, momentum, POCA, rInv, chi2RPhi, chi2RZ, bendChi2, hitPattern, mvaQuality, mvaOther, sector);
}

TTTrack_TrackWord() [3/4]

TTTrack_TrackWord::TTTrack_TrackWord	(	unsigned int	valid,
		unsigned int	rInv,
		unsigned int	phi0,
		unsigned int	tanl,
		unsigned int	z0,
		unsigned int	d0,
		unsigned int	chi2RPhi,
		unsigned int	chi2RZ,
		unsigned int	bendChi2,
		unsigned int	hitPattern,
		unsigned int	mvaQuality,
		unsigned int	mvaOther
	)

Definition at line 44 of file TTTrack_TrackWord.cc.

References d0, setTrackWord(), validateGeometry_cfg::valid, and HLTMuonOfflineAnalyzer_cfi::z0.

                                                            {
  setTrackWord(valid, rInv, phi0, tanl, z0, d0, chi2RPhi, chi2RZ, bendChi2, hitPattern, mvaQuality, mvaOther);
}

TTTrack_TrackWord() [4/4]

TTTrack_TrackWord::TTTrack_TrackWord ( const TTTrack_TrackWord &  word )

inline

Definition at line 161 of file TTTrack_TrackWord.h.

References trackWord_.

{ trackWord_ = word.trackWord_; }

Member Function Documentation

countSetBits()

unsigned int TTTrack_TrackWord::countSetBits ( unsigned int  n ) const

inlineprivate

Definition at line 281 of file TTTrack_TrackWord.h.

References submitPVResolutionJobs::count, and dqmiodumpmetadata::n.

Referenced by getNStubs().

                                                  {
    // Adapted from: https://www.geeksforgeeks.org/count-set-bits-in-an-integer/
    unsigned int count = 0;
    while (n) {
      n &= (n - 1);
      count++;
    }
    return count;
  }

digitizeSignedValue()

unsigned int TTTrack_TrackWord::digitizeSignedValue ( double  value, unsigned int  nBits, double  lsb  ) const

inlineprivate

Definition at line 291 of file TTTrack_TrackWord.h.

References l1tHGCalVFEProducer_cfi::lsb.

Referenced by setTrackWord(), and singleDigitizationSchemeTest().

                                                                                       {
    // Digitize the incoming value
    int digitizedValue = std::floor(value / lsb);

    // Calculate the maxmum possible positive value given an output of nBits in size
    int digitizedMaximum = (1 << (nBits - 1)) - 1;  // The remove 1 bit from nBits to account for the sign
    int digitizedMinimum = -1. * (digitizedMaximum + 1);

    // Saturate the digitized value
    digitizedValue = std::clamp(digitizedValue, digitizedMinimum, digitizedMaximum);

    // Do the two's compliment encoding
    unsigned int twosValue = digitizedValue;
    if (digitizedValue < 0) {
      twosValue += (1 << nBits);
    }

    return twosValue;
  }

getBendChi2()

double TTTrack_TrackWord::getBendChi2 ( ) const

inline

Definition at line 224 of file TTTrack_TrackWord.h.

References bendChi2Bins, and getBendChi2Bits().

{ return bendChi2Bins[getBendChi2Bits()]; }

getBendChi2Bits()

unsigned int TTTrack_TrackWord::getBendChi2Bits ( ) const

inline

Definition at line 209 of file TTTrack_TrackWord.h.

References getBendChi2Word().

Referenced by L1TrackQuality::featureTransform(), and getBendChi2().

{ return getBendChi2Word().to_uint(); }

getBendChi2Word()

bendChi2_t TTTrack_TrackWord::getBendChi2Word ( ) const

inline

Definition at line 184 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getBendChi2Bits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

                                     {
    return getTrackWord()(TrackBitLocations::kBendChi2MSB, TrackBitLocations::kBendChi2LSB);
  }

getBin()

template<typename T >

constexpr unsigned int TTTrack_TrackWord::getBin ( double  value, const T &  bins  ) const

inlineprivate

Definition at line 312 of file TTTrack_TrackWord.h.

References trigObjTnPSource_cfi::bins, up, pfDeepBoostedJetPreprocessParams_cfi::upper_bound, and relativeConstraints::value.

Referenced by BTagWeightCalculator.BTagWeightCalculator::calcJetWeightImpl(), and setTrackWord().

                                                                   {
    auto up = std::upper_bound(bins.begin(), bins.end(), value);
    return (up - bins.begin() - 1);
  }

getChi2RPhi()

double TTTrack_TrackWord::getChi2RPhi ( ) const

inline

Definition at line 222 of file TTTrack_TrackWord.h.

References chi2RPhiBins, and getChi2RPhiBits().

{ return chi2RPhiBins[getChi2RPhiBits()]; }

getChi2RPhiBits()

unsigned int TTTrack_TrackWord::getChi2RPhiBits ( ) const

inline

Definition at line 207 of file TTTrack_TrackWord.h.

References getChi2RPhiWord().

Referenced by L1TrackQuality::featureTransform(), and getChi2RPhi().

{ return getChi2RPhiWord().to_uint(); }

getChi2RPhiWord()

chi2rphi_t TTTrack_TrackWord::getChi2RPhiWord ( ) const

inline

Definition at line 178 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getChi2RPhiBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

                                     {
    return getTrackWord()(TrackBitLocations::kChi2RPhiMSB, TrackBitLocations::kChi2RPhiLSB);
  }

getChi2RZ()

double TTTrack_TrackWord::getChi2RZ ( ) const

inline

Definition at line 223 of file TTTrack_TrackWord.h.

References chi2RZBins, and getChi2RZBits().

{ return chi2RZBins[getChi2RZBits()]; }

getChi2RZBits()

unsigned int TTTrack_TrackWord::getChi2RZBits ( ) const

inline

Definition at line 208 of file TTTrack_TrackWord.h.

References getChi2RZWord().

Referenced by L1TrackQuality::featureTransform(), and getChi2RZ().

{ return getChi2RZWord().to_uint(); }

getChi2RZWord()

chi2rz_t TTTrack_TrackWord::getChi2RZWord ( ) const

inline

Definition at line 181 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getChi2RZBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

                                 {
    return getTrackWord()(TrackBitLocations::kChi2RZMSB, TrackBitLocations::kChi2RZLSB);
  }

getD0()

double TTTrack_TrackWord::getD0 ( ) const

inline

Definition at line 221 of file TTTrack_TrackWord.h.

References getD0Bits(), stepD0, and undigitizeSignedValue().

{ return undigitizeSignedValue(getD0Bits(), TrackBitWidths::kD0Size, stepD0); }

getD0Bits()

unsigned int TTTrack_TrackWord::getD0Bits ( ) const

inline

Definition at line 206 of file TTTrack_TrackWord.h.

References getD0Word().

Referenced by getD0().

{ return getD0Word().to_uint(); }

getD0Word()

d0_t TTTrack_TrackWord::getD0Word ( ) const

inline

Definition at line 177 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getD0Bits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

{ return getTrackWord()(TrackBitLocations::kD0MSB, TrackBitLocations::kD0LSB); }

getHitPattern()

unsigned int TTTrack_TrackWord::getHitPattern ( ) const

inline

Definition at line 225 of file TTTrack_TrackWord.h.

References getHitPatternBits().

{ return getHitPatternBits(); }

getHitPatternBits()

unsigned int TTTrack_TrackWord::getHitPatternBits ( ) const

inline

Definition at line 210 of file TTTrack_TrackWord.h.

References getHitPatternWord().

Referenced by getHitPattern(), and getNStubs().

{ return getHitPatternWord().to_uint(); }

getHitPatternWord()

hit_t TTTrack_TrackWord::getHitPatternWord ( ) const

inline

Definition at line 187 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getHitPatternBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

                                  {
    return getTrackWord()(TrackBitLocations::kHitPatternMSB, TrackBitLocations::kHitPatternLSB);
  }

getMVAOther()

unsigned int TTTrack_TrackWord::getMVAOther ( ) const

inline

Definition at line 228 of file TTTrack_TrackWord.h.

References getMVAOtherBits().

{ return getMVAOtherBits(); }

getMVAOtherBits()

unsigned int TTTrack_TrackWord::getMVAOtherBits ( ) const

inline

Definition at line 212 of file TTTrack_TrackWord.h.

References getMVAOtherWord().

Referenced by getMVAOther().

{ return getMVAOtherWord().to_uint(); }

getMVAOtherWord()

otherMVA_t TTTrack_TrackWord::getMVAOtherWord ( ) const

inline

Definition at line 193 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getMVAOtherBits().

                                     {
    return getTrackWord()(TrackBitLocations::kMVAOtherMSB, TrackBitLocations::kMVAOtherLSB);
  }

getMVAQuality()

unsigned int TTTrack_TrackWord::getMVAQuality ( ) const

inline

Definition at line 227 of file TTTrack_TrackWord.h.

References getMVAQualityBits().

{ return getMVAQualityBits(); }

getMVAQualityBits()

unsigned int TTTrack_TrackWord::getMVAQualityBits ( ) const

inline

Definition at line 211 of file TTTrack_TrackWord.h.

References getMVAQualityWord().

Referenced by getMVAQuality().

{ return getMVAQualityWord().to_uint(); }

getMVAQualityWord()

qualityMVA_t TTTrack_TrackWord::getMVAQualityWord ( ) const

inline

Definition at line 190 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getMVAQualityBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

                                         {
    return getTrackWord()(TrackBitLocations::kMVAQualityMSB, TrackBitLocations::kMVAQualityLSB);
  }

getNStubs()

unsigned int TTTrack_TrackWord::getNStubs ( ) const

inline

Definition at line 226 of file TTTrack_TrackWord.h.

References countSetBits(), and getHitPatternBits().

{ return countSetBits(getHitPatternBits()); }

getPhi()

double TTTrack_TrackWord::getPhi ( ) const

inline

Definition at line 218 of file TTTrack_TrackWord.h.

References getPhiBits(), stepPhi0, and undigitizeSignedValue().

{ return undigitizeSignedValue(getPhiBits(), TrackBitWidths::kPhiSize, stepPhi0); }

getPhiBits()

unsigned int TTTrack_TrackWord::getPhiBits ( ) const

inline

Definition at line 203 of file TTTrack_TrackWord.h.

References getPhiWord().

Referenced by getPhi().

{ return getPhiWord().to_uint(); }

getPhiWord()

phi_t TTTrack_TrackWord::getPhiWord ( ) const

inline

Definition at line 174 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getPhiBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

{ return getTrackWord()(TrackBitLocations::kPhiMSB, TrackBitLocations::kPhiLSB); }

getRinv()

double TTTrack_TrackWord::getRinv ( ) const

inline

Definition at line 217 of file TTTrack_TrackWord.h.

References getRinvBits(), stepRinv, and undigitizeSignedValue().

{ return undigitizeSignedValue(getRinvBits(), TrackBitWidths::kRinvSize, stepRinv); }

getRinvBits()

unsigned int TTTrack_TrackWord::getRinvBits ( ) const

inline

Definition at line 202 of file TTTrack_TrackWord.h.

References getRinvWord().

Referenced by getRinv().

{ return getRinvWord().to_uint(); }

getRinvWord()

rinv_t TTTrack_TrackWord::getRinvWord ( ) const

inline

Definition at line 173 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getRinvBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

{ return getTrackWord()(TrackBitLocations::kRinvMSB, TrackBitLocations::kRinvLSB); }

getTanl()

double TTTrack_TrackWord::getTanl ( ) const

inline

Definition at line 219 of file TTTrack_TrackWord.h.

References getTanlBits(), stepTanL, and undigitizeSignedValue().

{ return undigitizeSignedValue(getTanlBits(), TrackBitWidths::kTanlSize, stepTanL); }

getTanlBits()

unsigned int TTTrack_TrackWord::getTanlBits ( ) const

inline

Definition at line 204 of file TTTrack_TrackWord.h.

References getTanlWord().

Referenced by getTanl().

{ return getTanlWord().to_uint(); }

getTanlWord()

tanl_t TTTrack_TrackWord::getTanlWord ( ) const

inline

Definition at line 175 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getTanlBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

{ return getTrackWord()(TrackBitLocations::kTanlMSB, TrackBitLocations::kTanlLSB); }

getTrackWord()

tkword_t TTTrack_TrackWord::getTrackWord ( ) const

inline

Definition at line 196 of file TTTrack_TrackWord.h.

References trackWord_.

Referenced by getBendChi2Word(), getChi2RPhiWord(), getChi2RZWord(), getD0Word(), getHitPatternWord(), getMVAOtherWord(), getMVAQualityWord(), getPhiWord(), getRinvWord(), getTanlWord(), getValidWord(), and getZ0Word().

{ return tkword_t(trackWord_.to_string().c_str(), 2); }

getValid()

bool TTTrack_TrackWord::getValid ( ) const

inline

Definition at line 216 of file TTTrack_TrackWord.h.

References getValidWord().

{ return getValidWord().to_bool(); }

getValidBits()

unsigned int TTTrack_TrackWord::getValidBits ( ) const

inline

Definition at line 201 of file TTTrack_TrackWord.h.

References getValidWord().

{ return getValidWord().to_uint(); }

getValidWord()

valid_t TTTrack_TrackWord::getValidWord ( ) const

inline

Definition at line 172 of file TTTrack_TrackWord.h.

References getTrackWord(), l1tmhtemu::kValidLSB, and l1tmhtemu::kValidMSB.

Referenced by getValid(), getValidBits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

{ return getTrackWord()(TrackBitLocations::kValidMSB, TrackBitLocations::kValidLSB); }

getZ0()

double TTTrack_TrackWord::getZ0 ( ) const

inline

Definition at line 220 of file TTTrack_TrackWord.h.

References getZ0Bits(), stepZ0, and undigitizeSignedValue().

{ return undigitizeSignedValue(getZ0Bits(), TrackBitWidths::kZ0Size, stepZ0); }

getZ0Bits()

unsigned int TTTrack_TrackWord::getZ0Bits ( ) const

inline

Definition at line 205 of file TTTrack_TrackWord.h.

References getZ0Word().

Referenced by getZ0().

{ return getZ0Word().to_uint(); }

getZ0Word()

z0_t TTTrack_TrackWord::getZ0Word ( ) const

inline

Definition at line 176 of file TTTrack_TrackWord.h.

References getTrackWord().

Referenced by getZ0Bits(), and l1tpf::PFTrackProducerFromL1Tracks::produce().

{ return getTrackWord()(TrackBitLocations::kZ0MSB, TrackBitLocations::kZ0LSB); }

localPhi()

float TTTrack_TrackWord::localPhi ( float  globalPhi, unsigned int  sector  ) const

inlineprotected

Definition at line 275 of file TTTrack_TrackWord.h.

References reco::deltaPhi(), and sectorWidth.

Referenced by TTTrack< T >::localPhi(), and setTrackWord().

                                                             {
    return reco::deltaPhi(globalPhi, (sector * sectorWidth));
  }

operator=()

TTTrack_TrackWord& TTTrack_TrackWord::operator= ( const TTTrack_TrackWord &  word )

inline

Definition at line 164 of file TTTrack_TrackWord.h.

References trackWord_.

                                                              {
    trackWord_ = word.trackWord_;
    return *this;
  }

setTrackWord() [1/3]

void TTTrack_TrackWord::setTrackWord	(	unsigned int	valid,
		const GlobalVector &	momentum,
		const GlobalPoint &	POCA,
		double	rInv,
		double	chi2RPhi,
		double	chi2RZ,
		double	bendChi2,
		unsigned int	hitPattern,
		unsigned int	mvaQuality,
		unsigned int	mvaOther,
		unsigned int	sector
	)

Definition at line 60 of file TTTrack_TrackWord.cc.

References bendChi2Bins, chi2RPhiBins, chi2RZBins, digitizeSignedValue(), getBin(), localPhi(), PV3DBase< T, PVType, FrameType >::perp(), PV3DBase< T, PVType, FrameType >::phi(), stepD0, stepPhi0, stepRinv, stepTanL, stepZ0, validateGeometry_cfg::valid, sistrip::valid_, and PV3DBase< T, PVType, FrameType >::z().

Referenced by l1t::demo::codecs::decodeTracks(), l1tpf::PFTrackProducerFromL1Tracks::produce(), setTrackWord(), and TTTrack_TrackWord().

                                                          {
  // first, derive quantities to be packed
  float rPhi = localPhi(momentum.phi(), sector);  // this needs to be phi relative to the center of the sector
  float rTanl = momentum.z() / momentum.perp();
  float rZ0 = POCA.z();
  float rD0 = POCA.perp();

  // bin and convert to integers
  valid_t valid_ = valid;
  rinv_t rInv_ = digitizeSignedValue(rInv, TrackBitWidths::kRinvSize, stepRinv);
  phi_t phi0_ = digitizeSignedValue(rPhi, TrackBitWidths::kPhiSize, stepPhi0);
  tanl_t tanl_ = digitizeSignedValue(rTanl, TrackBitWidths::kTanlSize, stepTanL);
  z0_t z0_ = digitizeSignedValue(rZ0, TrackBitWidths::kZ0Size, stepZ0);
  d0_t d0_ = digitizeSignedValue(rD0, TrackBitWidths::kD0Size, stepD0);
  chi2rphi_t chi2RPhi_ = getBin(chi2RPhi, chi2RPhiBins);
  chi2rz_t chi2RZ_ = getBin(chi2RZ, chi2RZBins);
  bendChi2_t bendChi2_ = getBin(bendChi2, bendChi2Bins);
  hit_t hitPattern_ = hitPattern;
  qualityMVA_t mvaQuality_ = mvaQuality;
  otherMVA_t mvaOther_ = mvaOther;

  // pack the track word
  //trackWord = ( mvaOther_, mvaQuality_, hitPattern_, bendChi2_, chi2RZ_, chi2RPhi_, d0_, z0_, tanl_, phi0_, rInv_, valid_ );
  setTrackWord(
      valid_, rInv_, phi0_, tanl_, z0_, d0_, chi2RPhi_, chi2RZ_, bendChi2_, hitPattern_, mvaQuality_, mvaOther_);
}

setTrackWord() [2/3]

void TTTrack_TrackWord::setTrackWord	(	unsigned int	valid,
		unsigned int	rInv,
		unsigned int	phi0,
		unsigned int	tanl,
		unsigned int	z0,
		unsigned int	d0,
		unsigned int	chi2RPhi,
		unsigned int	chi2RZ,
		unsigned int	bendChi2,
		unsigned int	hitPattern,
		unsigned int	mvaQuality,
		unsigned int	mvaOther
	)

Definition at line 98 of file TTTrack_TrackWord.cc.

References d0, setTrackWord(), validateGeometry_cfg::valid, sistrip::valid_, and HLTMuonOfflineAnalyzer_cfi::z0.

                                                            {
  // bin and convert to integers
  valid_t valid_ = valid;
  rinv_t rInv_ = rInv;
  phi_t phi0_ = phi0;
  tanl_t tanl_ = tanl;
  z0_t z0_ = z0;
  d0_t d0_ = d0;
  chi2rphi_t chi2RPhi_ = chi2RPhi;
  chi2rz_t chi2RZ_ = chi2RZ;
  bendChi2_t bendChi2_ = bendChi2;
  hit_t hitPattern_ = hitPattern;
  qualityMVA_t mvaQuality_ = mvaQuality;
  otherMVA_t mvaOther_ = mvaOther;

  // pack the track word
  //trackWord = ( otherMVA_t(mvaOther), qualityMVA_t(mvaQuality), hit_t(hitPattern),
  //              bendChi2_t(bendChi2), chi2rz_t(chi2RZ), chi2rphi_t(chi2RPhi),
  //              d0_t(d0), z0_t(z0), tanl_t(tanl), phi_t(phi0), rinv_t(rInv), valid_t(valid) );
  setTrackWord(
      valid_, rInv_, phi0_, tanl_, z0_, d0_, chi2RPhi_, chi2RZ_, bendChi2_, hitPattern_, mvaQuality_, mvaOther_);
}

setTrackWord() [3/3]

void TTTrack_TrackWord::setTrackWord	(	ap_uint< TrackBitWidths::kValidSize >	valid,
		ap_uint< TrackBitWidths::kRinvSize >	rInv,
		ap_uint< TrackBitWidths::kPhiSize >	phi0,
		ap_uint< TrackBitWidths::kTanlSize >	tanl,
		ap_uint< TrackBitWidths::kZ0Size >	z0,
		ap_uint< TrackBitWidths::kD0Size >	d0,
		ap_uint< TrackBitWidths::kChi2RPhiSize >	chi2RPhi,
		ap_uint< TrackBitWidths::kChi2RZSize >	chi2RZ,
		ap_uint< TrackBitWidths::kBendChi2Size >	bendChi2,
		ap_uint< TrackBitWidths::kHitPatternSize >	hitPattern,
		ap_uint< TrackBitWidths::kMVAQualitySize >	mvaQuality,
		ap_uint< TrackBitWidths::kMVAOtherSize >	mvaOther
	)

Definition at line 132 of file TTTrack_TrackWord.cc.

References b, d0, l1tmhtemu::kValidSize, hltrates_dqm_sourceclient-live_cfg::offset, trackWord_, validateGeometry_cfg::valid, and HLTMuonOfflineAnalyzer_cfi::z0.

                                                   {
  // pack the track word
  unsigned int offset = 0;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kMVAOtherSize); b++) {
    trackWord_.set(b, mvaOther[b - offset]);
  }
  offset += TrackBitWidths::kMVAOtherSize;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kMVAQualitySize); b++) {
    trackWord_.set(b, mvaQuality[b - offset]);
  }
  offset += TrackBitWidths::kMVAQualitySize;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kHitPatternSize); b++) {
    trackWord_.set(b, hitPattern[b - offset]);
  }
  offset += TrackBitWidths::kHitPatternSize;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kBendChi2Size); b++) {
    trackWord_.set(b, bendChi2[b - offset]);
  }
  offset += TrackBitWidths::kBendChi2Size;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kD0Size); b++) {
    trackWord_.set(b, d0[b - offset]);
  }
  offset += TrackBitWidths::kD0Size;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kChi2RZSize); b++) {
    trackWord_.set(b, chi2RZ[b - offset]);
  }
  offset += TrackBitWidths::kChi2RZSize;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kZ0Size); b++) {
    trackWord_.set(b, z0[b - offset]);
  }
  offset += TrackBitWidths::kZ0Size;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kTanlSize); b++) {
    trackWord_.set(b, tanl[b - offset]);
  }
  offset += TrackBitWidths::kTanlSize;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kChi2RPhiSize); b++) {
    trackWord_.set(b, chi2RPhi[b - offset]);
  }
  offset += TrackBitWidths::kChi2RPhiSize;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kPhiSize); b++) {
    trackWord_.set(b, phi0[b - offset]);
  }
  offset += TrackBitWidths::kPhiSize;
  for (unsigned int b = offset; b < (offset + TrackBitWidths::kRinvSize); b++) {
    trackWord_.set(b, rInv[b - offset]);
  }
  offset += TrackBitWidths::kRinvSize;
  for (unsigned int b = offset; b < offset + TrackBitWidths::kValidSize; b++) {
    trackWord_.set(b, valid[b - offset]);
  }
}

singleDigitizationSchemeTest()

bool TTTrack_TrackWord::singleDigitizationSchemeTest	(	const double	floatingPointValue,
		const unsigned int	nBits,
		const double	lsb
	)		const

Definition at line 196 of file TTTrack_TrackWord.cc.

References funct::abs(), digitizeSignedValue(), tttrack_trackword::infoTestDigitizationScheme(), l1tHGCalVFEProducer_cfi::lsb, and undigitizeSignedValue().

Referenced by testDigitizationScheme().

                                                                             {
  unsigned int digitizedSignedValue = digitizeSignedValue(floatingPointValue, nBits, lsb);
  double undigitizedSignedValue = undigitizeSignedValue(digitizedSignedValue, nBits, lsb);
  unsigned int redigitizedSignedValue = digitizeSignedValue(undigitizedSignedValue, nBits, lsb);
  tttrack_trackword::infoTestDigitizationScheme(
      nBits, lsb, floatingPointValue, digitizedSignedValue, undigitizedSignedValue, redigitizedSignedValue);
  return (std::abs(floatingPointValue - undigitizedSignedValue) <= (lsb / 2.0)) &&
         (digitizedSignedValue == redigitizedSignedValue);
}

testDigitizationScheme()

void TTTrack_TrackWord::testDigitizationScheme

(

)

const

Definition at line 208 of file TTTrack_TrackWord.cc.

References cms::cuda::assert(), and singleDigitizationSchemeTest().

                                                     {
  /*
  Expected output:
    testDigitizationScheme: Floating point value = -4 Digitized value = 4  Un-digitized value = -3.5
    testDigitizationScheme: Floating point value = 3  Digitized value = 3  Un-digitized value = 3.5
    testDigitizationScheme: Floating point value = -3.5 Digitized value = 9  Un-digitized value = -3.25
    testDigitizationScheme: Floating point value = 3.5  Digitized value = 7  Un-digitized value = 3.75
  */
  assert(singleDigitizationSchemeTest(-4.0, 3, 1.0));
  assert(singleDigitizationSchemeTest(3.0, 3, 1.0));
  assert(singleDigitizationSchemeTest(-3.5, 4, 0.5));
  assert(singleDigitizationSchemeTest(3.5, 4, 0.5));
}

undigitizeSignedValue()

double TTTrack_TrackWord::undigitizeSignedValue ( unsigned int  twosValue, unsigned int  nBits, double  lsb  ) const

inlineprivate

Definition at line 317 of file TTTrack_TrackWord.h.

References cms::cuda::assert(), and l1tHGCalVFEProducer_cfi::lsb.

Referenced by getD0(), getPhi(), getRinv(), getTanl(), getZ0(), and singleDigitizationSchemeTest().

                                                                                             {
    // Check that none of the bits above the nBits-1 bit, in a range of [0, nBits-1], are set.
    // This makes sure that it isn't possible for the value represented by `twosValue` to be
    //  any bigger than ((1 << nBits) - 1).
    assert((twosValue >> nBits) == 0);

    // Convert from twos compliment to C++ signed integer (normal digitized value)
    int digitizedValue = twosValue;
    if (twosValue & (1 << (nBits - 1))) {  // check if the twosValue is negative
      digitizedValue -= (1 << nBits);
    }

    // Convert to floating point value
    return (double(digitizedValue) + 0.5) * lsb;
  }

Member Data Documentation

bendChi2Bins

constexpr std::array<double, 1 << TrackBitWidths::kBendChi2Size> TTTrack_TrackWord::bendChi2Bins

static

Initial value:

= {
      {0.0, 0.75, 1.0, 1.5, 2.25, 3.5, 5.0, 20.0}}

Definition at line 104 of file TTTrack_TrackWord.h.

Referenced by getBendChi2(), and setTrackWord().

chi2RPhiBins

constexpr std::array<double, 1 << TrackBitWidths::kChi2RPhiSize> TTTrack_TrackWord::chi2RPhiBins

static

Initial value:

= {
      {0.0, 1.0, 1.5, 2.0, 2.5, 3.0, 3.5, 4.0, 5.0, 6.0, 10.0, 15.0, 20.0, 35.0, 60.0, 200.0}}

Definition at line 100 of file TTTrack_TrackWord.h.

Referenced by getChi2RPhi(), and setTrackWord().

chi2RZBins

constexpr std::array<double, 1 << TrackBitWidths::kChi2RZSize> TTTrack_TrackWord::chi2RZBins

static

Initial value:

= {
      {0.0, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0, 3.5, 4.0, 4.5, 5.0, 6.0, 8.0, 10.0, 20.0, 50.0}}

Definition at line 102 of file TTTrack_TrackWord.h.

Referenced by getChi2RZ(), and setTrackWord().

minD0

constexpr double TTTrack_TrackWord::minD0 = -16.

static

Definition at line 91 of file TTTrack_TrackWord.h.

minPhi0

constexpr double TTTrack_TrackWord::minPhi0 = -0.7853981696

static

Definition at line 88 of file TTTrack_TrackWord.h.

minRinv

constexpr double TTTrack_TrackWord::minRinv = -0.006

static

Definition at line 87 of file TTTrack_TrackWord.h.

minTanl

constexpr double TTTrack_TrackWord::minTanl = -8.

static

Definition at line 89 of file TTTrack_TrackWord.h.

minZ0

constexpr double TTTrack_TrackWord::minZ0 = -20.46912512

static

Definition at line 90 of file TTTrack_TrackWord.h.

nSectors

constexpr unsigned int TTTrack_TrackWord::nSectors = 9

static

Definition at line 108 of file TTTrack_TrackWord.h.

sectorWidth

constexpr double TTTrack_TrackWord::sectorWidth = (2. * M_PI) / nSectors

static

Definition at line 109 of file TTTrack_TrackWord.h.

Referenced by localPhi().

stepD0

constexpr double TTTrack_TrackWord::stepD0 = (1. / (1 << 8))

static

Definition at line 97 of file TTTrack_TrackWord.h.

Referenced by getD0(), and setTrackWord().

stepPhi0

constexpr double TTTrack_TrackWord::stepPhi0 = (2. * std::abs(minPhi0)) / (1 << TrackBitWidths::kPhiSize)

static

Definition at line 94 of file TTTrack_TrackWord.h.

Referenced by l1tmetemu::generateCosLUT(), l1tmetemu::generatePhiSliceLUT(), getPhi(), L1TrackerEtMissEmulatorProducer::L1TrackerEtMissEmulatorProducer(), L1TrackJetEmulationProducer::L2_cluster(), l1tmetemu::localToGlobalPhi(), and setTrackWord().

stepRinv

constexpr double TTTrack_TrackWord::stepRinv = (2. * std::abs(minRinv)) / (1 << TrackBitWidths::kRinvSize)

static

Definition at line 93 of file TTTrack_TrackWord.h.

Referenced by getRinv(), L1GTTInputProducer::inverseRT2InversePT(), and setTrackWord().

stepTanL

constexpr double TTTrack_TrackWord::stepTanL = (1. / (1 << 12))

static

Definition at line 95 of file TTTrack_TrackWord.h.

Referenced by getTanl(), L1GTTInputProducer::indexTanLambda2Eta(), and setTrackWord().

stepZ0

constexpr double TTTrack_TrackWord::stepZ0 = (2. * std::abs(minZ0)) / (1 << TrackBitWidths::kZ0Size)

static

Definition at line 96 of file TTTrack_TrackWord.h.

Referenced by getZ0(), L1TrackJetEmulationProducer::L2_cluster(), and setTrackWord().

trackWord_

tkword_bs_t TTTrack_TrackWord::trackWord_

private

Definition at line 334 of file TTTrack_TrackWord.h.

Referenced by getTrackWord(), operator=(), setTrackWord(), and TTTrack_TrackWord().