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

    • ICRP145_HumanPhantoms

    • radioprotection

    • STCyclotron

  • Francesco Romano(deputy)

    • eFLASH_radiotherapy

    • gammaknife

    • iort_therapy

    • radioprotection

  • Abdella Ahmed

    • doiPET
  • John Apostolakis

    • purging_magnet
  • Makoto Asai

    • gorad
  • Jeremy Brown

  • Barbara Caccia

    • medical linac
  • Pablo Caron

    • microelectronics
  • G. A. Pablo Cirrone

    • hadrontherapy

    • medical_linac

  • Miguel Antonio Cortes-Giraldo

  • Gabriele Cosmo

  • Paolo Dondero

  • Milos Dordevic

    • hadrontherapy
  • Andrea Dotti

    • lAr_Calorimeter
  • Paul Gueye

  • Haegin Han

    • ICRP145_HumanPhantoms
  • Alexander Howard

    • underground_physics
  • Sebastien Incerti

    • microbeam

    • nanobeam

  • Christophe Inguimbert

    • microelectronics
  • Omrane Kadri

  • Ara Knaian

    • fastAerosol
  • Damien Lambert

    • microelectronics
  • Zhuxin Li

  • Francesco Longo

    • eRosita

    • gammaray_telescope

  • Michel Maire

    • ams_Ecal
  • Carlo Mancini Terracciano

    • medical_linac
  • Alfonso Mantero

    • xray_fluorescence
  • Nate McFadden

    • fastAerosol
  • Claire Michelet

  • Giuliana Miluzzo

    • eFLASH_radiotherapy

    • gammaknife

    • iort_therapy

    • radioprotection

  • Bernardo Neto Gomes Baptista Tome

    • air_shower
  • Luciano Pandola

  • Giada Petringa

    • hadrontherapy
  • Ivan Petrovic

    • hadrontherapy
  • Floriane Poignant

    • STCyclotron
  • Andrea Polsini

    • eRosita

    • gammaray_telescope

  • Alexey Radkov

    • ChargeExchangeMC
  • Alberto Ribon

    • composite_calorimeter
  • Aleksandra Ristic Fira

    • hadrontherapy
  • Giorgio Russo

  • Mitra Safavi

    • doiPET
  • Giovanni Santin

    • xray_telescope
  • Ronny Stanzani

  • Bernardo Tome

    • air_shower
  • Hans-Joachim Wenzel

    • CaTS
  • 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
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
CaTS Hans-Joachim Wenzel Demonstration of the G4Opticks hybrid workflow for the creation and propagation of optical photons on GPU’s
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
eFLASH_radiotherapy Francesco Romano Modelling of a FLASH radiotherapy beamline
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
ICRP145_HumanPhantoms Susanna Guatelli Calculation of dose in ICRP145 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, 27th Geant4 Collaboration Meeting, 2022 link

Presentations of developments of the past 5 years:

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

  • 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 2023

  • Release of a new example showing how to import in Geant4 simulations IAEA Phase Space Files (1,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)
  • Development of a new example dedicated to the ATHENA mission (1,2)
  • Implementation of pre-clinical, mice PET images to evaluate a dose distribution for new drugs (1,2)
  • Upgrade of the medical_linac example (1,2)
  • Improve the Hadrontherapy example in the simulation of proton, carbon ion and helium ion beam irradiation (1,2)
  • Maintenance of the webpage (1,2)
  • Maintenance and code review (e.g. implementation of the extended examples coding guidelines and 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