GEANT4 2016

From HPC users
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.p04

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 and the installscript (Download)
  2. unzip both files into the same directory, e.g. "gras-installation" in your home directory
  3. run the installation script with ./install-gras-03-03.sh

After that the GRAS package is installed in your home directory (folder name is: gras-03-03) and ready to use.

The package comes with a few examples, to test if everything work you could do the following steps:

 cd $HOME/gras-03-03
 #this adds GRAS to your environment
 . bin/gras-env.sh
 cd examples/magfield/example1/
 module load Python
 #Apply the patch described 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