[u/mrichter/AliRoot.git] / MUON / READMEcalign.txt

// $Id$

/*! 

\page README_calign Offline Calibration and Alignment
 
\section calign_s1 Offline monitoring of the Alignment and Calibration

The macro MUONClusterInfo.C reads the ESDs or RecPoints and creates a tree of 
AliMUONClusterInfo objects which can be conveniently used to plot track to 
cluster residuals, cluster and pads properties.

Usage:
<pre>
root [0] .L $ALICE_ROOT/MUON/MUONClusterInfo.C+
root [1] MUONClusterInfo(nevents, esdFileName, inFileName, outFileName); 
</pre>

 1) <code> if ( esdFileName != "" ) </code>: 

 Loop over ESD event and fill AliMUONClusterInfo object with cluster + 
 corresponding track parameters.

 2) <code> if ( inFileName != "" ) </code>:
  
 Loop over RecPoints and fill AliMUONClusterInfo object with cluster not 
 attached to a track;

 3) Write results in a new root file.

\section calign_s2 How to run offline calibration and alignment tasks

AliMUONAlignmentTask:
 
It is an AliAnalysisTask to align the MUON spectrometer. The Task reads 
as input ESDs and feeds the MUONTracks to AliMUONAlignment. The alignment 
itself is performed by AliMillepede. A OCDB entry is written with the 
alignment parameters. A list of graph are written to monitor the alignment 
parameters. 

AliMUONReAlignTask:

It is an AliAnalysisTask to realign the MUON spectrometer. The Task reads 
as input ESDs moves the clusters of a MUONTrack acoording to the re aligned 
geometry taken from a misalignment file in the OCDB and refit the track. 
Then it produces a AliMUONClusterInfo object for each cluster. The output is 
a TTree of AliMUONClusterInfo.

AliMUONChamberCalibrationTask:

It is a AliAnalysisTaskSE to recalibrate the MUON spectrometers. The output is 
a TTree of AliMUONClusterInfo. 


The AliMUON*Task are designed to run in an analyis train of the Analysis 
Framework. The macros AddTaskMuon*.C can be used to add the task to an 
analysis train. An usage example based on the new standard AnalysisTrainNew.C 
will be provided soon. 


This chapter is defined in the READMEcalign.txt file.

*/
Commit	Line	Data
6c960a43	1	// $Id$
	2
	3	/*!
	4
	5	\page README_calign Offline Calibration and Alignment
	6
	7	\section calign_s1 Offline monitoring of the Alignment and Calibration
	8
	9	The macro MUONClusterInfo.C reads the ESDs or RecPoints and creates a tree of
	10	AliMUONClusterInfo objects which can be conveniently used to plot track to
	11	cluster residuals, cluster and pads properties.
	12
	13	Usage:
	14	<pre>
	15	root [0] .L $ALICE_ROOT/MUON/MUONClusterInfo.C+
	16	root [1] MUONClusterInfo(nevents, esdFileName, inFileName, outFileName);
	17	</pre>
	18
	19	1) <code> if ( esdFileName != "" ) </code>:
	20
	21	Loop over ESD event and fill AliMUONClusterInfo object with cluster +
	22	corresponding track parameters.
	23
	24	2) <code> if ( inFileName != "" ) </code>:
	25
	26	Loop over RecPoints and fill AliMUONClusterInfo object with cluster not
	27	attached to a track;
	28
	29	3) Write results in a new root file.
	30
	31	\section calign_s2 How to run offline calibration and alignment tasks
	32
	33	AliMUONAlignmentTask:
	34
	35	It is an AliAnalysisTask to align the MUON spectrometer. The Task reads
	36	as input ESDs and feeds the MUONTracks to AliMUONAlignment. The alignment
	37	itself is performed by AliMillepede. A OCDB entry is written with the
	38	alignment parameters. A list of graph are written to monitor the alignment
	39	parameters.
	40
	41	AliMUONReAlignTask:
	42
	43	It is an AliAnalysisTask to realign the MUON spectrometer. The Task reads
	44	as input ESDs moves the clusters of a MUONTrack acoording to the re aligned
	45	geometry taken from a misalignment file in the OCDB and refit the track.
	46	Then it produces a AliMUONClusterInfo object for each cluster. The output is
	47	a TTree of AliMUONClusterInfo.
	48
	49	AliMUONChamberCalibrationTask:
	50
	51	It is a AliAnalysisTaskSE to recalibrate the MUON spectrometers. The output is
	52	a TTree of AliMUONClusterInfo.
	53
	54
	55	The AliMUON*Task are designed to run in an analyis train of the Analysis
	56	Framework. The macros AddTaskMuon*.C can be used to add the task to an
	57	analysis train. An usage example based on the new standard AnalysisTrainNew.C
	58	will be provided soon.
	59
	60
	61	This chapter is defined in the READMEcalign.txt file.
	62
	63	*/