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 <TROOT.h> // EMILIANO: needed to compile with ROOT > 5.16/x

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

#define NTYPES 10
#define NGF 14

/**
 * \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 
*
 * 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;
    static TrkCalib*    calib1;
    static TrkCalib*    calib2;
    // ---------------------------------------------
    // 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;
    static cDbg init__dbg_mode; //debug mode (for both c++ and F77 roiutines)
    static float init__pfa_e234ax[6]; // angle intervals for eta2-3-4
    static float init__pfa_e234ay[6]; // angle intervals for eta2-3-4
    static double init__deltab_0; 
    static double init__deltab_1;
    static double init__dlt;

    // ------------------------------------------
    // nominal z-coordinates to define acceptance
    // ------------------------------------------
    static int   nGF;
    static float zGF[NGF];
    static float xGF_min[NGF];
    static float xGF_max[NGF];
    static float yGF_min[NGF];
    static float yGF_max[NGF];
    static TString GF_element[NGF];

    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){ 
      Bool_t result = true;
          for(Int_t i=0; i<NTYPES; i++)
        if( !TrkParams::Set(glrun,dbc,trkparamtype[i]) )
                result = false;
          return result;
    };
    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( );

    static GL_PARAM GetParams( UInt_t type ){ return gl[TrkParams::GetIndex(type)]; }; 

    // ---------------------------------------------
    // retrieve parameters
    // ---------------------------------------------
    static float GetBX(float*);
    static float GetBY(float*);
    static float GetBZ(float*);
    static float GetResolution(int,float);
    static int   GetPFA(){return sw_.pfaid;};
    static int GetPFA_NbinsAngle();
    static int GetPFA_NbinsETA();
    static int GetPFA_NbinsCharge(){return 0;};
    static int GetPFA_AngleBin(float);
    static float* GetPFA_ETAcorr(TString,int,int,int);
    static float* GetPFA_ETAabs(TString,int);
    static float  GetPFA_ETAlandi(int,int,int);
    static float  GetPFA_ETAlandi(int nv,int nl,float ang)
        { return TrkParams::GetPFA_ETAlandi(nv,nl,TrkParams::GetPFA_AngleBin(ang)); };


    // ---------------------------------------------
    // debug mode 
    // ---------------------------------------------

    static void SetDebugMode()  {init__dbg_mode.SetDebug();   dbg_=init__dbg_mode;};
    static void SetVerboseMode(){init__dbg_mode.SetVerbose(); dbg_=init__dbg_mode;};
    static void SetWarningMode(){init__dbg_mode.SetWarning(); dbg_=init__dbg_mode;};    
    static void SetQuietMode()  {init__dbg_mode.SetNone();    dbg_=init__dbg_mode;};    
    static Bool_t DebugMode(){return init__dbg_mode.debug;};
    static Bool_t WarningMode(){return init__dbg_mode.warning;};
    static Bool_t VerboseMode(){return init__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 SetDeltaB()         {deltab_.delta0   = init__deltab_0;
                                     deltab_.delta1   = init__deltab_1;};    
    static void SetDLT()            {deltab_.dlt   = init__dlt;};
    static void SetMiniDefault()    {
        SetTrackingMode(); 
        SetPrecisionFactor(); 
        SetStepMin(); 
        SetDeltaB(); 
        SetDLT();
    }; //
    static void SetPFA();
    
    // set to custom values
    static void SetTrackingMode(int);
    static void SetPrecisionFactor(double);
    static void SetStepMin(int);
    static void SetDeltaB(int,double);    
    static void SetDLT(double);
    static void SetPFA(int);
    static void SetPFA(float *);
    
    // ---------------------------------------------
    // varie ed eventuali...
    // ---------------------------------------------
    static TSQLServer* SetDBConnection();


    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	mocchiut	1.9	#include <TROOT.h> // EMILIANO: needed to compile with ROOT > 5.16/x
13	pam-fi	1.1
14			#include <GLTables.h>
15			#include <TrkStruct.h>
16			#include <TrkCalib.h>
17
18			#define NTYPES 10
19	pam-fi	1.13	#define NGF 14
20	pam-fi	1.1
21			/**
22			* \brief Class to store tracker parameter information
23			*
24	pam-fi	1.5	* Tracker parameters include calibration parameters (PED, SIG and BAD),
25			* parameters loaded from DB (alignment, ADC-to-mip, etc. ) and some parameters
26			* to configure tracker processing (PFA, ecc...).
27			*
28			* Calibrations can be either those evaluated online or default values.
29			* External parameter are labelled according to the DB convention:
30	pam-fi	1.2	*
31			* type description
32			* -----------------
33			* 1 field
34			* 2 adc-to-mip
35			* 3 charge-correlation
36			* 4 p.f.a. (eta)
37			* 5 alignment
38			* 6 VA1 mask
39			* 7 default calibration
40			*
41	pam-fi	1.5	* Internal parameters are initialized to default values
42	pam-fi	1.7	*
43	pam-fi	1.2	* TrkParams::SetCalib(...) and TrkParams::Set(...) methods allow to set
44			* required parameters, from an input path, from the DB (for a given input
45			* run id) and from environment variable PAM_CALIB.
46			* TrkParams::LoadCalib() and TrkParams::Load() methods load parameters into
47			* F77 common.
48			*
49			* Tracker libraries (TrkLevel0, TrkLevel1 and TrkLevel2) implement automatic
50	pam-fi	1.4	* setting (either from DB or from environment variables) and loading of parameters.
51	pam-fi	1.2	* If one needs to load custom parameters, it is enough to call TrkParams::Set(...)
52			* with proper arguments. All the methods are static, and can be used as standalone functions.
53			*
54			* For example:
55			*
56			* TrkParams::Set("/param-path/new-mip-param/",2);
57			*
58			* After this instruction (to be called once), new adc-to-mip conversion parameters
59			* will be loaded automatically (once) and used until the next set instruction
60	pam-fi	1.1	*/
61			class TrkParams : public TObject {
62
63			private:
64
65			static Int_t GetIndex( UInt_t type );
66
67			public:
68
69			// ---------------------------------------------
70			// variables to store loaded-calibration info
71			// ---------------------------------------------
72			static GL_TRK_CALIB calib;
73			static TString calibpatht; //truncated
74			static TString calibpathf; //full
75			static Bool_t calib104;
76			static Bool_t calibload;
77	pam-fi	1.16	static TrkCalib* calib1;
78			static TrkCalib* calib2;
79	pam-fi	1.1	// ---------------------------------------------
80			// variables to store loaded-parameters info
81			// ---------------------------------------------
82			static UInt_t trkparamtype[NTYPES];
83			static GL_PARAM gl[NTYPES];
84			static TString glpath[NTYPES];
85			static Bool_t glload[NTYPES];
86	pam-fi	1.5	// -----------------------------------------------
87			// some parameters to configure tracker processing
88			// -----------------------------------------------
89			static int init__pfa;
90			static int init__mini_trackmode;
91			static int init__mini_istepmin;
92			static double init__mini_fact;
93	pam-fi	1.7	static cDbg init__dbg_mode; //debug mode (for both c++ and F77 roiutines)
94	pam-fi	1.8	static float init__pfa_e234ax[6]; // angle intervals for eta2-3-4
95			static float init__pfa_e234ay[6]; // angle intervals for eta2-3-4
96	pam-fi	1.11	static double init__deltab_0;
97			static double init__deltab_1;
98	pam-fi	1.12	static double init__dlt;
99	pam-fi	1.8
100	pam-fi	1.13	// ------------------------------------------
101			// nominal z-coordinates to define acceptance
102			// ------------------------------------------
103			static int nGF;
104			static float zGF[NGF];
105			static float xGF_min[NGF];
106			static float xGF_max[NGF];
107			static float yGF_min[NGF];
108			static float yGF_max[NGF];
109			static TString GF_element[NGF];
110
111	pam-fi	1.1	TrkParams();
112	pam-fi	1.13
113	pam-fi	1.1	// ---------------------------------------------
114			// calibration (PED-SIG-BAD)
115			// ---------------------------------------------
116			static Bool_t SetCalib( GL_RUN* , TSQLServer* );
117			static Bool_t LoadCalib( );
118			static Bool_t CalibIsLoaded(){ return calibload; };
119	pam-fi	1.3	static UInt_t ValidateTrkCalib( CalibTrk1Event* );
120	pam-fi	1.16	// static void FillFCalibFrom(TFile* , Int_t , Int_t );//full
121			// static void FillTCalibFrom(TFile* , Int_t , Int_t );//truncated
122	pam-fi	1.1	static void FillTCalibFrom(TString path);
123			static void FillACalibFrom(TFile* , Int_t , Int_t );//all
124			static void FillMask(TFile* , Int_t , Int_t );
125
126			// ---------------------------------------------
127			// parameters
128			// ---------------------------------------------
129			static Bool_t Set( GL_RUN* glrun, TSQLServer* dbc, UInt_t type);
130			static Bool_t Set( GL_RUN* glrun, TSQLServer* dbc){
131	pam-fi	1.17	Bool_t result = true;
132			for(Int_t i=0; i<NTYPES; i++)
133			if( !TrkParams::Set(glrun,dbc,trkparamtype[i]) )
134			result = false;
135			return result;
136	pam-fi	1.1	};
137			static Bool_t Set( TString, UInt_t );
138			static Bool_t Set( UInt_t );
139			static Bool_t Set( );
140			static Bool_t Load( UInt_t );
141			static Bool_t Load( );
142			static Bool_t IsLoaded( UInt_t type ){return glload[TrkParams::GetIndex(type)];};
143			static Bool_t IsLoaded( );
144
145	pam-fi	1.16	static GL_PARAM GetParams( UInt_t type ){ return gl[TrkParams::GetIndex(type)]; };
146
147	pam-fi	1.5	// ---------------------------------------------
148			// retrieve parameters
149			// ---------------------------------------------
150			static float GetBX(float*);
151			static float GetBY(float*);
152			static float GetBZ(float*);
153	pam-fi	1.6	static float GetResolution(int,float);
154	pam-fi	1.8	static int GetPFA(){return sw_.pfaid;};
155	pam-fi	1.14	static int GetPFA_NbinsAngle();
156			static int GetPFA_NbinsETA();
157			static int GetPFA_NbinsCharge(){return 0;};
158			static int GetPFA_AngleBin(float);
159			static float* GetPFA_ETAcorr(TString,int,int,int);
160			static float* GetPFA_ETAabs(TString,int);
161			static float GetPFA_ETAlandi(int,int,int);
162			static float GetPFA_ETAlandi(int nv,int nl,float ang)
163			{ return TrkParams::GetPFA_ETAlandi(nv,nl,TrkParams::GetPFA_AngleBin(ang)); };
164	pam-fi	1.4
165	pam-fi	1.15
166
167	pam-fi	1.4	// ---------------------------------------------
168			// debug mode
169			// ---------------------------------------------
170
171	pam-fi	1.7	static void SetDebugMode() {init__dbg_mode.SetDebug(); dbg_=init__dbg_mode;};
172			static void SetVerboseMode(){init__dbg_mode.SetVerbose(); dbg_=init__dbg_mode;};
173			static void SetWarningMode(){init__dbg_mode.SetWarning(); dbg_=init__dbg_mode;};
174			static void SetQuietMode() {init__dbg_mode.SetNone(); dbg_=init__dbg_mode;};
175			static Bool_t DebugMode(){return init__dbg_mode.debug;};
176			static Bool_t WarningMode(){return init__dbg_mode.warning;};
177			static Bool_t VerboseMode(){return init__dbg_mode.verbose;};
178	pam-fi	1.4
179	pam-fi	1.5	// ------------------------------------------------
180			// alcuni metodi che non sapevo dove mettere
181			// per inizializzare alcune variabili in F77 common
182			// ------------------------------------------------
183			// set to default values
184			static void SetTrackingMode() {track_.trackmode = init__mini_trackmode;};
185			static void SetPrecisionFactor(){track_.fact = init__mini_fact; };
186			static void SetStepMin() {track_.istepmin = init__mini_istepmin; };
187	pam-fi	1.11	static void SetDeltaB() {deltab_.delta0 = init__deltab_0;
188			deltab_.delta1 = init__deltab_1;};
189	pam-fi	1.12	static void SetDLT() {deltab_.dlt = init__dlt;};
190	pam-fi	1.11	static void SetMiniDefault() {
191			SetTrackingMode();
192			SetPrecisionFactor();
193			SetStepMin();
194			SetDeltaB();
195	pam-fi	1.12	SetDLT();
196	pam-fi	1.11	}; //
197			static void SetPFA();
198
199	pam-fi	1.5	// set to custom values
200			static void SetTrackingMode(int);
201			static void SetPrecisionFactor(double);
202			static void SetStepMin(int);
203	pam-fi	1.11	static void SetDeltaB(int,double);
204	pam-fi	1.12	static void SetDLT(double);
205	pam-fi	1.5	static void SetPFA(int);
206	pam-fi	1.8	static void SetPFA(float *);
207	pam-fi	1.5
208	pam-fi	1.10	// ---------------------------------------------
209			// varie ed eventuali...
210			// ---------------------------------------------
211			static TSQLServer* SetDBConnection();
212
213
214	pam-fi	1.4	ClassDef(TrkParams,2);
215	pam-fi	1.1
216			};
217
218			#endif
219