# New histograms in BeamSpotMonitor

## Related MRs and Issues

None

## Description

This MR adds 12 new histograms to the BeamSpotMonitor algorithm along with 3 new properties to set the axis ranges for a subset of these histograms.

These new histograms show various statistics *relative to* the last-published (cached) set of conditions. These histograms should be useful to verify that the configured thresholds are behaving as expected and for checking the distribution of PVs relative to the published conditions, something that is somewhat difficult with the current histograms of PVs that are centered on the origin of the coordinate system.

## New histograms

This section describes the new histograms and includes examples of them produced by running this MR over VELO alignment samples from Run 294393.

### PV position relative published conditions

Three new 2D histograms that correspond to the exising histograms `PVPosYvX`

, `PVPosXvZ`

, and `PVPosYvZ`

but that are centered on the published conditions position rather than on the origin of the coordinate system.

The histogram limits are based on the existing properties for the `PVPos.v.`

histograms. These come in (min, max) pairs, so the limits for new histograms are `$\pm (\text{max} - \text{min})/2$`

.

#### PVDelPosYvX

Limits are determined from the (extant) properties `Hist2DPVYMin`

, `Hist2DPVYMax`

, `Hist2DPVXMin`

, and `Hist2DPVXMax`

.

#### PVDelPosXvZ

Limits determined from the (extant) properties `Hist2DPVXMin`

, `Hist2DPVXMax`

, `Hist2DPVZMin`

, and `Hist2DPVZMax`

.

#### PVDelPosYvZ

Limits determined from the (extant) properties `Hist2DPVYMin`

, `Hist2DPVYMax`

, `Hist2DPVZMin`

, and `Hist2DPVZMax`

.

### Conditions position

Three new histograms showing the mean vertex position for each tranche of 2500 PVs (a provisional or unpublished condition) relative to the cached IR condition position. Like the existing `HistIRCond.*`

histograms, these monitor unpublished statistics. They are 2D histograms centered on the cached conditions position.

Their limits are based on *new* properties included in this MR.

#### CondDelPosYvX

Limits determined from the *new* properties `Hist2DCondDelPosYHalfWidth`

and `Hist2DCondDelPosXHalfWidth`

.

This histogram is particularly useful to check that the threshold on transverse displacement is being sensibly applied.

#### CondDelPosXvZ

Limits determined from the *new* properties Hist2DCondDelPosXHalfWidth and Hist2DCondDelPosZHalfWidth.

#### CondDelPosYvZ

Limits determined from the *new* properties `Hist2DCondDelPosYHalfWidth`

and `Hist2DCondDelPosZHalfWidth`

.

### Conditions spread

Six new histograms showing the covariance of vertex positions for each tranche of 2500 PVs (a provisional or unpublished condition) relative to the cached IR condition spread matrix. These are 1D histograms that correspond to the exising `CondSpread..`

histograms, but they are centered on the corresponding cached conditions spread matrix element rather than on the origin of the coordinate system.

The histogram limits are based on the existing properties for the `CondSpread..`

histograms. These come in (min, max) pairs, so the limits for new histograms are `$\pm (\text{max} - \text{min})/2$`

.

#### CondDelSpreadXX

Limits determined from the (extant) properties `HistIRCondSpreadXXMax`

and `HistIRCondSpreadXXMin`

.

#### CondDelSpreadXY

Limits determined from the (extant) properties `HistIRCondSpreadXYMax`

and `HistIRCondSpreadXYMin`

.

#### CondDelSpreadYY

Limits determined from the (extant) properties `HistIRCondSpreadYYMax`

and `HistIRCondSpreadYYMin`

.

#### CondDelSpreadZX

Limits determined from the (extant) properties `HistIRCondSpreadZXMax`

and `HistIRCondSpreadZXMin`

.

#### CondDelSpreadYZ

Limits determined from the (extant) properties `HistIRCondSpreadYZMax`

and `HistIRCondSpreadYZMin`

.

### CondDelSpreadZZ

Limits determined from the (extant) properties `HistIRCondSpreadZZMax`

and `HistIRCondSpreadZZMin`

.