TrackerLevel2/inc/TrkLevel2.h

/**
 * \file TrkLevel2.h
 * \author Elena Vannuccini
 */
#ifndef trklevel2_h
#define trklevel2_h

#include <TObject.h>
#include <TObjArray.h>
#include <TClonesArray.h>
#include <TRefArray.h>
#include <TRef.h>

#include <TrkParams.h>
#include <TrkLevel1.h>

// z-coordinate of track state-vector reference-plane
#define ZINI 23.5   
// (mechanical) z-coordinate of the tracker planes
#define ZTRK6 -22.23
#define ZTRK5 -13.32
#define ZTRK4 -4.42
#define ZTRK3 4.48
#define ZTRK2 13.38
#define ZTRK1 22.28
// (mechanical) x/y-coordinates of magnet cavity
#define XTRKL -8.1
#define XTRKR  8.1
#define YTRKL -6.6
#define YTRKR  6.6

/**
 * \brief Class to describe, by points, a particle trajectory in the apparatus. 
 *
 * The idea is to create it by integrating the equations of motion, given the 
 * track state vector and the z coordinates where to evaluate track position.
 */
// ==================================================================
class Trajectory : public TObject{
 private:

 public:

    int npoint; ///< number of evaluated points along the trajectory
    float* x;   ///< x coordinates 
    float* y;   ///< y coordinates 
    float* z;   ///< z coordinates 
    float* thx; ///< x projected angle 
    float* thy; ///< y projected angle
    float* tl;  ///< track length

    Trajectory();
    Trajectory(int n);
    Trajectory(int n, float* pz);
    ~Trajectory(){Delete();};
    void Dump();
    void Delete();

    int DoTrack2(float* al);
    float GetLength(){float l=0; for(int i=0; i<npoint;i++)l=l+tl[i]; return l;};
    float GetLength(int,int);

    ClassDef(Trajectory,2);

};
/**
 * \brief Class to describe fitted tracks. 
 *
 * A track is defined by the measured coordinates associated to it, the 
 * track status vector, plus other quantities.
 * A track may have an "image", due to the ambiguity in the y view.
 *
 * Cluster flags: xgood[6], ygood[6]
 * 
 * xgood/ygood = +/- 0lsccccccc
 *                |   |||------- ID (1-7483647) of the included cluster  
 *                |   ||-------- sensor number (1,2   - increasing y)
 *                |   |--------- ladder number (1,2,3 - increasing x)
 *                |------------- does-not/does include bad strips
 */
// ==================================================================
class TrkTrack : public TObject {

private:

    int   seqno;           ///<stored track sequential number
    int   image;           ///<sequential number of track-image
        
public:

    float al[5];           ///<TRACK STATE VECTOR 
    float coval[5][5];     ///<covariance matrix 
    int   xgood[6];        ///<cluster flag for x-view (0 = view not included in the fit) 
    int   ygood[6];        ///<cluster flag for y-view (0 = view not included in the fit) 
    float xm[6];           ///<measured x coordinates
    float ym[6];           ///<measured y coordinates 
    float zm[6];           ///<measured z coordinates 
    float resx[6];         ///<spatial resolution on X view
    float resy[6];         ///<spatial resolution on y view
    float tailx[6];        ///<spatial resolution tail on X view
    float taily[6];        ///<spatial resolution tail on y view
    float chi2;            ///<chi2
    int   nstep;           ///<n. step
    float xv[6];           ///<calculated x coordinates
    float yv[6];           ///<calculated y coordinates
    float zv[6];           ///<calculated z coordinates
    float axv[6];          ///<calculated angles (deg) on x view
    float ayv[6];          ///<calculated angles (deg) on y view
    float dedx_x[6];       ///<dE/dx in MIP (<0 if saturated)
    float dedx_y[6];       ///<dE/dx in MIP (<0 if saturated) 

    TrkTrack();
    TrkTrack(const TrkTrack&);

    ~TrkTrack(){ Delete(); };
        
