quantify_scheduler.operations.pulse_library

Standard pulse-level operations for use with the quantify_scheduler.

Module Contents

Classes

ShiftClockPhase	An operation that shifts the phase of a clock by a specified amount.
ResetClockPhase	An operation that resets the phase of a clock.
SetClockFrequency	Operation that sets updates the frequency of a clock. This is a low-level operation
VoltageOffset	Operation that represents setting a constant offset to the output voltage.
IdlePulse	The IdlePulse Operation is a placeholder for a specified duration of time.
RampPulse	The RampPulse Operation is a real-valued pulse that ramps from the specified offset
StaircasePulse	A real valued staircase pulse, which reaches it's final amplitude in discrete
SquarePulse	The SquarePulse Operation is a real-valued pulse with the specified
SuddenNetZeroPulse	The sudden net-zero (SNZ) pulse from Neg\^ırneac et al. [2021].
SoftSquarePulse	The SoftSquarePulse Operation is a real valued square pulse convolved with
ChirpPulse	A linear chirp signal. A sinusoidal signal that ramps up in frequency.
DRAGPulse	DRAG pulse intended for single qubit gates in transmon based systems.
WindowOperation	The WindowOperation is an operation for visualization purposes.
NumericalPulse	Defines a pulse where the shape is determined by specifying an array of (complex)
SkewedHermitePulse	Hermite pulse intended for single qubit gates in diamond based systems.

Functions

decompose_long_square_pulse(→ list)	Generates a list of square pulses equivalent to a (very) long square pulse.
create_dc_compensation_pulse(→ SquarePulse)	Calculates a SquarePulse to counteract charging effects based on a list of pulses.
_extract_pulses(→ List[Dict[str, Any]])

