Import Geant4 11.4.0 source tree

2025-12-05 08:54:02 +01:00
parent a499fb82e9
commit b4a16de652
6484 changed files with 232674 additions and 221097 deletions
@@ -1,169 +0,0 @@
-/// @file "hadronic/FlukaCern/ProcessLevel/CrossSection/.README.txt"
-/// @brief Example exFlukaCernCrossSection README
-
-/*! \page exFlukaCernCrossSection Example : exFlukaCernCrossSection
-
-
-# Description
-
-This example allows the study of G4 cross-sections, 
-and in addition, of the `FLUKA` hadron-nucleus reaction cross sections.
-
-The user can printout any particle-material XS. <br>
-The XS are exactly the ones defined in any G4 physicsList chosen by the user,
-or from `FLUKA` (hadron-nucleus inelastic case).
-  
-In the input file, the user can set:
- projectile.
- target material (element, compound or even mixture).
- plotting options.
-
-All plots (created via the G4 analysis manager) can be dumped 
-to any of the usually supported formats (e.g. `ROOT` format), 
-but also in a Flair-compatible format. <br>
-Regarding the extension of `G4H1` to insure `Flair` compatibility, 
-see `geant4/examples/extended/hadronic/FlukaCern/utils`.
-     
-Note that the Geant4 SERIAL run manager is used, since `FLUKA` is single-threaded  
-(in actual `FLUKA` runs, parallelism is achieved via a multi-processing approach).    
-   
-Before you can access the `FLUKA` hadron-nucleus inelastic model in this example, 
-you will need to install and setup `FLUKA` and its interface. <br> 
-See "Dependencies" paragraph below.    
-
-A version of the interface to `FLUKA` is directly located at `geant4/examples/extended/hadronic/FlukaCern/FlukaInterface`.      
-   
-
-# Dependencies
-
-### Environment
- **gcc** >= 7 (Linux) and **gcc** >= 9 (MacOS) <br>
-In practice, a recent version is recommended, at least `gcc >=10`.    
-\verbatim
-gcc --version
-\endverbatim
-<br>
-
- **CMake** >= 3.16...3.21 <br>
-\verbatim
-cmake3 --version
-\endverbatim
-<br>
-
- **G4** >= 11.0.3 (Not tested on older G4 releases: might still work, but with no guarantee). <br>  
-IMPORTANT: YOU NEED TO SOURCE YOUR G4 ENVIRONMENT. <br>
-It needs to be sourced in whichever terminal you want to build / run a G4 application with the `FLUKA` interface.
-\verbatim
-source path_to_geant4/install/bin/geant4.sh
-which geant4-config   # NB: Your geant4-config should support the modern CMake way of building G4.
-\endverbatim
-<br>
-
- **Easy setup on lxplus** (lxplus7): <br>  
-All you need to do on lxplus, to setup an environment satisfying all the conditions above, is, for example:
-\verbatim
-source /cvmfs/sft.cern.ch/lcg/releases/gcc/10.1.0/x86_64-centos7/setup.sh
-source /cvmfs/geant4.cern.ch/geant4/11.1/x86_64-centos7-gcc10-optdeb-MT/CMake-setup.sh
-# NB: Your geant4.sh is at: /cvmfs/geant4.cern.ch/geant4/11.1/x86_64-centos7-gcc10-optdeb-MT/bin/geant4.sh
-\endverbatim
-<br>
-
-### FLUKA4
-Release: >= **4-3.2**   
-
-Please install the latest `FLUKA` release. <br>      
-(1) You first need to register (and accept the licence when relevant): https://fluka.cern/download/registration <br>  
-(2) You can then download the `binary libraries` (or potentially the `source code` package, depending on your case): 
-https://fluka.cern/download/latest-fluka-release. <br>   
-(3) Follow the `FLUKA` installation instructions: https://fluka.cern/documentation/installation <br>
-In particular, for a Linux/MacOS install: https://fluka.cern/documentation/installation/fluka-linux-macos <br>
-They will show you how to setup `FLUKA`. <br> 
-If (and only if) you went for the source code package option, you will need to build `fluka`, and, in addition, to do `make cpp_headers` at `path_to_fluka/src`. <br>
-(4) Eventually, all you need are the headers `fluka_repo/include`, libraries `fluka_repo/lib`, and data `fluka_repo/data`. Check that they are not empty. <br>
-Do not forget to add `/path_to_fluka/bin` to your `PATH`. Check with `which fluka`.  
-
-### FlukaInterface
-A version of the G4-FLUKA interface (`FLUKA` hadron-nucleus inelastic physics) 
-is located at `geant4/examples/extended/hadronic/FlukaCern/FlukaInterface`. <br>
-You will first need to build the interface to `FLUKA`, and create the environment scripts. <br>   
-\verbatim
-cd geant4/examples/extended/hadronic/FlukaCern/FlukaInterface/
-# Check with `which fluka` that fluka executable is added to your `PATH`.
-source path_to_geant4/install/bin/geant4.sh
-make interface
-make env       # Creates `env_FLUKA.sh` and `env_FLUKA_G4_interface.sh`
-\endverbatim
-IMPORTANT: `env_FLUKA_G4_interface.sh` needs to be sourced in whichever terminal 
-you want to build / run a G4 application with the `FLUKA` interface.  
-
-
-# Build this example
- 
-\verbatim
-cd geant4/examples/extended/hadronic/FlukaCern/ProcessLevel/CrossSection/
-# Check with `which fluka` that fluka executable is added to your `PATH`.
-source path_to_geant4/install/bin/geant4.sh
-source ../../FlukaInterface/env_FLUKA_G4_interface.sh
-mkdir build
-cd build
-cmake3 -DG4_USE_FLUKA=1 ..
-make -j8
-\endverbatim
-
-
-# Run this example
- 
-\verbatim
-cd geant4/examples/extended/hadronic/FlukaCern/ProcessLevel/CrossSection/
-# Check with `which fluka` that fluka executable is added to your `PATH`.
-source path_to_geant4/install/bin/geant4.sh
-source ../../FlukaInterface/env_FLUKA_G4_interface.sh
-# Edit all_XS.in (choice of particle, material, energy range...)
-# XS used by FTFP_BERT_HP physics list:
-./build/HadronNucleusXS all_XS.in FTFP_BERT_HP
-# XS used by G4_HP_CernFLUKAHadronInelastic_PhysicsList physics list:
-./build/HadronNucleusXS all_XS.in G4_HP_CFLUKAHI
-\endverbatim
-
-
-# Study the cross-sections
-All plots are dumped at the end of the run in `all_XS.ext`. <br>  
-2 formats are supported: `ROOT` and `Flair`.
-
- You can use `ROOT`: <br>
-\verbatim
-cd geant4/examples/extended/hadronic/FlukaCern/ProcessLevel/CrossSection/
-root all_XS.root
-\endverbatim
-<br>   
- Alternatively, the use of `Flair` is also supported. <br>   
-Please see http://flair.web.cern.ch/flair/download.html for `Flair` download. <br> 
-`Flair` tutorials are also available from that website. <br> 
-You can download the package corresponding to your distribution at the top of the page 
-(no need for `geoviewer`, which is for geometry display). Then look at the requirements & installation instructions at the bottom of the page. <br>  
-If you face issues installing `Flair`, you can get support at: https://fluka-forum.web.cern.ch/c/installation/
-<br><br>
-An example file, showing how to directly visualize all XS with `Flair`, 
-is provided in this G4 example. <br>
-By default, it directly provides comparison plots:  
-`FTFP_BERT_HP` versus `G4_HP_CernFLUKAHadronInelastic`. <br> 
-One can very easily adapt it (directly from `Flair` GUI) to any study of interest.
-\verbatim
-cd geant4/examples/extended/hadronic/FlukaCern/ProcessLevel/CrossSection/
-mkdir -p results/FTFP_BERT_HP results/G4_HP_CernFLUKAHadronInelastic
-# First run the example for FTFP_BERT, G4_HP_CernFLUKAHadronInelastic, and move the results!
-./build/HadronNucleusXS all_XS.in FTFP_BERT_HP
-mv all_XS.hist results/FTFP_BERT_HP
-./build/HadronNucleusXS all_XS.in G4_HP_CFLUKAHI
-mv all_XS.hist results/G4_HP_CernFLUKAHadronInelastic
-
-flair study_all_XS.flair &
-\endverbatim
-In the `Plot` tab, you can select the plot of interest in the left column, 
-and then click `Plot` (top banner, yellow button). <br>
-You can select a physics list by clicking on its name in the `Detectors` box (center). You can then decide to change its color, line width (`Options` box). You can decide to plot it or not, by selecting / unselecting `graph` in the `Show` box (in the center). <br>
-You can change the path of the data file by clicking on the folder button (button on the right). <br>
-You can set the plots extrema, as well as select or unselect the log format, in the top right corner.
-
-
-*/
@@ -23,9 +23,9 @@
 // * acceptance of all terms of the Geant4 Software license.          *
 // ********************************************************************
 //
