ToFLevel2/inc/ToFLevel2.h

/**
 * \file ToFLevel2.h
 * \author Gianfranca DeRosa / Wolfgang Menn
 */

#ifndef ToFLevel2_h
#define ToFLevel2_h
//
#include <TObject.h>
#include <TArrayI.h>
#include <TArrayF.h>
#include <TClonesArray.h>

#include <ToFStruct.h>


//
// class which contains track related variables
//
#define ZTOF11 53.74
#define ZTOF12 53.04
#define ZTOF21 23.94
#define ZTOF22 23.44
#define ZTOF31 -23.49
#define ZTOF32 -24.34


/**
 * \brief  Class which contains the PMT data
 *
 * If there is a valid ADC or a TDC value (value<4095) for a PMT, both ADC and TDC data
 * are stored in the PMT class.
 * Look in the ToFLevel2Ex.cxx example in the repository how to read the PMT class. 
 */
class ToFPMT : public TObject {

 private:

 public:
    Int_t pmt_id;     ///<the identification number of the PMT from 0 to 47
    Float_t adc;      ///<raw ADC value for this PMT 
    Float_t tdc;      ///<raw TDC value for this PMT
    Float_t tdc_tw;   ///<time-walk corrected TDC value for this PMT
    //
    ToFPMT();
    ToFPMT(const ToFPMT&);
    //
    ToFPMT* GetToFPMT(){return this;};
    void Clear();


    ClassDef(ToFPMT,2);
};


/**
 * \brief Class which contains the tracker related variables
 *
 * We can use the ToF standalone to find hitted paddles, calculate beta, etc..
 * These results are then stored with the "trkseqno" = -1.
 * If we use the track from the tracker, then the penetration points in the
 * scintillators are calculated, which defines the hitted paddles. For these paddles
 * we calculate then all the output.
 * Note: The artificial ADC values are stored as dEdx in the output, the dEdx will be
 * by definition = 1. However, the artificial TDC values are just used internally
 * and not stored in the output. But one can see in both cases which PMT has artificial
 * values using "adcflag" and "tdcflag".
 * Look in the ToFLevel2Ex.cxx example in the repository how to read the tracker related
 * variables. 
 */
class ToFTrkVar : public TObject {

 private:

 public:
  //
  Int_t trkseqno; ///< tracker sequ. number: -1=ToF standalone, 0=first Tracker track, ...
  //
  Int_t npmttdc;  ///<number of the TDC measurements used to evaluate beta
  TArrayI pmttdc;  ///<contains the ID (0..47) for the PMT used to evaluate beta
  TArrayI tdcflag; ///<flag for artificial TDC, "0" if normal TDC value

/**
 * \brief beta, 12 measurements for the 12  combinations, beta[13] is weighted mean
 *
 * The 12 measurements are S11-S31, S11-S32, S12-S31, S12-S32, and then analogue for
 * S2-S3 and S1-S2. 
 * In the moment all measurements are taken and the weighted mean is calculated.
 * Note that the weights are just simple overall results for S1-S3, S2-S3, and S1-S2.
 * Artificial measurments are not treated correct, (since there is only one real
 * measurment the weight should be different then for two meassurments). 
 * The beta calculation will be improved in the next release.    
 */
  Float_t beta[13]; 
  //
  Int_t npmtadc;  ///<number of the ADC measurements used for dEdx evaluation
  TArrayI pmtadc; ///<contains the ID (0..47) for the PMT used to evaluate dEdx
  TArrayI adcflag; ///<flag for artificial ADCs, "0" if normal ADC value
  TArrayF dedx;    ///<energy loss for this PMT in mip
  //
  Float_t xtofpos[3];  ///<x-measurement using the TDC values and the calibration from S12, S21, S32
  Float_t ytofpos[3];  ///<x-measurement using the TDC values and the calibration from S11, S22, S31
  //
  Float_t xtr_tof[6];  ///<x-measurement in the ToF layers from tracker
  Float_t ytr_tof[6];  ///<x-measurement in the ToF layers from tracker
  //
  ToFTrkVar();
  ToFTrkVar(const ToFTrkVar&);

  ToFTrkVar* GetToFTrkVar(){return this;};
  void Clear();

  ClassDef(ToFTrkVar,1);
  //
};

/**
 * \brief  Class to describe ToF LEVEL2 data
 *
 */

class ToFLevel2 : public TObject {
 private:

 public:
  //
  TClonesArray *PMT; ///<class needed to store PMT hit informations
  TClonesArray *ToFTrk; ///<track related variable class
  Int_t tof_j_flag[6];  ///<number of hitted paddle(s) for each ToF layer: flag = flag + 2**(paddlenumber-1)
  //
  Int_t unpackError;///< zero if no error presente
  Int_t default_calib; ///< one if the default calibration has been used to process the data, zero otherwise
  //
  Float_t GetdEdx(Int_t notrack, Int_t plane, Int_t adcfl); // gf Apr 07
  //
  // methods to make life simplier during the analysis, returns a pointer to the ToFTrkVar class containing track related variables
  //
  Int_t ntrk(){return ToFTrk->GetEntries();};
  Int_t npmt(){return PMT->GetEntries();};

