Advanced Examples


The Advanced Examples illustrate realistic applications of Geant4 in typical experimental environments. They are developed in collaboration with user groups expert in the corresponding experimental domain. The code of the developed examples can be dowloaded together with the Geant4 toolkit in the directory examples/advanced.

Mailing list:


Show responsibility

  • Susanna Guatelli(coordinator)

    • brachytherapy

    • doiPET

    • human_phantom

    • ICRP110_HumanPhantoms

    • radioprotection

    • STCyclotron

  • Francesco Romano(deputy)

    • gammaknife

    • iort_therapy

    • radioprotection

  • Abdella Ahmed

  • John Apostolakis

    • purging_magnet
  • Makoto Asai

    • gorad
  • Jeremy Brown

  • Barbara Caccia

  • Pablo Caron

  • G. A. Pablo Cirrone

    • hadrontherapy

    • medical_linac

  • Miguel Antonio Cortes-Giraldo

  • Gabriele Cosmo

  • Giacomo Cuttone

  • Milos Dordevic

  • Andrea Dotti

    • lAr_Calorimeter
  • Paul Gueye

  • Alexander Howard

    • underground_physics
  • Sebastien Incerti

    • microbeam

    • nanobeam

  • Christophe Inguimbert

  • Omrane Kadri

  • Ara Knaian

  • Damien Lambert

  • Zhuxin Li

  • Francesco Longo

    • eRosita

    • gammaray_telescope

  • Michel Maire

    • ams_Ecal
  • Alfonso Mantero

    • xray_fluerescence
  • Nate McFadden

  • Claire Michelet

  • Bernardo Neto Gomes Baptista Tome

    • air_shower
  • Luciano Pandola

  • Giada Petringa

  • Ivan Petrovic

  • Maria Grazia Pia

  • Floriane Poignant

  • Alexey Radkov

  • Mélanie Raine-Theillet

    • microelectronics
  • Alberto Ribon

    • composite_calorimeter
  • Aleksandra Ristic Fira

  • Giorgio Russo

  • Mitra Safavi

  • Giovanni Santin

    • xray_telescope
  • Bernardo Tome

  • Hans-Joachim Wenzel

  • Anna Zaborowska

    • HGCal_testbeam

Responsible categories


Advanced examples

A short introduction to each advanced example is provided following the appropriate link in the table below. All examples have a README file in the Geant4 distribution where more technical information is provided (e.g. how to compile and run the simulation). For questions, it is suggested to contact directly the responsible Geant4 Collaborator (indicated in the table below as well) and, eventually, the Coordinator/Deputy Coordinator of the Working Group.