-///  \file HadronicNucleusXS.cc
-///  \brief Main program,
-///         hadronic/FlukaCern/ProcessLevel/CrossSection example.
+/// \file HadronNucleusXS.cc
+/// \brief Main program of the ProcessLevel/CrossSection example
+
 //
 //  Author: G.Hugo, 06 January 2023
 //
@@ -10,7 +10,7 @@


 **************************************************************
- Geant4 version Name: geant4-11-03-ref-06    (30-June-2025)
+ Geant4 version Name: geant4-11-04-ref-00    (5-December-2025)
                       Copyright : Geant4 Collaboration
                      References : NIM A 506 (2003), 250-303
                                 : IEEE-TNS 53 (2006), 270-278
@@ -18,7 +18,7 @@
                             WWW : http://geant4.org/
 **************************************************************

-G4PhysListFactory::GetReferencePhysList <FTFP_BERT_HP>  EMoption= 0
+G4PhysListFactory::GetReferencePhysList <FTFP_BERT_HP>
 <<< Geant4 Physics List simulation engine: FTFP_BERT_HP


@@ -1,6 +1,8 @@
+\page ExampleCrossSection Example CrossSection
+
 # Description

-This example allows the study of G4 cross-sections, 
+This FlukaCern example allows the study of G4 cross-sections,
 and in addition, of the `FLUKA` hadron-nucleus reaction cross sections.

 The user can printout any particle-material XS.    
