Skip to content

Commit

Permalink
update comments
Browse files Browse the repository at this point in the history
  • Loading branch information
atolosadelgado committed Nov 26, 2024
1 parent 2564163 commit d02cf89
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 15 deletions.
26 changes: 12 additions & 14 deletions DCHdigi/README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,18 @@
# Drift chamber (DCH) digitizers

## DCHsimpleDigitizer

* Similar to DCHdigi_v01, but it uses the placement matrix of the wires to apply the smearing along/perpendicular to the sense wire
* No cluster counting information added into the digitized output
* It relies on a dedicated data extension, similar to DCHdigi_v01
## DCHdigi_v01

## DCHdigi description

* Each simulated hit is transformed into a digitized hit
* The digitized hit position is the projection of the simulated hit position onto the sense wire (at the center of the cell)
* Smearing of the digitized hit position along the wire and radially is done according to the input parameter values (`zResolution_mm1` and `xyResolution_mm`, respectively)
* Number of clusters and their size is derived from file containing precalculated distributions, specified by the parameter `fileDataAlg`, and implemented as the option 3 described in F. Cuna et al, arXiv:2105.07064
* Debug histograms are created if `create_debug_histograms` option is enabled (output file name can be given)
* Stand alone test run simulation of the drift chamber based on twisted tubes, and then apply the digitizer. Dedicated directory with all the files needed is given in `DCHdigi/test/test_DCHdigi/`
* Each simulated hit is transformed into a digitized hit. The digitized hit position is the projection of the simulated hit position onto the sense wire (at the center of the cell)
* Smearing of the digitized hit position along the wire and radially is done according to the input parameter values (`zResolution_mm` and `xyResolution_mm`, respectively)
* The digitized hit adds new information: number of clusters and their size, which are derived from precalculated distributions contained in an input file specified by the parameter `fileDataAlg`. The method and distributions corresponds to the option 3 described in F. Cuna et al, arXiv:2105.07064
* It requires that the cellID contain the layer and number of cell within the layer (nphi). It does not matter if the segmentation comes from geometrical segmentation by using twisted tubes and hyperboloids (and the cellID is created out of volume IDs), or the segmentation is virtual DD4hep segmentation
* New digitized hit class is used as an EDM4hep data extension, to be integrated into EDM4hep
* Debug histograms are created if `create_debug_histograms` option is enabled (output file name can be given)
* Stand alone test run simulation of the drift chamber based on twisted tubes, and then apply the digitizer. Dedicated directory with all the files needed is given in `DCHdigi/test/test_DCHdigi/`
* Random number generator uses the seeds calculated on an event basis by the UID service, from the podio header information (run/event number)
* At the moment, only one version: v01

## DCHsimpleDigitizer

* Similar to DCHdigi_v01, but it uses the placement matrix of the wires to apply the smearing along/perpendicular to the sense wire
* No cluster counting information is added into the digitized output
* It relies on a dedicated data extension, similar to DCHdigi_v01
2 changes: 1 addition & 1 deletion DCHdigi/src/DCHdigi_v01.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
#include "extension/MutableDriftChamberDigiV2.h"

///////////////////////////////////////////////////////////////////////////////////////
/////////////////////// DCHdigi constructor ////////////////////////////
////////////////////// DCHdigi_v01 constructor ////////////////////////////
///////////////////////////////////////////////////////////////////////////////////////
// -- KeyValues("name of the variable that holds the name of the collection exposed in the python steering file", {"default name for the collection"}),
DCHdigi_v01::DCHdigi_v01(const std::string& name, ISvcLocator* svcLoc)
Expand Down

0 comments on commit d02cf89

Please sign in to comment.