    void Dump();
    void Clear();
    void Clear(Option_t *option){Clear();};
    void Delete();
    void Copy(TrkTrack&);
//    void Set();

    Int_t  GetSeqNo(){return seqno;}        ///< Returns the track sequential number
    Int_t  GetImageSeqNo(){return image;}   ///< Returns the track image sequential number
    Bool_t HasImage(){return !(image==-1);} ///< Returns true if the track has an image
    int DoTrack(Trajectory* t);                         ///< Evaluates the trajectory in the apparatus.
    int DoTrack2(Trajectory* t);                        ///< Evaluates the trajectory in the apparatus.
    float BdL(){return 0;};                                     ///< Evaluates the integral of B*dL along the track.
    Int_t GetNX(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=(Int_t)XGood(i); return n;}; 
    Int_t GetNY(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=(Int_t)YGood(i); return n;};
    Int_t GetNtot(){return GetNX()+GetNY();};
    Float_t GetRigidity();
    Float_t GetDeflection();
    Bool_t IsSaturated(int,int);
    Bool_t IsSaturated(int);
    Bool_t IsSaturated();
    Bool_t IsBad(int,int);
    Float_t GetDEDX();
    Float_t GetDEDX(int);
    Float_t GetDEDX(int,int);
    Int_t GetLeverArmX();
    Int_t GetLeverArmY();

    void SetMeasure(double *xmeas, double *ymeas, double *zmeas);
    void SetResolution(double *rx, double *ry);
    void SetTail(double *tx, double *ty, double factor);
    void SetStudentParam(int flag);
    void SetGood(int *xg, int *yg);
    void LoadField(TString s);
    void Fit(double pfixed, int& fail, int iprint, int froml1);
    void Fit(double pfixed, int& fail, int iprint){ Fit(pfixed,fail,iprint,0); };
    void FitReset();
    void SetTrackingMode(int trackmode);
    void SetPrecisionFactor(double fact);
    void SetStepMin(int istepmin);

    void EvaluateClusterPositions();

    void FillMiniStruct(cMini2track&);
    void SetFromMiniStruct(cMini2track*);
    
    Int_t GetClusterX_ID(int ip);
    Int_t GetClusterY_ID(int ip);
    Int_t GetLadder(int ip);
    Int_t GetSensor(int ip);
    Bool_t XGood(int ip){ return GetClusterX_ID(ip)!=-1; };
    Bool_t YGood(int ip){ return GetClusterY_ID(ip)!=-1; };
    void ResetXGood(int ip){ xgood[ip]=0; };
    void ResetYGood(int ip){ ygood[ip]=0; };
    void SetXGood(int ip, int clid, int is);
    void SetYGood(int ip, int clid, int is);

    Bool_t BadClusterX(int ip){ return IsBad(ip,0); };
    Bool_t BadClusterY(int ip){ return IsBad(ip,1); };

    Bool_t SaturatedClusterX(int ip){ return IsSaturated(ip,0); };
    Bool_t SaturatedClusterY(int ip){ return IsSaturated(ip,1); };

    TrkTrack* GetTrkTrack(){return this;};

    friend class TrkLevel2;

    ClassDef(TrkTrack,3);

};
/**
 * \brief Class to describe single clusters ("singlets"). 
 *
 * Single clusters are clusters not associated to any track.
 */
class TrkSinglet : public TObject {

private:
        

public:
        
    int plane;       ///<plane 
    float coord[2];  ///<coordinate (on sensor 1 and 2)
    float sgnl;      ///<cluster signal in MIP (<0 if saturated)

    TrkSinglet();
    TrkSinglet(const TrkSinglet&);
    ~TrkSinglet(){Delete();};

    void Dump();
    void Clear();
    void Clear(Option_t *option){Clear();};
    void Delete(){Clear();};
    Float_t GetSignal(){return fabs(sgnl);}
    Bool_t IsSaturated(){return (sgnl<0); };
        
    friend class TrkLevel2;

