README.md 3.7 KB
Newer Older
1
# AnalysisEfficiency
Simon Spannagel's avatar
Simon Spannagel committed
2
**Maintainer**: Simon Spannagel (<simon.spannagel@cern.ch>), Jens Kroeger (<jens.kroeger@cern.ch>)  
3
4
**Module Type**: *DUT*  
**Detector Type**: *all*  
5
6
7
**Status**: Functional

### Description
8
This module measures the efficiency of the DUT by comparing its cluster positions with the interpolated track position at the DUT.
9
It also comprises a range of histograms to investigate where inefficiencies might come from.
10

11
12
13
The efficiency is calculated as the fraction of tracks with associated clusters on the DUT over the the total number of tracks intersecting the DUT (or region-of-interest, if defined).
It is stored in a ROOT `TEfficiency` object (see below).
Its uncertainty is calculated using the default ROOT `TEfficiency` method which is applying a Clopper-Pearson confidence interval of one sigma.
Jens Kroeger's avatar
Jens Kroeger committed
14
Analogue to a Gaussian sigma, this corresponds to the central 68.3% of a binomial distribution for the given efficiency but taking into account a lower limit of 0 and an upper limit of 1.
15
This method is recommended by the Particle Data Group.
16
More information can be found in the ROOT `TEfficiency` class reference, section `ClopperPearson()` @root-tefficiency-class-ref.
17

18
### Parameters
19
20
* `time_cut_frameedge`: Parameter to discard telescope tracks at the frame edges (start and end of the current event window). Defaults to `20ns`.
* `chi2ndof_cut`: Acceptance criterion for telescope tracks, defaults to a value of `3`.
21
* `inpixel_bin_size`: Parameter to set the bin size of the in-pixel 2D efficiency histogram. This should be given in units of distance and the same value is used in both axes. Defaults to `1.0um`.
22
* `inpixel_cut_edge`: Parameter to exclude tracks going within a cut-distance to the pixel edge. Effectively defines an in-pixel ROI. Defaults to `5um`.
23
* `masked_pixel_distance_cut`: Distance (in pixels) to exclude tracks passing close to masked pixel. Defaults to `1`.
24
* `require_associated_cluster_on`: Names of detectors which are required to have an associated cluster to the telescope tracks. Detectors listed here must be marked as `role = DUT` in the detector configuration file. Only tracks satisfying this requirement are accepted for the efficiency measurement. If empty, no detector is required. Default is empty.
25
26

### Plots produced
27
28
29

For the DUT, the following plots are produced:

30
* 2D histograms:
31
  * 2D Map of in-pixel efficiency and in-pixel efficiency within in-pixel ROI
32
  * 2D Maps of chip efficiency in local and global coordinates, filled at the position of the track intercept point or at the position of the associated cluster center
33
  * 2D Map of pixel efficiency, for the full matrix, filled at the pixel (of the associated cluster) through which the track goes, constrained to an in-pixel ROI defined by `inpixel_cut_edge`.
34
  * 2D Maps of the position difference of a track with and without associated cluster to the previous track
35
  * 2D Map of the distance between track intersection and associated cluster
36

37
38
* 1D histograms:
  * Histogram of all single-pixel efficiencies
39
40
41
  * Histograms of time difference of the matched and non-matched track time to the previous track
  * Histograms of the row and column difference of the matched and non-matched track time to the previous track
  * Histograms of the time difference of a matched (non-matched) cluster to a previous hit (not matter if noise or track)
42
43
  * Distribution of cluster-track distances

44
* Other:
45
  * Value of total efficiency as `TEfficiency` including (asymmetric) error bars (total and restricted to in-pixel ROI)
46
  * Efficiency as function of column and row, and vs. time
47

48
49
50
51

### Usage
```toml
[AnalysisEfficiency]
52
chi2ndof_cut = 5
53
```
54
[@root-tefficiency-class-ref]: https://root.cern.ch/doc/master/classTEfficiency.html#ae80c3189bac22b7ad15f57a1476ef75b