Skip to content

Commit 8b4ceb3

Browse files
committed
corrections section and supporting file, change a few admonition types
1 parent a8bc304 commit 8b4ceb3

File tree

2 files changed

+36
-2
lines changed

2 files changed

+36
-2
lines changed
119 KB
Loading

docs/guis/chroma/gui.md

Lines changed: 36 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
The non-linear chromaticity GUI provides functionality to analyze [chromaticity scans](#performing-scans) in the LHC.
44
The GUI itself has no functionality for making these measurements and only serves to extract and analyze data from `NXCALS`.
55

6-
!!! note "Kerberos"
6+
!!! info "Kerberos"
77
Note that using the GUI requires a valid Kerberos token.
88

99
The GUI is published with `acc-py`, and can be run with:
@@ -73,7 +73,7 @@ Next, go to the `Timber` tab and select `start` and `end` dates to extract data
7373
!!! tip "Time Convention"
7474
Note that the times are expected in UTC. One can check the online [Timber][timber_web]{target=_blank .cern_internal} interface for the correct time range of the scan data to extract.
7575

76-
!!! note "Data Extraction Process"
76+
!!! info "Data Extraction Process"
7777
There is no need to click `Extract raw BBQ` unless to re-analyze the raw data. There are specific UCAP nodes which have done this analysis already.
7878

7979
There is no loading bar, the panel will just say "Extracting data from Timber..." on the right (and show some things in the terminal). Be patient.
@@ -143,6 +143,40 @@ Similarly, the computed value for each order is shown in a table in the top righ
143143

144144
### Determining Corrections
145145

146+
Move to the `Corrections` tab.
147+
148+
- Keep the method set to `Global` correction scheme.
149+
- For `Observables to correct` select `DQ2` or `DQ3` to correct $Q''$ or $Q'''$. Adapt the selection to the fitted order from the previous step.
150+
- Click `Correct` to compute corrections for the given settings.
151+
152+
<figure>
153+
<center>
154+
<img src="../../assets/images/chroma_gui/corrections_tab.png" width="90%" alt="Corrections tab determined trims" />
155+
<figcaption> Corrections Tab with Determined Trims for the Given Measurement and Settings </figcaption>
156+
</center>
157+
</figure>
158+
159+
!!! info "Trimming Corrections"
160+
The resulting correction needs to be **added** to all correctors as displayed, with no sign change.
161+
162+
In the example screenshot above, this means going to `LSA App Suite`, selecting the relevant corrector circuit for `B1` and trimming an additional `818.1284` to the current value.
163+
164+
The relevant LHC circuits can be found on pages 2 and 3 of this MD note:
165+
166+
??? abstract "MD6864 --- Decapole Studies at Injection, `M. Le Garrec et al.`, 2023, URL: [CERN-ACC-NOTE-2023-0018](https://cds.cern.ch/record/2879070){target=_blank}"
167+
```
168+
@techreport{LeGarrecMD6864DecapoleStudies2023,
169+
type = {{Accelerators \& Technology Sector Note}},
170+
title = {{MD6864 --- Decapole Studies at Injection}},
171+
author = {Le Garrec, Mael and Carlier, Felix Simon and Dilly, Joschua Werner and Ferrentino, Vittorio and Maclean, Ewen Hamish and Paraschou, Konstantinos and Tomas Garcia, Rogelio},
172+
year = {2023},
173+
month = oct,
174+
number = {CERN-ACC-NOTE-2023-0018},
175+
institution = {CERN},
176+
url = {https://cds.cern.ch/record/2879070}
177+
}
178+
```
179+
146180
[timber_web]: https://timber.cern.ch/
147181

148182
*[EIC]: Engineer in Charge, operators of the LHC

0 commit comments

Comments
 (0)