# Repository: https://gitlab.com/quantify-os/quantify-scheduler
# Licensed according to the LICENCE file on the main branch
"""Standard pulse-level operations for use with the quantify_scheduler."""
from __future__ import annotations
from dataclasses import dataclass
from typing import Any, Literal
import numpy as np
from qcodes import InstrumentChannel, validators
from quantify_scheduler.operations.operation import Operation
from quantify_scheduler.resources import BasebandClockResource, DigitalClockResource
@dataclass
[docs]
class ReferenceMagnitude:
"""Dataclass defining a reference level for pulse amplitudes in units of 'V', 'dBm', or 'A'."""
[docs]
unit: Literal["V", "dBm", "A"]
@classmethod
[docs]
def from_parameter(cls, parameter: InstrumentChannel) -> ReferenceMagnitude | None:
"""Initialize from ReferenceMagnitude QCoDeS InstrumentChannel values."""
value, unit = parameter.get_val_unit()
if np.isnan(value):
return None
if unit not in (allowed_units := ["V", "dBm", "A", "W"]):
raise ValueError(f"Invalid unit: {unit}. Allowed units: {allowed_units}")
return cls(value, unit)
def __hash__(self) -> int:
return hash((self.value, self.unit))
[docs]
class ShiftClockPhase(Operation):
"""
Operation that shifts the phase of a clock by a specified amount.
This is a low-level operation and therefore depends on the backend.
Currently only implemented for Qblox backend, refer to
:class:`~quantify_scheduler.backends.qblox.operation_handling.virtual.NcoPhaseShiftStrategy`
for more details.
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.
duration
(deprecated) The duration of the operation in seconds.
"""
def __init__(
self,
phase_shift: float,
clock: str,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"t0": t0,
"phase_shift": phase_shift,
"clock": clock,
"port": None,
"duration": 0,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class ResetClockPhase(Operation):
"""
An operation that resets the phase of a clock.
Parameters
----------
clock
The clock of which to reset the phase.
"""
def __init__(self, clock: str, t0: float = 0) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"clock": clock,
"t0": t0,
"duration": 0,
"port": None,
"reset_clock_phase": True,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class SetClockFrequency(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
:class:`~quantify_scheduler.backends.qblox.operation_handling.virtual.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.
If None, it will reset to the clock frequency set by the configuration or resource.
t0
Time in seconds when to execute the command relative to the start time of
the Operation in the Schedule.
duration
(deprecated) The duration of the operation in seconds.
"""
def __init__(
self,
clock: str,
clock_freq_new: float | None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"t0": t0,
"clock": clock,
"clock_freq_new": clock_freq_new,
"clock_freq_old": None,
"interm_freq_old": None,
"port": None,
"duration": 0,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class VoltageOffset(Operation):
"""
Operation that represents setting a constant offset to the output voltage.
Please refer to :ref:`sec-qblox-offsets-long-voltage-offsets` in the reference guide
for more details.
Parameters
----------
offset_path_I : float
Offset of path I.
offset_path_Q : float
Offset of path Q.
port : str
Port of the voltage offset.
clock : str, optional
Clock used to modulate the voltage offset.
By default the baseband clock.
duration : float, optional
(deprecated) 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.
reference_magnitude :
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
"""
def __init__(
self,
offset_path_I: float,
offset_path_Q: float,
port: str,
clock: str = BasebandClockResource.IDENTITY,
t0: float = 0,
reference_magnitude: ReferenceMagnitude | None = None,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"t0": t0,
"offset_path_I": offset_path_I,
"offset_path_Q": offset_path_Q,
"clock": clock,
"port": port,
"duration": 0.0,
"reference_magnitude": reference_magnitude,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class IdlePulse(Operation):
"""
The IdlePulse Operation is a placeholder for a specified duration of time.
Parameters
----------
duration
The duration of idle time in seconds.
"""
def __init__(self, duration: float) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"t0": 0,
"duration": duration,
"clock": BasebandClockResource.IDENTITY,
"port": None,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class RampPulse(Operation):
r"""
RampPulse Operation is a pulse that ramps from zero to a set amplitude over its duration.
The pulse is given as a function of time :math:`t` and the parameters offset and
amplitude by
.. math::
P(t) = \mathrm{offset} + t \times \mathrm{amp}.
Parameters
----------
amp
Unitless 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 the baseband clock.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
t0
Time in seconds when to start the pulses relative
to the start time
of the Operation in the Schedule.
"""
def __init__(
self,
amp: float,
duration: float,
port: str,
clock: str = BasebandClockResource.IDENTITY,
reference_magnitude: ReferenceMagnitude | None = None,
offset: float = 0,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.ramp",
"amp": amp,
"reference_magnitude": reference_magnitude,
"duration": duration,
"offset": offset,
"t0": t0,
"clock": clock,
"port": port,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class StaircasePulse(Operation):
"""
A real valued staircase pulse, which reaches it's final amplitude in discrete steps.
In between it will maintain a plateau.
Parameters
----------
start_amp
Starting unitless amplitude of the staircase envelope function.
final_amp
Final unitless 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.
By default the baseband clock.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule.
"""
def __init__(
self,
start_amp: float,
final_amp: float,
num_steps: int,
duration: float,
port: str,
clock: str = BasebandClockResource.IDENTITY,
reference_magnitude: ReferenceMagnitude | None = None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.staircase",
"start_amp": start_amp,
"final_amp": final_amp,
"reference_magnitude": reference_magnitude,
"num_steps": num_steps,
"duration": duration,
"t0": t0,
"clock": clock,
"port": port,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class MarkerPulse(Operation):
"""
Digital pulse that is HIGH for the specified duration.
Marker pulse is played on marker output. Currently only implemented for Qblox
backend.
Parameters
----------
duration
Duration of the HIGH signal.
port
Name of the associated port.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule.
clock
Name of the associated clock. By default
:class:`~quantify_scheduler.resources.DigitalClockResource`. This only needs to
be specified if a custom clock name is used for a digital channel (for example,
when a port-clock combination of a device element is used with a digital
channel).
fine_start_delay
Delays the start of the pulse by the given amount in seconds. Does not
delay the start time of the operation in the schedule. If the hardware
supports it, this parameter can be used to shift the pulse by a small
amount of time, independent of the hardware instruction timing grid.
Currently only implemented for Qblox QTM modules, which allow only
positive values for this parameter. By default 0.
fine_end_delay
Delays the end of the pulse by the given amount in seconds. Does not
delay the end time of the operation in the schedule. If the hardware
supports it, this parameter can be used to shift the pulse by a small
amount of time, independent of the hardware instruction timing grid.
Currently only implemented for Qblox QTM modules, which allow only
positive values for this parameter. By default 0.
"""
def __init__(
self,
duration: float,
port: str,
t0: float = 0,
clock: str = DigitalClockResource.IDENTITY,
fine_start_delay: float = 0,
fine_end_delay: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"marker_pulse": True, # This distinguishes MarkerPulse from other operations
"t0": t0,
"clock": clock,
"port": port,
"duration": duration,
"fine_start_delay": fine_start_delay,
"fine_end_delay": fine_end_delay,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class SquarePulse(Operation):
"""
A real-valued pulse with the specified amplitude during the pulse.
Parameters
----------
amp
Unitless complex valued 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.
By default the baseband clock.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule.
"""
def __init__(
self,
amp: complex,
duration: float,
port: str,
clock: str = BasebandClockResource.IDENTITY,
reference_magnitude: ReferenceMagnitude | None = None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.square",
"amp": amp,
"reference_magnitude": reference_magnitude,
"duration": duration,
"t0": t0,
"clock": clock,
"port": port,
}
]
self._update()
def __str__(self) -> str:
# Some pulse infos do not have amps in them, we need to select the correct pulse info.
pulse_info = [d for d in self.data["pulse_info"] if "amp" in d][0]
return self._get_signature(pulse_info)
[docs]
class SuddenNetZeroPulse(Operation):
"""
A pulse that can be used to implement a conditional phase gate in transmon device elements.
The sudden net-zero (SNZ) pulse is defined in
:cite:t:`negirneac_high_fidelity_2021`.
Parameters
----------
amp_A
Unitless amplitude of the main square pulse.
amp_B
Unitless 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.
By default the baseband clock.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule.
"""
def __init__(
self,
amp_A: float, # noqa N803: upper case in variable
amp_B: float, # noqa N803: upper case in variable
net_zero_A_scale: float, # noqa N803: upper case in variable
t_pulse: float,
t_phi: float,
t_integral_correction: float,
port: str,
clock: str = BasebandClockResource.IDENTITY,
reference_magnitude: ReferenceMagnitude | None = None,
t0: float = 0,
) -> None:
duration = t_pulse + t_phi + t_integral_correction
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.sudden_net_zero",
"amp_A": amp_A,
"amp_B": amp_B,
"reference_magnitude": reference_magnitude,
"net_zero_A_scale": net_zero_A_scale,
"t_pulse": t_pulse,
"t_phi": t_phi,
"t_integral_correction": t_integral_correction,
"duration": duration,
"phase": 0,
"t0": t0,
"clock": clock,
"port": port,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
def 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 :class:`~SquarePulse`.
Returns
-------
:
A list of :class`SquarePulse` s equivalent to the desired long pulse.
"""
# Sanity checks
validator_dur = validators.Numbers(min_value=0.0, max_value=7 * 24 * 3600.0)
validator_dur.validate(duration)
validator_dur_max = validators.Numbers(min_value=0.0, max_value=duration)
validator_dur_max.validate(duration_max)
duration_last_pulse = duration % duration_max
num_pulses = int(duration // duration_max)
pulses = [SquarePulse(duration=duration_max, **kwargs) for _ in range(num_pulses)]
if duration_last_pulse != 0.0:
duration_last_pulse = duration_max if single_duration else duration_last_pulse
pulses.append(SquarePulse(duration=duration_last_pulse, **kwargs))
return pulses
[docs]
class SoftSquarePulse(Operation):
"""
A real valued square pulse convolved with a Hann window for smoothing.
Parameters
----------
amp
Unitless 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.
By default the baseband clock.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule.
"""
def __init__(
self,
amp: float,
duration: float,
port: str,
clock: str = BasebandClockResource.IDENTITY,
reference_magnitude: ReferenceMagnitude | None = None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.soft_square",
"amp": amp,
"reference_magnitude": reference_magnitude,
"duration": duration,
"t0": t0,
"clock": clock,
"port": port,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class ChirpPulse(Operation):
"""
A linear chirp signal. A sinusoidal signal that ramps up in frequency.
Parameters
----------
amp
Unitless 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.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
t0
Shift of the start time with respect to the start of the operation.
"""
def __init__(
self,
amp: float,
duration: float,
port: str,
clock: str,
start_freq: float,
end_freq: float,
reference_magnitude: ReferenceMagnitude | None = None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.chirp",
"amp": amp,
"reference_magnitude": reference_magnitude,
"duration": duration,
"start_freq": start_freq,
"end_freq": end_freq,
"t0": t0,
"clock": clock,
"port": port,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class DRAGPulse(Operation):
r"""
A Gaussian pulse with a derivative component added to the out-of-phase channel.
It uses the specified amplitude and sigma.
If sigma is not specified it is set to 1/4 of the duration.
The DRAG pulse is intended for single qubit gates in transmon based systems.
It can be calibrated to reduce unwanted excitations of the
:math:`|1\rangle - |2\rangle` transition (:cite:t:`motzoi_simple_2009` and
:cite:t:`gambetta_analytic_2011`).
The waveform is generated using :func:`.waveforms.drag` .
Parameters
----------
G_amp
Unitless amplitude of the Gaussian envelope.
D_amp
Unitless 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.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
sigma
Width of the Gaussian envelope in seconds. If not provided, the sigma
is set to 1/4 of the duration.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule.
"""
def __init__(
self,
G_amp: float,
D_amp: float,
phase: float,
duration: float,
port: str,
clock: str,
reference_magnitude: ReferenceMagnitude | None = None,
sigma: float = None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.drag",
"G_amp": G_amp,
"D_amp": D_amp,
"reference_magnitude": reference_magnitude,
"duration": duration,
"phase": phase,
"nr_sigma": 4 if sigma is None else None,
"sigma": sigma,
"clock": clock,
"port": port,
"t0": t0,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class GaussPulse(Operation):
r"""
The GaussPulse Operation is a real-valued pulse with the specified
amplitude and sigma.
If sigma is not specified it is set to 1/4 of the duration.
The waveform is generated using :func:`.waveforms.drag` whith a D_amp set to zero,
corresponding to a Gaussian pulse.
Parameters
----------
G_amp
Unitless amplitude of the Gaussian envelope.
duration
The pulse duration in seconds.
phase
Phase of the pulse in degrees.
clock
Clock used to modulate the pulse.
By default the baseband clock.
port
Port of the pulse, must be capable of carrying a complex waveform.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
sigma
Width of the Gaussian envelope in seconds. If not provided, the sigma
is set to 1/4 of the duration.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule.
"""
def __init__(
self,
G_amp: float,
phase: float,
duration: float,
port: str,
clock: str = BasebandClockResource.IDENTITY,
reference_magnitude: ReferenceMagnitude | None = None,
sigma: float = None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.drag",
"G_amp": G_amp,
"D_amp": 0,
"reference_magnitude": reference_magnitude,
"duration": duration,
"phase": phase,
"nr_sigma": 4 if sigma is None else None,
"sigma": sigma,
"clock": clock,
"port": port,
"t0": t0,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
def create_dc_compensation_pulse(
pulses: list[Operation],
sampling_rate: float,
port: str,
t0: float = 0,
amp: float | None = None,
reference_magnitude: ReferenceMagnitude | None = None, # noqa: ARG001
duration: float | None = 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 unitless amplitude of the DC compensation SquarePulse.
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.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
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.
Returns
-------
:
Returns a SquarePulse object that compensates all pulses passed as argument.
"""
# Prevent circular import.
from quantify_scheduler.helpers.waveforms import area_pulses
def _extract_pulses(pulses: list[Operation], port: str) -> list[dict[str, Any]]:
# Collect all pulses for the given port
pulse_info_list: list[dict[str, Any]] = []
for pulse in pulses:
for pulse_info in pulse["pulse_info"]:
if (
pulse_info["port"] == port
and pulse_info["clock"] == BasebandClockResource.IDENTITY
):
pulse_info_list.append(pulse_info)
return pulse_info_list
# Make sure that the list contains at least one element
if len(pulses) == 0:
raise ValueError(
"Attempting to create a DC compensation SquarePulse with no pulses. "
"At least one pulse is necessary."
)
pulse_info_list: list[dict[str, Any]] = _extract_pulses(pulses, port)
# Calculate the area given by the list of pulses
area: float = area_pulses(pulse_info_list, sampling_rate)
# Calculate the compensation amplitude and duration based on area
c_duration: float
c_amp: float
if amp is None and duration is not None:
if not duration > 0:
raise ValueError(
f"Attempting to create a DC compensation SquarePulse specified by {duration=}. "
f"Duration must be a positive number."
)
c_duration = duration
c_amp = -area / c_duration
elif amp is not None and duration is None:
c_amp = -abs(amp) if area > 0 else abs(amp)
c_duration = abs(area / c_amp)
else:
raise ValueError(
"The DC compensation SquarePulse allows either amp or duration to "
+ "be specified, not both. Both amp and duration were passed."
)
return SquarePulse(
amp=c_amp,
duration=c_duration,
port=port,
clock=BasebandClockResource.IDENTITY,
t0=t0,
)
[docs]
class WindowOperation(Operation):
"""
The WindowOperation is an operation for visualization purposes.
The :class:`~WindowOperation` has a starting time and duration.
"""
def __init__(
self,
window_name: str,
duration: float,
t0: float = 0.0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"window_name": window_name,
"duration": duration,
"t0": t0,
"port": None,
}
]
self._update()
@property
[docs]
def window_name(self) -> str:
"""Return the window name of this operation."""
return self.data["pulse_info"][0]["window_name"]
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class NumericalPulse(Operation):
"""
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 :math:`t[n] < t' < t[n+1]`,
`scipy.interpolate.interp1d` will be used to interpolate between the two points and
determine the value.
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.
By default the baseband clock.
reference_magnitude
Scaling value and unit for the unitless samples. Uses settings in
hardware config if not provided.
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`.
"""
def __init__(
self,
samples: np.ndarray | list,
t_samples: np.ndarray | list,
port: str,
clock: str = BasebandClockResource.IDENTITY,
reference_magnitude: ReferenceMagnitude | None = None,
t0: float = 0,
interpolation: str = "linear",
) -> None:
def make_list_from_array(val: np.ndarray[float] | list[float]) -> list[float]:
"""Needed since numpy arrays break the (de)serialization code (#146)."""
if isinstance(val, np.ndarray):
new_val: list[float] = val.tolist()
return new_val
return val
duration = t_samples[-1] - t_samples[0]
samples, t_samples = map(make_list_from_array, [samples, t_samples])
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.interpolated_complex_waveform",
"samples": samples,
"t_samples": t_samples,
"reference_magnitude": reference_magnitude,
"duration": duration,
"interpolation": interpolation,
"clock": clock,
"port": port,
"t0": t0,
}
]
self._update()
def __str__(self) -> str:
"""Provides a string representation of the Pulse."""
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class SkewedHermitePulse(Operation):
"""
Hermite pulse intended for single qubit gates in diamond based systems.
The waveform is generated using :func:`~quantify_scheduler.waveforms.skewed_hermite`.
Parameters
----------
duration
The pulse duration in seconds.
amplitude
Unitless 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.
reference_magnitude
Scaling value and unit for the unitless amplitude. Uses settings in
hardware config if not provided.
t0
Time in seconds when to start the pulses relative to the start time
of the Operation in the Schedule. By default 0.
"""
def __init__(
self,
duration: float,
amplitude: float,
skewness: float,
phase: float,
port: str,
clock: str,
reference_magnitude: ReferenceMagnitude | None = None,
t0: float = 0,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": "quantify_scheduler.waveforms.skewed_hermite",
"duration": duration,
"amplitude": amplitude,
"reference_magnitude": reference_magnitude,
"skewness": skewness,
"phase": phase,
"clock": clock,
"port": port,
"t0": t0,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
[docs]
class Timestamp(Operation):
"""
Operation that marks a time reference for timetags.
Specifically, all timetags in
:class:`~quantify_scheduler.operations.acquisition_library.Timetag` and
:class:`~quantify_scheduler.operations.acquisition_library.TimetagTrace` are
measured relative to the timing of this operation, if they have a matching port and
clock, and if ``time_ref=TimeRef.TIMESTAMP`` is given as an argument.
Parameters
----------
port
The same port that the timetag acquisition is defined on.
clock
The same clock that the timetag acquisition is defined on.
t0
Time offset (in seconds) of this Operation, relative to the start time in the
Schedule. By default 0.
"""
def __init__(
self,
port: str,
t0: float = 0,
clock: str = DigitalClockResource.IDENTITY,
) -> None:
super().__init__(name=self.__class__.__name__)
self.data["pulse_info"] = [
{
"wf_func": None,
"t0": t0,
"duration": 0,
"clock": clock,
"port": port,
"timestamp": True,
}
]
self._update()
def __str__(self) -> str:
pulse_info = self.data["pulse_info"][0]
return self._get_signature(pulse_info)
