From d02cf89682699bb8bdd19d8c41c4da4f38e06558 Mon Sep 17 00:00:00 2001 From: Alvaro Tolosa Delgado Date: Sun, 24 Nov 2024 19:00:34 +0100 Subject: [PATCH] update comments --- DCHdigi/README.md | 26 ++++++++++++-------------- DCHdigi/src/DCHdigi_v01.cpp | 2 +- 2 files changed, 13 insertions(+), 15 deletions(-) diff --git a/DCHdigi/README.md b/DCHdigi/README.md index 2978f3a..c307fec 100644 --- a/DCHdigi/README.md +++ b/DCHdigi/README.md @@ -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 diff --git a/DCHdigi/src/DCHdigi_v01.cpp b/DCHdigi/src/DCHdigi_v01.cpp index 6b61090..dbcf7a9 100644 --- a/DCHdigi/src/DCHdigi_v01.cpp +++ b/DCHdigi/src/DCHdigi_v01.cpp @@ -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)