Geant4 Tutorial

3 Sept 2018, 09:00 → 7 Sept 2018, 21:00 Europe/Stockholm

Lyra (Department of Astronomy and Theoretical Physics)

Dennis Wright, Luis Sarmiento Pico (Lunds universitet), Makoto Asai, Mihaly Novak

GEANT4 (http://geant4.web.cern.ch/) is a toolkit for simulating the passage of particles through matter. It is the reference simulation engine in many areas. GEANT4 covers all relevant physics processes, electromagnetic, hadronic, decay, optical, for long and short lived particles, for energy range spanning from tens of eV to TeV scale. The transport of low energy neutrons down to thermal energies is also be handled. The software can also simulate remnants of hadronic interactions, including atomic de-excitation and provides extension to low energies down to the DNA scale for biological modelling. The software is based on a sound object-oriented design which favours a variety of application development by the community, like for example the propagation of acoustic phonons in cryogenic crystals, the Geant4 Application for Tomographic Emission (GATE), the beam line simulation (G4BEAMLINE) and others

Register for the course following the link below but please also fill out the COMPUTE course registration form, which can be downloaded from the following website http://cbbp.thep.lu.se/compute/index.php.

COMPUTE registration form http://cbbp.thep.lu.se/compute/COMPUTE_application.pdf

Information Simuleringskurs-informationsblad.pdf

Project Pico-NAFY002-project.pdf

Syllabus NAFY002-Eng.pdf

Monday 3 September

Tutorial

1 Welcome

2 Tutorial introduction

- Network, logistics - Tutorial structure - Lecturer introduction

Speaker: Luis Sarmiento Pico (Lunds universitet)

3 Introduction to detector simulation

- Basic concepts of Monte Carlo and detector simulation

Speaker: Dennis Wright

Slides MCLUND.pdf

4 Kernel I

- General introduction of Geant4 - Use-case studies in HENP, space, medicine and other user domains - Global structure of Geant4 - Run, event, track, step, trajectory, etc. - User classes

Speaker: Makoto Asai

Slides Kernel1.pdf

10:30 break

Tutorial

5 User documents and examples

- Installation Guide - Application developer’s manual - Toolkit developer’s manual - Physics reference manual - Novice examples in Geant4 distribution - Extended and advanced examples in Geant4 distribution - LXR source code browser - HyperNews

Speaker: Dennis Wright

Slides ExampleDocsLUND.pdf

6 User interface I

- Syntax of UI command - Interactive mode / batch mode - G4UIExective class

Speaker: Makoto Asai

Slides UserInterface1.pdf

7 Visualization I

- Introduction to Visualization - Quick Looks at Seven Visualization Drivers - Basic Visualization Commands

Speaker: Mihaly Novak

Slides Visualization1-v2.pdf

12:20 lunch break

Tutorial

8 Scoring I

- Introduction to sensitivity - Command-based scoring - Add a new scorer/filter

Speaker: Makoto Asai

Slides Scoring1.pdf

9 Physics I

- Introduction - G4VUserPhysicsList class - Modular physics list - Packaged physics lists - Choosing appropriate Physics List

Speaker: Mihaly Novak

Slides PhysLists.pdf

15:00 break

Hands-on

10 Hands-on I

- Complete Geant4 installation and execute a few examples to confirm the installation --> Hands-on instruction --> Hands-on instruction - Additional links --> Installation guide --> Troubleshooting: Installation and Configuration thread of Hypernews

# this bit of code should be included in your ~/.bashrc.

# If not running interactively, don't do anything
[[ $- != *i* ]] && return

#########################################################################
#########################################################################
##                                                                     ##
##                    LCG and LCG-inspired configuration               ##
##                                                                     ##
##                        (http://lcginfo.cern.ch/)                    ##
##                                                                     ##
#########################################################################
#########################################################################

export LCG_REPO=/cvmfs/sft.cern.ch/lcg/views

### for latest Geant4 this is the one you need
export LCG_RELEASE=94rc1
export LCG_PLATFORM=x86_64-slc6-gcc62-opt

## for production this is the current tested one
#export LCG_RELEASE=93
#export LCG_PLATFORM=x86_64-slc6-gcc62-opt

##
source                $LCG_REPO/LCG_$LCG_RELEASE/$LCG_PLATFORM/setup.sh
export QT_QPA_FONTDIR=$LCG_REPO/LCG_$LCG_RELEASE/$LCG_PLATFORM/fonts

cat <<EOF

#########################################################################
#########################################################################

Current Software setup  is

        LCG version : $LCG_RELEASE
        platform    : $LCG_PLATFORM

        G4examples  : $LCG_REPO/LCG_$LCG_RELEASE/$LCG_PLATFORM/share/Geant4-*/examples

#########################################################################
#########################################################################
EOF

return

Tuesday 4 September

Tutorial

11 Material definition

- Defining Materials - NIST Material database

Speaker: Dennis Wright

Slides MaterialsLUND.pdf

12 Geometry I

- Introduction - G4VUserDetectorConstruction class - Solid - Logical volume - Region - Physical volume - Placement

Speaker: Makoto Asai

Slides Geometry1.pdf

10:30 Break

Tutorial

13 Primary particle

- G4VUserPrimaryGeneratorAction class - Primary vertex and primary particle - Built-in primary particle generators - More on Particle Gun

Speaker: Makoto Asai

Slides PrimaryParticle.pdf

14 Physics II

- Physics components - General process interface - Secondary production threshold

Speaker: Mihaly Novak

Slides Process.pdf

12:20 lunch break

Tutorial

15 Physics III

- Decay - Optical - Phonon, electron/hole - Channeling

Speaker: Mihaly Novak

Slides Physics3_DecayAndOptical.pdf

16 Geometry II

- Parametrized volume - Replicated volume - Divided volume - Nested-parameterization - Assembly volume - Reflected volume - Touchable

Speaker: Makoto Asai

Slides Geometry2.pdf

15:00 Break

Hands-on

17 Hands-on II

- Material and a simple geometry - Visualization of geometry - Command-based scoring --> Hands-on instruction --> Hands-on instruction

when working on the HandsOn2 you will see that the notes for the tutorial are hosted at SLAC with rather "generic" instructions. I have translated them into 'iridium-able' commands ;-)

