Jpp  17.2.0
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  * Constructor.
110  *
111  * \param ID detector identifier
112  * \param run run number
113  */
114  JRunQuality(const int ID,
115  const int run) :
116  JRunQuality()
117  {
118  this->detector = ID;
119  this->run = run;
120  }
121 
122  /**
123  * Put value at given key.
124  *
125  * \param key key
126  * \param value value
127  */
128  void put(const std::string& key,
129  const std::string& value);
130 
131 
132  std::string GIT; ///< GIT version used to write QA/QC data
133  std::string JPP; ///< Jpp version used to take data (see JPrintMeta.cc)
134  std::string UUID; ///< UUID of raw data file
135  int detector; ///< detector identifier
136  int run; ///< run number
137  double livetime_s; ///< livetime of data takig run (as determined from KM3NETDAQ::JDAQSummaryslice data)
138  double UTCMin_s; ///< minimal UTC time (from "runs" table)
139  double UTCMax_s; ///< maximal UTC time (from "runs" table)
140  JEnabled trigger3DMuon; ///< enable (1) or disable (0) of 3D-muon trigger
141  JEnabled trigger3DShower; ///< enable (1) or disable (0) of 3D-shower trigger
142  JEnabled triggerMXShower; ///< enable (1) or disable (0) of L1/L0 mixed trigger
143  JEnabled triggerNB; ///< enable (1) or disable (0) of nano-beacon trigger
144  JPrescaler writeL0; ///< pre-scaling of L0 data (0 implies off)
145  JPrescaler writeL1; ///< pre-scaling of L1 data (0 implies off)
146  JPrescaler writeL2; ///< pre-scaling of L2 data (0 implies off)
147  JPrescaler writeSN; ///< pre-scaling of Supernova data (0 implies off)
148  int JDAQTimeslice; ///< number of timeslices (reserved for rejected data)
149  int JDAQTimesliceL0; ///< number of L0 timeslices
150  int JDAQTimesliceL1; ///< number of L1 timeslices
151  int JDAQTimesliceL2; ///< number of L2 timeslices
152  int JDAQTimesliceSN; ///< number of Supernova timeslices
153  int JDAQSummaryslice; ///< number of summary slices
154  int JDAQEvent; ///< number of events
155  int JTriggerReprocessor; ///< number of events following re-triggering of the data (see JTriggerReprocessor.cc)
156  int JTrigger3DShower; ///< number of 3D-muon triggers (see JTriggerMonitor.cc)
157  int JTriggerMXShower; ///< number of 3D-shower triggers (see JTriggerMonitor.cc)
158  int JTrigger3DMuon; ///< number of L1/L0 mixed triggers (see JTriggerMonitor.cc)
159  int JTriggerNB; ///< number of nano-beacon triggers (see JTriggerMonitor.cc)
160  int in_sync; ///< number of modules in synchronisation with master clock (see JTurbot.cc)
161  int out_sync; ///< number of modules out of synchronisation with master clock (see JTurbot.cc)
162  double DAQ; ///< fraction of data frames with correct DAQ status (see JSummaryMonitor.cc)
163  double WR; ///< fraction of data frames with correct White Rabbit status (see JSummaryMonitor.cc)
164  double HRV; ///< fraction of PMTs with high-rate veto (see JSummaryMonitor.cc)
165  double FIFO; ///< fraction of PMTs with FIFO (almost) full (see JSummaryMonitor.cc)
166  double PMTs; ///< number of PMTs with valid data (see JSummaryMonitor.cc)
167  double MEAN_Rate_Hz; ///< mean rate from PMTs with valid data (see JSummaryMonitor.cc)
168  double RMS_Rate_Hz; ///< RMS of rate from PMTs with valid data (see JSummaryMonitor.cc)
169  int Acoustics; ///< number of acoustic events (see JAcousticsEventBuilder.cc)
170  double AHRS; ///< number of compass measurements (see software/JCompass/JAHRSMonitor.cc)
171  std::string name; ///< setup name (see JRunsetups)
172  double value; ///< setup identifier (see JRunsetups)
173 
174  ClassDef(JRunQuality, 3);
175  };
176 
177 
178  /**
179  * Less-than operator.
180  *
181  * \param first first run quality
182  * \param second second run quality
183  * \return true if first run quality less than second; else false
184  */
185  inline bool operator<(const JRunQuality& first,
186  const JRunQuality& second)
187  {
188  if (first.detector == second.detector)
189  return first.run < second.run;
190  else
191  return first.detector < second.detector;
192  }
193 }
194 
195 #endif
int JDAQTimeslice
number of timeslices (reserved for rejected data)
Definition: JRunQuality.hh:148
int out_sync
number of modules out of synchronisation with master clock (see JTurbot.cc)
Definition: JRunQuality.hh:161
JEnabled trigger3DMuon
enable (1) or disable (0) of 3D-muon trigger
Definition: JRunQuality.hh:140
int JDAQTimesliceL1
number of L1 timeslices
Definition: JRunQuality.hh:150
int detector
detector identifier
Definition: JRunQuality.hh:135
double PMTs
number of PMTs with valid data (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:166
bool operator<(const Head &first, const Head &second)
Less than operator.
Definition: JHead.hh:1741
int JTriggerMXShower
number of 3D-shower triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:157
int JTriggerReprocessor
number of events following re-triggering of the data (see JTriggerReprocessor.cc) ...
Definition: JRunQuality.hh:155
JPrescaler writeL0
pre-scaling of L0 data (0 implies off)
Definition: JRunQuality.hh:144
double WR
fraction of data frames with correct White Rabbit status (see JSummaryMonitor.cc) ...
Definition: JRunQuality.hh:163
Definition: JRoot.hh:19
int JTriggerNB
number of nano-beacon triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:159
JPrescaler writeL2
pre-scaling of L2 data (0 implies off)
Definition: JRunQuality.hh:146
JEnabled triggerMXShower
enable (1) or disable (0) of L1/L0 mixed trigger
Definition: JRunQuality.hh:142
int JTrigger3DShower
number of 3D-muon triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:156
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:147
int Acoustics
number of acoustic events (see JAcousticsEventBuilder.cc)
Definition: JRunQuality.hh:169
int run
run number
Definition: JRunQuality.hh:136
std::string name
setup name (see JRunsetups)
Definition: JRunQuality.hh:171
double FIFO
fraction of PMTs with FIFO (almost) full (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:165
then echo Variable JPP_DIR undefined exit fi source $JPP_DIR setenv sh $JPP_DIR &dev null set_variable DETECTOR $JPP_DATA km3net_reference detx set_variable NUMBER_OF_STRINGS set_variable ID if do_usage *then usage $script[detector file[variant[identifier]]] fi case set_variable ID
Definition: JDetector.sh:24
int JDAQEvent
number of events
Definition: JRunQuality.hh:154
JEnabled triggerNB
enable (1) or disable (0) of nano-beacon trigger
Definition: JRunQuality.hh:143
double AHRS
number of compass measurements (see software/JCompass/JAHRSMonitor.cc)
Definition: JRunQuality.hh:170
int JDAQTimesliceSN
number of Supernova timeslices
Definition: JRunQuality.hh:152
std::string JPP
Jpp version used to take data (see JPrintMeta.cc)
Definition: JRunQuality.hh:133
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:162
JRunQuality(const int ID, const int run)
Constructor.
Definition: JRunQuality.hh:114
double livetime_s
livetime of data takig run (as determined from KM3NETDAQ::JDAQSummaryslice data)
Definition: JRunQuality.hh:137
double MEAN_Rate_Hz
mean rate from PMTs with valid data (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:167
then for DETECTOR in Antares KM3NeT
Definition: JMultiPMT.sh:45
int JTrigger3DMuon
number of L1/L0 mixed triggers (see JTriggerMonitor.cc)
Definition: JRunQuality.hh:158
JEnabled trigger3DShower
enable (1) or disable (0) of 3D-shower trigger
Definition: JRunQuality.hh:141
double HRV
fraction of PMTs with high-rate veto (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:164
int JDAQTimesliceL0
number of L0 timeslices
Definition: JRunQuality.hh:149
int JDAQSummaryslice
number of summary slices
Definition: JRunQuality.hh:153
double UTCMin_s
minimal UTC time (from &quot;runs&quot; table)
Definition: JRunQuality.hh:138
std::string GIT
GIT version used to write QA/QC data.
Definition: JRunQuality.hh:132
JPrescaler writeL1
pre-scaling of L1 data (0 implies off)
Definition: JRunQuality.hh:145
ClassDef(JRunQuality, 3)
double UTCMax_s
maximal UTC time (from &quot;runs&quot; table)
Definition: JRunQuality.hh:139
double RMS_Rate_Hz
RMS of rate from PMTs with valid data (see JSummaryMonitor.cc)
Definition: JRunQuality.hh:168
static const char *const getName()
Table name.
int in_sync
number of modules in synchronisation with master clock (see JTurbot.cc)
Definition: JRunQuality.hh:160
std::string UUID
UUID of raw data file.
Definition: JRunQuality.hh:134
Auxiliary data structure for data quality.
Definition: JRunQuality.hh:34
int JDAQTimesliceL2
number of L2 timeslices
Definition: JRunQuality.hh:151
double value
setup identifier (see JRunsetups)
Definition: JRunQuality.hh:172