TPC/scripts/README

   1 ----------
   2 Quickstart
   3 -----------
   4 Without thinking, you can do the follwoing to create a tree with calibration entries.
   5 The default settings should work, however you might want to change them for 'better' performance.
   6
   7 Do the following:
   8 1. Setup environment
   9    a. gui dependend variables
  10
  11 export SCRIPTDIR=$ALICE_ROOT/TPC/scripts
  12 export PATH=$SCRIPTDIR:$PATH
  13
  14    b. Alien
  15
  16 alien-token-init
  17 source /tmp/gclient_env_${UID}
  18 or
  19 $ALICE_ROOT/TPC/CalibMacros/alienSetupGSI.sh (GSI specific)
  20
  21 2. Run tree creation
  22    a. Run on a list of run numbers with name 'list.txt', one run number per line
  23
  24 makeCalibTree -l list.txt
  25
  26    b. Run on a range of run numbers:
  27
  28 makeCalibTree -r 75000-80000
  29
  30
  31 myrun=70000
  32 endrun=90000
  33 bdir=`pwd`
  34 while [ $myrun -le ${endrun} ]  ; do
  35        mydir=$GUI_OUTDIR/tmp/$myrun;
  36        mkdirhier $mydir
  37        cd $mydir;
  38        $BATCHCOMMAND -oo $GUI_OUTDIR/logs/log$myrun.log -eo $GUI_OUTDIR/logs/err$myrun.out  makeCalibTree  -o   -r $myrun-$(($myrun+500));
  39        myrun=$(( $myrun +500 )) ;
  40        echo $myrun;
  41 done;
  42 cd $bdir
  43
  44    c. Run automatic tree creation for all runs in the
  45       data taking period which was set up (see below)
  46       !!!WARNING!!! this will take quite some time
  47
  48 makeCalibTree -a
  49
  50 3. Start the GUI browser
  51
  52 guiTime
  53
  54
  55 -------------------
  56 General information
  57 -------------------
  58 The macros and shell scripts used are stored in $ALICE_ROOT/TPC/CalibMacros/guiTime
  59 If you would like to modify some setting (see below), but do not have write access to this
  60 directory, you can copy the complete directory somewhere else and setup the environment
  61 variables accordingly:
  62
  63 export SCRIPTDIR=path_to_my_directory
  64 export PATH=$SCRIPTDIR:$PATH
  65
  66 - setup scripts
  67 All user relevant setup is done the shell script 'guiEnv' and the root macro 'ConfigOCDB.C'
  68 All other files don't need to be modified by the user.
  69
  70 - scripts for the tree creation:
  71 makeCalibTree:        Steering script to launch the tree creation
  72 makeCalibTreeList:    script running the actual root process to create the tree
  73
  74 - scripts to start the gui:
  75 gui 'filename':       Start the CalibViewerGUI using the tree in file 'filename'. Invokes the script
  76                       startGUI.C
  77 guiTime ['filename']: Start the CalibViewerGUItime. Optionally a filename containing the calibration
  78                       calibration tree can be specified. Otherwise the trees from the directory setup
  79                       in guiEnv will be used (see below). Invokes the script startGUItime.C
  80
  81 -oter scripts:
  82 loadlibsREC.C:        Root macro to load only libraries needed to start the gui and tree creation.
  83
  84
  85 ----------------
  86 Customised setup
  87 ----------------
  88
  89 - Defining the OCDB directories (ConfigOCDB.C):
  90 Before starting the tree creation or gui the macro 'ConfigOCDB.C' is exectued. This macro should contain
  91 all the setup needed to point to the proper OCDB directories. If alien is used, alien needs also to be
  92 setup in the macro. Open the macro for examples.
  93
  94 - General output information (guiEnv):
  95 In the 'guiEnv' script environment variables defining default output directories etc. See comments in the
  96 file for explanations.
  97