======================================================================================
BLOCK 1  getting the exercise code
======================================================================================

$ mkdir ~/HandsOn2          # make new working directory
$ cd ~/HandsOn2             # change to your new working directory
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn2/HandsOn2.tar.gz
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn2/HandsOn2-solution.tar.gz
$ tar xzf HandsOn2.tar.gz   # extract source code
# optionally extract in a similar way the solution. But please give the exercise a try first ;-)
$ cd HandsOn2               # change to newly extracted code
$ ls                        # have a look at the files
$ cd ..                     # let's go back to '~/HandsOn2' working directory

===================================================================================

and

===================================================================================
BLOCK 2  OPTION: SEPARATE build and source directory
===================================================================================

$ mkdir build-HandsOn2
$ cd build-HandsOn2
$ cmake ../HandsOn2
$ make
$ ./SLACtut

===================================================================================
RINSE AND REPEAT
===================================================================================
# ... modify files located under '~/HandsOn2/HandsOn2'
# compile the code at ~/HandsOn2/build-HandsOn2
$ make
# when you issued 'cmake ../HandsOn2' those two folders got linked. It would just work
===================================================================================

OR

===================================================================================
BLOCK 2  OPTION: SAME build and source directory
===================================================================================

$ cd HandsOn2
$ cmake .
$ make -f Makefile
$ ./SLACtut

===================================================================================
RINSE AND REPEAT
===================================================================================
# ... modify files located under '~/HandsOn2/HandsOn2'
# compile the code directly at ~/HandsOn2/HandsOn2
$ make -f Makefile
===================================================================================

Happy coding ;-)

 

Wednesday 5 September

Tutorial

18 EM physics I

- EM standard overview

Speaker: Mihaly Novak

Slides EMPhysics1.pdf

19 Scoring II

- Define scorers in the tracking geometry - Reduction of user data - Sensitive detector - Hits

Speaker: Makoto Asai

Slides Scoring2.pdf

10:30 break

Tutorial

20 EM physics II

- Low-E EM overview - DNA physics

