module use /scigroup/cvmfs/geant4/modules
module load gemc/5.10Note: the above commands are not needed if load the clas12 module.
We distribute releases of Geant4 on CVMFS for the following platforms:
- Linux: Fedora 36, AlmaLinux 9, Ubuntu24
- MacOS: macOS 14.5 (Sonoma)
If you have access to a CVMFS client and your OS is supported, you can load Geant4 with the following commands:
module use /cvmfs/oasis.opensciencegrid.org/jlab/geant4/modules
module load gemc/5.10Note: the above commands are not needed if load the clas12 module.
module avail gemc: shows available gemc modules
module load geant4/11.2.2: loads standalone geant4 libraries 11.2.2
module switch gemc/dev: switch to gemc (clas12Tags) dev version
module show <module>/<version>: shows what is loaded by a module
To download and compile Geant4 and/or Gemc on your local machine, follow these instructions.
Below we''ll use /opt/software as the installation location, but it can be any directory of your choice.
Make sure you have write permissions on the directory you choose. You can always change permissions like this:
chown -R $USER /opt/software
Do this only once. If you have already cloned the repo, skip this step.
cd /opt/software
git clone https://github.com/jeffersonlab/ceInstall
module use /opt/software/ceInstall/modules
module load gemc/5.10
We suggest to add the commands above to your shell login file to have them available every time you log in.
Make sure the requirements for the libraries / environment installation listed at the bottom of this page are met.
After the steps above: module load sim_system will load the installation scripts location.
install_geant4 11.2.2will install geant4install_gemc 5.10will install gemc. This can be run standalone or after the geant4 installation.
Both installation scripts will check for existing installations and will not overwrite them.
moule avail geant4 or module avail gemc will show the versions available for installation.
The source code of the geant4 examples is in $G4INSTALL/source/examples/.
To compile one of the examples, create a build directory and run cmake using
the syntax below, where $G4INSTALL/source/examples/basic/B3 is selected
as an example, in a machine with 4 cores (-j4)
mkdir build ; cd build
cmake -DGeant4_DIR=$G4INSTALL/lib $G4INSTALL/source/examples/basic/B3
make -j4
Software based on compiled code (C++, fortran, etc) is organized in the SIM_OSRELEASE
directory. SIM_OSRELEASE, set by the modules, is a string is composed by the OS name and the compiler major version.
For example: macosx14-clang15, fedora34-gcc12.
Architecture-independent stuff (python, JAVA, etc) is organized in then noarch directory.
- /opt/software
⋮
∟ OSRELEASE (for example: macosx14-clang15)
⋮ ⊢ package 1
⋮ ⋮ ⊢ package1_version
⋮ ⋮ ⋮ ⊢ libraries and includes
⋮ ⊢ package 2
⋮ ⋮ ⊢ package2_version
⋮ ⋮ ⋮ ⊢ libraries and includes
⋮ ⊢ package 1
⋮ ⋮ ⊢ package1_version
⋮ ⋮ ⋮ ⊢ libraries and includes
⋮ ⊢ package 2
⋮ ⋮ ⊢ package2_version
⋮ ⋮ ⋮ ⊢ libraries and includes
∟ noarch
⋮
⋮ ⊢ noarch library 1
⋮ ⋮ ⊢ lib_version
environment modules> 4.5gcc/clang>= 8 (for c++17)cmake>= 3.16pyton>= 3.6qt5scons>= 4.2modules>= 4.5zshwgetgnu tarpkg-configmeson and ninja(for hipo installation)
The following qt packages must be installed:
- Qt5Core
- Qt5Gui
- Qt5Widgets
- Qt5OpenGL
- Qt5PrintSupport
root: for gemc3 root plugin
Find below the commands to install these requirements. Please email any corrections to [Maurizio](mailto:ungaro@jlab.org?subject=CeInstall Requirements Corrections).
brew install gnu-tar wget cmake mysql qt@5 scons freeglut modules sqlite meson ninja
Note: As of 8/2024: the mysql_native_password authentication plugin has been removed in mysql v9 and CCDB will not work w/o it. So, for now, we need to install mysql v8.4:
brew install mysql-client@8.4
export PATH="/opt/homebrew/opt/mysql-client@8.4/bin:$PATH"
export DYLD_LIBRARY_PATH="/opt/homebrew/opt/mysql-client@8.4/lib:$DYLD_LIBRARY_PATH"
brewDir=$(brew --prefix)
source $brewDir/opt/modules/init/zsh` or `. $brewDir/opt/modules/init/bash
set brewDir=`brew --prefix`
source $brewDir/opt/modules/init/tcsh
In order to avoid re-typing them every time, the lines could be added to the files .tcshrc or .cshrc
in your home directory, so they will be executed every time you open a new terminal.
You can create the file if it does not exist.
Linux Fedora line one-liner installation of requirements1:
yum install cmake3 make gcc-c++ gfortran expat-devel wget git environment-modules mysql-devel zlib-devel libX11-devel mesa-libGLU-devel libXmu-devel qt5-qttools-devel scons sqlite-devel
To enable modules, the following line should be added to your .bashrc or .zshrc:
. /usr/share/Modules/init/zsh or . /usr/share/Modules/init/bash
Linux Ubuntu one-liner installation of requirements2:
apt-get install cmake make g++ gfortran expat libexpat1-dev libpython3-dev scons libglu1-mesa-dev libx11-dev libxpm-dev libxft-dev libxt-dev libxmu-dev libxrender-dev bzip2 wget curl nano git bash tcsh zsh hostname gedit environment-modules psmisc procps mailcap net-tools libcpandb-perl xterm qtbase5-dev libqt5widgets5 libqt5opengl5-dev libqt5printsupport5
To enable modules, the following line should be added to your .bashrc or .zshrc:
. /usr/share/Modules/init/zsh or . /usr/share/Modules/init/bash
- mlibrary 1.7 is associated with geant4 10.6.2 and clhep 2.4.1.3
- mlibrary 1.8 is associated with geant4 10.7.4 and clhep 2.4.4.2
- gemc 5.9 is deprecated because of the above reason (cannot mix different mlibrary and geant4 versions)
For any questions, feedbacks or comments, please contact Maurizio Ungaro