ReleaseNotes.md

# 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

# 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.

# 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

# 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))
  - Geant4ShapeConverter: ExtrudedSolid: convert all vertices, fix #836, https://github.com/cms-sw/cmssw/issues/33656

* 2021-06-01 Marko Petric ([PR#840](https://github.com/aidasoft/DD4hep/pull/840))
  - Do not propagate CMAKE_BUILD_TYPE in DD4hepConfig.cmake

* 2021-05-27 Markus FRANK ([PR#835](https://github.com/aidasoft/DD4hep/pull/835))
  - On divisions the created solids did not carry the proper tag to identify them.
    This PR fixes this issue when multi-volumes are imported in dd4hep.
    See issue https://github.com/AIDASoft/DD4hep/issues/833

* 2021-05-17 Markus FRANK ([PR#829](https://github.com/aidasoft/DD4hep/pull/829))
  - Add missing Solid instantiation for TGeoCtub

* 2021-05-12 Andre Sailer ([PR#823](https://github.com/aidasoft/DD4hep/pull/823))
  - DDSim: add possibility for users to extend the physics setup with Physics.setupUserFunction

* 2021-05-07 Markus FRANK ([PR#825](https://github.com/aidasoft/DD4hep/pull/825))
  - Fix as reported from CMS

* 2021-05-01 Markus FRANK ([PR#821](https://github.com/aidasoft/DD4hep/pull/821))
  - Fix issue #820

* 2021-04-27 Andre Sailer ([PR#817](https://github.com/aidasoft/DD4hep/pull/817))
  - Move `create_segmentation` to DDCore/include/DD4hep/detail/SegmentationsInterna.h  to allow segmentation creation in other libraries
  - Removed REGISTER_SEGMENTATION macro and DDSegmentation::SegmentationFactory class because they are obsolete. Use DECLARE_SEGMENTATION to create a plugin entry for segmentations.

* 2021-04-24 Markus FRANK ([PR#816](https://github.com/aidasoft/DD4hep/pull/816))
  - Following requests, the support to output Volumes as CAD meshes.
    Depending on the underlying technology material names and visual attributes are supported
  - Improve CAD imports to take into account material names and visual attributes if supported
    by the underlying CAD format.
  - Add two examples showing the import and export technique.

* 2021-04-15 Markus FRANK ([PR#809](https://github.com/aidasoft/DD4hep/pull/809))
  - DDG4: Extend existing sensitive detectors to be used for GFlash parametrized fast simulations
  - DDG4: Remove legacy sensitive detectors, since they are no longer used by FCC

* 2021-04-15 Markus FRANK ([PR#808](https://github.com/aidasoft/DD4hep/pull/808))
  - Disable copy and move construction/assignment in Geant4 data
    See issue https://github.com/AIDASoft/DD4hep/issues/807
  - Adopt new naming convention for Geant4 assembly imprints
     See issue https://github.com/AIDASoft/DD4hep/issues/804
  - Add G4FastSimulationManagerProcess for GFlash

* 2021-04-12 Marko Petric ([PR#803](https://github.com/aidasoft/DD4hep/pull/803))
  - Fix bug in evaluator reported by Coverity

# v01-16-01

* 2021-03-26 Andre Sailer ([PR#799](https://github.com/AIDASoft/DD4hep/pull/799))
  - DDG4: flush the geant4 strstream buffer after run. fixes #798

* 2021-03-26 Marko Petric ([PR#793](https://github.com/AIDASoft/DD4hep/pull/793))
  - Account for possible units rounding bug in Tube creation (address #784 )

* 2021-03-23 Andre Sailer ([PR#797](https://github.com/AIDASoft/DD4hep/pull/797))
  - DDG4Dict: Adapt to changes in Root 6.24

* 2021-03-23 Andre Sailer ([PR#796](https://github.com/AIDASoft/DD4hep/pull/796))
  - RootDictionary: fix incompatibility with Root 6.24

* 2021-03-23 Andre Sailer ([PR#795](https://github.com/AIDASoft/DD4hep/pull/795))
  - Geant4Input: Add debug output for accepting or rejecting Particles

* 2021-03-14 Markus FRANK ([PR#794](https://github.com/AIDASoft/DD4hep/pull/794))
  - Address Coverity issues

* 2021-03-12 Marko Petric ([PR#792](https://github.com/AIDASoft/DD4hep/pull/792))
  - Use `CMAKE_SHARED_LIBRARY_SUFFIX` to define suffix of assimp libs
  - Define `BUILD_BYPRODUCTS` for compatibility with `ninja`

* 2021-03-12 Markus FRANK ([PR#791](https://github.com/AIDASoft/DD4hep/pull/791))
  - Remove a bunch of Coverity warnings.

* 2021-03-12 MarkusFrankATcernch ([PR#790](https://github.com/AIDASoft/DD4hep/pull/790))
  - update materialBudget utility
      -  allow to optionally use pseudo rapidity eta rather than polar angle

* 2021-03-12 Marko Petric ([PR#788](https://github.com/AIDASoft/DD4hep/pull/788))
  - Use flag `--as-needed` for GNU linkers

* 2021-03-11 Markus FRANK ([PR#789](https://github.com/AIDASoft/DD4hep/pull/789))
  - Fix several coverity warnings
  - Fix bug in extracting unsigned int/long from xml: conversion to unsigned values had a bug.
  - Remove unnecessary printout in Geant4Converter

# v01-16

* 2021-03-02 Markus FRANK ([PR#787](https://github.com/AIDASoft/DD4hep/pull/787))
  - Resolves #786. Also add an example to reproduce the Fix.
  - Add protection in Detector object against registering DetElements without placement
  - Modernize loop handling according to C++ 17 standards

* 2021-02-15 Andre Sailer ([PR#783](https://github.com/AIDASoft/DD4hep/pull/783))
  - Adapt to new ROOT mechanism for switching the unit system.
    Units can be switched now multiple times provided the units are unlocked in the TGeoManager.
    See TGeoManager::LockDefaultUnits(Bool_t new_value).
    This is only available for ROOT versions >= 6.22.08
  - Improve examples/Conditions. Allow for more complex dependencies. Not enabled by default.

* 2021-01-31 Markus FRANK ([PR#779](https://github.com/AIDASoft/DD4hep/pull/779))
  - Propagate changes in ComponentCast to the EDM module

* 2021-01-30 Markus FRANK ([PR#778](https://github.com/AIDASoft/DD4hep/pull/778))
  - Move the header DD4hep/detail/Grammar_parsed.h to DD4hep/GrammarParsed.h
  - Move the header DD4hep/detail/Grammar_unparsed.h to DD4hep/GrammarUnparsed.h
  - Try to improve type agnostic ABI cast. Works for down casts only.

* 2021-01-08 Markus FRANK ([PR#772](https://github.com/AIDASoft/DD4hep/pull/772))
  - This is the first release prepared to use Geant4 units (mm,ns,MeV). This compilation mode can be steered by a cmake flag: `-DDD4HEP_USE_GEANT4_UNITS=ON`. Once set, the flag is automatically propagated to depending projects in the generated `DD4hepConfig.cmake`. It programs TGeo to use the Geant4 units system. The unit system is applied also to depending quantities like interaction lengths etc.
  - Update some tests and ensure compatibility in the checks/reference files for both unit system. There is one caveat: Mesh-creation of shapes depends to some degree on the unit system, because mesh points are  removed depending on a tolerance value which is the same for both systems.
  - A fix had to be applied to propagate the flag `DD4HEP_BUILD_DEBUG` to depending projects.  This flag affects some object layouts and hence MUST be applied also to depending projects.
  - Remove inclusions of `Plugins.h` from being processed by rootcling. Plugins.h uses `#include <any>`, which cannot be processed.

* 2020-12-18 Marko Petric ([PR#771](https://github.com/AIDASoft/DD4hep/pull/771))
  - Expand list of cmake versions that have bug in detecting python version  (see AIDASoft/podio#162)

# v01-15

* 2020-12-08 Frank Gaede ([PR#740](https://github.com/AIDASoft/DD4hep/pull/740))
  - add back the  Geant4Output2EDM4hep plugin from EDM4hep
       - use optional flag `D4HEP_USE_EDM4HEP` to build this
       - requires podio and EDM4hep to be present
  - fix treatment of units in Geant4Output2EDM4hep
  - DDTest: add optional ddsim tests with edm4hep and lcio output (A.Sailer)
  - enable `D4HEP_USE_EDM4HEP` in CI for dev (A.Sailer)

* 2020-12-07 Christopher Jones ([PR#767](https://github.com/AIDASoft/DD4hep/pull/767))
  - Made internal classes used by Evaluator to be less stateful
  - Switch to using a read/write lock as modifications to the Evaluator are much less frequent than reads.
  - Added unit test for Evaluator

* 2020-12-04 Andre Sailer ([PR#766](https://github.com/AIDASoft/DD4hep/pull/766))
  - DDG4: hepmc3reader: add checks for read and skip success
  - DDTest: test hepmc3 reader, make lcio and hepmc3 reader tests depend on configuration.

* 2020-12-04 Andre Sailer ([PR#765](https://github.com/AIDASoft/DD4hep/pull/765))
  - DDG4: Geant4InputHandling: create particle with 4 vector (vecP, E), solves issue where the dynamic mass differs from the PDG mass (e.g., via particle.tbl / extraParticles), #760

* 2020-12-03 MarkusFrankATcernch ([PR#753](https://github.com/AIDASoft/DD4hep/pull/753))
  - Always use `CLHEP/Units/SystemOfUnits.h` and never `G4SystemOfUnits.hh`
    -  in `G4SystemOfUnits.hh`units are directly in the top level namespace
    - in `CLHEP/Units/SystemOfUnits.h` units are in the `CLHEP::` namespace
  - Remove all usage `using namespace CLHEP` and `using CLHEP::__some_unit__` to clarify which unit is used

* 2020-12-02 MarkusFrankATcernch ([PR#764](https://github.com/AIDASoft/DD4hep/pull/764))
  - Make scaled shapes includes conditional on Geant4 version (>=10.3)
  - Improve thread safety of expression evaluator

* 2020-12-02 Andre Sailer ([PR#754](https://github.com/AIDASoft/DD4hep/pull/754))
  - ddsim: fix problem with `--dumpSteeringFile` in python3
  - ddsim: fix issue in where isotrop was False, when distribution was set (python3)
  - ddsim: fix exception in exceptions for gun direction and position
  - ddsim: fix problem where `hepmc.useHepMC3` was always True by default
  - PluginManager: rename the listcomponents executable to listcomponents_dd4hep, to avoid clash with the Gaudi listcomponents. This is transparent for users of the dd4hep_add_plugin cmake macro.
  - DDG4Dict: remove `dd4hep::sim::Geant4InputAction::Particles;` as this is available under a different name, fixes warning
  - CMake: DD4hepConfig.cmake: use find_dependency with CONFIG for Geant4, TBB, ROOT, LCIO, and if needed CLHEP, to avoid accidental use of `Find<PACKAGE>.cmake` modules

* 2020-11-24 MarkusFrankATcernch ([PR#757](https://github.com/AIDASoft/DD4hep/pull/757))
  - Expression evaluation was not protected against race conditions when executing in multiple threads. We lock now the evaluation namespace with an associated lock when evaluating expression statements. Each evaluation call is wrapped and protected. This should ensure thread safety.

* 2020-11-24 Marko Petric ([PR#751](https://github.com/AIDASoft/DD4hep/pull/751))
  - Resolve which type of linker is used and assign proper linking flags

* 2020-11-21 Markus FRANK ([PR#756](https://github.com/AIDASoft/DD4hep/pull/756))
  - Remove from Geant4 conversion of scaled shapes artifacts of the prior implementation of reflections.
    This was a wrong implementation and should now be fixed.
    This PR should fix issue https://github.com/AIDASoft/DD4hep/issues/750
  - Introduce the Scale (based on TGeoScaledShape) as a separate shape om DD4hep.
  - Add test for scaled shape

* 2020-11-19 Marko Petric ([PR#749](https://github.com/AIDASoft/DD4hep/pull/749))
  - Add explanation of the system of units to the user manual

* 2020-11-19 MarkusFrankATcernch ([PR#748](https://github.com/AIDASoft/DD4hep/pull/748))
  - Review documentation
    o Add chapter to describe MC truth handling for DDG4
    o Review shape and shape plugin section in the DD4hep manual
  - Adapt ConeSegment shape plugin to allow for standard syntax
  - Fix Torus shape plugin and test 
  - Add copyright notice to various test files

* 2020-11-19 Ole Hansen ([PR#745](https://github.com/AIDASoft/DD4hep/pull/745))
  - Improve path handling in setup scripts, by avoiding duplicates in paths. Also support whitespaces in paths and don't add system paths to library paths on macOS

* 2020-11-19 Ole Hansen ([PR#743](https://github.com/AIDASoft/DD4hep/pull/743))
  - Fix compilation warnings from Apple Clang 12
  - Fix broken `t_CLICSiD_DDG4_g4geometry_scan_LONGTEST` test condition which always matched.

* 2020-11-18 Ole Hansen ([PR#744](https://github.com/AIDASoft/DD4hep/pull/744))
  - CMake: Fix regression that examples and example tests can now be built and run together with the main project

* 2020-11-16 Markus FRANK ([PR#747](https://github.com/AIDASoft/DD4hep/pull/747))
  - Add documentation of DDG4 Monte-Carlo truth handler
  - Add documentation of DDG4 ROOT output module

* 2020-11-13 Markus FRANK ([PR#742](https://github.com/AIDASoft/DD4hep/pull/742))
  - Add example for CMS CSC: tests divisions
  - Add example for CMS ECAL: tests reflections
  - Improve DDG4_MySensDet: Example illustrating how to have customized sensitive detectors and user defined hit classes with data saved to ROOT. Example corresponding to question raised in https://github.com/AIDASoft/DD4hep/issues/703
  The example also includes a small script to read back the data generated with this example:
  Command line usage:
     *  $> root.exe
     *  ....
     *  root [0] gSystem->Load("libDDG4Plugins.so");
     *  root [1] gSystem->Load("libDDG4_MySensDet.so");
     *  root [2] SomeExperiment::Dump::dumpData(<num-ebents>,<file-name>);
  
  - Remove the odd shadowing warning.
  - Improve visualization attributes:
    As reported by Sanhyung Ko (https://indico.cern.ch/event/967418/contributions/4075358/attachments/2128099/3583278/201009_shKo_dd4hep.pdf) the application of visual attributes to volumes was very resource intensive. 
    This should be fixed by asking for the transparent color only once at the level of the attribute rather then for each volume.

* 2020-11-11 Frank Gaede ([PR#738](https://github.com/AIDASoft/DD4hep/pull/738))
  - fix units in DDG4/LCIO conversions  
       - prepend namespace CLHEP where missing

* 2020-11-10 Markus FRANK ([PR#736](https://github.com/AIDASoft/DD4hep/pull/736))
  - Update DDCMS example to take into account new xml tags.
  - Improve some core object helpers

* 2020-11-06 Markus FRANK ([PR#734](https://github.com/AIDASoft/DD4hep/pull/734))
  - No new implementation for reflections. Still uses TGeo way with scaled shape.
    This implementation is not supposed to be used.
  - Added test to debug reflections

* 2020-11-05 Ianna Osborne ([PR#732](https://github.com/AIDASoft/DD4hep/pull/732))
  - Examples.DDCMS: add CMS EcalEndcap description to test reflected volumes

* 2020-11-03 Andre Sailer ([PR#731](https://github.com/AIDASoft/DD4hep/pull/731))
  - Tests: Always run AClick tests sequentially, fixes #730

* 2020-11-03 Andre Sailer ([PR#728](https://github.com/AIDASoft/DD4hep/pull/728))
  * CMake: fix python version compatibility check between python and root used for python. Add exception for CMake 3.17.1
  * Tests: fix some test configuration to run all tests after `-D DD4HEP_BUILD_EXAMPLES=ON`
  * Tests: fix tests for root 6.22.04 and master

* 2020-11-02 Andre Sailer ([PR#725](https://github.com/AIDASoft/DD4hep/pull/725))
  -  CMake: fail if ROOT and DD4hep python disagree

* 2020-10-14 Ianna Osborne ([PR#723](https://github.com/AIDASoft/DD4hep/pull/723))
  - SpecParRegistry: remove need for TBB
    - TBB has a slight overhead compare to std containers
    - Using std containers allows to return references to the containers in the registry
  
  - Reverse the plan to process XML files in parallel

# v01-14-01

* 2020-10-02 Markus Frank ([PR#720](https://github.com/AIDASoft/DD4hep/pull/720))
  - Add the ability to access the `DetElement` in a derived condition. Access to it is enabled now for all
  compilations (Debug + Release).
  - When parsing compact, it is possible to inject plugins to create tables with tabulated properties in C++
  - When parsing compact, it is possible to inject plugins to assign property tables to materials.

* 2020-09-28 Marko Petric ([PR#718](https://github.com/AIDASoft/DD4hep/pull/718))
  - Replace deprecated `PyOS_AfterFork` with `PyOS_AfterFork_Child` for python 3.7 and above

# v01-14

* 2020-09-26 Markus Frank ([PR#717](https://github.com/aidasoft/dd4hep/pull/717))
  - Propagate condition names for printouts. Names are enabled by default. The feature can be disabled
    to minimize conditions memory footprint. Comment `DD4HEP_CONDITIONS_HAVE_NAME` in `DD4hep/config.h`
  
  - If the debug flag `DD4HEP_CONDITIONS_DEBUG` is set (enabled by the compile definition `DD4HEP_DEBUG`, which in turn is enabled by the cmake flag `DD4HEP_BUILD_DEBUG`, which is turned on in debug builds automatically), then condition objects offer optional storage e.g. to store the object address or an xml-string etc.
  
  - Update and fix some tests, which were assuming names

* 2020-09-25 Marko Petric ([PR#715](https://github.com/aidasoft/dd4hep/pull/715))
  - Rename `TruncatedTube` `zHalf` accessor with `dZ` resolves #714 
  - Add to `Trap` missing `dZ` accessor resolves #713

* 2020-09-23 Andre Sailer ([PR#712](https://github.com/aidasoft/dd4hep/pull/712))
  - Cmake: add configuration option DD4HEP_BUILD_DEBUG, if ON or OFF enable or disable the DD4HEP_DEBUG definition
  if not set, enable if BuildType is Debug, fixes #708

* 2020-09-23 bcouturi ([PR#709](https://github.com/aidasoft/dd4hep/pull/709))
  - Added geoWebDisplay command that uses jsroot to render the Geometry, requires ROOT7 ROOTEve

* 2020-09-23 Andre Sailer ([PR#707](https://github.com/aidasoft/dd4hep/pull/707))
  - DDG4.HepEvtReader: fix reading of input particles, fixes #706 
  - DDG4.HepEvtReader: fix the units, expecting GeV, mm as units of input files.
  - DDG4.HepEvtReader: add abort if the file cannot be read, e.g., when the content doesn't match what is expected

* 2020-09-22 Marko Petric ([PR#710](https://github.com/aidasoft/dd4hep/pull/710))
  -  Fix variable name`SIGNATURE` in `Plugins.h` and `Plugins.inl` that conflicts with `#define` from `utmpx.h` in macOS libc implementation. Resolves #700
  - Migrate CI from Travis-CI to GitHub Actions and include macOS and ubuntu18 tests

* 2020-09-17 Marko Petric ([PR#704](https://github.com/aidasoft/dd4hep/pull/704))
  - Apply `clang-tidy` `llvm-header-guard` fixer

* 2020-09-16 Andre Sailer ([PR#705](https://github.com/aidasoft/dd4hep/pull/705))
  - DDSim: add options to select which sensitive detectors are trackers and calorimeters, defaults unchanged
  - DDSim: tweak log output formatting, logging goes now to stdout instead of stderr
  - SiD example: remove `track_length_max` and `time_max` from silicon limits (fixes part of #703 )

* 2020-09-07 Markus Frank ([PR#702](https://github.com/aidasoft/dd4hep/pull/702))
  - Add `starttheta`, `endtheta`, `endphi` xml accessors. 
  - Fix sphere shape creator and update shape example.

* 2020-09-04 Markus Frank ([PR#697](https://github.com/aidasoft/dd4hep/pull/697))
  - Implement data member accessors for construction parameters in `Shapes.h`. As discussed in the thread cms-sw/cmssw#30931 it was felt that read-only access to the basic construction parameters of a shape would be highly useful.

* 2020-09-03 Marko Petric ([PR#699](https://github.com/aidasoft/dd4hep/pull/699))
  - Set search order for python on macOS to search for system/framework python last (change in behavior of cmake 3.14->3.15)

* 2020-07-31 Markus Frank ([PR#692](https://github.com/aidasoft/dd4hep/pull/692))
  - Protect XML file handling against non-existing files.

* 2020-07-30 Markus Frank ([PR#691](https://github.com/aidasoft/dd4hep/pull/691))
  - Improve matrix helpers: Add extractors for scale and translation as `XYZVector` from `TGeoMatrix`.
  - Add example to simulate the MiniTel with DDG4 using a HepMC input file
  - Add example to load a sub-detector geometry from gdml.

* 2020-07-27 Markus Frank ([PR#690](https://github.com/aidasoft/dd4hep/pull/690))
  1) New example to show the usage of multiple compact input files being processed from the command line.
      The example illustrates how to maniplulate the opening and the closing of the geometry using the compact notation.
      ```
       geoDisplay  -input file:SiD_multiple_inputs.xml \
                           -input file:SiD_detectors_1.xml \
                           -input file:SiD_detectors_2.xml \
                           -input file:SiD_close.xml \
                           -print INFO -destroy -volmgr -load```
  2) New example to scan the geometry starting from a given position in a certain direction. Command line like for g4MaterialScan.
      The output shows then the pathes to the volumes traversed, the shape and the material of these volumes.
  
      `g4GeometryScan --compact=DDDetectors/compact/SiD.xml --position=0,0,0 --direction=0,1,0`
  
     Resulting output:
     ```
      GeometryScan                      WARN  Starting tracking action for track ID=1
      +--------------------------------------------------------------------------------------------------------------------------------------------------
      | Material scan between: x_0 = (   0.00,   0.00,   0.00) [cm] and x_1 = (   0.00,3000.00,   0.00) [cm]  TrackID:1: 
      +--------------------------------------------------------------------------------------------------------------------------------------------------
      |     \                Path                                        
      | Num. \  Thickness    Length   Endpoint                   Volume , Shape , Material
      | Layer \   [cm]        [cm]    (     cm,     cm,     cm)         
      +--------------------------------------------------------------------------------------------------------------------------------------------------
      |     1      2.4500     2.450   (   0.00,   2.45,   0.00)  Path:"/world/BeamPipeVacuum_62" Shape:G4Polycone  Mat:Vacuum
      |     2      0.0500     2.500   (   0.00,   2.50,   0.00)  Path:"/world/Beampipe_53" Shape:G4Polycone  Mat:Beryllium
      |     3      0.1802     2.680   (   0.00,   2.68,   0.00)  Path:"/world/av_3_impr_1_layer1_pv_0" Shape:G4Tubs  Mat:Air
      |     4      0.0115     2.692   (   0.00,   2.69,   0.00)  Path:"/world/av_3_impr_1_layer1_pv_0/VtxBarrelModuleInner_4" Shape:G4Box  Mat:Air
      |     5      0.0130     2.705   (   0.00,   2.70,   0.00)  Path:"/world/av_3_impr_1_layer1_pv_0/VtxBarrelModuleInner_4/component0_0" Shape:G4Box  Mat:Carbon
      |     6      0.0256     2.730   (   0.00,   2.73,   0.00)  Path:"/world/av_3_impr_1_layer1_pv_0/VtxBarrelModuleInner_4" Shape:G4Box  Mat:Air
      |     7      0.0050     2.735   (   0.00,   2.74,   0.00)  Path:"/world/av_3_impr_1_layer1_pv_0/VtxBarrelModuleInner_4/component1_1" Shape:G4Box  Mat:Silicon
      |     8      0.0050     2.740   (   0.00,   2.74,   0.00)  Path:"/world/av_3_impr_1_layer1_pv_0/VtxBarrelModuleInner_4" Shape:G4Box  Mat:Air
      |     9      0.1596     2.900   (   0.00,   2.90,   0.00)  Path:"/world/av_3_impr_1_layer1_pv_0" Shape:G4Tubs  Mat:Air
      |    10      0.7000     3.600   (   0.00,   3.60,   0.00)  Path:"/world" Shape:G4Box  Mat:Air
      |    11      0.1844     3.784   (   0.00,   3.78,   0.00)  Path:"/world/av_3_impr_1_layer2_pv_1" Shape:G4Tubs  Mat:Air
      |    12      0.0115     3.796   (   0.00,   3.80,   0.00)  Path:"/world/av_3_impr_1_layer2_pv_1/VtxBarrelModuleOuter_4" Shape:G4Box  Mat:Air
      ....
     ```

# v01-13-01

* 2020-07-10 Markus Frank ([PR#686](https://github.com/AIDASoft/DD4hep/pull/686))
  - Fix bug in `VolumeBuilder` where `VolIDs` were not properly set to physical volumes if the `xml` supported an `id` tag.

# v01-13

* 2020-07-02 MarkusFrankATcernch ([PR#684](https://github.com/AIDASoft/DD4hep/pull/684))
  - Fix compiler issue for clang 3.9 (resolves #683)

* 2020-07-02 Andre Sailer ([PR#682](https://github.com/AIDASoft/DD4hep/pull/682))
  - CMake: add option `DD4HEP_USE_TBB` to require TBB or not
  - `Filter` and `SpecParRegistry` classes from CMSSW (see #675)

* 2020-07-01 vvolkl ([PR#679](https://github.com/AIDASoft/DD4hep/pull/679))
  - Add CPack Configuration

* 2020-06-30 Markus Frank ([PR#680](https://github.com/AIDASoft/DD4hep/pull/680))
  - adopt IOV changes from @pikacic to work on macOS (see #678).

* 2020-06-30 Marco Clemencic ([PR#678](https://github.com/AIDASoft/DD4hep/pull/678))
  - Modernization and clean up of `dd4hep::IOV` (`using` instead of `typedef`, `constexpr` instead of `enum`)
  - Make `dd4hep::IOV::Key` uniform wrt first and second type
  - Use `std::int64_t`instead of `long` for `dd4hep::IOV::Key` elements

* 2020-06-18 lintao ([PR#677](https://github.com/AIDASoft/DD4hep/pull/677))
  - Fixed the `CLHEP::mm` to `dd4hep::mm` conversion problem in `DDG4/src/Geant4SensitiveDetector.cpp`

* 2020-06-11 Markus FRANK ([PR#676](https://github.com/AIDASoft/DD4hep/pull/676))
  - Fix problem with missing header in DDEve appearing in ROOT head.

* 2020-06-08 Marko Petric ([PR#673](https://github.com/AIDASoft/DD4hep/pull/673))
  - Use unique include guard in `BitFieldCoder.h`
    - fix ambiguity in test between `BitField64` in LCIO and DD4hep
  - Cast to string `coll_nam` in `DDG4.py` before using further, otherwise string concatenation does not work

* 2020-05-29 Andre Sailer ([PR#672](https://github.com/AIDASoft/DD4hep/pull/672))
  - Use unique include guards

* 2020-04-24 Frank Gaede ([PR#663](https://github.com/AIDASoft/DD4hep/pull/663))
  - fix compilation of `DigiKernel.cpp` with TBB

* 2020-04-09 Andre Sailer ([PR#660](https://github.com/AIDASoft/DD4hep/pull/660))
  - DDG4: fix behaviour of ParticleRejectFilter and ParticleSelectFilter, They now properly select or reject the given particle type, instead of the opposite. Fixes #657

* 2020-04-09 Markus FRANK ([PR#659](https://github.com/AIDASoft/DD4hep/pull/659))
  - Allow condition objects, which do not provide a default constructor. If such objects should be managed, these cannot be saved with ROOT - these objects may only live in memory. ROOT requires a default constructor.

* 2020-04-09 Marko Petric ([PR#654](https://github.com/AIDASoft/DD4hep/pull/654))
  - Rewrite rpath usage on macOS and make it relocatable with help of `@rpath`
    - itroduce new option `DD4HEP_SET_RPATH` default `ON`
  - adopt `thisdd4hep.sh` and other `.sh` scripts to work with zsh (new default for macOS 10.15)
  - Drop `MakeGaudiMap.cmake` and call directly `listcomponents`
    - fix env settings for macOS
  - Drop deprecated `-std=` flag in dictionary creation

* 2020-03-23 Andre Sailer ([PR#652](https://github.com/AIDASoft/DD4hep/pull/652))
  - Documentation: fix broken mathml, fixes #651

* 2020-03-20 Andre Sailer ([PR#649](https://github.com/AIDASoft/DD4hep/pull/649))
  - CMake: add `DD4HEP_HIGH_MEM_POOL_DEPTH` option. Allow setting of parallel builds of DDParser objects with the ninja generator. Defaults to "memory / 2000 cores (rounded down)"

* 2020-03-20 Andre Sailer ([PR#632](https://github.com/AIDASoft/DD4hep/pull/632))
  - CMake:  Adapt to ROOT 6.22 python library ROOTTPython

* 2020-03-18 Andre Sailer ([PR#636](https://github.com/AIDASoft/DD4hep/pull/636))
  - DDG4: add reader for HepMC3 files
  - DDG4: add generic EventParameters class to pass event level parameters from different input sources to different output sources, supercedes the LCIOEventParameters class

* 2020-03-11 Markus Frank ([PR#647](https://github.com/AIDASoft/DD4hep/pull/647))
  - The CAD volume plugin allows to embed valumes and shapes originating from Computer Aided Design drawings using multiple formats as they are supported by the open asset importer library (http://assimp.org ). The plugin can be used whenever the `xml` fragment matches the following pattern:
      ```xml
      <XXX ref="file-name"  material="material-name">   
        <material name="material-name"/>  <!-- alternative: child or attr -->
   
        Envelope:  Use special envelop shape (default: assembly)
                   The envelope tag must match the expected pattern of the utility
                   dd4hep::xml::createStdVolume(Detector& desc, xml::Element e)
        <envelope name="volume-name" material="material-name">
          <shape name="shape-name" type="shape-type" args....>
          </shape>
        </envelope>
   
        Option 1:  No additional children. use default material 
                   and place all children in the origin of the envelope
   
        Option 2:  Volume with default material
        <volume name="vol-name"/>
   
        Option 3:  Volume with non-default material
        <volume name="vol-name" material="material-name"/>
   
        Option 4:  Volume with optional placement. No position = (0,0,0), No rotation = (0,0,0)
        <volume name="vol-name" material="material-name"/>
          <position x="0" y="0" z="5*cm"/>
          <rotation x="0" y="0" z="0.5*pi*rad"/>
        </volume>
   
        For sensitive volumes: add physical volume IDs:
        <volume name="vol-name" material="material-name"/>
          <physvolid name="layer" value="1"/>
          <physvolid name="slice" value="10"/>
        </volume>
       </XXX>
       ```

# v01-12-01

* 2020-03-03 Marko Petric ([PR#641](https://github.com/AIDASoft/DD4hep/pull/641))
  - DDSim: make the output of `ddsim --dumpSteeringFile` visible again
  - DDSim: fix exception in ConfigHelper.printOptions, called by `--dumpParameters` option
  - DDSim: fix parsing of vector command line parameters, gun.position, gun.direction etc.
  - DDSim: better testing of command line parameters

* 2020-03-03 vvolkl ([PR#640](https://github.com/AIDASoft/DD4hep/pull/640))
  - DDSim: add option to use edm4hep output

# v01-12

* 2020-02-26 Andre Sailer ([PR#637](https://github.com/aidasoft/dd4hep/pull/637))
  - LcioEventReader: fix setting of color flow, second coordinate was never set

* 2020-02-25 Markus Frank ([PR#633](https://github.com/aidasoft/dd4hep/pull/633))
  - Added basic implementation for CAD interface to load shapes from CAD files. There is an open issue how to best embed the volume/shape loading from CAD files into the existing infrastructure. See for [presentation](https://indico.cern.ch/event/885083/contributions/3758180/attachments/1990793/3318984/2020-02-20-DD4hep-Tessellated-Shapes.pdf). This feature is only available if build against ROOT 6.22 or higher. 
  - DDCAD used the [assimp](https://github.com/assimp/assimp) librray to interprete the CAD files.
  - Simplify grammar instantiation. 
    - For grammars to be parsed with `boost::spirit` simply include
      `#include "DD4hep/detail/Grammar_parsed.h"`
    - For Grammars which should **not be parsed** with `boost::spirit` include
      `#include "DD4hep/detail/Grammar_unparsed.h"`
    - To instantiate the code and to register the instantiation call:
       `template <> dd4hep::Grammar<my-class>;`
    - If the Grammar is supposed to be registered call instead/in addition:
      `static auto s_registry = GrammarRegistry::pre_note<my-class>();`
     - All other macros are gone.