@@ -23,19 +23,23 @@
 // * acceptance of all terms of the Geant4 Software license.          *
 // ********************************************************************
 //
-///  \file DetectorConstruction.hh
-///  \brief Example of empty world volume.
+/// \file DetectorConstruction.hh
+/// \brief Definition of the DetectorConstruction class
+///
+/// Example of empty world volume.
+
 //
 //  Author: G.Hugo, 06 January 2023
 //
 // ***************************************************************************
 //
-///      DetectorConstruction
-//
-//  Example of empty world volume.
+///  \class DetectorConstruction
+///
+///  Example of empty world volume.
 //
 // ***************************************************************************

+
 #ifndef DETECTOR_CONSTRUCTION_HH
 #define DETECTOR_CONSTRUCTION_HH

@@ -23,16 +23,19 @@
 // * acceptance of all terms of the Geant4 Software license.          *
 // ********************************************************************
 //
-///  \file XSHistoManager.hh
-///  \brief Create a set of profiles for XS study.
+/// \file XSHistoManager.hh
+/// \brief Definition of the XSHistoManager class
+///
+/// Create a set of profiles for XS study.
+
 //
 //  Adapted from hadronic/Hadr00/include/HistoManager.hh
 //  Author: G.Hugo, 06 January 2023
 //
 // ***************************************************************************
 //
-//      XSHistoManager
-//
+///  \class XSHistoManager
+///
 ///  Create a set of profiles for XS study.
 ///
 ///  All profiles are G4H1.
@@ -51,6 +54,7 @@
 //
 // ***************************************************************************

+
 #ifndef XS_HISTO_MANAGER_HH
 #define XS_HISTO_MANAGER_HH

@@ -23,21 +23,25 @@
 // * acceptance of all terms of the Geant4 Software license.          *
 // ********************************************************************
 //
-///  \file XSHistoManagerMessenger.hh
-///  \brief UI commands for XS study.
+/// \file XSHistoManagerMessenger.hh
+/// \brief Definition of the XSHistoManagerMessenger class
+///
+/// UI commands for XS study.
+
 //
 //  Author: G.Hugo, 06 January 2023
 //
 // ***************************************************************************
 //
-//      XSHistoManagerMessenger
-//
+/// \class XSHistoManagerMessenger
+///
 ///  UI commands for XS study.
 //
 //  NB: Note that it is not necessary to have POINTERS to the UI commands.
 //
 // ***************************************************************************

+
 #ifndef HISTO_MANAGER_MESSENGER_HH
 #define HISTO_MANAGER_MESSENGER_HH

@@ -23,8 +23,9 @@
 // * acceptance of all terms of the Geant4 Software license.          *
 // ********************************************************************
 //
-///  \file DetectorConstruction.cc
-///  \brief Example of empty world volume.
+/// \file DetectorConstruction.cc
+/// \brief Implementation of the DetectorConstruction class
+
 //
 //  Author: G.Hugo, 06 January 2023
 //
@@ -23,8 +23,9 @@
 // * acceptance of all terms of the Geant4 Software license.          *
 // ********************************************************************
 //
-///  \file XSHistoManager.cc
-///  \brief Create a set of profiles for XS study.
+/// \file XSHistoManager.cc
+/// \brief Implementation of the XSHistoManager class
+
 //
 //  Adapted from hadronic/Hadr00/src/HistoManager.cc
 //  Author: G.Hugo, 06 January 2023
@@ -23,8 +23,9 @@
 // * acceptance of all terms of the Geant4 Software license.          *
 // ********************************************************************
 //
-///  \file XSHistoManagerMessenger.cc
-///  \brief UI commands for XS study.
+/// \file XSHistoManagerMessenger.cc
+/// \brief Implementation of the XSHistoManagerMessenger class
+
 //
 //  Author: G.Hugo, 06 January 2023
 //