Belle II Software light-2609-luna
EventVariables.cc
1/**************************************************************************
2 * basf2 (Belle II Analysis Software Framework) *
3 * Author: The Belle II Collaboration *
4 * *
5 * See git log for contributors and copyright holders. *
6 * This file is licensed under LGPL-3.0, see LICENSE.md. *
7 **************************************************************************/
8
9// Own header.
10#include <analysis/variables/EventVariables.h>
11
12// include VariableManager
13#include <analysis/VariableManager/Manager.h>
14
15// framework - DataStore
16#include <framework/datastore/StoreArray.h>
17#include <framework/datastore/StoreObjPtr.h>
18#include <framework/dataobjects/EventMetaData.h>
19
20// dataobjects
21#include <analysis/dataobjects/Particle.h>
22#include <analysis/dataobjects/EventKinematics.h>
23
24#include <mdst/dataobjects/MCParticle.h>
25#include <mdst/dataobjects/Track.h>
26#include <mdst/dataobjects/ECLCluster.h>
27#include <mdst/dataobjects/KLMCluster.h>
28#include <mdst/dataobjects/V0.h>
29
30#include <framework/dataobjects/EventT0.h>
31#include <mdst/dataobjects/EventLevelTriggerTimeInfo.h>
32
33// database
34#include <framework/database/DBObjPtr.h>
35#include <mdst/dbobjects/BeamSpot.h>
36
37#include <analysis/utility/PCmsLabTransform.h>
38
39#include <framework/core/Environment.h>
40#include <framework/logging/Logger.h>
41
42
43namespace Belle2 {
48 namespace Variable {
49
50 // Event ------------------------------------------------
51 bool isMC(const Particle*)
52 {
53 return Environment::Instance().isMC();
54 }
55
56 bool isContinuumEvent(const Particle*)
57 {
58 return (isNotContinuumEvent(nullptr) == 1 ? 0 : 1);
59 }
60
61 bool isChargedBEvent(const Particle*)
62 {
63 StoreArray<MCParticle> mcParticles;
64 for (const auto& mcp : mcParticles) {
65 int pdg_no = mcp.getPDG();
66 if (abs(pdg_no) == 521) return 1.0;
67 }
68 return 0.0;
69 }
70
71 double isUnmixedBEvent(const Particle*)
72 {
73 StoreArray<MCParticle> mcParticles;
74 std::vector<int> bPDGs;
75 for (const auto& mcp : mcParticles) {
76 int pdg_no = mcp.getPDG();
77 if (abs(pdg_no) == 511) bPDGs.push_back(pdg_no);
78 }
79 if (bPDGs.size() == 2) {
80 return bPDGs[0] * bPDGs[1] < 0;
81 }
82 return Const::doubleNaN;
83 }
84
85 bool isNotContinuumEvent(const Particle*)
86 {
87 StoreArray<MCParticle> mcParticles;
88 for (const MCParticle& mcp : mcParticles) {
89 int pdg_no = mcp.getPDG();
90 if (mcp.getMother() == nullptr &&
91 ((pdg_no == 553) ||
92 (pdg_no == 100553) ||
93 (pdg_no == 200553) ||
94 (pdg_no == 300553) ||
95 (pdg_no == 9000553) ||
96 (pdg_no == 9010553)))
97 return 1;
98 }
99 return 0;
100 }
101
102 int nMCParticles(const Particle*)
103 {
104 StoreArray<MCParticle> mcps;
105 return mcps.getEntries();
106 }
107
108 int nPrimaryMCParticles(const Particle*)
109 {
110 int n = 0;
111 StoreArray<MCParticle> mcps;
112 for (const auto& mcp : mcps)
113 if (mcp.isPrimaryParticle())
114 n++;
115 return n;
116 }
117
118 int nInitialPrimaryMCParticles(const Particle*)
119 {
120 int n = 0;
121 StoreArray<MCParticle> mcps;
122 for (const auto& mcp : mcps)
123 if (mcp.isInitial() and mcp.isPrimaryParticle())
124 n++;
125 return n;
126 }
127
128 int nVirtualPrimaryMCParticles(const Particle*)
129 {
130 int n = 0;
131 StoreArray<MCParticle> mcps;
132 for (const auto& mcp : mcps)
133 if (mcp.isVirtual() and mcp.isPrimaryParticle())
134 n++;
135 return n;
136 }
137
138 int nTracks(const Particle*)
139 {
140 StoreArray<Track> tracks;
141 return tracks.getEntries();
142 }
143
144 int nV0s(const Particle*)
145 {
146 StoreArray<V0> v0s;
147 return v0s.getEntries();
148 }
149
150 int nValidV0s(const Particle*)
151 {
152 StoreArray<V0> v0s;
153
154 int n = 0;
155 for (int i = 0; i < v0s.getEntries(); i++) {
156 const V0* v0 = v0s[i];
157 if (v0->getTrackFitResults().first->getChargeSign() == v0->getTrackFitResults().second->getChargeSign())
158 continue;
159 n++;
160 }
161
162 return n;
163 }
164
165 int nNeutralECLClusters(const Particle*, const std::vector<double>& hypothesis)
166 {
167 if (hypothesis.size() != 1)
168 B2FATAL("Number of arguments of nNeutralECLClusters must be 1.");
169
170 int hypothesis_int = std::lround(hypothesis[0]);
171 if (hypothesis_int < 1 or hypothesis_int > 2) {
172 B2WARNING("nNeutralECLClusters:: Hypothesis must be 1 (nPhotons) or 2 (NeutralHadron)");
173 return 0;
174 }
175
176 StoreArray<ECLCluster> eclClusters;
177 int nClusters = 0;
178 for (int i = 0; i < eclClusters.getEntries(); i++) {
179 auto cluster = eclClusters[i];
180 if (!cluster->isNeutral())
181 continue;
182
183 if ((hypothesis_int == 1 and cluster->hasHypothesis(ECLCluster::EHypothesisBit::c_nPhotons)) or
184 (hypothesis_int == 2 and cluster->hasHypothesis(ECLCluster::EHypothesisBit::c_neutralHadron)))
185 nClusters++;
186 }
187 return nClusters;
188 }
189
190 int nChargeZeroTrackFits(const Particle*)
191 {
192 StoreArray<TrackFitResult> tfrs;
193 int out = 0;
194 for (const auto& t : tfrs)
195 if (t.getChargeSign() == 0) out++;
196 return out;
197 }
198
199 double belleECLEnergy(const Particle*)
200 {
201 StoreArray<ECLCluster> eclClusters;
202 double result = 0;
203 for (int i = 0; i < eclClusters.getEntries(); ++i) {
204 // sum only ECLClusters which have the N1 (n photons) hypothesis
205 if (!eclClusters[i]->hasHypothesis(ECLCluster::EHypothesisBit::c_nPhotons))
206 continue;
207
208 result += eclClusters[i]->getEnergy(ECLCluster::EHypothesisBit::c_nPhotons);
209 }
210 return result;
211 }
212
213 int nKLMClusters(const Particle*)
214 {
215 StoreArray<KLMCluster> klmClusters;
216 return klmClusters.getEntries();
217 }
218
219 int expNum(const Particle*)
220 {
221 StoreObjPtr<EventMetaData> evtMetaData;
222 int exp_no = evtMetaData->getExperiment();
223 return exp_no;
224 }
225
226 int productionIdentifier(const Particle*)
227 {
228 StoreObjPtr<EventMetaData> evtMetaData;
229 int eventProduction = evtMetaData->getProduction();
230 return eventProduction;
231 }
232
233 int evtNum(const Particle*)
234 {
235 StoreObjPtr<EventMetaData> evtMetaData;
236 int evt_no = evtMetaData->getEvent();
237 return evt_no;
238 }
239
240 int runNum(const Particle*)
241 {
242 StoreObjPtr<EventMetaData> evtMetaData;
243 int run_no = evtMetaData->getRun();
244 return run_no;
245 }
246
247 // Beam Energies
248 double getCMSEnergy(const Particle*)
249 {
250 PCmsLabTransform T;
251 return T.getCMSEnergy();
252 }
253
254 double getBeamPx(const Particle*)
255 {
256 PCmsLabTransform T;
257 return (T.getBeamFourMomentum()).Px();
258 }
259
260 double getBeamPy(const Particle*)
261 {
262 PCmsLabTransform T;
263 return (T.getBeamFourMomentum()).Py();
264 }
265
266 double getBeamPz(const Particle*)
267 {
268 PCmsLabTransform T;
269 return (T.getBeamFourMomentum()).Pz();
270 }
271
272 double getBeamE(const Particle*)
273 {
274 PCmsLabTransform T;
275 return (T.getBeamFourMomentum()).E();
276 }
277
278 // get total 4-momentum of all final-state particles in MC
279 static ROOT::Math::PxPyPzEVector getTotalMcFinalStateMomentum()
280 {
281 StoreArray<MCParticle> mcps;
282 ROOT::Math::PxPyPzEVector sum;
283 for (const auto& mcp : mcps) {
284 // only consider primary final-state particle generated by generator
285 if (mcp.isPrimaryParticle() and not(mcp.isInitial() or mcp.isVirtual())) {
286 const MCParticle* mother = mcp.getMother();
287 // only consider particles with no mother or particles whose mother is not initial or virtual
288 if (not mother or not(mother->isPrimaryParticle() and not(mother->isInitial() or mother->isVirtual())))
289 sum += mcp.get4Vector();
290 }
291 }
292 return sum;
293 }
294
295
296 // get 4-momentum of the incoming electron/positron in MC event
297 static ROOT::Math::PxPyPzEVector getMcBeamMomentum(int charge)
298 {
299 StoreArray<MCParticle> mcps;
300 for (const auto& mcp : mcps) {
301 if (mcp.isInitial() && mcp.getPDG() == -charge * 11) {
302 return mcp.get4Vector();
303 }
304 }
305
306 // if no initial electron/positron found
307 return ROOT::Math::PxPyPzEVector(Const::doubleNaN, Const::doubleNaN, Const::doubleNaN, Const::doubleNaN);
308 }
309
310 // get HER/LER 4-momentum based on the calibration payloads
311 static ROOT::Math::PxPyPzEVector getBeamMomentum(int charge)
312 {
313 PCmsLabTransform T;
314 double EbeamCM = T.getCMSEnergy() / 2;
315 double pBeamCM = sqrt(pow(EbeamCM, 2) - pow(Const::electronMass, 2));
316
317 ROOT::Math::PxPyPzEVector pCM(0, 0, -charge * pBeamCM, EbeamCM);
318
319 return T.cmsToLab(pCM);
320 }
321
322
323 double getMcPxHER(const Particle*) {return getMcBeamMomentum(-1).Px();}
324 double getMcPyHER(const Particle*) {return getMcBeamMomentum(-1).Py();}
325 double getMcPzHER(const Particle*) {return getMcBeamMomentum(-1).Pz();}
326
327 double getMcPxLER(const Particle*) {return getMcBeamMomentum(+1).Px();}
328 double getMcPyLER(const Particle*) {return getMcBeamMomentum(+1).Py();}
329 double getMcPzLER(const Particle*) {return getMcBeamMomentum(+1).Pz();}
330
331
332 double getPxHER(const Particle*) {return getBeamMomentum(-1).Px();}
333 double getPyHER(const Particle*) {return getBeamMomentum(-1).Py();}
334 double getPzHER(const Particle*) {return getBeamMomentum(-1).Pz();}
335
336 double getPxLER(const Particle*) {return getBeamMomentum(+1).Px();}
337 double getPyLER(const Particle*) {return getBeamMomentum(+1).Py();}
338 double getPzLER(const Particle*) {return getBeamMomentum(+1).Pz();}
339
340
341 double getCMSEnergyMC(const Particle*)
342 {
343 StoreArray<MCParticle> mcps;
344 if (!mcps) {
345 return Const::doubleNaN;
346 } else return getTotalMcFinalStateMomentum().M();
347 }
348
349 double getTotalEnergyMC(const Particle*)
350 {
351 StoreArray<MCParticle> mcps;
352 if (!mcps) {
353 return Const::doubleNaN;
354 } else return getTotalMcFinalStateMomentum().E();
355 }
356
357 double getGenIPX(const Particle*)
358 {
359 // generated IP corresponds to the generated vertex of the
360 // first not-initial and not-virtual MCParticle
361 StoreArray<MCParticle> mcps;
362 for (const auto& mcp : mcps)
363 if (not mcp.isInitial() and not mcp.isVirtual() and mcp.isPrimaryParticle())
364 return mcp.getVertex().X();
365 return Const::doubleNaN;
366 }
367
368 double getGenIPY(const Particle*)
369 {
370 StoreArray<MCParticle> mcps;
371 for (const auto& mcp : mcps)
372 if (not mcp.isInitial() and not mcp.isVirtual() and mcp.isPrimaryParticle())
373 return mcp.getVertex().Y();
374 return Const::doubleNaN;
375 }
376
377 double getGenIPZ(const Particle*)
378 {
379 StoreArray<MCParticle> mcps;
380 for (const auto& mcp : mcps)
381 if (not mcp.isInitial() and not mcp.isVirtual() and mcp.isPrimaryParticle())
382 return mcp.getVertex().Z();
383 return Const::doubleNaN;
384 }
385
386 double getIPX(const Particle*)
387 {
388 static DBObjPtr<BeamSpot> beamSpotDB;
389 if (!beamSpotDB.isValid())
390 return Const::doubleNaN;
391 return (beamSpotDB->getIPPosition()).X();
392 }
393
394 double getIPY(const Particle*)
395 {
396 static DBObjPtr<BeamSpot> beamSpotDB;
397 if (!beamSpotDB.isValid())
398 return Const::doubleNaN;
399 return (beamSpotDB->getIPPosition()).Y();
400 }
401
402 double getIPZ(const Particle*)
403 {
404 static DBObjPtr<BeamSpot> beamSpotDB;
405 if (!beamSpotDB.isValid())
406 return Const::doubleNaN;
407 return (beamSpotDB->getIPPosition()).Z();
408 }
409
410 double ipCovMatrixElement(const Particle*, const std::vector<double>& element)
411 {
412 int elementI = std::lround(element[0]);
413 int elementJ = std::lround(element[1]);
414
415 bool isOutOfRange = false;
416 if (elementI < 0 || elementI > 2) {
417 B2WARNING("Requested IP covariance matrix element is out of boundaries [0 - 2]:" << LogVar("i", elementI));
418 isOutOfRange = true;
419 }
420 if (elementJ < 0 || elementJ > 2) {
421 B2WARNING("Requested IP covariance matrix element is out of boundaries [0 - 2]:" << LogVar("j", elementJ));
422 isOutOfRange = true;
423 }
424
425 if (isOutOfRange) return Const::doubleNaN;
426
427 static DBObjPtr<BeamSpot> beamSpotDB;
428 if (!beamSpotDB.isValid())
429 return Const::doubleNaN;
430 return beamSpotDB->getCovVertex()(elementI, elementJ);
431 }
432
433 // Event kinematics -> missing momentum in lab and CMS, missing energy and mass2, visible energy
434 double missingMomentumOfEvent(const Particle*)
435 {
436 StoreObjPtr<EventKinematics> evtShape;
437 if (!evtShape) {
438 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
439 return Const::doubleNaN;
440 }
441 double missing = evtShape->getMissingMomentum().R();
442 return missing;
443 }
444
445 double missingMomentumOfEvent_Px(const Particle*)
446 {
447 StoreObjPtr<EventKinematics> evtShape;
448 if (!evtShape) {
449 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
450 return Const::doubleNaN;
451 }
452 double missing = evtShape->getMissingMomentum().X();
453 return missing;
454 }
455
456 double missingMomentumOfEvent_Py(const Particle*)
457 {
458 StoreObjPtr<EventKinematics> evtShape;
459 if (!evtShape) {
460 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
461 return Const::doubleNaN;
462 }
463 double missing = evtShape->getMissingMomentum().Y();
464 return missing;
465 }
466
467 double missingMomentumOfEvent_Pz(const Particle*)
468 {
469 StoreObjPtr<EventKinematics> evtShape;
470 if (!evtShape) {
471 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
472 return Const::doubleNaN;
473 }
474 double missing = evtShape->getMissingMomentum().Z();
475 return missing;
476 }
477
478 double missingMomentumOfEvent_theta(const Particle*)
479 {
480 StoreObjPtr<EventKinematics> evtShape;
481 if (!evtShape) {
482 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
483 return Const::doubleNaN;
484 }
485 double missing = evtShape->getMissingMomentum().Theta();
486 return missing;
487 }
488
489 double missingMomentumOfEventCMS(const Particle*)
490 {
491 StoreObjPtr<EventKinematics> evtShape;
492 if (!evtShape) {
493 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
494 return Const::doubleNaN;
495 }
496 double missing = evtShape->getMissingMomentumCMS().R();
497 return missing;
498 }
499
500 double genMissingMomentumOfEventCMS(const Particle*)
501 {
502 StoreObjPtr<EventKinematics> evtShape("EventKinematicsFromMC");
503 if (!evtShape) {
504 B2WARNING("Cannot find missing momentum information from MC, did you forget to use the buildEventKinematicsFromMC method?");
505 return Const::doubleNaN;
506 }
507 double missing = evtShape->getMissingMomentumCMS().R();
508 return missing;
509 }
510
511 double missingMomentumOfEventCMS_Px(const Particle*)
512 {
513 StoreObjPtr<EventKinematics> evtShape;
514 if (!evtShape) {
515 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
516 return Const::doubleNaN;
517 }
518 double missing = evtShape->getMissingMomentumCMS().X();
519 return missing;
520 }
521
522 double missingMomentumOfEventCMS_Py(const Particle*)
523 {
524 StoreObjPtr<EventKinematics> evtShape;
525 if (!evtShape) {
526 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
527 return Const::doubleNaN;
528 }
529 double missing = evtShape->getMissingMomentumCMS().Y();
530 return missing;
531 }
532
533 double missingMomentumOfEventCMS_Pz(const Particle*)
534 {
535 StoreObjPtr<EventKinematics> evtShape;
536 if (!evtShape) {
537 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
538 return Const::doubleNaN;
539 }
540 double missing = evtShape->getMissingMomentumCMS().Z();
541 return missing;
542 }
543
544 double missingMomentumOfEventCMS_theta(const Particle*)
545 {
546 StoreObjPtr<EventKinematics> evtShape;
547 if (!evtShape) {
548 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
549 return Const::doubleNaN;
550 }
551 double theta = evtShape->getMissingMomentumCMS().Theta();
552 return theta;
553 }
554
555 double missingEnergyOfEventCMS(const Particle*)
556 {
557 StoreObjPtr<EventKinematics> evtShape;
558 if (!evtShape) {
559 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
560 return Const::doubleNaN;
561 }
562 double missing = evtShape->getMissingEnergyCMS();
563 return missing;
564 }
565
566 double genMissingEnergyOfEventCMS(const Particle*)
567 {
568 StoreObjPtr<EventKinematics> evtShape("EventKinematicsFromMC");
569 if (!evtShape) {
570 B2WARNING("Cannot find missing momentum information from MC, did you forget to use the buildEventKinematicsFromMC method?");
571 return Const::doubleNaN;
572 }
573 double missing = evtShape->getMissingEnergyCMS();
574 return missing;
575 }
576
577
578 double missingMass2OfEvent(const Particle*)
579 {
580 StoreObjPtr<EventKinematics> evtShape;
581 if (!evtShape) {
582 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
583 return Const::doubleNaN;
584 }
585 double missing = evtShape->getMissingMass2();
586 return missing;
587 }
588
589 double genMissingMass2OfEvent(const Particle*)
590 {
591 StoreObjPtr<EventKinematics> evtShape("EventKinematicsFromMC");
592 if (!evtShape) {
593 B2WARNING("Cannot find missing momentum information from MC, did you forget to use the buildEventKinematicsFromMC method?");
594 return Const::doubleNaN;
595 }
596 double missing = evtShape->getMissingMass2();
597 return missing;
598 }
599
600 double visibleEnergyOfEventCMS(const Particle*)
601 {
602 StoreObjPtr<EventKinematics> evtShape;
603 if (!evtShape) {
604 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
605 return Const::doubleNaN;
606 }
607 double visible = evtShape->getVisibleEnergyCMS();
608 return visible;
609 }
610
611 double genVisibleEnergyOfEventCMS(const Particle*)
612 {
613 StoreObjPtr<EventKinematics> evtShape("EventKinematicsFromMC");
614 if (!evtShape) {
615 B2WARNING("Cannot find missing momentum information from MC, did you forget to use the buildEventKinematicsFromMC method?");
616 return Const::doubleNaN;
617 }
618 double visible = evtShape->getVisibleEnergyCMS();
619 return visible;
620 }
621
622
623 double totalPhotonsEnergyOfEvent(const Particle*)
624 {
625 StoreObjPtr<EventKinematics> evtShape;
626 if (!evtShape) {
627 B2WARNING("Cannot find missing momentum information, did you forget to use the buildEventKinematics method?");
628 return Const::doubleNaN;
629 }
630 double energyOfPhotons = evtShape->getTotalPhotonsEnergy();
631 return energyOfPhotons;
632 }
633
634 double genTotalPhotonsEnergyOfEvent(const Particle*)
635 {
636 StoreObjPtr<EventKinematics> evtShape("EventKinematicsFromMC");
637 if (!evtShape) {
638 B2WARNING("Cannot find missing momentum information from MC, did you forget to use the buildEventKinematicsFromMC method?");
639 return Const::doubleNaN;
640 }
641 double energyOfPhotons = evtShape->getTotalPhotonsEnergy();
642 return energyOfPhotons;
643 }
644
645 double eventYearMonthDay(const Particle*)
646 {
647 StoreObjPtr<EventMetaData> evtMetaData;
648 if (!evtMetaData) {
649 return Const::doubleNaN;
650 }
651 std::time_t rawtime = trunc(evtMetaData->getTime() / 1e9);
652 const auto* tt = std::gmtime(&rawtime); // GMT
653 int y = tt->tm_year + 1900; // years since 1900
654 int m = tt->tm_mon + 1; // months since January
655 int d = tt->tm_mday; // day of the month
656 return (y * 1e4) + (m * 1e2) + d;
657 }
658
659 double eventYear(const Particle*)
660 {
661 StoreObjPtr<EventMetaData> evtMetaData;
662 if (!evtMetaData) {
663 return Const::doubleNaN;
664 }
665 std::time_t rawtime = trunc(evtMetaData->getTime() / 1e9);
666 const auto* tt = std::gmtime(&rawtime);
667 return tt->tm_year + 1900;
668 }
669
670 double eventTimeSeconds(const Particle*)
671 {
672 StoreObjPtr<EventMetaData> evtMetaData;
673
674 if (!evtMetaData) {
675 return Const::doubleNaN;
676 }
677 double evtTime = trunc(evtMetaData->getTime() / 1e9);
678
679 return evtTime;
680 }
681
682 double eventTimeSecondsFractionRemainder(const Particle*)
683 {
684 StoreObjPtr<EventMetaData> evtMetaData;
685
686 if (!evtMetaData) {
687 return Const::doubleNaN;
688 }
689 double evtTime = trunc(evtMetaData->getTime() / 1e9);
690
691 double evtTimeFrac = (evtMetaData->getTime() - evtTime * 1e9) / 1e9;
692
693 return evtTimeFrac;
694 }
695
696 double timeSincePrevTriggerClockTicks(const Particle*)
697 {
698 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
699
700 // Check if the pointer is valid
701 if (!TTDInfo.isValid()) {
702 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
703 return Const::doubleNaN;
704 }
705
706 // And check if the stored data is valid
707 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
708 // cppcheck-suppress knownConditionTrueFalse
709 if (TTDInfo->isValid()) {
710 return TTDInfo->getTimeSincePrevTrigger();
711 } else {
712 return Const::doubleNaN;
713 }
714 }
715
716 double timeSincePrevTriggerMicroSeconds(const Particle*)
717 {
718 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
719
720 // Check if the pointer is valid
721 if (!TTDInfo.isValid()) {
722 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
723 return Const::doubleNaN;
724 }
725
726 // And check if the stored data is valid
727 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
728 // cppcheck-suppress knownConditionTrueFalse
729 if (TTDInfo->isValid()) {
730 return TTDInfo->getTimeSincePrevTriggerInMicroSeconds();
731 } else {
732 return Const::doubleNaN;
733 }
734 }
735
736 double triggeredBunchNumberTTD(const Particle*)
737 {
738 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
739
740 // Check if the pointer is valid
741 if (!TTDInfo.isValid()) {
742 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
743 return Const::doubleNaN;
744 }
745
746 // And check if the stored data is valid
747 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
748 // cppcheck-suppress knownConditionTrueFalse
749 if (TTDInfo->isValid()) {
750 return TTDInfo->getBunchNumber();
751 } else {
752 return Const::doubleNaN;
753 }
754 }
755
756 double triggeredBunchNumber(const Particle*)
757 {
758 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
759
760 // Check if the pointer is valid
761 if (!TTDInfo.isValid()) {
762 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
763 return Const::doubleNaN;
764 }
765
766 // And check if the stored data is valid
767 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
768 // cppcheck-suppress knownConditionTrueFalse
769 if (TTDInfo->isValid()) {
770 return TTDInfo->getTriggeredBunchNumberGlobal();
771 } else {
772 return Const::doubleNaN;
773 }
774 }
775
776 double hasRecentInjection(const Particle*)
777 {
778 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
779
780 // Check if the pointer is valid
781 if (!TTDInfo.isValid()) {
782 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
783 return Const::doubleNaN;
784 }
785
786 // And check if the stored data is valid
787 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
788 // cppcheck-suppress knownConditionTrueFalse
789 if (TTDInfo->isValid()) {
790 return TTDInfo->hasInjection();
791 } else {
792 return Const::doubleNaN;
793 }
794 }
795
796 double timeSinceLastInjectionSignalClockTicks(const Particle*)
797 {
798 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
799
800 // Check if the pointer is valid
801 if (!TTDInfo.isValid()) {
802 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
803 return Const::doubleNaN;
804 }
805
806 // And check if the stored data is valid and if an injection happened recently
807 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
808 // cppcheck-suppress knownConditionTrueFalse
809 if (TTDInfo->isValid() && TTDInfo->hasInjection()) {
810 return TTDInfo->getTimeSinceLastInjection();
811 } else {
812 return Const::doubleNaN;
813 }
814 }
815
816 double timeSinceLastInjectionSignalMicroSeconds(const Particle*)
817 {
818 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
819
820 // Check if the pointer is valid
821 if (!TTDInfo.isValid()) {
822 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
823 return Const::doubleNaN;
824 }
825
826 // And check if the stored data is valid and if an injection happened recently
827 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
828 // cppcheck-suppress knownConditionTrueFalse
829 if (TTDInfo->isValid() && TTDInfo->hasInjection()) {
830 return TTDInfo->getTimeSinceLastInjectionInMicroSeconds();
831 } else {
832 return Const::doubleNaN;
833 }
834 }
835
836 double timeSinceLastInjectionClockTicks(const Particle*)
837 {
838 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
839
840 // Check if the pointer is valid
841 if (!TTDInfo.isValid()) {
842 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
843 return Const::doubleNaN;
844 }
845
846 // And check if the stored data is valid and if an injection happened recently
847 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
848 // cppcheck-suppress knownConditionTrueFalse
849 if (TTDInfo->isValid() && TTDInfo->hasInjection()) {
850 return TTDInfo->getTimeSinceInjectedBunch();
851 } else {
852 return Const::doubleNaN;
853 }
854 }
855
856 double timeSinceLastInjectionMicroSeconds(const Particle*)
857 {
858 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
859
860 // Check if the pointer is valid
861 if (!TTDInfo.isValid()) {
862 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
863 return Const::doubleNaN;
864 }
865
866 // And check if the stored data is valid and if an injection happened recently
867 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
868 // cppcheck-suppress knownConditionTrueFalse
869 if (TTDInfo->isValid() && TTDInfo->hasInjection()) {
870 return TTDInfo->getTimeSinceInjectedBunchInMicroSeconds();
871 } else {
872 return Const::doubleNaN;
873 }
874 }
875
876 double injectionInHER(const Particle*)
877 {
878 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
879
880 // Check if the pointer is valid
881 if (!TTDInfo.isValid()) {
882 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
883 return Const::doubleNaN;
884 }
885
886 // And check if the stored data is valid and if an injection happened recently
887 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
888 // cppcheck-suppress knownConditionTrueFalse
889 if (TTDInfo->isValid() && TTDInfo->hasInjection()) {
890 return TTDInfo->isHER();
891 } else {
892 return Const::doubleNaN;
893 }
894 }
895
896 double revolutionCounter2(const Particle*)
897 {
898 StoreObjPtr<EventLevelTriggerTimeInfo> TTDInfo;
899
900 // Check if the pointer is valid
901 if (!TTDInfo.isValid()) {
902 B2WARNING("StoreObjPtr<EventLevelTriggerTimeInfo> does not exist, are you running over data reconstructed with release-05 or earlier?");
903 return Const::doubleNaN;
904 }
905
906 // And check if the stored data is valid
907 // (a different isValid() than StoreObjPtr's, which cppcheck conflates)
908 // cppcheck-suppress knownConditionTrueFalse
909 if (TTDInfo->isValid()) {
910 return TTDInfo->isRevo2();
911 } else {
912 return Const::doubleNaN;
913 }
914 }
915
916 bool eventT0CalculatedWithSVDInfo(const Particle*)
917 {
918 StoreObjPtr<EventLevelTriggerTimeInfo> triggerTimeInfo;
919 if (!triggerTimeInfo.isValid()) {
920 return false;
921 }
922 return triggerTimeInfo->hasEventT0SourceFromSVD();
923 }
924
925 bool eventT0CalculatedWithCDCInfo(const Particle*)
926 {
927 StoreObjPtr<EventLevelTriggerTimeInfo> triggerTimeInfo;
928 if (!triggerTimeInfo.isValid()) {
929 return false;
930 }
931 return triggerTimeInfo->hasEventT0SourceFromCDC();
932 }
933
934 bool eventT0CalculatedWithECLInfo(const Particle*)
935 {
936 StoreObjPtr<EventLevelTriggerTimeInfo> triggerTimeInfo;
937 if (!triggerTimeInfo.isValid()) {
938 return false;
939 }
940 return triggerTimeInfo->hasEventT0SourceFromECL();
941 }
942
943
944 VARIABLE_GROUP("Event");
945
946 REGISTER_VARIABLE("isMC", isMC,
947 "[Eventbased] Returns 1 if current basf2 process is running over simulated (Monte-Carlo) dataset and 0 in case of real experimental data.");
948 REGISTER_VARIABLE("isContinuumEvent", isContinuumEvent,
949 "[Eventbased] Returns 1.0 if event doesn't contain a :math:`\\Upsilon(4S)` particle on generator level, 0.0 otherwise.");
950 REGISTER_VARIABLE("isNotContinuumEvent", isNotContinuumEvent,
951 "[Eventbased] Returns 1.0 if event does contain an :math:`\\Upsilon(4S)` particle on generator level and therefore is not a continuum event, 0.0 otherwise.");
952
953 REGISTER_VARIABLE("isChargedBEvent", isChargedBEvent,
954 "[Eventbased] Returns 1.0 if event contains a charged B-meson on generator level.");
955 REGISTER_VARIABLE("isUnmixedBEvent", isUnmixedBEvent,
956 R"DOC([Eventbased] Returns 1.0 if the event contains opposite flavor neutral B-mesons on generator level,
9570.0 in case of same flavor B-mesons and NaN if the event has no generated neutral B.)DOC");
958
959 REGISTER_VARIABLE("nTracks", nTracks, R"DOC(
960[Eventbased] Returns the total number of tracks (unfiltered) in the event.
961
962.. warning:: This variable is exceedingly background-dependent and should not really be used in any selections (other than perhaps for monitoring purposes).
963.. seealso:: :b2:var:`nCleanedTracks` for a more useful variable for use in selections.
964)DOC");
965 REGISTER_VARIABLE("nChargeZeroTrackFits", nChargeZeroTrackFits, R"DOC(
966[Eventbased] Returns number of track fits with zero charge.
967
968.. note::
969 Sometimes, track fits can have zero charge, if background or non IP originating tracks, for example, are fit from the IP.
970 These tracks are excluded from particle lists, but a large amount of charge zero
971 fits may indicate problems with whole event constraints
972 or abnominally high beam backgrounds and/or noisy events.
973)DOC");
974
975 REGISTER_VARIABLE("belleECLEnergy", belleECLEnergy, R"DOC(
976[Eventbased][Legacy] Returns total energy in ECL in the event as used in Belle 1 analyses.
977
978.. warning::
979 For Belle II use cases use either ``totalEnergyOfParticlesInList(gamma:all)``,
980 or (probably better) fill a photon list with some minimal cleanup cuts and use that instead:
981
982 .. code-block:: python
983
984 from variables import variables as vm
985 fillParticleList("gamma:cleaned", "E > 0.05 and isFromECL==1", path=path)
986 fillParticleList("e+:cleaned", "clusterE > 0.05", path=path)
987 vm.addAlias("myNeutralECLEnergy", "totalEnergyOfParticlesInList(gamma:cleaned)")
988 vm.addAlias("myChargedECLEnergy", "totalEnergyOfParticlesInList(e+:cleaned)")
989 vm.addAlias("myECLEnergy", "formula(myNeutralECLEnergy+myChargedECLEnergy)")
990
991)DOC","GeV");
992 REGISTER_VARIABLE("nKLMClusters", nKLMClusters,
993 "[Eventbased] Returns number of KLM clusters in the event.");
994 REGISTER_VARIABLE("nNeutralECLClusters(hypothesis)", nNeutralECLClusters,
995 "[Eventbased] Returns number of neutral ECL clusters with a given hypothesis, 1:nPhotons, 2:NeutralHadron.");
996 REGISTER_VARIABLE("nV0s", nV0s,
997 "[Eventbased] Returns number of V0s in the event.");
998 REGISTER_VARIABLE("nValidV0s", nValidV0s,
999 "[Eventbased] Returns number of V0s consisting of pair of tracks with opposite charges.");
1000 REGISTER_VARIABLE("nMCParticles", nMCParticles,
1001 "[Eventbased] Returns number of MCParticles in the event.");
1002 REGISTER_VARIABLE("nPrimaryMCParticles", nPrimaryMCParticles,
1003 "[Eventbased] Returns number of primary MCParticles in the event.");
1004 REGISTER_VARIABLE("nInitialPrimaryMCParticles", nInitialPrimaryMCParticles,
1005 "[Eventbased] Returns number of initial primary MCParticles in the event.");
1006 REGISTER_VARIABLE("nVirtualPrimaryMCParticles", nVirtualPrimaryMCParticles,
1007 "[Eventbased] Returns number of virtual primary MCParticles in the event.");
1008
1009 REGISTER_VARIABLE("expNum", expNum, "[Eventbased] Returns the experiment number.");
1010 REGISTER_VARIABLE("evtNum", evtNum, "[Eventbased] Returns the event number.");
1011 REGISTER_VARIABLE("runNum", runNum, "[Eventbased] Returns the run number.");
1012 REGISTER_VARIABLE("productionIdentifier", productionIdentifier, R"DOC(
1013[Eventbased] Production identifier.
1014Uniquely identifies an MC sample by the (grid-jargon) production ID.
1015This is useful when analysing large MC samples split between more than one production or combining different MC samples (e.g. combining all continuum samples).
1016In such cases the event numbers are sequential *only within a production*, so experiment/run/event will restart with every new sample analysed.
1017
1018.. tip:: Experiment/run/event/production is unique for all MC samples. Experiment/run/event is unique for data.
1019
1020.. seealso:: `Where can I rely on uniqueness of the ['__experiment__', '__run__', '__event__', '__candidate__'] combination? <https://questions.belle2.org/question/9704>`__
1021)DOC");
1022
1023 REGISTER_VARIABLE("Ecms", getCMSEnergy, "[Eventbased] Returns center-of-mass energy.\n\n", "GeV");
1024 REGISTER_VARIABLE("beamE", getBeamE, "[Eventbased] Returns total beam energy in the laboratory frame.\n\n","GeV");
1025 REGISTER_VARIABLE("beamPx", getBeamPx, "[Eventbased] Returns x component of total beam momentum in the laboratory frame.\n\n","GeV/c");
1026 REGISTER_VARIABLE("beamPy", getBeamPy, "[Eventbased] Returns y component of total beam momentum in the laboratory frame.\n\n","GeV/c");
1027 REGISTER_VARIABLE("beamPz", getBeamPz, "[Eventbased] Returns z component of total beam momentum in the laboratory frame.\n\n","GeV/c");
1028 REGISTER_VARIABLE("EcmsMC", getCMSEnergyMC, "[Eventbased] Truth value of sqrt(s)\n\n", "GeV");
1029 REGISTER_VARIABLE("totalEnergyMC", getTotalEnergyMC, "[Eventbased] Truth value of sum of energies of all the generated particles\n\n", "GeV");
1030
1031
1032 REGISTER_VARIABLE("PxHER", getPxHER, "[Eventbased] Returns x component of the electron beam momentum in the laboratory frame.\n\n","GeV/c");
1033 REGISTER_VARIABLE("PyHER", getPyHER, "[Eventbased] Returns y component of the electron beam momentum in the laboratory frame.\n\n","GeV/c");
1034 REGISTER_VARIABLE("PzHER", getPzHER, "[Eventbased] Returns z component of the electron beam momentum in the laboratory frame.\n\n","GeV/c");
1035 REGISTER_VARIABLE("PxLER", getPxLER, "[Eventbased] Returns x component of the positron beam momentum in the laboratory frame.\n\n","GeV/c");
1036 REGISTER_VARIABLE("PyLER", getPyLER, "[Eventbased] Returns y component of the positron beam momentum in the laboratory frame.\n\n","GeV/c");
1037 REGISTER_VARIABLE("PzLER", getPzLER, "[Eventbased] Returns z component of the positron beam momentum in the laboratory frame.\n\n","GeV/c");
1038
1039 REGISTER_VARIABLE("mcPxHER", getMcPxHER, "[Eventbased] Returns truth value of the x component of the incoming electron momentum in the laboratory frame.\n\n","GeV/c");
1040 REGISTER_VARIABLE("mcPyHER", getMcPyHER, "[Eventbased] Returns truth value of the y component of the incoming electron momentum in the laboratory frame.\n\n","GeV/c");
1041 REGISTER_VARIABLE("mcPzHER", getMcPzHER, "[Eventbased] Returns truth value of the z component of the incoming electron momentum in the laboratory frame.\n\n","GeV/c");
1042 REGISTER_VARIABLE("mcPxLER", getMcPxLER, "[Eventbased] Returns truth value of the x component of the incoming positron momentum in the laboratory frame.\n\n","GeV/c");
1043 REGISTER_VARIABLE("mcPyLER", getMcPyLER, "[Eventbased] Returns truth value of the y component of the incoming positron momentum in the laboratory frame.\n\n","GeV/c");
1044 REGISTER_VARIABLE("mcPzLER", getMcPzLER, "[Eventbased] Returns truth value of the z component of the incoming positron momentum in the laboratory frame.\n\n","GeV/c");
1045
1046
1047
1048 REGISTER_VARIABLE("IPX", getIPX, R"DOC(
1049[Eventbased] Returns x coordinate of the measured interaction point.
1050
1051.. note:: For old data and uncalibrated MC files this will return 0.0.
1052
1053.. note:: You might hear tracking and calibration people refer to this as the ``BeamSpot``.
1054
1055)DOC","cm");
1056 REGISTER_VARIABLE("IPY", getIPY, "[Eventbased] Returns y coordinate of the measured interaction point.\n\n","cm");
1057 REGISTER_VARIABLE("IPZ", getIPZ, "[Eventbased] Returns z coordinate of the measured interaction point.\n\n","cm");
1058 REGISTER_VARIABLE("IPCov(i,j)", ipCovMatrixElement, "[Eventbased] Returns (i,j)-th element of the covariance matrix of the measured interaction point.\n\n",":math:`\\text{cm}^2`");
1059
1060 REGISTER_VARIABLE("genIPX", getGenIPX, R"DOC(
1061[Eventbased] Returns x coordinate of the interaction point used for the underlying **MC generation**.
1062Returns NaN for data.
1063
1064.. note:: This is normally smeared from 0.0
1065
1066)DOC","cm");
1067 REGISTER_VARIABLE("genIPY", getGenIPY, "[Eventbased] Returns y coordinate of the interaction point used for the underlying **MC generation**. Returns NaN for data.\n\n","cm");
1068 REGISTER_VARIABLE("genIPZ", getGenIPZ, "[Eventbased] Returns z coordinate of the interaction point used for the underlying **MC generation**. Returns NaN for data.\n\n","cm");
1069
1070 REGISTER_VARIABLE("date", eventYearMonthDay, R"DOC(
1071[Eventbased] Returns the date when the event was recorded, a number of the form YYYYMMDD (in UTC).
1072
1073.. seealso:: :b2:var:`year`, :b2:var:`eventTimeSeconds`, :b2:var:`eventTimeSecondsFractionRemainder`, provided for convenience.
1074)DOC");
1075 REGISTER_VARIABLE("year", eventYear, R"DOC(
1076[Eventbased] Returns the year when the event was recorded (in UTC).
1077
1078.. tip::
1079 For more precise event time, see :b2:var:`eventTimeSeconds` and :b2:var:`eventTimeSecondsFractionRemainder`.
1080)DOC");
1081 REGISTER_VARIABLE("eventTimeSeconds", eventTimeSeconds,
1082 "[Eventbased] Time of the event (truncated down) since 1970/1/1 (Unix epoch).\n\n","s");
1083 REGISTER_VARIABLE("eventTimeSecondsFractionRemainder", eventTimeSecondsFractionRemainder, R"DOC(
1084[Eventbased] Remainder of the event time.
1085
1086.. tip:: Use eventTimeSeconds + eventTimeSecondsFractionRemainder to get the total event time in seconds.
1087
1088)DOC","s");
1089
1090 REGISTER_VARIABLE("timeSincePrevTriggerClockTicks", timeSincePrevTriggerClockTicks,
1091 "[Eventbased] Time since the previous trigger (127MHz=RF/4 clock).\n\n","clock ticks");
1092
1093 REGISTER_VARIABLE("timeSincePrevTriggerMicroSeconds", timeSincePrevTriggerMicroSeconds,
1094 "[Eventbased] Time since the previous trigger.\n\n",":math:`\\mathrm{\\mu s}`");
1095
1096 REGISTER_VARIABLE("triggeredBunchNumberTTD", triggeredBunchNumberTTD, R"DOC(
1097[Eventbased] Number of triggered bunch ranging from 0-1279.
1098
1099.. warning:: This is the bunch number as provided by the TTD, which does not necessarily correspond to the 'global' SKB bunch number.
1100.. note:: There are a maximum of 5120 buckets, which could each carry one bunch of e+/e-, but we only have 1280 clock ticks (=5120/4) to identify the bunches.
1101)DOC");
1102
1103 REGISTER_VARIABLE("triggeredBunchNumber", triggeredBunchNumber, R"DOC(
1104[Eventbased] Number of triggered bunch ranging from 0-1279.
1105
1106.. note:: There are a maximum of 5120 buckets, which could each carry one bunch of e+/e-, but we only have 1280 clock ticks (=5120/4) to identify the bunches
1107)DOC");
1108
1109 REGISTER_VARIABLE("hasRecentInjection", hasRecentInjection,
1110 "[Eventbased] Returns 1 if an injection happened recently, 0 otherwise.");
1111
1112 REGISTER_VARIABLE("timeSinceLastInjectionSignalClockTicks", timeSinceLastInjectionSignalClockTicks, R"DOC(
1113[Eventbased] Time since the last injection pre-kick signal (127MHz=RF/4 clock)
1114
1115.. warning:: this returns the time without the delay until the injected bunch reaches the detector (which differs for HER/LER)
1116
1117)DOC","clock ticks");
1118
1119 REGISTER_VARIABLE("timeSinceLastInjectionSignalMicroSeconds", timeSinceLastInjectionSignalMicroSeconds, R"DOC(
1120[Eventbased] Time since the last injection pre-kick signal
1121
1122.. warning:: this returns the time without the delay until the injected bunch reaches the detector (which differs for HER/LER)
1123
1124)DOC",":math:`\\mathrm{\\mu s}`");
1125
1126 REGISTER_VARIABLE("timeSinceLastInjectionClockTicks", timeSinceLastInjectionClockTicks,
1127 "[Eventbased] Time since the last injected bunch passed by the detector.\n\n","clock ticks")
1128
1129 REGISTER_VARIABLE("timeSinceLastInjectionMicroSeconds", timeSinceLastInjectionMicroSeconds,
1130 "[Eventbased] Time since the last injected bunch passed by the detector.\n\n",":math:`\\mathrm{\\mu s}`")
1131
1132 REGISTER_VARIABLE("injectionInHER", injectionInHER,
1133 "[Eventbased] Returns 1 if injection was in HER, 0 otherwise.");
1134
1135 REGISTER_VARIABLE("revolutionCounter2", revolutionCounter2, R"DOC(
1136[Eventbased] The lowest bit of revolution counter, i.e. return 0 or 1
1137
1138.. note:: related to PXD data acquisition; PXD needs ~2 revolutions to read out one frame
1139)DOC");
1140
1141 VARIABLE_GROUP("EventKinematics");
1142
1143 REGISTER_VARIABLE("missingMomentumOfEvent", missingMomentumOfEvent, R"DOC(
1144[Eventbased] The magnitude of the missing momentum in laboratory frame.
1145
1146.. warning:: You have to run the Event Kinematics builder module for this variable to be meaningful.
1147.. seealso:: `modularAnalysis.buildEventKinematics`.
1148
1149)DOC","GeV/c");
1150 REGISTER_VARIABLE("missingMomentumOfEvent_Px", missingMomentumOfEvent_Px, R"DOC(
1151[Eventbased] The x component of the missing momentum in laboratory frame.
1152
1153)DOC","GeV/c");
1154 REGISTER_VARIABLE("missingMomentumOfEvent_Py", missingMomentumOfEvent_Py, R"DOC(
1155[Eventbased] The y component of the missing momentum in laboratory frame.
1156
1157)DOC","GeV/c");
1158 REGISTER_VARIABLE("missingMomentumOfEvent_Pz", missingMomentumOfEvent_Pz, R"DOC(
1159[Eventbased] The z component of the missing momentum in laboratory frame.
1160
1161)DOC","GeV/c");
1162 REGISTER_VARIABLE("missingMomentumOfEvent_theta", missingMomentumOfEvent_theta, R"DOC(
1163[Eventbased] The theta angle of the missing momentum of the event in laboratory frame.
1164
1165)DOC","rad");
1166 REGISTER_VARIABLE("missingMomentumOfEventCMS", missingMomentumOfEventCMS, R"DOC(
1167[Eventbased] The magnitude of the missing momentum in center-of-mass frame.
1168
1169)DOC","GeV/c");
1170 REGISTER_VARIABLE("genMissingMomentumOfEventCMS", genMissingMomentumOfEventCMS, R"DOC(
1171[Eventbased] The magnitude of the missing momentum in center-of-mass frame from generator
1172
1173)DOC","GeV/c");
1174 REGISTER_VARIABLE("missingMomentumOfEventCMS_Px", missingMomentumOfEventCMS_Px, R"DOC(
1175[Eventbased] The x component of the missing momentum in center-of-mass frame.
1176
1177)DOC","GeV/c");
1178 REGISTER_VARIABLE("missingMomentumOfEventCMS_Py", missingMomentumOfEventCMS_Py, R"DOC(
1179[Eventbased] The y component of the missing momentum in center-of-mass frame.
1180
1181)DOC","GeV/c");
1182 REGISTER_VARIABLE("missingMomentumOfEventCMS_Pz", missingMomentumOfEventCMS_Pz, R"DOC(
1183[Eventbased] The z component of the missing momentum in center-of-mass frame.
1184
1185)DOC","GeV/c");
1186 REGISTER_VARIABLE("missingMomentumOfEventCMS_theta", missingMomentumOfEventCMS_theta, R"DOC(
1187[Eventbased] The theta angle of the missing momentum in center-of-mass frame.
1188
1189)DOC","rad");
1190 REGISTER_VARIABLE("missingEnergyOfEventCMS", missingEnergyOfEventCMS, R"DOC(
1191[Eventbased] The missing energy in center-of-mass frame.
1192
1193)DOC","GeV");
1194 REGISTER_VARIABLE("genMissingEnergyOfEventCMS", genMissingEnergyOfEventCMS, R"DOC(
1195[Eventbased] The missing energy in center-of-mass frame from generator.
1196
1197)DOC","GeV");
1198 REGISTER_VARIABLE("missingMass2OfEvent", missingMass2OfEvent, R"DOC(
1199[Eventbased] The missing mass squared.
1200
1201)DOC",":math:`[\\text{GeV}/\\text{c}^2]^2`");
1202 REGISTER_VARIABLE("genMissingMass2OfEvent", genMissingMass2OfEvent, R"DOC(
1203[Eventbased] The missing mass squared from generator
1204
1205)DOC",":math:`[\\text{GeV}/\\text{c}^2]^2`");
1206 REGISTER_VARIABLE("visibleEnergyOfEventCMS", visibleEnergyOfEventCMS, R"DOC(
1207[Eventbased] The visible energy in center-of-mass frame.
1208
1209)DOC","GeV");
1210 REGISTER_VARIABLE("genVisibleEnergyOfEventCMS", genVisibleEnergyOfEventCMS, R"DOC(
1211[Eventbased] The visible energy in center-of-mass frame from generator.
1212
1213)DOC","GeV");
1214 REGISTER_VARIABLE("totalPhotonsEnergyOfEvent", totalPhotonsEnergyOfEvent, R"DOC(
1215[Eventbased] The energy in laboratory frame of all the photons.
1216
1217)DOC","GeV");
1218 REGISTER_VARIABLE("genTotalPhotonsEnergyOfEvent", genTotalPhotonsEnergyOfEvent, R"DOC(
1219[Eventbased] The energy in laboratory frame of all the photons. from generator.
1220
1221)DOC","GeV");
1222 REGISTER_VARIABLE("eventT0CalculatedWithSVDInfo", eventT0CalculatedWithSVDInfo, R"DOC(
1223[Eventbased] It returns true if the SVD subdetector contributed in the calculation of the EventT0.
1224Please note that other subdetectors may also have contributed, so store the variables for these as well.
1225)DOC");
1226 REGISTER_VARIABLE("eventT0CalculatedWithCDCInfo", eventT0CalculatedWithCDCInfo, R"DOC(
1227[Eventbased] It returns true if the CDC subdetector contributed in the calculation of the EventT0.
1228Please note that other subdetectors may also have contributed, so store the variables for these as well.
1229)DOC");
1230 REGISTER_VARIABLE("eventT0CalculatedWithECLInfo", eventT0CalculatedWithECLInfo, R"DOC(
1231[Eventbased] It returns true if the ECL subdetector contributed in the calculation of the EventT0.
1232Please note that other subdetectors may also have contributed, so store the variables for these as well.
1233)DOC");
1234 }
1236}
static const double electronMass
electron mass
Definition Const.h:686
static const double doubleNaN
quiet_NaN
Definition Const.h:704
@ c_nPhotons
CR is split into n photons (N1)
Definition ECLCluster.h:41
@ c_neutralHadron
CR is reconstructed as a neutral hadron (N2)
Definition ECLCluster.h:43
bool isMC() const
Do we have generated, not real data?
static Environment & Instance()
Static method to get a reference to the Environment instance.
Abstract base class for different kinds of events.