--- DarthVader/TrackerLevel2/inc/TrkLevel2.h	2008/11/25 14:41:35	1.38
+++ DarthVader/TrackerLevel2/inc/TrkLevel2.h	2014/02/27 11:24:42	1.45
@@ -15,7 +15,7 @@
 #include <TrkLevel1.h>
 
 // z-coordinate of track state-vector reference-plane
-#define ZINI 23.5   
+#define ZINI 23.5 ///< z-coordinate of track state-vector reference-plane.
 // (mechanical) z-coordinate of the tracker planes
 #define ZTRK6 -22.22
 #define ZTRK5 -13.31
@@ -67,12 +67,17 @@
     Trajectory();
     Trajectory(int n);
     Trajectory(int n, float* pz);
-    ~Trajectory(){Delete();};
+    ~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;};
+    int DoTrack(float* al, float zini);
+    int DoTrack(float* al){ return DoTrack(al,23.5); }
+
+    int DoTrack2(float* al, float zini);
+    int DoTrack2(float* al){ return DoTrack2(al,23.5); }
+
+    float GetLength(){float l=0; for(int i=0; i<npoint;i++)l=l+tl[i]; return l;}
     float GetLength(int,int);
 
     ClassDef(Trajectory,3);
@@ -104,7 +109,18 @@
     int   seqno;           ///<stored track sequential number
     int   image;           ///<sequential number of track-image
 	
-    float al[5];           ///<TRACK STATE VECTOR 
+    /*! @brief Track state vector.
+     *
+     *  This is the track state vector on reference plane defined by #ZINI.
+     *
+     *  al[0]: X coordinate [cm]
+     *  al[1]: Y coordinate [cm]
+     *  al[2]: sin theta (altitude; theta = 0 is normal incidence)
+     *  al[3]: phi (azimuth; phi = 0 is negative X axis)
+     *  al[4]: deflection (with sign) [1/GV]
+     *
+     */
+    float al[5];
     float coval[5][5];     ///<covariance matrix 
     int   xgood[6];        ///<cluster id for x-view (0 = view not included in the fit) 
     int   ygood[6];        ///<cluster id for y-view (0 = view not included in the fit) 
@@ -137,11 +153,11 @@
     TrkTrack();
     TrkTrack(const TrkTrack&);
 
-    ~TrkTrack(){ Delete(); };
+    ~TrkTrack(){ Delete(); }
 	
     void Dump();
     void Clear();
-    void Clear(Option_t *option){Clear();};
+    void Clear(Option_t *option){Clear();}
     void Delete();
     void Copy(TrkTrack&);
 //    void Set();
@@ -151,10 +167,11 @@
     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 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 GetNXY(){Int_t n=0; for(Int_t i=0; i<6; i++)n+=(Int_t)YGood(i)*XGood(i); return n;}
+    Int_t GetNtot(){return GetNX()+GetNY();}
     Float_t GetRigidity();
     Float_t GetDeflection();
     Bool_t IsSaturated(int,int);
@@ -164,6 +181,7 @@
     Float_t GetDEDX();
     Float_t GetDEDX(int ip);
     Float_t GetDEDX(int ip,int iv);
+    Int_t GetLeverArmXY();
     Int_t GetLeverArmX();
     Int_t GetLeverArmY();
     Float_t GetChi2X();
@@ -180,7 +198,7 @@
     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 Fit(double pfixed, int& fail, int iprint){ Fit(pfixed,fail,iprint,0); }
     void FitReset();
     void SetTrackingMode(int trackmode);
     void SetPrecisionFactor(double fact);
@@ -188,42 +206,47 @@
     void SetDeltaB(int id, double db);
 
     Bool_t IsInsideCavity(float);
-    Bool_t IsInsideCavity(){ return IsInsideCavity(0.); };
-    Bool_t IsInsideAcceptance();
+    Bool_t IsInsideCavity(){ return IsInsideCavity(0.); }
+    Bool_t IsInsideAcceptance(float);
+    Bool_t IsInsideAcceptance(){ return IsInsideAcceptance(0.); }
+    Bool_t IsInsideGFSurface(const char*,float);
+    Bool_t IsInsideGFSurface(const char* surf){ return IsInsideGFSurface(surf,0.); }
 
     Bool_t EvaluateClusterPositions();
 
     void FillMiniStruct(cMini2track&);
     void SetFromMiniStruct(cMini2track*);
