--- DarthVader/TrackerLevel2/inc/TrkParams.h	2007/02/16 14:56:00	1.1
+++ DarthVader/TrackerLevel2/inc/TrkParams.h	2007/05/15 16:22:19	1.6
@@ -19,6 +19,43 @@
 /**
  * \brief Class to store tracker parameter information
  * 
+ * Tracker parameters include calibration parameters (PED, SIG and BAD), 
+ * parameters loaded from DB (alignment, ADC-to-mip, etc. ) and some parameters 
+ * to configure tracker processing (PFA, ecc...).
+ *
+ * Calibrations can be either those evaluated online or default values.
+ * External parameter are labelled according to the DB convention:
+ *
+ * type  description
+ * -----------------
+ * 1     field
+ * 2     adc-to-mip
+ * 3     charge-correlation
+ * 4     p.f.a. (eta)
+ * 5     alignment
+ * 6     VA1 mask
+ * 7     default calibration
+ *
+ * Internal parameters are initialized to default values 
+ * (NB!! the same values set in analisysflight.f).
+ *
+ * TrkParams::SetCalib(...) and TrkParams::Set(...) methods allow to set 
+ * required parameters, from an input path, from the DB (for a given input 
+ * run id) and from environment variable PAM_CALIB.
+ * TrkParams::LoadCalib() and TrkParams::Load() methods load parameters into
+ * F77 common. 
+ * 
+ * Tracker libraries (TrkLevel0, TrkLevel1 and TrkLevel2) implement automatic
+ * setting (either from DB or from environment variables) and loading of parameters.
+ * If one needs to load custom parameters, it is enough to call TrkParams::Set(...)
+ * with proper arguments. All the methods are static, and can be used as standalone functions. 
+ *
+ * For example: 
+ *
+ * TrkParams::Set("/param-path/new-mip-param/",2);
+ * 
+ * After this instruction (to be called once), new adc-to-mip conversion parameters 
+ * will be loaded automatically (once) and used until the next set instruction 
  */
 class TrkParams : public TObject {
 
@@ -43,6 +80,13 @@
     static GL_PARAM  gl[NTYPES]; 
     static TString   glpath[NTYPES];
     static Bool_t    glload[NTYPES];
+    // -----------------------------------------------
+    // some parameters to configure tracker processing
+    // -----------------------------------------------
+    static int init__pfa;
+    static int init__mini_trackmode;
+    static int init__mini_istepmin;
+    static double init__mini_fact;
     
     TrkParams();
     
@@ -52,6 +96,7 @@
     static Bool_t SetCalib( GL_RUN* , TSQLServer*  );
     static Bool_t LoadCalib( );
     static Bool_t CalibIsLoaded(){ return calibload; };
+    static UInt_t ValidateTrkCalib( CalibTrk1Event* );
     static void FillFCalibFrom(TFile* , Int_t , Int_t );//full
     static void FillTCalibFrom(TFile* , Int_t , Int_t );//truncated
     static void FillTCalibFrom(TString path);
@@ -75,7 +120,42 @@
     static Bool_t IsLoaded( UInt_t type ){return glload[TrkParams::GetIndex(type)];};
     static Bool_t IsLoaded( );
 
-    ClassDef(TrkParams,1);
+    // ---------------------------------------------
+    // retrieve parameters
+    // ---------------------------------------------
+    static float GetBX(float*);
+    static float GetBY(float*);
+    static float GetBZ(float*);
+    static float GetResolution(int,float);
+
+    // ---------------------------------------------
+    // debug mode 
+    // ---------------------------------------------
+    static cDbg dbg_mode; //debug mode (for both c++ and F77 roiutines)
+
+    static void SetDebugMode()  {dbg_mode.SetDebug();   dbg_=dbg_mode;};
+    static void SetVerboseMode(){dbg_mode.SetVerbose(); dbg_=dbg_mode;};
+    static void SetWarningMode(){dbg_mode.SetWarning(); dbg_=dbg_mode;};    
+    static Bool_t DebugMode(){return dbg_mode.debug;};
+    static Bool_t WarningMode(){return dbg_mode.warning;};
+    static Bool_t VerboseMode(){return dbg_mode.verbose;};
+
+    // ------------------------------------------------
+    // alcuni metodi che non sapevo dove mettere 
+    // per inizializzare alcune variabili in F77 common
+    // ------------------------------------------------     
+    // set to default values
+    static void SetTrackingMode()   {track_.trackmode = init__mini_trackmode;};
+    static void SetPrecisionFactor(){track_.fact      = init__mini_fact;     };
+    static void SetStepMin()        {track_.istepmin  = init__mini_istepmin; };
+    static void SetPFA()            {sw_.pfaid        = init__pfa;           };
+    // set to custom values
+    static void SetTrackingMode(int);
+    static void SetPrecisionFactor(double);
+    static void SetStepMin(int);
+    static void SetPFA(int);
+    
+    ClassDef(TrkParams,2);
 
 };