ATLHECTB

A Geant4 simulation of the ATLAS hadronic end-cap calorimeter beam tests.

<figure> <img src="./images/ATLHECTB_movie.gif" alt="Trulli" style="width:100%"> <figcaption align="center"><b>Fig. - 10 GeV muon passing through the ATLAS HEC.</b></figcaption> </figure>

<br/><br/>

<video align="center" src="https://user-images.githubusercontent.com/34685792/136785193-1741c29f-3666-4859-bd6c-34166515a7f7.mp4" alt="Trulli" controls="controls" style="width:100%"> </video> <figcaption align="center"><b>Vid. - Video example of how to use ATLHECTB in Geant Val.</b></figcaption>

<br/><br/>

<!-- TABLE OF CONTENTS --> <details open="open"> <summary>Table of Contents</summary> <ol> <li><a href="#project-description">Project description</a></li> <li><a href="#authors-and-contacts">Authors and contacts</a></li> <li> <a href="#documentation-and-results">Documentation and results</a> <ul> <li><a href="#selected-articles">Selected articles</a></li> <li><a href="#selected-presentations">Selected presentations</a></li> </ul> </li> </li><li><a href="#directory-structure">Directory structure</a></li> <li> <a href="#geant-val-integration">Geant Val integration</a> <ul> <li><a href="#list-of-results-on-geant-val">List of results on Geant Val</a></li> </ul> </li> <li><a href="#available-datasets-and-analyses">Available datasets and analyses</a></li> <li> <a href="#how-to">How to</a> <ul> <li><a href="#build-compile-and-execute-on-maclinux">Build, compile and execute on Mac/Linux</a></li> <li><a href="#build-compile-and-execute-on-lxplus">Build, compile and execute on lxplus</a></li> <li><a href="#submit-a-job-with-htcondor-on-lxplus">Submit a job with HTCondor on lxplus</a></li> <li><a href="#get-atlas-hec-geo-parameters-from-mysql-database">Get ATLAS HEC geo parameters from mysql database</a></li> <li><a href="#dump-atlhectb-gdml-geometry-description-file">Dump ATLHECTB GDML geometry description file</a></li> <li><a href="#use-flukacern-hadron-inelastic-process">Use Fluka.Cern hadron inelastic process</a></li> </ul> </li> </li><li><a href="#geant4-and-github-actions">Geant4 and Github Actions</a></li> </li><li><a href="#bugs-report">Bugs report</a></li> </li><li><a href="#my-quick-geant4-installation">My quick Geant4 installation</a></li> <li><a href="#selected-atlas-hec-references">Selected ATLAS HEC references</a> </ol> </details> <!--Project desription-->

Project description

The project targets a standalone Geant4 simulation of the ATLAS hadronic end-cap calorimeter beam tests to perform Geant4 regression testing, physics lists comparison and validation against test-beam data. It is also an example of how to use a Geant4 application with Geant Val and how to automatically test it using Github Actions.

• ⏰ Start date: 11 May 2021
• 📌 Status: from v1.0 on ATLHECTB is available for data production, from v2.0 on ATLHECTB is available on Geant Val
• Citation: if you want to use the code read the LICENSE and cite

<!--Authors and contacts-->

Authors and contacts

• 👨‍🔬 Lorenzo Pezzotti (CERN EP-SFT) - lorenzo.pezzotti@cern.ch
• 👨‍🔬 Supervisor: Alberto Ribon (CERN EP-SFT)

<!--Documentation and results-->

Documentation and results

Selected articles

• Pezzotti, L.; Kiryunin, A.; Konstantinov, D.; Ribon, A.; Strizenec, P.; on behalf of the Geant4 Collaboration. Including Calorimeter Test Beams in Geant-val—The Physics Validation Testing Suite of Geant4. Instruments 2022, 6, 41.

Selected presentations

• 🗣️ CALOR2024 22/5/2024, Validating Geant4 against calorimeters beam tests
• 🗣️ CERN EP-SFT Group Meeting 22/4/2024, End of Fellowship Report
• 🗣️ Geant4 Collaboration Meeting 2023 25-29/9/2023, Validation of Geant4 physics via calorimeter test-beams in geant-val
• 🗣️ ATLAS Simulation Group Meeting 5/9/2023 (ATLAS restricted), Testing ATLAS calorimeters with Geant4 and FLUKA.CERN
• 🗣️ CERN EP-SFT Simulation Meeting 5/9/2023, Testing ATLAS calorimeters with Geant4 and FLUKA.CERN
• 🗣️ 11th BTTB Workshop 19/4/2023, Geant4 Validation on Test-Beam Calorimetry Data
• 🗣️ CERN EP-SFT Simulation Meeting 7/2/2023, Testing alternative FTF tunes on calorimeters <em>(results obtained with v2.4)</em>
• 🗣️ Geant4 Collaboration Meeting 28/9/2022, Physics validation of Geant4 via calorimeter test-beams
• 🗣️ CALOR2022 17/5/2022, Including calorimeter test-beams into geant-val
• 🗣️ CERN EP-SFT Group Meeting 2/5/2022, Highlights from recent Geant4 validation on test-beam data
• 🗣️ ATLAS Simulation Group Meeting 9/11/2021 (ATLAS restricted), Updated results from the Geant ATLAS HEC simulation
• 🗣️ CERN EP-SFT Simulation Meeting 2/11/2021, Regression testing and physics list comparison with ATLHECTB
• 🗣️ CERN EP-SFT Simulation Meeting 19/10/2021, Geant Val integration of the ATLAS HEC test beam simulation
• 🗣️ CERN EP-SFT Simulation Meeting 13/7/2021, Results from the Geant4 ATLAS HEC test-beam simulation
• 🗣️ ATLAS Simulation Group Meeting 6/7/2021 (ATLAS restricted), A Geant4 simulation of the ATLAS HEC beam tests <em>(errata corrige: slide 11, EstBoard 0.8 mm Kapton -> 0.61 mm Kapton)</em>
• 🗣️ CERN EP-SFT Simulation Meeting 15/6/2021, First results from the Geant4 ATLAS HEC test beam simulation <em>(errata corrige: slide 9, EstBoard 0.8 mm Kapton -> 0.61 mm Kapton)</em>

⬆ back to top

<!--Directory structure-->

Directory structure

.
├── ATLHECTB.cc               # main()
├── ATLHECTB_gui.mac          # GUI settings
├── ATLHECTB_init_vis.mac     # Initialization and visualization settings
├── ATLHECTB_run.mac          # macro card example
├── CMakeLists.txt            # CMake instructions     
├── GNUmakefile               # GNUmake instructions
├── LICENSE                   # The LICENSE
├── README.md                 # Markdown documentation
├── _config.yml               # github pages settings
├── analysis                  # ROOT macros for data analysis
├── geantval_scripts          # Scripts for Geant Val usage
├── images                    # Images for documentation
├── include                   # Includers (.hh)
├── runcards                  # Macro cards for production
├── scripts                   # Scripts for lxplus and lxplus with HTCondor usage
├── src                       # Sources (.cc)

<!--Geant Val integration-->

Geant Val integration

Geant Val is the Geant4 testing and validation suite. It is a project hosted on gitlab.cern.ch used to facilitate the maintenance and validation of Geant4 applications, referred to as <em> tests</em>.
The following are instructions to use ATLHECTB within Geant Val, from batch submission to website deployment.

1. On lxplus git clone ATLHECTB and the Geant Val/geant-config-generator

   git clone git@github.com:lopezzot/ATLHECTB.git
   git clone ssh://git@gitlab.cern.ch:7999/GeantValidation/geant-config-generator.git
   

2