Track Reference updated

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

==========================================================
Please add  to this README file all information concerning 
config files, simulation, digitalization, clusterization, 
reconstruction and macro analysis

==========================================================
 How to run a MUON simulation 
==========================================================
aliroot
root [0] gAlice->Run(10,"$ALICE_ROOT/MUON/Config_MUON_test.C");

1 single muon of 7 GeV/c in the MUON spectrometer 
acceptance will be simulated using geant3. 
Hit information will be store in the root file in the
execution directory.
If you want to change the option or to define a new directory
for hits, you have to do the following before:
root [0] gAlice->SetConfigFunction("Config( \"/home/martinez/aliroot/work_NewIO/test/\" , \"box\" );"); 

============================================================
 How to run MUON Digitalization
============================================================
To process the digitalization of hits the AliRunDigitizer 
framework is used:

AliRunDigitizer   * manager = new AliRunDigitizer(1,1);
manager->SetInputStream(0,"galice.root");
AliMUONDigitizerv1* dMUON   = new AliMUONDigitizerv1(manager)
manager->AddDigitizer(dMUON);
manager->Exec("deb");

============================================================
 How to run MUON RecPoint clusterization
============================================================
aliroot -b << EOF
.includepath $ALICE_ROOT/STEER
.includepath $ALICE_ROOT/MUON
.L $ALICE_ROOT/MUON/MUONrawclusters.C++
MUONrawclusters("galice.root",0,10); 

First event and last event are given by hand, but this will change.

============================================================
 How to run MUON Trigger
============================================================
.L $ALICE_ROOT/MUON/MUONtrigger.C
MUONtrigger("galice.root",0,10); 
>> IMPORTANT NOTE: in the present version, one can only have either
>> rawclusters or trigger information written in MUON.RecPoints.root
>> but not both of them i.e. running MUONtrigger after MUONrawclusters
>> will erase rawclusters from TreeR and vice versa.

First event and last event are given by hand, but this will change.

============================================================
 How to run MUON Tracking reconstruction (old output)
===========================================================
.includepath $ALICE_ROOT/STEER
.includepath $ALICE_ROOT/MUON
.L $ALICE_ROOT/MUON/MUONrecoNtuple.C++
MUONrecoNtuple(0,10,0,"galice.root")    

First event and last event are given by hand, but this will change.

===========================================================
 How to run MUON Tracking reconstruction (new output)
===========================================================
.includepath $ALICE_ROOT/STEER
.includepath $ALICE_ROOT/MUON
.L $ALICE_ROOT/MUON/MUONTracker.C++
MUONTracker(0,10,"galice.root")    

Output in MUON.Tracks.root using the new IO 
as a TClonesArray of AliMUONTrack

============================================================
 How to run MUONCheck macro
============================================================
To check the content of a root data file, the MUONCheck
provides a ascii output on screen.

To compile MUONCheck.C
.includepath $ALICE_ROOT/STEER
.includepath $ALICE_ROOT/MUON
.L $ALICE_ROOT/MUON/MUONCheck.C++

To print Kine : (default file is galice.root )
MUONkine()

To print hits : (default file is galice.root if not MUONhits("toto.root""); )
MUONhits()  

To print digits : (default file is galice.root)
MUONdigits()  

To print rawcluster : (default file is galice.root)
MUONrecpoints()

To print trigger : (default file is galice.root)
MUONTestTrigger()

===========================================================
 Still working ..............
===========================================================