GEANT4 2016

From HPC users
Revision as of 14:10, 24 February 2017 by JBrunken (talk | contribs) (→‎GRAS)
Jump to navigationJump to search

Introduction

Geant4 is a toolkit for the simulation of the passage of particles through matter. Its areas of application include high energy, nuclear and accelerator physics, as well as studies in medical and space science. For more information refer to the official web page of GEANT4.

Installed Versions

There are currently different Versions of Geant4 installed on the Cluster:

  • Geant4/9.6.p04 (Patch 04)
  • Geant4/10.2.p01 (Patch 01)

More informations about the version and the patches can be found here.

Using Geant4

If you want to find out more about Geant4 on the HPC cluster, you can use the command

module spider geant4

This will show you basic informations e.g. a short description and the currently installed version. To load the desired version of the module, use e.g. the command

modudule load Geant4/9.6

Always remember: this command is case sensitive!

A guide on how to build and run an example can be found on the official homepage of Geant4: Example

GRAS

The Geant4 Radiation Analysis for Space (GRAS) tool is a Geant4-based application that deals with common analyses types in 3D geometry models. More information and the download of the GRAS package are found on the GRAS web page (login required). In order to use GRAS on the cluster the following steps need to be done:

  1. download the GRAS-package version 3.3 (this version is working on the cluster, other versions may or may not work)
  2. unpack the tar-file in your home-directory on the cluster (or another location of your choice, the following steps assume you use $HOME)
  3. change into the directory gras-03-03
  4. load the modules Geant4/9.6 and CMake
  5. execute the following commands:
mkdir build
cd build
.
.
.


After that the GRAS package is installed and ready to use. The package comes with a few examples, to test if everything work you could:

 cd $HOME/gras-03-03
 #this adds GRAS to your environment
 . bin/gras-env.sh
 cd examples/magfield/example1/
 module load python
 #before you need to apply the patch below
 python launch_example.py
 python plot_results.py

After this you see a number of new files, namely txt-, log-, and png-files (and some more). You need to copy these files to your local machine to view them.

In order to have the example above working you need to change a path in launch_example.py:

 os.chdir("../../../bin/Linux-g++")

should be

 os.chdir("../../../bin")


Note:

If you are using GRAS in any way for your work, please reference the official GRAS paper with the following lines:

GRAS Paper
Official GRAS publication in IEEE Transactions on Nuclear Science:
G. Santin, V. Ivanchenko, H. Evans, P. Nieminen, E. Daly, "GRAS: A general-purpose 3-D modular simulation tool for space environment effects analysis", IEEE Trans. Nucl. Sci. 52, Issue 6, 2005, pp 2294 - 2299

Documentation

The documentation for Geant4 can be found on the official homepage of Geant4: User Documentation