--- DarthVader/TrackerLevel2/inc/TrkLevel2.h	2006/06/30 09:48:15	1.4
+++ DarthVader/TrackerLevel2/inc/TrkLevel2.h	2007/08/22 07:03:44	1.30
@@ -8,15 +8,33 @@
 #include <TObject.h>
 #include <TObjArray.h>
 #include <TClonesArray.h>
+#include <TRefArray.h>
+#include <TRef.h>
 
-#include <TrkStruct.h>
+#include <TrkParams.h>
+#include <TrkLevel1.h>
 
 // z-coordinate of track state-vector reference-plane
 #define ZINI 23.5   
-// upper and lower (mechanical) z-coordinate of the tracker
-#define ZTRKUP 22.29
-#define ZTRKDW -22.22
-
+// (mechanical) z-coordinate of the tracker planes
+#define ZTRK6 -22.22
+#define ZTRK5 -13.31
+#define ZTRK4 -4.41
+#define ZTRK3 4.49
+#define ZTRK2 13.39
+#define ZTRK1 22.29
+// magnet cavity dimensions
+#define ZMAGNHIGH 21.83
+#define ZMAGNLOW -21.83
+#define XMAGNHIGH 8.07 
+#define XMAGNLOW -8.07 
+#define YMAGNHIGH 6.57 
+#define YMAGNLOW -6.57 
+// (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. 
@@ -41,12 +59,15 @@
     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,1);
+    ClassDef(Trajectory,2);
 
 };
 /**
@@ -55,6 +76,14 @@
  * 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 {
@@ -63,33 +92,41 @@
 
     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];        ///<mask of included x planes 
-    int   ygood[6];        ///<mask of included y planes 
+    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];       ///<signal in MIP (scaled to 300 micrometer)
-    float dedx_y[6];       ///<signal in MIP (scaled to 300 micrometer)
-
+    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
@@ -97,18 +134,68 @@
     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+=xgood[i]; return n;}; 
-    Int_t GetNY(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=ygood[i]; return n;};
+    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 ip);
+    Float_t GetDEDX(int ip,int iv);
+    Int_t GetLeverArmX();
+    Int_t GetLeverArmY();
+    Float_t GetChi2X();
+    Float_t GetChi2Y();
+    Float_t GetLnLX();
+    Float_t GetLnLY();
+
+    Float_t GetEffectiveAngle(int ip, int iv);
+    
+    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);
+    Bool_t IsInsideCavity();
+
+    Bool_t 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,1);
+    ClassDef(TrkTrack,3);
 
 };
 /**
@@ -119,21 +206,28 @@
 class TrkSinglet : public TObject {
 
 private:
+	
 
 public:
-
+	
     int plane;       ///<plane 
     float coord[2];  ///<coordinate (on sensor 1 and 2)
-    float sgnl;      ///<cluster signal in MIP 
+    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,1);
+    ClassDef(TrkSinglet,3);
 
 };
 
@@ -147,17 +241,62 @@
  * 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() ).
+ *
+ * The event status indicates the processing status of data from each DSP, according to the following
+ * notation:
+ *
+ *     xxxx xxxx xxxx xxxx xxxx xxxx 
+ *     |||| |||| |||| |||| |||| ||||_ 0 missing packet
+ *     |||| |||| |||| |||| |||| |||__ 1 CRC error
+ *     |||| |||| |||| |||| |||| ||___ 2 on-line software alarm (latch-up, timeout ecc...)
+ *     |||| |||| |||| |||| |||| |____ 3 jump in the trigger counter
+ *     |||| |||| |||| |||| ||||______ 4 decode error
+ *     |||| |||| |||| |||| |||_______ 5 n.clusters > maximum number (level1 processing)
+ *     |||| |||| |||| |||| ||________ 6 
+ *     |||| |||| |||| |||| |_________ 7 
+ *     |||| |||| |||| ||||___________ 8 n.clusters > maximum value (level2 processing)
+ *     |||| |||| |||| |||____________ 9 n.couples per plane > maximum values (vector dimention)
+ *     |||| |||| |||| ||_____________ 10 n.doublets > maximum values
+ *     |||| |||| |||| |______________ 11 n.triplets > maximum values
+ *     |||| |||| ||||________________ 12 n.yz-clouds > maximum values
+ *     |||| |||| |||_________________ 13 n.xz-clouds > maximum values 
+ *     |||| |||| ||__________________ 14 n.candidate-tracks > maximum values
+ *     |||| |||| |___________________ 15 n.couples per plane > maximum values (for Hough transform)
+ *     |||| ||||_____________________ 16 
+ *         
+ *
+ * For all data processed before June 2007 the event status was coded according to
+ * a different rule:
+ *
+ * Status of level1 processing
+ *  0 -- OK  
+ *  1 -- missing packet
+ *  2 -- 1  CRC error
+ *  3 -- 2 on-line software alarm (latch-up flags asserted or n.transmitted-words = 0)
+ *  4 -- 3 jump in the trigger counter
+ * 10 -- 4 decode error
+ * 11 -- 5  n.clusters > maximum number (for level1 processing)
+ * Status of level2 processing
+ * 21 -- 0 n.clusters > maximum value (for level2 processing)
+ * 22 -- 1 n.couples per plane > maximum values (vector dimention)
+ * 23 -- 2 n.doublets > maximum values 
+ * 24 -- 3 n.triplets > maximum values 
+ * 25 -- 4 n.yz-clouds > maximum values 
+ * 26 -- 5 n.xz-clouds > maximum values 
+ * 27 -- 6 n.candidate-tracks > maximum values 
+ * 28 -- 7 n.couples per plane > maximum values (for Hough transform)
+ *  
+ * 
  */
 class TrkLevel2 : public TObject {
 
  private:
-
+ 
  public:
 
-
-
-    Int_t good2;
-    Int_t crc[12];
+    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
@@ -165,34 +304,58 @@
 
     TrkLevel2();
 //    TrkLevel2(cTrkLevel2 *);
-
-    int ntrk() {return Track->GetEntries();}     ///< number of stored track
+    ~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 FillCommonVar(cTrkLevel2 *);
-    void Clear();
+    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
-    TClonesArray *GetTracks_Chi2Sorted();
-    TClonesArray *GetTracks_NFitSorted();
-    TClonesArray *GetTracks();
-
-//    int       GetNTracks(){return this->GetTracks()->GetEntries();}
-	Int_t     GetNTracks();
-	TrkTrack* GetTrack(int i);
-    TrkTrack* GetTrackImage(int i);
 
+    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,1);
-
-};
+    void   StatusDump(int view);
+    Bool_t StatusCheck(int view, int flagmask);
 
+    ClassDef(TrkLevel2,3);
 
+};
 
 #endif