Speaker: Mihaly Novak

Slides EM-LowE-v3.pdf

21 Geometry III

- Magnetic field - Field integration and other types of field - GDML interface - CAD interface - Geometry checking tools - Geometry optimization

Speaker: Makoto Asai

Slides Geometry3.pdf

12:20 lunch break

Tutorial

22 EM physics III

-specific topics of standard EM physics modelling: - energy-loss processes - multiple scattering - their role in Geant4 stepping

Speaker: Mihaly Novak

Slides Geant4Stepping.pdf

23 User interface II

- Define user commands

Speaker: Makoto Asai

Slides UserInterface2.pdf

15:00 break

Hands-on

24 Hands-on III

- Complete geometry - Define scorers - User Actions I: printing information on the screen --> Hands-on instruction --> Hands-on instruction

when working on the HandsOn3 you will see that the notes for the tutorial are hosted at SLAC with rather "generic" instructions. I have translated them into 'iridium-able' commands ;-)

===================================================================================
BLOCK 1  OPTION: SEPARATE build and source directory - getting the exercise code and compile
===================================================================================

$ mkdir ~/HandsOn3          # make new working directory
$ cd    ~/HandsOn3          # change to your new working directory
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn3/HandsOn3.tar.gz
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn3/HandsOn3-solution.tar.gz
$ tar xzf HandsOn3.tar.gz   # extract source code
# optionally extract in a similar way the solution. But please give the exercise a try first ;-)
$ mkdir build-HandsOn3
$ cd build-HandsOn3
$ cmake ../HandsOn3
$ make
$ ./SLACtut

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressing 'C-c' (Control key + c key)

===================================================================================
RINSE AND REPEAT
===================================================================================

# ... modify files located under '~/HandsOn3/HandsOn3'
# compile the code at ~/HandsOn3/build-HandsOn3
$ make
# when you issued 'cmake ../HandsOn3' those two folders got linked. It would just work

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressing 'C-c' (Control key + c key)

===================================================================================

OR

===================================================================================
BLOCK 1  OPTION: SAME build and source directory - getting the exercise code and compile
===================================================================================

$ mkdir ~/HandsOn3          # make new working directory
$ cd    ~/HandsOn3          # change to your new working directory
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn3/HandsOn3.tar.gz
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn3/HandsOn3-solution.tar.gz
$ tar xzf HandsOn3.tar.gz   # extract source code
# optionally extract in a similar way the solution. But please give the exercise a try first ;-)
$ cd HandsOn3
$ cmake .
$ make -f Makefile
$ ./SLACtut

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressung 'C-c' (Control key + c key)

===================================================================================
RINSE AND REPEAT
===================================================================================

# ... modify files located under '~/HandsOn3/HandsOn3'
# compile the code directly at ~/HandsOn3/HandsOn3
$ make -f Makefile

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressung 'C-c' (Control key + c key)

==================================================================================

Thursday 6 September

Tutorial

25 Hadronic physics I

- Hadronic physics overview - Pre-compound/de-excitation models - Cascade models

Speaker: Dennis Wright

Slides HadPhys1LUND.pdf

26 Scoring II

- Define scorers in the tracking geometry - Reduction of user data - Sensitive detector - Hits

Speaker: Makoto Asai

Slides Scoring2.pdf

10:30 break

Tutorial

27 Hadronic physics II

- Elastic process - Neutron physics - Ion physics - Capture, stopping and fission models

Speaker: Dennis Wright

Slides HadPhys2LUND.pdf

28 Multithreading I

- Introduction to multithreading - UI commands for multithreading

Speaker: Makoto Asai

Slides Multithreading1.pdf

29 Analysis

- G4Tools : built-in analysis tool

Speaker: Mihaly Novak

Slides Analysis-v3.pdf

12:20 lunch break

Tutorial

30 Hadronic physics III

- String models - Gamma- and Electro-nuclear models - Radioactive decay

Speaker: Dennis Wright

Slides HadPhys3LUND.pdf

31 Visualization II

- Visualization commands

Speaker: Mihaly Novak

Slides Visualization2.pdf

32 Geometry IV

- Parallel geometry - Layered mass geometry - Moving objects

