dodal.devices.beamlines.i19.access_controlled.energy_device.AccessControlledEnergyComposite#

class dodal.devices.beamlines.i19.access_controlled.energy_device.AccessControlledEnergyComposite[source]#

I19-specific device to change the beamline energy.

This device will send a REST call to the blueapi instance controlling the optics hutch running on the I19 cluster, which will evaluate the current hutch in use vs the hutch sending the request and decide if the plan will be run or not. As the two hutches are located in series, checking the hutch in use is necessary to avoid accidentally operating the common optics devices (dcm, undulator, focusing mirrors and stripes) from one hutch while the other has beamtime.

The name of the hutch that wants to change the energy, as well as a commissioning directory to act as a placeholder for the instrument_session, should be passed to the device upon instantiation.

The plan to change the energy also involves moving the mirror stripes and the stripe selection is hutch-dependent, so the choice of stripe needs to be done internally to this device and passed to the plan.

For details see the architecture described in https://diamondlightsource.github.io/i19-bluesky/main/explanations/decisions/0004-optics-blueapi-architecture.html

Parameters:

  • dcm_prefix (str)

  • hutch (HutchState)

  • mirror_energy_config (str)

  • config_client (ConfigClient)

  • instrument_session (str, default: '')

  • name (str, default: '')

Methods

set(value)

Attributes