+    void FillMiniStruct(){ extern cMini2track track_; FillMiniStruct(track_); };
+    void SetFromMiniStruct(){extern cMini2track track_; SetFromMiniStruct(&track_);};
     
     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 ResetXGoo(int ip){ xgood[ip]=0; };
-    void ResetYGood(int ip){ ygood[ip]=0; };
+    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); */
     void SetXGood(int ip, int clid, int il, int is, bool bad);
     void SetYGood(int ip, int clid, int il, int is, bool bad);
-    void SetXGood(int ip, int clid, int il, int is){ SetXGood(ip,clid,il,is,false); };
-    void SetYGood(int ip, int clid, int il, int is){ SetYGood(ip,clid,il,is,false); };
+    void SetXGood(int ip, int clid, int il, int is){ SetXGood(ip,clid,il,is,false); }
+    void SetYGood(int ip, int clid, int il, int is){ SetYGood(ip,clid,il,is,false); }
 
 
-    Bool_t BadClusterX(int ip){ return IsBad(ip,0); };
-    Bool_t BadClusterY(int ip){ return IsBad(ip,1); };
+    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); };
-
-    Int_t GetClusterX_Multiplicity(int ip){ return (Int_t)(multmaxx[ip]/10000); };
-    Int_t GetClusterY_Multiplicity(int ip){ return (Int_t)(multmaxy[ip]/10000); };
-    Int_t GetClusterX_MaxStrip(int ip){ return (Int_t)(multmaxx[ip]%10000); };
-    Int_t GetClusterY_MaxStrip(int ip){ return (Int_t)(multmaxy[ip]%10000); };
-    Float_t GetClusterX_Seed(int ip){ return seedx[ip]; };
-    Float_t GetClusterY_Seed(int ip){ return seedy[ip]; };
+    Bool_t SaturatedClusterX(int ip){ return IsSaturated(ip,0); }
+    Bool_t SaturatedClusterY(int ip){ return IsSaturated(ip,1); }
+
+    Int_t GetClusterX_Multiplicity(int ip){ return (Int_t)(multmaxx[ip]/10000); }
+    Int_t GetClusterY_Multiplicity(int ip){ return (Int_t)(multmaxy[ip]/10000); }
+    Int_t GetClusterX_MaxStrip(int ip){ return (Int_t)(multmaxx[ip]%10000); }
+    Int_t GetClusterY_MaxStrip(int ip){ return (Int_t)(multmaxy[ip]%10000); }
+    Float_t GetClusterX_Seed(int ip){ return seedx[ip]; }
+    Float_t GetClusterY_Seed(int ip){ return seedy[ip]; }
 /*     Float_t GetClusterX_oordinatePU(int ip); */
 /*     Float_t GetClusterY_CoordinatePU(int ip); */
     
@@ -234,18 +257,18 @@
     Int_t GetNColumns();
 
     Float_t GetDEDX_max(int ip, int iv);
-    Float_t GetDEDX_max(int iv){ return GetDEDX_max(-1,iv); };
-    Float_t GetDEDX_max(){ return GetDEDX_max(-1,-1); };
+    Float_t GetDEDX_max(int iv){ return GetDEDX_max(-1,iv); }
+    Float_t GetDEDX_max(){ return GetDEDX_max(-1,-1); }
     Float_t GetDEDX_min(int ip, int iv);
-    Float_t GetDEDX_min(int iv){ return GetDEDX_min(-1,iv); };
-    Float_t GetDEDX_min(){ return GetDEDX_min(-1,-1); };
+    Float_t GetDEDX_min(int iv){ return GetDEDX_min(-1,iv); }
+    Float_t GetDEDX_min(){ return GetDEDX_min(-1,-1); }
 
     Float_t GetResidual_max(int ip, int iv);
-    Float_t GetResidual_max(int iv){ return GetResidual_max(-1,iv); };
-    Float_t GetResidual_max(){ return GetResidual_max(-1,-1); };
+    Float_t GetResidual_max(int iv){ return GetResidual_max(-1,iv); }
+    Float_t GetResidual_max(){ return GetResidual_max(-1,-1); }
     Float_t GetResidual_av(int ip, int iv);