    ClassDef(TrkSinglet,3);

};

/**
 * \brief Class to describe tracker LEVEL2 data.
 *
 * A tracker events is defined by some general variables, plus the collection of all the fitted tracks and all 
 * single clusters on X and Y views. 
 * Tracks and single clusters ("singlets") are described by the classes TrkTrack and TrkSinglet respectivelly.
 * 
 * Each track may have an "image", due to the ambiguity on the Y view, which is stored also. 
 * Thus, the number of stored tracks ( ntrk() ) differs from the number of "physical" tracks ( GetNTracks() ). 
 * Proper methods allow to sort tracks and select the physical ones ( GetTracks() ).
 */
class TrkLevel2 : public TObject {

 private:
 
 public:

    Int_t         good[12];       ///< event status
    UInt_t        VKmask[12];     ///< Viking-chip mask
    UInt_t        VKflag[12];     ///< Viking-chip flag

    TClonesArray *Track;        ///< fitted tracks
    TClonesArray *SingletX;     ///< x singlets
    TClonesArray *SingletY;     ///< y singlets

    TrkLevel2();
//    TrkLevel2(cTrkLevel2 *);
    ~TrkLevel2(){Delete();};
        
    void Clear();
    void Clear(Option_t *option){Clear();};
    void Delete();
    void Set();
    
    int ntrk() {return Track->GetEntries();}    ///< number of stored track
    int nclsx(){return SingletX->GetEntries();} ///< number of x singlets 
    int nclsy(){return SingletY->GetEntries();} ///< number of y singlets 

    void Dump();
    void SetFromLevel2Struct(cTrkLevel2 *, TrkLevel1 *);
    void SetFromLevel2Struct(cTrkLevel2 *s2){ SetFromLevel2Struct(s2, NULL);          };
    void SetFromLevel2Struct(TrkLevel1 *l1) { SetFromLevel2Struct(&level2event_, l1); };    
    void SetFromLevel2Struct()              { SetFromLevel2Struct(&level2event_);     };    
    void GetLevel2Struct(cTrkLevel2 *) const;
    void LoadField(TString);
    float GetBX(float* v){return TrkParams::GetBX(v);};///< Bx (kGauss)
    float GetBY(float* v){return TrkParams::GetBY(v);};///< By (kGauss)
    float GetBZ(float* v){return TrkParams::GetBZ(v);};///< Bz (kGauss)
    Float_t GetZTrk(Int_t);
    Float_t GetXTrkLeft(){return XTRKL;};
    Float_t GetXTrkRight(){return XTRKR;};
    Float_t GetYTrkLeft(){return YTRKL;};
    Float_t GetYTrkRight(){return YTRKR;};
    
    Bool_t IsMaskedVK(int,int);
    Bool_t GetVKMask(int,int);
    Bool_t GetVKFlag(int,int);

    TrkSinglet   *GetSingletX(int);
    TrkSinglet   *GetSingletY(int);
    
    TrkTrack     *GetStoredTrack(int i);
    Int_t         GetSeqNo(Int_t i)  {return (((TrkTrack *)Track->At(i))->seqno);}; ///< Returns track sequential number

    TRefArray *GetTracks_NFitSorted();
    TRefArray *GetTracks(){return this->GetTracks_NFitSorted();};
    
    Int_t     GetNTracks();
    TrkTrack* GetTrack(int i);
    TrkTrack* GetTrackImage(int i);
    
    TrkLevel2*    GetTrkLevel2(){return this;}
    TClonesArray* GetTrackArray(){return Track;};///< returns pointer to the track array
    
    ClassDef(TrkLevel2,3);

};

