Digitization

In order to reduce the depletion depth of the charge drift in the IBL planar sensors, the Athena package PixelDigitization is used: http://acode-browser.usatlas.bnl.gov/lxr/source/atlas/InnerDetector/InDetDigitization/PixelDigitization/

- The drift loop is modified inside IblPlanarChargeTool (http://acode-browser.usatlas.bnl.gov/lxr/source/atlas/InnerDetector/InDetDigitization/PixelDigitization/src/IblPlanarChargeTool.cxx) and the relevant IBL thresholds (defined in the package http://acode-browser.usatlas.bnl.gov/lxr/source/atlas/InnerDetector/InDetConditions/PixelConditionsServices/) are reduced in such a way to account for the reduced depleted region for the charge drift.

Modifying the Lorentz Angle in the reconstruction frame

* Will need to correct for the reduced depletion depth where the drift is performed (http://acode-browser.usatlas.bnl.gov/lxr/source/atlas/InnerDetector/InDetConditions/SiLorentzAngleSvc/src/SiLorentzAngleSvc.cxx)

*The typical bias voltage applied on the sensors can also be modified in the same class SiLorentzAngleSvc.

Geometry (PixelGeoModel package)

*The interface to browse the geometry tag content is the following: http://atlas.web.cern.ch/Atlas/GROUPS/OPERATIONS/dataBases/DDDB/tag_hierarchy_browser.php

The geometry tag used to produce the HITS file can be chosen in the column on the left, the corresponding hierarchy of DB nodes is shown in the middle frame

1) Reading the values defined for a given geometry tag (example for ATLAS-R2-2015-03-01-00)

- access the PixelLayer table to read the MODULETYPE parameter corresponding to the layer to be modified
- access the PixelModule table, read the line number (MODULETYPE+1) to get the DESIGN type parameter
- open the PixelReadout table and read the line (DESIGNTYPE+1) to access the readout parameter corresponding to the module

2) Overwriting a value from the database with a txt file:

3) Modifying the xml file with the pixel identifiers:

An example of xml file can be found here: /afs/cern.ch/work/a/acalandr/public/IdDictInnerDetector_readout.xml
*range fields in Eta and Phi (eta_index and phi_index) should be modified according to the new pixel maps in the sub-regions (IBL, b-layer, L1, L2) where the modification occurred

4) Running the package:

1) Add a postInclude to the Reco_tf.py command in order to account for the changes in the geometry. The python script can be found here: /afs/cern.ch/work/a/acalandr/public/postInclude.IBL_Setup_readout.py

2) Check on the log flle to make sure the changes in geometry are properly taken into account by the software.

Pixel clustering

The following job option can be used as preInclude in the digi+reco command (Reco_tf.py) to set digital clustering (Position Strategy=0) and its corresponding error (ErrorStrategy=0):

Please refer to this class: http://acode-browser.usatlas.bnl.gov/lxr/source/atlas/InnerDetector/InDetRecTools/SiClusterOnTrackTool/src/PixelClusterOnTrackTool.cxx
where the various clustering options and errors ("PositionStrategy" and "ErrorStrategy") can be modified via job option

-- AlessandroCalandri - 2016-06-28