ReleaseNotes.md

# 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