Skip to content
Snippets Groups Projects
ReleaseNotes.md 238 KiB
Newer Older
# 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

Andre Sailer's avatar
Andre Sailer committed
# 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.

Andre Sailer's avatar
Andre Sailer committed
# 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

Andre Sailer's avatar
Andre Sailer committed
# 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

Andre Sailer's avatar
Andre Sailer committed
# v01-22

* 2022-08-16 Andre Sailer ([PR#957](https://github.com/aidasoft/dd4hep/pull/957))
  - CI: add check for header guards

* 2022-08-15 Andre Sailer ([PR#956](https://github.com/aidasoft/dd4hep/pull/956))
  - CI: Add test with Geant4Units enabled

* 2022-08-15 Andre Sailer ([PR#946](https://github.com/aidasoft/dd4hep/pull/946))
  - CI changes, for discussion

* 2022-08-11 Markus Frank ([PR#954](https://github.com/aidasoft/dd4hep/pull/954))
  Before starting to parse XML files, programatically set the locale to "C" if any of the three
  - LC_NUMERIC,
  - LC_TIME,
  - LC_CTYPE
  Is not set to "C".
  
  Addresses issue https://github.com/AIDASoft/DD4hep/issues/913.

* 2022-08-11 Andre Sailer ([PR#953](https://github.com/aidasoft/dd4hep/pull/953))
  - DDSim: find the python executable used during build and set that for the hashbang, e.g. python3.9 instead of python. Fixes #952

* 2022-08-10 Markus Frank ([PR#951](https://github.com/aidasoft/dd4hep/pull/951))
  - Allow to set MeanExcEnergy, MeanEnergyPerIonPair and BirksConstant in G4Materials ionisation parameters.
    Specify values in the compact description of the materials:
  ```
      <material name="Ice">
        <D type="density" value="1.0" unit="g/cm3"/>
        <composite n="2" ref="H"/>
        <composite n="1" ref="O"/>
        <constant name="BirksConstant"        value="123.456*mm/MeV"/>
        <constant name="MeanExcitationEnergy" value="79.7*eV"/>
        <constant name="MeanEnergyPerIonPair" value="50*eV"/>
      </material>
  ```
  Units will be converted to Geant4 units in the converter.
  See issue https://github.com/AIDASoft/DD4hep/issues/890 for details.
  
  If in DDG4 the the material debugging is enabled:
  ```
    # Configure G4 geometry setup
    seq, act = geant4.addDetectorConstruction("Geant4DetectorGeometryConstruction/ConstructGeo")
    act.DebugMaterials = True
  ```
  this gives the following output:
  ```
  Ice                    ++ Created G4 material  Material:      Ice    density:  1.000 g/cm3   RadL:  36.083 cm   Nucl.Int.Length:  75.375 cm 
                        Imean:  79.700 eV   temperature: 293.15 K  pressure:   1.00 atm
  
     --->  Element: H (H)   Z =  1.0   N =     1   A =  1.008 g/mole
           --->  Isotope:    H1   Z =  1   N =   1   A =   1.01 g/mole   abundance: 99.989 %
           --->  Isotope:    H2   Z =  1   N =   2   A =   2.01 g/mole   abundance:  0.011 %
            ElmMassFraction:  11.19 %  ElmAbundance  66.67 % 
  
     --->  Element: O (O)   Z =  8.0   N =    16   A = 15.999 g/mole
           --->  Isotope:   O16   Z =  8   N =  16   A =  15.99 g/mole   abundance: 99.757 %
           --->  Isotope:   O17   Z =  8   N =  17   A =  17.00 g/mole   abundance:  0.038 %
           --->  Isotope:   O18   Z =  8   N =  18   A =  18.00 g/mole   abundance:  0.205 %
            ElmMassFraction:  88.81 %  ElmAbundance  33.33 % 
            log(MEE): -9.437  Birk's constant: 123.5 [mm/MeV]  Mean Energy Per Ion Pair: 50 [eV]
  ```

* 2022-08-10 Markus Frank ([PR#950](https://github.com/aidasoft/dd4hep/pull/950))
  On request from out LHC colleagues DD4hep supports channeling physics in Geant4.
  To support channeling physics in Geant4 it is necessary to enable the transparent 
  creation of G4ExtendedMaterial and G4LogicalCrystalVolume instances.
  This can be done in DD4hep with the supply of material and volume properties in DD4hep.
  
  Material properties can be supplied in the compact description like here:
  ```
      <material name="Ice">
        <D type="density" value="1.0" unit="g/cm3"/>
        <composite n="2" ref="H"/>
        <composite n="1" ref="O"/>
        <constant name="Geant4-plugin:material"            option="ChannelingCrystalMaterial"/>
        <constant name="Geant4-ignore:crystal_data"        option="${DD4hepExamplesINSTALL}/examples/DDG4/data/Si220pl/Si220pl"/>
        <constant name="Geant4-ignore:crystal_orientation" option="(1,0,0)"/>
      </material>
  ```
  The property starting with the tag `Geant4-plugin` is used to determine the proper plugin
  preparing the G4ExtendedMaterial instance.
  All properties with tags `Geant4-ignore` are not passed as material properties to Geant4.
  Properties starting with this tag can be used by users to configure the G4ExtendedMaterial instance.
  
  Volumes can as well have properties as this C++ example shows:
  ```
    Volume vol = Volume("Volume", solid, material);
    xml_elt_t ec = ...;
    vol.addProperty(ec.attr<std::string>(_U(name)), ec.attr<std::string>(_U(value)));
  ```
  with values supplied by XML:
  ```
    <property name="Geant4-plugin" value="ChannelingCrystalVolume"/>
  ```
  For more details see the example `<DD4hep>/examples/DDG4/compact/Channeling.xml`.
  Again the property `Geant4-plugin` is used to call a plugin to create sub-classes
  of G4LogicalVolume like G4LogicalCrystalVolume. 
  
  An example was prepared in `<DD4hep>/examples/DDG4` containing:
  - a compact description: `compact/Channeling.xml`
  - an example factory for the G4ExtendedMaterial: `src/ChannelingCrystalMaterial.cpp`
  - an example factory for the G4LogicalCrystalVolume: `src/ChannelingCrystalVolume.cpp`
  - A script invoking Geant4 to test this setup: `scripts/Channeling.py`

* 2022-08-09 Dmitry Kalinkin ([PR#949](https://github.com/aidasoft/dd4hep/pull/949))
  - DDSim: restore the fixed momentum behaviour of `--gun.energy`, independent of the isotrop setting for the particle gun. If gun.energy is set, the momentum will have this value. If it is not set, momentumMin and momentumMax will be used to pick a value.

* 2022-08-05 Andre Sailer ([PR#942](https://github.com/aidasoft/dd4hep/pull/942))
  - DDSim: add option to set userInputPlugin for simulation by adding a plugin for themselves, and this to the ddsim steering file (for #940)
     ```python
        def exampleUserPlugin(dd4hepSimulation):
          '''Example code for user created plugin.
  
          :param DD4hepSimulation dd4hepSimulation: The DD4hepSimulation instance, so all parameters can be accessed
          :return: GeneratorAction
          '''
          from DDG4 import GeneratorAction, Kernel
          # Geant4InputAction is the type of plugin, Cry1 just an identifier
          gen = GeneratorAction(Kernel(), 'Geant4InputAction/Cry1' , True)
          # CRYEventReader is the actual plugin, steeringFile its constructor parameter
          gen.Input = 'CRYEventReader|' + 'steeringFile'
          # we can give a dictionary of Parameters that has to be interpreted by the setParameters function of the plugin
          gen.Parameters = {'DataFilePath': '/path/to/files/data'}
          gen.enableUI()
          return gen
  
        SIM.inputConfig.userInputPlugin = exampleUserPlugin
     ```

* 2022-08-04 Andrea Ciarma ([PR#944](https://github.com/aidasoft/dd4hep/pull/944))
  * Mask_o1: Added the possibility to have sensitive elements of type Mask_o1_v01_geo by adding a `sensitive="sensitiveType"` attribute

* 2022-08-02 Juraj Smiesko ([PR#941](https://github.com/aidasoft/dd4hep/pull/941))
  * checkOverlaps.py: Adding possibility to provide multiple compact files
  * checkOverlaps.py: replace optparse by argparse for up-to-date python

* 2022-08-01 Markus Frank ([PR#939](https://github.com/aidasoft/dd4hep/pull/939))
  - Follow up of https://github.com/AIDASoft/DD4hep/pull/938. 
    Improves the DetectorCheck plugin.
  - Add example with an "ill" detector description that triggers the DetectorCheck plugin
    to complain and to eject pathes to problematic detector elements ect.

* 2022-07-29 Markus Frank ([PR#938](https://github.com/aidasoft/dd4hep/pull/938))
  - Fix type in DDCore/src/DD4hepRootPersistency.cpp
  - Add operator== and operator != to handles of DetElement, SensitiveDetector
    Volume and PlacedVolume. Check pointer values for equality.
  - Add plugin DD4hep_DetectorCheck. Improves and replaces DD4hep_VolumeMgrTest.
    o Test checks the strutural tree of a given top element
    o Test checks the geometry tree of a given top element
    o If physical volume ids are properly placed these can also be checked.
  ```
  DD4hep_DetectorCheck -option [-option]                                         
    -help                        Print this help message                         
    -name  <subdetector name>    Name of the subdetector to be checked           
                                 "ALL" or "all": loop over known subdetectors
                                 "world" start from the mother of all...       
    -structure                   Check structural tree consistency               
    -geometry                    Check geometry tree consistency                 
    -sensitve                    Check consistency between detector and volume   
                                 settings of sensitive detectors.                
    -volmgr                      Check volume manager entries against volIDs of  
                                 sensitive volume placements.                  
  
                                 NOTE: Option requires proper PhysVolID setup    
                                 of the sensitive volume placements !
  ```

* 2022-07-27 Juraj Smiesko ([PR#937](https://github.com/aidasoft/dd4hep/pull/937))
  - Improving error message when setting detector type flags

* 2022-07-27 Andre Sailer ([PR#935](https://github.com/aidasoft/dd4hep/pull/935))
  - ddsim: Fix setting of zeroTimePDGs, previously this value was not forwarded from config to the program
  - particle.tbl: change 523 to unstable (fixes #909)
  - Geant4InputHandling: add exception when encountering stable particles with daughters that are marked for simulation (implements feature of #909)
  - Geant4InputHandling: reject particles with GEN_DOC, GEN_BEAM, GEN_OTHER (fixes part of #918)

* 2022-07-26 Markus Frank ([PR#936](https://github.com/aidasoft/dd4hep/pull/936))
  - Recursive calls to apply-plugins overwrote the return code.
  - This MR fixes issue https://github.com/AIDASoft/DD4hep/issues/875
  
  - Support for 1D, 2D and 3D parameterised volumes.
    (Outstanding request by S.Ko)
    1. TGeo does not support parametrized volumes intrinsically.
      On the dd4hep/TGeo side these are implemented by multiple placements 
      according to the user supplied transformation matrices.
      For details see the calls in `dd4hep::Volume::paramVolume<dim>D(...)`
    2. When translated to Geant4, the structures are identified and
      the proper Geant4 parameterisation is created.
    3. An example can be found in:
      - `examples/ClientTests/src/ParamVolume_geo.cpp`
      - to display: `geoDisplay examples/ClientTests/compact/ParamVolume<dim>D.xml`
      - the Geant4 conversion is excercised with the scripts:
        ```
        python examples/ClientTests/scripts/ParamVolume.py \
           -geometry examples/ClientTests/compact/ParamVolume<dim>D.xml \
           -vis -macro examples/ClientTests/compact/ParamVolume.mac ```

Andre Sailer's avatar
Andre Sailer committed
# v01-21

* 2022-07-19 Markus Frank ([PR#933](https://github.com/aidasoft/DD4hep/pull/933))
  The fast simulation handling in Geant4 includes the GFlash interface
  as implemented in `<geant40-source>/source/parameterisations/gflash`
  and a fast simulation interface as provided by 
  `<geant40-source>/source/processes/parameterisation`
  
  This MR allows to handle both mechanisms using the same callbacks 
  in the Geant4SensitiveActions using the callback specialization:
  ```
        /// GFLASH/FastSim interface: Method for generating hit(s) using the information of the fast simulation spot object.
        virtual bool processFastSim(const Geant4FastSimSpot* spot, G4TouchableHistory* history)  final;
  ```
  in addition to the regular callback for full simulation:
  ```
        /// G4VSensitiveDetector interface: Method for generating hit(s) using the G4Step object.
        virtual bool process(const G4Step* step,G4TouchableHistory* history)  final;
  ```
  The `Geant4FastSimSpot` is inspired by the `G4GFlashSpot`, but avoids the specialization towards GFlash
  given that the `G4FastHit` and the `G4GFlashEnergySpot` are equivalent.
  Together with the helper class `Geant4FastSimHandler` simple sensitive detector callbacks
  can be implemented like:
  ```
      /// GFlash/FastSim interface: Method for generating hit(s) using the information of Geant4FastSimSpot object.
      template <> bool
      Geant4SensitiveAction<Geant4Tracker>::processFastSim(const Geant4FastSimSpot* spot,
  							 G4TouchableHistory* /* hist */)
      {
        typedef Geant4Tracker::Hit Hit;
        Geant4FastSimHandler h(spot);
        Hit* hit = new Hit(h.trkID(), h.trkPdgID(), h.deposit(), h.track->GetGlobalTime());
        hit->cellID        = cellID(h.touchable(), h.avgPositionG4());
        hit->energyDeposit = h.deposit();
        hit->position      = h.avgPosition();
        hit->momentum      = h.momentum();
        hit->length        = 0e0;
        collection(m_collectionID)->add(hit);
        return true;
      }
  ```
  Callbacks with this signature are called both for GFlash and the G4 fast simulation.
  
  To simplify the user defined construction of fast simulation shower models
  the helper class `Geant4FastSimShowerModel` is implemented as a `Geant4Action`
  and hence allows to have options to be set by the user (including python).
  
  As an illustration two fast simulation shower models were implemented in
  `<dd4hep>/DDG4/plugins/Geant4P1ShowerModel.cpp` which were directly deduced
  from the Geant4 example `<geant4-source>/examples/extended/parameterisations/Par01`.
  Please see the source files for details.
  
  To execute GFlash or fast simulation to simple python examples are provided
  using simple silicon blocks as sensitive volumes:
  - GFlash `<dd4hep-dir>/examples/ClientTests/scripts/SiliconBlockGFlash.py`
  - Fast simulation `<dd4hep-dir>/examples/ClientTests/scripts/SiliconBlockFastSim.py`
  
  To enable either the following actions are required:
  1. Enable fast simulation for certain particles in the physics list:
  ```  # Build the physics list:
    phys = geant4.setupPhysics('FTFP_BERT')
    ph = DDG4.PhysicsList(kernel, str('Geant4FastPhysics/FastPhysicsList'))
    ph.EnabledParticles = ['e+', 'e-']
    ph.enableUI()
    phys.adopt(ph)
  ```
  This step is identical for GFlash and fast simulation physics.
  2. Enable the shower mode:
  ```  model = DDG4.DetectorConstruction(kernel, str('Geant4Par01EMShowerModel/ShowerModel'))
    # Mandatory model parameters
    model.RegionName = 'SiRegion'
    model.Material = 'Silicon'
    model.ApplicableParticles = ['e+', 'e-']
    model.Etrigger = {'e+': 0.1 * GeV, 'e-': 0.1 * GeV}
    model.Enable = True
    model.enableUI()
  ```
  Here the options must be set according to the parameters required by the shower models.
  
  The G4 fast simulation interface is only functional for Geant4 version >= 10.07.
  For lower versions of Geant4 missing classes are stubbed to allow the compilation.

* 2022-07-18 Paul Gessinger ([PR#931](https://github.com/aidasoft/DD4hep/pull/931))
  - Update `VariantParameters`: `value_or` is const (returns by value anyway), add non-const `get` method

* 2022-07-15 Markus Frank ([PR#930](https://github.com/aidasoft/DD4hep/pull/930))
  - Fix some handler
  - Add 2 examples to test the functionality

* 2022-07-14 Markus Frank ([PR#929](https://github.com/aidasoft/DD4hep/pull/929))
  - First attempt to implement GFlash parametrization for DDG4
  - Example is in examples/ClientTests/scripts/SiliconBlockGFlash.py
    Relevant code changes are for the detector construction:
    ```
    seq, act = geant4.addDetectorConstruction('Geant4DetectorGeometryConstruction/ConstructGeo')
    ....
    # Enable GFlash shower model
    model = DDG4.DetectorConstruction(kernel, str('Geant4GFlashShowerModel/ShowerModel'))
    model.Parametrization = 'GFlashHomoShowerParameterisation'
    # Mandatory model parameters
    model.RegionName = 'SiRegion'
    model.Material = 'Silicon'
    model.Enable = True
    # Energy boundaries are optional
    model.Emin  = {'e+': 0.1*GeV, 'e-': 0.1*GeV }  # Units in GeV
    model.Ekill = {'e+': 0.1*MeV, 'e-': 0.1*MeV }
    model.enableUI()
    seq.adopt(model)
    ```
    and the physics list.
    ```
    # Now build the physics list:
    phys = geant4.setupPhysics('FTFP_BERT')
    ph = DDG4.PhysicsList(kernel, str('Geant4FastPhysics/FastPhysicsList'))
    ph.EnabledParticles = ['e+', 'e-']
    ph.BeVerbose = True
    ph.enableUI()
    phys.adopt(ph)
    ```
  The setup of the regions is crucial for GFlash to work, because it applies to regions.
  For concrete detector constructors the proper regional setting are mandatory, but do not affect
  this implementation.

* 2022-07-12 Andre Sailer ([PR#928](https://github.com/aidasoft/DD4hep/pull/928))
  - CI: Due to incompatibilities we can no longer test macOS on github

* 2022-07-12 Markus Frank ([PR#927](https://github.com/aidasoft/DD4hep/pull/927))
  Easy possibility to store condition payloads as std::any.
  - Use of specialized handle class `dd4hep::ConditionAny` to support the functionality.
    The payload is automatically bound to an object of type std::any.
    Example code of constructor and how to access data:
     ```
    /// Emplacement construction
    std::vector<int> value;
    ... // fill data
    ConditionAny c2("name", "type", std::move(value));
  
    /// Construct conditions object with empty std::any	 
    ConditionAny c2("name", "type");
    /// Assign data (empty vector<int>) to the payload:
    c2.get() = vector<int>();
  
    /// Access data:
    vector<int>& data = c2.as<vector<int> >();
       ```
     as a corollary to this approach these conditions can only be stored and retrieved from ROOT storage 
     if the requirement for ROOT are satisfied. Otherwise no other restrictions are imposed. 
     The corresponding grammar instance is part of the library.
  
  - Add example to illustrate the functionality in example/conditions:
     o   examples/Conditions/src/ConditionAnyExampleObjects.cpp
     o   examples/Conditions/src/ConditionAnyExampleObjects.h
     o   plugin: examples/Conditions/src/ConditionAnyExample_populate.cpp
         Invocation:
  ```
     $> geoPluginRun  -destroy -plugin DD4hep_ConditionAnyExample_populate \
          -input ../../DD4hep/examples/AlignDet/compact/Telescope.xml -iovs 1
     ```
  
  - Plugin example to test basic functionality and verify proper assignment works
     o   examples/Conditions/src/Conditions_any_basic.cpp
         Invocation:
  ```
  $> geoPluginRun -destroy -volmgr -plugin DD4hep_Conditions_any_basic
  
  ```
  - Add 2 tests illustrating this functionality.

* 2022-07-09 Markus Frank ([PR#925](https://github.com/aidasoft/DD4hep/pull/925))
  Easy possibility to store condition payloads as std::any.
  - Use of specialized handle class `dd4hep::ConditionAny` to support the functionality.
    The payload is automatically bound to an object of type std::any.
    Example code of constructor and how to access data:
     ```
    /// Emplacement construction
    std::vector<int> value;
    ... // fill data
    ConditionAny c2("name", "type", std::move(value));
  
    /// Construct conditions object with empty std::any	 
    ConditionAny c2("name", "type");
    /// Assign data (empty vector<int>) to the payload:
    c2.get() = vector<int>();
  
    /// Access data:
    vector<int>& data = c2.as<vector<int> >();
       ```
     as a corollary to this approach these conditions can only be stored and retrieved from ROOT storage 
     if the requirement for ROOT are satisfied. Otherwise no other restrictions are imposed. 
     The corresponding grammar instance is part of the library.
  
  - Add example to illustrate the functionality in example/conditions:
     o   examples/Conditions/src/ConditionAnyExampleObjects.cpp
     o   examples/Conditions/src/ConditionAnyExampleObjects.h
     o   plugin: examples/Conditions/src/ConditionAnyExample_populate.cpp
         Invocation:
  ```
     $> geoPluginRun  -destroy -plugin DD4hep_ConditionAnyExample_populate \
          -input ../../DD4hep/examples/AlignDet/compact/Telescope.xml -iovs 1
     ```
  
  - Plugin example to test basic functionality and verify proper assignment works
     o   examples/Conditions/src/Conditions_any_basic.cpp
         Invocation:
  ```
  $> geoPluginRun -destroy -volmgr -plugin DD4hep_Conditions_any_basic
  
  ```

* 2022-07-07 Andre Sailer ([PR#922](https://github.com/aidasoft/DD4hep/pull/922))
  - LCIOOutput: Fix exception when trying to use a readout for different sub-detectors
  - EDM4hepOutput: Fix memory leak when re-using readouts for different sub-detectors

* 2022-06-16 Markus Frank ([PR#917](https://github.com/aidasoft/DD4hep/pull/917))
  -- Improve error reporting if derived condition dependencies cannot be resolved 
  -- Add illustrating example

* 2022-06-14 Paul Gessinger ([PR#911](https://github.com/aidasoft/DD4hep/pull/911))
  - Add `VariantParameters` extension + plugin to assign parameters to it by name.

* 2022-06-08 Andre Sailer ([PR#914](https://github.com/aidasoft/DD4hep/pull/914))
  - DDSim: add possibility to use individual compact files, e.g.:
      ddsim --compactFile $DD4hep/examples/CLICSiD/compact/SiD_multiple_inputs.xml $DD4hep/examples/CLICSiD/compact/SiD_detectors_1.xml  $DD4hep/examples/CLICSiD/compact/SiD_detectors_2.xml $DD4hep/examples/CLICSiD/compact/SiD_close.xml --runType shell

* 2022-05-18 Andre Sailer ([PR#912](https://github.com/aidasoft/DD4hep/pull/912))
  - Detector: some corrections to the function docstrings

* 2022-05-09 Marco Clemencic ([PR#910](https://github.com/aidasoft/DD4hep/pull/910))
  - Plugin Service: check that the `LD_LIBRARY_PATH` (or `PATH` or `DYLD_LIBRAY_PATH`) are actually set before trying to use them (to avoid a crash)

* 2022-04-29 Andre Sailer ([PR#908](https://github.com/aidasoft/DD4hep/pull/908))
  -  CMake: add a message about how to avoid errors when manuals cannot be build, fixes #907

* 2022-04-28 Juraj Smiesko ([PR#906](https://github.com/aidasoft/DD4hep/pull/906))
  - bootstrap script runs all tests

* 2022-04-28 Andre Sailer ([PR#905](https://github.com/aidasoft/DD4hep/pull/905))
  - SegmentationInterna: fix shadow warning for `s`
  - DDEve: fix shadow warnings for menuBar (bar), s

# v01-20-02

* 2022-04-04 Sanghyun Ko ([PR#902](https://github.com/aidasoft/dd4hep/pull/902))
  - Fix a bug that cannot set G4 const property, following up #884

* 2022-03-30 Valentin Volkl ([PR#899](https://github.com/aidasoft/dd4hep/pull/899))
  - cmake: DD4hepConfig: Drop unnecessary call to DD4HEP_SETUP_BOOST_TARGETS

* 2022-03-30 Markus Frank ([PR#898](https://github.com/aidasoft/dd4hep/pull/898))
  - Reduce coverity warnings

* 2022-03-21 Markus Frank ([PR#897](https://github.com/aidasoft/dd4hep/pull/897))
  See for the example
  -- /examples/ClientTests/src/MaterialTester_geo.cpp
  -- /examples/OpticalSurfaces/compact/ReadMaterialProperties.xml
  -- /examples/OpticalSurfaces/scripts/ReadMaterialProperties.py
  
  The python file is only there to show that the G4 simulation does not get screwed.....
  Otherwise: to define properties, which do not participate in Geant4:
  ```
      <material name="Water">
        <D type="density" value="1.0" unit="g/cm3"/>
        <composite n="2" ref="H"/>
        <composite n="1" ref="O"/>
        <!-- Properties used by Geant4    -->
        <property name="RINDEX"        ref="RINDEX__0x123aff00"/>
        <property name="ABSLENGTH"     ref="ABSLENGTH__0x123aff00"/>
        <property name="FASTCOMPONENT" ref="FASTCOMPONENT__0x123aff00"/>
        <property name="SLOWCOMPONENT" ref="SLOWCOMPONENT__0x123aff00"/>
        <!-- Properties ignored by Geant4 -->
        <property name="Property_of_mine" ref="Water__0x123aff00"/>
        <constant name="BirksConstant"    ref="Birk__Water|Geant4-ignore"/>
        <!-- Constants  ignored by Geant4 -->
        <constant name="Constant_of_mine" ref="Water__Mine|Geant4-ignore"/>
      </material>
  ```
  where:
  ```
    <properties>
      <constant name="Birk__Water|Geant4-ignore" value="12.345678"/>
      <constant name="Water__Mine|Geant4-ignore" value="87.654321"/>
    </properties>
  ```
  and
  ```
      <matrix name= "Water__0x123aff00" option="Geant4-ignore" coldim="1" values="  
                2.034*eV 
                2.068*eV 
                2.103*eV 
                2.139*eV 
                2.177*eV 
                2.216*eV 
      "/>
    </properties>
  ```
  For non-const properties you have to set the option to "Geant4-ignore",
  otherwise you append the string to the name. The "ref" string in the material
  and the property must match.
  In the program you can then access the propertiers by name like this:
  ```
  Material material(...)
  double v = material->GetConstProperty("BirksConstant");
  TGDMLMatrix* m = material->GetProperty("Property_of_mine");
  ```
  like any other property. See for details:
  /examples/ClientTests/src/MaterialTester_geo.cpp lines 78-108

* 2022-03-21 Wouter Deconinck ([PR#896](https://github.com/aidasoft/dd4hep/pull/896))
  - edm4hep: don't add particle as parent to its daughters, and vice versa

* 2022-03-15 Paul Gessinger ([PR#895](https://github.com/aidasoft/dd4hep/pull/895))
  - Allow relaxing the python version requirements at CMake level via option `DD4HEP_RELAX_PYVER`.

# v01-20-01

* 2022-03-08 Markus FRANK ([PR#894](https://github.com/AIDASoft/DD4hep/pull/894))
  - The refactoring of namespaces (some years ago) left some factory name discrepancies in DDEve.
  This PR fixes them and re-enables the various views and projections.
  See issue https://github.com/AIDASoft/DD4hep/issues/893.
  - There are still some issues when loading a new file, which are not yet entirely understood.
  The suspicion is that the displayed 2D histograms somehow "reside" in the opened file and disappear
  when the file is closed. This however needs confirmation (and eventually fixing).

* 2022-03-04 Wouter Deconinck ([PR#892](https://github.com/AIDASoft/DD4hep/pull/892))
  - Support `ddsim --gun.momentumMin 1*GeV --momentumMax 10*GeV` (default remains momentumMin = 0.0)

* 2022-02-25 Andre Sailer ([PR#891](https://github.com/AIDASoft/DD4hep/pull/891))
  - DDParsers: do not use deprecated boost headers with boost 1.78
  - DDG4 Particle.tbl: drop some diffr(active) particles causing warnings with Geant4 11.0
  - DetectorIMP: Changing message about Geant4 unit system to INFO, fixes #844
  - Volumes: Changing message about REFLECTION to DEBUG, fixes #844

Andre Sailer's avatar
Andre Sailer committed
# v01-20

* 2021-12-21 Markus Frank ([PR#888](https://github.com/aidasoft/DD4hep/pull/888))
  - Changes for Geant4 11.0.0.
    Propagate additional setup properties for optical parameters in Geant4ScintillationPhysics.
    Other required changes were already included when preparing for the Geant4 beta release.
  - Allow for Geant4 builds without GDML.
    Enable conditional build if the Geant4 build does not support GDML

* 2021-12-16 Thomas Madlener ([PR#887](https://github.com/aidasoft/DD4hep/pull/887))
  - Rework the EDM4hep output action. The major reason is the renaming of the default types in AIDASoft/podio#205 and its effects on EDM4hep (key4hep/EDM4hep#132). These changes are:
    - Use `auto` wherever possible to remove any explicit mentioning of EDM4hep types.
    - Switch to range-based for-loops where possible
    - Keep an internal map of the collections to get rid of the `const_cast`s that were used before.
  - EDM4hep output: Make sure that the daughter relations are also set, because that is not done automatically in EDM4hep but is in LCIO.

* 2021-12-02 Wouter Deconinck ([PR#886](https://github.com/aidasoft/DD4hep/pull/886))
  - Add diquarks to default DDG4 rejectPDGs list

* 2021-11-26 Markus Frank ([PR#885](https://github.com/aidasoft/DD4hep/pull/885))
  - Remove another occurrency of a call to G4::GetPropertyIndex() with 2nd argument.
  - This PR is an addendum to the already closed request https://github.com/AIDASoft/DD4hep/pull/884

* 2021-11-22 Markus Frank ([PR#884](https://github.com/aidasoft/DD4hep/pull/884))
  - Issue https://github.com/AIDASoft/DD4hep/issues/881
    Next attempt for resolution. Avoid explicit use of the second argument in 
  ```
    G4int GetConstPropertyIndex(const G4String& key,
                                G4bool warning = false) const;
    // Get the constant property index from the key-name
  
    G4int GetPropertyIndex(const G4String& key, G4bool warning = false) const;
    // Get the property index by the key-name.
    ```
    Should satisfy existing and future snapshots of Geant4.

Andre Sailer's avatar
Andre Sailer committed
# v01-19

* 2021-11-12 Markus Frank ([PR#882](https://github.com/aidasoft/DD4hep/pull/882))
  - See issue in github: https://github.com/AIDASoft/DD4hep/issues/881
  - Material properties have changed in Geant4 between version 10 and 11.
  - This fix should fix the compilation problems and take new properties in Geant4.11 into account.

* 2021-11-12 MarkusFrankATcernch ([PR#876](https://github.com/aidasoft/DD4hep/pull/876))
  - Fix cmake issue when using cmake 3.16.3 (or any of the other versions of cmake that require special python version handling presumably) in a dependent package.

* 2021-11-10 Ben Couturier ([PR#880](https://github.com/aidasoft/DD4hep/pull/880))
  - Added the default move constructor and default move assignment operator to dd4hep::detail::ConditionObject and dd4hep::NamedObject

* 2021-11-03 Markus Frank ([PR#877](https://github.com/aidasoft/DD4hep/pull/877))
  - To not compromize client code with an enforced termination handler, the DD4hep termination handler
  moved to DDG4, where it actually is needed. In DDG4 the termination handler is activated when the main
  Geant4Kernel instance is created.
  Reasoning: Please see issue https://github.com/AIDASoft/DD4hep/issues/874 .
  - Throw an exception if clients ask a DetElement handle for a child by name if such a child is not present or the handle is invalid. This is the new default now. The old behaviour is kept with a second accessor for children by name, with an explicit statement that an exception is unwanted such as: child = DetElement::child("name", false)
  Please see issue: https://github.com/AIDASoft/DD4hep/issues/878.

* 2021-10-13 Markus Frank ([PR#873](https://github.com/aidasoft/DD4hep/pull/873))
  - Remove internal classes from evaluator. Use STL provided classes 
  - Remove hidden clashes with CLHEP evaluator (move internal class Item to anonymous namespace)

* 2021-09-22 Wouter Deconinck ([PR#872](https://github.com/aidasoft/DD4hep/pull/872))
  - Allow for specifying MomentumMin and MomentumMax in Geant4IsotropeGenerator

* 2021-09-15 Markus Frank ([PR#871](https://github.com/aidasoft/DD4hep/pull/871))
  - Finalize CAD stuff.
  - Fix issue https://github.com/AIDASoft/DD4hep/issues/870

Andre Sailer's avatar
Andre Sailer committed
# v01-18

* 2021-09-07 Wouter Deconinck ([PR#869](https://github.com/aidasoft/DD4hep/pull/869))
  - Use G4OpticalParameters in geant4.10.7 and newer

* 2021-09-06 Andre Sailer ([PR#863](https://github.com/aidasoft/DD4hep/pull/863))
  - DDSim: add possibility for users to inject configurations for their own output plugins. See example in OutputConfig section of the steering file

* 2021-08-31 Markus Frank ([PR#867](https://github.com/aidasoft/DD4hep/pull/867))
  - Mainly update reference files for CAD shape tests, since the order of the vertices changed when adding facets
    with vertex indices rather than coordinates.

* 2021-08-30 Markus Frank ([PR#866](https://github.com/aidasoft/DD4hep/pull/866))
  - The export of beoolean shapes (union, subtraction, intersection) to was not properly working
    and actually casued segment vialotions. This PR fixes the problem and handles these shapes
    properly using the RootCsg operations for boolean shapes.
  - Examples geometries were provided by Gerri from FCC:  examples/ClientTests/compact/FCCmachine and files thereein.
  - Test example is in DDCAD:   DDCAD_export_FCC_machine and DDCAD_import_FCC_machine
  - This PR addresses the issues: https://github.com/AIDASoft/DD4hep/issues/813 , https://github.com/AIDASoft/DD4hep/issues/858

* 2021-08-25 Markus Frank ([PR#865](https://github.com/aidasoft/DD4hep/pull/865))
  - In cmake tests use the macro ${Python_EXECUTABLE} to invoke the python interpreter rather than
    only `python`.
  - if  `FIND_PACKAGE(Python ${REQUIRE_PYTHON_VERSION} EXACT QUIET COMPONENTS Interpreter)`
    does not resolve the python executable fall back to `python${Python_VERSION_MAJOR}`.

* 2021-08-24 Markus FRANK ([PR#864](https://github.com/aidasoft/DD4hep/pull/864))
  - Support for multiple readouts or (G4VUserParallelWorld equivalent)
    Issue https://github.com/AIDASoft/DD4hep/issues/861
    Example: 
    examples/CLICSiD/compact/SiD_ECAL_Parallel_Readout.xml + 
    examples/CLICSiD/scripts/SiD_ECAL_Parallel_Readout.py
  
    For a given subdetector the sequence of sensitive actions can be enhanced
    having multiple sensitive actions where each one can have its own Readout
    definition. Hence each action can produce its own set of hits depending on the
    readout geometry (segmentation).
    in XML these readout structures must first be defined:
  ```
    <readouts>
      <readout name="EcalBarrelHits">
        <segmentation type="CartesianGridXY" grid_size_x="3.5" grid_size_y="3.5" />
        <id>system:8,barrel:3,module:4,layer:6,slice:5,x:32:-16,y:-16</id>
      </readout>        
  
      <readout name="EcalBarrelHits_0">
        <segmentation type="CartesianGridXY" grid_size_x="1" grid_size_y="1" />
        <id>system:8,barrel:3,module:4,layer:6,slice:5,x:32:-16,y:-16</id>
      </readout>        
   ....
    </readouts>
  
  ```
  and can then be assigned to the sensitive actions in the python setup:
  ```  det = str('EcalBarrel')
    typ = sid.geant4.sensitive_types['calorimeter']
    seq = DDG4.SensitiveSequence(sid.kernel, str('Geant4SensDetActionSequence/') + det)
    seq.enableUI()
    act = DDG4.SensitiveAction(sid.kernel, str(typ + '/EcalBarrelHandler'), det)
    act.enableUI()
    seq.add(act)
    # Add extra parallel readout action with readout EcalBarrelHits_0
    act = DDG4.SensitiveAction(sid.kernel, str(typ + '/EcalBarrelHandler_0'), det)
    act.ReadoutName = 'EcalBarrelHits_0'
    act.enableUI()
    seq.add(act)
    # Add extra parallel readout action with readout EcalBarrelHits_1
    act = DDG4.SensitiveAction(sid.kernel, str(typ + '/EcalBarrelHandler_1'), det)
    act.ReadoutName = 'EcalBarrelHits_1'
  ...
  ```

* 2021-08-10 Wouter Deconinck ([PR#860](https://github.com/aidasoft/DD4hep/pull/860))
  - Optionally import gdml physvol below top level, avoiding world

* 2021-08-03 Valentin Volkl ([PR#855](https://github.com/aidasoft/DD4hep/pull/855))
  - [testing] separate import test for ddg4 and rest of dd4hep

* 2021-07-29 Markus FRANK ([PR#853](https://github.com/aidasoft/DD4hep/pull/853))
  - Implement fix as proposed in issue https://github.com/AIDASoft/DD4hep/issues/850.

* 2021-07-27 Whitney Armstrong ([PR#851](https://github.com/aidasoft/DD4hep/pull/851))
  - Using `ref="OtherVisName"` attribute with the `vis` tag, the visualization attribute is an extension of
  `"OtherVisName"` which is used to initialize the new vis attribute.
   - The new VisAttr inherits all the properties  of the ref and additional arguments override these values.
  
  Example where the only difference is the `alpha` value.
  
  ```
    <vis name="SiVertexBarrelModuleVis"
         alpha="1.0" r="1.0" g="0.75" b="0.76"
         drawingStyle="wireframe"
         showDaughters="false"
         visible="true"/>
  
    <vis name="SiVertexEndcapModuleVis"
         ref="SiVertexBarrelModuleVis"
         alpha="0.5"/>
  ```

* 2021-07-22 Whitney Armstrong ([PR#849](https://github.com/aidasoft/DD4hep/pull/849))
  - Fix G4Sphere construction to use delta theta/phi instead of TGeo's ending angles phi2/theta2.

* 2021-07-21 Placido Fernandez Declara ([PR#847](https://github.com/aidasoft/DD4hep/pull/847))
  - EDM4hepOutput: On collection creation for EDM4hep, save CellIDEncodingString

* 2021-06-24 Thomas Madlener ([PR#843](https://github.com/aidasoft/DD4hep/pull/843))
  - Explicitly enable `C` as language to avoid problems in the build file generation step of cmake (see spack/spack#24232)

# v01-17-00

* 2021-06-02 Andre Sailer ([PR#838](https://github.com/aidasoft/DD4hep/pull/838))