[u/mrichter/AliRoot.git] / TPC / CalibMacros / READMEcalib.txt

In this README you can find the list of calibration components used for calibration using reconstructed information.  


Base classes:
AliTPCAnalysisTaskcalib - analysis task owner of the calibration components using reconstructed events and tracks

AliTPCcalibBase  - base class for other components
AliTPCcalibCalib - not very nice name - component to reaply calibration 
                   according the setup in the configuration macro


See components below:
=============================================================================
Standard CPass0,CPass1
=============================================================================
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
AliTPCcalibTime
Input- reconstructed tracks and events
OCDB output:  TPC/Calib/TimeDrift array of graphs
	      +
              in past used as one of input for the TPC/Calib/Corrections 
              
Details:
Kalman fit: drift, drfit velocity gradient t0 shift+ alignment 
            output: part of TPC/CalibTimeDrift
Histogramming:
	a.) TPC/ITS, TPC/Vertex, TPC/TOF, TPC/TRD residual histograms in 4 D
             -cretaion of distortion maps for run by run alignment
            OCDB output: part of TPC/CalibTimeDrift
            additional output: distortion map in meanITSVertex.root
        b.) TPCAside vertex, TPCCside vertex, Global vertex 
            combination histogramming 
             -implemented as a robust method - not used 
              for extraction of calibration because of worse precission, and 
              problems starting strting at high luminosity running.
        c.) TPCdrift laser histogramming 
             -OCDB output: part of TPC/CalibTimeDrift
             -as laser is not 100 % stable, calibration is not used in 
              the reconstruction unless all other methods mentioned
              above failed


xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
AliTPCcalibTimeGain:
Input- reconstructed tracks and events
OCDB output:  TPC/Calib/TimeGain - array of graphs
Details: the calibration of the time dependence of the TPC gain due to pressure and temperature changes etc. In addition signal attenuation calibration 


xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
AliTPCcalibGainMult: 
Input- reconstructed tracks and events
OCDB output:  TPC/Calib/TimeGain - array of graphs
Details: gain/tail as function of multiplicity, gain per chamber
         + experimental code for the  dEdx calibration presented 
           one year ago (disabled) 


=============================================================================
New in CPass0,CPass1
=============================================================================

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
AliTPCcalibAlign         - 
Input - reconstructed events/tracks
Histograms: THnSparse -  residuals  at sector  boundaries,
            THn - 4D cluster/track residuals
Status: code cleaning needed 
Output - in past used as one of input for the TPC/Calib/Corrections 
          automatic procedure missing
 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
AliTPCcalibLaser         - 
Input  - reconstructed events/tracks
Actions: drift velocity fit; histogramming of the cluster residuals with 
         respect to survey 
Output - drift velocity (integrated in AliTPCcalibTime)
         in past used as one of input for the TPC/Calib/Corrections 


xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx     AliTPCcalibTracks
Input  - tracks and clusters
Output - TPC/CalibClusterParam
Action: getting resolution and shape parameterizatio and space point bias calibration 
Histogramming : the local residuals between the tracklet and cluster

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx     AliTPCcalibSummary
dumping of the information into the calibration tree used later for calibration visualization

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Components to be replaced once the high pt trees are created by default:
AliTPCcalibTrigger.cxxAliTPCcalibV0.cxx 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Obsolete:
AliTPCcalibTrigger.cxx AliTPCcalibAlignment.cxx 

                 
# calibration visualization
-rw-rw-r-- 1 miranov miranov  40882 Oct  6 23:50 AliTPCcalibSummary.cxx

-rw-rw-r-- 1 miranov miranov   7292 Oct  6 23:50 AliTPCAnalysisTaskcalib.cxx
-rw-rw-r-- 1 miranov miranov  84811 Oct  6 23:50 AliTPCcalibTime.cxx
-rw-rw-r-- 1 miranov miranov  24779 Oct  6 23:50 AliTPCcalibTimeGain.cxx

