Getting Started

Athena-Atlfast is a fast simulation of the ATLAS. detector that has been fully integrated with the Athena framework. It is designed in an Object Orientated manner and written in C++. A full description of the Athena-Atlfast design and structure is given here. The number of different ways that Athena-Atlfast can be obtained and run are descibed in this chapter. It should be noted that thus far Athena (and thus Athena-Atlfast) only supports egcs-1.1 and gcc-2.95.2.

1) The Standalone Version

There is a standalone version of Athena-Atlfast that can be run on any system, whether it has full atlas software or not. This version only runs on Linux (red hat). The tar file built from Atlfast-00-00-18 can be found at /afs/cern.ch/atlas/maxidisk/d90/2.0.1/Atlfast.tar.gz. This is should be unpacked as follows:

gzip -cd Atlfast.tar.gz | tar xvf -

Once this has been done follow the instructions given in the README.Root file. For a more detailed explaination on the jobOptions.txt and the StandardAtlfastOptions.txt see Chapter 2: Run Scripts

2) Running within Athena

Athena-Atlfast can be run by directly linking to the Athena libraries on the atlas computers, thus no libraries have to be copied over. However, this requires that the computer has full atlas software or an afs link to CERN. To run Athena-Atlfast, first the SRT setup needs to be run, then the files copied from CERN and finally the environment setup file has to be run. This can be achieved by following the commands given below:

. `/afs/cern.ch/atlas/software/bin/srt setup`
/afs/cern.ch/atlas/software/bin/srt new src 2.0.1
mkdir run
cd run
cp $SRT_DIST/2.0.1/installed/share/AthenaCommon/* .
cp $SRT_DIST/2.0.1/Simulation/Atlfast/AtlfastCode/share/* .
source setup.sh

This will make two directories, a src directory and a run directory. Once this is done just type athena whilst in the run directory to run the program. All these commands are available as a single script. The athena release 2.x.x contains libraries built from Atlfast-00-00-18

3) Checking Out Code From CVS

The Athena-Atlfast source code can be checked out from the atlas CVS repositry and compiled on its own. This requires access to the atlas CVS repositry. Before you checkout the code, firstly make a directory for the code, such as AtlfastWork/ Then from this directory type the following commands:

. `/afs/cern.ch/atlas/software/bin/srt setup`
/afs/cern.ch/atlas/software/bin/srt new src 2.0.1
cd src
cvs co -d Atlfast -r Atlfast-00-00-19 offline/Simulation/Atlfast

This will copy all the source code and Atlfast documentation into the newly created AtlfastWork/src/Atlfast directory. See Chapter 4: Atlfast Directory Structure for more information on how the code is ordered in these directories. The code can now be compiled. Move up a directory back into AtlfastWork, then use the following commands:

mkdir build
cd build
../src/configure
make clean
make install

All the code should now be built in the build directory. Any changes to the code the user wishes to make should only be made to the source code in the src directory. To recompile the code only make install needs to be typed in the build directory. Once the code is fully built, it is ready to run. For this a run directory will be needed. Move up a directory to the AtlfastWork directory again, and then do the following:

mkdir run
cd run
cp ../src/Atlfast/AtlfastCode/share/* .
cp $SRT_DIST/2.0.1/installed/share/AthenaCommon/Atlas_Gen.UnixStandardJob.txt .
cp $SRT_DIST/2.0.1/installed/share/AthenaCommon/setup.sh .
source setup.sh

Then to run Athena-Atlfast simply type athena

Prev	home	Next