Jpp 20.0.0-rc.8
the software that should make you happy
Loading...
Searching...
No Matches
JDetectorSupportkit.hh
Go to the documentation of this file.
1#ifndef __JDETECTOR__JDETECTORSUPPORTKIT__
2#define __JDETECTOR__JDETECTORSUPPORTKIT__
3
4#include "JLang/JTypeList.hh"
5#include "JLang/JNullType.hh"
6#include "JLang/JType.hh"
7#include "JLang/JException.hh"
8
9#include "JMath/JConstants.hh"
10
11#include "JDetector/JModule.hh"
15
16
17/**
18 * \file
19 *
20 * Detector support kit.
21 * \author mdejong
22 */
23namespace JDETECTOR {}
24namespace JPP { using namespace JDETECTOR; }
25
26namespace JDETECTOR {
27
28 using JLANG::JTypeList;
29 using JLANG::JTYPELIST;
30 using JLANG::JNullType;
31 using JLANG::JType;
34
35
36 static const double ORCA_TBARZ_M = 0.91; //!< ORCA T-bar position relative to seabed [m]
37 static const double ARCA_TBARZ_M = 0.95; //!< ORCA T-bar position relative to seabed [m]
38
39
40 /**
41 * Type definitions for different detectors.
42 */
43 struct JPPM_DU_t {}; //!< PPM_DU
44 struct JKM3NeT_t {}; //!< %KM3NeT default detector
45 struct JMonteCarlo_t {}; //!< Monte Carlo
46 struct JAntares_t {}; //!< %Antares
47 struct JObsolete_t {}; //!< obsolete detector
48 struct JKM3NeTFit_t {}; //!< %KM3NeT with cable swaps, etc. (see e.g. JPMTSwapDB.cc)
49
50
51 /**
52 * Type list of %KM3NeT detector types (specific detectors first).
53 */
55
56
57 /**
58 * Check validity of detector identifier.
59 *
60 * \param type detector type
61 * \param id detector identifier
62 * \return true if valid match; else false
63 */
64 inline bool hasDetector(JType<JPPM_DU_t> type, const int id) { return id == 1; }
65 inline bool hasDetector(JType<JKM3NeTFit_t> type, const int id) { return id >= 2 && id <= 2000000000; }
66 inline bool hasDetector(JType<JKM3NeT_t> type, const int id) { return id >= 2 && id <= 2000000000; }
67 inline bool hasDetector(JType<JMonteCarlo_t> type, const int id) { return id >= -2000000000 && id <= -2; }
68
69
70 /**
71 * Auxiliary interface for building detector.
72 */
75 {
76 /**
77 * Get module.
78 *
79 * The configuration of module is according internal module address map.
80 *
81 * \param id module identifier
82 * \param location module location
83 * \return module
84 */
85 const JModule& getModule(const int id = -1, const JLocation& location = JLocation()) const
86 {
87 module.setID(id);
88 module.setLocation(location);
89
90 const JModuleAddressMap& memo = this->get(id);
91
92 module.resize(memo.size());
93
94 if (memo.has( 0)) { module[memo[ 0].tdc] = JPMT( 1, JAxis3D(JVector3D(+0.000, +0.000, -0.200), JVersor3D(+0.000, +0.000, -1.000))); }
95
96 if (memo.has( 1)) { module[memo[ 1].tdc] = JPMT( 2, JAxis3D(JVector3D(+0.000, +0.105, -0.170), JVersor3D(+0.000, +0.527, -0.850))); }
97 if (memo.has( 2)) { module[memo[ 2].tdc] = JPMT( 3, JAxis3D(JVector3D(+0.091, +0.053, -0.170), JVersor3D(+0.456, +0.263, -0.850))); }
98 if (memo.has( 3)) { module[memo[ 3].tdc] = JPMT( 4, JAxis3D(JVector3D(+0.091, -0.053, -0.170), JVersor3D(+0.456, -0.263, -0.850))); }
99 if (memo.has( 4)) { module[memo[ 4].tdc] = JPMT( 5, JAxis3D(JVector3D(+0.000, -0.105, -0.170), JVersor3D(+0.000, -0.527, -0.850))); }
100 if (memo.has( 5)) { module[memo[ 5].tdc] = JPMT( 6, JAxis3D(JVector3D(-0.091, -0.053, -0.170), JVersor3D(-0.456, -0.263, -0.850))); }
101 if (memo.has( 6)) { module[memo[ 6].tdc] = JPMT( 7, JAxis3D(JVector3D(-0.091, +0.053, -0.170), JVersor3D(-0.456, +0.263, -0.850))); }
102
103 if (memo.has( 7)) { module[memo[ 7].tdc] = JPMT( 8, JAxis3D(JVector3D(+0.083, +0.144, -0.111), JVersor3D(+0.416, +0.720, -0.555))); }
104 if (memo.has( 8)) { module[memo[ 8].tdc] = JPMT( 9, JAxis3D(JVector3D(+0.166, +0.000, -0.111), JVersor3D(+0.832, +0.000, -0.555))); }
105 if (memo.has( 9)) { module[memo[ 9].tdc] = JPMT(10, JAxis3D(JVector3D(+0.083, -0.144, -0.111), JVersor3D(+0.416, -0.720, -0.555))); }
106 if (memo.has(10)) { module[memo[10].tdc] = JPMT(11, JAxis3D(JVector3D(-0.083, -0.144, -0.111), JVersor3D(-0.416, -0.720, -0.555))); }
107 if (memo.has(11)) { module[memo[11].tdc] = JPMT(12, JAxis3D(JVector3D(-0.166, +0.000, -0.111), JVersor3D(-0.832, +0.000, -0.555))); }
108 if (memo.has(12)) { module[memo[12].tdc] = JPMT(13, JAxis3D(JVector3D(-0.083, +0.144, -0.111), JVersor3D(-0.416, +0.720, -0.555))); }
109
110 if (memo.has(13)) { module[memo[13].tdc] = JPMT(14, JAxis3D(JVector3D(+0.000, +0.191, -0.059), JVersor3D(+0.000, +0.955, -0.295))); }
111 if (memo.has(14)) { module[memo[14].tdc] = JPMT(15, JAxis3D(JVector3D(+0.165, +0.096, -0.059), JVersor3D(+0.827, +0.478, -0.295))); }
112 if (memo.has(15)) { module[memo[15].tdc] = JPMT(16, JAxis3D(JVector3D(+0.165, -0.096, -0.059), JVersor3D(+0.827, -0.478, -0.295))); }
113 if (memo.has(16)) { module[memo[16].tdc] = JPMT(17, JAxis3D(JVector3D(+0.000, -0.191, -0.059), JVersor3D(+0.000, -0.955, -0.295))); }
114 if (memo.has(17)) { module[memo[17].tdc] = JPMT(18, JAxis3D(JVector3D(-0.165, -0.096, -0.059), JVersor3D(-0.827, -0.478, -0.295))); }
115 if (memo.has(18)) { module[memo[18].tdc] = JPMT(19, JAxis3D(JVector3D(-0.165, +0.096, -0.059), JVersor3D(-0.827, +0.478, -0.295))); }
116
117 if (memo.has(19)) { module[memo[19].tdc] = JPMT(20, JAxis3D(JVector3D(+0.096, +0.165, +0.059), JVersor3D(+0.478, +0.827, +0.295))); }
118 if (memo.has(20)) { module[memo[20].tdc] = JPMT(21, JAxis3D(JVector3D(+0.191, +0.000, +0.059), JVersor3D(+0.955, +0.000, +0.295))); }
119 if (memo.has(21)) { module[memo[21].tdc] = JPMT(22, JAxis3D(JVector3D(+0.096, -0.165, +0.059), JVersor3D(+0.478, -0.827, +0.295))); }
120 if (memo.has(22)) { module[memo[22].tdc] = JPMT(23, JAxis3D(JVector3D(-0.096, -0.165, +0.059), JVersor3D(-0.478, -0.827, +0.295))); }
121 if (memo.has(23)) { module[memo[23].tdc] = JPMT(24, JAxis3D(JVector3D(-0.191, +0.000, +0.059), JVersor3D(-0.955, +0.000, +0.295))); }
122 if (memo.has(24)) { module[memo[24].tdc] = JPMT(25, JAxis3D(JVector3D(-0.096, +0.165, +0.059), JVersor3D(-0.478, +0.827, +0.295))); }
123
124 if (memo.has(25)) { module[memo[25].tdc] = JPMT(26, JAxis3D(JVector3D(+0.000, +0.166, +0.111), JVersor3D(+0.000, +0.832, +0.555))); }
125 if (memo.has(26)) { module[memo[26].tdc] = JPMT(27, JAxis3D(JVector3D(+0.144, +0.083, +0.111), JVersor3D(+0.720, +0.416, +0.555))); }
126 if (memo.has(27)) { module[memo[27].tdc] = JPMT(28, JAxis3D(JVector3D(+0.144, -0.083, +0.111), JVersor3D(+0.720, -0.416, +0.555))); }
127 if (memo.has(28)) { module[memo[28].tdc] = JPMT(29, JAxis3D(JVector3D(+0.000, -0.166, +0.111), JVersor3D(+0.000, -0.832, +0.555))); }
128 if (memo.has(29)) { module[memo[29].tdc] = JPMT(30, JAxis3D(JVector3D(-0.144, -0.083, +0.111), JVersor3D(-0.720, -0.416, +0.555))); }
129 if (memo.has(30)) { module[memo[30].tdc] = JPMT(31, JAxis3D(JVector3D(-0.144, +0.083, +0.111), JVersor3D(-0.720, +0.416, +0.555))); }
130
131 configure();
132
133 module.compile();
134 module.set(JVector3D(0.0, 0.0, 0.0));
135
136 return module;
137 }
138
139 protected:
140 /**
141 * Configure module.
142 */
143 virtual void configure() const
144 {}
145
147 };
148
149
150 /**
151 * Template lookup table for detector builder.
152 *
153 * The template argument refers to a specific detector.\n
154 * This class should be specialised for each detector by providing an implementation of method getDefaultModuleAddressMap.\n
155 * In the constructor of the specialised class, the PMT cable swaps should be defined.\n
156 * Other features can be implemented in virtual method configure.
157 */
158 template<class JDetector_t>
160
161
162 /**
163 * Template specialisation of JDetectorBuilder for obsolete detector.
164 */
165 template<>
167 public JDetectorBuilder
168 {
169 public:
170 /**
171 * Default constructor.
172 */
175
176
177 /**
178 * Get default module address map.
179 *
180 * \return module address map
181 */
182 virtual const JModuleAddressMap& getDefaultModuleAddressMap() const override
183 {
184 static JModuleAddressMap memo;
185
186 if (memo.empty()) {
187
189
196
203
210
217
224
225 memo.configure();
226 }
227
228 return memo;
229 }
230 };
231
232
233 /**
234 * Template specialisation of JDetectorBuilder for PPM_DU detector.
235 */
236 template<>
238 public JDetectorBuilder
239 {
240 public:
241 /**
242 * Default constructor.
243 */
245 {
246 get(103).swap(24,30);
247 }
248
249
250 /**
251 * Get default module address map.
252 *
253 * \return module address map
254 */
255 virtual const JModuleAddressMap& getDefaultModuleAddressMap() const override
256 {
257 static JModuleAddressMap memo;
258
259 if (memo.empty()) {
260
262
269
276
283
290
297
298 memo.configure();
299 }
300
301 return memo;
302 }
303 };
304
305
306 /**
307 * Template specialisation of JDetectorBuilder for %KM3NeT detector.
308 */
309 template<>
311 public JDetectorBuilder
312 {
313 public:
314 /**
315 * Default constructor.
316 */
319
320
321 /**
322 * Get default module address map.
323 *
324 * \return module address map
325 */
326 virtual const JModuleAddressMap& getDefaultModuleAddressMap() const override
327 {
328 static JModuleAddressMap memo;
329
330 if (memo.empty()) {
331
333
340
347
354
361
368
369 memo.configure();
370 }
371
372 return memo;
373 }
374 };
375
376
377 /**
378 * Template specialisation of JDetectorBuilder for Monte Carlo detector.
379 */
380 template<>
382 public JDetectorBuilder
383 {
384 public:
385 /**
386 * Default constructor.
387 */
390
391
392 /**
393 * Get default module address map.
394 *
395 * \return module address map
396 */
397 virtual const JModuleAddressMap& getDefaultModuleAddressMap() const override
398 {
399 static JModuleAddressMap memo;
400
401 if (memo.empty()) {
402
404
411
418
425
432
439
440 memo.configure();
441 }
442
443 return memo;
444 }
445 };
446
447
448 /**
449 * Template specialisation of JDetectorBuilder for %KM3NeT detector with all known features.
450 */
451 template<>
453 public JDetectorBuilder_t<JKM3NeT_t>
454 {
455 public:
456 /**
457 * Default constructor.
458 */
460 {
461 // NCR A02904908
462
463 get(817802210).rotateL('B');
464
465 // https://elog.km3net.de/Analysis/721
466 // https://elog.km3net.de/Analysis/723
467
468 get(817351722).swapTDC(15, 17);
469 get(808972598).swapTDC(27, 28);
470 get(817315169).swapTDC(14, 18);
471 get(806481218).swapTDC( 9, 11);
472
473 get(817295048).rotateR('B');
474
475 // NCR A03733363
476
477 get(817565802).swapTDC( 3, 4);
478
479 // NCR A02922408
480
481 //get(817801283).swapTDC(22, 24);
482 //get(817801283).swapTDC(24, 26);
483
484 // https://git.km3net.de/working_groups/calibration/-/issues/154
485
486 get(805631219).swapTDC(23, 25);
487 get(805631219).swapTDC(24, 30);
488 get(810310870).swapTDC(12, 15);
489
490 get(805536976).rotateR('D');
491 }
492
493 protected:
494 /**
495 * Configure module.
496 */
497 virtual void configure() const override
498 {
499 using namespace JPP;
500
501 // https://elog.km3net.de/Analysis/723
502
503 if (module.getID() == 817802210) {
504 rotateLower(-60.0);
505 }
506
507 // https://git.km3net.de/auxiliary_data/calibration/-/issues/10
508
509 if (module.getID() == 817603901) {
510 rotateLower(+60.0);
511 }
512
513 // https://git.km3net.de/working_groups/calibration/-/issues/153
514
515 if (module.getID() == 810403184) {
516 rotateLower(-30.0);
517 }
518
519 // https://git.km3net.de/working_groups/calibration/-/issues/154
520
521 if (module.getID() == 805536812) {
522 rotateLower(+60.0);
523 }
524 }
525
526
527 /**
528 * Rotate lower hemisphere clock-wise around z-axis.
529 *
530 * \param phi angle [deg]
531 */
532 void rotateLower(const double phi) const
533 {
534 using namespace JPP;
535
536 const JRotation3Z R(phi * PI / 180.0);
537
538 for (JModule::iterator pmt = module.begin(); pmt != module.end(); ++pmt) {
539 if (pmt->getDZ() < 0.0) {
540 pmt->rotate(R);
541 }
542 }
543 }
544 };
545
546
547 /**
548 * Get detector builder.
549 *
550 * \return detector builder
551 */
552 template<class JDetector_t>
554 {
556
557 return demo;
558 }
559
560
561 /**
562 * Get detector address map.
563 *
564 * \return detector address map
565 */
566 template<class JDetector_t>
571
572
573 /**
574 * Get module address map.
575 *
576 * \param id module identifier
577 * \return module address map
578 */
579 template<class JDetector_t>
584
585
586 /**
587 * Get PMT address translator for given module identifier and TDC channel.
588 *
589 * \param id module identifier
590 * \param tdc TDC
591 * \return PMT address translator
592 */
593 template<class JDetector_t>
594 inline const JPMTAddressTranslator& getPMTAddressTranslator(int id, int tdc)
595 {
597 }
598
599
600 /**
601 * Get PMT logical index for given module identifier and TDC channel.
602 *
603 * \param id module identifier
604 * \param tdc TDC
605 * \return PMT logical index
606 */
607 template<class JDetector_t>
608 inline int getPMTLogicalIndex(int id, int tdc)
609 {
611 }
612
613
614 /**
615 * Auxiliary class to extract detector address map from detector identifier.
616 */
617 template<class T>
619
620
621 template<class JHead_t, class JTail_t>
622 struct JDetectorHelper_t< JTypeList<JHead_t, JTail_t> >
623 {
624 /**
625 * Get detector address map.
626 *
627 * \param id detector identifier
628 * \return detector builder
629 */
630 static JDetectorBuilder& get(const int id)
631 {
632 if (hasDetector(JType<JHead_t>(), id))
634 else
636 }
637
638
639 /**
640 * Has detector address map.
641 *
642 * \param id detector identifier
643 * \return true if detector address map available; else false
644 */
645 static bool has(const int id)
646 {
648 }
649 };
650
651
652 template<class JHead_t>
654 {
655 /**
656 * Get detector address map.
657 *
658 * \param id detector identifier
659 * \return detector builder
660 */
661 static JDetectorBuilder& get(const int id)
662 {
663 if (hasDetector(JType<JHead_t>(), id))
665 else
666 THROW(JIndexOutOfRange, "getDetectorAddressMap<..>(" << id << ")" );
667 }
668
669
670 /**
671 * Has detector address map.
672 *
673 * \param id detector identifier
674 * \return true if detector address map available; else false
675 */
676 static bool has(const int id)
677 {
678 return hasDetector(JType<JHead_t>(), id);
679 }
680 };
681
682
683 /**
684 * Get detector builder.
685 *
686 * \param id detector identifier
687 * \return detector builder
688 */
690 {
692 }
693
694
695 /**
696 * Get detector address map.
697 *
698 * \param id detector identifier
699 * \return detector address map
700 */
705
706
707 /**
708 * Check if detector builder is available.
709 *
710 * \param id detector identifier
711 * \return true if detector builder available; else false
712 */
713 inline bool hasDetectorBuilder(const int id)
714 {
716 }
717
718
719 /**
720 * Check if detector address map is available.
721 *
722 * \param id detector identifier
723 * \return true if detector address map available; else false
724 */
725 inline bool hasDetectorAddressMap(const int id)
726 {
728 }
729
730
731 /**
732 * Get module according given detector type.
733 *
734 * \param type detector type
735 * \param id module identifier
736 * \param location module location
737 * \return module
738 */
739 template<class JDetector_t>
740 inline const JModule& getModule(const JType<JDetector_t> type,
741 const int id,
742 const JLocation& location = JLocation())
743 {
744 return getDetectorBuilder<JDetector_t>().getModule(id, location);
745 }
746
747
748 /**
749 * Get module according Antares detector type.
750 *
751 * \param type Antares detector type
752 * \param id module identifier
753 * \param location module location
754 * \return module
755 */
756 inline const JModule& getModule(const JType<JAntares_t> type,
757 const int id,
758 const JLocation& location = JLocation())
759 {
760 using namespace JPP;
761
762 static JModule module;
763
764 module.setID(id);
765
766 module.setLocation(location);
767
768 if (module.empty()) {
769
770 module.resize(3);
771
772 const double R = 0.5; // [m]
773
774 const double st = sin(0.75*PI);
775 const double ct = cos(0.75*PI);
776
777 for (int i = 0; i != 3; ++i) {
778
779 const double phi = (2.0*PI*i) / 3.0;
780 const double cp = cos(phi);
781 const double sp = sin(phi);
782
783 module[i] = JPMT(i, JAxis3D(JVector3D(R*st*cp, R*st*sp, R*ct), JVersor3D(st*cp, st*sp, ct)));
784 }
785 }
786
787 return module;
788 }
789
790
791 /**
792 * Get module according detector template.
793 *
794 * \param id module identifier
795 * \param location module location
796 * \return module
797 */
798 template<class JDetector_t>
799 inline const JModule& getModule(const int id,
800 const JLocation& location = JLocation())
801 {
802 return getModule(JType<JDetector_t>(), id, location);
803 }
804}
805
806#endif
807
Exceptions.
#define THROW(JException_t, A)
Marco for throwing exception with std::ostream compatible message.
Mathematical constants.
Module support kit.
Data structure for optical module.
Lookup table for PMT addresses in detector.
const JModuleAddressMap & get(const int id) const
Get module address map.
virtual void configure() const override
Configure module.
void rotateLower(const double phi) const
Rotate lower hemisphere clock-wise around z-axis.
virtual const JModuleAddressMap & getDefaultModuleAddressMap() const override
Get default module address map.
virtual const JModuleAddressMap & getDefaultModuleAddressMap() const override
Get default module address map.
virtual const JModuleAddressMap & getDefaultModuleAddressMap() const override
Get default module address map.
virtual const JModuleAddressMap & getDefaultModuleAddressMap() const override
Get default module address map.
Template lookup table for detector builder.
Logical location of module.
Definition JLocation.hh:40
Lookup table for PMT addresses in optical module.
const JPMTAddressTranslator & getAddressTranslator(const int tdc) const
Get PMT address translator.
void configure()
Configure internal router.
int getIndex(const int tdc) const
Get PMT logical index for given TDC channel.
bool has(const int index) const
Test whether index is available.
Data structure for a composite optical module.
Definition JModule.hh:76
Data structure for PMT physical address.
Data structure for PMT readout address.
Rotation around Z-axis.
General exception.
Definition JException.hh:24
Exception for accessing an index in a collection that is outside of its range.
file Auxiliary data structures and methods for detector calibration.
Definition JAnchor.hh:12
const JModule & getModule(const JType< JDetector_t > type, const int id, const JLocation &location=JLocation())
Get module according given detector type.
JDetectorBuilder & getDetectorBuilder()
Get detector builder.
static const double ORCA_TBARZ_M
ORCA T-bar position relative to seabed [m].
bool hasDetectorBuilder(const int id)
Check if detector builder is available.
const JPMTAddressTranslator & getPMTAddressTranslator(int id, int tdc)
Get PMT address translator for given module identifier and TDC channel.
static const double ARCA_TBARZ_M
ORCA T-bar position relative to seabed [m].
int getPMTLogicalIndex(int id, int tdc)
Get PMT logical index for given module identifier and TDC channel.
JDetectorAddressMap & getDetectorAddressMap()
Get detector address map.
JTYPELIST< JPPM_DU_t, JKM3NeTFit_t, JKM3NeT_t, JMonteCarlo_t >::typelist JDetectorTypes_t
Type list of KM3NeT detector types (specific detectors first).
bool hasDetectorAddressMap(const int id)
Check if detector address map is available.
JModuleAddressMap & getModuleAddressMap(int id)
Get module address map.
bool hasDetector(JType< JPPM_DU_t > type, const int id)
Check validity of detector identifier.
This name space includes all other name spaces (except KM3NETDAQ, KM3NET and ANTARES).
Auxiliary interface for building detector.
virtual void configure() const
Configure module.
const JModule & getModule(const int id=-1, const JLocation &location=JLocation()) const
Get module.
static JDetectorBuilder & get(const int id)
Get detector address map.
static bool has(const int id)
Has detector address map.
static bool has(const int id)
Has detector address map.
static JDetectorBuilder & get(const int id)
Get detector address map.
Auxiliary class to extract detector address map from detector identifier.
KM3NeT with cable swaps, etc. (see e.g. JPMTSwapDB.cc)
KM3NeT default detector
Data structure to translate PMT physical to readout address.
Type definitions for different detectors.PPM_DU.
Auxiliary class for no type definition.
Definition JNullType.hh:19
Auxiliary class for recursive type list generation.
Definition JTypeList.hh:351
Type list.
Definition JTypeList.hh:23
Auxiliary class for a type holder.
Definition JType.hh:19