Feature Description

As a user/instrument scientist of the south side muon instruments, I would like my beam to remain stable when other muon instruments change the power of their main magnets.

Explanation

The main magnets on the south side muon instruments (particularity EMU) are strong enough to alter the beam position in other instruments. This can be corrected by applying linear scaling factors to the beam positioning magnets on those instruments based on the known strength of the magnet at a given point in time (the steering magnets are weak enough that their impact on other beam-lines in negligible).

MuSR can run in two modes, each of which will need to be adjusted for.

Additional Information

This was first proposed in 2018. In 2019 a meeting took place and was documented. No further action was taken as it was easiest to implement this when all instruments were migrated to IBEX. With the migration of HiFi earlier this year, this has now been completed and so we are in a position to do this work. A meeting took place in September 2025 where it was agreed the requirements were broadly outlined in that documentation (which has been updated following that meeting).

_{See our Git Workflow.}

Acceptance Criteria

• An IOC exists that applies appropriate corrections to beam positions for each of the south side instruments based on the known strength of the other instruments main magnets.
• Information on this IOC is exposed to users
• Existing documentation for what is planned is updated to be documentation for this IOC.
• Testing has taken place with the relevant muon beam-lines out of cycle to ensure it functions as expected

How to Review

_{Before making a PR...}

• Provide verbose instructions for the reviewer to test your changes
• Describe how you have implemented testing for this feature
• Provide screenshots of the feature to help the reviewer if relevant

_{If not applicable, write "Not applicable"}

...

_{To the reviewer: Make sure to update submodules!}

Discussed 00:48:50 - in planning 02/10/25 move to next sprint
DIscussed 08/01/2026 14:44