ReleaseNotes.md

# v01-30

* 2024-08-25 Andre Sailer ([PR#1317](https://github.com/aidasoft/dd4hep/pull/1317))
  - DDSim: regexSD fix infinite loop, but change the interface from assignment to dictionary entries. Have to ensure only a single entry of a detector is given to the RegexSD

* 2024-08-15 Sanghyun Ko ([PR#1315](https://github.com/aidasoft/dd4hep/pull/1315))
  - DDSim: prevent Geometry.regexSensitiveDetector from always throwing exception when called with argument.

* 2024-08-13 Andre Sailer ([PR#1312](https://github.com/aidasoft/dd4hep/pull/1312))
  - GitlabCI: drop Flake check, since we have that on github as well

* 2024-08-12 Andre Sailer ([PR#1310](https://github.com/aidasoft/dd4hep/pull/1310))
  - GitlabCI: Use an el9 container to build documentation for the webpage

* 2024-08-12 Andre Sailer ([PR#1309](https://github.com/aidasoft/dd4hep/pull/1309))
  - CLICSiD AClick tests: avoid running in parallel, tests might break

* 2024-08-12 Andre Sailer ([PR#1308](https://github.com/aidasoft/dd4hep/pull/1308))
  - Geant4RegexSensitivesConstruction: allow using regex that don't match the full volume path, reduce time by 40% or so
  - DDSim: add interface for Geant4RegexSensitivesConstruction to geometry construction

* 2024-07-30 Leonhard Reichenbach ([PR#1303](https://github.com/aidasoft/dd4hep/pull/1303))
  - Added a Geant4TVUserParticleHandler that can utilise an arbitrary tracking volume as introduced in https://github.com/AIDASoft/DD4hep/pull/384

* 2024-07-24 ybedfer ([PR#1294](https://github.com/aidasoft/dd4hep/pull/1294))
  - Adding a "CylindricalGridPhiZ" segmentation class.
     - N.B.: the class has a "radius" data member, registered by the constructors.

* 2024-07-22 Markus Frank ([PR#1301](https://github.com/aidasoft/dd4hep/pull/1301))
  - See issue https://github.com/AIDASoft/DD4hep/issues/1292 and PR https://github.com/AIDASoft/DD4hep/pull/1293 , fix crash when action dictionary not hashable.

* 2024-07-22 Andre Sailer ([PR#1299](https://github.com/aidasoft/dd4hep/pull/1299))
  - CI: use alma9 stack for python lint check
  - CI: move key4hep stack to alma9

* 2024-07-22 Sanghyun Ko ([PR#1298](https://github.com/aidasoft/dd4hep/pull/1298))
  - Geant4Converter: Improve lookup speed of `GeoHandler::i_collect` by using `std::set` instead of `std::find` (issue #1291)

* 2024-07-06 jmcarcell ([PR#1290](https://github.com/aidasoft/dd4hep/pull/1290))
  - Add the missing header unistd.h in a file to find `::open` and `::close`
  - Fix a few warnings about unused variables or shadowing
  - Add .cache and compile_commands.json to .gitignore

* 2024-07-05 Markus Frank ([PR#1289](https://github.com/aidasoft/dd4hep/pull/1289))
  * Add RegexSD example for illustration: See https://github.com/AIDASoft/DD4hep/pull/1288

* 2024-07-05 Markus Frank ([PR#1288](https://github.com/aidasoft/dd4hep/pull/1288))
  - As reported in this issue https://github.com/AIDASoft/DD4hep/issues/1285 under certain circumstances the memory usage of DDG4 goes through the roof. This was traced back to the creation of excessive maps in the `Geant4VolumeManager`, if the number of sensitive pathes is very high like e.g. for straw detectors.
  - To solve the problem, geometry constructors may not declare any sensitive volumes. Hence the `Geant4VolumeManager` will not be populated. To still make Geant4 functioning, the sensitive volumes may be declared a posterior after conversion using regular expressions as implemented in the class `Geant4RegexSensitivesConstruction`. This class is only an example how such functionality may be achieved: other solutions are possible as well. This functionality can be switched at the level of each subdetector participating in the experiment setup.
  - To illustrate, an example detector `BoxOfStraws` was constructed with a flag in the xml description:

  ```
      <detector id="1" name="BoxOfStrawsDet" type="DD4hep_BoxOfStraws" readout="BoxOfStrawsHits" vis="VisibleGreen" region="StrawRegion" limits="BoxOfStrawsLimitSet">
        <box      x="1*m"    y="1*m" z="1000*mm"  limits="BoxOfStrawsLimitSet" vis="VisibleRed"/>
        <straw rmax="0.5*mm" y="1*m" thickness="0.1*mm" vis="VisibleBlue">
          <material name="Iron"/>
        </straw>
        <gas vis="VisibleGreen">
          <material name="Argon"/>
          <non_sensitive/>
        </gas>
        <position x="0*m"   y="0*m"   z="0*m"/>
        <rotation x="0"     y="0"     z="0"/>
      </detector>
  ```

  Change `<non_sensitive/>` to `<sensitive/>` and the different behavor of memory allocation when starting Geant4 can be observed.
  The corresponding Geant4 python script can be found here:

  ```
  <DD4hep>/examples/ClientTests/scripts/BoxOfStraws.py
  ```

  The memory consumption differs then as follows (depending on the thickness of the straws, which determine the number of sensitive pathes):

  ```
  With explicit sensitive volumes:   
  before Geant4VolumeManager:    Virtual: 903.3m   resident: 690.5m
  after Geant4VolumeManager:     Virtual: 1848.2m  resident: 1.6g   
  
  
  With Sensitives matching regex and not sensitive volumes declared:
  before Geant4VolumeManager:    Virtual: 903.3m   Resident: 690.6m 
  after Geant4VolumeManager:     Virtual: 903.3m   Resident: 690.6m 
  Simulating:                    Virtual: 903.5m   Resident: 692.6m 
  ```

  Hence this is a possibility to significantly reduce memory consumption for highly granular subdetectors.

* 2024-07-01 Markus Frank ([PR#1287](https://github.com/aidasoft/dd4hep/pull/1287))
  - As noted by Ben, the global alignment does not work in the presence of assemblies.
    This PR together with https://github.com/root-project/root/pull/15905 fixes this deficiency.
  - An example was added to convert a globally misaligned geometry to Geant4:
    ` $ python examples/AlignDet/scripts/AlephTPC.py -batch -events 5 -alignments examples/AlignDet/compact/AlephTPC_alignment.xml`

* 2024-07-01 jmcarcell ([PR#1286](https://github.com/aidasoft/dd4hep/pull/1286))
  - Fix warnings related to unused variables and shadowing of already existing variables
  - Don't use the deprecated `PySys_SetArgv`

* 2024-06-26 Andre Sailer ([PR#1284](https://github.com/aidasoft/dd4hep/pull/1284))
  - DDG4.inputHandling: do not simulate rejectPDG particles even if they are called stable by the generator file, fixes #1282

* 2024-06-26 Andre Sailer ([PR#1283](https://github.com/aidasoft/dd4hep/pull/1283))
  - DDSim: Do not check for existence of files behind a URL like root://, fixes #1281

* 2024-06-24 jmcarcell ([PR#1280](https://github.com/aidasoft/dd4hep/pull/1280))
  - CMake: Allow finding version 1.0 (and newer) for podio

* 2024-06-21 Markus Frank ([PR#1279](https://github.com/aidasoft/dd4hep/pull/1279))
  - The conquest against tainted variables in coverity

* 2024-06-20 Markus Frank ([PR#1278](https://github.com/aidasoft/dd4hep/pull/1278))
  - Fight coverity tainted variables.

# v01-29

* 2024-06-06 Andre Sailer ([PR#1277](https://github.com/aidasoft/DD4hep/pull/1277))
  - Geant4Converter: fix the order of the TGeoNode conversion to Geant4 volumes, using vector instead of set. Maybe fixes #1271

* 2024-05-26 Andre Sailer ([PR#1276](https://github.com/aidasoft/DD4hep/pull/1276))
  - XMLElements: fix build when not using XercesC, failing to include header files

* 2024-05-23 Markus Frank ([PR#1275](https://github.com/aidasoft/DD4hep/pull/1275))
  - The battle agains coverity
  - The last defects I know how to solve. For the rest more expertise is required.

* 2024-05-23 MarkusFrankATcernch ([PR#1274](https://github.com/aidasoft/DD4hep/pull/1274))
  - Allow coverity scans being started manually

* 2024-05-23 Markus Frank ([PR#1272](https://github.com/aidasoft/DD4hep/pull/1272))
  - The battle agains coverity. Try to fix various defects.

* 2024-05-22 Markus Frank ([PR#1270](https://github.com/aidasoft/DD4hep/pull/1270))
  - The battle agains coverity: Attack and reduce coverity errors

* 2024-05-22 Markus Frank ([PR#1269](https://github.com/aidasoft/DD4hep/pull/1269))
  - Code maintenance: change quoted include statements to angular brackets in subpackage DDG4.

* 2024-05-22 Markus Frank ([PR#1268](https://github.com/aidasoft/DD4hep/pull/1268))
  Code maintenance: 
  - change quoted include statements in DDCore to angular brackets
  - Add the odd licence statement
  - Remove obsolete file DD4hep/TGeoUnits.h: Take TGeoUnits from ROOT if needed. 
    This file dates back to the time TGeoUnits.h did not exist in ROOT.

* 2024-05-21 Markus Frank ([PR#1267](https://github.com/aidasoft/DD4hep/pull/1267))
  - Try to eliminate more coverity code deficiencies
   (See https://scan.coverity.com/projects/dd4hep?tab=overview)

* 2024-05-16 Andre Sailer ([PR#1266](https://github.com/aidasoft/DD4hep/pull/1266))
  - DDSim: make setupUserFunction be documented in the steering file
  - Fix random typos in comments and doxygen strings
  - Geant4Handle: Fix error message when plugin casting did not succeed

* 2024-05-16 Markus Frank ([PR#1265](https://github.com/aidasoft/DD4hep/pull/1265))
  - Fix some coverity problems

* 2024-05-16 tmadlener ([PR#1264](https://github.com/aidasoft/DD4hep/pull/1264))
  - EDM4hepOUTPUT: Introduce pre-processor checks to transparently switch to the new `std::optional` return values of `podio::Frame::getParameter` (introduced with [AIDASoft/podio#580](https://github.com/AIDASoft/podio/pull/580))

* 2024-05-16 Thomas Latham ([PR#1263](https://github.com/aidasoft/DD4hep/pull/1263))
  - Enhance handling of transformations in VolumeBuilder

* 2024-05-15 Markus Frank ([PR#1262](https://github.com/aidasoft/DD4hep/pull/1262))
  - Add optional instantiation of the G4ScoringManager together with the G4RunManager.
    The instantiation can be steered by option to the Geant4Kernel:
  ```
  import DDG4
  g4 = DDG4.Geant4()
  g4.kernel().HaveScoringManager = True
  ```
  For rational, please see issue: https://github.com/AIDASoft/DD4hep/issues/1261

* 2024-05-13 Alvaro Tolosa Delgado ([PR#1253](https://github.com/aidasoft/DD4hep/pull/1253))
  - DDRec/DCH_info.h: Add data extension class for FCCee Drift Chamber. This class provides data storage and ancillary functionalities needed to build the geometry.

* 2024-05-10 Andre Sailer ([PR#1260](https://github.com/aidasoft/DD4hep/pull/1260))
  - DDG4/DDSim: allow configuring of the unstable generator status codes with SIM.physics.alternativeDecayStatuses. This allows one to tweak which particles are passed to the Geant4 simulation. Fixes #1256 
  - DDG4: Geant4InputAction: move setting of generator status bits to a common place, reduce code duplication.

* 2024-05-07 Markus Frank ([PR#1259](https://github.com/aidasoft/DD4hep/pull/1259))
  - Protect Geant4 Primary creation against negative masses.
  - See issue https://github.com/AIDASoft/DD4hep/issues/1233 for a detailed discussion of the problem.
  - Allow shapes to be defined recursively using shape creation plugin.
  - Show how to properly use CAD shapes with a non-zero origin (Issue : https://github.com/AIDASoft/DD4hep/issues/1200)
     examples/DDCAD/compact/DD4hep_Issue_1134_resolved.xml
     Once the CAD shape (aka volume) is placed correctly into the origin of a mother mother, the mother can then be placed 
     rotated and shifted according to the the boxed mother's origin like any other volume.

* 2024-05-07 Andre Sailer ([PR#1258](https://github.com/aidasoft/DD4hep/pull/1258))
  - DDSim: correct the number of events when running over all events (-1), fixes #1257 
  - GenerationActionInit: declare properties to access number of processed runs (numberOfRuns) and events (numberOfEVents)
  - DDG4: decode or eval all properties out of str or cppyy.gbl.string types

* 2024-04-23 Andre Sailer ([PR#1255](https://github.com/aidasoft/DD4hep/pull/1255))
  - Geant4GFlashShowerModel: remove wrong unit conversions from particleBound properties. Caused particle bounds to be off by 1e3 when GEANT_UNITS were enabled.

* 2024-04-22 tmadlener ([PR#1252](https://github.com/aidasoft/DD4hep/pull/1252))
  - DDDigiEDM4hep: Switch to the correct podio pre-processor version checks for switching to the non-deprecated readers / writers. Also simplify this such that choosing which type(name) to use is handled in one place rather than several.
  - Geant4Output2EDM4hep: Switch to a non-deprecated setter for setting the MCParticle for a SimTrackerHit once EDM4hep ships with it.

* 2024-04-19 Andre Sailer ([PR#1254](https://github.com/aidasoft/DD4hep/pull/1254))
  - CMake: drop possible use of ROOT::PyROOT target, always use ROOT::ROOTTPython
  - Python: remove the use of (dd)six, fix issues pointed out by new version of flake8

* 2024-04-18 Andre Sailer ([PR#1242](https://github.com/aidasoft/DD4hep/pull/1242))
  - CI: change which LCG_releases/ROOT versions DD4hep is tested.
  - Fix various issues with latest version of ROOT (6-32-patches, master) and cppyy in ROOT.
     - :warning: : You may encounter issues with python setup complaining about mismatched types, strings, conversions

* 2024-04-04 Andre Sailer ([PR#1251](https://github.com/aidasoft/DD4hep/pull/1251))
  - EDM4hepOutput: determine momentum vector type automagically. Make it work with any EDM4hep version correctly, fixes #1250

* 2024-04-02 Andre Sailer ([PR#1248](https://github.com/aidasoft/DD4hep/pull/1248))
  - ddsim now exits with non-zero exit code when something went wrong during simulation

* 2024-04-02 Wouter Deconinck ([PR#1245](https://github.com/aidasoft/DD4hep/pull/1245))
  - fix adding individual planes to existing Polycone

* 2024-03-26 Andre Sailer ([PR#1247](https://github.com/aidasoft/DD4hep/pull/1247))
  - DDSim: add checks that input files and compact files exist before doing anything extensive and provide proper error message. Fixes #1246

* 2024-03-21 Markus Frank ([PR#1244](https://github.com/aidasoft/DD4hep/pull/1244))
  * The build type flag was lost when including files from compact. This PR fixes this deficiency and ensures the flag propagation. Example:  'box_shape_build_type'

* 2024-03-20 Alvaro Tolosa Delgado ([PR#1243](https://github.com/aidasoft/DD4hep/pull/1243))
  - Fixed TwistedTube when only half-length is provided, making the tube is symmetric along Z axis

* 2024-03-13 Andre Sailer ([PR#1241](https://github.com/aidasoft/DD4hep/pull/1241))
  - CMake: dd4hep_add_dictionary: use temporary files to create dictionary to allow dependencies to use COMPILE_LANGUAGE, fixes #1239 . Add USE_COMMAND_TO_GENERATE option to fall back to previous implementation
  - CMake: dd4hep_add_dictionary: remove duplicates from definition and include_directory options when calling rootcling

* 2024-02-29 Markus Frank ([PR#1238](https://github.com/aidasoft/DD4hep/pull/1238))
  - Adapt documentation for Tube(...) constructor to reality.
    See issue https://github.com/AIDASoft/DD4hep/issues/1236

# v01-28

* 2024-02-19 Markus Frank ([PR#1228](https://github.com/aidasoft/dd4hep/pull/1228))
  - Fix DD4hep_DetectorDump plugin to avoid crash if a DetElement placement is invalid,
     which is not allowed, but also should not end up in a crash.
  - Add test to check if DetElements have proper placement set using MiniTel example
    (see examples/ClientTests/compact/MiniTel_err_place.xml) and
    test MiniTel_check_missing_placements
  - The fake DD4hep object TwistedTube  did not correctly emulate the different constructors when converted
    to Geant4. This should be fixed with this PR.

* 2024-02-16 Andre Sailer ([PR#1231](https://github.com/aidasoft/dd4hep/pull/1231))
  - CMake: use the LCIO::lcio target instead of LCIO::LCIO

* 2024-02-15 Andre Sailer ([PR#1230](https://github.com/aidasoft/dd4hep/pull/1230))
  - XML: add missing std:: when building with TinyXML
  - DetectorSurfaces: silence printout when creating SurfaceList, fixes #1229

* 2024-02-13 Wouter Deconinck ([PR#1225](https://github.com/aidasoft/dd4hep/pull/1225))
  - upgrade CI to checkout@v4, cvmfs@v4, upload-artifact@v4

* 2024-02-12 Alvaro Tolosa Delgado ([PR#1227](https://github.com/aidasoft/dd4hep/pull/1227))
  - Twisted tube: twisted angle unit conversion now works properly

* 2024-02-12 Markus Frank ([PR#1226](https://github.com/aidasoft/dd4hep/pull/1226))
  Multiple commits. Most important one (on user request):
  - Implement CONST properties to optical sufaces. (Requires new release of ROOT)
    See issue: https://github.com/AIDASoft/DD4hep/issues/1223
  
  Otherwise:
  - Remove support for very old versions of ROOT < 6.10.0
  - Remove support for very old versions of ROOT < 6.26.0. 
  - Remove default use of std namespace from most implementation files.

* 2024-02-12 Wouter Deconinck ([PR#1218](https://github.com/aidasoft/dd4hep/pull/1218))
  - add command line options to pass stepping (etc) action plugins to ddsim

* 2024-02-08 tmadlener ([PR#1219](https://github.com/aidasoft/dd4hep/pull/1219))
  - Make the upcoming renaming of `edm4hep::TrackerHit` to `edm4hep::TrackerHit3D` (https://github.com/key4hep/EDM4hep/pull/252) transparent as far as DD4hep is concerned.

* 2024-02-07 jmcarcell ([PR#1221](https://github.com/aidasoft/dd4hep/pull/1221))
  - Change ROOTFrame{Writer,Reader} to ROOT{Writer,Reader} following https://github.com/AIDASoft/podio/pull/549

* 2024-02-02 tmadlener ([PR#1198](https://github.com/aidasoft/dd4hep/pull/1198))
  - Set the momenta of the `edm4hep::MCParticle` as double instead of float once it becomes possible.

* 2024-01-18 Markus Frank ([PR#1217](https://github.com/aidasoft/dd4hep/pull/1217))
  - Enable energy deposit collection in FiberTubeCalorimeter example.

* 2024-01-18 Markus Frank ([PR#1216](https://github.com/aidasoft/dd4hep/pull/1216))
  - Update FiberTubeCalorimeter example
  - Fix overlapping volumes

* 2024-01-17 Markus Frank ([PR#1215](https://github.com/aidasoft/dd4hep/pull/1215))
  - Fix creation of tessellated shapes from CAD files.
  -  Properly hand quadri-linear facets from CAD files.
  -  See also: https://github.com/root-project/root/pull/14327
  -  See also: https://github.com/AIDASoft/DD4hep/pull/1212

* 2024-01-16 Markus Frank ([PR#1214](https://github.com/aidasoft/dd4hep/pull/1214))
  - Fix to MR https://github.com/AIDASoft/DD4hep/pull/1212

* 2024-01-15 Markus Frank ([PR#1213](https://github.com/aidasoft/dd4hep/pull/1213))
  - Adapt material scan to be aware of the different compilation modes for TGeo units and Geant4 units.
    See also issue https://github.com/AIDASoft/DD4hep/issues/1163.

* 2024-01-15 Andre Sailer ([PR#1212](https://github.com/aidasoft/dd4hep/pull/1212))
  - Assimp: adapt to changes in TGeoTessellated for ROOT 6.32
  - ShapeUtilities: adapt to changes in TGeoTessellated for ROOT 6.32

* 2024-01-12 Markus Frank ([PR#1211](https://github.com/aidasoft/dd4hep/pull/1211))
  - Implement required chnges for new ROOT 6.31.X.
    See issue https://github.com/AIDASoft/DD4hep/issues/1210 for details.

* 2024-01-08 Markus Frank ([PR#1209](https://github.com/aidasoft/dd4hep/pull/1209))
  - Restore behavior of teveDisplay. See issue https://github.com/AIDASoft/DD4hep/issues/1208 for details.

* 2023-12-19 Andre Sailer ([PR#1206](https://github.com/aidasoft/dd4hep/pull/1206))
  - CI: Coverity: use el9 based stack

# v01-27-02

* 2023-12-15 Andre Sailer ([PR#1205](https://github.com/aidasoft/dd4hep/pull/1205))
  - Geant4PrimaryHandling: fix issue with multiple vertices in Geant4 GeneralParticleSource, fixes #1204

* 2023-12-14 Markus Frank ([PR#1201](https://github.com/aidasoft/dd4hep/pull/1201))
  - Incorporate type fix from https://github.com/AIDASoft/DD4hep/pull/1172
  - Propagate polish setting from ROOT surfaces to Geant4
  - Improve debugging capabilities of detector checksums by improved dumping possibilities.

* 2023-12-14 Andre Sailer ([PR#1196](https://github.com/aidasoft/dd4hep/pull/1196))
  - NestedBoxReflection_geo.cpp: use std::abs instead of abs
  - HexGrid: use std::abs instead of abs
  - DDSim: better logging of which sensitive detector is used when defaults are used

* 2023-12-14 Paul Gessinger ([PR#1195](https://github.com/aidasoft/dd4hep/pull/1195))
  - Replace usage of the `imp` module that was removed in Python 3.12 with `importlib` and `types`.

* 2023-11-24 Andre Sailer ([PR#1192](https://github.com/aidasoft/dd4hep/pull/1192))
  - DetectorChecksum: use fabs to check if values are 0.0, fixes  #1188

# v01-27-01

* 2023-11-20 jmcarcell ([PR#1191](https://github.com/aidasoft/DD4hep/pull/1191))
  - CMake: Add a check for the c++ standard that Geant4 was compiled with, and fail if it is
    different from the one required for DD4hep.

* 2023-11-19 Wouter Deconinck ([PR#1190](https://github.com/aidasoft/DD4hep/pull/1190))
  - Use TROOT::GetIconPath to find icons in DDEve

* 2023-11-17 Markus Frank ([PR#1187](https://github.com/aidasoft/DD4hep/pull/1187))
  - Implement startup flags to set the visualization depth in teveDisplay like for geoDisplay.
    See  Issue: See deeper hierarchy in teveDisplay  https://github.com/AIDASoft/DD4hep/issues/1186 for details.

* 2023-11-17 Dmitry Kalinkin ([PR#1184](https://github.com/aidasoft/DD4hep/pull/1184))
  - Fixed runtime issues during initialization caused by incorrectly placed `DECLARE_SEGMENTATION` for CartesianGridXYStaggered and HexGrid.

# v01-27

* 2023-10-19 Alvaro Tolosa Delgado ([PR#1174](https://github.com/aidasoft/dd4hep/pull/1174))
  - Geant4OpticalTracker: Kill optical photons (instead of all other particles) as soon they enter into a Optical Tracker sensitive detector

* 2023-10-19 Wouter Deconinck ([PR#1148](https://github.com/aidasoft/dd4hep/pull/1148))
  - Allow several DDRec c'tors to work on `const Detector&` instead of `Detector&`

* 2023-10-18 Markus Frank ([PR#1181](https://github.com/aidasoft/dd4hep/pull/1181))
  Allow for XML processing of files relative to xml tag location:
  - For some tags the relative placement of include files was not possible.
    This pull request is supposed to close these missing include features.
  - See issue https://github.com/AIDASoft/DD4hep/issues/1180 for details)
  - See the examples ClientTests: minitel_config_plugins_include_command_xml
    with the compact file ClientTests/compact/IncludePlugins.xml for an example.

* 2023-10-17 Alvaro Tolosa Delgado ([PR#1179](https://github.com/aidasoft/dd4hep/pull/1179))
  - DDSim: Corrected documentation of `--gun.energy`. This corresponds to the total energy including the mass of the particle

* 2023-10-11 Andre Sailer ([PR#1176](https://github.com/aidasoft/dd4hep/pull/1176))
  - DDG4: G4VTouchable: for Geant4 11.1.ref09 cannot forward declare the class any more

* 2023-10-11 Markus Frank ([PR#1175](https://github.com/aidasoft/dd4hep/pull/1175))
  - Handle request from issue 1166: Allow to load CAD files with relative path w/r to declaring xml file 
  - Add illustrating example: t_DDCAD_Check_Shape_RelativePath

* 2023-09-20 Dhevan Gangadharan ([PR#1170](https://github.com/aidasoft/dd4hep/pull/1170))
  - Extend usage of dumpBfield to asymmetric X,Y,Z ranges.

* 2023-09-20 Sebouh Paul ([PR#1161](https://github.com/aidasoft/dd4hep/pull/1161))
  - DDSegmentation: added segmentation HexGrid for hexagonal segmentation
  - DDSegmentation: added CartesionGridXYStaggered for rectangular segmentation that can be staggered for every other layer

* 2023-09-19 Dmitry Kalinkin ([PR#1171](https://github.com/aidasoft/dd4hep/pull/1171))


* 2023-09-15 jmcarcell ([PR#1169](https://github.com/aidasoft/dd4hep/pull/1169))
  - CMake: DDG4: Check if the CLHEP target exists before creating it in DD4hepBuild.cmake, since if it exists cmake will error.

* 2023-09-15 Wouter Deconinck ([PR#1168](https://github.com/aidasoft/dd4hep/pull/1168))
  - ddsim: handle run header exception when the user has no username.

* 2023-08-31 Dmitry Kalinkin ([PR#1165](https://github.com/aidasoft/dd4hep/pull/1165))
  - DDG4: HepMC3Input: Fix loading of run info for RootTree HepMC3 input format

* 2023-08-25 Andre Sailer ([PR#1162](https://github.com/aidasoft/dd4hep/pull/1162))
  - DDEve Webdisplay: fix issue with ROOT master with RGeomViewer no longer being in the experimental namespace.

* 2023-08-24 Andre Sailer ([PR#1160](https://github.com/aidasoft/dd4hep/pull/1160))
  - SiliconBlockGFlash: add maximal energy for using parametrisation, for electron and positron, fixes #1153

* 2023-08-24 Markus Frank ([PR#1155](https://github.com/aidasoft/dd4hep/pull/1155))
  - Implement correct transparency handling of ROOT:
    The transparency setting was connected to the material of the volume.
    This led to the same transparency setting for all volumes of the same material.
    It was not possible to change them at the level of the volume though 
    the API  suggested so.
    See: https://github.com/AIDASoft/DD4hep/issues/1117
    See: https://github.com/root-project/root/pull/13402
  - Add test examples/ClientTests/compact/visTestEx.xml and visTest.xml.
    From the inversion of tubes with the same material, for ROOT >= 6.29
    the correct transparency settings are shown, whereas for ROOT < 6.29
    the transparency settings are the same for all volumes.
    Also see scripts/visTest.C

* 2023-08-23 Ben Couturier ([PR#1159](https://github.com/aidasoft/dd4hep/pull/1159))
  - Improved _getEnviron to deal with the case when multiple variables are to be evaluated in the string

* 2023-08-22 Dmitry Kalinkin ([PR#1158](https://github.com/aidasoft/dd4hep/pull/1158))
  - DDSim: Fix reading HepMC3 input files via xrootd, fixes #1156

* 2023-08-22 Wouter Deconinck ([PR#1157](https://github.com/aidasoft/dd4hep/pull/1157))
  - Geant4Output2EDM4hep: allow use of identical collection names across multiple detectors

* 2023-08-04 Andre Sailer ([PR#1152](https://github.com/aidasoft/dd4hep/pull/1152))
  - CI: use clang16 for header guards check

* 2023-08-04 jmcarcell ([PR#1151](https://github.com/aidasoft/dd4hep/pull/1151))
  - Limits object: fix string creation of Limit::toString, this will now also print the relevant "particles"
  - Shapes: remove "move" from return of dimensions()

# v01-26

* 2023-07-24 Andre Sailer ([PR#1147](https://github.com/aidasoft/DD4hep/pull/1147))
  - Add reading of HepMC3 run info and forwarding it to output files: fixes #1114. Reliably this will only work for HepMC3 >= 3.2.6.

* 2023-07-18 Markus Frank ([PR#1146](https://github.com/aidasoft/DD4hep/pull/1146))
  - By default do not keep hash string for detector checksum to minimize resource usage.
   As pointed out in Issue https://github.com/AIDASoft/DD4hep/issues/1143 keeping the hash string of detector
    components  is very often too resource/memory consuming. Hence keep the hashed strings only if requested
    e.g. for debugging purposes. By default the hash strings are not kept.
  This means the produces hash sums are NOT backwards compatible, because during the checksum creation the
  hash strings from sub-components were used. These are now consequently replaced by the corresponding hash codes.

* 2023-07-18 Andre Sailer ([PR#1145](https://github.com/aidasoft/DD4hep/pull/1145))
  - DDSim: ConfigHelper: prevent using unknown properties everywhere but in Meta, where we want to allow adding arbitrary information, fixes #1072

* 2023-07-17 Andre Sailer ([PR#1144](https://github.com/aidasoft/DD4hep/pull/1144))
  - DDSim: change the default output file name on how DD4hep was built. Fixes #1101 
     - Add outputConfig.forceLCIO, outputConfig.forceEDM4HEP, outputConfig.forceDD4HEP switches to force a particular output plugin
     - If LCIO was used, slcio is still the default
     - If EDM4hep was used but not LCIO, EDM4hep is the default and used for all root output files. 
     - If neither LCIO or EDM4hep was used, then DD4hep's root output is used. Use the outputConfig.forceDD4HEP flag to use DD4hep's root output if EDM4hep is available as well
  
  - DDSim: remove python2 legacy shims
  - Geant4UIManager: fail when pre or post run commands are not successfully executed.

* 2023-07-14 Andre Sailer ([PR#1142](https://github.com/aidasoft/DD4hep/pull/1142))
  - DDSim: add the possibility to configure execution of Geant4 UI commands during the different Geant4 UI phases (fixes #1010)

* 2023-07-13 Wouter Deconinck ([PR#1141](https://github.com/aidasoft/DD4hep/pull/1141))
  - Support TGeoTessellated volumes in DetectorChecksum

* 2023-07-13 tmadlener ([PR#1140](https://github.com/aidasoft/DD4hep/pull/1140))
  - Create a separate `metadata` Frame in the edm4hep output and put the `CellIDEncoding` strings there in order to follow the new convention for this introduced by key4hep/k4FWCore#100.

* 2023-06-24 Markus Frank ([PR#1139](https://github.com/aidasoft/DD4hep/pull/1139))
  - Add test for issue #1134

* 2023-06-23 tmadlener ([PR#1138](https://github.com/aidasoft/DD4hep/pull/1138))
  - Make the default return value of `DetElementCreator::process` non-zero to avoid erroneously raising an exception after finishing. 
  - Add a test case that checks that things work

* 2023-06-22 Markus Frank ([PR#1136](https://github.com/aidasoft/DD4hep/pull/1136))
  - Adds missing parts to: https://github.com/AIDASoft/DD4hep/pull/1135
  - Enable CLICSiD GDML exports and import tests and fix the broken import test.

* 2023-06-22 Andre Sailer ([PR#1133](https://github.com/aidasoft/DD4hep/pull/1133))
  - DDSim: OutputConfig: correct the example to be valid python in all cases.

* 2023-06-21 tmadlener ([PR#1132](https://github.com/aidasoft/DD4hep/pull/1132))
  - Add conversion from of `TGeoPara` to `G4Para`

* 2023-06-16 Markus Frank ([PR#1131](https://github.com/aidasoft/DD4hep/pull/1131))
  - Fix compile error on MacOS
    See issue https://github.com/AIDASoft/DD4hep/issues/1130

* 2023-06-14 Wouter Deconinck ([PR#1129](https://github.com/aidasoft/DD4hep/pull/1129))
  - fix: exit(0) when --dumpParameter/dumpSteeringFile

* 2023-06-13 Markus Frank ([PR#1128](https://github.com/aidasoft/DD4hep/pull/1128))
  - Move DDDigi edm4hep I/O to new frame writing.
  - Improve DDG4 edm4hep I/O (remove debug statements)
  - Protect DDDigi edm4hep output against races
  - Fix some compiler warnings

* 2023-06-12 Wouter Deconinck ([PR#1108](https://github.com/aidasoft/DD4hep/pull/1108))
  - Delay writing EDM4hep collections until `commit` at end of event, allowing for multiple collections with same name

* 2023-06-09 Markus Frank ([PR#1125](https://github.com/aidasoft/DD4hep/pull/1125))
  - Define the CellID and the VolumeID data types of segmentations as uint64_t rather than signed integers.
    Reasoning: Please see issue: 1090 (https://github.com/AIDASoft/DD4hep/issues/1090)

* 2023-06-09 tmadlener ([PR#1113](https://github.com/aidasoft/DD4hep/pull/1113))
  - Remove the copy&past `DigiFrame.h` and use the upstream `podio/Frame.h` as all functionality is available from there.
  - Increase the minimum podio version to 0.16.3

* 2023-06-09 tmadlener ([PR#1112](https://github.com/aidasoft/DD4hep/pull/1112))
  - Use the templated `getMap` access functionality for `podio::GenericParameters` as the non-templated versions will be removed.

* 2023-06-08 Markus Frank ([PR#1126](https://github.com/aidasoft/DD4hep/pull/1126))
  - Allow to user-set world material in compact description:
  ```
    <world material="Steel235">
    </world>
  ```
    See issue https://github.com/AIDASoft/DD4hep/issues/1116 for details.
  - Add test t_minitel_config_world_material illustrating the feature.

* 2023-06-02 tmadlener ([PR#1124](https://github.com/aidasoft/DD4hep/pull/1124))
  - DDDigi: Make the `get{Value,}TypeName` calls work with the upcoming switch to `std::string_view` return types in podio.

* 2023-06-01 Andre Sailer ([PR#1123](https://github.com/aidasoft/DD4hep/pull/1123))
  - Volumes.h: rearrange implementation of classes, fix needed for gcc13/root 6.28/04, c++20

* 2023-06-01 Juraj Smiesko ([PR#1122](https://github.com/aidasoft/DD4hep/pull/1122))
  - ddsim: fix indentation from steeringfile produced by `ddsim --dumpSteeringFile`

* 2023-06-01 Dmitry Kalinkin ([PR#1089](https://github.com/aidasoft/DD4hep/pull/1089))
  - Add optional support for reading compressed files using HepMC3. Enabled with cmake flag DD4HEP_HEPMC3_COMPRESSION_SUPPORT. Needs at least HepMC3.2.5 and presence of zlib, lzma, bzip2

* 2023-05-31 Markus Frank ([PR#1120](https://github.com/aidasoft/DD4hep/pull/1120))
  - Fix example arguments

* 2023-05-31 Dmitry Kalinkin ([PR#1106](https://github.com/aidasoft/DD4hep/pull/1106))
  - DetectorImp::getRefChild() will no longer print to error context to std::cout, it will instead appear in the message of the runtime_exception thrown.

* 2023-05-30 Markus Frank ([PR#1119](https://github.com/aidasoft/DD4hep/pull/1119))
  - Disable DDCMS Geant4 example to resolve MR chain

* 2023-05-30 Paul Gessinger ([PR#1109](https://github.com/aidasoft/DD4hep/pull/1109))
  - Remove `using namespace std;` in `Printout.cpp`

* 2023-05-30 Andre Sailer ([PR#1100](https://github.com/aidasoft/DD4hep/pull/1100))
  - CMake: increase required version of Cmake from 3.12 to 3.14

* 2023-05-30 Markus Frank ([PR#1098](https://github.com/aidasoft/DD4hep/pull/1098))
  - MiniTel Generate example should replect the detector in issue (https://github.com/AIDASoft/DD4hep/issues/1091)

* 2023-05-04 Wouter Deconinck ([PR#1105](https://github.com/aidasoft/DD4hep/pull/1105))
  - allow rotation/position transformation on entire CAD_MultiVolume

* 2023-04-26 Andre Sailer ([PR#1099](https://github.com/aidasoft/DD4hep/pull/1099))
  - thisdd4hep.sh: make the Geant4 path discovery compatible with Geant4 11.1.1

* 2023-04-25 Andre Sailer ([PR#1097](https://github.com/aidasoft/DD4hep/pull/1097))
  - Geant4InputHandling: in case the MC generator gives us a negative mass, the proper_time_precision could be negative and we would not identify properTimeZero correctly. Fixes parts of #1094 when ddg4 smearing is used.

* 2023-04-21 scott snyder ([PR#1093](https://github.com/aidasoft/DD4hep/pull/1093))
  - ddsim: Fix handling of --meta.runNumberOffset and --meta.eventNumberOffset command-line switches.

* 2023-04-21 Frank Gaede ([PR#1088](https://github.com/aidasoft/DD4hep/pull/1088))
  - fix units in `Geant4FastSimShowerModel::constructSensitives`
       - used for energy check in `Geant4FastSimShowerModel::check_trigger`  for fast simulation

* 2023-04-21 Andre Sailer ([PR#1074](https://github.com/aidasoft/DD4hep/pull/1074))
  - DDSim: add explicit configuration of the Geometry construction, exposing many debug options for elements, materials, volumes, shapes, placements, Reflections, Regions, and Surfaces. See ddsim --help or --dumpSteeringFile

* 2023-03-31 Markus Frank ([PR#1087](https://github.com/aidasoft/DD4hep/pull/1087))
  - Improve plugin information
  -  inline in StandardPlugins.cpp and ShapePlugins.cpp
  - In DD4hep manual

* 2023-03-30 Andre Sailer ([PR#1086](https://github.com/aidasoft/DD4hep/pull/1086))
  - HepMC3: use all vertex information to create primary vertices, including time, fixes #1082

* 2023-03-29 Markus Frank ([PR#1084](https://github.com/aidasoft/DD4hep/pull/1084))
  - Upgrade standard plugins. Add some help information

* 2023-03-29 Markus Frank ([PR#1083](https://github.com/aidasoft/DD4hep/pull/1083))
  - Add plugin to assign VolumIDs to DetElements
    Normally this functionality id done by the VolumeManager. However, some clients prefer to not use the volume manager.
    With this plugin this basic functionality can be maintained.
  - Update plugin DD4hep_DetectorDump to optionally output the accumulated volume identifiers when traversing 
    the DetElement tree.
  
  To test both, invoke e.g.:
  ```
  $> geoPluginRun -input ../DD4hep/DDDetectors/compact/SiD.xml \
       -plugin DD4hep_DetElementVolumeIDs -detector /world \
       -plugin DD4hep_DetectorDump -sensitive -volids
  ```

* 2023-03-23 Markus Frank ([PR#1081](https://github.com/aidasoft/DD4hep/pull/1081))
  Allow users to add track user information to G4 tracks, which then moves to Geant4Particle for saving
  Use class Geant4ParticleInformation to extend the Geant4Particle object.
  Wrapper to store any user information as a `G4VUserTrackInformation` in a `G4Track`.
      The data of type `ParticleExtension` is moved from the `G4Track` to the `Geant4Particle` in the `Geant4ParticleHandler` if present. This automatically make the `G4Track` instance persistent as a `Geant4Particle`.
  Hence: Be careful to not assign the entity by default!
  
  The data in the subclass of `ParticleExtension` defined by the user
  requires a dictionary to be stored to ROOT.
  
  - Example: examples/DDG4_MySensDet. See examples/DDG4_MySensDet/src/MyTrackerSDAction.cpp for details.
  - Great thanks to ROOT for now being able to store std::unique_ptr<T>!
  - This is sort of a sub-issue to https://github.com/AIDASoft/DD4hep/issues/1073

* 2023-03-23 Christopher Dilks ([PR#1069](https://github.com/aidasoft/DD4hep/pull/1069))
  - rename `OpticalTracker` example to `RICH`

* 2023-03-22 Markus Frank ([PR#1080](https://github.com/aidasoft/DD4hep/pull/1080))
  - Fix bug in B field component access after a space transformation of multipole fields.
    See issue  MultipoleMagnet rotation #1073 https://github.com/AIDASoft/DD4hep/issues/1073 for details.

* 2023-03-22 Markus Frank ([PR#1079](https://github.com/aidasoft/DD4hep/pull/1079))
  - Optimize sensitive detector callbacks in DDG4.
    Many operations were performed twice: once in the sensitive detector, and once again in the computation of
    the MC contribution to the hit. This MR removes multiple computations and uses the results from the MC
    contribution to create the hit.
    The change should be fully compatible and delivers numerically identical results.
  
  - Remove deprecated DetElement factories.
    To not clutter the global namespace with factory names, factories in the DDDetectors area were declared
    deprecated many years ago. At a time these factories were replaced by identical factoris with a name prefix "DD4hep_".
    These factories are "official" and should be used instead.
    On creation such factories issued a warning message.
    It is now time to remove these factories completely.

* 2023-03-21 Christopher Dilks ([PR#1065](https://github.com/aidasoft/DD4hep/pull/1065))
  - Add test for average energy deposition in `OpticalTracker` example, for `Geant4SensitiveAction<Geant4OpticalTracker>`

* 2023-03-15 Markus Frank ([PR#1078](https://github.com/aidasoft/DD4hep/pull/1078))
  - See issue 1076 https://github.com/AIDASoft/DD4hep/issues/1076

* 2023-03-15 Wouter Deconinck ([PR#1075](https://github.com/aidasoft/DD4hep/pull/1075))
  - ddsim: Support for setting etaMin and etaMax. These override the respective theta settings!

* 2023-03-03 Markus Frank ([PR#1071](https://github.com/aidasoft/DD4hep/pull/1071))
  -  Verify and enhance the possibility to import plugin definitions from an external XML file
    (See isue: https://github.com/AIDASoft/DD4hep/issues/1062).
    The corresponding examples are:
    -- minitel_config_plugins_include_command_line, which shows how to perform the task by parsing sequentially the 
       XML input files like: 
       ```
       $> geoPluginRun -input <path>/compact/MiniTel.xml  -input  <path>/compact/ExamplePlugins.xml
      ```
    -- minitel_config_plugins_include_command_xml, where the second XML file is simply included:
  
        <includes>
          <file ref=<path>/examples/ClientTests/compact/BoxTrafos.xml/>
          <file ref=<path>/examples/ClientTests/compact/ExamplePlugins.xml/>
        </includes>
     where `BoxTrafos` is the entire original XML containing the geometry.
  -  Add plugins: configure Volume/SensitiveDetector object instances from information in XML Nodes. Given an XML tag like:
     ```
      <plugin type="config" name="DD4hep_DetElementConfig" path="/world" debug="true">
        <volume>
           <regionref   name="world_region"/>
           <limitsetref name="world_limits"/>
           <visref      name="world_vis"/>
        </volume>
      </plugin>```
  Can be used directly to modify the settings of s DetElement identified by its path. Similar for sensitive detector objects:
  ```
      <plugin type="config" name="DD4hep_SensitiveDetectorConfig" detector="MyLHCBdetector5" debug="true">
        <combine_hits    value="true"/>
        <verbose         value="true"/>
        <type            value="tracker"/>
        <ecut            value="5*keV"/>
        <hits_collection value="hits_collection_5"/>
      </plugin>
  ```
  - This construct also allows to configure the world volume as part of the resolution of issue https://github.com/AIDASoft/DD4hep/issues/1064
     ```
    <world debug="true">
      <regionref   name="world_region"/>
      <limitsetref name="world_limits"/>
      <visref      name="world_vis"/>
    </world> 
     ```
    Technically the implementation are XML utilities, which are used both by the plugin and the Compact converter.
  
  - Propagate the changes to the world volume to Geant4, which was not possible with DDG4 before, because production cuts and region settings for the world volume belong to Geant4 and are managed by Geant4. (also https://github.com/AIDASoft/DD4hep/issues/1064)
  - Side product: Add debug flags for the G4 LimitSet conversion. To enable the flags in the python setup:
  
    ```
      seq, act = m.geant4.addDetectorConstruction("Geant4DetectorGeometryConstruction/ConstructGeo")
      act.DebugLimits = True
     ```
  - Have the maps in DetectorData being named to ease debugging.
  - Add some XML attribute conversions (more user friendliness)
  - Add accessors to the PlacedVolume and the Volume handles to access the class name of the implementing class.
  - DDDigi: Add passing event parameters to the output and from the input record to the store. Needs testing though, 
    but this requires a new release of podio.

* 2023-03-02 Markus Frank ([PR#1070](https://github.com/aidasoft/DD4hep/pull/1070))
  - PR 1068 was incomplete (OpticalTracker). Add the missing pieces.

* 2023-03-01 Christopher Dilks ([PR#1068](https://github.com/aidasoft/DD4hep/pull/1068))
  - fix: fill energy deposition for `Geant4SensitiveAction<Geant4OpticalTracker>`

* 2023-03-01 Markus Frank ([PR#1066](https://github.com/aidasoft/DD4hep/pull/1066))
  - Add include directive in <plugins> section
    (https://github.com/AIDASoft/DD4hep/commit/43b66bfd145c9e58c91f2189c2a3671ef9b2ef8e)
    See Issue 1062 (https://github.com/AIDASoft/DD4hep/issues/1062)
  - With test: /examples/ClientTests/compact/IncludePlugins.xml
  - Some (mostly cosmetic) refactorization in DDDigi

# v01-25-01

* 2023-02-24 Andre Sailer ([PR#1063](https://github.com/aidasoft/dd4hep/pull/1063))
  * DDG4: fix -Wnon-pod-varargs in Geant4Output2EDM4hep, which fails on clang

# v01-25

* 2023-02-23 Thomas Madlener ([PR#1059](https://github.com/aidasoft/dd4hep/pull/1059))
  - Propagate HepMC event weights to EDM4hep and LCIO outputs of ddsim
    - Store all available weights and their names into the Frame / Event parameters, additionally store the first weight into the `weight` field of the `edm4hep::EventHeader`, resp. the `LCEvent`.
  - Add a possibility to store `double` values in `DDG4::EventParameters`

* 2023-02-23 Andre Sailer ([PR#920](https://github.com/aidasoft/dd4hep/pull/920))
  - DDG4: Geant4InputHandling: Try to address the simulation of Excited Ions. Print a warning if we encounter excited Ions that Geant4 cannot handle. Waiting for something else to provide the excitation energy information that is needed in this case. Fixes #918 and #1051 
  - DDSim: Catch and log exceptions for physics/userFunctions.

* 2023-02-21 Ben Couturier ([PR#1060](https://github.com/aidasoft/dd4hep/pull/1060))
  - Prevent a compact file from being loaded twice if the debug option "incguard" has been set.

* 2023-02-16 Andre Sailer ([PR#1061](https://github.com/aidasoft/dd4hep/pull/1061))
  - ddsim: make it possible to use batchmode with userInputPlugins only

* 2023-02-09 Markus Frank ([PR#1058](https://github.com/aidasoft/dd4hep/pull/1058))
  The export of dd4hep::units is problematic in the presence of identical libraries from DD4hep in the LD_LIBRARY_PATH:
  - The ROOT auto-class loading tends to falsely load these libraries if constants from the dd4hep namespace are requested in python. This is clearly wrong: the original libraries may not be binary compatible. The 
  - The export of the units using a helper class fixes this and ensures that the auto load mechanism is not automatically triggered. This is at least a formally correct solution until the auto load mechanism is better understood.
  
  - In the ROOT loader for DDDigi the `TBranch::SetAutoDelete(true)` was not set causing eventually double deletion and arbitrary crashes. Data read by DDDigi are put on the store and deleted by the application to allow subsequent reading for feeding other threads. If ROOT would take care of the deletion, multi-threaded processing is not possible.

* 2023-02-06 Dmitry Kalinkin ([PR#1055](https://github.com/aidasoft/dd4hep/pull/1055))
  - Pass `DYLD_LIBRARY_PATH` environment to listcomponents_dd4hep when generating rootmaps in CMake

* 2023-01-31 Paul Gessinger ([PR#1053](https://github.com/aidasoft/dd4hep/pull/1053))
  - Check podio version for compatibility in cmake

* 2023-01-30 Dmitry Kalinkin ([PR#1052](https://github.com/aidasoft/dd4hep/pull/1052))
  - Removed not implemented declaration of member function `PlacedVolume::flags()`

* 2023-01-26 Thomas Madlener ([PR#1050](https://github.com/aidasoft/dd4hep/pull/1050))
  - DDG4 EDM4hep Output: Write Frames into the `"runs"` category of the output file to store some run information.

# v01-24

* 2023-01-20 Andre Sailer ([PR#1048](https://github.com/AIDASoft/DD4hep/pull/1048))
  - add -Wno-psabi to compiler flags to ignore warnings about ABI changes that we will never have issues with. Fixes #1043

* 2023-01-20 Andre Sailer ([PR#1046](https://github.com/AIDASoft/DD4hep/pull/1046))
  - ParticleHandler: account for modified stepping actions, where tracking of a particle could be paused and later restarted.

* 2023-01-18 Andre Sailer ([PR#1045](https://github.com/AIDASoft/DD4hep/pull/1045))
  - thisdd4hep: fix an issue with environment paths getting dropped when they contain a complete substring of a path that is going to be added

* 2023-01-18 Markus Frank ([PR#1044](https://github.com/AIDASoft/DD4hep/pull/1044))
  - This PR addresses issue https://github.com/AIDASoft/DD4hep/issues/1037
    Rather than adding the beta as a double it was chosen to add at each step the track momentum
    in floats which for 4 more bytes offers more information.

* 2023-01-18 Andre Sailer ([PR#1042](https://github.com/AIDASoft/DD4hep/pull/1042))
  - ddsim: fix exception when a compactFile path not containing any slashes was given (fixes #1039 )

* 2023-01-17 Markus Frank ([PR#1041](https://github.com/AIDASoft/DD4hep/pull/1041))
  - Make DDDigi I/O interface more common and add edm4hep write/read example
  - Move DDG4 edm4hep writer to use podio Frames

* 2023-01-11 Markus Frank ([PR#1038](https://github.com/AIDASoft/DD4hep/pull/1038))
  - Improve DDDigi documentation when opening code sub-page
  - Silence flak8 warning from python
  - Fix a bug in the detector checksum module. Tested with TGeo units and G4 units of the CLICSiD model.
  - Propagate the configuration flag `DD4HEP_USE_EDM4HEP` to the generated dd4hep cmake of client projects.
  - Add DDDigi output module for the edm4hep format
  - Add DDDigi output module for the native ROOT objects including required dictionaries.

* 2022-12-15 Markus Frank ([PR#1032](https://github.com/AIDASoft/DD4hep/pull/1032))
  - Improve GDML export procedures
    -- Allow to set export precision in the plugin
    -- New ROOT release needed to properly export surfaces (current ROOT GDML export does not handle this currectly)
       See ROOT PR https://github.com/root-project/root/pull/11886
       See ROOT PR https://github.com/root-project/root/pull/11887
       See ROOT PR https://github.com/root-project/root/pull/11888
       See ROOT PR https://github.com/root-project/root/pull/11889
       See ROOT PR https://github.com/root-project/root/pull/11895
  - Remove some build errors for MAC

* 2022-12-09 Markus Frank ([PR#1030](https://github.com/AIDASoft/DD4hep/pull/1030))
  - Program GDML writer (requires new ROOT release to take advantage)

* 2022-12-09 Markus Frank ([PR#1029](https://github.com/AIDASoft/DD4hep/pull/1029))
  - Improve DDDigi package doc
  - Bug fix in detector checksum
  - Remove flak8 warnings

* 2022-12-06 Markus Frank ([PR#1028](https://github.com/AIDASoft/DD4hep/pull/1028))
  - Add detector checksum facility as plugin: Compare different detector setups
  - Gives identical hash results for TGeo units and G4 units
  - Supports detector dumps with "unified" strings for debugging
  ```
  Usage: -plugin DD4hepDetectorChecksum -arg [-arg]                             
  
       -detector <string>     Top level DetElement path. Default: '/world'        
       -readout               also hash the detector's readout properties         
                              (sensitive det, id desc, segmentation)              
                              default: false                                      
                                                                                  
     Debugging: Dump individual hash codes (debug>=1)                             
     Debugging: and the hashed string (debug>2)                                   
       -dump_elements         Dump hashes of used elements                        
       -dump_materials        Dump hashes of used materials                       
       -dump_solids           Dump hashes of used solids                          
       -dump_volumes          Dump hashes of used volumes                         
       -dump_placements       Dump hashes of used placements                      
       -dump_detelements      Dump hashes of used detelements                     
       -dump_sensitive        Dump hashes of sensitive detectors                  
       -dump_readout          Dump hashes of readout entities                     
       -dump_iddescriptors    Dump hashes of ID descriptors                       
       -dump_segmentations    Dump hashes of readout segmentations                
                                                                                  
     Modify units in the created hash strings (deprecated):                       
       -length_unit  <value>  Unit of length  as literal. default: mm             
       -angle_unit   <value>  Unit of angle   as literal. default: deg            
       -energy_unit  <value>  Unit of energy  as literal. default: GeV            
       -density_unit <value>  Unit of density as literal. default: g/cm3          
       -atomic_unit <value>   Unit of atomic weight as literal. default: g/mole   
                                                                                  
       -debug <number>        Enable debug printouts.                             
       -help                  Print this help output
  ```

* 2022-11-30 Kolja Kauder ([PR#1017](https://github.com/AIDASoft/DD4hep/pull/1017))
  - Final state HepMC particles were all attached to (0,0,0). Fixed by switching vertex creation for parentless particles to using their end-point instead, fixes #1013

* 2022-11-26 Markus Frank ([PR#1026](https://github.com/AIDASoft/DD4hep/pull/1026))
  - Fixed some coverity defects recently reported
  - Fix Geant4Converter bug: Protect for reflected assembly shapes.
  - Added feature to Geant4Output2ROOT to change file when the run number changes (ie. for each /run/beamOn command)
  - Modify and enhance the MiniTel example in ClientTests to serve as a small, but flexible testbed for DDDigi
  - Add multiple DDDigi tests using the modified MiniTel
    o Data generator using DDG4
    o See examples/DDDigi/scripts for the tests:
       o multiple interactions
       o spillover events
       o Container parallelization
       o Segmentation parallization
  - Started to implement a checksum mechanism based on well formatted XML dumps similar to GDML, but with
    well defined floating point precision.
    o See https://github.com/AIDASoft/DD4hep/issues/994 for details
    o first and incomplete dump for shapes.
    o to be completed eventually
    o whoever feels like it can become involved to implement such dumps for other objects:
      - elements, isotopes, materials, DetElements, Volumes, Placements etc.

* 2022-11-25 jmcarcell ([PR#1024](https://github.com/AIDASoft/DD4hep/pull/1024))
  - Fix compiler warning about unused variable
  - Fix warning in example test and fix also the test, it was comparing `char* == char*` which is almost never true

* 2022-11-24 Wouter Deconinck ([PR#1012](https://github.com/AIDASoft/DD4hep/pull/1012))
  - DDG4: Geant4TCUserParticleHandler: Allow for asymmetric tracking region with `tracker_region_zmin`

* 2022-11-22 Markus Frank ([PR#1023](https://github.com/AIDASoft/DD4hep/pull/1023))
  Take into account suggestions from PR https://github.com/AIDASoft/DD4hep/pull/1021

* 2022-11-22 Markus Frank ([PR#1021](https://github.com/AIDASoft/DD4hep/pull/1021))
  - Implemented issue https://github.com/AIDASoft/DD4hep/issues/1010: Changing Geant4 physics flags 
    o Extended the Geant4UIManager to support command queues at various stages of the program:
      -- configure
      -- initialize
      -- pre-run
      -- post-run
      -- terminate
    o Added interface function to directly communicate with the G4UI using string commands at any time
      from python.
    o Extended Geant4Kernel functionality to allow client actions to subscribe to stages of the program
      and perform dedicated actions on:
      -- configure
      -- initialize
      -- terminate
      As an example please see DDG4/src/Geant4UIManager.cpp
  
  - Dropped issue https://github.com/AIDASoft/DD4hep/issues/1004 after some tests and investigation:
    This issue cannot be resolved, because MC records may also be read without Geant4 and a physics list being initialized.
    Hence the event readers cannot implement such a feature if the event record does not support charge, but only the PDG code.
    Conclusion is to best update the charge of particles at the output stage using the PDG code or to implement an event action,
    which performs this actions right before the output stage.
  - Simplified component properties. 
  - Improvements to DDDigi (work in progress)

* 2022-11-17 Andre Sailer ([PR#1019](https://github.com/AIDASoft/DD4hep/pull/1019))
  - LCIOConversions: fix attaching SimCaloHit collections to event, this was accidentally dropped in #922

* 2022-11-16 Jonas Hahnfeld ([PR#1018](https://github.com/AIDASoft/DD4hep/pull/1018))
  - Fix build with GCC 8

* 2022-11-11 Wouter Deconinck ([PR#1011](https://github.com/AIDASoft/DD4hep/pull/1011))
  - Allow HepMC3 ROOT input files in ddsim when they end with `.hepmc3.tree.root`

* 2022-11-10 Wouter Deconinck ([PR#989](https://github.com/AIDASoft/DD4hep/pull/989))
  - ddsim: Automatically interpret '.hepmc3' input files

* 2022-11-03 Andre Sailer ([PR#1005](https://github.com/AIDASoft/DD4hep/pull/1005))
  - Examples: OpticalTracker: declare dependency on DDRec
  - Docs: fix some typos noted in #1003

* 2022-10-30 Markus Frank ([PR#1002](https://github.com/AIDASoft/DD4hep/pull/1002))
  - Fix to issue https://github.com/AIDASoft/DD4hep/issues/1000 and https://github.com/AIDASoft/DD4hep/issues/999

* 2022-10-29 Markus Frank ([PR#998](https://github.com/AIDASoft/DD4hep/pull/998))
  - DDCore
    -- Add string hash function for 8 and 16 bit hash results
    -- Add position transformations (world, detector element) to volume manager
  
  - DDG4
    -- Fix interface to Geant4StackingAction. Add missing function interface to allow access to ClassifyNewTrack.
       Also pass the current stacking manager reference to all user callbacks.
    -- Add simple example to test the functionality  examples/DDG4/scrips/TestStacking.py
  
  - DDDigi
    -- Add some processor plugins for simple data processing.
    -- Enhance the usage of the Key identifier.
    -- Add several test scripts in the example area.
  
  - examples
    -- Reduce the test execution time of the top CPU consumers by reducing the number of simulated events.

* 2022-10-24 Paul Gessinger ([PR#997](https://github.com/AIDASoft/DD4hep/pull/997))
  - DD4HEP_RELAX_PYVER is exported to `DD4hepConfig.cmake`.

* 2022-10-22 Andre Sailer ([PR#996](https://github.com/AIDASoft/DD4hep/pull/996))
  - DDSim: fix bug preventing the use of integers for the verbosity level (-v/--printLevel, --output.input etc.) fixes #992

* 2022-10-17 Andre Sailer ([PR#987](https://github.com/AIDASoft/DD4hep/pull/987))
  - DDEve: Adapt to renamed header in upcoming ROOT 6.28

* 2022-10-17 Wouter Deconinck ([PR#986](https://github.com/AIDASoft/DD4hep/pull/986))
  - Shapes::Trap: Fix the 4-argument trapezoidal prism constructor (again)

* 2022-10-10 Wouter Deconinck ([PR#983](https://github.com/AIDASoft/DD4hep/pull/983))
  - Ensure that closed tessellated solids are converted to closed solids in geant4

# v01-23

* 2022-09-28 Wouter Deconinck ([PR#982](https://github.com/aidasoft/dd4hep/pull/982))
  - ddsim: set eta_min, eta_max correctly for `ddsim --gun.distribution eta`

* 2022-09-23 Markus Frank ([PR#980](https://github.com/aidasoft/dd4hep/pull/980))
  Remove using declarations in root-cling dictionary files to avoid interpreter clashes with the global namespace
  
  Affected files:
  -   DDCore/src/GeoDictionary.h
  -   DDCore/src/PropertyDictionary.h
  -   DDCore/src/RootDictionary.h
  -   DDCore/src/SegmentationDictionary.h
  -   DDEve/include/DDEve/Dictionary.h
  -   DDG4/include/DDG4/DDG4Dict.h

* 2022-09-23 Marco Clemencic ([PR#979](https://github.com/aidasoft/dd4hep/pull/979))
  - Use explicit namespaces in DDCond dictionary

* 2022-09-19 Wouter Deconinck ([PR#976](https://github.com/aidasoft/dd4hep/pull/976))
  - `geoConverter -compact2tgeo` to write TGeo geometry to ROOT file

* 2022-09-19 Christopher Dilks ([PR#974](https://github.com/aidasoft/dd4hep/pull/974))
  - add example RICH detector, demonstrating and testing `Geant4OpticalTrackerAction`

* 2022-09-16 Wouter Deconinck ([PR#975](https://github.com/aidasoft/dd4hep/pull/975))
  - materialBudget: enable use with asymmetric detectors: adding thetaMin/thetaMax/etaMin to the steering file

* 2022-09-15 Wouter Deconinck ([PR#967](https://github.com/aidasoft/dd4hep/pull/967))
  - Geant4OpticalTrackerAction which stops-and-kills optical photons for e.g. SiPM sensor planes

* 2022-09-12 Christopher Dilks ([PR#973](https://github.com/aidasoft/dd4hep/pull/973))
  - fix typo in `examples/README.md`: `cmake` option `DD4HEP_BUILD_EXAMPLES` should be `DD4HEP_EXAMPLES`

* 2022-09-07 Dmitry Kalinkin ([PR#972](https://github.com/aidasoft/dd4hep/pull/972))
  - Refactor thisdd4hep.sh to use local variables where possible to prevent user environment corruption.

* 2022-09-01 Andre Sailer ([PR#969](https://github.com/aidasoft/dd4hep/pull/969))
  - DDSim: ddsim now prints out if the defaultFilter or if no filter is used for a sensitive detector

* 2022-09-01 Wouter Deconinck ([PR#968](https://github.com/aidasoft/dd4hep/pull/968))
  - ddsin: Add `--runType qt` support for enabling the graphical Qt interface for geant4
  - ddsim: change shell type to tcsh: enabling tab completion when Geant4 offers it

* 2022-08-26 Andre Sailer ([PR#962](https://github.com/aidasoft/dd4hep/pull/962))
  - DDCore: DetectorInfo: make INFO attributes optional, fixes #960

* 2022-08-25 Andre Sailer ([PR#963](https://github.com/aidasoft/dd4hep/pull/963))
  - ChannelingCrystalMaterial: fix crystal_orientation to be constPropertyRef

* 2022-08-25 Andre Sailer ([PR#961](https://github.com/aidasoft/dd4hep/pull/961))
  - DDSim: fix example for adding user physics list extension