MUON/READMEcosmics.txt

   1 // $Id$
   2
   3 /*! \page README_cosmics The Software testing on Cosmics Test Data
   4
   5
   6 Seeveral macros has been developed during the Offline shifts
   7 during the Feb-March 2008 cosmics runs. On this page we summarize
   8 how to use these macros.
   9
  10 \section cosmics_s1 Software installation
  11
  12 - For installing AliRoot see ALICE Offline Installation Web page at
  13 http://aliceinfo.cern.ch/Offline/AliRoot/Installation.html
  14
  15 - and for installing alien see ALICE Offline Tutorial, slides 131 - 145 at
  16 http://aliceinfo.cern.ch/Offline/Analysis/Tutorial
  17
  18 If we need a fast fix, it may be provided via a patch.txt file,
  19 which should be then applied in this way:
  20 <pre> $&gt; cd $ALICE_ROOT
  21  $&gt; patch -p0 --posix &lt; patch.txt
  22  $&gt; make
  23 </pre>
  24
  25 Eventually, we may get in situation when an important update of the MUON code
  26 is not yet included in the release, and we may then need to replace the MUON
  27 from the release with the MUON from the trunk:
  28 <pre> $&gt; cd $ALICE_ROOT
  29  $&gt; mv MUON MUON.release
  30  $&gt; svn co http://alisoft.cern.ch/AliRoot/trunk/MUON MUON
  31  $&gt; rm -fr $ALICE_ROOT/lib/tgt_$ALICE_TARGET/libMUON*
  32  $&gt; make
  33 </pre>
  34
  35 \section cosmics_s2 Running reconstruction
  36
  37 During the offline shifts, there has been added a a new macro
  38 runDataReconstruction.C. You have first to edit the macro and change
  39 the value of <em>input</em> with the path to raw data file
  40 which you want to reconstruct. Then you prepare an output directory
  41 and run reconstruction in this way:
  42
  43 <pre> $&gt; alien-token-int
  44  $&gt; . /tmp/gclient_env_$UID
  45  $&gt; cd $ALICE_ROOT/MUON
  46  $&gt; mkdir runXYZ_c1_out
  47  $&gt; cp rootlogon.C .rootrc runDataReconstruction.C runXYZ_c1_out
  48  $&gt; cd runXYZ_c1_out
  49  $&gt; root
  50  root[0] .x runDataReconstruction.C(1) &gt;&amp; runReco.out
  51 </pre>
  52
  53 This will run reconstruction with the first calibration option
  54 selected ("NOGAIN"); to run the same with the second calibration option
  55 ("GAINCONSTANTCAPA"):
  56 <pre> $&gt; cd $ALICE_ROOT/MUON
  57  $&gt; mkdir runXYZ_c2_out
  58  $&gt; cp rootlogon.C .rootrc runDataReconstruction.C runXYZ_c2_out
  59  $&gt; cd runXYZ_c2_out
  60  $&gt; root
  61  root[0] .x runDataReconstruction.C(2) &gt;&amp; runReco.out
  62  </pre>
  63
  64 \section cosmics_s3 Inspecting data with mchview
  65
  66 The new macro MUONOfflineShift.C will process the data
  67 and generate the Root output file which can be then open with
  68 the \em mchview program:
  69
  70 <pre> $&gt; alien-token-int
  71  $&gt; . /tmp/gclient_env_$UID
  72  $&gt; cd $ALICE_ROOT/MUON
  73  root[0] .L MUONOfflineShift.C+
  74  root[1] MUONOfflineShift("path_to_raw_file","basename of output file");
  75  .q
  76
  77  $&gt; mchview --use basename.root
  78 </pre>
  79
  80
  81 \section cosmics_s4 Inspecting rec points
  82
  83 There has been added a new macro TestRecPoints.C.
  84
  85 The analysis of the trigger part needs only RecPoints: the digits are then re-created
  86 out of the local trigger information. The analysis of the tracker part needs the
  87 MUON.Digits, which can be created during reconstruction with the "SAVEDIGITS" option.
  88 (This option is switched on by default in the runDataReconstruction.C macro.)
  89 The macro, then, performs the clusterization on the fly and analyses data.
  90 This was necessary since, normally, the clusters are saved in the AliESDs.root
  91 but only for reconstructed tracks (which I guess will be very few in the cosmic run).
  92 Re-performing clusterization is surely more time expensive, but (I guess) is the
  93 only way to get information on all clusters even when no track is created.
  94
  95 To use the macro:
  96 <pre> $&gt; cd $ALICE_ROOT/MUON
  97  $&gt; root
  98  root[0] .L TestRecPoints.C+
  99  root[1] TestRecPoints(runXYZ_c1);
 100 </pre>
 101
 102 It is also possible to check only tracker:
 103 <pre> root[1] TestRecPoints("pathToData","outputDirectory",kOnlyTracker);
 104 </pre>
 105
 106 or only the trigger
 107 <pre> root[0] TestRecPoints("pathToData","outputDirectory",kOnlyTrigger);
 108 </pre>
 109
 110 \section cosmics_s5 Event display
 111
 112 See EVE/README_MUON.
 113
 114 This chapter is defined in the READMEcosmics.txt file.
 115
 116 */