class ShiftClockPhase(phase_shift: float, clock: str, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

An operation that shifts the phase of a clock by a specified amount.

Create a new instance of ShiftClockPhase.

Parameters

• phase_shift – The phase shift in degrees.

• clock – The clock of which to shift the phase.

• t0 – Time in seconds when to execute the command relative to the start time of the Operation in the Schedule.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

class ResetClockPhase(clock: str, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

An operation that resets the phase of a clock.

Create a new instance of ResetClockPhase.

Parameters

• clock – The clock of which to reset the phase.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

class SetClockFrequency(clock: str, clock_freq_new: float, t0: float = 0, duration: float = qblox_constants.NCO_SET_FREQ_WAIT * 1e-09)

Bases: quantify_scheduler.Operation

Operation that sets updates the frequency of a clock. This is a low-level operation and therefore depends on the backend.

Currently only implemented for Qblox backend, refer to NcoSetClockFrequencyStrategy for more details.

Parameters

• clock – The clock for which a new frequency is to be set.

• clock_freq_new – The new frequency in Hz.

• t0 – Time in seconds when to execute the command relative to the start time of the Operation in the Schedule.

• duration – The duration of the operation in seconds.

class VoltageOffset(offset_path_0: float, offset_path_1: float, duration: float = 0.0, port: Optional[str] = None, clock: Optional[str] = None, t0: float = 0)

Bases: quantify_scheduler.Operation

Operation that represents setting a constant offset to the output voltage.

Currently only implemented for Qblox backend, refer to AwgOffsetStrategy for more details.

Parameters

• offset_path_0 (float) – Offset of path 0 (the I-path).

• offset_path_1 (float) – Offset of path 1 (the Q-path).

• port (str or None, optional) – Port of the stitched pulse.

• clock (str or None, optional) – Clock used to modulate the stitched pulse.

• duration (float, optional) – The time to hold the offset for (in seconds).

• t0 (float, optional) – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

class IdlePulse(duration: float, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

The IdlePulse Operation is a placeholder for a specified duration of time.

Create a new instance of IdlePulse.

The IdlePulse Operation is a placeholder for a specified duration of time.

Parameters

• duration – The duration of idle time in seconds.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

class RampPulse(amp: float, duration: float, port: str, offset: float = 0, clock: str = BasebandClockResource.IDENTITY, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

The RampPulse Operation is a real-valued pulse that ramps from the specified offset to the specified amplitude + offset during the duration of the pulse.

Create a new instance of RampPulse.

The RampPulse Operation is a real-valued pulse that ramps from zero to the specified amplitude during the duration of the pulse.

The pulse is given as a function of time \(t\) and the parameters offset and amplitude by

\[P(t) = \mathrm{offset} + t \times \mathrm{amp}.\]

Parameters

• amp – Amplitude of the ramp envelope function.

• duration – The pulse duration in seconds.

• offset – Starting point of the ramp pulse

• port – Port of the pulse.

• clock – Clock used to modulate the pulse, by default a BasebandClock is used.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

• data – The operation’s dictionary, by default Nonen Note: if the data parameter is not None all other parameters are overwritten using the contents of data.n Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

class StaircasePulse(start_amp: float, final_amp: float, num_steps: int, duration: float, port: str, clock: str = BasebandClockResource.IDENTITY, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

A real valued staircase pulse, which reaches it’s final amplitude in discrete steps. In between it will maintain a plateau.

Constructor for a staircase.

Parameters

• start_amp – Starting amplitude of the staircase envelope function.

• final_amp – Final amplitude of the staircase envelope function.

• num_steps – The number of plateaus.

• duration – Duration of the pulse in seconds.

• port – Port of the pulse.

• clock – Clock used to modulate the pulse.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

class SquarePulse(amp: float, duration: float, port: str, clock: str = BasebandClockResource.IDENTITY, phase: float = 0, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

The SquarePulse Operation is a real-valued pulse with the specified amplitude during the pulse.

Create a new instance of SquarePulse.

The SquarePulse Operation is a real-valued pulse with the specified amplitude during the pulse.

Parameters

• amp – Amplitude of the envelope.

• duration – The pulse duration in seconds.

• port – Port of the pulse, must be capable of playing a complex waveform.

• clock – Clock used to modulate the pulse.

• phase – Phase of the pulse in degrees.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

class SuddenNetZeroPulse(amp_A: float, amp_B: float, net_zero_A_scale: float, t_pulse: float, t_phi: float, t_integral_correction: float, port: str, clock: str = BasebandClockResource.IDENTITY, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

The sudden net-zero (SNZ) pulse from Neg\^ırneac et al. [2021].

The sudden net-zero (SNZ) pulse from Neg\^ırneac et al. [2021].

The SuddenNetZeroPulse is a real-valued pulse that can be used to implement a conditional phase gate in transmon qubits.

Parameters

• amp_A – amplitude of the main square pulse

• amp_B – scaling correction for the final sample of the first square and first sample of the second square pulse.

• net_zero_A_scale – amplitude scaling correction factor of the negative arm of the net-zero pulse.

• t_pulse – the total duration of the two half square pulses

• t_phi – the idling duration between the two half pulses

• t_integral_correction – the duration in which any non-zero pulse amplitude needs to be corrected.

• port – Port of the pulse, must be capable of playing a complex waveform.

• clock – Clock used to modulate the pulse.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

decompose_long_square_pulse(duration: float, duration_max: float, single_duration: bool = False, **kwargs) → list

Generates a list of square pulses equivalent to a (very) long square pulse.

Intended to be used for waveform-memory-limited devices. Effectively, only two square pulses, at most, will be needed: a main one of duration duration_max and a second one for potential mismatch between N duration_max and overall duration.

Parameters

• duration – Duration of the long pulse in seconds.

• duration_max – Maximum duration of square pulses to be generated in seconds.

• single_duration – If True, only square pulses of duration duration_max will be generated. If False, a square pulse of duration < duration_max might be generated if necessary.

• **kwargs – Other keyword arguments to be passed to the SquarePulse.

Returns

A list of :class`SquarePulse` s equivalent to the desired long pulse.

class SoftSquarePulse(amp: float, duration: float, port: str, clock: str, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

The SoftSquarePulse Operation is a real valued square pulse convolved with a Hann window for smoothing.

Create a new instance of SoftSquarePulse.

The SoftSquarePulse Operation is a real valued square pulse convolved with a Hann window for smoothing.

Parameters

• amp – Amplitude of the envelope.

• duration – The pulse duration in seconds.

• port – Port of the pulse, must be capable of playing a complex waveform.

• clock – Clock used to modulate the pulse.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

class ChirpPulse(amp: float, duration: float, port: str, clock: str, start_freq: float, end_freq: float, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

A linear chirp signal. A sinusoidal signal that ramps up in frequency.

Constructor for a chirp pulse.

Parameters

• amp – Amplitude of the envelope.

• duration – Duration of the pulse.

• port – The port of the pulse.

• clock – Clock used to modulate the pulse.

• start_freq – Start frequency of the Chirp. Note that this is the frequency at which the waveform is calculated, this may differ from the clock frequency.

• end_freq – End frequency of the Chirp.

• t0 – Shift of the start time with respect to the start of the operation.

class DRAGPulse(G_amp: float, D_amp: float, phase: float, clock: str, duration: float, port: str, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

DRAG pulse intended for single qubit gates in transmon based systems.

A DRAG pulse is a gaussian pulse with a derivative component added to the out-of-phase channel to reduce unwanted excitations of the \(|1\rangle - |2\rangle\) transition (Motzoi et al. [2009] and Gambetta et al. [2011]).

The waveform is generated using waveforms.drag() .

Create a new instance of DRAGPulse.

Parameters

• G_amp – Amplitude of the Gaussian envelope.

• D_amp – Amplitude of the derivative component, the DRAG-pulse parameter.

• duration – The pulse duration in seconds.

• phase – Phase of the pulse in degrees.

• clock – Clock used to modulate the pulse.

• port – Port of the pulse, must be capable of carrying a complex waveform.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

create_dc_compensation_pulse(pulses: List[quantify_scheduler.Operation], sampling_rate: float, port: str, t0: float = 0, amp: Optional[float] = None, duration: Optional[float] = None, data: Optional[Dict[str, Any]] = None) → SquarePulse

Calculates a SquarePulse to counteract charging effects based on a list of pulses.

The compensation is calculated by summing the area of all pulses on the specified port. This gives a first order approximation for the pulse required to compensate the charging. All modulated pulses ignored in the calculation.

Parameters

• pulses – List of pulses to compensate

• sampling_rate – Resolution to calculate the enclosure of the pulses to calculate the area to compensate.

• amp – Desired amplitude of the DCCompensationPulse. Leave to None to calculate the value for compensation, in this case you must assign a value to duration. The sign of the amplitude is ignored and adjusted automatically to perform the compensation.

• duration – Desired pulse duration in seconds. Leave to None to calculate the value for compensation, in this case you must assign a value to amp. The sign of the value of amp given in the previous step is adjusted to perform the compensation.

• port – Port to perform the compensation. Any pulse that does not belong to the specified port is ignored.

• clock – Clock used to modulate the pulse.

• phase – Phase of the pulse in degrees.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

Returns

• Returns a SquarePulse object that compensates all pulses passed as argument.

_extract_pulses(pulses: List[quantify_scheduler.Operation], port: str) → List[Dict[str, Any]]

class WindowOperation(window_name: str, duration: float, t0: float = 0.0, data: Optional[Dict[str, Any]] = None)

Bases: quantify_scheduler.Operation

The WindowOperation is an operation for visualization purposes.

The WindowOperation has a starting time and duration.

Create a new instance of WindowOperation.

property window_name: str

Return the window name of this operation

class NumericalPulse(samples: Union[numpy.ndarray, list], t_samples: Union[numpy.ndarray, list], port: str, clock: str, t0: float = 0, interpolation: str = 'linear', data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

Defines a pulse where the shape is determined by specifying an array of (complex) points. If points are required between the specified samples (such as could be required by the sampling rate of the hardware), meaning \(t[n] < t' < t[n+1]\), scipy.interpolate.interp1d will be used to interpolate between the two points and determine the value.

Creates an instance of the NumericalPulse.

Parameters

• samples – An array of (possibly complex) values specifying the shape of the pulse.

• t_samples – An array of values specifying the corresponding times at which the samples are evaluated.

• port – The port that the pulse should be played on.

• clock – Clock used to (de)modulate the pulse.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule.

• interpolation – Specifies the type of interpolation used. This is passed as the “kind” argument to scipy.interpolate.interp1d.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.

class SkewedHermitePulse(duration: float, amplitude: float, skewness: float, phase: float, port: str, clock: str, t0: float = 0, data: Optional[dict] = None)

Bases: quantify_scheduler.Operation

Hermite pulse intended for single qubit gates in diamond based systems.

The waveform is generated using skewed_hermite().

Create a new instance of SkewedHermitePulse.

Parameters

• duration – The pulse duration in seconds.

• amplitude – Amplitude of the hermite pulse.

• skewness – Skewness in the frequency space.

• phase – Phase of the pulse in degrees.

• clock – Clock used to modulate the pulse.

• port – Port of the pulse, must be capable of carrying a complex waveform.

• t0 – Time in seconds when to start the pulses relative to the start time of the Operation in the Schedule. By default 0.

• data –

  The operation’s dictionary, by default None

  Note: if the data parameter is not None all other parameters are overwritten using the contents of data.

  Deprecated: support for the data argument will be dropped in quantify-scheduler >= 0.13.0. Please consider updating the data dictionary after initialization.