/cvmfs/ilc.desy.de/sw/x86_64_gcc48_sl6/v01-17-10/DD4hep/v00-16/DDDetectors/src/

Tweaking the drivers

This is a very brief description of how one can tweaking the DD4hep drivers to change for example the way various detector sensors are placed, or simply to print detector id's and coordinates.

Model components

The DD4hep model of each SiD sub-detector contains two important components:

1. geometry description, in an XML file, e.g. SiD/compact/SiD_o2_v01/SiTrackerBarrel_o2_v01_00.xml
2. the driver, in a C++ file, e.g. detector/tracker/TrackerBarrel_o1_v03_geo.cpp

Note that the file paths above assume you are located in lcgeo/.

Identifying the driver

To find which driver is used, have a look in the XML file, in the example above

In the example above, we use a custom driver which is normally located in the detector/ subdirectory. In other cases, a generic driver can be used, e.g.

Generic DD4hep drivers have names like DD4hep_.... A custom driver is very often a modified generic driver. Note that in the case below, a custom driver located in detector/calorimeter is used, even though it's named Generic_...

Customising a driver

Let us say we want to customise our ECalBarrel driver, which in the example above was GenericCalBarrel_o1_v01_geo.cpp. We make a copy:

cd detector/calorimeter/
cp GenericCalBarrel_o1_v01_geo.cpp MyECalBarrel_o1_v01_geo.cpp 
cd ../../

... detector id="5" name="ECalBarrel" type="MyECalBarrel_o1_v01" ...

std:cout <<   "Module: " << module <<   " X: " << posX << " Y: " << posY << " rotY: " << rotY << std:endl;

DECLARE_DETELEMENT(MyECalBarrel_o1_v01, create_detector)

[ 59%] Building CXX object CMakeFiles/lcgeo.dir/detector/calorimeter/MyECalBarrel_o1_v01_geo.cpp.o

Running with the new driver

Now if you run for example geoDisplay, or ddsim

ddsim --compactFile=SiD/compact/SiD_o2_v01/SiD_o2_v01.xml --runType=batch --inputFile mcparticles.slcio -N=1 --outputFile=testSiD_o2_v01.slcio

Module: 0 X: 34.5329 Y: 128.879 rotY: -0.261799
Module: 1 X: 94.3457 Y: 94.3457 rotY: -0.785398
Module: 2 X: 128.879 Y: 34.5329 rotY: -1.309
Module: 3 X: 128.879 Y: -34.5329 rotY: -1.8326
Module: 4 X: 94.3457 Y: -94.3457 rotY: -2.35619
Module: 5 X: 34.5329 Y: -128.879 rotY: -2.87979
Module: 6 X: -34.5329 Y: -128.879 rotY: -3.40339
Module: 7 X: -94.3457 Y: -94.3457 rotY: -3.92699
Module: 8 X: -128.879 Y: -34.5329 rotY: -4.45059
Module: 9 X: -128.879 Y: 34.5329 rotY: -4.97419
Module: 10 X: -94.3457 Y: 94.3457 rotY: -5.49779
Module: 11 X: -34.5329 Y: 128.879 rotY: -6.02139

Follow this example to modify the drivers as needed.