- add option to enable debug output actions for hits from Markus

Add Helper Input and GuineaPig for further expansions in the future

Set on the command line with

   --guineapig.particlesPerEvent=123

or in the steering file

   SIM.guineapig.particlesPerEvent=123

This reverts commit 70feca4742a0721bdbe7197de1a33eb878a63799.

as we are now potentially changing the random seed we need to initialize it before the output file, because we write the variables to the outputfile at this point

Add option to enable eventSeed plugin
Add possibility to create switches automatically, this does not allow 'choice' so we need to if/else the whole function call add_argument

Need to return the value
Kept DDg4ParticleGun from working

Cannot use PrimaryHandler together with either of these (particles are created twice)
Thanks to S.Lukic for pointing out the problem

Move consistency checks to separate function for better readability

DDSim: Add functionality to enable geant4gun and geant4 particle general source. Needs DD4hep Revision 2128

Add example macro file to use gun or general particle source

Do not print error messages when dumping SteeringFile or parameters
Fix crash when dumping steeringfile

DDSim: Add logic to add help for non-property helper variables, add logic to add choices for all helper options

Add control over distributions
if a distribution is set activate isotrop
if isotrop is activated use uniform by default

Move set up gun function to Helper/Gun, keeps functionality closer together

previously only the main variable values were overwritten, now dumpSteeringFile and dumpParameters will also display the proper value

Add white line before documentation block for better readability

Otherwise error for unknown function, reported by Marko,
Copied fix from DD4hep::DDG4.py
change is compatible with root5

If used isotropic is mandatory so we turn it on in  setup
Note different capitalisations for options,
keeping lower case starting char for ddsim options

needs dd4hep revision 2071

with the additional range cut parameter created Physics Helper object
the DD4hepSimulation physicsList attribute is now deprecated, use physics.list instead
The default value for the rangecut is the one from geant4 10.1: 700 micron

None is default for setupFuction, so we can allways pass the action and don't need the else
setupSD now accepts tuples

DDSim: use different name for different GenAction when the same kind of inputfile is used multiple times

if not specific filter is set the default filter for tracker or calorimeter is applied (if a default filter is set)
To turn off all filters just assign an empty string, empty list or None to the mapDetFilter

update doc

Move applyFilter to Helper/Filter
Adapt steeringFile

Move module doc to class doc so we can use it in the automatically created steering file

Change docstrings to be more sensible

changed member variables to private: _errorMessages, _dumpParameter, _dumpSteeringFile

removed abspath from macroFile and compactFile because otherwise the default values break error checking

See example/steeringFile.py and DDSim/Helper/Filter.py for examples

see the steering file or the ConfigHelper/Action docstring for an example for CaloPreShowerSDAction

use absolute path for steering, compact and macro file
remove magneticFieldDict because no longer used