CommitLineData
2 * See cxx source for full Copyright notice */
3
4// $Id$
5
6/// \file Doxymain.h
7/// \brief The main page for code documenation
8
9
b3cde273 10/*! \mainpage MUON code documentation
7537f3cf 11
12This is the documentation for the MUON simulation and reconstruction code.
91509ec6 13It is a mix of general concepts and code implementation details.
14It is constantly updated by all dimuon code developers.
15
16The documentation is organized in the thematic pages, defined in the
18Currently there are the documentation pages on
91509ec6 36
37On this page you will find the first how to run the
38simulation, reconstructin and evaluation chain. More details
39and various macros can be found on the other pages.
40
41\section s1 How to check that your aliroot is working well
42
43There is a script file AlirootRun_MUONtest.sh which
44allows for simulating, reconstructing and making the
45invariant analysis of the generated Upsilon (1S).
46The used configuration file is Config.C in MUON
47directory.
48
49You have to type :
50<pre>
51$ALICE_ROOT/MUON/AlirootRun_MUONtest.sh [option] 52</pre> 53 54The complete list of the option is printed when you call 55the script with whatever non valid option, .eg. h: 56 57<pre> 58./AlirootRun_MUONtest.sh h 59ERROR : extra option not recognized 19b50c28 60Usage: AlirootRun_MUONtest.sh options (-SRXsrxn:tg:p:d:c:) 91509ec6 61 -S (-s) perform (or not) simulation (default is do it, i.e -S) 62 -R (-r) perform (or not) reconstruction (default is do it, i.e. -R) 63 -X event (-x) perform (or not) checks and dumps (default is do it for event 5, i.e. -X 5) 64 -n nevents (int) number of events to simulate (default 100) 19b50c28 65 -t will use OUTDIR as a tmp directory to generate raw data 66 -g seed (uint) seed to be used in simulation (default 1234567) 91509ec6 67 -p recoptions (quotified string) reconstruction options to use (default "SAVEDIGITS") 19b50c28 68 -d full path to output directory (default /work/projects/alice/trunk/AliRoot/MUON/test_out.100) 69 -c full path to configuration file for simulation (default /work/projects/alice/trunk/AliRoot/MUON/Config.C) 91509ec6 70</pre> 71 72The results of this test are saved in test_out.nevent directory. 73Please note that the CDB (Condition DataBase) is now always *required* 74to perform either simulation or reconstruction. For the moment, a version 75of that CDB is stored in CVS, so you should have one already in MUON/Calib 76subdirectories. 77 78 79\section s2 How to check that your aliroot is working VERY well 80 81There is a script file AlirootRun_MUONlongtest.sh which 82allows for simulating, reconstructing and making the 83-+invariant analysis of the generated Upsilon (1S). 84This script generates a large number of Upsilon (20k) 85in order to access differential quantities. 86The used configuration file is Config.C in MUON 87directory. 88 89One should really run this script to check if the MUON 90code can process a large number of events WITHOUT errors, 91in particular before making important commits !! 92 93You have to type : 94<pre> 95$ALICE_ROOT/MUON/AlirootRun_MUONtestlong.sh
96</pre>
97The results of this test are saved in testlong_out/ directory
98and will be kept in CVS
99
100(NOTE: the macros performing the calculations/plots MUONefficiency.C
101and MUONplotefficiency.C are also able to handle J/Psi if
102Config.C is modified accordingly )
b3cde273 103
7537f3cf 104*/