v4.2.0

This new release adds compability with Geant4 v11.3.2 and QT6.

New

• Build agains Geant4 v11.3.2. Requires updated Geant4 data files.
• Supports QT6. Introduced two required parameters to build against QT5 or QT6 during cmake configuration
  • For QT6 append: -DTOPAS_USE_QT=ON -DTOPAS_USE_QT6=ON
  • For QT5 append: -DTOPAS_USE_QT=ON -DTOPAS_USE_QT6=OFF
  • The Docker image is built with QT5 to allow compatibility with XQuartz on macOS
• New QT interface features include:
  • Duplication of geometries, and geometry trees.
  • New parameters are now dumped in a txt file per category
  • For users' extensions, it is now included logic to detect pre-define user-defined geometry-component parameters for the QT interface
• New option to visualize electric fields

Fixes

• Fix missing include for <array> in TsMagneticFieldMap.cc and TsElectricFieldMap.cc
• Update TsVBinnedScorer.cc to fix time penalty when reporting Standard_Deviation. A new map is introduced to track zero-contributing histories. This has a small penalty in RAM but improves speed by c.a 5x
• Fix GeometricalParticleSplit to avoid division by zero during pre/post weight calculation
• Fix FilterByRTStructures so it now works when Ts/RestoreResultsFromFile is enabled

Changes in parameter naming

• b:Ts/ShowCPUTime = "True" by default.
• Removed the prefix "Beam" for parameters that define particle name, energy, energy spread and spectrum now take as a prefix the source type. E.g., an isotropic source's energy is defined as.
  • s:So/<source>/IsotropicEnergy = 10 MeV
    TOPAS is still compatible with "BeamEnergy", etc.
• New parameter s:Ge//DicomRTStructFile so one can point a TsDicomPatient to a specific DICOM-RTStruct file

Changes in accuracy

• This release passed our comprehensive regression test system. Due to a major Geant4 upgrade, it is expected that there will be changes in scored quantities resulting from the Geant4 version. In particular, the newest version uses updated neutron/gamma evaluated data cross sections. Then, it is expected that some changes in the yield from those particles will occur. We recommend testing accuracy against measured data when using hadronic processes.

v4.1.1

A new patch is available with the following items

Bugs and fixes:

• Fixes a mismatch between binary/CSV save/restore feature. The bug exists because the CSV
  code for saving/restoring never mirrors the reverse iteration logic that the binary path
  uses. The nested loop order is set to [for (k, j, i)]
• Fixes a bug that prohibited using FilterByRTStructures when Ts/RestoreResultsFromFile was used.
• Code clean up for unused lines
• Update TOPAS version to v4.1.1

New features

• New executable scripts for using Docker images with Apptainer compatibility. The documentation can be found in ./docker subdirectory in OpenTOPAS/: topas-docker topas-apptainer
• b:Ts/ShowCPUTime is active by default
• The order of bining for output/input CSV and Binary runs as for [k, j, i]

v4.1.0

New features

• Update TsModularPhysicsList.cc to include other chemistry options
• Add option to visualize electric fields
• Add classes for including mapped electric fields in a simulation.
• Add the value "MagneticFieldMap" as an equivalent key to "MappedMagnet" for geometry component field assignation.
• Add CSV and Opera3D format compatibility for mapped magnetic fields
• Add Periodic Boundary Condition physical process and new example
• Update ci.yml for continuous tests after commits

Bugs

• Fix comparison between long int and double when performing history checks of phase space reading, issue #168
• Patch typo in g4tools, set CMake version to avoid GDCM problems
• Fixes error in Sum when reported with Mean simultaneously, issue #66

Admin

• Removing generator and sources as this will rely on an extension
• Adding geometry and primaries to the corresponding managers
• Only runs CI for source code changes. See issue #41
• Use virtual python environment following pip error message

Installation issues

• Fixed WSL quickStart image visualisation
• Environment setup for each OS change when workflow is run
• gdcm_dir back in looking at rpath
• print libraries in Frameworks folder

v4.0.0

Compatible with Geant4 11.1.3