3.2.1.3. qupulse.hardware.awgs.tabor

Functions

with_configuration_guard(function_object)	This decorator assures that the AWG is in configuration mode while the decorated method runs.
with_select(function_object)	Asserts the channel pair is selected when the wrapped function is called

Classes

TaborAWGRepresentation([instr_addr, ...])
TaborChannelPair(tabor_device, channels, ...)
TaborProgramMemory(waveform_to_segment, program)	Create new instance of TaborProgramMemory(waveform_to_segment, program)

Exceptions

TaborUndefinedState(*args, device)

If this exception is raised the attached tabor device is in an undefined state.

class TaborAWGRepresentation(instr_addr=None, paranoia_level=1, external_trigger=False, reset=False, mirror_addresses=())

Bases: object

Parameters:

• instr_addr – Instrument address that is forwarded to tabor_control

• paranoia_level – Paranoia level that is forwarded to tabor_control

• external_trigger – Not supported yet

• reset

• mirror_addresses

abort() → None

property all_devices: Sequence[tabor_control.device.TEWXAwg]

amplitude(channel) → float

property channel_pair_AB: TaborChannelPair

property channel_pair_CD: TaborChannelPair

property dev_properties: dict

download_adv_seq_table(seq_table, pref=':ASEQ:DATA', paranoia_level=None)

download_segment_lengths(seg_len_list, pref=':SEGM:DATA', paranoia_level=None)

download_sequencer_table(seq_table, pref=':SEQ:DATA', paranoia_level=None)

enable() → None

get_readable_device(simulator=True) → tabor_control.device.TEWXAwg

get_status_table() → Dict[str, str | float | int]

Send a lot of queries to the AWG about its settings. A good way to visualize is using pandas.DataFrame

Returns:

An ordered dictionary with the results

initialize() → None

is_coupled() → bool

property is_open: bool

property main_instrument: tabor_control.device.TEWXAwg

property mirrored_instruments: Sequence[tabor_control.device.TEWXAwg]

offset(channel: int) → float

property paranoia_level: int

reset() → None

sample_rate(channel) → int

select_channel(channel) → None

select_marker(marker: int) → None

Select marker 1 or 2 of the currently active channel pair.

send_binary_data(pref, bin_dat, paranoia_level=None)

send_cmd(cmd_str, paranoia_level=None)

send_query(query_str, query_mirrors=False) → Any

trigger() → None

class TaborChannelPair(tabor_device: TaborAWGRepresentation, channels: Tuple[int, int], identifier: str)

Bases: AWG

CONFIG_MODE_PARANOIA_LEVEL = None

arm(name: str) → None

Load the program ‘name’ and arm the device for running it. If name is None the awg will “dearm” its current program.

change_armed_program(name: str | None) → None

cleanup() → None

Discard all segments after the last which is still referenced

clear() → None

Delete all segments and clear memory

property device: TaborAWGRepresentation

free_program(name: str) → TaborProgramMemory

property internal_paranoia_level: int | None

property logger

property num_channels: int

Number of channels

property num_markers: int

Number of marker channels

property programs: Set[str]

The set of program names that can currently be executed on the hardware AWG.

read_advanced_sequencer_table() → Tuple[ndarray, ndarray, ndarray]

read_complete_program() → PlottableProgram

read_sequence_tables() → List[Tuple[ndarray, ndarray, ndarray]]

read_waveforms() → List[ndarray]

remove(name: str) → None

Remove a program from the AWG.

Also discards all waveforms referenced only by the program identified by name.

Parameters:

name (str) – The name of the program to remove.

run_current_program() → None

property sample_rate: float

The sample rate of the AWG.

select() → None

set_channel_state(channel, active) → None

set_marker_state(marker: int, active: bool) → None

Sets the marker state of this channel pair. According to the manual one cannot turn them off/on separately.

set_program_advanced_sequence_table(name, new_advanced_sequence_table)

set_program_sequence_table(name, new_sequence_table)

set_volatile_parameters(program_name: str, parameters: Mapping[str, Number]) → None

Set the values of parameters which were marked as volatile on program creation. Sets volatile parameters in program memory and device’s (adv.) sequence tables if program is current program.

If set_volatile_parameters needs to run faster, set CONFIG_MODE_PARANOIA_LEVEL to 0 which causes the device to enter the configuration mode with paranoia level 0 (Note: paranoia level 0 does not work for the simulator) and set device._is_coupled.

Parameters:

• program_name – Name of program which should be changed.

• parameters – Names of volatile parameters and respective values to which they should be set.

property total_capacity: int

upload(name: str, program: Loop, channels: Tuple[str | int | None, str | int | None], markers: Tuple[str | int | None, str | int | None], voltage_transformation: Tuple[Callable, Callable], force: bool = False) → None

Upload a program to the AWG.

The policy is to prefer amending the unknown waveforms to overwriting old ones.