Jpp  16.0.0-rc.1
the software that should make you happy
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
JRunQuality.hh
Go to the documentation of this file.
1 #ifndef __JDB_JRUNQUALITY__
2 #define __JDB_JRUNQUALITY__
3 
4 #include <TROOT.h>
5 #include <TObject.h>
6 
7 #include <string>
8 #include <istream>
9 
11 
12 /**
13  * \author mdejong
14  */
15 namespace JDATABASE {}
16 namespace JPP { using namespace JDATABASE; }
17 
18 namespace KM3NeT {
19  namespace DB {
20  class ResultSet;
21  }
22 }
23 
24 namespace JDATABASE {
25 
26  using KM3NeT::DB::ResultSet;
27 
28  /**
29  * Auxiliary data structure for data quality.
30  *
31  * For ASCII I/O, the number, order and type of the data members of this data structure
32  * should be compatible with the output of the script JQAQC.sh.
33  */
34  struct JRunQuality :
35  public TObject
36  {
37  static const char* const getName() { return JRunSummaryNumbers::getName(); } //!< Table name
38 
39  struct JPrescaler :
40  public TObject
41  {
43  prescale(0)
44  {}
45 
46  int prescale;
47 
48  ClassDef(JPrescaler, 1);
49  };
50 
51  struct JEnabled :
52  public TObject
53  {
55  enabled(0)
56  {}
57 
58  int enabled;
59 
60  ClassDef(JEnabled, 1);
61  };
62 
63 
65  GIT("?"),
66  JPP("?"),
67  UUID("?"),
68  detector(0),
69  run(0),
70  livetime_s(0.0),
71  UTCMin_s(0.0),
72  UTCMax_s(0.0),
73  trigger3DMuon(),
76  triggerNB(),
77  writeL0(),
78  writeL1(),
79  writeL2(),
80  writeSN(),
81  JDAQTimeslice(0),
82  JDAQTimesliceL0(0),
83  JDAQTimesliceL1(0),
84  JDAQTimesliceL2(0),
85  JDAQTimesliceSN(0),
87  JDAQEvent(0),
91  JTrigger3DMuon(0),
92  JTriggerNB(0),
93  in_sync(0),
94  out_sync(0),
95  DAQ(0.0),
96  WR(0.0),
97  HRV(0.0),
98  FIFO(0.0),
99  PMTs(0.0),
100  MEAN_Rate_Hz(0.0),
101  RMS_Rate_Hz(0.0),
102  Acoustics(0),
103  AHRS(0.0),
104  name("?"),
105  value(0.0)
106  {}
107 
108  /**
109  * Put value at given key.
110  *
111  * \param key key
112  * \param value value
113  */
114  void put(const std::string& key,
115  const std::string& value);
116 
117 
118  std::string GIT; ///< GIT version used to write QA/QC data
119  std::string JPP; ///< Jpp version used to take data (see JPrintMeta.cc)
120  std::string UUID; ///< UUID of raw data file
121  int detector; ///< detector identifier
122  int run; ///< run number
123  double livetime_s; ///< livetime of data takig run (as determined from KM3NETDAQ::JDAQSummaryslice data)
124  double UTCMin_s; ///< minimal UTC time (from "runs" table)
125  double UTCMax_s; ///< maximal UTC time (from "runs" table)
126  JEnabled trigger3DMuon; ///< enable (1) or disable (0) of 3D-muon trigger
127  JEnabled trigger3DShower; ///< enable (1) or disable (0) of 3D-shower trigger
128  JEnabled triggerMXShower; ///< enable (1) or disable (0) of L1/L0 mixed trigger
129  JEnabled triggerNB; ///< enable (1) or disable (0) of nano-beacon trigger
130  JPrescaler writeL0; ///< pre-scaling of L0 data (0 implies off)
131  JPrescaler writeL1; ///< pre-scaling of L1 data (0 implies off)
132  JPrescaler writeL2; ///< pre-scaling of L2 data (0 implies off)
133  JPrescaler writeSN; ///< pre-scaling of Supernova data (0 implies off)
134  int JDAQTimeslice; ///< number of timeslices (reserved for rejected data)
135  int JDAQTimesliceL0; ///< number of L0 timeslices
136  int JDAQTimesliceL1; ///< number of L1 timeslices
137  int JDAQTimesliceL2; ///< number of L2 timeslices
138  int JDAQTimesliceSN; ///< number of Supernova timeslices
139  int JDAQSummaryslice; ///< number of summary slices
140  int JDAQEvent; ///< number of events
141  int JTriggerReprocessor; ///< number of events following re-triggering of the data (see JTriggerReprocessor.cc)
142  int JTrigger3DShower; ///< number of 3D-muon triggers (see JTriggerMonitor.cc)
143  int JTriggerMXShower; ///< number of 3D-shower triggers (see JTriggerMonitor.cc)
144  int JTrigger3DMuon; ///< number of L1/L0 mixed triggers (see JTriggerMonitor.cc)
145  int JTriggerNB; ///< number of nano-beacon triggers (see JTriggerMonitor.cc)
146  int in_sync; ///< number of modules in synchronisation with master clock (see JTurbot.cc)
147  int out_sync; ///< number of modules out of synchronisation with master clock (see JTurbot.cc)
148  double DAQ; ///< fraction of data frames with correct DAQ status (see JSummaryMonitor.cc)
149  double WR; ///< fraction of data frames with correct White Rabbit status (see JSummaryMonitor.cc)
150  double HRV; ///< fraction of PMTs with high-rate veto (see JSummaryMonitor.cc)
151  double FIFO; ///< fraction of PMTs with FIFO (almost) full (see JSummaryMonitor.cc)
152  double PMTs; ///< number of PMTs with valid data (see JSummaryMonitor.cc)
153  double MEAN_Rate_Hz; ///< mean rate from PMTs with valid data (see JSummaryMonitor.cc)
154  double RMS_Rate_Hz; ///< RMS of rate from PMTs with valid data (see JSummaryMonitor.cc)
155  int Acoustics; ///< number of acoustic events (see JAcousticsEventBuilder.cc)
156  double AHRS; ///< number of compass measurements (see software/JCompass/JAHRSMonitor.cc)
157  std::string name; ///< setup name (see JRunsetups)
158  double value; ///< setup identifier (see JRunsetups)
159 
160  ClassDef(JRunQuality, 3);
161  };
162 
163 
164  /**
165  * Less-than operator.
166  *
167  * \param first first run quality
168  * \param second second run quality
169  * \return true if first run quality less than second; else false
170  */
171  inline bool operator<(const JRunQuality& first,
172  const JRunQuality& second)
173  {
174  if (first.detector == second.detector)
175  return first.run < second.run;
176  else
177  return first.detector < second.detector;
178  }
179 }
180 
181 #endif
int JDAQTimeslice
number of timeslices (reserved for rejected data)
Definition: JRunQuality.hh:134
int out_sync
number of modules out of synchronisation with master clock (see JTurbot.cc)
Definition: JRunQuality.hh:147
JEnabled trigger3DMuon
enable (1) or disable (0) of 3D-muon trigger
Definition: JRunQuality.hh:126
int JDAQTimesliceL1
number of L1 timeslices
Definition: JRunQuality.hh:136
int detector
detector identifier
Definition: JRunQuality.hh:121
double PMTs
number of PMTs with valid data (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:152
bool operator<(const Head &first, const Head &second)
Less than operator.
Definition: JHead.hh:1678
int JTriggerMXShower
number of 3D-shower triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:143
int JTriggerReprocessor
number of events following re-triggering of the data (see JTriggerReprocessor.cc) ...
Definition: JRunQuality.hh:141
JPrescaler writeL0
pre-scaling of L0 data (0 implies off)
Definition: JRunQuality.hh:130
double WR
fraction of data frames with correct White Rabbit status (see JSummaryMonitor.cc) ...
Definition: JRunQuality.hh:149
Definition: JRoot.hh:19
int JTriggerNB
number of nano-beacon triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:145
JPrescaler writeL2
pre-scaling of L2 data (0 implies off)
Definition: JRunQuality.hh:132
JEnabled triggerMXShower
enable (1) or disable (0) of L1/L0 mixed trigger
Definition: JRunQuality.hh:128
int JTrigger3DShower
number of 3D-muon triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:142
static const char *const getName()
Table name.
Definition: JRunQuality.hh:37
then echo The file $DIR KM3NeT_00000001_00000000 root already please rename or remove it first
JPrescaler writeSN
pre-scaling of Supernova data (0 implies off)
Definition: JRunQuality.hh:133
int Acoustics
number of acoustic events (see JAcousticsEventBuilder.cc)
Definition: JRunQuality.hh:155
int run
run number
Definition: JRunQuality.hh:122
std::string name
setup name (see JRunsetups)
Definition: JRunQuality.hh:157
double FIFO
fraction of PMTs with FIFO (almost) full (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:151
int JDAQEvent
number of events
Definition: JRunQuality.hh:140
JEnabled triggerNB
enable (1) or disable (0) of nano-beacon trigger
Definition: JRunQuality.hh:129
double AHRS
number of compass measurements (see software/JCompass/JAHRSMonitor.cc)
Definition: JRunQuality.hh:156
int JDAQTimesliceSN
number of Supernova timeslices
Definition: JRunQuality.hh:138
std::string JPP
Jpp version used to take data (see JPrintMeta.cc)
Definition: JRunQuality.hh:119
void put(const std::string &key, const std::string &value)
Put value at given key.
Definition: JRunQuality.cc:25
double DAQ
fraction of data frames with correct DAQ status (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:148
double livetime_s
livetime of data takig run (as determined from KM3NETDAQ::JDAQSummaryslice data)
Definition: JRunQuality.hh:123
double MEAN_Rate_Hz
mean rate from PMTs with valid data (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:153
then for DETECTOR in Antares KM3NeT
Definition: JMultiPMT.sh:45
int JTrigger3DMuon
number of L1/L0 mixed triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:144
JEnabled trigger3DShower
enable (1) or disable (0) of 3D-shower trigger
Definition: JRunQuality.hh:127
double HRV
fraction of PMTs with high-rate veto (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:150
int JDAQTimesliceL0
number of L0 timeslices
Definition: JRunQuality.hh:135
int JDAQSummaryslice
number of summary slices
Definition: JRunQuality.hh:139
double UTCMin_s
minimal UTC time (from &quot;runs&quot; table)
Definition: JRunQuality.hh:124
std::string GIT
GIT version used to write QA/QC data.
Definition: JRunQuality.hh:118
JPrescaler writeL1
pre-scaling of L1 data (0 implies off)
Definition: JRunQuality.hh:131
ClassDef(JRunQuality, 3)
double UTCMax_s
maximal UTC time (from &quot;runs&quot; table)
Definition: JRunQuality.hh:125
double RMS_Rate_Hz
RMS of rate from PMTs with valid data (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:154
static const char *const getName()
Table name.
int in_sync
number of modules in synchronisation with master clock (see JTurbot.cc)
Definition: JRunQuality.hh:146
std::string UUID
UUID of raw data file.
Definition: JRunQuality.hh:120
Auxiliary data structure for data quality.
Definition: JRunQuality.hh:34
int JDAQTimesliceL2
number of L2 timeslices
Definition: JRunQuality.hh:137
double value
setup identifier (see JRunsetups)
Definition: JRunQuality.hh:158