-rw-rw-r-- 1 miranov miranov 127790 Oct  6 23:50 AliTPCcalibAlign.cxx
-rw-rw-r-- 1 miranov miranov   4571 Oct  6 23:50 AliTPCcalibAlignment.cxx
-rw-rw-r-- 1 miranov miranov  13159 Oct  6 23:50 AliTPCcalibBase.cxx
-rw-rw-r-- 1 miranov miranov  16622 Oct  6 23:50 AliTPCcalibCalib.cxx
-rw-rw-r-- 1 miranov miranov  57212 Oct  6 23:50 AliTPCcalibCosmic.cxx
-rw-rw-r-- 1 miranov miranov  73173 Oct  6 23:50 AliTPCcalibDB.cxx
-rw-rw-r-- 1 miranov miranov 109458 Oct  6 23:50 AliTPCcalibDButil.cxx
-rw-rw-r-- 1 miranov miranov  75162 Oct  6 23:50 AliTPCcalibGainMult.cxx
-rw-rw-r-- 1 miranov miranov 171739 Oct  6 23:50 AliTPCcalibLaser.cxx
-rw-rw-r-- 1 miranov miranov   6754 Oct  6 23:50 AliTPCcalibTracksCuts.cxx
-rw-rw-r-- 1 miranov miranov  50184 Oct  6 23:50 AliTPCcalibTracksGain.cxx
-rw-rw-r-- 1 miranov miranov  11188 Oct  6 23:50 AliTPCcalibTrigger.cxx
-rw-rw-r-- 1 miranov miranov  31505 Oct  6 23:50 AliTPCcalibV0.cxx
Commit	Line	Data
69549f91	1	In this README you can find the list of calibration components used for calibration using reconstructed information.
	2
	3
	4	Base classes:
	5	AliTPCAnalysisTaskcalib - analysis task owner of the calibration components using reconstructed events and tracks
	6
	7	AliTPCcalibBase - base class for other components
	8	AliTPCcalibCalib - not very nice name - component to reaply calibration
	9	according the setup in the configuration macro
	10
	11
	12	See components below:
	13	=============================================================================
	14	Standard CPass0,CPass1
	15	=============================================================================
	16	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
	17	AliTPCcalibTime
	18	Input- reconstructed tracks and events
	19	OCDB output: TPC/Calib/TimeDrift array of graphs
	20	+
	21	in past used as one of input for the TPC/Calib/Corrections
	22
	23	Details:
	24	Kalman fit: drift, drfit velocity gradient t0 shift+ alignment
	25	output: part of TPC/CalibTimeDrift
	26	Histogramming:
	27	a.) TPC/ITS, TPC/Vertex, TPC/TOF, TPC/TRD residual histograms in 4 D
	28	-cretaion of distortion maps for run by run alignment
	29	OCDB output: part of TPC/CalibTimeDrift
	30	additional output: distortion map in meanITSVertex.root
	31	b.) TPCAside vertex, TPCCside vertex, Global vertex
	32	combination histogramming
	33	-implemented as a robust method - not used
	34	for extraction of calibration because of worse precission, and
	35	problems starting strting at high luminosity running.
	36	c.) TPCdrift laser histogramming
	37	-OCDB output: part of TPC/CalibTimeDrift
	38	-as laser is not 100 % stable, calibration is not used in
	39	the reconstruction unless all other methods mentioned
	40	above failed
	41
	42
	43
	44	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
	45	AliTPCcalibTimeGain:
	46	Input- reconstructed tracks and events
	47	OCDB output: TPC/Calib/TimeGain - array of graphs
	48	Details: the calibration of the time dependence of the TPC gain due to pressure and temperature changes etc. In addition signal attenuation calibration
	49
	50
	51
	52
	53	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
	54	AliTPCcalibGainMult:
	55	Input- reconstructed tracks and events
	56	OCDB output: TPC/Calib/TimeGain - array of graphs
	57	Details: gain/tail as function of multiplicity, gain per chamber
	58	+ experimental code for the dEdx calibration presented
	59	one year ago (disabled)
	60
	61
	62	=============================================================================
	63	New in CPass0,CPass1
	64	=============================================================================
