README.md 2.16 KB
Newer Older
1
# AnalysisDUT
2
**Maintainer**: Simon Spannagel (<simon.spannagel@cern.ch>)  
3
4
**Module Type**: *DUT*  
**Detector Type**: *all*  
5
**Status**: Functional
6

7
### Description
Simon Spannagel's avatar
Simon Spannagel committed
8
9
Generic analysis module for all types of detectors. Produces a number of commonly used plots to gauge detector performance and allows to discard tracks based on their chi2/ndf value.
If a region of interest (ROI) is defined for the detector under investigation, only tracks from within this region are evaluated, all others are discarded.
10

11
### Parameters
12
* `time_cut_frameedge`: Parameter to discard telescope tracks at the frame edges (start and end of the current CLICpix2 frame). Defaults to `20ns`.
13
14
* `chi2ndof_cut`: Acceptance criterion for the maximum telescope tracks chi2/ndf, defaults to a value of `3`.
* `use_closest_cluster`: If `true` the cluster with the smallest distance to the track is used if a track has more than one associated cluster. If `false`, loop over all associated clusters. Defaults to `true`.
Jens Kroeger's avatar
Jens Kroeger committed
15
16
* `n_time_bins`: Number of bins in the time residual and correlation histograms. Defaults to `20000`.
* `time_binning`: Bin width in the time residual and correlation histograms. Defaults to `0.1ns`.
17
* `correlations`: If `true`, correlation plots between all tracks and all clusters on the DUT (i.e. associated + non-associated) are created. Defaults to `false`.
18

19
### Plots produced
20
21
22
23
24

For the DUT, the following plots are produced:

* 2D histograms:
    * Maps of the position, size, and charge/raw value of associated clusters
25
    * Maps of all pixels of associated clusters
26
27
    * Maps of the in-pixel efficiencies in local/global coordinates
    * Maps of matched/non-matched track positions
28
    * Maps of cluster/seed charge vs. row
29
30
31
* 1D histograms:
    * Histograms of the cluster size of associated clusters in X/Y
    * Histogram of the charge/raw values of associated clusters
32
    * Various histograms for track residuals and correlations for different cluster sizes
Jens Kroeger's avatar
Jens Kroeger committed
33
    * Histograms of pixel timestamp minus seed pixel timestamp for different cluster sizes
34
    * Profiles of cluster charge vs. column/row
35

36
### Usage
37
```toml
38
39
40
41
[AnalysisDUT]
time_cut_frameedge = 50ns
chi2ndof_cut = 5.
use_closest_cluster = false
42
```