ReleaseNotes.md

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

* 2020-02-21 Andre Sailer ([PR#631](https://github.com/aidasoft/dd4hep/pull/631))
  - Only build DDG4 Python dependent libraries and pcms if Python and PyROOT are found

* 2020-02-21 Andre Sailer ([PR#627](https://github.com/aidasoft/dd4hep/pull/627))
  - MakeGaudiMap: better inference of listcomponents and library location by using target properties
  - MakeGauiMap: Detailed information about the command is not only printed when VERBOSE=1

* 2020-02-19 Marko Petric ([PR#626](https://github.com/aidasoft/dd4hep/pull/626))
  - Check in python modules that load `libglapi` is only called if the library is not already loaded.

* 2020-02-19 Sebastien Ponce ([PR#624](https://github.com/aidasoft/dd4hep/pull/624))
  - Fixed bug in the `dd4hep_add_test_reg` function which was only taking into account the last dependency of a test when several were present.

* 2020-02-19 Marko Petric ([PR#622](https://github.com/aidasoft/dd4hep/pull/622))
  - Add missing conversion from `unicode` to `str` for python 2 case in `DDrec.py`
  - Add test to check dd4hep python module imports
  - Fixes for tests from examples:
     - typo in tessellated example
     - make gdml read test dependent on the gdml write test
  - Add check to test if the version of python used to build ROOT is the same to the version detected by CMake to build DD4hep (works only from ROOT 6.20)

* 2020-02-17 Andre Sailer ([PR#621](https://github.com/aidasoft/dd4hep/pull/621))
  - Cmake: dd4hep_add_dictionary: directly use command, no longer created bash script to be called. See details of call with `make VERBOSE=1`
  - PluginServiceV2: use `boost::split` instead of walking of char arrays, fix bug when two colons are in the environment variable. Fixes #600

* 2020-02-13 Sebastien Ponce ([PR#620](https://github.com/aidasoft/dd4hep/pull/620))
  - added missing dependency of Persist_CLICSiD_Geant4 test on Persist_CLICSiD_Save_LONGTEST

* 2020-02-11 Marko Petric ([PR#618](https://github.com/aidasoft/dd4hep/pull/618))
  - Fix from which version of ROOT `TGeoTessellated` is supported (starting only in 6.22)
  - Fix location of test file in tessellated example

* 2020-02-06 Hadrien Grasland ([PR#613](https://github.com/aidasoft/dd4hep/pull/613))
  - Use the official CMake configuration mechanism provided by TBB >= 2017 U7.
  - Do not delete move constructors in DigiKernel as this breaks current versions of TBB.

* 2020-02-05 Markus Frank ([PR#610](https://github.com/aidasoft/dd4hep/pull/610))
  - Thanks to @agheata, ROOT now supports tessellated shapes. These new shapes are now supported by DD4hep including the automatic translation to Geant4. The tessellated shapes feature is only supported when compiling against ROOT 6.20.0 or higher.
  - Added a basic shape test for the tessellated shape.

* 2020-02-03 Markus Frank ([PR#608](https://github.com/aidasoft/dd4hep/pull/608))
  - SInce we do not use DTD checking all DTD links from lcdd xml files have been removed in examples. 
  - Add 2 examples to check the usage of NTP and STP temperature/pressure conditions

* 2020-01-09 Markus Frank ([PR#606](https://github.com/aidasoft/dd4hep/pull/606))
  - Resolves #605 
  - There was an apparent bug when cloning `DetElement` trees. Not only for the top element, which should receive a new ID, this top ID was propagated to all children. This was clearly wrong. The correct solution is: 
      - Top element gets a new ID
      - Children keep their ID
  - If a user wants to preserve the old functionality the flag `DetElement::PROPAGATE_PARENT_ID` must be set in the clone statement.

* 2019-12-18 Markus Frank ([PR#604](https://github.com/aidasoft/dd4hep/pull/604))
  - Allow to set ambient temperature and pressure for all materials. 
      - predefined settings: STP, NTP
      - Example:
         - `examples/ClientTests/compact/Check_Air.xml`
       - Apply global temperature and pressure for all materials and especially for one single material.
       - Verification for Geant4: `examples/ClientTests/scripts/Check_Air.py`
  - DDG4: allow Geant4 messengers to pass parameter string.

* 2019-12-16 Markus Frank ([PR#603](https://github.com/aidasoft/dd4hep/pull/603))
  - Resolves #599
  - Resolves #601 
  - Work on #595

* 2019-11-27 Markus Frank ([PR#597](https://github.com/aidasoft/dd4hep/pull/597))
  - Intermediate release to store improvements in the development of DDDigi:
    Start implementing noise chains
  - Fix cmake build if CLHEP is included in Geant4 and not external.