Example name Responsible Geant4 Collaborator Short description
air_shower Bernardo Tomè Modelling of the ULTRA experiment, EUSO mission
CaTS Hans-Joachim Wenzel Demonstration of the G4Opticks hybrid workflow for the creation and propagation of optical photons on GPU’s
ams_Ecal Michel Maire Modelling of the electromagnetic Calorimeter (ECAL) of the AMS-02 experiment
brachytherapy Susanna Guatelli Calculation of dose in a phantom, in the context of brachytherapy
ChargeExchangeMC Alexey Radkov Simulation of hadronic physics experiments of the Petersburg Nuclear Physics Institute (PNPI, Russia)
composite_calorimeter Alberto Ribon Example of a test-beam simulation used by the CMS Collaboration, CERN, Geneva, Switzerland
doiPET Susanna Guatelli Modelling of a PET scintillator system
eRosita Francesco Longo Modelling of eROSITA astronomical X-ray full-sky survey mission on-board the Spectrum-X-Gamma space mission
fastAerosol Makoto Asai Development of a custom geometry class for accurately and efficiently simulating aerosols with many droplets
gammaknife Francesco Romano Simulation of an advanced device for Stereotactic Radiosurgery
gammaray_telescope Francesco Longo Model of a typical telescope for gamma ray analysis in the context of space exploration
gorad Makoto Asai Turn-key application for radiation analysis and spacecraft design built on top of Geant4
hadrontherapy Pablo Cirrone Model of hadrontherapy beamlines
HGCal_testbeam Anna Zaborowska Demonstration of a high-end High Energy Physics test beam setup, for the endcap electromagnetic calorimeter of the CMS detector CERN-LHCC-2017-023
human_phantom Susanna Guatelli Calculation of dose in analytical anthropomorphic phantoms
ICRP110_HumanPhantoms Susanna Guatelli Calculation of dose in ICRP110 anthorpomorphic phantoms
iort_therapy Francesco Romano Model of a typical Intraoperative Radiation Therapy beamline
lAr_calorimeter Andrea Dotti Simulation of the Forward Liquid Argon Calorimeter (FCAL) of the ATLAS Detector, CERN, Switzerland
medical_linac Pablo Cirrone Model of a typical medical linear accelerator for Intensity Modulated Radiation Therapy (IMRT)
microbeam Sebastien Incerti Simulation of the microbeam cellular irradiation beam line installed on the AIFIRA electrostatic accelerator facility located at LP2i Bordeaux, France
microelectronics Christophe Inguimbert, Damien Lambert, Mélanie Raine-Theillet Demonstration on how to activate track structure physics models for electrons in a silicon microelectronics device
nanobeam Sebastien Incerti Simulation of the beam optics of the “nanobeam line” installed on the AIFIRA electrostatic accelerator facility located at LP2i Bordeaux, France
purging_magnet John Apostolakis Modelling of electrons traveling through a 3D magnetic field in the radiotherapy context
radioprotection Susanna Guatelli and Francesco Romano Modelling of detectors and their response for microdosimetry for radiation protection in space
STCyclotron Susanna Guatelli Model of the solid target of the South Australian Health and Medical Research Institute (SAHMRI), Adelaide, South Australia
underground_physics Alex Howard Example of an underground dark matter experiment. More details are provided in the README file accompanying the example
xray_fluorescence Alfonso Mantero Example reproducing various setups for PIXE and XRF experiments. More details are provided in the README file accompanying the example
xray_telescope Giovanni Santin Simulation of a typical X-ray telescope for space exploration

Current Developments

  • S. Guatelli & F. Romano, Update on Advanced Examples: summary, 26th Geant4 Collaboration Meeting, 2021 link

Presentations of developments of the past 5 years:

  • S. Guatelli & F. Romano, Status and recent developments in the Geant4 Advanced Examples: summary, 25th Geant4 Collaboration Meeting, 2020 link
  • S. Guatelli & F. Romano, Geant4 Advanced Examples: progress, 24th Geant4 Collaboration Meeting, 2019 link
  • I. Hrivnacova & S. Guatelli, Parallel Session 6B: Basic, Extended & Advanced Examples, 23rd Geant4 Collaboration Meeting, 2018 link
  • F. Romano, Advanced examples: updates and plan, 23rd Geant4 Collaboration Meeting, 2017 link

Working plans

Working Plan 2022

  • Release of a new example showing how to import in Geant4 simulations IAEA Phase Space Files (2)[*]
  • Development of a specific advanced example for proton tomography (1,2)
  • Development of a SPring-8 synchrotron x-ray polarimetry example for testing low energy polarised gamma-ray physics (1,2)
  • Further developments of in-silico experimental microdosimetry in the Radioprotection example (1,2)
  • Development of a mammography example (1,2)
  • Measurements and statistical analysis of size, McCabe, Halstead, Chidamber and Kemerer software metrics over at least 50% of the advanced examples; explication of the results in relation to ISO/IEC 9126 and ISO/IEC 25000 (1,2)
  • Migration and improvement of the webpage (1,2)
  • Maintenance and code review (e.g. implementation of the extended examples coding guidelines amd migration to C++17) in selected examples (1,2)


  • [*] Optional, and subject to the availability of manpower
  • 1: aimed to be done in first semester
  • 2: aimed to be done in second semester

Previous working plans