Monte Carlo and Reconstruction Software
1. Introduction
In order to be able to install and run the ATHENA Monte Carlo and Reconstruction programs on your machine you must have installed first
(see the root home page in http://root.cern.ch).
The Monte Carlo macros (MCinter.C and MCbatch.C) can be called within root and allow the simulation of the entire detector (they use the class defined to this purpose in the Athena.so class library and the interface between root and Geant in TGeant3 directory).
It is possible to generate different types of events (for example using the graphical menus, for the interactive version). In the current version one can choose to generate four different event types:
- Antihydrogen event (proton-antiproton and electron-positron annihilation)
- electron-positron annihilation
- proton-antiproton annihilation
- cosmic
The loast version of the sources of both library (Athena.so and libTGeant3.so) can be exported from the cvs repository (if you are allowed to). Alternatively you can go to the download section and click over the files you need.
2. Installation
At first one has to check if the interface library between Geant3 and Root (libTGeant3.so) has already been installed on the PC, in a directory such as /usr/local/TGeant3.
If not, one has to copy the file TGeant3.tar.gz , containing all the files needed to create the library TGeant3.so, toghether with the Makefile command file.
N.B. Root must already have been installed and the environment variable ROOTSYS, toghether with the library path to the ROOT libraries must have been defined in the account from which the TGeant3 library compilation is performed.
The library can be put in a common directory (such as /usr/local/Tgeant3/) or in a personal directory; in any case the TGeant3 library directory must be included in the library path of your login shell script.
The Athena.tar archive allows to create the Athena.so library, containing all the classes and the macros to run Athena events generation and reconstruction in batch or interactive mode. The library is created, by default, in the subdirectory TBin/Athena.so of the current directory, and its directory must be defined in the rootlogon.C file.
N.B. The environment variable ROOTSYS, toghether with the library path to the ROOT and TGeant3 libraries must have been defined in the account in which the Athena programs are to be installed. The link to the TGeant3 directory must also be specified in the Athena library Makefile, if different from /usr/local/TGeant3.
4. Running
As an example, to run the athena montecarlo one can enter the root environment and run the C macro MCinter.C. Then one can choose the type of event to be generated and require the tridimensional view of the athena detector. The results of a very preliminary version of track and vertex reconstruction can also be shown.
It is obviously possible to add a macro for a specified job, using the classes and the methods contained in the Athena library.
7. Download
Download the following file:
TGeant3.tar.gz
to create the library providing the interface between Geant3 and Root.
Download the archive containing the Athena library and the macros to run the montecarlo :
| Version | Athena lib |
| PRO | Athena.tar.gz * |
| NEW | Athenanew.tar.gz |
* Version pro has been tested for Linux RedHat 6.0 and 6.1. The program requires the 3.00 version of root and the old version (egcs 1.1.2) of the GNU compiler.
Last modified: Fri Mar 23 16:31:12 CET 2001