Back to home page

EIC code displayed by LXR

 
 

    


Warning, /geant4/CHANGELOG/Beta4.11.3-1.txt is written in an unsupported language. File is not indexed.

0001 
0002                   Geant4 11.3-beta-01 Release Notes
0003                   ---------------------------------
0004 
0005                                                             28 June 2024
0006 
0007                  Migration Notes & Main New Features
0008                  -----------------------------------
0009 
0010   o Fixed spurious compilation warnings on gcc when LTO settings are enabled.
0011   o First full implementation of sub-event parallelism, with creation and
0012     processing of sub-events in workers, and merging of results back into
0013     events on the main thread.
0014   o Added protection in G4VPrimaryGenerator::SetParticlePosition() to avoid
0015     and warn for attempts to place vertex position outside or on surface of
0016     the world volume.
0017   o Extended diagnostics and output from material scanner.
0018   o First implementation of parallel initialisation of geometry optimisation.
0019   o New revised and optimised implementation of G4GenericTrap shape.
0020   o Improved/optimised implementation of GetCubicVolume() in Boolean solids.
0021   o Added new classes for automatic field construction from parameters.
0022   o Optimised step limitation algorithm in G4UrbanMscModel.
0023   o G4eeToTwoGammaModel: fixed precision lost in sampling of final state
0024     for very high energies.
0025   o New class G4EmDataRegistry, to keep EM data tables.
0026   o New G4OrePowellAtRestModel class, Orel & Powell orto positronium decay
0027     model AtRest and G4SimpleoPsAtRestModel, a simple orto para positronium
0028     chooser.
0029   o New classes for multiple-ionisation in Geant4-DNA.
0030   o In G4EmDNAPhysics, define default maximum kinetic energy 600 MeV instead
0031     of 300 MeV in order to have standard ionisation and multiple scattering
0032     always defined for DNA physics configurations
0033   o Added three new variants of 'Shielding' physics list in G4PhysListFactory.
0034   o Introduced neutron treatment of the Unresolved Resonance Region (URR)
0035     via Probability Table (PT); relevant for precise simulations of nuclear
0036     reactor criticality and shielding applications.
0037   o First implementation of NuDEX nuclear de-excitation hadronic model.
0038   o Updates to cross-section classes to rationalise initialisation of data
0039     in MT mode.
0040   o Simplified computation of cross-section maximum for discrete processes
0041     in G4EmUtility.
0042   o New class G4XTRGaussRadModel, providing improved account on the origin
0043     of XTR photons.
0044   o Restored OpenGL as default backend for Qt6. Fixed open issues when using
0045     Qt6 with supported drivers.
0046   o Improved identification of scene tree models in visualisation.
0047     Now suppressing the scene tree if the number of touchables exceeds
0048     10000 (equivalent to about 20 MB)
0049   o Removed configuration/setup of no longer supported TiMemory profiling.
0050   o Build option with VecGeom requires VecGeom-1.2.8 or higher.
0051   o Requires CLHEP-2.4.7.1 for external CLHEP installation.
0052   o New versions of datasets: G4PARTICLEXS-4.1, G4EMLOW-8.6.
0053   o New optional datasets: G4NUDEXLIB-1.0, G4URRPT-1.0.
0054 
0055  ----------------------------------------------------------------------------
0056 
0057                              Technical Notes
0058                              --------------- 
0059 
0060   o Tested platforms:
0061     + Linux, gcc-11.3.1.
0062       Tested on 64 bit architectures (Intel or AMD) with Alma Linux 9
0063       (based on RedHat Linux Enterprise 9). Versions of Geant4 have also
0064       been compiled successfully on other Linux distributions, Ubuntu,
0065       Debian, Suse or other RedHat systems.
0066     + MacOS 14.5, Apple LLVM/clang-15 (Intel or Apple Silicon).
0067     + Windows/11 with Visual C++ 14.40 (Visual Studio 2022)
0068 
0069   o More verified configurations:
0070     + Linux, with gcc-9.4/10.3/11.3/12.1/13.2/14.1, clang-14/15/16/17.
0071     + Linux, with Intel-icx 2024.1.
0072     + MacOS 12.7/13.6, with Apple LLVM/clang-14/15.
0073     + Windows/10 with Visual C++ 14.36 (Visual Studio 2022)
0074 
0075   o External dependencies
0076     + CLHEP-2.4.7.1, suggested for external installation of the CLHEP library.
0077     + VecGeom-1.2.8 or later, for optional use of VecGeom geometry primitives.
0078     + PTL-2.3.3, for external installation of the PTL tasking library.
0079 
0080   o New datasets:
0081     + G4PARTICLEXS-4.1, G4EMLOW-8.6, G4NUDEXLIB-1.0, G4URRPT-1.0.
0082 
0083  Please refer to the Geant4 User Documentation:
0084    https://cern.ch/geant4/support/user_documentation
0085  for further information about using Geant4.
0086 
0087  ----------------------------------------------------------------------------
0088 
0089 List of features and fixes included in this Beta release since 11.2.p02:
0090 
0091   o Configuration:
0092     -------------
0093     + CMake:
0094       o Added compiler flags for GCC only to help detect/debug LTO-related
0095         problems when building with CMAKE_INTERPROCEDURAL_OPTIMIZATION.
0096       o Provide CMake function to assist in linking unit tests to final
0097         libraries given required source code modules.
0098       o Removed configuration/setup of no longer supported TiMemory profiling.
0099       o Introduced new "FullRelWithDebInfo" build mode, "-O3 -g", so maximum
0100         optimisation with debugging symbols.
0101       o Simplifications to Geant4Config.cmake: removed obsolete and never run
0102         "whole archive" linking of G4physics_lists; replaced TOOLSSG
0103         visualisation driver variables that are just synonyms for more
0104         fundamental config options (e.g. GEANT4_USE_QT) with the underlying
0105         variable.
0106       o Added optional install of new NuDEXLib and URRPT datasets.
0107       o Updated to datasets: G4PARTICLEXS-4.1, G4EMLOW-8.6, G4NUDEXLIB-1.0,
0108         G4URRPT-1.0.
0109 
0110   o Event:
0111     -----
0112     + Initial implementation of creation and processing of sub-events.
0113     + Added protection in G4VPrimaryGenerator::SetParticlePosition() to avoid
0114       and warn for attempts to place vertex position outside or on surface of
0115       the world volume.
0116     + G4PrimaryTransformer: adding sanity check of 4-momentum.
0117     + Added UI command to switch on/off the vertex position check (default: on).
0118     + Updated "/gun/position" UI command guidance in G4ParticleGunMessenger.
0119       Removed unnecessary setting of gun position to (0, 0, 0).
0120     + Removed use of no longer supported TiMemory.
0121 
0122   o Geometry:
0123     --------
0124     + divisions:
0125       o Applied trivial clang-tidy fixes to classes, i.e. use of default
0126         constructor/destructor.
0127     + magneticfield:
0128       o Added new classes for automatic field construction from parameters:
0129         G4FieldBuilder[Messenger], G4FieldParameters[Messenger] and
0130         G4FieldSetup.
0131       o Applied trivial clang-tidy fixes to classes, i.e. use of default
0132         constructor/destructor, auto and using statements.
0133       o Minor cleanup in QSS classes.
0134     + management:
0135       o Added new capability to run voxel optimisation in threads in MT mode.
0136         Parallelises only over volumes. The user must currently call
0137         G4GeometryManager::RequestParallelOptimisation(optimise, verbose) to
0138         use it. Set 'verbose=true' to obtain statistics on the volumes with
0139         biggest contribution to memory size and CPU time for voxelisation.
0140         New method BuildOptimisationsParallel() can be called by
0141         G4WorkerRunManager to initialise. New method ReportVoxelInfo() to
0142         write out for verification. Checked with simple and complex/large
0143         geometries.
0144       o Added new methods GetNumOfConstituents() and IsFaceted() to G4VSolid.
0145       o Applied trivial clang-tidy fixes to classes, i.e. use of default
0146         constructor/destructor.
0147     + navigation:
0148       o G4TransportationManager now notifies G4FieldManager about the global
0149         field via its new function SetGlobalFieldManager(). This provides
0150         the ability to access/revise the global field manager directly
0151         from G4FieldManager without dependency on the navigation module.
0152       o Applied trivial clang-tidy fixes to classes, i.e. use of 'override' and
0153         removal of 'virtual' keywords; use of default constructor/destructor.
0154     + solids/Boolean:
0155       o In G4BooleanSolid, propagate parameter to all constituents in
0156         SetCubVolStatistics() and SetCubVolEpsilon().
0157       o In G4UnionSolid and G4SubtractionSolid, limit calculations with
0158         construction of temporary G4IntersectionSolid by 10 constituents for
0159         GetCubicVolume().
0160       o Implemented new methods GetNumOfConstituents() and IsFaceted().
0161       o Added extra method to process solid and not perform external operations
0162         via G4Polyhedron. Successive Boolean mesh operations with floating point
0163         are invariably going to be unstable. Providing a method which takes a
0164         solid and returns the G4Polyhedron allows the external processor to use
0165         significantly more precise types and strategies to avoid ambiguity and
0166         then finally convert to double at the very last step.
0167     + solids/CSG:
0168       o Implemented new methods GetNumOfConstituents() and IsFaceted().
0169       o Applied trivial clang-tidy fixes to G4CSGSolid, i.e. use of 'override'.
0170     + solids/specific:
0171       o Completely revised and optimised implementation of G4GenericTrap.
0172         Addressing problem report #2547.
0173       o Implemented new methods GetNumOfConstituents() and IsFaceted().
0174       o Applied trivial clang-tidy fixes to classes, i.e. use of 'override'
0175         and 'default' keywords.
0176     + volumes:
0177       o Applied trivial clang-tidy fixes to G4AssemblyStore, i.e. removed
0178         unnecessary 'if' check for null pointer in Clean() method.
0179 
0180   o Global:
0181     ------
0182     + G4StateManager, G4VStateDependent: added notifying methods when an event
0183       or a run is deleted to avoid a state-dependent class from accessing to an
0184       obsolete event/run object.
0185     + G4PhysicsModelCatalog: added ID for the NuDEX nuclear de-excitation model;
0186       removed unnecessary ID (24110) for internal conversion.
0187     + G4PhysicsTable: avoid crash in printout for the case when a vector in the
0188       table is not yet created (useful for debugging).
0189     + Removed use of no longer supported TiMemory.
0190     + Changed date for release 11.3-beta.
0191 
0192   o Graphics Representations:
0193     ------------------------
0194     + G4SceneTreeItem: added G4String field 'FurtherInfo' and access functions.
0195     + G4Colour: clarify usage; added GetColor (US spelling); added G4Exception.
0196     + G4VVisManager: added EventReadyForVis(), used by G4SubEvtRunManager.
0197 
0198   o Intercoms:
0199     ---------
0200     + Unify range checking implementation in G4UIparameter/command; pure
0201       refactor to remove code duplication and complexity of user-facing
0202       classes.
0203     + Removed use of no longer supported TiMemory.
0204 
0205   o Interfaces:
0206     ----------
0207     + Improved identification of scene tree models: use full description,
0208       including embedded blanks.
0209     + In G4UIQt, now all models are treated alike. Load tooltip with "further
0210       information", if any; inform user if scene tree is suppressed because
0211       of too many touchable. Fixed crash and bad rendering behaviour when
0212       using QOpenGLWidget with Qt6.
0213     + Removed use of no longer supported TiMemory.
0214 
0215   o Physics Lists:
0216     -------------
0217     + Constructors:
0218       o electromagnetic:
0219         - G4EmStandardPhysicsWVI: return back ATIMA model for ionisation and
0220           fluctuations of ions in order to make comparisons with other models.
0221         - G4EmStandardPhysics_option3: return back step limit type to
0222           'fUseDistanceToBoundary' and the default RangeFactor from 0.03
0223           to 0.04. This will allow to restore more accurate distributions for
0224           several medical benchmark tests.
0225         - G4EmStandardPhysics_option3, G4EmStandardPhysics_option4,
0226           G4EmLivermorePhysics, G4EmLivermorePhysics, G4EmDNAPhysics: use
0227           fAllisonPositronium type of model for sampling of positron
0228           annihilation at rest (as in release 11.2).
0229         - G4EmStandardPhysics_option4: use alternative model for positron
0230           annihilation on fly with 3-gamma annihilation channel enabled.
0231         - G4GammaGeneralProcess: updated according to change in EM data tables.
0232         - G4EmDNAPhysics: define default maximum kinetic energy 600 MeV instead
0233           of 300 MeV in order to have standard ionisation and multiple
0234           scattering always defined for DNA physics configurations.
0235           This allows to avoid situations when low-energy ions pass through
0236           DNA regions without interaction.
0237         - G4EmDNAPhysics, G4EmDNAPhysicsActivator, G4EmDNAPhysics_option2,
0238           G4EmDNAPhysics_option4, G4EmDNAPhysics_option6 and
0239           G4EmDNAPhysics_option8: changed upper limit for DNA physics of
0240           Helium ions from 300 MeV to 400 MeV.
0241         - G4EmDNABuilder: added nuclear stopping process for G4GenericIon
0242           below 1 MeV/u.
0243         - Use EmParameters to control chemistry models in
0244           G4EmDNAChemistry_option3.
0245       o factory:
0246         - Minor code cleanup in G4PhysicsConstructorRegistry source.
0247       o constructors/hadron_inelastic
0248         - G4HadronPhysicsQGSP_BERT_HP: use alternative NUDEX model of
0249           gamma de-excitation.
0250 
0251   o Electromagnetic Processes:
0252     -------------------------
0253     + DNA:
0254       o Optimised IRT-syn at 1 ps for high LET applications.
0255       o G4DNARuddIonisationExtendedModel: updated model to not use autolock but
0256         rather upload data in the class constructor once in all threads; use
0257         effective charge approach for all ions with Z > 2 (in order to have
0258         more correct computation of stopping power and ranges); precompute
0259         internal variables before sampling; optimised algorithm of sampling
0260         (at 10 MeV it becomes ~10 times faster); updated initialisation to
0261         allow be called from the general model; removed unused parameters.
0262       o G4GeneralIonIonisationModel, G4DNAIonChargeIncreaseModel and
0263         G4DNAIonChargeDecreaseModel: new classes implementing general models
0264         for ions heavier than Helium.
0265       o G4DNAChargeDecrease, G4DNAChargeIncrease: removed obsolete definition
0266         of min/max model energy inside processes class; some code clean-up.
0267       o G4DNAElectronHoleRecombination: changed branch condition in
0268         FindReactant() to select only H2O+ ions involved in electron-hole
0269         recombination.
0270       o G4DNAWaterDissociationDisplacer: added dissociative decay channels for
0271         multiple-ionised water ions.
0272       o G4DNAMultipleIonisationManager: new class focusing on generation of
0273         multiple-ionised water ions and calculation of scale parameter to
0274         compute cross-section of each multiple-ionisation process.
0275       o G4DNADoubleIonisation, G4DNATripleIonisation and
0276         G4DNAQuadrupleIonisation: new process classes for multiple-ionisation.
0277       o G4DNADoubleIonisationModel, G4DNATripleIonisationModel and
0278         G4DNAQuadrupleIonisationModel: new model classes related to
0279         multiple-ionisation.
0280       o G4DNAELSEPAElasticModel: modified to be compatible with density
0281         scaling.
0282       o Debug invalid KDTree node.
0283       o Deleted DelayLists at the end of chemistry stage.
0284       o Delete unused enum, as now adopting EmParameters to control chemistry
0285         models in G4EmDNAChemistry_option3.
0286       o Cleaned G4Scheduler and cleanup in CMake scripts.
0287     + Low Energy:
0288       o G4MicroElecLOPhononModel: minor code cleanup.
0289     + Standard:
0290       o New G4OrePowellAtRestModel class, Orel & Powell orto positronium decay
0291         model AtRest and G4SimpleoPsAtRestModel, simple orto para positronium
0292         chooser.
0293       o G4IonICRU73Data: fix for the case when target material has an element
0294         with Z>92; improved debug printouts. In the Lindhard-Sorensen model to
0295         compute dEdx the first try is to take it from ICRU73 or ICRU90 data,
0296         if this class returns zero, then dEdx is computed from G4GenericIon 
0297         and effective charge. Addressing problem report #2586.
0298       o G4eeToTwoGammaModel: fixed precision lost in sampling of final state
0299         for the very high energy (ATLAS report).
0300       o G4UrbanMscModel: optimised DistanceToBoundary step limitation
0301         algorithm currently used only in Opt3 EM physics.
0302       o G4SimplePositronAtRestModel, G4AllisonAtRestModel: new classes to
0303         sample positron annihilation.
0304       o G4eplusTo2GammaOKVIModel: removed sampling at rest.
0305       o G4eplusAnnihilation: added selection of AtRest model; implemented
0306         ApplyCuts() for AtRest; implemented choice of positron annihilation
0307         model at rest. Use more const class members; changed model ID
0308         definition for produced tracks.
0309     + Utils:
0310       o G4EmParameters: increased low-limit on 'maxKinEnergy' parameter from
0311         10 MeV to 600 MeV in order to have standard ionisation and multiple
0312         scattering always defined for DNA physics configurations. 
0313         Added protection to fix segmentation fault when data is unavailable.
0314       o G4EmParameters, G4EmParametersMessenger: added enumerator and a new
0315         flag G4PositronAtRestModel, which allows selection and configuration of
0316         the model of positron annihilation at rest. Added orto positronium
0317         fraction flag.
0318       o G4LowEnergyEmProcessSubType: added 'fLowEnergyTripleIonisation' and
0319         'fLowEnergyQuadrupleIonisation' for implementing multiple-ionisation
0320         processes in Geant4-DNA.
0321       o G4VPositronAtRestModel: new virtual interface.
0322       o G4EmDataRegistry: new class to keep EM data tables.
0323       o G4VEmProcess: extended info printout for e+ annihilation at rest.
0324       o G4VEmProcess, G4VEnergyLossProcess: improved identification of model ID
0325         for atomic de-excitation (fluorescence, Auger e-, PIXE).
0326       o G4EmParameters, G4EmLowEParameters, G4EmLowEParametersMessenger: added
0327         DNA chemistry time step model.
0328       o G4EmDataHandler: extended functionality.
0329       o G4LossTableManager: identify master thread using std method.
0330       o G4LossTableBUilder: more accurate use of static members and methods.
0331       o G4VEmModel, G4VEmProcess, G4VEnergyLossProcess, G4EmTableUtil: updated
0332         according to change in the data.
0333       o G4VMscModel: moved initialisation of tables for model to G4EmTableUtil.
0334       o G4EmBiasingManager: minor cosmetic change.
0335     + Xrays:
0336       o G4XTRGaussRadModel: new class providing improved account on the origin
0337         of XTR photons.
0338 
0339   o Hadronic Processes:
0340     ------------------
0341     + cross_sections
0342       o G4NeutronCapture: lowest energy limit is set to 10^-5 eV; below this
0343         energy no computations are done, to avoid numerical problems.
0344         Improved comments to the code.
0345       o G4NeutronInelastic: implemented 1/v cross-section dependence below
0346         low-energy limit of the cross-section vector, if the cross-section
0347         does not start from null.
0348       o Moved G4IsotopeList header to 'util' module.
0349       o G4HadronXSDataTable: make class a singleton for registration and
0350         destruction of static objects with cross-section data; data are deleted
0351         only at the end of run.
0352       o G4BGGNucleonElasticXS, G4BGGNucleonInelasticXS, G4BGGPionElasticXS,
0353         G4BGGPionInelasticXS, G4ComponentBarNucleonNucleusXsc,
0354         G4HadronNucleonXsc, G4UPiNuclearCrossSection and
0355         G4CrossSectionDataSetRegistry: code clean-up; removed 'isMaster' checks,
0356         removed mutex locks, removed unused variables and applied code
0357         formatting.
0358       o G4BGGNucleonElasticXS, G4BGGNucleonInelasticXS, G4NeutronInelasticXS,
0359         G4ComponentBarNucleonNucleusXsc, G4ComponentGGNuclNuclXsc, G4PiData and
0360         G4NucleonNuclearCrossSection: general clean-up of proton and neutron
0361         cross-sections; removed unused methods, removed not needed mutex locks,
0362         improved printouts, cross-sections outside data tables are equal to
0363         low or high edge of the table (not zero).
0364       o In G4NeutronInelasticXS::SelectIsotope(), fixed compilation warnings
0365         for implicit type conversions detected with macOS/XCode.
0366       o G4ComponentGGNuclNuclXsc: removed debug printout, added check of
0367         G4VERBOSE.
0368       o G4BGGPionElasticXS, G4BGGNucleonInelasticXS, G4BGGNucleonElasticXS:
0369         added check of G4VERBOSE compilation flag.
0370     + management
0371       o G4HadronicProcessStore: fixed handling of rare processes, printout, 
0372         cross-section maximum search, and deletion at the end of run.
0373     + models/abla
0374       o Added array extension for super-heavy nuclei.
0375       o Added the dissipation parameter for heavy hypernuclei.
0376       o General code cleanup; removed unused data structures; consistently use
0377         G4 types; added pragma once for compilation.
0378     + models/cascade
0379       o Use G4UniformRand() instead of G4InuclSpecialFunctions::inuclRndm()
0380         wrapper (now removed from class G4InuclSpecialFunctions) in the code.
0381       o In G4CascadeFinalStateAlgorithm::GenerateCosTheta(), for 4-body and
0382         higher-body generation of cosTheta, use direct sampling of
0383         exp(1-cosTheta) instead of previously used rejection method on
0384         sinTheta*exp(-sinTheta). This removes the reflection about cosTheta=0
0385         that caused a symmetric double bump in the Feynman-x distribution.
0386     + models/de_excitation
0387       o G4CameronGilbertPairingCorrections, G4CameronGilbertShellCorrections,
0388         G4NuclearLevelData, G4PairingCorrection: simplified computation of
0389         corrections; computations are now done in one place only, not spread
0390         among classes.
0391       o G4EvaporationChannel, G4EvaporationProbability: fixed usage of pairing
0392         corrections; agreement with test data is improved.
0393       o G4EvaporationChannel: fixed computation of minimal kinetic energy of a
0394         fragment for odd-even residual nucleus. 
0395       o G4DeexPrecoParameters: moved definition of int and bool parameters to
0396         source; improved comments; added default width of nuclear level needed
0397         for selection of final excitation in a decay of an excited state.
0398       o G4PhotonEvaporation: use abs() in all computations for 'JP', as it can
0399         be negative due to parity. Addressing problem report #2587.
0400       o G4VEmissionProbability: renamed local variable to avoid possible
0401         shadowing. Use the new width parameter.
0402       o G4ExcitationHandler: improved debug printout.
0403       o G4ExcitationHandle, G4NeutronRadCapture: corrected model ID for IC
0404         electrons.
0405       o G4GEMChannelVI, G4GEMProbabilityVI: updated interfaces and simplified
0406         algorithm of computation of probability.
0407       o G4VCoulombBarrier, G4CoulombBarrier, G4GEMCoulombBarrier,
0408         G4FermiBreakUpUtil: code cleanup; removed unused headers and variables.
0409     + models/fission
0410       o G4FissLib: fixed compilation warning on gcc when LTO settings are
0411         enabled.
0412     + models/lepto_nuclear
0413       o Fixed Coverity warning on unused variable in neutrino models.
0414     + models/nudex
0415       o New alternative and more sophisticated nuclear de-excitation model
0416         (NuDEX) as far as the emission of gammas and internal conversion
0417         electrons are concerned. The model relies on the dataset
0418         G4NUDEXLIB-1.0, which is pointed by the environmental variable
0419         G4NUDEXLIBDATA. When NuDEX is not applicable - e.g. because the
0420         corresponding nucleus is not present in the dataset - the
0421         G4PhotonEvaporation class is utilised instead. Currently, the model
0422         will be used only for the neutron capture process, when ParticleHP is
0423         utilised; in the future it can be used more generally as one of the
0424         possible "evaporation" models. This, at the beginning, will only be
0425         possible for the physics list QGSP_BERT_HP.
0426     + models/particle_hp
0427       o Introduced neutron treatment of the Unresolved Resonance Region (URR)
0428         via Probability Table (PT); relevant for precise simulations of nuclear
0429         reactor criticality and shielding applications.
0430         Reading probability table files in compressed format from the new
0431         G4URRPT-1.0 dataset pointed by the G4URRPTDATA environment variable.
0432     + models/parton_string
0433       o G4ExcitedStringDecay: fixed minor memory leak suggested by Coverity.
0434     + models/radioactive_decay
0435       o Renamed G4RadioactiveDecay to G4VRadioactiveDecay and G4Radioactivation
0436         to G4RadioactiveDecay. The header for G4Radioactivation is preserved to
0437         provide backwards compatibility.
0438     + util
0439       o G4HadronicParameters: introduced Get/Set methods for flag controlling
0440         the NuDEX gamma de-excitation module.
0441       o Moved G4IsotopeList header with static data in this module, from
0442         'cross_sections'.
0443 
0444   o Run:
0445     ---
0446     + First full implementation of of sub-event parallelism, adding the
0447       creation and processing of sub-events in workers, plus the merging
0448       of results back into events on the main thread. Some additional work
0449       may be needed to correctly retain a limited sample of events.
0450       No impact of the core changes needed to support sub event parallelism in
0451       any other mode (Seq, MT, Tasking) other than some counting issues with
0452       retained events.
0453     + Extended diagnostics and output from material scanner.
0454     + Added call in G4WorkerRunManager to use parallel initialisation of
0455       voxels.
0456     + In G4RunManager::ReinitializeGeometry(), added call to new function
0457       G4FieldBuilder::Reinitialize().
0458     + G4PhysicsListHelper: added 'DNATripleIoni' and 'DNAQuadrupleIoni'
0459       for the implementation of multiple-ionisation processes in Geant4-DNA.
0460     + G4RunManager: added SetDefaultClassification() methods to enable setting
0461       the classification for tracks newly arriving to a stack.
0462     + Removed use of no longer supported TiMemory.
0463     + Fixed compilation warnings for implicit type conversions on macOS/XCode
0464       on G4MSSteppingAction. Use consistently G4 types.
0465 
0466   o Track & Tracking:
0467     ----------------
0468     + Added optional copy of touchable when copy constructing a G4Track, to
0469       support sub-event parallelism.
0470     + Some code cleanup, providing more easy reading of class headers; expected
0471       tiny CPU speedup; identical results.
0472     + G4Track, G4Step, G4StepPoint: added keyword "inline" to all inline method
0473       declarations; improved comments.
0474     + G4Step: move methods to compute delta energy and momentum to inline
0475       removing G4Exception but improving comments to these methods; removed
0476       G4ThreadLocal variable.
0477     + G4VParticleChange: improved layout of variables.
0478     + G4ParticleChangeForGamma, G4ParticleChangeForLoss: reserve vector of
0479       secondaries.
0480     + Removed use of no longer supported TiMemory.
0481 
0482   o Visualization:
0483     -------------
0484     + management:
0485       o Rationalisation, simplification and code tidying.
0486       o Updated visualisation manager to correctly merge/handle asynchronous
0487         event merging (also resolving long standing issues with post
0488         processing). Implemented 'EventReadyForVis', used by G4SubEvtRunManager;
0489         restructured EndOfEvent functions to accommodate this and avoid code
0490         duplication; this involved introducing: "Relinquishable",
0491         "EndOfEventKernel" and "EndOfEventCleanup".
0492       o Corrected the use of "KeepForPostProcessing/PostProcessingFinished".
0493       o G4VisExecutive: restored OpenGL as default backend for Qt6.
0494       o Improved identification of scene tree models: use full description,
0495         including embedded blanks.
0496       o G4VViewer: check validity of arguments in SceneTreeScene constructor.
0497         Pre-calculate quantities in SceneTreeScene constructor; pre-calculate
0498         the number of touchable; if more than 10000, suppress them in the
0499         scene tree and add some information about it to the model item so that
0500         it pops up as a tooltip in the GUI.
0501         More logical order of some functions.
0502       o G4VSceneHandler: specify the G4PhysicalVolumeModel for construction
0503         of scene tree. Simplified loop over models, added some printing.
0504         Print number of touchable by depth (if verbosity >= confirmations).
0505         Print problematic volumes (if verbosity >= confirmations).
0506       o Limit the number of scene tree items. For complex geometries, the scene
0507         tree can take up a lot of space, and, anyway, not easy to navigate.
0508         Now suppressing the scene tree if the number of touchable exceeds
0509         10000 (equivalent to about 20 MB).
0510       o G4VisCommandsViewer: use GetSceneTree() rather than AccessSceneTree()
0511         when not necessary.
0512       o In G4VisExecutive, trap use of run-time visualisation driver choice,
0513         and (if using run-time choice) insist the UI session is instantiated
0514         *before* G4VisExecutive.
0515         Keep argc, argv and user-specified system, if specified, for delayed
0516         use. Moved informational (G4warn) from G4VisManager.
0517       o Delay determination of the run-time-chosen default driver.
0518         The run-time-chosen default driver is not actually used until the first
0519         use of "/vis/open" or "/vis/sceneHandler/create" without driver
0520         parameter, so we delay to this point. This catches the situation when
0521         the user instantiates the UI session *after* instantiating the vis
0522         manager.
0523       o G4VisManager: make GetDefaultGraphicsSystemName() virtual and non const.
0524         The code for choosing a default driver *has to be* in user space, i.e.,
0525         in G4VisExecutive, so that it has access to use flags.
0526         Modified the informational (G4warn) in PrintAvailableGraphicsSystems()
0527         to give advice and point to further information to be given after
0528         "/vis/open".
0529       o G4VisCommandsTouchable: "/vis/touchable/dump" and "findPath" do not
0530         need a scene handler nor a viewer.
0531         Moved them to the beginning of G4VisCommandsTouchable::SetNewValue(),
0532         before the check on scene handler and viewer. This allows the user to
0533         "/vis/touchable/dump" even if he/she has not yet opened a viewer.
0534     + modeling:
0535       o G4PhysicalVolumeModel: added data field 'TotalTouchables' and access
0536         functions.
0537       o G4TextModel: use single quote (') to delineate actual text in
0538         description.
0539     + OpenGL:
0540       o In G4OpenGLQtViewer, fixed MT issue of possible dead-lock in case
0541         multiple OGLI or OGLS viewers are enabled and when issuing
0542         "/run/beamOn". Restored picking feature for Qt6 and implemented 2D
0543         draw text in DrawText().
0544       o In G4OpenGLImmediateQtViewer and G4OpenGLStoredQtViewer, removed usage
0545         of paintEvent() for Qt6, paintGL() should be sufficient.
0546         For updateQWidget, use update() to trigger a repaint.
0547         In Initialise() check validity of widget type, to avoid observed crash
0548         at startup on macOS; do the same on the ClearView(), SetView().
0549       o Make headers of implementation detail classes private.
0550     + OpenInventor:
0551       o G4OpenInventorQtViewer: in Qt6, reparent G4OpenInventorQtExaminerViewer
0552         in its own QWidget, allowing to restore correct behaviour when opening
0553         multiple viewers. Properly handle viewer destruction.
0554         Have "addInTab" done in Initialise() method. Avoid to do an examiner
0555         viewer "move/resize" in Initialise() method, as causing strange widget
0556         rendering behaviour.
0557       o In G4OpenInventorQtExaminerViewer, allow with Qt6 to map a dialog in
0558         case being closed with the mouse. Have the title window reflecting the
0559         name of the viewer. In MT mode, fixed behaviour when issuing multiple
0560         "/run/beamOn" commands within multiple viewers.
0561       o Make headers of implementation detail classes private.
0562     + Qt3D
0563       o Added missing call to fpPhysicalVolumeObjects.clear() in
0564         G4Qt3DSceneHandler::EstablishG4Qt3DQEntities(). Fixes cases of
0565         crash when opening multiple viewers with "/vis/open Qt3D".
0566       o In G4Qt3DViewer destructor, call setRootEntity(nullptr) to disconnect
0567         the G4Qt3DSceneHandler::fpQt3DScene from a viewer.
0568       o In G4Qt3DSceneHandler destructor, clear the scene tree.
0569     + ToolsGS:
0570       o Replace TOOLSSG vis driver variables that are just synonyms for more
0571         fundamental config options (e.g. GEANT4_USE_QT) with the underlying
0572         variable.
0573       o Make Freetype a private dependency in CMake script.
0574     + Vtk:
0575       o In G4VtxQtViewer, fixed MT issue of possible dead-lock in case multiple
0576         Vtk viewers are enabled and when issuing "/run/beamOn".
0577 
0578   o Datasets:
0579     ---------
0580     + G4PARTICLEXS-4.1:
0581       o Updated data for all isotopes, for neutron, proton and light ion
0582         cross-sections. Fixed cross-sections for Argon, Promethium, Astatine,
0583         Radon, Francium. Fixed low-energy cross-section; low-energy limits of
0584         cross-sections per target are verified and updated based on neutron
0585         data.
0586     + G4EMLOW-8.6:
0587       o Added new data for multi-ionisation DNA processes.
0588     + G4NUDEXLIB-1.0:
0589       o New [optional] dataset required to enable the NuDEX hadronic model
0590         (E. Mendoza et al., NIMA 1047, 167894 (2023) https://doi.org/10.1016/
0591         j.nima.2022.167894).
0592         Including: data file with general parameters used by NuDEX; data tables
0593         to get internal conversion factors, obtained from BrICC; nuclear level
0594         schemes and densities downloaded from the RIPL-3 data library; files
0595         containing primary capture gamma rays, obtained from ENSDF; photon
0596         strength function parameters, obtained from RIPL-3 and from the IAEA
0597         Photon Strength Function Database; folder to change the default
0598         parameters for the decay of specific nuclei.
0599     + G4URRPT-1.0:
0600       o New [optional] Probability Table dataset, used for the treatment of
0601         low-energy neutrons in the Unresolved Resonance Region (URR), at
0602         temperature of 293.15 K, processed with both NJOY and CALENDF.
0603         As described in: M. Zmeskal et al., Comp.Phys. arXiv:2404.16389.
0604 
0605   o Examples:
0606     --------
0607     + Updated reference outputs, macros, READMEs and scripts.
0608     + Updated URL for schema validation in all GDML files to valid short
0609       address.
0610     + Applied clang-format to basic and extended examples; addressed coding
0611       style warnings.
0612     + advanced/dsbandrepair
0613       o Use EmParameters to control chemistry time step model.
0614     + advanced/eFLASH_radiotherapy
0615       o Added FlashPhysicsListMessenger class to allow changing the physics
0616         list by macro commands (opt3, opt4, Penelope and Livermore).
0617     + basic/B3
0618       o Looping over G4THitsMap via range for loop instead of iterators.
0619     + extended/electromagnetic/TestEm0
0620       o DetectorConstruction: introduced Xenon gas.
0621       o Added new macro xenonGas.mac.
0622     + extended/electromagnetic/TestEm4
0623       o PhysicsLists: fixed annoying warnings on decay table;
0624         removed obsolete methods.
0625       o Run: code cleanup; removed Tabs.
0626     + extended/electromagnetic/TestEm5
0627       o TrackingAction: added protection against wrong argument of std::acos(),
0628         rarely happening for very high energy projectile particles.
0629       o Removed macro subcut.mac.
0630     + extended/electromagnetic/TestEm7
0631       o RunAction: added protection to histogram binning for very low step
0632         limit.
0633     + extended/electromagnetic/TestEm12
0634       o Added comments to dna.mac input macro.
0635     + extended/electromagnetic/TestEm15
0636       o SteppingAction: code cleanup; removed Tabs.
0637     + extended/eventgenerator/exgps
0638       o Updated build script for CTests definitions.
0639     + extended/eventgenerator/pythia/py8decayer
0640       o Updated to Pythia8.3.10 for testing.
0641       o Added Py8DecayerEngine to override Pythia8 native engine with the
0642         default one from Geant4 (CLHEP), to properly run in the MT/Tasking mode.
0643       o Updated main() to use MT mode; some code cleanup.
0644     + extended/exoticphysics/phonon
0645       o Updated build script for CTests definitions.
0646     + extended/field/field01
0647     + extended/field/field02
0648     + extended/field/field03
0649       o Replaced FieldSetup and FieldMessenger classes with usage of new
0650         field builder class G4FieldBuilder.
0651       o Moved setting field value (ThreeVector) from FieldSetup (now removed)
0652         in DetectorConstruction and its messenger and removed setting of
0653         Z-value only.
0654     + extended/hadronic/Hadr01
0655       o Enable usage of the NUDEX library for QGSP_BERT_HP physics in main().
0656     + extended/hadronic/Hadr03
0657       o PrimaryGeneratorAction: added tiny shift of position of the particle
0658         gun from the world volume boundary; fixing a warning now detecting this.
0659       o PhysicsList: removed G4RadioactiveDecayPhysics.
0660       o Updated fusion.mac input macro.
0661     + extended/hadronic/Hadr05
0662       o PrimaryGeneratorAction: added tiny shift of position of the particle
0663         gun from the world volume boundary; fixing a warning now detecting this.
0664       o RadioactiveDecayPhysics: added Triton.
0665       o Applied coding rules.
0666     + extended/hadronic/Hadr07
0667       o RadioactiveDecayPhysics: added Triton.
0668       o Applied coding rules.
0669     + extended/hadronic/NeutronSource
0670       o PhysicsList: added G4HadronElasticPhysicsXS.
0671       o RadioactiveDecayPhysics: added Triton.
0672       o GammaNuclearPhysics, GammaNuclearPhysicsLEND: applied coding rules.
0673     + extended/medical/dna/chem6
0674       o Use EmParameters to control chemistry models.
0675     + extended/medical/dna/dnadamage1
0676       o Fixed compilation errors on macOS/clang with C++23 enabled.
0677     + extended/medical/dna/dnaphysics
0678       o PhysicsList: switched to DNA physics constructors i/o model activator.
0679       o Added new n-tuple to collect track information.
0680       o Added plotDeexcitation.C analysis and deexcitation.in macro.
0681       o Updated comments in headers.
0682     + extended/medical/dna/mfp
0683       o Code cleanup.
0684     + extended/medical/dna/microdosimetry
0685       o Removed original content of the example; replaced by dnaphysics example.
0686       o Code simplification to demonstrate the usage of G4DNAPhysicsActivator.
0687     + extended/medical/dna/microprox
0688     + extended/medical/dna/microyz
0689       o Code cleanup.
0690     + extended/medical/dna/moleculardna
0691       o Updated /dnageom/interactionDirectRange to 2.0 angstrom.
0692     + extended/medical/dna/range
0693     + extended/medical/dna/slowing
0694       o Code cleanup.
0695     + extended/medical/dna/spower
0696       o SteppingAction: extended use for ions heavier than helium.
0697       o In spower.in input macro, added extra commands to show how to shoot
0698         ions heavier than helium.
0699       o Code cleanup.
0700     + extended/medical/dna/svalue
0701     + extended/medical/dna/wvalue
0702       o Code cleanup.
0703     + extended/medical/dna/UHDR
0704       o Updated bounce off condition based on:
0705         Karamitros M. et al.2020,arXiv:2006.14225 (2020).
0706       o Implemented PBC based on https://github.com/amentumspace/g4pbc
0707         to calculate microdosimetry
0708       o Added a maximum dose (2 times of cut-off dose) to abort the event.
0709       o Fixed compilation errors on macOS/clang with C++23 enabled, for
0710         incomplete types of smart-pointers through defaulted destructors.
0711     + extended/medical/fanoCavity
0712       o Make PhysicsLists of the example coherent with physics_list library.
0713         Fixed annoying warnings on decay table.
0714     + extended/medical/fanoCavity2
0715       o Make PhysicsLists of the example coherent with physics_list library.
0716     + extended/parallel
0717       o Removed obsolete TopC example.
0718     + extended/parallel/MPI
0719       o Updated build script for CTests definitions.
0720     + extended/parallel/ThreadsafeScorers
0721       o Removed use of no longer supported TiMemory.
0722     + extended/radioactivedecay/Activation
0723       o PhysicsList: added G4HadronElasticPhysicsXS.
0724       o RadioactiveDecayPhysics: added Triton.
0725       o GammaNuclearPhysics, GammaNuclearPhysicsLEND: applied coding rules.
0726     + extended/radioactivedecay/rdecay01
0727       o PhysicsList: set 'MeanLifeThreshold' to 1 nanosecond.
0728       o Added time windowed biasing to rdecay01.in macro.
0729       o In timeWindowBiased.mac and rdecay01.in, removed
0730         "/process/had/rdm/BRbias".
0731     + extended/runAndEvent/RE07
0732       o Fixed compilation warnings for potentially initialised local variable
0733         in EmStandardPhysicsTrackingManager::PostStepDoIt().
0734     + extended/visualization/standalone
0735       o A smarter way of getting extent of geometry that ignores invisible
0736         volumes. Thus, if the world is marked invisible, it ignores it.
0737       o In DrawGeometryVisAction: use G4PhysicalVolumeModel to determine extent.
0738 
0739  ----------------------------------------------------------------------------
0740