Changes

Page history
Update Data Model authored by Matteo Tenti's avatar Matteo Tenti
Show whitespace changes
Inline Side-by-side
Data-Model.md
View page @ f2798a88
......@@ -3,7 +3,7 @@ The [edep-sim](https://github.com/ClarkMcGrew/edep-sim/blob/master/README.md) ou
***STT***
------------------------------------------------
**Hit**
**hit**
The hit struct represent the segment along which a particle's energy deposit occurs inside the sensible volume (i.e. the gas) of the STT detector. It has one-to-one relation with objects of the class *[TG4HitSegment](https://github.com/ClarkMcGrew/edep-sim/blob/master/README.md#the-energy-deposition-class-and-friends)* corresponding to the STT hit collection.
......@@ -23,13 +23,31 @@ The hit struct represent the segment along which a particle's energy deposit occ
| int | pid | Index of the particle producing the hit. It corresponds to `TG4HitSegment::PrimaryId` |
| int | index | Hit index. It corresponds to the position of the corresponding TG4HitSegment in the `vector<TG4HitSegment>` corresponding to the STT hit collection |
**Digit**
**pe**
The digit represents (or at least should) the real response of the straw tube. It has a many-to-one relation with the hit. Hits produced by the same particle on the same sensible detector are *merged*. All the hits produced by the same particle in the same sansible detector are time ordered.
The struct pe is a simplified representation of a photo-electron in the ECAL fibers. It contains information about its arrival time at the photo sensor and the index of the TG4HitSegment which produced it.
* The space position of the digit is the mean point of the segment joining the start point of the first hit with the end point of the last hit.
* The time of the digit is the time of the start point of the first hit.
* The energy deposit is the sum of the energy deposits of the hits.
| Type | Name | Description |
| ------ | ------ | ------ |
| double | time | Arrival time at the photo sensor |
| int | h_index | Index of the TG4HitSegment which produced it |
**dg_ps**
The struct dg_ps represent a signal (above threshold) produced by the photo sensors of the ECAL cells.
| Type | Name | Description |
| ------ | ------ | ------ |
| int | side | Side of the cell where photosensor producing photo signal lays |
| double | adc | ADC of the signal |
| double | tdc | TDC of the signal |
| `std::vector<pe>`| `photo_el`| Vector of photo electrons producing the signal |
**dg_tube**
The dg_tube represents (or at least should) the real response of the straw tube. It has a many-to-one relation with the hit. For each hits the drift time of the charges toward the wire and the propagation time of the electric signal along the wire is taken into account. TDC is given by the earliest signal with a smearing while the ADC is given by the energy release in the tube within the integration time.
The t0 is given assuming to know by which proton bucket the neutrino produing the event originated, then light speed propagation is taken into account.
| Type | Name | Description |
| ------ | ------ | ------ |
......@@ -38,12 +56,14 @@ The digit represents (or at least should) the real response of the straw tube. I
| double | x | X position of the digit evaluated as explained above |
| double | y | Y position of the digit evaluated as explained above |
| double | z | Z position of the digit evaluated as explained above |
| double | t | Time coordinate of the digit evaluated as explained above |
| double | t0 | t0 of the tube |
| double | de | Energy deposit |
| double | adc | Signal ADC |
| double | tdc | Signal TDC |
| bool| hor| Flag to identified straw tube orientation. `hor == true` means horizontal, `hor == false` means vertical |
| std::vector<int> | hindex | vector of the hit indeces contributing to the digit |
**Track**
**track**
All digits produced by the same particle are grouped and fitted. No pattern recognition is used; the grouping is performed exploting MC truth information. The track model is a circle in the Y-Z plane and straight line in the rho-X plane as suggested [here](http://www2.fisica.unimi.it/andreazz/AA_TrackingSystems.pdf). Two variables (`ret_cr` and `ret_ln` for circular and linear fit respectively) provide the return value of the function preforming the fit. A good fit has occured if `ret_cr==0 && ret_ln==0`. A rough measurement of the quality of the fits can be checked from the variables: `chi2_cr` and `chi2_ln`. The circular fit provides:
......@@ -84,7 +104,7 @@ The linear fit provides:
------------------------------------------------
The calorimeter geometry is based on the instruction provided by KLOE people through two files: [udigic.kloe](uploads/e09fbb27918ed093adc125f131061050/udigic.kloe) [udcalg.kloe](uploads/affea6bb3801cd8ebf709ac059e83157/udcalg.kloe). The barrel is composed by 24 modules with trapeziod cross section. The endcaps are tubes. Both are composed by alternating scintillator and lead layers.
**Cell**
**dg_cell**
A cell represents the real responce of a cell of the e.m. calorimeter. It has one-to-many relation with objects of the class *[TG4HitSegment](https://github.com/ClarkMcGrew/edep-sim/blob/master/README.md#the-energy-deposition-class-and-friends)* corresponding to the EM Calo hit collection.
......@@ -96,19 +116,13 @@ A cell represents the real responce of a cell of the e.m. calorimeter. It has on
| double | y | Y position of the center of the cell |
| double | z | Z position of the center of the cell |
| double | l | Length of the cell, i.e. optical distance between the associated with the cell |
| double | adc1 | ADC count of the first pmt |
| double | tdc1 | TDC of the frist pmt |
| double | adc2 | ADC count of the second pmt |
| double | tdc2 | TDC of the second pmt |
| double | ps1 | Vector of photo signal from one side |
| double | ps2 | ... and the other side |
| int | mod | Index of the module. 0 - 23 for the barrel starting from the upper one and moving upstream. 30 and 40 for the right and left endcap respectively |
| int | lay | Index of the layer. 0 - 4 starting from the inner one |
| int | cel | Index of the cell. 0 - 12 starting from the left |
| std::vector<double> | pe_time1 | Time arrival of the photo-electron collected by the first pmt |
| std::vector<int> | hindex1 | Indices of the hits producing the photo-electrons. It has one-to-one correspondence with pe_time1 |
| std::vector<double> | pe_time2 | Time arrival of the photo-electron collected by the second pmt |
| std::vector<int> | hindex2 | Indices of the hits producing the photo-electrons. It has one-to-one correspondence with pe_time2 |
**Cluster**
**cluster**
The cluster is a set of cell grouped on the basis track that produced them. It has a one-to-many correspondence with the cell.
......@@ -126,9 +140,9 @@ The cluster is a set of cell grouped on the basis track that produced them. It h
| double | varx | Variance in X of the cluster |
| double | vary | Variance in Y of the cluster |
| double | varz | Variance in Z of the cluster |
| std::vector<cell> | cells | Vector of the cell associated to the cluster |
| std::vector<dg_cell> | cells | Vector of the cell associated to the cluster |
**Particle**
**particle**
| Type | Name | Description |
| ------ | ------ | ------ |
......@@ -162,7 +176,7 @@ The cluster is a set of cell grouped on the basis track that produced them. It h
| bool | has_daughter | True if particle has daughter, false otherwise |
| std::vector<particle> | daughters | Vector of the daughter particles |
**Event**
**event**
| Type | Name | Description |
| ------ | ------ | ------ |
......
......