3.2.4. qupulse.hardware.setup

Classes

HardwareSetup()	Representation of the hardware setup.
MarkerChannel(awg, channel_on_awg)	A hardware channel that can only take two values
MeasurementMask(dac, mask_name)
PlaybackChannel(awg, channel_on_awg, ...)	A hardware channel that is not a marker
RegisteredProgram(program, ...)	Create new instance of RegisteredProgram(program, measurement_windows, run_callback, awgs_to_upload_to, dacs_to_arm)

class HardwareSetup

Bases: object

Representation of the hardware setup.

The class takes an instruction block, forms it into possibly channel dependent programs and registers the programs at the AWGs which modify their program to fit to their capabilities. The class also extracts the measurement windows(with absolute times) and hands them over to the DACs which will do further processing.

arm_program(name: str) → None

Assert program is in memory. Hardware will wait for trigger event

clear_programs() → None

Clears all programs from all known AWG and DAC devices.

Does not affect channel configurations or measurement masks set by set_channel or set_measurement.

property known_awgs: Set[AWG]

property known_dacs: Set[DAC]

register_program(name: str, program: Loop, run_callback=<function HardwareSetup.<lambda>>, update: bool = False, measurements: Mapping[str, ~typing.Tuple[~numpy.ndarray, ~numpy.ndarray]]=None, channels: Sequence[str | int] = None) → None

Register a program under a given name at the hardware setup. The program will be uploaded to the participating AWGs and DACs. The run callback is used for triggering the program after arming.

Parameters:

• name – Name of the program.

• program – Output of create_program()

• run_callback – Used to trigger the program after arming

• update – Must be set if the program is already known.

• measurements – Will be used as measurements if provided. Otherwise, the measurements are extracted from the program.

registered_channels() → Dict[str | int, Set[_SingleChannel]]

property registered_programs: Dict[str, RegisteredProgram]

remove_program(name: str)

rm_channel(identifier: str | int) → None

run_program(name) → None

Calls arm program and starts it using the run callback

set_channel(identifier: str | int, single_channel: _SingleChannel | Iterable[_SingleChannel], allow_multiple_registration: bool = False) → None

set_measurement(measurement_name: str, measurement_mask: MeasurementMask | Iterable[MeasurementMask], allow_multiple_registration: bool = False)

update_parameters(name: str, parameters: Mapping[str, Real])

class MarkerChannel(awg: AWG, channel_on_awg: int)

Bases: _SingleChannel

A hardware channel that can only take two values

class MeasurementMask(dac: DAC, mask_name: str)

Bases: object

class PlaybackChannel(awg: ~qupulse.hardware.awgs.base.AWG, channel_on_awg: int, voltage_transformation: ~typing.Callable[[~numpy.ndarray], ~numpy.ndarray] = <function PlaybackChannel.<lambda>>)

Bases: _SingleChannel

A hardware channel that is not a marker

voltage_transformation

A transformation that is applied to the pulses on the channel. One use case is to scale up the voltage if an amplifier is inserted.