Jpp 20.0.0
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 // https://git.km3net.de/working_groups/calibration/-/issues/118
493
494 get(809069506).rotateL('D');
495 }
496
497 protected:
498 /**
499 * Configure module.
500 */
501 virtual void configure() const override
502 {
503 using namespace JPP;
504
505 // https://elog.km3net.de/Analysis/723
506
507 if (module.getID() == 817802210) {
508 rotateLower(-60.0);
509 }
510
511 // https://git.km3net.de/auxiliary_data/calibration/-/issues/10
512
513 if (module.getID() == 817603901) {
514 rotateLower(+60.0);
515 }
516
517 // https://git.km3net.de/working_groups/calibration/-/issues/153
518
519 if (module.getID() == 810403184) {
520 rotateLower(-30.0);
521 }
522
523 // https://git.km3net.de/working_groups/calibration/-/issues/154
524
525 if (module.getID() == 805536812) {
526 rotateLower(+60.0);
527 }
528
529 // https://git.km3net.de/working_groups/calibration/-/issues/118
530
531 if (module.getID() == 809069506) {
532 rotateLower(-60.0);
533 }
534 }
535
536
537 /**
538 * Rotate lower hemisphere clock-wise around z-axis.
539 *
540 * \param phi angle [deg]
541 */
542 void rotateLower(const double phi) const
543 {
544 using namespace JPP;
545
546 const JRotation3Z R(phi * PI / 180.0);
547
548 for (JModule::iterator pmt = module.begin(); pmt != module.end(); ++pmt) {
549 if (pmt->getDZ() < 0.0) {
550 pmt->rotate(R);
551 }
552 }
553 }
554 };
555
556
557 /**
558 * Get detector builder.
559 *
560 * \return detector builder
561 */
562 template<class JDetector_t>
564 {
566
567 return demo;
568 }
569
570
571 /**
572 * Get detector address map.
573 *
574 * \return detector address map
575 */
576 template<class JDetector_t>
581
582
583 /**
584 * Get module address map.
585 *
586 * \param id module identifier
587 * \return module address map
588 */
589 template<class JDetector_t>
594
595
596 /**
597 * Get PMT address translator for given module identifier and TDC channel.
598 *
599 * \param id module identifier
600 * \param tdc TDC
601 * \return PMT address translator
602 */
603 template<class JDetector_t>
604 inline const JPMTAddressTranslator& getPMTAddressTranslator(int id, int tdc)
605 {
607 }
608
609
610 /**
611 * Get PMT logical index for given module identifier and TDC channel.
612 *
613 * \param id module identifier
614 * \param tdc TDC
615 * \return PMT logical index
616 */
617 template<class JDetector_t>
618 inline int getPMTLogicalIndex(int id, int tdc)
619 {
621 }
622
623
624 /**
625 * Auxiliary class to extract detector address map from detector identifier.
626 */
627 template<class T>
629
630
631 template<class JHead_t, class JTail_t>
632 struct JDetectorHelper_t< JTypeList<JHead_t, JTail_t> >
633 {
634 /**
635 * Get detector address map.
636 *
637 * \param id detector identifier
638 * \return detector builder
639 */
640 static JDetectorBuilder& get(const int id)
641 {
642 if (hasDetector(JType<JHead_t>(), id))
644 else
646 }
647
648
649 /**
650 * Has detector address map.
651 *
652 * \param id detector identifier
653 * \return true if detector address map available; else false
654 */
655 static bool has(const int id)
656 {
658 }
659 };
660
661
662 template<class JHead_t>
664 {
665 /**
666 * Get detector address map.
667 *
668 * \param id detector identifier
669 * \return detector builder
670 */
671 static JDetectorBuilder& get(const int id)
672 {
673 if (hasDetector(JType<JHead_t>(), id))
675 else
676 THROW(JIndexOutOfRange, "getDetectorAddressMap<..>(" << id << ")" );
677 }
678
679
680 /**
681 * Has detector address map.
682 *
683 * \param id detector identifier
684 * \return true if detector address map available; else false
685 */
686 static bool has(const int id)
687 {
688 return hasDetector(JType<JHead_t>(), id);
689 }
690 };
691
692
693 /**
694 * Get detector builder.
695 *
696 * \param id detector identifier
697 * \return detector builder
698 */
700 {
702 }
703
704
705 /**
706 * Get detector address map.
707 *
708 * \param id detector identifier
709 * \return detector address map
710 */
715
716
717 /**
718 * Check if detector builder is available.
719 *
720 * \param id detector identifier
721 * \return true if detector builder available; else false
722 */
723 inline bool hasDetectorBuilder(const int id)
724 {
726 }
727
728
729 /**
730 * Check if detector address map is available.
731 *
732 * \param id detector identifier
733 * \return true if detector address map available; else false
734 */
735 inline bool hasDetectorAddressMap(const int id)
736 {
738 }
739
740
741 /**
742 * Get module according given detector type.
743 *
744 * \param type detector type
745 * \param id module identifier
746 * \param location module location
747 * \return module
748 */
749 template<class JDetector_t>
750 inline const JModule& getModule(const JType<JDetector_t> type,
751 const int id,
752 const JLocation& location = JLocation())
753 {
754 return getDetectorBuilder<JDetector_t>().getModule(id, location);
755 }
756
757
758 /**
759 * Get module according Antares detector type.
760 *
761 * \param type Antares detector type
762 * \param id module identifier
763 * \param location module location
764 * \return module
765 */
766 inline const JModule& getModule(const JType<JAntares_t> type,
767 const int id,
768 const JLocation& location = JLocation())
769 {
770 using namespace JPP;
771
772 static JModule module;
773
774 module.setID(id);
775
776 module.setLocation(location);
777
778 if (module.empty()) {
779
780 module.resize(3);
781
782 const double R = 0.5; // [m]
783
784 const double st = sin(0.75*PI);
785 const double ct = cos(0.75*PI);
786
787 for (int i = 0; i != 3; ++i) {
788
789 const double phi = (2.0*PI*i) / 3.0;
790 const double cp = cos(phi);
791 const double sp = sin(phi);
792
793 module[i] = JPMT(i, JAxis3D(JVector3D(R*st*cp, R*st*sp, R*ct), JVersor3D(st*cp, st*sp, ct)));
794 }
795 }
796
797 return module;
798 }
799
800
801 /**
802 * Get module according detector template.
803 *
804 * \param id module identifier
805 * \param location module location
806 * \return module
807 */
808 template<class JDetector_t>
809 inline const JModule& getModule(const int id,
810 const JLocation& location = JLocation())
811 {
812 return getModule(JType<JDetector_t>(), id, location);
813 }
814}
815
816#endif
817
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