-    Float_t GetResidual_av(int iv){ return GetResidual_av(-1,iv); };
-    Float_t GetResidual_av(){ return GetResidual_av(-1,-1); };
+    Float_t GetResidual_av(int iv){ return GetResidual_av(-1,iv); }
+    Float_t GetResidual_av(){ return GetResidual_av(-1,-1); }
 
     Int_t GetClusterX_Multiplicity_max();
     Int_t GetClusterX_Multiplicity_min();
@@ -255,7 +278,7 @@
     Float_t GetClusterX_Seed_min();
     Float_t GetClusterY_Seed_min();
 
-    TrkTrack* GetTrkTrack(){return this;};
+    TrkTrack* GetTrkTrack(){return this;}
 
     friend class TrkLevel2;
 
@@ -281,18 +304,18 @@
 
     TrkSinglet();
     TrkSinglet(const TrkSinglet&);
-    ~TrkSinglet(){Delete();};
+    ~TrkSinglet(){Delete();}
 
     void Dump();
     void Clear();
-    void Clear(Option_t *option){Clear();};
+    void Clear(Option_t *option){Clear();}
     void Delete(){Clear();};
     Float_t GetSignal(){return fabs(sgnl);}
-    Bool_t IsSaturated(){return (sgnl<0); };
+    Bool_t IsSaturated(){return (sgnl<0); }
 
-    Bool_t IsBad()                 { return multmax<=0; };
-    Int_t GetCluster_Multiplicity(){ return (Int_t)(abs(multmax)/10000); };
-    Int_t GetCluster_MaxStrip()    { return (Int_t)(abs(multmax)%10000); };
+    Bool_t IsBad()                 { return multmax<=0; }
+    Int_t GetCluster_Multiplicity(){ return (Int_t)(abs(multmax)/10000); }
+    Int_t GetCluster_MaxStrip()    { return (Int_t)(abs(multmax)%10000); }
 
 
     friend class TrkLevel2;
@@ -316,40 +339,44 @@
  * notation:
  *
  * LSB --> 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)
- *
  * MSB --> 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)
  *  
  * 
  */
@@ -369,13 +396,13 @@
 
     TrkLevel2();
 //    TrkLevel2(cTrkLevel2 *);
-    ~TrkLevel2(){Delete();};
+    ~TrkLevel2(){Delete();}
 	
     void Clear();
-    void Clear(Option_t *option){Clear();};
+    void Clear(Option_t *option){Clear();}
     void Delete();
     void Set();
-    int UnpackError(){ for(int i=0; i<12; i++)if(StatusCheck(i,0x12))return 1; return 0;};
+    int UnpackError(){ for(int i=0; i<12; i++)if(!StatusCheck(i,0x12))return 1; return 0;}
     
     int ntrk() {return Track->GetEntries();}    ///< number of stored track
     int nclsx(){return SingletX->GetEntries();} ///< number of x singlets 
@@ -383,19 +410,19 @@
 
     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 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 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 XMAGNLOW;};
-    Float_t GetXTrkRight(){return XMAGNHIGH;};
-    Float_t GetYTrkLeft(){return YMAGNLOW;};
-    Float_t GetYTrkRight(){return YMAGNHIGH;};
+    Float_t GetXTrkLeft(){return XMAGNLOW;}
+    Float_t GetXTrkRight(){return XMAGNHIGH;}
+    Float_t GetYTrkLeft(){return YMAGNLOW;}
+    Float_t GetYTrkRight(){return YMAGNHIGH;}
     
     Bool_t IsMaskedVK(int,int);
     Bool_t GetVKMask(int,int);
@@ -405,17 +432,17 @@
     TrkSinglet   *GetSingletY(int);
     
     TrkTrack     *GetStoredTrack(int i);
-    Int_t         GetSeqNo(Int_t i)  {return (((TrkTrack *)Track->At(i))->seqno);}; ///< Returns track sequential number
+    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();};
+    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
+    TClonesArray* GetTrackArray(){return Track;}///< returns pointer to the track array
     
     void   StatusDump(int view);
     Bool_t StatusCheck(int view, int flagmask);