1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
4 <TITLE> Users Guide for AliRoot </TITLE>
5 <!-- Changed by: Yiota Foka, 18-Mar-1999 -->
6 <STYLE TYPE="text/css">
7 H1 { font-style: italic; color: green ; font-size: 24pt; align: center}
8 H2 { color: red ; font-size: 22pt }
9 H3 { color: blue ; font-size: 20pt }
10 H4 { color: violet; font-size: 18pt }
11 H5 { color: olive ; font-size: 16pt }
12 H6 { color: maroon; font-size: 14pt }
13 TABLE { font-size: 14pt }
16 <!-- Header material -->
18 <table border=0 cellpadding=5 cellspacing=0 width="100%">
20 <td align=left width=30%>
21 <img alt="Alice" src="gif/Logo.gif" width="60" height="60"
22 align="absmiddle" border=1>
23 <td align=center width=40%>
25 Alice Off-Line Project
27 <td align=right width=30% valign=bottom>
29 <script language="JavaScript">
30 document.write("Last modified "+ document.lastModified)
40 <BODY TEXT="#000000" BGCOLOR="#FFFFFF"
41 LINK="#0000FF" VLINK="#551A8B" ALINK="#FF0000">
44 <BR><H1> Users Guide for AliRoot</H1>
47 <BR> The source code for all AliRoot classes is <A
48 HREF="roothtml/USER_Index.html">documented</A> and the html files are
49 automatically generated by ROOT.
54 <LI><A HREF="#1">How to run</A> AliRoot
55 <LI><A HREF="roothtml/USER_Index.html">AliRoot classes</A>
60 <H2><A NAME="1">1. How to run AliRoot</A></H2>
62 <P>To execute the Alice detector simulation program.
65 <LI>Type: <KBD> $ aliroot </KBD>
67 <BR> this starts AliRoot in interactive mode by default after few seconds
68 the <b>root</b> prompt apears
69 <BR>you can now start a AliRoot
70 interactive session by either creating the standard menu
72 <LI>Type: <KBD> root[0] .x menu.C </KBD>
74 <LI>Type: <KBD> root[1] gAlice->Run() </KBD>
76 <LI>Type: <KBD> root[1] gAlice->RunLego() </KBD>
78 <BR> to divert the long output generated by the AliRoot initialisation phase
79 to an eg. AliRoot.log file
80 <LI>Type: <KBD> root[3] .x menu.C > AliRoot.log </KBD>
82 <LI>Type: <KBD> root[4] gAlice->Run(); > AliRoot.log </KBD>
85 <P>The time for the initialisation phase of AliRoot is typicaly 30 seconds.
87 <P> By default the macro <A HREf="roothtml/examples/menu.C.html">menu.C</A>
88 invokes <A HREF="roothtml/AliRun.html">AliRun::Init</A> with the
89 configuration file <A HREF="roothtml/examples/Config.C.html">Config.C</A>.
91 <P>When the initialisation is finished the <b>root</b> prompt apears
93 <BR>You also get back the Root control bar menu.
95 <P>You can now select options from the bar menu.
99 <BR> to generate an event with the number of tracks and the configuration as specified in <A HREF="roothtml/examples/Config.C.html"> Config.C </A>
102 <BR> to generate the standard lego plots for radiation and absorption length. By default the granularity is 60 rays in theta and 60 rays in phi.
103 <BR>To view the results when this command is finished type:
105 <KBD> root[0] .x <A HREF="roothtml/examples/lego.C.html">lego.C</A> </KBD>
108 <BR> to change the parameters if you do not want to run with the default ones
110 <br><br><KBD> root[3] gAlice->RunLego (your list of parameters) </KBD>
112 <A HREF="roothtml/AliRun.html">AliRun::RunLego </A> for details
115 <LI><B> Top, Front, Side view </B>
116 <BR> to generate the corresponding cut view of Alice detector.
117 <BR> note that it takes a long time to execute a cut view typicaly
118 of the order of about 30 sec.
120 <LI><B> Menu Trees </B>
121 <BR> this shows a new menu from which you can draw the geometry tree for
122 most of Alice detectors.
123 <BR> double-clicking on an Alice detector generates its specifications.
125 <LI><B> Menu Pictures </B>
126 <BR> this shows a new menu from which you can draw the major Alice detectors
129 <LI><B> Other Options </B>
130 <BR> allow to switch ON/OFF various drawing modes.
133 <P>For more details on the functionality see the documentation of
134 <A HREF="roothtml/AliRun.html">AliRun</A> and
135 <A HREF="roothtml/TGeant3.html">TGeant3</A> classes
137 A global varial <var> gAlice </var>
138 can be used to invoke the AliRun class functions.
140 A global varial <var>gMC</var>
141 can be used to invoke the TGeant3 class functions.
143 <P> Note that several TGeant3 functions are also available by clicking with
144 the right button on a canvas while in the AliRoot session.
149 <LI>Type: <KBD> root[3] .q </KBD>
153 <!! ======================================================================>
155 <!! <A NAME="2"><H2></H2>
157 <!======================================================================>
159 <!! <A NAME="3"><H2></H2>
162 <!!======================================================================>
164 <!! <A NAME="4"><H2></H2>
167 <!===========================================================================>
173 <A HREF="mailto:Yiota.Foka@cern.ch">Yiota Foka</A>
176 <A HREF="http://www1.cern.ch/ALICE">
178 <A HREF="http://www1.cern.ch/ALICE/Projects/offline">