44ca93d2ede66f07607c00d06cf801ea024474f9
[u/mrichter/AliRoot.git] / 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.