--- DarthVader/TrackerLevel2/inc/TrkLevel2.h	2009/02/03 13:57:14	1.41
+++ DarthVader/TrackerLevel2/inc/TrkLevel2.h	2011/09/01 16:01:32	1.43
@@ -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
@@ -109,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) 
@@ -156,7 +167,7 @@
     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.
+    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;};
@@ -196,7 +207,10 @@
 
     Bool_t IsInsideCavity(float);
     Bool_t IsInsideCavity(){ return IsInsideCavity(0.); };
-    Bool_t IsInsideAcceptance();
+    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();