/[PAMELA software]/DarthVader/TrackerLevel2/inc/TrkLevel2.h
ViewVC logotype

Contents of /DarthVader/TrackerLevel2/inc/TrkLevel2.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.37 - (show annotations) (download)
Wed Oct 22 15:17:32 2008 UTC (16 years, 1 month ago) by pam-fi
Branch: MAIN
Changes since 1.36: +4 -0 lines
File MIME type: text/plain
fixed bug in TrkHough track + new method UnpackError()

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.22
21 #define ZTRK5 -13.31
22 #define ZTRK4 -4.41
23 #define ZTRK3 4.49
24 #define ZTRK2 13.39
25 #define ZTRK1 22.29
26 // magnet cavity dimensions
27 #define ZMAGNHIGH 21.83
28 #define ZMAGNLOW -21.83
29 #define XMAGNHIGH 8.07
30 #define XMAGNLOW -8.07
31 #define YMAGNHIGH 6.57
32 #define YMAGNLOW -6.57
33 // tof planes
34 #define ZS11 53.74
35 #define ZS12 53.04
36 #define ZS21 23.94
37 #define ZS22 23.44
38 #define ZS31 -23.49
39 #define ZS32 -24.34
40
41 // (mechanical) x/y-coordinates of magnet cavity
42 /* #define XTRKL -8.1 */
43 /* #define XTRKR 8.1 */
44 /* #define YTRKL -6.6 */
45 /* #define YTRKR 6.6 */
46
47 /**
48 * \brief Class to describe, by points, a particle trajectory in the apparatus.
49 *
50 * The idea is to create it by integrating the equations of motion, given the
51 * track state vector and the z coordinates where to evaluate track position.
52 */
53 // ==================================================================
54 class Trajectory : public TObject{
55 private:
56
57 public:
58
59 int npoint; ///< number of evaluated points along the trajectory
60 float* x; //[npoint]
61 float* y; //[npoint]
62 float* z; //[npoint]
63 float* thx; //[npoint]
64 float* thy; //[npoint]
65 float* tl; //[npoint]
66
67 Trajectory();
68 Trajectory(int n);
69 Trajectory(int n, float* pz);
70 ~Trajectory(){Delete();};
71 void Dump();
72 void Delete();
73
74 int DoTrack2(float* al);
75 float GetLength(){float l=0; for(int i=0; i<npoint;i++)l=l+tl[i]; return l;};
76 float GetLength(int,int);
77
78 ClassDef(Trajectory,3);
79
80 };
81 /**
82 * \brief Class to describe fitted tracks.
83 *
84 * A track is defined by the measured coordinates associated to it, the
85 * track status vector, plus other quantities.
86 * A track may have an "image", due to the ambiguity in the y view.
87 *
88 * Cluster flags: xgood[6], ygood[6]
89 *
90 * xgood/ygood = +/- 0lsccccccc
91 * ccccccc ID (1-7483647) of the included cluster
92 * s sensor number (1,2 - increasing y)
93 * l ladder number (1,2,3 - increasing x)
94 * +/- does-not/does include bad strips
95 *
96 */
97 // ==================================================================
98 class TrkTrack : public TObject {
99
100 private:
101
102 public:
103
104 int seqno; ///<stored track sequential number
105 int image; ///<sequential number of track-image
106
107 float al[5]; ///<TRACK STATE VECTOR
108 float coval[5][5]; ///<covariance matrix
109 int xgood[6]; ///<cluster id for x-view (0 = view not included in the fit)
110 int ygood[6]; ///<cluster id for y-view (0 = view not included in the fit)
111 float xm[6]; ///<measured x coordinates
112 float ym[6]; ///<measured y coordinates
113 float zm[6]; ///<measured z coordinates
114 float resx[6]; ///<spatial resolution on X view
115 float resy[6]; ///<spatial resolution on y view
116 float tailx[6]; ///<spatial resolution tail on X view
117 float taily[6]; ///<spatial resolution tail on y view
118 float chi2; ///<chi2
119 int nstep; ///<n.step
120 float xv[6]; ///<calculated x coordinates
121 float yv[6]; ///<calculated y coordinates
122 float zv[6]; ///<calculated z coordinates
123 float axv[6]; ///<calculated angles (deg) on x view
124 float ayv[6]; ///<calculated angles (deg) on y view
125 float dedx_x[6]; ///<dE/dx in MIP (<0 if saturated)
126 float dedx_y[6]; ///<dE/dx in MIP (<0 if saturated)
127 int multmaxx[6]; ///<cluster multiplicity and strip of maximum on x view
128 int multmaxy[6]; ///<cluster multiplicity and strip of maximum on y view
129 float seedx[6]; ///< seed of the cluster x
130 float seedy[6]; ///< seed of the cluster y
131 float xpu[6]; ///< x coordinate in pitch units
132 float ypu[6]; ///< y coordinate in pitch units
133
134 float xGF[14]; ///<calculated x coordinates on GF reference planes
135 float yGF[14]; ///<calculated y coordinates on GF reference planes
136
137 TrkTrack();
138 TrkTrack(const TrkTrack&);
139
140 ~TrkTrack(){ Delete(); };
141
142 void Dump();
143 void Clear();
144 void Clear(Option_t *option){Clear();};
145 void Delete();
146 void Copy(TrkTrack&);
147 // void Set();
148
149 Int_t GetSeqNo(){return seqno;} ///< Returns the track sequential number
150 Int_t GetImageSeqNo(){return image;} ///< Returns the track image sequential number
151 Bool_t HasImage(){return !(image==-1);} ///< Returns true if the track has an image
152 int DoTrack(Trajectory* t); ///< Evaluates the trajectory in the apparatus.
153 int DoTrack2(Trajectory* t); ///< Evaluates the trajectory in the apparatus.
154 float BdL(){return 0;}; ///< Evaluates the integral of B*dL along the track.
155 Int_t GetNX(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=(Int_t)XGood(i); return n;};
156 Int_t GetNY(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=(Int_t)YGood(i); return n;};
157 Int_t GetNtot(){return GetNX()+GetNY();};
158 Float_t GetRigidity();
159 Float_t GetDeflection();
160 Bool_t IsSaturated(int,int);
161 Bool_t IsSaturated(int);
162 Bool_t IsSaturated();
163 Bool_t IsBad(int,int);
164 Float_t GetDEDX();
165 Float_t GetDEDX(int ip);
166 Float_t GetDEDX(int ip,int iv);
167 Int_t GetLeverArmX();
168 Int_t GetLeverArmY();
169 Float_t GetChi2X();
170 Float_t GetChi2Y();
171 Float_t GetLnLX();
172 Float_t GetLnLY();
173
174 Float_t GetEffectiveAngle(int ip, int iv);
175
176 void SetMeasure(double *xmeas, double *ymeas, double *zmeas);
177 void SetResolution(double *rx, double *ry);
178 void SetTail(double *tx, double *ty, double factor);
179 void SetStudentParam(int flag);
180 void SetGood(int *xg, int *yg);
181 void LoadField(TString s);
182 void Fit(double pfixed, int& fail, int iprint, int froml1);
183 void Fit(double pfixed, int& fail, int iprint){ Fit(pfixed,fail,iprint,0); };
184 void FitReset();
185 void SetTrackingMode(int trackmode);
186 void SetPrecisionFactor(double fact);
187 void SetStepMin(int istepmin);
188 void SetDeltaB(int id, double db);
189
190 Bool_t IsInsideCavity(float);
191 Bool_t IsInsideCavity(){ return IsInsideCavity(0.); };
192 Bool_t IsInsideAcceptance();
193
194 Bool_t EvaluateClusterPositions();
195
196 void FillMiniStruct(cMini2track&);
197 void SetFromMiniStruct(cMini2track*);
198
199 Int_t GetClusterX_ID(int ip);
200 Int_t GetClusterY_ID(int ip);
201 Int_t GetLadder(int ip);
202 Int_t GetSensor(int ip);
203 Bool_t XGood(int ip){ return GetClusterX_ID(ip)!=-1; };
204 Bool_t YGood(int ip){ return GetClusterY_ID(ip)!=-1; };
205 void ResetXGoo(int ip){ xgood[ip]=0; };
206 void ResetYGood(int ip){ ygood[ip]=0; };
207 /* void SetXGood(int ip, int clid, int is); */
208 /* void SetYGood(int ip, int clid, int is); */
209 void SetXGood(int ip, int clid, int il, int is, bool bad);
210 void SetYGood(int ip, int clid, int il, int is, bool bad);
211 void SetXGood(int ip, int clid, int il, int is){ SetXGood(ip,clid,il,is,false); };
212 void SetYGood(int ip, int clid, int il, int is){ SetYGood(ip,clid,il,is,false); };
213
214
215 Bool_t BadClusterX(int ip){ return IsBad(ip,0); };
216 Bool_t BadClusterY(int ip){ return IsBad(ip,1); };
217
218 Bool_t SaturatedClusterX(int ip){ return IsSaturated(ip,0); };
219 Bool_t SaturatedClusterY(int ip){ return IsSaturated(ip,1); };
220
221 Int_t GetClusterX_Multiplicity(int ip){ return (Int_t)(multmaxx[ip]/10000); };
222 Int_t GetClusterY_Multiplicity(int ip){ return (Int_t)(multmaxy[ip]/10000); };
223 Int_t GetClusterX_MaxStrip(int ip){ return (Int_t)(multmaxx[ip]%10000); };
224 Int_t GetClusterY_MaxStrip(int ip){ return (Int_t)(multmaxy[ip]%10000); };
225 Float_t GetClusterX_Seed(int ip){ return seedx[ip]; };
226 Float_t GetClusterY_Seed(int ip){ return seedy[ip]; };
227 /* Float_t GetClusterX_oordinatePU(int ip); */
228 /* Float_t GetClusterY_CoordinatePU(int ip); */
229
230 Float_t GetYav();
231 Float_t GetXav();
232 Float_t GetZav();
233
234 Int_t GetNColumns();
235
236 Float_t GetDEDX_max(int ip, int iv);
237 Float_t GetDEDX_max(int iv){ return GetDEDX_max(-1,iv); };
238 Float_t GetDEDX_max(){ return GetDEDX_max(-1,-1); };
239 Float_t GetDEDX_min(int ip, int iv);
240 Float_t GetDEDX_min(int iv){ return GetDEDX_min(-1,iv); };
241 Float_t GetDEDX_min(){ return GetDEDX_min(-1,-1); };
242
243 Float_t GetResidual_max(int ip, int iv);
244 Float_t GetResidual_max(int iv){ return GetResidual_max(-1,iv); };
245 Float_t GetResidual_max(){ return GetResidual_max(-1,-1); };
246 Float_t GetResidual_av(int ip, int iv);
247 Float_t GetResidual_av(int iv){ return GetResidual_av(-1,iv); };
248 Float_t GetResidual_av(){ return GetResidual_av(-1,-1); };
249
250 Int_t GetClusterX_Multiplicity_max();
251 Int_t GetClusterX_Multiplicity_min();
252 Int_t GetClusterY_Multiplicity_max();
253 Int_t GetClusterY_Multiplicity_min();
254
255 Float_t GetClusterX_Seed_min();
256 Float_t GetClusterY_Seed_min();
257
258 TrkTrack* GetTrkTrack(){return this;};
259
260 friend class TrkLevel2;
261
262 ClassDef(TrkTrack,5);
263
264 };
265 /**
266 * \brief Class to describe single clusters ("singlets").
267 *
268 * Single clusters are clusters not associated to any track.
269 */
270 class TrkSinglet : public TObject {
271
272 private:
273
274
275 public:
276
277 int plane; ///<plane
278 float coord[2]; ///<coordinate (on sensor 1 and 2)
279 float sgnl; ///<cluster signal in MIP (<0 if saturated)
280 int multmax; ///<cluster multiplicity and strip of maximum
281
282 TrkSinglet();
283 TrkSinglet(const TrkSinglet&);
284 ~TrkSinglet(){Delete();};
285
286 void Dump();
287 void Clear();
288 void Clear(Option_t *option){Clear();};
289 void Delete(){Clear();};
290 Float_t GetSignal(){return fabs(sgnl);}
291 Bool_t IsSaturated(){return (sgnl<0); };
292
293 Bool_t IsBad() { return multmax<=0; };
294 Int_t GetCluster_Multiplicity(){ return (Int_t)(abs(multmax)/10000); };
295 Int_t GetCluster_MaxStrip() { return (Int_t)(abs(multmax)%10000); };
296
297
298 friend class TrkLevel2;
299
300 ClassDef(TrkSinglet,4);
301
302 };
303
304 /**
305 * \brief Class to describe tracker LEVEL2 data.
306 *
307 * A tracker events is defined by some general variables, plus the collection of all the fitted tracks and all
308 * single clusters on X and Y views.
309 * Tracks and single clusters ("singlets") are described by the classes TrkTrack and TrkSinglet respectivelly.
310 *
311 * Each track may have an "image", due to the ambiguity on the Y view, which is stored also.
312 * Thus, the number of stored tracks ( ntrk() ) differs from the number of "physical" tracks ( GetNTracks() ).
313 * Proper methods allow to sort tracks and select the physical ones ( GetTracks() ).
314 *
315 * The event status indicates the processing status of data from each DSP, according to the following
316 * notation:
317 *
318 * LSB --> 0 missing packet
319 * 1 CRC error
320 * 2 on-line software alarm (latch-up, timeout ecc...)
321 * 3 jump in the trigger counter
322 * 4 decode error
323 * 5 n.clusters > maximum number (level1 processing)
324 * 6
325 * 7
326 * 8 n.clusters > maximum value (level2 processing)
327 * 9 n.couples per plane > maximum values (vector dimention)
328 * 10 n.doublets > maximum values
329 * 11 n.triplets > maximum values
330 * 12 n.yz-clouds > maximum values
331 * 13 n.xz-clouds > maximum values
332 * 14 n.candidate-tracks > maximum values
333 * 15 n.couples per plane > maximum values (for Hough transform)
334 * MSB --> 16
335 *
336 *
337 * For all data processed before June 2007 the event status was coded according to
338 * a different rule:
339 *
340 * Status of level1 processing
341 * 0 -- OK
342 * 1 -- missing packet
343 * 2 -- 1 CRC error
344 * 3 -- 2 on-line software alarm (latch-up flags asserted or n.transmitted-words = 0)
345 * 4 -- 3 jump in the trigger counter
346 * 10 -- 4 decode error
347 * 11 -- 5 n.clusters > maximum number (for level1 processing)
348 * Status of level2 processing
349 * 21 -- 0 n.clusters > maximum value (for level2 processing)
350 * 22 -- 1 n.couples per plane > maximum values (vector dimention)
351 * 23 -- 2 n.doublets > maximum values
352 * 24 -- 3 n.triplets > maximum values
353 * 25 -- 4 n.yz-clouds > maximum values
354 * 26 -- 5 n.xz-clouds > maximum values
355 * 27 -- 6 n.candidate-tracks > maximum values
356 * 28 -- 7 n.couples per plane > maximum values (for Hough transform)
357 *
358 *
359 */
360 class TrkLevel2 : public TObject {
361
362 private:
363
364 public:
365
366 Int_t good[12]; ///< event status
367 UInt_t VKmask[12]; ///< Viking-chip mask
368 UInt_t VKflag[12]; ///< Viking-chip flag
369
370 TClonesArray *Track; ///< fitted tracks
371 TClonesArray *SingletX; ///< x singlets
372 TClonesArray *SingletY; ///< y singlets
373
374 TrkLevel2();
375 // TrkLevel2(cTrkLevel2 *);
376 ~TrkLevel2(){Delete();};
377
378 void Clear();
379 void Clear(Option_t *option){Clear();};
380 void Delete();
381 void Set();
382 int UnpackError(){ for(int i=0; i<12; i++)if(StatusCheck(i,0x12))return 1; return 0;};
383
384 int ntrk() {return Track->GetEntries();} ///< number of stored track
385 int nclsx(){return SingletX->GetEntries();} ///< number of x singlets
386 int nclsy(){return SingletY->GetEntries();} ///< number of y singlets
387
388 void Dump();
389 void SetFromLevel2Struct(cTrkLevel2 *, TrkLevel1 *);
390 void SetFromLevel2Struct(cTrkLevel2 *s2){ SetFromLevel2Struct(s2, NULL); };
391 void SetFromLevel2Struct(TrkLevel1 *l1) { SetFromLevel2Struct(&level2event_, l1); };
392 void SetFromLevel2Struct() { SetFromLevel2Struct(&level2event_); };
393 void GetLevel2Struct(cTrkLevel2 *) const;
394 void LoadField(TString);
395 float GetBX(float* v){return TrkParams::GetBX(v);};///< Bx (kGauss)
396 float GetBY(float* v){return TrkParams::GetBY(v);};///< By (kGauss)
397 float GetBZ(float* v){return TrkParams::GetBZ(v);};///< Bz (kGauss)
398 Float_t GetZTrk(Int_t);
399 Float_t GetXTrkLeft(){return XMAGNLOW;};
400 Float_t GetXTrkRight(){return XMAGNHIGH;};
401 Float_t GetYTrkLeft(){return YMAGNLOW;};
402 Float_t GetYTrkRight(){return YMAGNHIGH;};
403
404 Bool_t IsMaskedVK(int,int);
405 Bool_t GetVKMask(int,int);
406 Bool_t GetVKFlag(int,int);
407
408 TrkSinglet *GetSingletX(int);
409 TrkSinglet *GetSingletY(int);
410
411 TrkTrack *GetStoredTrack(int i);
412 Int_t GetSeqNo(Int_t i) {return (((TrkTrack *)Track->At(i))->seqno);}; ///< Returns track sequential number
413
414 TRefArray *GetTracks_NFitSorted();
415 TRefArray *GetTracks(){return this->GetTracks_NFitSorted();};
416
417 Int_t GetNTracks();
418 TrkTrack* GetTrack(int i);
419 TrkTrack* GetTrackImage(int i);
420
421 TrkLevel2* GetTrkLevel2(){return this;}
422 TClonesArray* GetTrackArray(){return Track;};///< returns pointer to the track array
423
424 void StatusDump(int view);
425 Bool_t StatusCheck(int view, int flagmask);
426
427 ClassDef(TrkLevel2,3);
428
429 };
430
431 #endif

  ViewVC Help
Powered by ViewVC 1.1.23