remoe duplicate QA initialisation and do ESD QA for same detectors as RecPoint QA
[u/mrichter/AliRoot.git] / MUON / Doxymain.h
CommitLineData
1dfba132 1/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
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
17README*.txt files, which follow the code organization in the libraries.
18Currently there are the documentation pages on
19- \ref README_sim
20- \ref README_rec
21- \ref README_base
020ae1db 22- \ref README_mchview
91509ec6 23- \ref README_evaluation
e3a26974 24- \ref README_cosmics
91509ec6 25- \ref README_fast
b3cde273 26- \ref README_raw
27- \ref README_mapping
b9f858e1 28- \ref README_mchda
b3cde273 29- \ref README_calib
30- \ref README_geometry
31- \ref README_trigger
32- \ref README_shuttle
91509ec6 33
34On this page you will find the first how to run the
35simulation, reconstructin and evaluation chain. More details
36and various macros can be found on the other pages.
37
38\section s1 How to check that your aliroot is working well
39
40There is a script file AlirootRun_MUONtest.sh which
41allows for simulating, reconstructing and making the
42invariant analysis of the generated Upsilon (1S).
43The used configuration file is Config.C in MUON
44directory.
45
46You have to type :
47<pre>
48$ALICE_ROOT/MUON/AlirootRun_MUONtest.sh [option]
49</pre>
50
51The complete list of the option is printed when you call
52the script with whatever non valid option, .eg. h:
53
54<pre>
55./AlirootRun_MUONtest.sh h
56ERROR : extra option not recognized
57Usage: AlirootRun_MUONtest.sh options (-SRXsrxn:p:d:c:)
58 -S (-s) perform (or not) simulation (default is do it, i.e -S)
59 -R (-r) perform (or not) reconstruction (default is do it, i.e. -R)
60 -X event (-x) perform (or not) checks and dumps (default is do it for event 5, i.e. -X 5)
61 -n nevents (int) number of events to simulate (default 100)
62 -p recoptions (quotified string) reconstruction options to use (default "SAVEDIGITS")
63 -d full path to output directory (default /work/projects/alice/dev/AliRoot/MUON/test_out.100)
64 -c full path to configuration file for simulation (default /work/projects/alice/dev/AliRoot/MUON/Config.C)
65</pre>
66
67The results of this test are saved in test_out.nevent directory.
68Please note that the CDB (Condition DataBase) is now always *required*
69to perform either simulation or reconstruction. For the moment, a version
70of that CDB is stored in CVS, so you should have one already in MUON/Calib
71subdirectories.
72
73
74\section s2 How to check that your aliroot is working VERY well
75
76There is a script file AlirootRun_MUONlongtest.sh which
77allows for simulating, reconstructing and making the
78-+invariant analysis of the generated Upsilon (1S).
79This script generates a large number of Upsilon (20k)
80in order to access differential quantities.
81The used configuration file is Config.C in MUON
82directory.
83
84One should really run this script to check if the MUON
85code can process a large number of events WITHOUT errors,
86in particular before making important commits !!
87
88You have to type :
89<pre>
90$ALICE_ROOT/MUON/AlirootRun_MUONtestlong.sh
91</pre>
92The results of this test are saved in testlong_out/ directory
93and will be kept in CVS
94
95(NOTE: the macros performing the calculations/plots MUONefficiency.C
96and MUONplotefficiency.C are also able to handle J/Psi if
97Config.C is modified accordingly )
b3cde273 98
7537f3cf 99*/