  //
  void GetLevel2Struct(cToFLevel2 *) const;
  //
  ToFTrkVar *GetToFTrkVar(Int_t notrack);
  ToFPMT *GetToFPMT(Int_t nohit);
  Int_t GetPMTid(Int_t gg, Int_t hh);
  TString GetPMTName(Int_t ind);
  
  Int_t GetPlaneIndex(Int_t pmt_id);
  void GetMatrix(Int_t notrack, Float_t adc[4][12], Float_t tdc[4][12]);
  void GetPMTIndex(Int_t pmt_id, Int_t &gg, Int_t &hh);

  // gf Apr 07
  void GetdEdxPaddle(Int_t notrack, Int_t paddleid, Int_t adcfl, Float_t &PadEdx, Int_t &SatWarning); // gf Apr 07
  TString GetPMTName(Int_t ind, Int_t &iplane, Int_t &ipaddle,Int_t &ipmt);
  Int_t GetPaddleIdOfTrack(Float_t xtr, Float_t ytr, Int_t plane); // gf Apr 07
  void GetPMTPaddle(Int_t pmt_id, Int_t &plane, Int_t &paddle); // gf Apr 07
  void GetPaddlePMT(Int_t paddle, Int_t &pmtleft, Int_t &pmtright); // gf Apr 07
  void GetPaddleGeometry(Int_t plane, Int_t paddle, Float_t &xleft, Float_t &xright, Float_t &yleft, Float_t &yright); // gf Apr 07
  Int_t GetPaddleid(Int_t plane, Int_t paddle);
  void GetPaddlePlane(Int_t padid, Int_t &plane, Int_t &paddle);
  Int_t GetNPaddle(Int_t plane);
  //
  
  //
  // constructor
  //
  ToFLevel2();
  ~ToFLevel2(){Delete();}; //ELENA
  void Delete(); //ELENA
  void Set();//ELENA
  //
  //
  ToFLevel2*   GetToFLevel2(){return this;};

/**
 * Method to get the z-position of the 6 TOF layers from the plane ID
 * @param plane_id Plane ID (11 12 21 22 31 32)
 */
  Float_t      GetZTOF(Int_t plane_id){
      switch(plane_id){
      case 11: return ZTOF11;
      case 12: return ZTOF12;
      case 21: return ZTOF21;
      case 22: return ZTOF22;
      case 31: return ZTOF31;
      case 32: return ZTOF32;
      default: return 0.;
      };
  };

    //
    // Paddles position
    //
    /*
      S11 8 paddles  33.0 x 5.1 cm
      S12 6 paddles  40.8 x 5.5 cm
      S21 2 paddles  18.0 x 7.5 cm
      S22 2 paddles  15.0 x 9.0 cm
      S31 3 paddles  15.0 x 6.0 cm
      S32 3 paddles  18.0 x 5.0 cm
    */

    Int_t  GetToFPlaneID(Int_t ip);
    Int_t  GetToFPlaneIndex(Int_t plane_id);
    Bool_t HitPaddle(Int_t ,Int_t);
    Int_t  GetNHitPaddles(Int_t plane);
    void Clear();
    //
    ClassDef(ToFLevel2,3);
};

#endif

