1 | <!-- ******************************************************** --> |
---|
2 | <!-- --> |
---|
3 | <!-- [History] --> |
---|
4 | <!-- Converted to DocBook: Katsuya Amako, Aug-2006 --> |
---|
5 | <!-- Changed by: Dennis Wright, 2-Dec-2002 --> |
---|
6 | <!-- Proof read by: Joe Chuma, 7-Jun-1999 --> |
---|
7 | <!-- --> |
---|
8 | <!-- ******************************************************** --> |
---|
9 | |
---|
10 | <para> |
---|
11 | This section describes the global computing environment required |
---|
12 | for installing the Geant4 toolkit. To set up your specific |
---|
13 | computing environment for Geant4, refer to Section 2 of this Guide. |
---|
14 | </para> |
---|
15 | |
---|
16 | <para> |
---|
17 | A shell script (<literal>Configure</literal>) is provided to |
---|
18 | facilitate the installation procedure, and to help the user set up |
---|
19 | the environment correctly. |
---|
20 | </para> |
---|
21 | |
---|
22 | |
---|
23 | <!-- ******************* Section (Level#1) ****************** --> |
---|
24 | <sect1 id="sect.Support"> |
---|
25 | <title> |
---|
26 | Supported Computers and Operating Systems |
---|
27 | </title> |
---|
28 | |
---|
29 | <para> |
---|
30 | Geant4 is supported under the following operating systems: |
---|
31 | |
---|
32 | <itemizedlist spacing="compact"> |
---|
33 | <listitem><para> |
---|
34 | Linux on PC with g++ (gcc compiler) |
---|
35 | </para></listitem> |
---|
36 | <listitem><para> |
---|
37 | MacOSX with g++ (gcc compiler) |
---|
38 | </para></listitem> |
---|
39 | <listitem><para> |
---|
40 | Windows/XP with MicroSoft Visual C++ |
---|
41 | </para></listitem> |
---|
42 | </itemizedlist> |
---|
43 | </para> |
---|
44 | |
---|
45 | <para> |
---|
46 | Currently, this is the set of flavors which can be associated with |
---|
47 | the environment variable <literal>$G4SYSTEM</literal> to identify the |
---|
48 | system architecture and compiler used: |
---|
49 | |
---|
50 | <literallayout><literal> |
---|
51 | Linux - Scientific Linux CERN, SLC5 (or SLC4) |
---|
52 | g++ gcc 4.1.2 (or 3.4.6) G4SYSTEM: Linux-g++ |
---|
53 | MacOSX - MacOSX Darwin 10.6 (or 10.5) |
---|
54 | g++ gcc 4.2.1 (or 4.0.1) G4SYSTEM: Darwin-g++ |
---|
55 | Windows - Windows XP and Cygwin32 |
---|
56 | MSVC++ 9.0, Visual Studio 2008 G4SYSTEM: WIN32-VC |
---|
57 | </literal></literallayout> |
---|
58 | </para> |
---|
59 | |
---|
60 | <para> |
---|
61 | For a more detailed description of supported platforms/compilers |
---|
62 | and versions of third party software, please refer to the release |
---|
63 | notes available with the current release you're using in |
---|
64 | <literal>geant4/ReleaseNotes</literal> (also accessible from the web |
---|
65 | <ulink url="http://cern.ch/geant4/support/download.shtml"> |
---|
66 | distribution page |
---|
67 | </ulink> |
---|
68 | ). |
---|
69 | </para> |
---|
70 | |
---|
71 | </sect1> |
---|
72 | |
---|
73 | |
---|
74 | <!-- ******************* Section (Level#1) ****************** --> |
---|
75 | <sect1 id="sect.ReqSoft"> |
---|
76 | <title> |
---|
77 | Required Software |
---|
78 | </title> |
---|
79 | |
---|
80 | <para> |
---|
81 | To run Geant4, the following software must be properly installed in |
---|
82 | your computing environment: |
---|
83 | |
---|
84 | <itemizedlist spacing="compact"> |
---|
85 | <listitem><para> |
---|
86 | C++ compiler |
---|
87 | <para> |
---|
88 | (compiler from Unix vendor, g++ or Visual C++ for Windows systems) |
---|
89 | </para> |
---|
90 | </para></listitem> |
---|
91 | <listitem><para> |
---|
92 | CLHEP library |
---|
93 | <para> |
---|
94 | (see CLHEP reference guide |
---|
95 | <ulink url="http://cern.ch/clhep/manual/RefGuide/"> |
---|
96 | cern.ch/clhep/manual/RefGuide |
---|
97 | </ulink> |
---|
98 | ) |
---|
99 | </para> |
---|
100 | </para></listitem> |
---|
101 | <listitem><para> |
---|
102 | GNU Make (note: g++ preprocessing is used to build file |
---|
103 | dependencies) is also used and a UNIX shell |
---|
104 | </para></listitem> |
---|
105 | <listitem><para> |
---|
106 | The Geant4 toolkit source code |
---|
107 | </para></listitem> |
---|
108 | </itemizedlist> |
---|
109 | </para> |
---|
110 | |
---|
111 | </sect1> |
---|
112 | |
---|
113 | |
---|
114 | <!-- ******************* Section (Level#1) ****************** --> |
---|
115 | <sect1 id="sect.VisSoft"> |
---|
116 | <title> |
---|
117 | Visualization Software |
---|
118 | </title> |
---|
119 | |
---|
120 | <para> |
---|
121 | The above list of software is the minimum required for a |
---|
122 | non-graphical setup of Geant4. To use visualization graphics in |
---|
123 | Geant4 and/or a graphical user interface (GUI), at least one of the |
---|
124 | following graphic systems or packages is required in your computing |
---|
125 | environment: |
---|
126 | |
---|
127 | <itemizedlist spacing="compact"> |
---|
128 | <listitem><para> |
---|
129 | X Windows |
---|
130 | </para></listitem> |
---|
131 | <listitem><para> |
---|
132 | <ulink url="http://www.opengl.org/"> |
---|
133 | OpenGL |
---|
134 | </ulink> |
---|
135 | or |
---|
136 | <ulink url="http://www.mesa3d.org/"> |
---|
137 | MesaGL |
---|
138 | </ulink> |
---|
139 | (free software compatible with OpenGL) |
---|
140 | </para></listitem> |
---|
141 | <listitem><para> |
---|
142 | <ulink url="http://geant4.kek.jp/GEANT4/vis/"> |
---|
143 | DAWN |
---|
144 | </ulink> |
---|
145 | , a PostScript renderer |
---|
146 | </para></listitem> |
---|
147 | <listitem><para> |
---|
148 | <ulink url="http://www.trolltech.com"> |
---|
149 | Qt |
---|
150 | </ulink> |
---|
151 | , a powerfull toolkit |
---|
152 | </para></listitem> |
---|
153 | <listitem><para> |
---|
154 | <ulink url="http://oss.sgi.com/projects/inventor/"> |
---|
155 | Open Inventor |
---|
156 | </ulink> |
---|
157 | (free software from SGI) |
---|
158 | </para></listitem> |
---|
159 | <listitem><para> |
---|
160 | <ulink url="http://openscientist.lal.in2p3.fr/"> |
---|
161 | Open Scientist |
---|
162 | </ulink> |
---|
163 | (Interactive environment, including GUI) |
---|
164 | </para></listitem> |
---|
165 | <listitem><para> |
---|
166 | <ulink url="http://www.slac.stanford.edu/BFROOT/www/Computing/Graphics/Wired/"> |
---|
167 | HepRApp Browser |
---|
168 | </ulink> |
---|
169 | ( |
---|
170 | <ulink url="http://www.slac.stanford.edu/~perl/heprep/"> |
---|
171 | HepRep |
---|
172 | </ulink> |
---|
173 | Browser) |
---|
174 | </para></listitem> |
---|
175 | <listitem><para> |
---|
176 | <ulink url="http://wired.freehep.org/"> |
---|
177 | WIRED4 JAS Plug-In |
---|
178 | </ulink> |
---|
179 | ( |
---|
180 | <ulink url="http://www.slac.stanford.edu/~perl/heprep/"> |
---|
181 | HepRep |
---|
182 | </ulink> |
---|
183 | Browser) |
---|
184 | </para></listitem> |
---|
185 | <listitem><para> |
---|
186 | <ulink url="http://cern.ch/geant4/geant4_public/source/geant4/environments/MOMO/docs/MOMOHelp.html"> |
---|
187 | Momo |
---|
188 | </ulink> |
---|
189 | (a |
---|
190 | <ulink url="http://java.sun.com/"> |
---|
191 | Java |
---|
192 | </ulink> |
---|
193 | -based GUI environment, GGE, GPE, ...) |
---|
194 | </para></listitem> |
---|
195 | <listitem><para> |
---|
196 | VRML browser |
---|
197 | </para></listitem> |
---|
198 | </itemizedlist> |
---|
199 | </para> |
---|
200 | |
---|
201 | <para> |
---|
202 | Alternatively, you can produce an ascii file for VRML or DAWN. |
---|
203 | </para> |
---|
204 | |
---|
205 | <para> |
---|
206 | More information is available in Section 8.6, Visualization |
---|
207 | Drivers, of the User's Guide for Application Developers. |
---|
208 | </para> |
---|
209 | |
---|
210 | </sect1> |
---|
211 | |
---|
212 | |
---|
213 | <!-- ******************* Section (Level#1) ****************** --> |
---|
214 | <sect1 id="sect.SoftAnaHisto"> |
---|
215 | <title> |
---|
216 | Software for Analysis and Histogramming |
---|
217 | </title> |
---|
218 | |
---|
219 | <para> |
---|
220 | Histogramming facilities are provided through the <emphasis role="bold">AIDA</emphasis> |
---|
221 | abstract interface, which in this case needs to be installed as |
---|
222 | well: |
---|
223 | |
---|
224 | <itemizedlist spacing="compact"> |
---|
225 | <listitem><para> |
---|
226 | <ulink url="http://aida.freehep.org/"> |
---|
227 | AIDA |
---|
228 | </ulink> |
---|
229 | (Abstract Interfaces for Data Analysis) |
---|
230 | </para></listitem> |
---|
231 | </itemizedlist> |
---|
232 | </para> |
---|
233 | |
---|
234 | <para> |
---|
235 | External, AIDA-compliant packages which provide the necessary |
---|
236 | functionalities for doing histogramming (and therefore, should be |
---|
237 | optionally installed) are: |
---|
238 | |
---|
239 | <itemizedlist spacing="compact"> |
---|
240 | <listitem><para> |
---|
241 | <ulink url="http://iaida.dynalias.net/"> |
---|
242 | iAIDA |
---|
243 | </ulink> |
---|
244 | (iAIDA, an implementation of AIDA in C++) |
---|
245 | </para></listitem> |
---|
246 | <listitem><para> |
---|
247 | <ulink url="http://jas.freehep.org/jas3/"> |
---|
248 | JAS |
---|
249 | </ulink> |
---|
250 | (Java Analysis Studio) |
---|
251 | </para></listitem> |
---|
252 | <listitem><para> |
---|
253 | <ulink url="http://openscientist.lal.in2p3.fr/"> |
---|
254 | Open Scientist |
---|
255 | </ulink> |
---|
256 | (Interactive Analysis Environment). |
---|
257 | </para></listitem> |
---|
258 | <listitem><para> |
---|
259 | <ulink url="http://ilcsoft.desy.de/portal/software_packages/raida/"> |
---|
260 | rAIDA |
---|
261 | </ulink> |
---|
262 | (rAIDA, a <ulink url="http://root.cern.ch/">Root</ulink> implementation of AIDA) |
---|
263 | </para></listitem> |
---|
264 | </itemizedlist> |
---|
265 | </para> |
---|
266 | |
---|
267 | </sect1> |
---|