1a41249f9e252ebfe5cce2468c7fbe1b8054f359
[u/mrichter/AliRoot.git] / README
1 AliRoot
2 -------
3
4 ########################### Release version 3.01 ##############################
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 EITHER
40 ======
41
42 - Get the file /afs/cern.ch/alice/offline/dist/AliOffline3.01.tar.gz
43
44 - Unpack it with
45
46 $ cd $ALICE
47 $ gtar xvfz AliOffline3.01.tar.gz
48
49 OR
50 ==
51
52 - Get the files
53
54       /afs/cern.ch/alice/offline/dist/AliRoot3.01.tar.gz (AliRoot code)
55       /afs/cern.ch/alice/offline/dist/AliLibs3.01.tar.gz (minicern code)
56
57 THEN PROCEED WITH
58 =================
59
60 - install the CERN library part
61
62 $ cd $ALICE_ROOT
63 $ gmake cernlibs
64
65 - Install the ALICE specific software
66
67 $ cd $ALICE_ROOT
68 $ gmake
69
70 - Copy the file $ALICE_ROOT/.rootrc to your home directory
71
72 - run the code
73
74 $ aliroot
75
76 root [1] .x menu.C
77
78
79 Notice for Linux users
80 ======================
81
82 AliRoot requires the compiler system egcs 1.1.1 or later. Unfortunately the 
83 location of the include files is dependent on the compiler version on Linux.
84 While g++ knows the location of the files relative to its own version, but 
85 this is not the case for the makedepend, that should be told where include
86 files are. This is accomplished by the DEPINC variable in the file
87 $ALIROOT/conf.
88
89 In case several error message appear during the make phase, complaining for
90 include files not found, the list of include directories in DEPINC should
91 be compared with the standard list of the compiler, that can be found out
92 with the following commands:
93
94 touch dummy.cxx
95 g++ -v dummy.cxx
96
97 and looking at the output between the lines:
98
99 #include <...> search starts here:
100 .
101 .
102 .
103 .
104 End of search list.
105
106
107 List of changes
108 ===============
109
110 Sun Mar 21 12:38:38 CET 1999 ==================================================
111
112 -------------------------------------------------------------------------------
113 AliRun.cxx
114 removed AliDetector::FinishEvent call from AliRun::FinishRun
115
116 -------------------------------------------------------------------------------
117 Makefile.hpux
118 added +Onolimit to the optimisation on the hp to avoid warning messages
119
120 -------------------------------------------------------------------------------
121 TOPDIR changed to ALITOP as it should be in this README file. 
122
123 Wed Mar 24 15:44:49 CET 1999 ==================================================
124
125 -------------------------------------------------------------------------------
126 SGI Makefile corrected
127
128 -------------------------------------------------------------------------------
129 Make-macros corrected to include the ITS*.det files in the distribution
130
131 -------------------------------------------------------------------------------
132 Code of PHOSv2 introduced, thanks to M. Volkov
133
134 Thu Mar 25 21:19:52 CET 1999 ==================================================
135
136 -------------------------------------------------------------------------------
137 Change the load order in Make-macros
138
139 Wed Apr  7 09:25:51 CEST 1999 =================================================
140
141 -------------------------------------------------------------------------------
142 AliTPC.cxx, AliTPCv2.cxx, AliTPCSecGeo.h, GeantPatch.F
143
144 The drift gas parameters updated using the recent numbers from A.Sharma.
145 M.Kowalski
146
147 Thu Apr  8 16:08:12 CEST 1999 =================================================
148
149 -------------------------------------------------------------------------------
150 Slight changes to M.Volkov files to correct some syntactical problems
151
152 -------------------------------------------------------------------------------
153 Changed common_ to G..._t in TGeant3.h to be compatible with P.Murat, CDF.
154
155 Fri Apr  9 08:06:21 CEST 1999 =================================================
156
157 -------------------------------------------------------------------------------
158 Restructuration of TGeant3. Common addresses are now returned by access
159 functions and they are all private.
160
161 Fri Apr 20 08:06:21 CEST 1999 =================================================
162
163 -------------------------------------------------------------------------------
164 Introduction of the cvs repository. Now all changes are maintained via cvs.