1	pam-de	1.14	/**
2			* \file ToFLevel2.h
3			* \author Gianfranca DeRosa / Wolfgang Menn
4			*/
5
6	mocchiut	1.1	#ifndef ToFLevel2_h
7			#define ToFLevel2_h
8			//
9			#include <TObject.h>
10	mocchiut	1.4	#include <TArrayI.h>
11			#include <TArrayF.h>
12	mocchiut	1.1	#include <TClonesArray.h>
13	pam-fi	1.6
14			#include <ToFStruct.h>
15	pam-de	1.14
16
17	mocchiut	1.1	//
18			// class which contains track related variables
19			//
20			#define ZTOF11 53.74
21			#define ZTOF12 53.04
22			#define ZTOF21 23.94
23			#define ZTOF22 23.44
24			#define ZTOF31 -23.49
25			#define ZTOF32 -24.34
26
27	mocchiut	1.4
28	pam-de	1.14	/**
29			* \brief Class which contains the PMT data
30			*
31	pam-de	1.15	* If there is a valid ADC or a TDC value (value<4095) for a PMT, both ADC and TDC data
32			* are stored in the PMT class.
33			* Look in the ToFLevel2Ex.cxx example in the repository how to read the PMT class.
34	pam-de	1.14	*/
35	mocchiut	1.4	class ToFPMT : public TObject {
36	pam-de	1.14
37	mocchiut	1.4	private:
38
39			public:
40	pam-de	1.14	Int_t pmt_id; ///<the identification number of the PMT from 0 to 47
41	pam-de	1.15	Float_t adc; ///<raw ADC value for this PMT
42	mocchiut	1.17	Float_t tdc; ///<raw TDC value for this PMT
43	pam-de	1.15	Float_t tdc_tw; ///<time-walk corrected TDC value for this PMT
44	mocchiut	1.4	//
45			ToFPMT();
46			ToFPMT(const ToFPMT&);
47			//
48			ToFPMT* GetToFPMT(){return this;};
49			void Clear();
50
51	pam-de	1.14
52	mocchiut	1.13
53	mocchiut	1.17	ClassDef(ToFPMT,2);
54	mocchiut	1.4	};
55
56
57	pam-de	1.14	/**
58	pam-de	1.15	* \brief Class which contains the tracker related variables
59	pam-de	1.14	*
60	pam-de	1.15	* We can use the ToF standalone to find hitted paddles, calculate beta, etc..
61			* These results are then stored with the "trkseqno" = -1.
62			* If we use the track from the tracker, then the penetration points in the
63			* scintillators are calculated, which defines the hitted paddles. For these paddles
64			* we calculate then all the output.
65			* Note: The artificial ADC values are stored as dEdx in the output, the dEdx will be
66			* by definition = 1. However, the artificial TDC values are just used internally
67			* and not stored in the output. But one can see in both cases which PMT has artificial
68			* values using "adcflag" and "tdcflag".
69			* Look in the ToFLevel2Ex.cxx example in the repository how to read the tracker related
70			* variables.
71	pam-de	1.14	*/
72	mocchiut	1.1	class ToFTrkVar : public TObject {
73	pam-de	1.14
74	mocchiut	1.1	private:
75
76			public:
77	mocchiut	1.13	//
78	pam-de	1.14	Int_t trkseqno; ///< tracker sequ. number: -1=ToF standalone, 0=first Tracker track, ...
79	mocchiut	1.1	//
80	pam-de	1.15	Int_t npmttdc; ///<number of the TDC measurements used to evaluate beta
81			TArrayI pmttdc; ///<contains the ID (0..47) for the PMT used to evaluate beta
82			TArrayI tdcflag; ///<flag for artificial TDC, "0" if normal TDC value
83
84			/**
85			* \brief beta, 12 measurements for the 12 combinations, beta[13] is weighted mean
86			*
87			* The 12 measurements are S11-S31, S11-S32, S12-S31, S12-S32, and then analogue for
88			* S2-S3 and S1-S2.
89			* In the moment all measurements are taken and the weighted mean is calculated.
90			* Note that the weights are just simple overall results for S1-S3, S2-S3, and S1-S2.
91			* Artificial measurments are not treated correct, (since there is only one real
92			* measurment the weight should be different then for two meassurments).
93			* The beta calculation will be improved in the next release.
94			*/
95			Float_t beta[13];
96			//
97			Int_t npmtadc; ///<number of the ADC measurements used for dEdx evaluation
98			TArrayI pmtadc; ///<contains the ID (0..47) for the PMT used to evaluate dEdx
99			TArrayI adcflag; ///<flag for artificial ADCs, "0" if normal ADC value
100			TArrayF dedx; ///<energy loss for this PMT in mip
101	mocchiut	1.4	//
102	pam-de	1.15	Float_t xtofpos[3]; ///<x-measurement using the TDC values and the calibration from S12, S21, S32
103			Float_t ytofpos[3]; ///<x-measurement using the TDC values and the calibration from S11, S22, S31
104	mocchiut	1.16	//
105			Float_t xtr_tof[6]; ///<x-measurement in the ToF layers from tracker
106			Float_t ytr_tof[6]; ///<x-measurement in the ToF layers from tracker
107	mocchiut	1.1	//
108			ToFTrkVar();
109			ToFTrkVar(const ToFTrkVar&);
110	pam-de	1.14
111	mocchiut	1.1	ToFTrkVar* GetToFTrkVar(){return this;};
112	mocchiut	1.4	void Clear();
113
114	mocchiut	1.1	ClassDef(ToFTrkVar,1);
115			//
116			};
117
118	pam-de	1.14	/**
119			* \brief Class to describe ToF LEVEL2 data
120			*
121			*/
122
123	mocchiut	1.1	class ToFLevel2 : public TObject {
124			private:
125	pam-de	1.14
126	mocchiut	1.1	public:
127	mocchiut	1.4	//
128	pam-de	1.14	TClonesArray *PMT; ///<class needed to store PMT hit informations
129			TClonesArray *ToFTrk; ///<track related variable class
130			Int_t tof_j_flag[6]; ///<number of hitted paddle(s) for each ToF layer: flag = flag + 2**(paddlenumber-1)
131	mocchiut	1.17	//
132			Int_t unpackError;///< zero if no error presente
133			Int_t default_calib; ///< one if the default calibration has been used to process the data, zero otherwise
134	mocchiut	1.1	//
135	mocchiut	1.16	Float_t GetdEdx(Int_t notrack, Int_t plane, Int_t adcfl); // gf Apr 07
136	mocchiut	1.1	//
137			// methods to make life simplier during the analysis, returns a pointer to the ToFTrkVar class containing track related variables
138			//
139			Int_t ntrk(){return ToFTrk->GetEntries();};
140	mocchiut	1.4	Int_t npmt(){return PMT->GetEntries();};
141	pam-de	1.14
142	mocchiut	1.1	//
143	pam-fi	1.6	void GetLevel2Struct(cToFLevel2 *) const;
144			//
145	pam-de	1.14	ToFTrkVar *GetToFTrkVar(Int_t notrack);
146			ToFPMT *GetToFPMT(Int_t nohit);
147	mocchiut	1.4	Int_t GetPMTid(Int_t gg, Int_t hh);
148			TString GetPMTName(Int_t ind);
149	mocchiut	1.16
150	mocchiut	1.4	Int_t GetPlaneIndex(Int_t pmt_id);
151			void GetMatrix(Int_t notrack, Float_t adc[4][12], Float_t tdc[4][12]);
152	mocchiut	1.5	void GetPMTIndex(Int_t pmt_id, Int_t &gg, Int_t &hh);
153	mocchiut	1.16
154			// gf Apr 07
155			void GetdEdxPaddle(Int_t notrack, Int_t paddleid, Int_t adcfl, Float_t &PadEdx, Int_t &SatWarning); // gf Apr 07
156			TString GetPMTName(Int_t ind, Int_t &iplane, Int_t &ipaddle,Int_t &ipmt);
157			Int_t GetPaddleIdOfTrack(Float_t xtr, Float_t ytr, Int_t plane); // gf Apr 07
158			void GetPMTPaddle(Int_t pmt_id, Int_t &plane, Int_t &paddle); // gf Apr 07
159			void GetPaddlePMT(Int_t paddle, Int_t &pmtleft, Int_t &pmtright); // gf Apr 07
160			void GetPaddleGeometry(Int_t plane, Int_t paddle, Float_t &xleft, Float_t &xright, Float_t &yleft, Float_t &yright); // gf Apr 07
161			Int_t GetPaddleid(Int_t plane, Int_t paddle);
162			void GetPaddlePlane(Int_t padid, Int_t &plane, Int_t &paddle);
163			Int_t GetNPaddle(Int_t plane);
164			//
165
166	mocchiut	1.1	//
167			// constructor
168			//
169			ToFLevel2();
170	mocchiut	1.13	~ToFLevel2(){Delete();}; //ELENA
171			void Delete(); //ELENA
172			void Set();//ELENA
173	mocchiut	1.1	//
174			//
175			ToFLevel2* GetToFLevel2(){return this;};
176	pam-de	1.14
177			/**
178	pam-de	1.15	* Method to get the z-position of the 6 TOF layers from the plane ID
179	pam-de	1.14	* @param plane_id Plane ID (11 12 21 22 31 32)
180			*/
181	mocchiut	1.4	Float_t GetZTOF(Int_t plane_id){
182	mocchiut	1.1	switch(plane_id){
183			case 11: return ZTOF11;
184			case 12: return ZTOF12;
185			case 21: return ZTOF21;
186			case 22: return ZTOF22;
187			case 31: return ZTOF31;
188			case 32: return ZTOF32;
189			default: return 0.;
190			};
191	mocchiut	1.4	};
192	pam-de	1.14
193	mocchiut	1.1	//
194			// Paddles position
195			//
196			/*
197			S11 8 paddles 33.0 x 5.1 cm
198			S12 6 paddles 40.8 x 5.5 cm
199			S21 2 paddles 18.0 x 7.5 cm
200			S22 2 paddles 15.0 x 9.0 cm
201			S31 3 paddles 15.0 x 6.0 cm
202			S32 3 paddles 18.0 x 5.0 cm
203			*/
204	pam-de	1.14
205	mocchiut	1.1	Int_t GetToFPlaneID(Int_t ip);
206			Int_t GetToFPlaneIndex(Int_t plane_id);
207			Bool_t HitPaddle(Int_t ,Int_t);
208			Int_t GetNHitPaddles(Int_t plane);
209	mocchiut	1.3	void Clear();
210	mocchiut	1.1	//
211	mocchiut	1.17	ClassDef(ToFLevel2,3);
212	mocchiut	1.1	};
213
214			#endif
215	pam-de	1.14