CMS 3D CMS Logo

HFDataFrame.h
Go to the documentation of this file.
1 #ifndef DIGIHCAL_HFDATAFRAME_H
2 #define DIGIHCAL_HFDATAFRAME_H
3 
7 #include <ostream>
8 
14 class HFDataFrame {
15 public:
16  typedef HcalDetId key_type;
17 
18  constexpr HFDataFrame() : id_(0), size_(0), hcalPresamples_(0) {}
19  constexpr explicit HFDataFrame(const HcalDetId& id)
20  : id_(id), size_(0), hcalPresamples_(0) { // TODO : test id for HcalForward
21  }
22 
23  constexpr HcalDetId const& id() const { return id_; }
24  constexpr HcalElectronicsId const& elecId() const { return electronicsId_; }
25 
27  constexpr int size() const { return size_ & 0xF; }
29  constexpr int presamples() const { return hcalPresamples_ & 0xF; }
31  constexpr bool zsMarkAndPass() const { return (hcalPresamples_ & 0x10); }
33  constexpr bool zsUnsuppressed() const { return (hcalPresamples_ & 0x20); }
35  constexpr uint32_t zsCrossingMask() const { return (hcalPresamples_ & 0x3FF000) >> 12; }
36 
38  constexpr HcalQIESample const& operator[](int i) const { return data_[i]; }
40  constexpr HcalQIESample const& sample(int i) const { return data_[i]; }
41 
43  constexpr int fiberIdleOffset() const {
44  int val = (hcalPresamples_ & 0xF00) >> 8;
45  return (val == 0) ? (-1000) : (((val & 0x8) == 0) ? (-(val & 0x7)) : (val & 0x7));
46  }
47 
49  constexpr bool validate(int firstSample = 0, int nSamples = 100) const {
50  int capid = -1;
51  bool ok = true;
52  for (int i = 0; ok && i < nSamples && i + firstSample < size_; i++) {
53  if (data_[i + firstSample].er() || !data_[i + firstSample].dv())
54  ok = false;
55  if (i == 0)
56  capid = data_[i + firstSample].capid();
57  if (capid != data_[i + firstSample].capid())
58  ok = false;
59  capid = (capid + 1) % 4;
60  }
61  return ok;
62  }
63 
64  constexpr void setSize(int size) {
65  if (size > MAXSAMPLES)
66  size_ = MAXSAMPLES;
67  else if (size <= 0)
68  size_ = 0;
69  else
70  size_ = size;
71  }
72  constexpr void setPresamples(int ps) { hcalPresamples_ |= ps & 0xF; }
73  constexpr void setZSInfo(bool unsuppressed, bool markAndPass, uint32_t crossingMask = 0) {
74  hcalPresamples_ &= 0x7FC00F0F; // preserve actual presamples and fiber idle offset
75  if (markAndPass)
76  hcalPresamples_ |= 0x10;
77  if (unsuppressed)
78  hcalPresamples_ |= 0x20;
79  hcalPresamples_ |= (crossingMask & 0x3FF) << 12;
80  }
81  constexpr void setSample(int i, const HcalQIESample& sam) { data_[i] = sam; }
82  constexpr void setReadoutIds(const HcalElectronicsId& eid) { electronicsId_ = eid; }
83  constexpr void setFiberIdleOffset(int offset) {
84  hcalPresamples_ &= 0x7FFFF0FF;
85  if (offset >= 7)
86  hcalPresamples_ |= 0xF00;
87  else if (offset >= 0)
88  hcalPresamples_ |= (0x800) | (offset << 8);
89  else if (offset >= -7)
90  hcalPresamples_ |= ((-offset) << 8);
91  else
92  hcalPresamples_ |= 0x700;
93  }
94 
95  static const int MAXSAMPLES = 10;
96 
97 private:
100  int size_;
103 };
104 
105 std::ostream& operator<<(std::ostream&, const HFDataFrame&);
106 
107 #endif
HcalDetId id_
Definition: HFDataFrame.h:98
HcalDetId key_type
For the sorted collection.
Definition: HFDataFrame.h:16
constexpr void setSize(int size)
Definition: HFDataFrame.h:64
constexpr uint32_t zsCrossingMask() const
zs crossing mask (which sums considered)
Definition: HFDataFrame.h:35
constexpr HcalDetId const & id() const
Definition: HFDataFrame.h:23
int hcalPresamples_
Definition: HFDataFrame.h:101
constexpr bool zsMarkAndPass() const
was ZS MarkAndPass?
Definition: HFDataFrame.h:31
constexpr HFDataFrame(const HcalDetId &id)
Definition: HFDataFrame.h:19
std::ostream & operator<<(std::ostream &, const HFDataFrame &)
Definition: HFDataFrame.cc:3
HcalQIESample data_[MAXSAMPLES]
Definition: HFDataFrame.h:102
constexpr void setZSInfo(bool unsuppressed, bool markAndPass, uint32_t crossingMask=0)
Definition: HFDataFrame.h:73
constexpr int presamples() const
number of samples before the sample from the triggered beam crossing (according to the hardware) ...
Definition: HFDataFrame.h:29
constexpr void setPresamples(int ps)
Definition: HFDataFrame.h:72
constexpr HcalQIESample const & sample(int i) const
access a sample
Definition: HFDataFrame.h:40
constexpr HFDataFrame()
Definition: HFDataFrame.h:18
constexpr HcalElectronicsId const & elecId() const
Definition: HFDataFrame.h:24
constexpr void setReadoutIds(const HcalElectronicsId &eid)
Definition: HFDataFrame.h:82
constexpr int size() const
total number of samples in the digi
Definition: HFDataFrame.h:27
constexpr bool validate(int firstSample=0, int nSamples=100) const
validate appropriate DV and ER bits as well as capid rotation for the specified samples (default is a...
Definition: HFDataFrame.h:49
constexpr void setFiberIdleOffset(int offset)
Definition: HFDataFrame.h:83
constexpr void setSample(int i, const HcalQIESample &sam)
Definition: HFDataFrame.h:81
constexpr int fiberIdleOffset() const
offset of bunch number for this channel relative to nominal set in the unpacker (range is +7->-7...
Definition: HFDataFrame.h:43
constexpr int capid() const
get the Capacitor id
Definition: HcalQIESample.h:47
HcalElectronicsId electronicsId_
Definition: HFDataFrame.h:99
constexpr bool zsUnsuppressed() const
was ZS unsuppressed?
Definition: HFDataFrame.h:33
static const int MAXSAMPLES
Definition: HFDataFrame.h:95
constexpr HcalQIESample const & operator[](int i) const
access a sample
Definition: HFDataFrame.h:38
Readout chain identification for Hcal.