KaliVeda  1.12/06
Heavy-Ion Analysis Toolkit
KVINDRA.h
Go to the documentation of this file.
1 /***************************************************************************
2  kvindra.h - description
3  -------------------
4  begin : Mon May 20 2002
5  copyright : (C) 2002 by J.D. Frankland
6  email : frankland@ganil.fr
7 
8 $Id: KVINDRA.h,v 1.43 2009/01/21 10:05:51 franklan Exp $
9  ***************************************************************************/
10 
11 /***************************************************************************
12  * *
13  * This program is free software; you can redistribute it and/or modify *
14  * it under the terms of the GNU General Public License as published by *
15  * the Free Software Foundation; either version 2 of the License, or *
16  * (at your option) any later version. *
17  * *
18  ***************************************************************************/
19 
20 #ifndef KVINDRA_H
21 #define KVINDRA_H
22 
23 #include "TEnv.h"
24 #include "KVASMultiDetArray.h"
25 #include "KVList.h"
26 #include "KVHashList.h"
27 #include "KVACQParam.h"
28 #include "KVDBSystem.h"
29 #include "KVUpDater.h"
30 #include "KVDataSetManager.h"
31 #include "KVINDRATriggerInfo.h"
32 #include "KVINDRADetector.h"
33 #include "KVINDRATelescope.h"
34 
35 class KVLayer;
36 class KVNucleus;
37 class KVChIo;
38 class KVDetectorEvent;
39 class KVINDRAReconEvent;
40 
43  ChIo_GG = 1,
44  ChIo_PG, //=2
45  ChIo_T, //=3
46  Si_GG, //=4
47  Si_PG, //=5
48  Si_T, //=6
49  CsI_R, //=7
50  CsI_L, //=8
51  CsI_T, //=9
52  Si75_GG, //=10
53  Si75_PG, //=11
54  Si75_T, //=12
55  SiLi_GG, //=13
56  SiLi_PG, //=14
57  SiLi_T //=15
58 };
60  Phos_R = 1,
61  Phos_L, //=2
62  Phos_T, //=3
63 };
64 
71 class KVINDRA: public KVASMultiDetArray {
72 
73 public:
74  static Char_t SignalTypes[16][3];
75 
76 
77 private:
80 
82  {
84  AddACQParam(p);
85  }
86 
87 protected:
92 
94 
96 
98 
99  virtual void MakeListOfDetectors();
100  virtual void BuildGeometry();
101  virtual void SetGroupsAndIDTelescopes();
104  void LinkToCodeurs();
105  void BuildLayer(const Char_t* name);
106  KVRing* BuildRing(Int_t number, const Char_t* prefix);
107  KVINDRATelescope* BuildTelescope(const Char_t* prefix, Int_t mod);
110  void SetNamesOfIDTelescopes() const;
111 
113 #ifdef WITH_MFM
114  Bool_t handle_raw_data_event_mfmframe_ebyedat(const MFMEbyedatFrame&);
115 #endif
117 
121  {
124  return IDCodes::NO_IDENTIFICATION;
125  }
127  {
130  return IDCodes::ID_CI_SI_COHERENCY;
131  }
133  {
136  return IDCodes::ID_CI_MULTIHIT;
137  }
139  {
141  return ECodes::NORMAL_CALIBRATION;
142  }
143 
144 public:
145  enum IDCodes {
151  ID_GAMMA = 0,
155  ID_SI_CSI = 3,
158  ID_CI_SI = 4,
159  ID_CI_CSI = 4,
166  };
168  {
170  switch (idc) {
171  case NO_IDENTIFICATION:
172  return "NO_IDENTIFICATION";
174  return "ID_STOPPED_IN_FIRST_STAGE";
175  case ID_GAMMA:
176  return "ID_GAMMA";
177  case ID_NEUTRON:
178  return "ID_NEUTRON";
179  case ID_CSI_PSA:
180  return "ID_CSI_PSA";
181  case ID_SI_CSI:
182  return "ID_SI_CSI";
183  case ID_CI_SI:
184  return "ID_CI_CSI";
185  case ID_CSI_FRAGMENT:
186  return "ID_CSI_FRAGMENT";
188  return "ID_CSI_MASS_OUT_OF_RANGE";
189  default:
190  return Form("(unknown:%d)", idc);
191  }
192  }
193  enum ECodes {
201  BAD_CALIBRATION = 15
202  };
204  {
205  switch (ec) {
207  return "NO_CALIBRATION_ATTEMPTED";
208  case NORMAL_CALIBRATION:
209  return "NORMAL_CALIBRATION";
211  return "SOME_ENERGY_LOSSES_CALCULATED";
213  return "WARNING_CSI_MAX_ENERGY";
214  case BAD_CALIBRATION:
215  return "BAD_CALIBRATION";
216  default:
217  return Form("(unknown:%d)", ec);
218  }
219  }
221  {
222  return IDCodes::ID_STOPPED_IN_FIRST_STAGE;
223  }
224 
225  KVINDRA();
226  virtual ~ KVINDRA();
227 
228  virtual void Build(Int_t run = -1);
229  virtual Bool_t ArePHDSet() const
230  {
231  return fPHDSet;
232  }
233  virtual void PHDSet(Bool_t yes = kTRUE)
234  {
235  fPHDSet = yes;
236  }
237 
239  inline KVHashList* GetListOfChIo() const
240  {
241  return fChIo;
242  };
243  inline KVHashList* GetListOfSi() const
244  {
245  return fSi;
246  };
247  inline KVHashList* GetListOfCsI() const
248  {
249  return fCsI;
250  };
252  {
253  return fPhoswich;
254  };
255 
256  virtual KVChIo* GetChIoOf(const Char_t* detname);
257  virtual void cd(Option_t* option = "");
259  UInt_t type) const;
260 
261  void SetTrigger(UChar_t trig);
263  {
264  return fTrigger;
265  }
266 
267  void SetPinLasersForCsI();
268  virtual TGraph* GetPedestals(const Char_t* det_signal, const Char_t* det_type, Int_t ring_number, Int_t run_number = -1);
269 
270  void SetArrayACQParams();
271  virtual void GetDetectorEvent(KVDetectorEvent* detev, const TSeqCollection* fired_params = 0);
272 
274  {
275  return fSelecteur;
276  };
277 
278  void CreateROOTGeometry();
279 
280  virtual void SetROOTGeometry(Bool_t on = kTRUE);
281  void SetMinimumOKMultiplicity(KVEvent*) const;
284 
285  ClassDef(KVINDRA, 6) //class describing the materials and detectors etc. to build an INDRA multidetector array
286 };
287 
290 
292 inline void KVINDRA::cd(Option_t*)
293 {
294  gIndra = this;
295 }
296 
297 #endif
int Int_t
unsigned int UInt_t
#define R__EXTERN
R__EXTERN KVINDRA * gIndra
................ global variable
Definition: KVINDRA.h:289
EBaseIndra_type
old BaseIndra type definitions
Definition: KVINDRA.h:42
@ Si_PG
Definition: KVINDRA.h:47
@ ChIo_PG
Definition: KVINDRA.h:44
@ SiLi_GG
Definition: KVINDRA.h:55
@ CsI_L
Definition: KVINDRA.h:50
@ Si75_GG
Definition: KVINDRA.h:52
@ ChIo_T
Definition: KVINDRA.h:45
@ SiLi_T
Definition: KVINDRA.h:57
@ CsI_T
Definition: KVINDRA.h:51
@ SiLi_PG
Definition: KVINDRA.h:56
@ ChIo_GG
Definition: KVINDRA.h:43
@ CsI_R
Definition: KVINDRA.h:49
@ Si75_T
Definition: KVINDRA.h:54
@ Si_GG
Definition: KVINDRA.h:46
@ Si_T
Definition: KVINDRA.h:48
@ Si75_PG
Definition: KVINDRA.h:53
EBaseIndra_typePhos
Definition: KVINDRA.h:59
@ Phos_T
Definition: KVINDRA.h:62
@ Phos_R
Definition: KVINDRA.h:60
@ Phos_L
Definition: KVINDRA.h:61
unsigned short UShort_t
unsigned char UChar_t
char Char_t
bool Bool_t
const char Option_t
#define ClassDef(name, id)
char * Form(const char *fmt,...)
GANIL VXI/VME acquisition parameter.
Definition: KVACQParam.h:15
Base class for azimuthally-symmetric multidetector arrays (obsolete)
Ionisation chamber detectors of the INDRA multidetector array.
Definition: KVChIo.h:29
Base class for detector geometry description, interface to energy-loss calculations.
Definition: KVDetector.h:121
Base class container for multi-particle events.
Definition: KVEvent.h:176
Base class for particle reconstruction in one group of a detector array.
Group of detectors which can be treated independently of all others in array.
Definition: KVGroup.h:19
Extended version of ROOT THashList.
Definition: KVHashList.h:28
Base class for all detectors or associations of detectors in array which can identify charged particl...
Definition: KVIDTelescope.h:88
Base class for detectors of INDRA array.
Event reconstructed from energy losses in INDRA multidetector.
Base class for telescopes in INDRA array.
Information on INDRA event from DAQ trigger.
INDRA multidetector array geometry.
Definition: KVINDRA.h:71
virtual void Build(Int_t run=-1)
Definition: KVINDRA.cpp:380
void SetGGtoPGConversionFactors()
Definition: KVINDRA.cpp:1122
KVHashList * GetListOfSi() const
Definition: KVINDRA.h:243
KVINDRA()
Definition: KVINDRA.cpp:84
virtual KVChIo * GetChIoOf(const Char_t *detname)
Definition: KVINDRA.cpp:582
KVINDRATelescope * BuildTelescope(const Char_t *prefix, Int_t mod)
Definition: KVINDRA.cpp:292
void CreateROOTGeometry()
Definition: KVINDRA.cpp:1189
UChar_t GetTrigger() const
Definition: KVINDRA.h:262
KVHashList * fChIo
List Of ChIo of INDRA.
Definition: KVINDRA.h:88
virtual UChar_t GetNormalCalibrationCode()
Definition: KVINDRA.h:138
void SetPinLasersForCsI()
Definition: KVINDRA.cpp:896
TString GetIDCodeMeaning(Int_t idc) const
Definition: KVINDRA.h:167
KVGroupReconstructor * GetReconstructorForGroup(const KVGroup *) const
Definition: KVINDRA.cpp:1328
virtual Int_t GetIDCodeForParticlesStoppingInFirstStageOfTelescopes() const
Definition: KVINDRA.h:220
virtual void SetGroupsAndIDTelescopes()
Definition: KVINDRA.cpp:564
void LinkToCodeurs()
Definition: KVINDRA.cpp:964
Int_t GetIDTelescopes(KVDetector *, KVDetector *, TCollection *)
Definition: KVINDRA.cpp:725
ECodes
Calibration quality codes attributed to particles reconstructed from data.
Definition: KVINDRA.h:193
@ NORMAL_CALIBRATION
normal well-calibrated particle with no problems
Definition: KVINDRA.h:198
@ BAD_CALIBRATION
calibration attempted but bad result (negative energies etc.)
Definition: KVINDRA.h:201
@ NO_CALIBRATION_ATTEMPTED
particle stopped in detectors with no available calibration
Definition: KVINDRA.h:197
@ WARNING_CSI_MAX_ENERGY
particle calibration OK, although apparent energy would mean punching through the CsI
Definition: KVINDRA.h:200
@ SOME_ENERGY_LOSSES_CALCULATED
particle calibration OK, with some detector energies calculated
Definition: KVINDRA.h:199
KVHashList * GetListOfPhoswich() const
Definition: KVINDRA.h:251
KVINDRATriggerInfo * fSelecteur
infos from DAQ trigger (le Selecteur)
Definition: KVINDRA.h:95
UChar_t fTrigger
multiplicity trigger used for acquisition
Definition: KVINDRA.h:78
virtual UShort_t GetCoherencyIDCode()
Definition: KVINDRA.h:126
KVLayer * GetChIoLayer()
Definition: KVINDRA.cpp:600
KVHashList * fCsI
List of CsI detectors of INDRA.
Definition: KVINDRA.h:90
virtual void cd(Option_t *option="")
................ inline functions
Definition: KVINDRA.h:292
virtual void SetROOTGeometry(Bool_t on=kTRUE)
Definition: KVINDRA.cpp:1290
static Char_t SignalTypes[16][3]
Use this static array to translate EBaseIndra_type signal type to a string giving the signal type.
Definition: KVINDRA.h:74
void FillListsOfDetectorsByType()
Fill lists of ChIo, Si, CsI and phoswich.
Definition: KVINDRA.cpp:528
virtual ~ KVINDRA()
virtual void MakeListOfDetectors()
Overrides KVASMultiDetArray method to add FillListsOfDetectorsByType()
Definition: KVINDRA.cpp:515
void FillTrajectoryIDTelescopeLists()
Definition: KVINDRA.cpp:339
TString GetECodeMeaning(Int_t ec) const
Definition: KVINDRA.h:203
KVHashList * fSi
List of Si detectors of INDRA.
Definition: KVINDRA.h:89
void SetIDCodeForIDTelescope(KVIDTelescope *) const
Set the INDRA-specific general identification code for the given telescope.
Definition: KVINDRA.cpp:849
KVHashList * GetListOfChIo() const
Definition: KVINDRA.h:239
TEnv fStrucInfos
file containing structure of array
Definition: KVINDRA.h:97
void PerformClosedROOTGeometryOperations()
Definition: KVINDRA.cpp:789
IDCodes
Identification quality codes attributed to particles reconstructed from data.
Definition: KVINDRA.h:145
@ ID_CI_SI75
particle identified in ChIo-Si75 etalon telescope
Definition: KVINDRA.h:160
@ ID_SI_CSI
particle identified in Si-CsI telescope
Definition: KVINDRA.h:155
@ ID_NEUTRON
'neutron' discriminated by coherency between CsI and Si-CsI identifications
Definition: KVINDRA.h:152
@ ID_CI_SI
particle identified in ChIo-Si telescope
Definition: KVINDRA.h:158
@ ID_CI_SI_COHERENCY
particle identified in ChIo-Si telescope in coincidence with light particle identified in CsI
Definition: KVINDRA.h:161
@ ID_STOPPED_IN_FIRST_STAGE
particle stopped in first detector of telescope, only minimum Z can be estimated
Definition: KVINDRA.h:150
@ ID_CSI_PSA
particle identified in CsI detector by pulse shape analysis
Definition: KVINDRA.h:154
@ ID_PHOSWICH
particle identified in phoswich (campaigns 1-3)
Definition: KVINDRA.h:153
@ NO_IDENTIFICATION
no identification either attempted or available for particle
Definition: KVINDRA.h:149
@ ID_CI_COHERENCY
particle stopped in ChIo revealed by coherency tests (Zmin)
Definition: KVINDRA.h:162
@ ID_CI_MULTIHIT
particles stopped in multiple Si (ring<10) or CsI (ring>9) behind same ChIo, bad identification
Definition: KVINDRA.h:163
@ ID_CSI_FRAGMENT
particle partially identified in CsI detector, with Z greater than identifiable
Definition: KVINDRA.h:164
@ ID_GAMMA
'gamma' particle detected in CsI
Definition: KVINDRA.h:151
@ ID_SILI_CSI
particle identified in SiLi-CsI etalon telescope
Definition: KVINDRA.h:157
@ ID_CSI_MASS_OUT_OF_RANGE
particle partially identified in CsI detector, mass out of range of apparent Z (pile-up?...
Definition: KVINDRA.h:165
@ ID_SI75_SILI
particle identified in Si75-SiLi etalon telescope
Definition: KVINDRA.h:156
@ ID_CI_CSI
particle identified in ChIo-CsI telescope
Definition: KVINDRA.h:159
virtual void PHDSet(Bool_t yes=kTRUE)
Definition: KVINDRA.h:233
virtual UShort_t GetBadIDCode()
Definition: KVINDRA.h:120
void SetReconParametersInEvent(KVReconstructedEvent *) const
If "INDRA.EN" parameter has been set, we use it to set the event number.
Definition: KVINDRA.cpp:1354
virtual TGraph * GetPedestals(const Char_t *det_signal, const Char_t *det_type, Int_t ring_number, Int_t run_number=-1)
Definition: KVINDRA.cpp:1038
void SetTrigger(UChar_t trig)
Definition: KVINDRA.cpp:615
virtual Bool_t ArePHDSet() const
Definition: KVINDRA.h:229
Bool_t handle_raw_data_event_mfmframe_ebyedat(const MFMEbyedatFrame &)
Definition: KVINDRA.cpp:807
KVRing * BuildRing(Int_t number, const Char_t *prefix)
Build ring with infos in file "$KVROOT/KVFiles/data/indra-struct.[dataset].env".
Definition: KVINDRA.cpp:243
virtual KVINDRADetector * GetDetectorByType(UInt_t cou, UInt_t mod, UInt_t type) const
Definition: KVINDRA.cpp:651
void SetNamesOfIDTelescopes() const
Definition: KVINDRA.cpp:748
void AddArrayACQParam(KVACQParam *p)
Definition: KVINDRA.h:81
KVINDRATriggerInfo * GetTriggerInfo()
Definition: KVINDRA.h:273
KVList fOwnedACQParams
to clean up acquisition parameters belonging to the array, not to detectors
Definition: KVINDRA.h:79
KVHashList * GetListOfCsI() const
Definition: KVINDRA.h:247
void SetArrayACQParams()
Definition: KVINDRA.cpp:444
virtual UShort_t GetMultiHitFirstStageIDCode()
Definition: KVINDRA.h:132
virtual void GetDetectorEvent(KVDetectorEvent *detev, const TSeqCollection *fired_params=0)
Definition: KVINDRA.cpp:1091
void BuildLayer(const Char_t *name)
Build layer 'name' with infos in file "$KVROOT/KVFiles/data/indra-struct.[dataset]....
Definition: KVINDRA.cpp:218
virtual void BuildGeometry()
Definition: KVINDRA.cpp:157
KVHashList * fPhoswich
List of NE102/NE115 detectors of INDRA.
Definition: KVINDRA.h:91
Bool_t fPHDSet
set to kTRUE if pulse height defect parameters are set
Definition: KVINDRA.h:93
void SetMinimumOKMultiplicity(KVEvent *) const
Definition: KVINDRA.cpp:1312
Set of detectors at a similar distance from target (obsolete)
Definition: KVLayer.h:32
Extended TList class which owns its objects by default.
Definition: KVList.h:27
void AddACQParam(KVACQParam *)
Description of properties and kinematics of atomic nuclei.
Definition: KVNucleus.h:125
Physical event reconstructed from data measured with a detector array using implemented identificatio...
Ring in INDRA array (obsolete)
Definition: KVRing.h:19
virtual void Add(TObject *obj)