README.md 1.56 KB
Newer Older
1
# Prealignment
2
**Maintainer**: Morag Williams (<morag.williams@cern.ch>)   
3
4
**Module Type**: *DETECTOR*  
**Detector Type**: *all*  
5
6
**Status**: Functional   

7
### Description
8
This module performs translational telescope plane alignment.
9

10
This initial alignment along the X and Y axes is designed to be performed before the `Alignment` module, which carries out translational and rotational alignment of the planes. To not include the DUT in this transaltional alignment, it will need to be masked in the configuration file.
11

12
The required translational shifts in X and Y are calculated for each detector as the mean of the 1D correlation histogram along the axis.
13

14
### Parameters
15
* `damping_factor`: A factor to change the percentage of the calcuated shift applied to each detector. Default value is `1`.
16
* `max_correlation_rms`: The maximum RMS of the 1D correlation histograms allowed for the shifts to be applied. This factor should be tuned for each run, and is combat the effect of flat distributions. Default value is `6mm`.
17
* `timing_cut`: maximum time difference between clusters to be taken into account. Defaults to `100ns`.
18

Simon Spannagel's avatar
Simon Spannagel committed
19
### Plots Created
20
For each detector the following plots are produced:
21

22
23
24
25
26
27
28
* 1D correlation plot for X
* 1D correlation plot for Y
* 2D correlation plot for X in local coordinates (comparing to reference plane)
* 2D correlation plot for Y in local coordinates
* 2D correlation plot for X in global coordinates
* 2D correlation plot for Y in global coordinates

29
### Usage
30
31
32
33
34
35
```toml
[Prealignment]
log_level = INFO
max_correlation_rms = 6.0
damping_factor = 1.0
```