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