lcgeo (Lepton Collider Geometry)

Implementation of Lepton Collider detector models in DD4hep.

lcgeo is distributed under the GPLv3 License

Requirements

DD4hep built with Geant4 and LCIO

Download and Installation

Download

• git clone https://github.com/iLCSoft/lcgeo.git

• cd lcgeo ; mkdir build ; cd build

  Initialize dependency

• source __path_to_DD4hep__/bin/thisdd4hep.sh

• cmake -DBoost_NO_BOOST_CMAKE=ON ..

  Build

• make -j4 install

  Initialize

• source ../bin/thislcgeo.sh

Running some examples

go to cd ./example

Create single particle input file

Modify the python script ./example/lcio_particle_gun.py in order to create an LCIO input file with single particles:

• export PYTHONPATH=${LCIO}/src/python:${ROOTSYS}/lib:$PYTHONPATH
• python lcio_particle_gun.py

There is also example input file with 10 singe muons: ./mcparticles.slcio

Run the simulation:

• ddsim --compactFile ../ILD/compact/ILD_o1_v05/ILD_o1_v05.xml --inputFiles mcparticles.slcio -N 10

This creates an lcio file simple_lcio.slcio with sim hits and MCParticles.

You can look at it in the usual way

• anajob simple_lcio.slcio

• dumpevent simple_lcio.slcio 1

Change the ddsim command line parameters as needed to read other input files.

Event displays:

There are several ways for visualizing the detector geometry and the simulated events:

1) CED event display

ced2go -d gear_ILD_o1_v05_ORG.xml -t ced2go-template.xml simple_lcio.slcio

2) teveDisplay

ln -s simple_lcio.slcio teve_infile.slcio

teveDisplay ../ILD/compact/ILD_o1_v05/ILD_o1_v05.xml

3) DDEve:

root

.x $DD4hepINSTALL/examples/DDEve/DDEve.C()

and then load

../ILD/compact/ILD_o1_v05/DDEve.xml

Running the reconstruction with Marlin (EXPERIMENTAL)

1) create a gear file from the DD4hep detector model, e.g.

`convertToGear default ../trunk/ILD/compact/ILD_o1_v05.xml gear_ILD_o1_v05_dd4hep.xml`

[ Friendly reminder: in order to work you need to explicitly build DD4hep with GEAR enabled. Use the flag `-DDD4HEP_USE_GEAR="ON"` for the cmake command. ]

Note: currently this might still be incomplete and you can copy missing information for example from the original Mokka gear files ( or use `$DDSIM/example/gear_ILD_o1_v05_dd4hep.xml` )

2) run simulation (as described above), e.g.:

`python ddsim.py ../ILD/compact/ILD_o1_v05/ILD_o1_v05.xml`

3) run the standard reconstruction ( tracking only so far ):

`Marlin ../example/ild_dd4hep_stdreco.xml`  
`--global.LCIOInputFiles=./simple_lcio.slcio`
`--MyLCIOOutputProcessor.LCIOOutputFile=./simple_lcio_REC.slcio`

4) look at the result w/ the CED event display, e.g.

`ced2go -d ../example/gear_ILD_o1_v05_ORG.xml -t ../example/ced2go-template.xml simple_lcio_REC.slcio`

License and Copyright

Copyright (C), lcgeo Authors

lcgeo is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License long with this program. If not, see http://www.gnu.org/licenses/.