MUON/READMEraw.txt

   1 // $Id$
   2
   3 /*!
   4
   5 \page README_raw Raw data
   6
   7 \section raw_s1 How to read & decode raw data
   8
   9 The macros MUONRawStreamTracker.C and MUONRawStreamTrigger.C can
  10 be used to read & decode DDL files and root files.
  11 DATE files are no more supported.
  12
  13 For tracker raw data, full output
  14 <pre>
  15 .includepath $ALICE_ROOT/STEER
  16 .includepath $ALICE_ROOT/MUON
  17 .includepath $ALICE_ROOT/RAW
  18 .L $ALICE_ROOT/MUON/MUONRawStreamTracker.C+
  19 MUONRawStreamTrackerExpert(rawFileName, maxEvent, firstDDL, lastDDL)
  20 </pre>
  21
  22
  23 For tracker raw data, just digit output
  24 <pre>
  25 .includepath $ALICE_ROOT/STEER
  26 .includepath $ALICE_ROOT/MUON
  27 .includepath $ALICE_ROOT/RAW
  28 .L $ALICE_ROOT/MUON/MUONRawStreamTracker.C+
  29 MUONRawStreamTrackerSimple(rawFileName, maxEvent, firstDDL, lastDDL)
  30 </pre>
  31
  32 For trigger raw data, full output
  33 <pre>
  34 .includepath $ALICE_ROOT/STEER
  35 .includepath $ALICE_ROOT/MUON
  36 .includepath $ALICE_ROOT/RAW
  37 .L $ALICE_ROOT/MUON/MUONRawStreamTrigger.C+
  38 MUONRawStreamTrigger(maxEvent, firstDDL, lastDDL, rawFileName)
  39 </pre>
  40
  41 For trigger raw data, local response output
  42 <pre>
  43 .includepath $ALICE_ROOT/STEER
  44 .includepath $ALICE_ROOT/MUON
  45 .includepath $ALICE_ROOT/RAW
  46 .L $ALICE_ROOT/MUON/MUONRawStreamTrigger.C+
  47 MUONRawStreamTriggerSimple(maxEvent, firstDDL, lastDDL, rawFileName)
  48 </pre>
  49
  50
  51 Default wise the macro read all DDL files from the current directory for 1000 events.
  52 For root file rawFileName must end with .root. For DDL files you have to specified the directory
  53 where the raw0...n subdirectories are located:
  54 <pre>
  55 MUONRawStreamTracker(..)(maxEvent, firstDDL, lastDDL, "$YOUR_WORKING_DIRECTORY/"); //Do not forget the slash at the end!
  56 </pre>
  57
  58 \section raw_s2 Timing of the raw data decoders
  59
  60 The macro MUONTimeRawStreamTracker.C can used to check the timing (speed) performance
  61 of the existing offline decoder for the tracker DDLs (AliMUONRawStreamTracker) and also
  62 for the new high performance decoder (AliMUONRawStreamTrackerHP). It can be invoked
  63 as follows:
  64
  65 <pre>
  66  $ aliroot
  67 .L $ALICE_ROOT/MUON/MUONTimeRawStreamTracker.C+
  68  MUONTimeRawStreamTracker(filename, maxEvent);
  69 </pre>
  70
  71 where \em filename is the name of a file containing the raw data, or alternatively
  72 the directory containing rawX (X being an integer) paths with the raw DDL
  73 data. The \em maxEvent value is the maximum event to process (default set to
  74 1000). Thus the macro will time the algorithm for all events in the range
  75 [0 .. maxEvent-1].
  76
  77
  78 This chapter is defined in the READMEraw.txt file.
  79
  80 */
  81