Speaker: Makoto Asai

Slides Geometry4.pdf

15:00 break

Hands-on

33 Hands-on IV

- User Actions II: Accumulating information from a run - Use g4tools to create histograms and output ntuple files --> Hands-on instruction --> Hands-on instruction

when working on the HandsOn4 you will see that the notes for the tutorial are hosted at SLAC with rather "generic" instructions. I have translated them into 'iridium-able' commands ;-)

===================================================================================
BLOCK 1  OPTION: SEPARATE build and source directory - getting the exercise code and compile
===================================================================================

$ mkdir ~/HandsOn4          # make new working directory
$ cd    ~/HandsOn4          # change to your new working directory
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn4/HandsOn4.tar.gz
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn4/HandsOn4-solution.tar.gz
$ tar xzf HandsOn4.tar.gz   # extract source code
# optionally extract in a similar way the solution. But please give the exercise a try first ;-)
$ mkdir build-HandsOn4
$ cd build-HandsOn4
$ cmake ../HandsOn4
$ make
$ ./SLACtut

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressing 'C-c' (Control key + c key)

===================================================================================
RINSE AND REPEAT
===================================================================================

# ... modify files located under '~/HandsOn4/HandsOn4'
# compile the code at ~/HandsOn4/build-HandsOn4
$ make
# when you issued 'cmake ../HandsOn4' those two folders got linked. It would just work

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressing 'C-c' (Control key + c key)

===================================================================================

OR

===================================================================================
BLOCK 1  OPTION: SAME build and source directory - getting the exercise code and compile
===================================================================================

$ mkdir ~/HandsOn4          # make new working directory
$ cd    ~/HandsOn4          # change to your new working directory
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn4/HandsOn4.tar.gz
$ wget http://geant4.slac.stanford.edu/SLACG4TutorialHandsOn/HandsOn4/HandsOn4-solution.tar.gz
$ tar xzf HandsOn4.tar.gz   # extract source code
# optionally extract in a similar way the solution. But please give the exercise a try first ;-)
$ cd HandsOn4
$ cmake .
$ make -f Makefile
$ ./SLACtut

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressung 'C-c' (Control key + c key)

===================================================================================
RINSE AND REPEAT
===================================================================================

# ... modify files located under '~/HandsOn4/HandsOn4'
# compile the code directly at ~/HandsOn4/HandsOn4
$ make -f Makefile

# If at the time of quitting the execution you do not return to the prompt, you can try
# to 'kill' the process by pressung 'C-c' (Control key + c key)

==================================================================================

Friday 7 September

Tutorial

34 Event biasing

- Overview - Geometrical biasing - Physics biasing - Bremsstrahlung splitting

Speaker: Dennis Wright

Slides BiasingLUND.pdf

35 Multithreading II

- Thread safety - MPI - File I/O in multithreaded mode

Speaker: Makoto Asai

Slides Multithreading2.pdf

10:30 break

Tutorial

36 Physics list

- Choice of physics list - Validation of physics lists

Speaker: Mihaly Novak

Slides ChoosingPhysLists.pdf

37 Kernel II

- User limits - User information classes - Fast simulation (a.k.a. shower parameterization) - Stack management

Speaker: Makoto Asai

Slides Kernel2.pdf

12:20 lunch break

Tutorial

38 Q/A

39 How to Update Your Geant4 Installation

- Major versus minor releases - What to look for in the release notes

Speaker: Dennis Wright

Slides UpgradingLUND.pdf

40 Closing remarks

Speaker: Makoto Asai

Slides ConcludingRemarks.pdf

Adjourn

Submission: Project submission

This is the place to upload the reports

41 Caterina Marcon

Slides MARCON_CATERINA_Geant4_assignment.pdf

42 Eleni Skorda

Slides g4HWSkorda.pdf

43 Emil Rofors

Slides Emil_Rofors_GEANT4_handin.pdf

44 Eva Hansen

Slides report.pdf

45 Jonatan Adolfsson

Slides report.pdf

46 Katja Mankinen

Slides finalProject_KatjaMankinen.pdf

47 Nicholai Mauritzson

Slides G4_report.pdf

48 Ander Gray