pulses

Classes for handling pulses.

Module Contents

Classes

PulseStrategyPartial	Contains the logic shared between all the pulses.
GenericPulseStrategy	Default class for handling pulses.
DigitalOutputStrategy	Interface class for MarkerPulseStrategy and DigitalPulseStrategy.
MarkerPulseStrategy	If this strategy is used a digital pulse is played on the corresponding marker.
DigitalPulseStrategy	If this strategy is used a digital pulse is played

Attributes

logger

logger

class PulseStrategyPartial(operation_info: quantify_scheduler.backends.types.qblox.OpInfo, channel_name: str)

Bases: quantify_scheduler.backends.qblox.operation_handling.base.IOperationStrategy

Contains the logic shared between all the pulses.

Parameters:

• operation_info – The operation info that corresponds to this pulse.

• channel_name – Specifies the channel identifier of the hardware config (e.g. complex_output_0).

_amplitude_path_I: float | None

_amplitude_path_Q: float | None

_pulse_info: quantify_scheduler.backends.types.qblox.OpInfo

channel_name

property operation_info: quantify_scheduler.backends.types.qblox.OpInfo

Property for retrieving the operation info.

class GenericPulseStrategy(operation_info: quantify_scheduler.backends.types.qblox.OpInfo, channel_name: str)

Bases: PulseStrategyPartial

Default class for handling pulses.

No assumptions are made with regards to the pulse shape and no optimizations are done.

Parameters:

• operation_info – The operation info that corresponds to this pulse.

• channel_name – Specifies the channel identifier of the hardware config (e.g. complex_output_0).

_amplitude_path_I: float | None = None

_amplitude_path_Q: float | None = None

_waveform_index0: int | None = None

_waveform_index1: int | None = None

_waveform_len: int | None = None

generate_data(wf_dict: dict[str, Any]) → None

Generates the data and adds them to the wf_dict (if not already present).

In complex mode (e.g. complex_output_0), the NCO produces real-valued data (\(I_\text{IF}\)) on sequencer path_I and imaginary data (\(Q_\text{IF}\)) on sequencer path_Q.

\[\begin{split}\underbrace{\begin{bmatrix} \cos\omega t & -\sin\omega t \\ \sin\omega t & \phantom{-}\cos\omega t \end{bmatrix}}_\text{NCO} \begin{bmatrix} I \\ Q \end{bmatrix} = \begin{bmatrix} I \cdot \cos\omega t - Q \cdot\sin\omega t \\ I \cdot \sin\omega t + Q \cdot\cos\omega t \end{bmatrix} \begin{matrix} \ \text{(path_I)} \\ \ \text{(path_Q)} \end{matrix} = \begin{bmatrix} I_\text{IF} \\ Q_\text{IF} \end{bmatrix}\end{split}\]

In real mode (e.g. real_output_0), the NCO produces \(I_\text{IF}\) on path_I

\[\begin{split}\underbrace{\begin{bmatrix} \cos\omega t & -\sin\omega t \\ \sin\omega t & \phantom{-}\cos\omega t \end{bmatrix}}_\text{NCO} \begin{bmatrix} I \\ Q \end{bmatrix} = \begin{bmatrix} I \cdot \cos\omega t - Q \cdot\sin\omega t\\ - \end{bmatrix} \begin{matrix} \ \text{(path_I)} \\ \ \text{(path_Q)} \end{matrix} = \begin{bmatrix} I_\text{IF} \\ - \end{bmatrix}\end{split}\]

Note that the fields marked with - represent waveforms that are not relevant for the mode.

Parameters:

wf_dict – The dictionary to add the waveform to. N.B. the dictionary is modified in function.

Raises:

ValueError – Data is complex (has an imaginary component), but the channel_name is not set as complex (e.g. complex_output_0).

insert_qasm(qasm_program: quantify_scheduler.backends.qblox.qasm_program.QASMProgram) → None

Add the assembly instructions for the Q1 sequence processor that corresponds to this pulse.

Parameters:

qasm_program – The QASMProgram to add the assembly instructions to.

class DigitalOutputStrategy(operation_info: quantify_scheduler.backends.types.qblox.OpInfo, channel_name: str)

Bases: PulseStrategyPartial

Interface class for MarkerPulseStrategy and DigitalPulseStrategy.

Both classes work very similarly, since they are both strategy classes for the ~quantify_scheduler.operations.pulse_library.MarkerPulse. The MarkerPulseStrategy is for the QCM/QRM modules, and the DigitalPulseStrategy for the QTM.

generate_data(wf_dict: dict[str, Any]) → None

Returns None as no waveforms are generated in this strategy.

class MarkerPulseStrategy(operation_info: quantify_scheduler.backends.types.qblox.OpInfo, channel_name: str)

Bases: DigitalOutputStrategy

If this strategy is used a digital pulse is played on the corresponding marker.

insert_qasm(qasm_program: quantify_scheduler.backends.qblox.qasm_program.QASMProgram) → None

Inserts the QASM instructions to play the marker pulse. Note that for RF modules the first two bits of set_mrk are used as switches for the RF outputs.

Parameters:

qasm_program – The QASMProgram to add the assembly instructions to.

static _fix_marker_bit_output_addressing_qcm_rf(qasm_program: quantify_scheduler.backends.qblox.qasm_program.QASMProgram, marker_bit_index: int) → int

Fix for the swapped marker bit output addressing of the QCM-RF.

class DigitalPulseStrategy(operation_info: quantify_scheduler.backends.types.qblox.OpInfo, channel_name: str)

Bases: DigitalOutputStrategy

If this strategy is used a digital pulse is played on the corresponding digital output channel.

insert_qasm(qasm_program: quantify_scheduler.backends.qblox.qasm_program.QASMProgram) → None

Inserts the QASM instructions to play the marker pulse. Note that for RF modules the first two bits of set_mrk are used as switches for the RF outputs.

Parameters:

qasm_program – The QASMProgram to add the assembly instructions to.