From 95b8e190cfab7da63cbf3a7d4cedb3eb52f447f0 Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 16:32:23 +0100 Subject: [PATCH 1/8] make admonition about losses expanded by default, will add screenshot of BLM display --- docs/guis/multiturn/excitation.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/guis/multiturn/excitation.md b/docs/guis/multiturn/excitation.md index 85296bc0..30c02a83 100644 --- a/docs/guis/multiturn/excitation.md +++ b/docs/guis/multiturn/excitation.md @@ -211,11 +211,12 @@ Always ask the experts on shift if unsure about the kick amplitudes to set. Trigger an acquisition by clicking the yellow ++"Acquire with ACDipole excitation"++ button at the bottom left of the GUI. The AC Dipole will arm, then kick the beam. -Make sure to have a `BLM Display` application open and to monitor the losses during that time. -Afterwards, a new tab will open at the very top of the GUI to display the BPM measurements, which can be checked: a menu list lets one select any BPM from each beam, and view the recorded bunch centroid turn-by-turn data through the acquisition. +!!! tip "Watch for Losses on Kicks" + Make sure to have a `BLM Display` application open and to monitor the losses right after clicking to acquire. + + TODO: insert a picture of the BLM display? -??? info "Losses on Kicks" Sometimes when increasing the kick amplitude, one will notice large losses. In this case it is recommended to kick a couple times at this amplitude or just below to see if the losses reduce or are consistent. @@ -223,6 +224,8 @@ Afterwards, a new tab will open at the very top of the GUI to display the BPM me Otherwise, stop increasing unless a beam dump is affordable. Refer to the experts on shift if unsure about the losses, and whether the kick amplitude can be increased further. +After the kick is done, a new tab will open at the very top of the GUI to display the BPM measurements, which can be checked: a menu list lets one select any BPM from each beam, and view the recorded bunch centroid turn-by-turn data through the acquisition. + !!! danger "Do not Kick Both Beams Simultaneously" Firstly, kicking both beams simultaneously might exceed the losses threshold and lead to a beam dump. From dc2813d08c87fa2d36f87b6a36f0796cd146fc48 Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 16:33:13 +0100 Subject: [PATCH 2/8] a word also for ADT AC dipole excitation --- docs/guis/multiturn/excitation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/guis/multiturn/excitation.md b/docs/guis/multiturn/excitation.md index 30c02a83..b004aac8 100644 --- a/docs/guis/multiturn/excitation.md +++ b/docs/guis/multiturn/excitation.md @@ -253,6 +253,7 @@ This deficit can be overcome in improving the signal-to-noise ratio through incr Refer to the [AC Dipole Excitation](#ac-dipole-excitation) section above for the settings and steps. Trigger an acquisition by clicking the yellow ++"Acquire with ADT/AC excitation"++ button at the bottom left of the GUI. +Just as with the AC Dipole, make sure to keep an eye on the losses (via BLM display) during the acquisition. *[AC Dipole]: Alternating Current Dipole *[ADT]: LHC Transverse Damper From d7c8987d92b2e4132c70afbdbaa2583d495b3a5b Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 17:23:57 +0100 Subject: [PATCH 3/8] also watch beam intensity --- docs/guis/multiturn/excitation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/guis/multiturn/excitation.md b/docs/guis/multiturn/excitation.md index b004aac8..4b35962f 100644 --- a/docs/guis/multiturn/excitation.md +++ b/docs/guis/multiturn/excitation.md @@ -219,6 +219,7 @@ The AC Dipole will arm, then kick the beam. Sometimes when increasing the kick amplitude, one will notice large losses. In this case it is recommended to kick a couple times at this amplitude or just below to see if the losses reduce or are consistent. + While doing so, also keep an eye on the beam intensity as can be seen on the vistars. Should they reduce the beam might have just needed cleaning and one can increase the kick amplitude further. Otherwise, stop increasing unless a beam dump is affordable. From cab977a6c8e25a1c886048889d1592bf12e20ba3 Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 17:26:07 +0100 Subject: [PATCH 4/8] more verbose --- docs/guis/multiturn/excitation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guis/multiturn/excitation.md b/docs/guis/multiturn/excitation.md index 4b35962f..ea74eba4 100644 --- a/docs/guis/multiturn/excitation.md +++ b/docs/guis/multiturn/excitation.md @@ -213,11 +213,11 @@ Trigger an acquisition by clicking the yellow ++"Acquire with ACDipole excitatio The AC Dipole will arm, then kick the beam. !!! tip "Watch for Losses on Kicks" - Make sure to have a `BLM Display` application open and to monitor the losses right after clicking to acquire. + Make sure to have a `BLM Display` application open and to monitor the losses right after clicking to acquire, and watch out for large losses and spikes close to thresholds. + This is especially important to do when increasing the kick amplitude btween kicks. TODO: insert a picture of the BLM display? - Sometimes when increasing the kick amplitude, one will notice large losses. In this case it is recommended to kick a couple times at this amplitude or just below to see if the losses reduce or are consistent. While doing so, also keep an eye on the beam intensity as can be seen on the vistars. From eaceab8c66e9aee2f79c4308423b6162651daec6 Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 17:43:04 +0100 Subject: [PATCH 5/8] it's Fixed Display, actually --- docs/guis/multiturn/excitation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guis/multiturn/excitation.md b/docs/guis/multiturn/excitation.md index ea74eba4..2e87a8f5 100644 --- a/docs/guis/multiturn/excitation.md +++ b/docs/guis/multiturn/excitation.md @@ -213,7 +213,7 @@ Trigger an acquisition by clicking the yellow ++"Acquire with ACDipole excitatio The AC Dipole will arm, then kick the beam. !!! tip "Watch for Losses on Kicks" - Make sure to have a `BLM Display` application open and to monitor the losses right after clicking to acquire, and watch out for large losses and spikes close to thresholds. + Make sure to have a `BLM Fixed Display` application open and to monitor the losses right after clicking to acquire, and watch out for large losses and spikes close to thresholds. This is especially important to do when increasing the kick amplitude btween kicks. TODO: insert a picture of the BLM display? @@ -254,7 +254,7 @@ This deficit can be overcome in improving the signal-to-noise ratio through incr Refer to the [AC Dipole Excitation](#ac-dipole-excitation) section above for the settings and steps. Trigger an acquisition by clicking the yellow ++"Acquire with ADT/AC excitation"++ button at the bottom left of the GUI. -Just as with the AC Dipole, make sure to keep an eye on the losses (via BLM display) during the acquisition. +Just as with the AC Dipole, make sure to keep an eye on the losses (via the `BLM Fixed Display` and beam intensities) during the acquisition. *[AC Dipole]: Alternating Current Dipole *[ADT]: LHC Transverse Damper From f28bf8472742abe9f52607c7e2124d0c13257ce8 Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 17:43:51 +0100 Subject: [PATCH 6/8] make TODO a comment for now --- docs/guis/multiturn/excitation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guis/multiturn/excitation.md b/docs/guis/multiturn/excitation.md index 2e87a8f5..01199f70 100644 --- a/docs/guis/multiturn/excitation.md +++ b/docs/guis/multiturn/excitation.md @@ -216,7 +216,7 @@ The AC Dipole will arm, then kick the beam. Make sure to have a `BLM Fixed Display` application open and to monitor the losses right after clicking to acquire, and watch out for large losses and spikes close to thresholds. This is especially important to do when increasing the kick amplitude btween kicks. - TODO: insert a picture of the BLM display? + In this case it is recommended to kick a couple times at this amplitude or just below to see if the losses reduce or are consistent. While doing so, also keep an eye on the beam intensity as can be seen on the vistars. From 7fc8c3869c10556bc83637020edf1379680d078a Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 17:45:24 +0100 Subject: [PATCH 7/8] more info on what to do --- docs/guis/multiturn/excitation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guis/multiturn/excitation.md b/docs/guis/multiturn/excitation.md index 01199f70..d1cffbb6 100644 --- a/docs/guis/multiturn/excitation.md +++ b/docs/guis/multiturn/excitation.md @@ -218,11 +218,11 @@ The AC Dipole will arm, then kick the beam. - In this case it is recommended to kick a couple times at this amplitude or just below to see if the losses reduce or are consistent. + In case large losses are observed, it is recommended to kick a couple times at the current amplitude or just below to see if the losses reduce or are consistent. While doing so, also keep an eye on the beam intensity as can be seen on the vistars. - Should they reduce the beam might have just needed cleaning and one can increase the kick amplitude further. - Otherwise, stop increasing unless a beam dump is affordable. + Should losses reduce, the beam might have just needed cleaning and one can increase the kick amplitude further. + Otherwise stop increasing unless a beam dump is affordable (hint: it **rarely** is). Refer to the experts on shift if unsure about the losses, and whether the kick amplitude can be increased further. After the kick is done, a new tab will open at the very top of the GUI to display the BPM measurements, which can be checked: a menu list lets one select any BPM from each beam, and view the recorded bunch centroid turn-by-turn data through the acquisition. From a928ec9128194c135b770b48d155e739230dac91 Mon Sep 17 00:00:00 2001 From: Felix Soubelet Date: Wed, 17 Dec 2025 17:58:55 +0100 Subject: [PATCH 8/8] mention the exact app --- docs/measurements/procedures/general_checks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/measurements/procedures/general_checks.md b/docs/measurements/procedures/general_checks.md index d9d0d5b3..2d65893a 100644 --- a/docs/measurements/procedures/general_checks.md +++ b/docs/measurements/procedures/general_checks.md @@ -72,7 +72,7 @@ Here are some general checks on should always keep in mind when performing measu

- [ ]
Have the Losses Applications Open -

When kicking from Multiturn, keep an eye on the losses application for unexpected spikes. +

When kicking from Multiturn, keep an eye on the losses application (`BLM Fixed Display`) for unexpected spikes.

- [ ]
Make Sure to Log All Info