CameraController

class caqtus.device.camera.CameraController(

device_name: DeviceName,

shot_event_dispatcher: ShotEventDispatcher,

)

Bases: DeviceController

async run_shot(

camera: CameraProxy,

/,

timeout: float,

picture_names: list[str],

exposures: list[float],

*args,

**kwargs,

) → None

Runs a shot on the device.

This method must call wait_all_devices_ready() exactly once.

Parameters:

• device – An asynchronous proxy to the device being controlled.

• args –

  Extra arguments than can be computed before the shot and that are required to run the shot.

  These arguments are at the discretion of the subclass implementation.

• kwargs –

  Extra arguments than can be computed before the shot and that are required to run the shot.

  These arguments are at the discretion of the subclass implementation.

A typical implementation can look like this:

async def run_shot(self, device, instruction):
    await device.program(instruction)
    await self.wait_all_devices_ready()
    await device.trigger()

    data = await device.read_data()
    self.signal_data_acquired("some label", data)

Warning

Implementations of this method must be careful to handle cancellation at a checkpoint in case the shot is aborted.