#endif
1	/**
2	* \file TrkLevel2.h
3	* \author Elena Vannuccini
4	*/
5	#ifndef trklevel2_h
6	#define trklevel2_h
7
8	#include <TObject.h>
9	#include <TObjArray.h>
10	#include <TClonesArray.h>
11	#include <TRefArray.h>
12	#include <TRef.h>
13
14	#include <TrkParams.h>
15	#include <TrkLevel1.h>
16
17	// z-coordinate of track state-vector reference-plane
18	#define ZINI 23.5
19	// (mechanical) z-coordinate of the tracker planes
20	#define ZTRK6 -22.23
21	#define ZTRK5 -13.32
22	#define ZTRK4 -4.42
23	#define ZTRK3 4.48
24	#define ZTRK2 13.38
25	#define ZTRK1 22.28
26	// (mechanical) x/y-coordinates of magnet cavity
27	#define XTRKL -8.1
28	#define XTRKR 8.1
29	#define YTRKL -6.6
30	#define YTRKR 6.6
31
32	/**
33	* \brief Class to describe, by points, a particle trajectory in the apparatus.
34	*
35	* The idea is to create it by integrating the equations of motion, given the
36	* track state vector and the z coordinates where to evaluate track position.
37	*/
38	// ==================================================================
39	class Trajectory : public TObject{
40	private:
41
42	public:
43
44	int npoint; ///< number of evaluated points along the trajectory
45	float* x; ///< x coordinates
46	float* y; ///< y coordinates
47	float* z; ///< z coordinates
48	float* thx; ///< x projected angle
49	float* thy; ///< y projected angle
50	float* tl; ///< track length
51
52	Trajectory();
53	Trajectory(int n);
54	Trajectory(int n, float* pz);
55	~Trajectory(){Delete();};
56	void Dump();
57	void Delete();
58
59	int DoTrack2(float* al);
60	float GetLength(){float l=0; for(int i=0; i<npoint;i++)l=l+tl[i]; return l;};
61	float GetLength(int,int);
62
63	ClassDef(Trajectory,2);
64
65	};
66	/**
67	* \brief Class to describe fitted tracks.
68	*
69	* A track is defined by the measured coordinates associated to it, the
70	* track status vector, plus other quantities.
71	* A track may have an "image", due to the ambiguity in the y view.
72	*
73	* Cluster flags: xgood[6], ygood[6]
74	*
75	* xgood/ygood = +/- 0lsccccccc
76	* \| \|\|\|------- ID (1-7483647) of the included cluster
77	* \| \|\|-------- sensor number (1,2 - increasing y)
78	* \| \|--------- ladder number (1,2,3 - increasing x)
79	* \|------------- does-not/does include bad strips
80	*/
81	// ==================================================================
82	class TrkTrack : public TObject {
83
84	private:
85
86	int seqno; ///<stored track sequential number
87	int image; ///<sequential number of track-image
88
89	public:
90
91	float al[5]; ///<TRACK STATE VECTOR
92	float coval[5][5]; ///<covariance matrix
93	int xgood[6]; ///<cluster flag for x-view (0 = view not included in the fit)
94	int ygood[6]; ///<cluster flag for y-view (0 = view not included in the fit)
95	float xm[6]; ///<measured x coordinates
96	float ym[6]; ///<measured y coordinates
97	float zm[6]; ///<measured z coordinates
98	float resx[6]; ///<spatial resolution on X view
99	float resy[6]; ///<spatial resolution on y view
100	float tailx[6]; ///<spatial resolution tail on X view
101	float taily[6]; ///<spatial resolution tail on y view
102	float chi2; ///<chi2
103	int nstep; ///<n. step
104	float xv[6]; ///<calculated x coordinates
105	float yv[6]; ///<calculated y coordinates
106	float zv[6]; ///<calculated z coordinates
107	float axv[6]; ///<calculated angles (deg) on x view
108	float ayv[6]; ///<calculated angles (deg) on y view
109	float dedx_x[6]; ///<dE/dx in MIP (<0 if saturated)
110	float dedx_y[6]; ///<dE/dx in MIP (<0 if saturated)
111
112	TrkTrack();
113	TrkTrack(const TrkTrack&);
114
115	~TrkTrack(){ Delete(); };
116
117	void Dump();
118	void Clear();
119	void Clear(Option_t *option){Clear();};
120	void Delete();
121	void Copy(TrkTrack&);
122	// void Set();
123
124	Int_t GetSeqNo(){return seqno;} ///< Returns the track sequential number
125	Int_t GetImageSeqNo(){return image;} ///< Returns the track image sequential number
126	Bool_t HasImage(){return !(image==-1);} ///< Returns true if the track has an image
127	int DoTrack(Trajectory* t); ///< Evaluates the trajectory in the apparatus.
128	int DoTrack2(Trajectory* t); ///< Evaluates the trajectory in the apparatus.
129	float BdL(){return 0;}; ///< Evaluates the integral of B*dL along the track.
130	Int_t GetNX(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=(Int_t)XGood(i); return n;};
131	Int_t GetNY(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=(Int_t)YGood(i); return n;};
132	Int_t GetNtot(){return GetNX()+GetNY();};
133	Float_t GetRigidity();
134	Float_t GetDeflection();
135	Bool_t IsSaturated(int,int);
136	Bool_t IsSaturated(int);
137	Bool_t IsSaturated();
138	Bool_t IsBad(int,int);
139	Float_t GetDEDX();
140	Float_t GetDEDX(int);
141	Float_t GetDEDX(int,int);
142	Int_t GetLeverArmX();
143	Int_t GetLeverArmY();
144
145	void SetMeasure(double xmeas, double ymeas, double *zmeas);
146	void SetResolution(double rx, double ry);
147	void SetTail(double tx, double ty, double factor);
148	void SetStudentParam(int flag);
149	void SetGood(int xg, int yg);
150	void LoadField(TString s);
151	void Fit(double pfixed, int& fail, int iprint, int froml1);
152	void Fit(double pfixed, int& fail, int iprint){ Fit(pfixed,fail,iprint,0); };
153	void FitReset();
154	void SetTrackingMode(int trackmode);
155	void SetPrecisionFactor(double fact);
156	void SetStepMin(int istepmin);
157
158	void EvaluateClusterPositions();
159
160	void FillMiniStruct(cMini2track&);
161	void SetFromMiniStruct(cMini2track*);
162
163	Int_t GetClusterX_ID(int ip);
164	Int_t GetClusterY_ID(int ip);
165	Int_t GetLadder(int ip);
166	Int_t GetSensor(int ip);
167	Bool_t XGood(int ip){ return GetClusterX_ID(ip)!=-1; };
168	Bool_t YGood(int ip){ return GetClusterY_ID(ip)!=-1; };
169	void ResetXGood(int ip){ xgood[ip]=0; };
170	void ResetYGood(int ip){ ygood[ip]=0; };
171	void SetXGood(int ip, int clid, int is);
172	void SetYGood(int ip, int clid, int is);
173
174	Bool_t BadClusterX(int ip){ return IsBad(ip,0); };
175	Bool_t BadClusterY(int ip){ return IsBad(ip,1); };
176
177	Bool_t SaturatedClusterX(int ip){ return IsSaturated(ip,0); };
178	Bool_t SaturatedClusterY(int ip){ return IsSaturated(ip,1); };
179
180	TrkTrack* GetTrkTrack(){return this;};
181
182	friend class TrkLevel2;
183
184	ClassDef(TrkTrack,3);
185
186	};
187	/**
188	* \brief Class to describe single clusters ("singlets").
189	*
190	* Single clusters are clusters not associated to any track.
191	*/
192	class TrkSinglet : public TObject {
193
194	private:
195
196
197	public:
198
199	int plane; ///<plane
200	float coord[2]; ///<coordinate (on sensor 1 and 2)
201	float sgnl; ///<cluster signal in MIP (<0 if saturated)
202
203	TrkSinglet();
204	TrkSinglet(const TrkSinglet&);
205	~TrkSinglet(){Delete();};
206
207	void Dump();
208	void Clear();
209	void Clear(Option_t *option){Clear();};
210	void Delete(){Clear();};
211	Float_t GetSignal(){return fabs(sgnl);}
212	Bool_t IsSaturated(){return (sgnl<0); };
213
214	friend class TrkLevel2;
215
216	ClassDef(TrkSinglet,3);
217
218	};
219
220	/**
221	* \brief Class to describe tracker LEVEL2 data.
222	*
223	* A tracker events is defined by some general variables, plus the collection of all the fitted tracks and all
224	* single clusters on X and Y views.
225	* Tracks and single clusters ("singlets") are described by the classes TrkTrack and TrkSinglet respectivelly.
226	*
227	* Each track may have an "image", due to the ambiguity on the Y view, which is stored also.
228	* Thus, the number of stored tracks ( ntrk() ) differs from the number of "physical" tracks ( GetNTracks() ).
229	* Proper methods allow to sort tracks and select the physical ones ( GetTracks() ).
230	*/
231	class TrkLevel2 : public TObject {
232
233	private:
234
235	public:
236
237	Int_t good[12]; ///< event status
238	UInt_t VKmask[12]; ///< Viking-chip mask
239	UInt_t VKflag[12]; ///< Viking-chip flag
240
241	TClonesArray *Track; ///< fitted tracks
242	TClonesArray *SingletX; ///< x singlets
243	TClonesArray *SingletY; ///< y singlets
244
245	TrkLevel2();
246	// TrkLevel2(cTrkLevel2 *);
247	~TrkLevel2(){Delete();};
248
249	void Clear();
250	void Clear(Option_t *option){Clear();};
251	void Delete();
252	void Set();
253
254	int ntrk() {return Track->GetEntries();} ///< number of stored track
255	int nclsx(){return SingletX->GetEntries();} ///< number of x singlets
256	int nclsy(){return SingletY->GetEntries();} ///< number of y singlets
257
258	void Dump();
259	void SetFromLevel2Struct(cTrkLevel2 , TrkLevel1 );
260	void SetFromLevel2Struct(cTrkLevel2 *s2){ SetFromLevel2Struct(s2, NULL); };
261	void SetFromLevel2Struct(TrkLevel1 *l1) { SetFromLevel2Struct(&level2event_, l1); };
262	void SetFromLevel2Struct() { SetFromLevel2Struct(&level2event_); };
263	void GetLevel2Struct(cTrkLevel2 *) const;
264	void LoadField(TString);
265	float GetBX(float* v){return TrkParams::GetBX(v);};///< Bx (kGauss)
266	float GetBY(float* v){return TrkParams::GetBY(v);};///< By (kGauss)
267	float GetBZ(float* v){return TrkParams::GetBZ(v);};///< Bz (kGauss)
268	Float_t GetZTrk(Int_t);
269	Float_t GetXTrkLeft(){return XTRKL;};
270	Float_t GetXTrkRight(){return XTRKR;};
271	Float_t GetYTrkLeft(){return YTRKL;};
272	Float_t GetYTrkRight(){return YTRKR;};
273
274	Bool_t IsMaskedVK(int,int);
275	Bool_t GetVKMask(int,int);
276	Bool_t GetVKFlag(int,int);
277
278	TrkSinglet *GetSingletX(int);
279	TrkSinglet *GetSingletY(int);
280
281	TrkTrack *GetStoredTrack(int i);
282	Int_t GetSeqNo(Int_t i) {return (((TrkTrack *)Track->At(i))->seqno);}; ///< Returns track sequential number
283
284	TRefArray *GetTracks_NFitSorted();
285	TRefArray *GetTracks(){return this->GetTracks_NFitSorted();};
286
287	Int_t GetNTracks();
288	TrkTrack* GetTrack(int i);
289	TrkTrack* GetTrackImage(int i);
290
291	TrkLevel2* GetTrkLevel2(){return this;}
292	TClonesArray* GetTrackArray(){return Track;};///< returns pointer to the track array
293
294	ClassDef(TrkLevel2,3);
295
296	};
297
298	#endif