README

   1 AliRoot
   2 -------
   3
   4 ########################### Release version ###############################
   5
   6 Last update Tue Jun 15 08:10:40 1999 - Federico Carminati
   7
   8 This is the Version 3.01 of the ALICE simulation and reconstruction
   9 software. This code will be released after the May ALICE Offline
  10 Meeting. It is intended to offer a general purpose framework for ALICE
  11 simulation and reconstruction. The program should not be considered
  12 complete, and we are relying on the feed-back from users to correct bugs
  13 and provide improvements.
  14
  15 The simulation program is based on GEANT3.21. A special version of the
  16 GEANT library and a mini-CERN Library are needed to run this code.
  17
  18 Installation
  19 ------------
  20
  21 - Install ROOT and define the ROOTSYS symbol correctly.
  22
  23 - Decide in which directory you will install the ALICE sofware. We will
  24 indicate it with <directory>
  25
  26 - Define the following global variables in the login script
  27
  28 ALICE                   = <directory>
  29 ALICE_LEVEL             = pro
  30 ALICE_ROOT              = $ALICE/$ALICE_LEVEL
  31 ALICE_TARGET            = `uname`
  32 LD_LIBRARY_PATH         = $LD_LIBRARY_PATH\:$ALICE_ROOT/lib (on all systems)
  33 SHLIB_PATH              = $SHLIB_PATH\:$ALICE_ROOT/lib (on hpux)
  34 PATH                    = $PATH\:$ALICE_ROOT/bin
  35
  36 At this point you should logout, login again and check that the symbols are
  37 set correctly
  38
  39 - Get the file /afs/cern.ch/alice/offline/dist/AliOffline3.01.tar.gz
  40
  41 - Unpack it with
  42
  43 $ cd $ALICE
  44 $ gtar xvfz AliOffline3.01.tar.gz
  45
  46 - install the CERN library part
  47
  48 $ cd $ALICE_ROOT
  49 $ gmake cernlibs
  50
  51 - Install the ALICE specific software
  52
  53 $ cd $ALICE_ROOT
  54 $ gmake
  55
  56 - Copy the file $ALICE_ROOT/.rootrc to your home directory
  57
  58 - run the code
  59
  60 $ aliroot
  61
  62 root [1] .x menu.C
  63
  64
  65 Notice for Linux users
  66 ======================
  67
  68 AliRoot requires the compiler system egcs 1.1.1 or later. Unfortunately the
  69 location of the include files is dependent on the compiler version on Linux.
  70 While g++ knows the location of the files relative to its own version, but
  71 this is not the case for the makedepend, that should be told where include
  72 files are. This is accomplished by the DEPINC variable in the file
  73 $ALIROOT/conf.
  74
  75 In case several error message appear during the make phase, complaining for
  76 include files not found, the list of include directories in DEPINC should
  77 be compared with the standard list of the compiler, that can be found out
  78 with the following commands:
  79
  80 touch dummy.cxx
  81 g++ -v dummy.cxx
  82
  83 and looking at the output between the lines:
  84
  85 #include <...> search starts here:
  86 .
  87 .
  88 .
  89 .
  90 End of search list.
  91
  92
  93 List of changes
  94 ===============
  95
  96 Sun Mar 21 12:38:38 CET 1999 ==================================================
  97
  98 -------------------------------------------------------------------------------
  99 AliRun.cxx
 100 removed AliDetector::FinishEvent call from AliRun::FinishRun
 101
 102 -------------------------------------------------------------------------------
 103 Makefile.hpux
 104 added +Onolimit to the optimisation on the hp to avoid warning messages
 105
 106 -------------------------------------------------------------------------------
 107 TOPDIR changed to ALITOP as it should be in this README file.
 108
 109 Wed Mar 24 15:44:49 CET 1999 ==================================================
 110
 111 -------------------------------------------------------------------------------
 112 SGI Makefile corrected
 113
 114 -------------------------------------------------------------------------------
 115 Make-macros corrected to include the ITS*.det files in the distribution
 116
 117 -------------------------------------------------------------------------------
 118 Code of PHOSv2 introduced, thanks to M. Volkov
 119
 120 Thu Mar 25 21:19:52 CET 1999 ==================================================
 121
 122 -------------------------------------------------------------------------------
 123 Change the load order in Make-macros
 124
 125 Wed Apr  7 09:25:51 CEST 1999 =================================================
 126
 127 -------------------------------------------------------------------------------
 128 AliTPC.cxx, AliTPCv2.cxx, AliTPCSecGeo.h, GeantPatch.F
 129
 130 The drift gas parameters updated using the recent numbers from A.Sharma.
 131 M.Kowalski
 132
 133 Thu Apr  8 16:08:12 CEST 1999 =================================================
 134
 135 -------------------------------------------------------------------------------
 136 Slight changes to M.Volkov files to correct some syntactical problems
 137
 138 -------------------------------------------------------------------------------
 139 Changed common_ to G..._t in TGeant3.h to be compatible with P.Murat, CDF.
 140
 141 Fri Apr  9 08:06:21 CEST 1999 =================================================
 142
 143 -------------------------------------------------------------------------------
 144 Restructuration of TGeant3. Common addresses are now returned by access
 145 functions and they are all private.
 146
 147 Fri Apr 20 08:06:21 CEST 1999 =================================================
 148
 149 -------------------------------------------------------------------------------
 150 Introduction of the cvs repository. Now all changes are maintained via cvs.