65
66	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
67	AliTPCcalibAlign -
68	Input - reconstructed events/tracks
69	Histograms: THnSparse - residuals at sector boundaries,
70	THn - 4D cluster/track residuals
71	Status: code cleaning needed
72	Output - in past used as one of input for the TPC/Calib/Corrections
73	automatic procedure missing
74
75	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
76	AliTPCcalibLaser -
77	Input - reconstructed events/tracks
78	Actions: drift velocity fit; histogramming of the cluster residuals with
79	respect to survey
80	Output - drift velocity (integrated in AliTPCcalibTime)
81	in past used as one of input for the TPC/Calib/Corrections
82
83
84	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx AliTPCcalibTracks
85	Input - tracks and clusters
86	Output - TPC/CalibClusterParam
87	Action: getting resolution and shape parameterizatio and space point bias calibration
88	Histogramming : the local residuals between the tracklet and cluster
89
90	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx AliTPCcalibSummary
91	dumping of the information into the calibration tree used later for calibration visualization
92
93	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
94	Components to be replaced once the high pt trees are created by default:
95	AliTPCcalibTrigger.cxxAliTPCcalibV0.cxx
96
97	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
98	Obsolete:
99	AliTPCcalibTrigger.cxx AliTPCcalibAlignment.cxx
100
101
102
103	# calibration visualization
104	-rw-rw-r-- 1 miranov miranov 40882 Oct 6 23:50 AliTPCcalibSummary.cxx
105
106	-rw-rw-r-- 1 miranov miranov 7292 Oct 6 23:50 AliTPCAnalysisTaskcalib.cxx
107	-rw-rw-r-- 1 miranov miranov 84811 Oct 6 23:50 AliTPCcalibTime.cxx
108	-rw-rw-r-- 1 miranov miranov 24779 Oct 6 23:50 AliTPCcalibTimeGain.cxx
109
110	-rw-rw-r-- 1 miranov miranov 127790 Oct 6 23:50 AliTPCcalibAlign.cxx
111	-rw-rw-r-- 1 miranov miranov 4571 Oct 6 23:50 AliTPCcalibAlignment.cxx
112	-rw-rw-r-- 1 miranov miranov 13159 Oct 6 23:50 AliTPCcalibBase.cxx
113	-rw-rw-r-- 1 miranov miranov 16622 Oct 6 23:50 AliTPCcalibCalib.cxx
114	-rw-rw-r-- 1 miranov miranov 57212 Oct 6 23:50 AliTPCcalibCosmic.cxx
115	-rw-rw-r-- 1 miranov miranov 73173 Oct 6 23:50 AliTPCcalibDB.cxx
116	-rw-rw-r-- 1 miranov miranov 109458 Oct 6 23:50 AliTPCcalibDButil.cxx
117	-rw-rw-r-- 1 miranov miranov 75162 Oct 6 23:50 AliTPCcalibGainMult.cxx
118	-rw-rw-r-- 1 miranov miranov 171739 Oct 6 23:50 AliTPCcalibLaser.cxx
119	-rw-rw-r-- 1 miranov miranov 6754 Oct 6 23:50 AliTPCcalibTracksCuts.cxx
120	-rw-rw-r-- 1 miranov miranov 50184 Oct 6 23:50 AliTPCcalibTracksGain.cxx
121	-rw-rw-r-- 1 miranov miranov 11188 Oct 6 23:50 AliTPCcalibTrigger.cxx
122	-rw-rw-r-- 1 miranov miranov 31505 Oct 6 23:50 AliTPCcalibV0.cxx
123