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