<HTML>
<HEAD>
<TITLE>How to run AliRoot</TITLE>
+<!-- Changed by: , 1-Nov-1999 -->
<link rev="made" href="mailto:Federico.Carminati@cern.ch">
<STYLE>
BODY {
</TR>
</TABLE>
-<h2>How to Run AliRoot</h2>
-<h3>For the impatient user</h3>
+<H2><A NAME="#Content">Content</A></H2>
+
+<UL>
+
+<LI><A HREF="#For the impatient">For the impatient user</A></LI>
+
+<LI><A HREF="#A more detailed view">A more detailed view</A></LI>
+
+<LI><A HREF="#Batch processing">Batch processing</A></LI>
+
+</UL>
+
+<HR>
+
+<h2><A HREF="#Content" NAME="For the impatient">For the impatient user</A></h2>
<p> <a href="picts/menubar.gif">
<img src="picts/menubar.gif" alt="AliRoot menu bar"
-height=50% align=right></a>
+height=250 align=right></a>
<p> To start up AliRoot after installation just type
<p> <a href="picts/display.gif">
<img src="picts/display.gif" alt="AliRoot Event Display"
-height=30% align=right></a>
+height=160 align=right></a>
<p> You can now select several actions from the menu.
<p> <b>Run</b>
-<p> generates to generate an event with the number of tracks and the
+<p> generates an event with the number of tracks and the
configuration as specified in <A
HREF="roothtml/examples/Config.C.html">Config.C</A>. The hits deposited
<p> <a href="picts/legoex.gif">
<img src="picts/legoex.gif" alt="Example of Lego Plot"
-height=30% align=right></a>
+height=150 align=right></a>
<p> generates the standard lego plots for radiation and absorption
length. By default the granularity is 60 rays in theta and 60 rays in phi.
<p> <KBD> root[0] .x <A HREF="roothtml/examples/lego.C.html">lego.C</A> </KBD>
-<p> to change the parameters of the lego run you could specify them
-in the calling sequence of the RunLego method
-ones type:
+<p> the parameters of the lego run can be specified
+in the calling sequence of the RunLego method as follows:
<p> <KBD> root[3] gAlice->RunLego (your list of parameters) </KBD>
<p> <a href="picts/treex.gif">
<img src="picts/treex.gif" alt="Example of Tree"
-height=30% align=right></a>
+height=150 align=right></a>
<p> see <A HREF="roothtml/AliRun.html">AliRun</a>::RunLego for details
<p> This shows a new menu from which you can draw the geometry tree for the
Alice detectors. Clicking with the right button on the pad with the name of
-a geometrical element give access to a number of graphic and inspect
+a geometrical element gives access to a number of graphic and inspect
functions. Double-clicking on the pad generates a drawing of the specifications
of the geometry of the element.
<p> <a href="picts/tpcex.gif">
<img src="picts/tpcex.gif" alt="Example of Picture"
-height=30% align=right></a>
+height=150 align=right></a>
<p> <b>Menu Pictures</b>
<p> <KBD>root [ ] .q</KBD>
-<h3>A more detailed view</h3>
+<h2><A HREF="#Content" NAME="A more detailed view">A more detailed view</A></h2>
<p> After startup of the <b>aliroot</b> program the simulation
infrastructure is initialised by the <a
name for this script is <a
href="roothtml/examples/Config.C.html">Config.C</a>. This script
initialises the version of the different detectors and of the generator to
-be used. In particular some generators can generated a fixed number of
+be used. In particular some generators can generate a fixed number of
particles and in this case this number is an argument of the generator
constructor.
functions are specific to Geant3, and these can be accessed recasting this
pointer to a specific Geant3 pointer via the statement
-<p> <KBD>root [ ] TGeant3 g3 = (TGeant3*) gMC</KBD>
+<p> <KBD>root [ ] TGeant3 *g3 = (TGeant3*) gMC</KBD>
<p> <a href="picts/itsex.gif">
<img src="picts/itsex.gif" alt="Example of Picture"
-height=30% align=right></a>
+height=150 align=right></a>
<p> In particular all the drawing functions of Geant3 are available via
-this interface. To draw a cut view of the ITS following commands
-could be used
+this interface. To draw a cut view of the ITS the following commands
+can be used
<p>
<KBD>
more events can be run. If this number is positive, after the indicated number
of events the run is terminated. No more events can be run.
-<h3>Batch processing</h3>
+<h2><A HREF="#Content" NAME="Batch processing">Batch processing</A></h2>
<p> In AliRoot there is really no difference between batch and interactive
processing. An <a href="roothtml/examples/grun.C.html">elementary macro</a>
to run AliRoot in batch mode is provided amongst the examples, and it can
be used in the following way to run a 10 events run
-<p> <KBD> aliroot -b grun.C\(10\)</KBD>
+<p> <KBD> aliroot -b -q grun.C\(10\)</KBD>
<p> Note that the backslashes are necessary to prevent the shell from
interpreting the brackets.
+<p> For very large output files we strongly discourage the use of afs
+space, as it has performance penalty and it is really intended to be used
+for user and program files and not data files. Users needing access to
+large data files should use the ALICE staging facility. The procedure is
+the following:
+
+<p><ol>
+
+<li> Define a <var>STAGE_HOST</var> variable which is in our case
+<var>shiftalice</var>
+
+<p><li> In your <var>Config.C</var> macro, or in any other place where
+you open a file, instead of opening the file as
+
+<p><kbd>
+ TFile *f = new TFile("filename","option");
+</kbd>
+
+<p>use
+
+<p><kbd>
+ TFile *f = TFile::Open("rfio:filename","option");
+</kbd>
+
+<p><li>Stage a file via the command
+<p><kbd>
+ stagealloc -p alice_stage filename
+</kbd>
+
+<p>This will create in your working directory a link <var>filename</var>
+that points to the <em>real</em> file in the stage pool.
+
+<p><li>Now you can run
+
+<p><li>When done with the file, do not <kbd>rm filename</kbd>. It will
+remove the link only, the file will still be in the pool, occupying our
+precious disk space. To delete a staged file instead do
+<p><kbd>
+ stageclr -P `stageqry -p alice_stage -A filename -P`
+</kbd>
+<p>and this will do a proper job.
+</ol>
+
+<p>More information on stage can be found in the <a
+href="http://wwwinfo.cern.ch/pdp/castor/doc/public/all_man_pages.html">man pages</a> of
+the different stage commands or in the CORE <a
+href="http://wwwinfo.cern.ch/pdp/sc/coreplus.html">User Guide</a>.
+
+<br clear>
<hr>
<address>
- <script language="JavaScript">
- document.write("Last modified "+ document.lastModified)
- // end of script -->
- </script>
-by <a href="mailto:Federico.Carminati@cern.ch">Federico Carminati</a>
-</address>
+ Last modified Thu Oct 07 11:33:05 1999
+by <A href="mailto:Federico.Carminati@cern.ch">Federico Carminati</A>
+</ADDRESS>
</BODY>
</HTML>
git://git.uio.no / u / mrichter / AliRoot.git / blobdiff