MOLLER GEANT4 Simulations
I am going to suggest chapters and possibly sections (an outline) for the MOLLER GEANT4 documentation. People will need to provide the text for the different sections. People should also feel free to suggest a different outline or set-up.
Contents
Overview
GEANT4
MOLLER
Getting Started
Quick start:
- In a terminal window on ifarml6, type:
- mkdir ~/scratch
- mkdir ~/scratch/ROOTfiles
- setenv MOLLERGEANTDIR <directory where you would like to have the simulation/moller12gev>
- cd <directory where you would like to have the simulation>
- svn checkout https://jlabsvn.jlab.org/svnroot/moller12gev
- cd moller12gev
- make clean
- make
- cd analysis
- make clean
- make
- cd ../
- jsub eesim.jsub
- change analysis/inifiles/sample.ini to point to rootfile that is created in ~/scratch/ROOTfiles
- analysis/mollerClass analysis/inifiles/sample.ini
- eog plots/moller_myr.gif (for example)
Getting the simulation
In a terminal window, type:
- svn checkout https://jlabsvn.jlab.org/svnroot/moller12gev
Get the field maps:
- -OR- link to some central location, on the farm machines:
- The defaults are currently (both in cylindrical coordinates):
- ln -s /w/halla/parity/disk2/jmammei/tosca_stuff/MAPFILES/blockyHybrid_3.0.txt fieldmap_back.txt
- ln -s /w/halla/parity/disk2/jmammei/tosca_stuff/MAPFILES/blockyUpstream_1.1.txt fieldmap_front.txt
- ln -s /w/halla/parity/disk2/jmammei/tosca_stuff/MAPFILES/blockyHybrid_3.0.txt fieldmap_back.txt
Setting the environment variables
You'll have to make sure your environment variables are set correctly. If you are running the simulation on your
own machine, for now you'll have to set the environment variables yourself, but be sure to also change the version
of GEANT in the local_moller_settings.dat file.
- On ifarml1 or ifarml6, type:
- source env_jlabcue
Batch Mode
To run in batch mode:
- Create a scratch directory in your home directory with a link to a ROOTfiles directory
- Create your own .mac file or modify (or modify/use run_ee.mac, run_ep.mac or run_ine.mac)
- Type, for example: bin/Linux-g++/moller_sim run_ee.mac
Note: The default .mac files are intended to run on the farm using jsub, but to test you can change the number of
events to 10k instead of 100k, for example.
Interactive Mode
Right now the visualization works marginally well. It uses OpenGL and it is very simple - you can only change the
display with one of the macros that comes with svn. Ultimately we will want to be able to change the view using
the mouse in the window, and will even probably want to develop a GUI.
For now, to use the visualization on the farm machines, in the moller12gev directory:
- Type:
- bin/Linux-g++/moller_sim
- bin/Linux-g++/moller_sim
- To change the view, modify vis.mac and then, in the GEANT4 terminal, type:
- /control/execute vis.mac
- /control/execute vis.mac
- To exit the interactive mode, type:
- exit
Running on farm
If you want to run multiple simulations at the same time, or even one simulation with more than about 10k events,
you'll want to use the JLab Auger.
- If you haven't already, create a scratch directory in your home directory with a link to a ROOTfiles directory
- To submit a job to the farm:
- Create your own .mac file (or modify/use run_ee.mac, run_ep.mac or run_ine.mac)
- Create your own .csh file (or modify/use runsim_ee.csh, runsim_ep.csh or runsim_ine.csh)
- Create your own .jsub file (or modify/use eesim.jsub, epsim.jsub, inesim.jsub)
- Create your own .mac file (or modify/use run_ee.mac, run_ep.mac or run_ine.mac)
- Then type, for example:
- jsub eesim.jsub
- jsub eesim.jsub
- Note: If you want to receive email notification of the completion of your job(s) you have to change the line
- in the jsub file:
- MAIL: user@jlab.org -> your username at jlab or another email address
- Note: If you want to receive email notification of the completion of your job(s) you have to change the line
Look at output
From moller12gev directory:
- If you haven't compiled the analysis code yet:
- cd analysis
- make
- cd ../
- Then:
- Modify sample.ini file in the analysis/initfiles directory to have the name(s) of the rootfile(s)
- From terminal: ./analysis/mollerClass analysis/inifiles/sample.ini
- The output and plot files should be created in your output/ and plots/ folders
- Modify sample.ini file in the analysis/initfiles directory to have the name(s) of the rootfile(s)
- --> see more details in the README file
Geometry
Target
Beamline
Collimators
Spectrometer
Detectors
Generators
Moller
Mott (Elastic ep)
Inelastic ep
Other backgrounds
Physics Processes
Analysis
Benchmarks of the Simulation
Return to MOLLER at 11 GeV E09-005