Change description related to CDB

[u/mrichter/AliRoot.git] / MUON / README

diff --git a/MUON/README b/MUON/README
index 4ebe8c122f4c2b6ddc3bb5271d3a45ac4e3cceec..868e7441e186ffda1f8ef99084345e6093355034 100644 (file)
--- a/MUON/README
+++ b/MUON/README
@@ -23,17 +23,41 @@ reconstruction and macro analysis
 ==========================================================
  How to check that your aliroot is working well
 ==========================================================
-There is a script file AlirootRun_MUONtest.script which 
+There is a script file AlirootRun_MUONtest.sh which 
 allows for simulating, reconstructing and making the
 invariant analysis of the generated Upsilon (1S).
 The used configuration file is Config.C in MUON 
 directory.
-There you have to type :
+You have to type :
+source $ALICE_ROOT/MUON/AlirootRun_MUONtest.sh 
+The results of this test are saved in test_out/ directory.
+Please note that the CDB (Condition DataBase) is now always *required* 
+to perform either simulation or reconstruction. For the moment, a version
+ of that CDB is stored in CVS, so you should have one already in MUON/Calib
+subdirectories.
 
-source $ALICE_ROOT/MUON/AlirootRun_MUONtest.script
+==========================================================
+ How to check that your aliroot is working VERY well
+==========================================================
+There is a script file AlirootRun_MUONlongtest.sh which
+allows for simulating, reconstructing and making the
+-+invariant analysis of the generated Upsilon (1S).
+This script generates a large number of Upsilon (20k) 
+in order to access differential quantities. 
+The used configuration file is Config.C in MUON
+directory.
+One should really run this script to check if the MUON 
+code can process a large number of events WITHOUT errors,
+in particular before making important commits !!
+
+You have to type :
+$ALICE_ROOT/MUON/AlirootRun_MUONtestlong.sh
+The results of this test are saved in testlong_out/ directory
+and will be kept in CVS
 
-If you do not recover a few Upsilons in their mass region 
-in the file MUONmassPlot.root
+(NOTE: the macros performing the calculations/plots MUONefficiency.C 
+and MUONplotEfficiency.C are also able to handle J/Psi if 
+Config.C is modified accordingly )
 
 ==========================================================
  How to run a MUON generation
@@ -72,6 +96,9 @@ MUONhits()  or MUONhits(##,"galice.root") for the event number ##
 To print digits : (default file is galice.root)
 MUONdigits()  or MUONdigits(##,"galice.root") for the event number ##
 
+To print sdigits : (default file is galice.root)
+MUONsdigits()  or MUONsdigits(##,"galice.root") for the event number ##
+
 To print rawcluster : (default file is galice.root)
 MUONrecpoints() or MUONrecpoints(##,"galice.root") for the event number ##
 
@@ -81,20 +108,22 @@ MUONrectrigger() or MUONrectrigger(##,"galice.root") for the event number ##
 ....
 
 ============================================================
- How to check the Geometry 
+ How to check the Geometry with the new Geometrical modeler
+ ftp://root.cern.ch/root/doc/chapter16.pdf
+ http://agenda.cern.ch/fullAgenda.php?ida=a05212
 ============================================================
 gAlice->Init("$ALICE_ROOT/MUON/Config.C");
-.L $ALICE/geant3/TGeant3/G3GUI.C
-G3GUI()
+gGeoManager->GetMasterVolume()->Draw();
+
 
 ============================================================
- How to check the Geometry with the new Geometrical modeler
+ How to check the overlap with the new Geometrical modeler
  ftp://root.cern.ch/root/doc/chapter16.pdf
  http://agenda.cern.ch/fullAgenda.php?ida=a05212
 ============================================================
 gAlice->Init("$ALICE_ROOT/MUON/Config.C");
-gGeoManager->GetMasterVolume()->Draw();
-
+gGeoManager->CheckOverlaps();
+gGeoManager->PrintOverlaps();
 
 ============================================================
  How to run MUONdisplay
@@ -197,8 +226,10 @@ MuonRec.SetRunVertexFinder(kFALSE);
 MuonRec.SetRunLocalReconstruction("MUON");
 MuonRec.SetRunTracking("");
 MuonRec.SetFillESD("MUON");
-MuonRec.SetOption("MUON", "AZ Kalman"); // to use AZ clustering and Kalman filter
-MuonRec.Run();
+MuonRec.SetOption("MUON", "VS"); // to use VS cluster finder
+// MuonRec.SetOption("MUON", "VS Original"); // to run VS and original track finder
+// MuonRec.SetOption("MUON", "Combi"); // to run combined cluster / track finder
+MMuonRec.Run();
 .q
 EOF
 
@@ -316,6 +347,13 @@ MuonRec.Run()
 .q
 EOF
 
+==========================================================
+ How to play with the CDB
+==========================================================
+
+If you'd like to see how the CDB is created, please have a look at the 
+MUONCDB.C (work in progress, though).
+
 ===========================================================
  Still working ..............
 ===========================================================