def int_weights_envelope(self, envelope=None):
"""Set or get the envelope multiplied with the integration
weights.
Arguments:
envelope (list or double): Envelope value or list of values
to be multiplied with the integration weights. Each
value must be between 0.0 and 1.0 (default: 1.0).
Raises:
ToolkitError: If integration weight envelope is given as a
list or array but the length of the list does not match
the integration length.
"""
if envelope is None:
return self._int_weights_envelope
else:
if isinstance(envelope, list) or isinstance(envelope, np.ndarray):
if len(envelope) == self._parent.integration_length():
for i in range(len(envelope)):
envelope[i] = Parse.greater_equal(envelope[i], 0)
envelope[i] = Parse.smaller_equal(envelope[i], 1.0)
else:
_logger.error(
"The length of `int_weights_envelope` list must be equal to "
"integration length.",
_logger.ExceptionTypes.ToolkitError,
)
else:
envelope = Parse.greater_equal(envelope, 0)
envelope = Parse.smaller_equal(envelope, 1.0)
self._int_weights_envelope = envelope
self._set_int_weights()
return self._int_weights_envelope
def mode(self, mode=None):
if mode is None:
v = self._scopeModule.getInt("mode")
return Parse.get_scope_mode(v)
else:
v = Parse.set_scope_mode(mode)
self._scopeModule.set("mode", v)
def _init_scope_params(self):
self._enable = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/enable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.single = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/single"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.length = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/length"),
device=self._parent,
set_parser=[
lambda v: Parse.greater_equal(v, 4096),
lambda v: Parse.smaller_equal(v, 128000000),
lambda v: Parse.multiple_of(v, 16, "down"),
],
)
self._channel = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channel"),
device=self._parent,
)
self.trigger_source = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/trigchannel"),
device=self._parent,
auto_mapping=True,
)
self.trigger_level = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/triglevel"),
device=self._parent,
)
self.trigger_enable = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/trigenable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.trigger_reference = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/trigreference"),
device=self._parent,
)
self.trigger_holdoff = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/trigholdoff"),
device=self._parent,
)
def _init_params(self):
"""Initialize parameters associated with device nodes."""
super()._init_params()
self.ref_clock = Parameter(
self,
self._get_node_dict(f"system/clocks/referenceclock/in/source"),
device=self,
auto_mapping=True,
)
self.ref_clock_actual = Parameter(
self,
self._get_node_dict(
f"system/clocks/referenceclock/in/sourceactual"),
device=self,
auto_mapping=True,
)
self.ref_clock_status = Parameter(
self,
self._get_node_dict(f"system/clocks/referenceclock/in/status"),
device=self,
get_parser=Parse.get_locked_status,
)
self.progress = Parameter(
self,
self._get_node_dict(f"execution/progress"),
device=self,
)
self._enable = Parameter(
self,
self._get_node_dict(f"execution/enable"),
device=self,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.repetitions = Parameter(
self,
self._get_node_dict(f"execution/repetitions"),
device=self,
set_parser=[
lambda v: Parse.greater_equal(v, 1),
lambda v: Parse.smaller_equal(v, 2**32 - 1),
],
)
self.holdoff = Parameter(
self,
self._get_node_dict(f"execution/holdoff"),
device=self,
set_parser=[
lambda v: Parse.greater_equal(v, 100e-9),
lambda v: Parse.multiple_of(v, 100e-9, "nearest"),
],
)
def readout_amplitude(self, amp=None):
"""Sets or gets the readout amplitude for this channel.
The amplitude of the readout pulse is used for signal generation of the
readout tone if the channel is enabled and if the AWG
:class:`SequenceProgram` is of type *'Readout'*. (default: 1.0)
"""
if amp is None:
return self._readout_amplitude
else:
Parse.amp1(amp)
self._readout_amplitude = amp
return self._readout_amplitude
def _init_sweeper_params(self):
self.oscillator_gain = Parameter(
self,
self._device._get_node_dict(f"qachannels/{self._index}/oscs/0/gain"),
device=self._device,
set_parser=[
lambda v: Parse.smaller_equal(v, 1.0),
lambda v: Parse.greater_equal(v, 0.0),
],
)
self.oscillator_freq = Parameter(
self,
self._device._get_node_dict(f"qachannels/{self._index}/oscs/0/freq"),
device=self._device,
set_parser=[
lambda v: Parse.smaller_equal(v, 1e9),
lambda v: Parse.greater_equal(v, 0.0),
],
)
self.integration_time = Parameter(
self,
dict(
Node=f"{self._device.serial}/qachannels/{self._index}/spectroscopy/length".upper(),
Description="Sets the integration length in Spectroscopy mode in unit "
"of seconds. Up to 16.7 ms can be recorded, which "
"corresponds to 33.5 MSa (2^25 samples).",
Type="Double",
Properties="Read, Write, Setting",
Unit="s",
),
device=self._device,
set_parser=Parse.shfqa_time2samples,
get_parser=Parse.shfqa_samples2time,
)
self.integration_length = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/spectroscopy/length"
),
device=self._device,
set_parser=[
lambda v: Parse.greater_equal(v, 4),
lambda v: Parse.smaller_equal(v, ((2 ** 23) - 1) * 4),
lambda v: Parse.multiple_of(v, 4, "down"),
],
)
self.integration_delay = Parameter(
self,
self._device._get_node_dict(f"qachannels/{self._index}/spectroscopy/delay"),
device=self._device,
set_parser=lambda v: Parse.multiple_of(v, 2e-9, "nearest"),
)
self.trigger_source = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/spectroscopy/trigger/channel"
),
device=self._device,
auto_mapping=True,
)
def _init_qachannel_params(self):
self.input = Parameter(
self,
self._parent._get_node_dict(f"qachannels/{self._index}/input/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.input_range = Parameter(
self,
self._parent._get_node_dict(
f"qachannels/{self._index}/input/range"),
device=self._parent,
set_parser=[
lambda v: Parse.greater_equal(v, -50),
lambda v: Parse.smaller_equal(v, 10),
lambda v: Parse.multiple_of(v, 5, "nearest"),
],
)
self.output = Parameter(
self,
self._parent._get_node_dict(f"qachannels/{self._index}/output/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.output_range = Parameter(
self,
self._parent._get_node_dict(
f"qachannels/{self._index}/output/range"),
device=self._parent,
set_parser=[
lambda v: Parse.greater_equal(v, -50),
lambda v: Parse.smaller_equal(v, 10),
lambda v: Parse.multiple_of(v, 5, "nearest"),
],
)
self.center_freq = Parameter(
self,
self._parent._get_node_dict(
f"qachannels/{self._index}/centerfreq"),
device=self._parent,
set_parser=[
lambda v: Parse.greater_equal(v, 1e9),
lambda v: Parse.smaller_equal(v, 8e9),
lambda v: Parse.multiple_of(v, 100e6, "nearest"),
],
)
self.mode = Parameter(
self,
self._parent._get_node_dict(f"qachannels/{self._index}/mode"),
device=self._parent,
auto_mapping=True,
)
def _init_params(self):
"""Initialize parameters associated with device nodes."""
super()._init_params()
self.integration_time = Parameter(
self,
dict(
Node=f"{self.serial}/qas/0/integration/length".upper(),
Description=
"The integration time of all weighted integration units "
"specified in seconds. In Standard mode, a maximum of 4096 "
"samples can be integrated, which corresponds to 2.3 µs. "
"In Spectroscopy mode, a maximum of 16.7 MSa can be "
"integrated, which corresponds to ~10 ms.",
Type="Double",
Properties="Read, Write, Setting",
Unit="s",
),
device=self,
set_parser=Parse.uhfqa_time2samples,
get_parser=Parse.uhfqa_samples2time,
)
self.integration_length = Parameter(
self,
self._get_node_dict("qas/0/integration/length"),
device=self,
set_parser=[
lambda v: Parse.greater_equal(v, 4),
lambda v: Parse.multiple_of(v, 4, "down"),
],
)
self.result_source = Parameter(
self,
self._get_node_dict("qas/0/result/source"),
device=self,
mapping=MAPPINGS["result_source"],
)
self.averaging_mode = Parameter(
self,
self._get_node_dict("qas/0/result/mode"),
device=self,
mapping=MAPPINGS["averaging_mode"],
)
self.ref_clock = Parameter(
self,
self._get_node_dict(f"system/extclk"),
device=self,
auto_mapping=True,
)
def _init_awg_params(self):
self._enable = Parameter(
self,
self._parent._get_node_dict(f"awgs/0/enable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.output1 = Parameter(
self,
self._parent._get_node_dict("sigouts/0/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.output2 = Parameter(
self,
self._parent._get_node_dict("sigouts/1/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.gain1 = Parameter(
self,
self._parent._get_node_dict("awgs/0/outputs/0/amplitude"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1.0),
lambda v: Parse.greater_equal(v, -1.0),
],
)
self.gain2 = Parameter(
self,
self._parent._get_node_dict("awgs/0/outputs/1/amplitude"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1.0),
lambda v: Parse.greater_equal(v, -1.0),
],
)
self.single = Parameter(
self,
self._parent._get_node_dict("awgs/0/single"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
def readout_frequency(self, freq=None):
"""Sets or gets the readout frequency for this channel.
Readout frequency in Hz of the readout channel. If the AWG
:class:`SequenceProgram` is of type "Readout", this Parameter is used to
generate a readout tone at the given readout frequency for all readout
channels that are enabled. This frequency is also used in the signal
acquisition for digital demodulation if the readout channel is
enabled. The frequency must be positive.
"""
if freq is None:
return self._readout_frequency
else:
Parse.greater0(freq)
self._readout_frequency = freq
self._set_int_weights()
return self._readout_frequency
def phase_shift(self, ph=None):
"""Sets or gets the readout phase shift for this channel.
Additional phase shift in the signal generation between I and Q
quadratures. (default: 0)
"""
if ph is None:
return self._phase_shift
else:
self._phase_shift = Parse.phase(ph)
return self._phase_shift
def _init_generator_params(self):
self._enable = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/generator/enable"),
device=self._device,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.dig_trigger1_source = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/generator/auxtriggers/0/channel"),
device=self._device,
auto_mapping=True,
)
self.dig_trigger2_source = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/generator/auxtriggers/1/channel"),
device=self._device,
auto_mapping=True,
)
self.playback_delay = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/generator/delay"),
device=self._device,
set_parser=lambda v: Parse.multiple_of(v, 2e-9, "nearest"),
)
self._ready = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/generator/ready"),
device=self._device,
)
self.single = Parameter(
self,
self._device._get_node_dict(
f"qachannels/{self._index}/generator/single"),
device=self._device,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
def _init_awg_params(self):
self._enable = Parameter(
self,
self._parent._get_node_dict(f"awgs/{self._index}/enable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.output1 = Parameter(
self,
self._parent._get_node_dict(f"sigouts/{2*self._index}/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.output2 = Parameter(
self,
self._parent._get_node_dict(f"sigouts/{2*self._index+1}/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.modulation_freq = Parameter(
self,
self._parent._get_node_dict(f"oscs/{4 * self._index}/freq"),
device=self._parent,
set_parser=lambda v: Parse.greater(v, 0),
)
self.modulation_phase_shift = Parameter(
self,
self._parent._get_node_dict(
f"sines/{2 * self._index + 1}/phaseshift"),
device=self._parent,
set_parser=Parse.phase,
)
self.gain1 = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/outputs/0/gains/0"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1.0),
lambda v: Parse.greater_equal(v, -1.0),
],
)
self.gain2 = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/outputs/1/gains/1"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1.0),
lambda v: Parse.greater_equal(v, -1.0),
],
)
self.single = Parameter(
self,
self._parent._get_node_dict(f"awgs/{self._index}/single"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.zsync_register_mask = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/register/mask"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 15),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_register_shift = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/register/shift"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 3),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_register_offset = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/register/offset"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1023),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_decoder_mask = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/decoder/mask"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 255),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_decoder_shift = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/decoder/shift"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 7),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_decoder_offset = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/decoder/offset"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1023),
lambda v: Parse.greater_equal(v, 0),
],
)
def _init_scope_params(self):
self._enable = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/enable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.channel1 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/0/enable"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.channel2 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/1/enable"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.channel3 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/2/enable"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.channel4 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/3/enable"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.input_select1 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/0/inputselect"),
device=self._parent,
auto_mapping=True,
)
self.input_select2 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/1/inputselect"),
device=self._parent,
auto_mapping=True,
)
self.input_select3 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/2/inputselect"),
device=self._parent,
auto_mapping=True,
)
self.input_select4 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/3/inputselect"),
device=self._parent,
auto_mapping=True,
)
self._wave1 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/0/wave"),
device=self._parent,
)
self._wave2 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/1/wave"),
device=self._parent,
)
self._wave3 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/2/wave"),
device=self._parent,
)
self._wave4 = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/channels/3/wave"),
device=self._parent,
)
self.trigger_source = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/trigger/channel"),
device=self._parent,
auto_mapping=True,
)
self.trigger_delay = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/trigger/delay"),
device=self._parent,
set_parser=lambda v: Parse.multiple_of(v, 2e-9, "nearest"),
)
self.length = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/length"),
device=self._parent,
set_parser=[
lambda v: Parse.greater_equal(v, 16),
lambda v: Parse.smaller_equal(v, 2 ** 18),
lambda v: Parse.multiple_of(v, 16, "down"),
],
)
self.time = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/time"),
device=self._parent,
auto_mapping=True,
)
self._segments_enable = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/segments/enable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self._segments_count = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/segments/count"),
device=self._parent,
set_parser=lambda v: Parse.greater(v, 0),
)
self._averaging_enable = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/averaging/enable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self._averaging_count = Parameter(
self,
self._parent._get_node_dict(f"scopes/0/averaging/count"),
device=self._parent,
set_parser=lambda v: Parse.greater(v, 0),
)
def _init_awg_params(self):
self._enable = Parameter(
self,
self._parent._get_node_dict(f"awgs/{self._index}/enable"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.output1 = Parameter(
self,
self._parent._get_node_dict(f"sigouts/{2*self._index}/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
self.output2 = Parameter(
self,
self._parent._get_node_dict(f"sigouts/{2*self._index+1}/on"),
device=self._parent,
set_parser=Parse.set_on_off,
get_parser=Parse.get_on_off,
)
# If the HDAWG has the MF option, the oscillator assignment
# per core is different
if "MF" in self._parent.options:
oscs_multiplier = 4
else:
oscs_multiplier = 1
self.modulation_freq = Parameter(
self,
self._parent._get_node_dict(
f"oscs/{oscs_multiplier* self._index}/freq"),
device=self._parent,
set_parser=lambda v: Parse.greater(v, 0),
)
self.modulation_phase_shift = Parameter(
self,
self._parent._get_node_dict(
f"sines/{2 * self._index + 1}/phaseshift"),
device=self._parent,
set_parser=Parse.phase,
)
self.gain1 = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/outputs/0/gains/0"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1.0),
lambda v: Parse.greater_equal(v, -1.0),
],
)
self.gain2 = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/outputs/1/gains/1"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1.0),
lambda v: Parse.greater_equal(v, -1.0),
],
)
self.single = Parameter(
self,
self._parent._get_node_dict(f"awgs/{self._index}/single"),
device=self._parent,
set_parser=Parse.set_true_false,
get_parser=Parse.get_true_false,
)
self.zsync_register_mask = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/register/mask"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 15),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_register_shift = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/register/shift"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 3),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_register_offset = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/register/offset"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1023),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_decoder_mask = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/decoder/mask"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 255),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_decoder_shift = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/decoder/shift"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 7),
lambda v: Parse.greater_equal(v, 0),
],
)
self.zsync_decoder_offset = Parameter(
self,
self._parent._get_node_dict(
f"awgs/{self._index}/zsync/decoder/offset"),
device=self._parent,
set_parser=[
lambda v: Parse.smaller_equal(v, 1023),
lambda v: Parse.greater_equal(v, 0),
],
)