TrackerLevel2/inc/TrkParams.h

/**
 * \file TrkParams.h
 * \author Elena Vannuccini
 */
#ifndef trkparams_h
#define trkparams_h

#include <TObject.h>
#include <TString.h>
#include <TSQLServer.h>
#include <TSystem.h>

#include <GLTables.h>
#include <TrkStruct.h>
#include <TrkCalib.h>

#define NTYPES 10

/**
 * \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 {

private:
        
    static Int_t GetIndex( UInt_t type );

public:

    // ---------------------------------------------
    // variables to store loaded-calibration info
    // ---------------------------------------------
    static GL_TRK_CALIB calib; 
    static TString      calibpatht; //truncated
    static TString      calibpathf; //full
    static Bool_t       calib104;
    static Bool_t       calibload;
    // ---------------------------------------------
    // variables to store loaded-parameters info
    // ---------------------------------------------
    static UInt_t    trkparamtype[NTYPES];
    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();
    
    // ---------------------------------------------
    // calibration (PED-SIG-BAD)
    // ---------------------------------------------
    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);
    static void FillACalibFrom(TFile* , Int_t , Int_t );//all
    static void FillMask(TFile* , Int_t , Int_t );

    // ---------------------------------------------
    // parameters
    // ---------------------------------------------
    static Bool_t Set( GL_RUN* glrun, TSQLServer* dbc, UInt_t type);
    static Bool_t Set( GL_RUN* glrun, TSQLServer* dbc){ 
        for(Int_t i=0; i<NTYPES; i++) 
            if( !TrkParams::Set(glrun,dbc,trkparamtype[i]) )return false; 
        return true; 
    };
    static Bool_t Set( TString, UInt_t );
    static Bool_t Set( UInt_t );
    static Bool_t Set( );
    static Bool_t Load( UInt_t );
    static Bool_t Load( );
    static Bool_t IsLoaded( UInt_t type ){return glload[TrkParams::GetIndex(type)];};
    static Bool_t IsLoaded( );

    // ---------------------------------------------
    // retrieve parameters
    // ---------------------------------------------
    static float GetBX(float*);
    static float GetBY(float*);
    static float GetBZ(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);

};

#endif

1	pam-fi	1.1	/**
2			* \file TrkParams.h
3			* \author Elena Vannuccini
4			*/
5			#ifndef trkparams_h
6			#define trkparams_h
7
8			#include <TObject.h>
9			#include <TString.h>
10			#include <TSQLServer.h>
11			#include <TSystem.h>
12
13			#include <GLTables.h>
14			#include <TrkStruct.h>
15			#include <TrkCalib.h>
16
17			#define NTYPES 10
18
19			/**
20			* \brief Class to store tracker parameter information
21			*
22	pam-fi	1.5	* Tracker parameters include calibration parameters (PED, SIG and BAD),
23			* parameters loaded from DB (alignment, ADC-to-mip, etc. ) and some parameters
24			* to configure tracker processing (PFA, ecc...).
25			*
26			* Calibrations can be either those evaluated online or default values.
27			* External parameter are labelled according to the DB convention:
28	pam-fi	1.2	*
29			* type description
30			* -----------------
31			* 1 field
32			* 2 adc-to-mip
33			* 3 charge-correlation
34			* 4 p.f.a. (eta)
35			* 5 alignment
36			* 6 VA1 mask
37			* 7 default calibration
38			*
39	pam-fi	1.5	* Internal parameters are initialized to default values
40			* (NB!! the same values set in analisysflight.f).
41			*
42	pam-fi	1.2	* TrkParams::SetCalib(...) and TrkParams::Set(...) methods allow to set
43			* required parameters, from an input path, from the DB (for a given input
44			* run id) and from environment variable PAM_CALIB.
45			* TrkParams::LoadCalib() and TrkParams::Load() methods load parameters into
46			* F77 common.
47			*
48			* Tracker libraries (TrkLevel0, TrkLevel1 and TrkLevel2) implement automatic
49	pam-fi	1.4	* setting (either from DB or from environment variables) and loading of parameters.
50	pam-fi	1.2	* If one needs to load custom parameters, it is enough to call TrkParams::Set(...)
51			* with proper arguments. All the methods are static, and can be used as standalone functions.
52			*
53			* For example:
54			*
55			* TrkParams::Set("/param-path/new-mip-param/",2);
56			*
57			* After this instruction (to be called once), new adc-to-mip conversion parameters
58			* will be loaded automatically (once) and used until the next set instruction
59	pam-fi	1.1	*/
60			class TrkParams : public TObject {
61
62			private:
63
64			static Int_t GetIndex( UInt_t type );
65
66			public:
67
68			// ---------------------------------------------
69			// variables to store loaded-calibration info
70			// ---------------------------------------------
71			static GL_TRK_CALIB calib;
72			static TString calibpatht; //truncated
73			static TString calibpathf; //full
74			static Bool_t calib104;
75			static Bool_t calibload;
76			// ---------------------------------------------
77			// variables to store loaded-parameters info
78			// ---------------------------------------------
79			static UInt_t trkparamtype[NTYPES];
80			static GL_PARAM gl[NTYPES];
81			static TString glpath[NTYPES];
82			static Bool_t glload[NTYPES];
83	pam-fi	1.5	// -----------------------------------------------
84			// some parameters to configure tracker processing
85			// -----------------------------------------------
86			static int init__pfa;
87			static int init__mini_trackmode;
88			static int init__mini_istepmin;
89			static double init__mini_fact;
90	pam-fi	1.1
91			TrkParams();
92
93			// ---------------------------------------------
94			// calibration (PED-SIG-BAD)
95			// ---------------------------------------------
96			static Bool_t SetCalib( GL_RUN* , TSQLServer* );
97			static Bool_t LoadCalib( );
98			static Bool_t CalibIsLoaded(){ return calibload; };
99	pam-fi	1.3	static UInt_t ValidateTrkCalib( CalibTrk1Event* );
100	pam-fi	1.1	static void FillFCalibFrom(TFile* , Int_t , Int_t );//full
101			static void FillTCalibFrom(TFile* , Int_t , Int_t );//truncated
102			static void FillTCalibFrom(TString path);
103			static void FillACalibFrom(TFile* , Int_t , Int_t );//all
104			static void FillMask(TFile* , Int_t , Int_t );
105
106			// ---------------------------------------------
107			// parameters
108			// ---------------------------------------------
109			static Bool_t Set( GL_RUN* glrun, TSQLServer* dbc, UInt_t type);
110			static Bool_t Set( GL_RUN* glrun, TSQLServer* dbc){
111			for(Int_t i=0; i<NTYPES; i++)
112			if( !TrkParams::Set(glrun,dbc,trkparamtype[i]) )return false;
113			return true;
114			};
115			static Bool_t Set( TString, UInt_t );
116			static Bool_t Set( UInt_t );
117			static Bool_t Set( );
118			static Bool_t Load( UInt_t );
119			static Bool_t Load( );
120			static Bool_t IsLoaded( UInt_t type ){return glload[TrkParams::GetIndex(type)];};
121			static Bool_t IsLoaded( );
122
123	pam-fi	1.5	// ---------------------------------------------
124			// retrieve parameters
125			// ---------------------------------------------
126			static float GetBX(float*);
127			static float GetBY(float*);
128			static float GetBZ(float*);
129	pam-fi	1.4
130			// ---------------------------------------------
131			// debug mode
132			// ---------------------------------------------
133			static cDbg dbg_mode; //debug mode (for both c++ and F77 roiutines)
134
135			static void SetDebugMode() {dbg_mode.SetDebug(); dbg_=dbg_mode;};
136			static void SetVerboseMode(){dbg_mode.SetVerbose(); dbg_=dbg_mode;};
137			static void SetWarningMode(){dbg_mode.SetWarning(); dbg_=dbg_mode;};
138			static Bool_t DebugMode(){return dbg_mode.debug;};
139			static Bool_t WarningMode(){return dbg_mode.warning;};
140			static Bool_t VerboseMode(){return dbg_mode.verbose;};
141
142	pam-fi	1.5	// ------------------------------------------------
143			// alcuni metodi che non sapevo dove mettere
144			// per inizializzare alcune variabili in F77 common
145			// ------------------------------------------------
146			// set to default values
147			static void SetTrackingMode() {track_.trackmode = init__mini_trackmode;};
148			static void SetPrecisionFactor(){track_.fact = init__mini_fact; };
149			static void SetStepMin() {track_.istepmin = init__mini_istepmin; };
150			static void SetPFA() {sw_.pfaid = init__pfa; };
151			// set to custom values
152			static void SetTrackingMode(int);
153			static void SetPrecisionFactor(double);
154			static void SetStepMin(int);
155			static void SetPFA(int);
156
157	pam-fi	1.4	ClassDef(TrkParams,2);
158	pam-fi	1.1
159			};
160
161			#endif
162