Analysis taks for the generation of AOD with muon events (Roberta, Enrico)
[u/mrichter/AliRoot.git] / PWG3 / READMEmuon
1 ===================================================
2   Code to include the muon information in the 
3   creation of the standard AOD from the ESD
4   Roberta ARNALDI, Enrico SCOMPARIN Torino
5 ---------------------------------------------------------------
6
7 Code to copy the muon information from the ESD to the standard AOD. 
8
9 1) AnalysisTrainMuonLocal.C --> macro to run locally the AliAnalysisTaskESDMuonFilter. 
10                                 It creates a standard AOD from the ESD
11 2) AliAnalysisTaskESDMuonFilter.h  --> analysis task to copy the muon information from the ESD to the standard AOD
12 3) AliAnalysisTaskESDMuonFilter.cxx --> analysis task to copy the muon information from the ESD to the standard AOD
13 4) libPWG3muon.pkg
14 5) PWG3muonLinkDef.h 
15
16 ===================================================
17   Creation of the MUON-AOD from the standard AOD
18   Roberta ARNALDI, Enrico SCOMPARIN Torino
19 ---------------------------------------------------------------
20
21 Code to produce a muon-AOD, i.e. a replica of the standard AOD containing only events where 
22 at least one muon is present
23
24 1) AnalysisTrainFromStandardToMuonAODLocal.C --> macro to produce the MUON-AOD (it runs locally)
25 2) AliAnalysisTaskFromStandardToMuonAOD.h  --> analysis task to replicate the AOD content for interesting events
26 3) AliAnalysisTaskFromStandardToMuonAOD.cxx --> analysis task to replicate the AOD content for interesting events
27 4) libPWG3muon.pkg
28 5) PWG3muonLinkDef.h 
29
30 - The input files are the ESD (used only for tag creation) and the standard AOD.
31   Tags files are created from all the ESD/AOD files placed in a directory,  
32   given as an argument to the macro, and in its subdirectories.
33 - The selection of the muon events is based on the AOD tags.
34 - The contents of the MUON-AOD can be defined by the user in the AnalysisTrainFromStandardToMuonAODLocal.C
35   macro with some settings as
36   SetNeedsTracksBranchReplication(), SetNeedsVerticesBranchReplication() 
37   (defined in STEER/AliAODHandler.h)...
38
39 ===================================================
40   Calculation of the LUT 
41   Bogdan VULPESCU, Clermont
42 ---------------------------------------------------------------
43 Analysis task for the calculation of the Look-up-Tables used by the MUON
44 trigger algorithm
45
46 Purpose: extract from ESD files track information (ESD track parameters and
47 matched local trigger decisions) and store in TNtuple; the ntuple is used
48 for building 2D histograms (transverse momentum / local deviation) which
49 afterwards enter calculation/optimization procedures for the selection of
50 LUT cuts for individual local boards and several transverse momenta.
51
52 This version is prepared for the use on the grid, see the JDL file.
53
54 Files:
55
56 AliAnalysisTaskLUT.cxx   - source files of the analysis task
57 AliAnalysisTaskLUT.h
58
59 rootlutnt.sh             - executable (script)
60
61 runCreateLUTNT.C         - macro for setting the libraries environment and
62                            execution of the main macro
63
64 analysisTaskLUTNT.C      - main macro for the analysis
65
66 createLUTNT.jdl          - JDL file
67
68 ===================================================
69  Analysis task for the calculation of the trigger chamber efficiency.
70  Diego STOCCO, Torino
71 ----------------------------------------------------------------
72
73 Purpose: produce histograms for the trigger chamber efficiency determination 
74 from MUON track info. The task works either with input ESD or AOD (default is ESD).
75
76 This version works either locally or on grid.
77
78 Files:
79 AliAnalysisTaskTrigChEff.cxx   -source files of the analysis task
80 AliAnalysisTaskTrigChEff.h
81
82 AnalysisTrigChEff.C            - main macro for analysis
83
84 Test analysis:
85 - Preliminary: copy the following packages in the current working directory
86   - STEERBase.par
87   - ESD.par
88   - AOD.par
89   - ANALYSIS.par
90   - ANALYSISalice.par
91   - PWG3muon.par
92 If the packages are not present, create them: 
93 cd $ALICE_ROOT
94 make STEERBase.par
95 make ESD.par 
96 ...
97
98   - Local test:
99   root
100   .x AnalysisTrigChEff.C(kMlocal)
101
102   by default the macro searches for ESD in $ALICE_ROOT/MUON/test_out.100
103   The directory is generated by MUON/AlirootRun_MUONtest.sh (see README in MUON).
104
105   - Grid test (interactive):
106   root
107   .x AnalysisTrigChEff.C(kMlocalGrid)
108
109   by default the macro searches for a wn.xml in the current directory, with the list
110   of grid files to analyse.
111
112 - Display results:
113 The macro creates the file MUON.TriggerEfficiencyMap.root
114 aliroot
115 AliMUONTriggerEfficiencyCells effCells("MUON.TriggerEfficiencyMap.root")
116 effCells.DisplayEfficiency()