The easiest to get started is to use your RACF account. For setup instructions on other platforms, you will need to run the following commands inside the singularity container as outlined below.

Download and compile the comptonRad generator sources:

mkdir -p ~/fun4all/compton
cd ~/fun4all/compton
git clone https://gitlab.com/eic/mceg/comptonRad
cd comptonRad
make

You can then run events by running ./main.exe. Modify the configuration by looking at the top of comrad.f and recompiling.

Download the fun4all_Compton macros and IO classes:

mkdir -p ~/fun4all/compton
cd ~/fun4all/compton
git clone https://github.com/cipriangal/fun4all_Compton
cd fun4all_Compton/source
mkdir build
cd build
../autogen.sh --prefix=$MYINSTALL
make install

After installing fun4all_Compton, you will need to reload your environment (script see below):

source setup.sh

or you can add the ~/fun4all/lib directory to your LD_LIBRARY_PATH by hand:

export LD_LIBRARY_PATH=$MYINSTALL/lib:$LD_LIBRARY_PATH

root.exe
.x Fun4All_G4_BeamLine.C
.L DisplayOn.C
PHG4Reco *g4 = QTGui();  

root.exe
.x Fun4All_G4_BeamLine.C
.L DisplayOn.C
PHG4Reco *g4 = DisplayOn(); // to still have the command line
Fun4AllServer *se = Fun4AllServer::instance();
se->run(1); // to shoot the geantinos

root
.x Fun4All_G4_IP12Compton.C
.L DisplayOn.C
PHG4Reco *g4 = QTGui()

To run test electrons on the G4 terminal, use:

/Fun4All/run 1

The ComRad package produces Compton events based on initial settings hard coded into the comrad.f file.

• EB is the electron beam energy
• EPHOT is the photon energy
• SPIN array allows you to set the spin direction.

Some examples are given in the comments around where these variables are initialized. Modfiy the file and then recompile. The main.exe file that is created will output the events directly to the screen. Pipe it to a file of your choice. The convert2MILOU macro takes that file, parses it and creates a faux-MILOU generator text file that can be read in easily by standard EIC frameworks.

To convert the milou text file to a root file that can be read in by fun4all (with the eic cvmfs ENV set up):

root -l
gSystem->Load("libeicsmear")
erhic::DisKinematics::BoundaryWarning=false;
BuildTree("fauxMILOUfile.ml", ".", -1);

root
.x Fun4All_G4_IP12Compton.C(100,"./milouIn.root","o_ComptonTst.root",false,18")

If you have a Linux system, you can install CVMFS and install Singularity. This will allow you to start a shell inside the singularity container at /cvmfs/eic.opensciencegrid.org/singularity/rhic_sl7_ext with

singularity shell -B /cvmfs:/cvmfs /cvmfs/eic.opensciencegrid.org/singularity/rhic_sl7_ext

You should get a shell that looks like this:

Singularity>

You environment will be inherited from the host system. You may need to unset ROOTSYS for the following to work.

You can create a 'singularity_shell.sh` script to run when you want to start the singularity container.

~/fun4all/singularity_shell.sh contains

#!/bin/bash
singularity shell -e -B /cvmfs:/cvmfs /cvmfs/eic.opensciencegrid.org/singularity/rhic_sl7_ext

Start the container with by running:

bash ~/fun4all/singularity_shell.sh

You can create a setup.sh script to source when you enter the singularity container.

~/fun4all/setup.sh contains

#!/bin/bash
source /cvmfs/eic.opensciencegrid.org/x8664_sl7/opt/fun4all/core/bin/eic_setup.sh
export MYINSTALL=~/fun4all
source ${OPT_FUN4ALL}/bin/setup_local.sh $MYINSTALL

After starting the container, source this script:

source ~/fun4all/setup.sh

Go to VirtualBox.md to download the "EIC Ubuntu 18.04LTS Image" virtual box image. Follow instructions there to enter the singularity shell.