From 32d4e63e8cca34268a1a01ba336c7631ee139c06 Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Thu, 5 May 2022 18:43:05 +0300
Subject: [PATCH 01/14] Implement basic functionality for uploading waveforms

---
 .../drivers/Tektronix/AFG3000.py              | 59 ++++++++++++++++++-
 1 file changed, 58 insertions(+), 1 deletion(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index 9ddcd2d40..247738b69 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -1,10 +1,16 @@
-from typing import Any, Tuple
+from typing import Any, Tuple, List
 
+import numpy as np
 from qcodes import VisaInstrument
 import qcodes.utils.validators as vals
 from qcodes.utils.helpers import create_on_off_val_mapping
 
 
+
+MIN_WAVEFORM_LENGTH = 2
+MAX_WAVEFORM_LENGTH = 131072
+
+
 class AFG3000(VisaInstrument):
     """Qcodes driver for Tektronix AFG3000 series arbitrary function generator.
     
@@ -621,6 +627,57 @@ def synchronize_phase(self, src: int) -> None:
         self.log.info('Synchronizing CH1 and CH2 phase.')
         self.write(f'SOURce{src}:PHASe:INITiate')
 
+    def reset_edit_memory(self, points: int = 1000):
+        """
+        Reset the contents of the edit memory (EMEM), and set its size to
+        `points`.
+
+        Each point will be initialized with the value 8191, which corresponds
+        to zero amplitude.
+        """
+        if (points < MIN_WAVEFORM_LENGTH or
+            points > MAX_WAVEFORM_LENGTH):
+            raise ValueErorr(f"Trying to reset edit memory with invalid length: {points}")
+
+        self.write(f"DATA:DEFINE EMEM,{points}")
+
+    def upload_waveform(self, waveform: List[float], memory: int):
+        """
+        Upload a waveform to the editable memory (EMEM), and then copy it to the
+        USER1, USER2, USER3 or USER4 memory.
+
+        Args:
+            waveform: list of points containing the waveform data,
+                containing values from -1 to 1.
+            memory: The USER# memory where to to store the waveform, from 1 to 4.
+        """
+        if (len(waveform) < MIN_WAVEFORM_LENGTH or
+            len(waveform) > MAX_WAVEFORM_LENGTH):
+            raise ValueErorr(f"Invalid waveform length: {len(waveform)}")
+
+        if memory not in [1, 2, 3, 4]:
+            raise ValueErorr(f"Invalid value for memory: '{memory}'")
+
+        self.reset_edit_memory(len(waveform))
+
+        # convert waveform to two-byte integer values in the range 0..16382 (= 2**14-2)
+        wf_codes = ((np.array(waveform) + 1) * 0.5 * (2**14-2)).astype(np.uint16)
+        n_bytes = wf_codes.nbytes
+        n_digits_in_n_bytes = len(str(n_bytes))
+
+        # write data to the editable memory
+        self.visa_handle.write_binary_values(
+            f"DATA:DATA EMEM,#{n_digits_in_n_bytes}{n_bytes}",
+            wf_codes,
+            datatype="H", # unsigned short (16 bits)
+            is_big_endian=True, # the AFG expects data in big endian order
+            header_fmt="empty", # do not prefix data with header
+        )
+
+        # copy data from editable memory to USER.
+        self.write(f"DATA:COPY USER{memory},EMEM")
+
+
 class AFG3252(AFG3000):
     pass
     

From 4b770f02d8f83a6720b3112ed1a5ddc1a70e5c7e Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Thu, 5 May 2022 20:15:21 +0300
Subject: [PATCH 02/14] Attempt at readin back waveform data from AFG

This doesn't completely work. For some reason, after the query, the
AFG keeps spitting out data (self.visa_handle.read_raw() returns
some data), and I couldn't figure out what to do with it based on
the manual. So this is mostly a curiosity that I will revert.
---
 .../drivers/Tektronix/AFG3000.py              | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index 247738b69..a08b55c8a 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -561,6 +561,15 @@ def __init__(self, name: str, address: str, **kwargs: Any):
             vals=vals.Enum('INTernal', 'INT', 'EXTernal', 'EXT')
         )
 
+        self.add_parameter(
+            name='ememory_points',
+            label='Number of points in the editable memory',
+            get_cmd='DATA:POINts? EMEM',
+            get_parser=int,
+            set_cmd='DATA:POINts EMEM, {}',
+            vals=vals.Ints(MIN_WAVEFORM_LENGTH, MAX_WAVEFORM_LENGTH),
+        )
+
         # Trigger parameters
         self.add_parameter(
             name='trigger_slope',
@@ -677,6 +686,31 @@ def upload_waveform(self, waveform: List[float], memory: int):
         # copy data from editable memory to USER.
         self.write(f"DATA:COPY USER{memory},EMEM")
 
+    def read_waveform(self, memory: int) -> np.ndarray:
+        """
+        Copy the waveform stored in one of the user memories to the edit memory
+        and read the waveform data from the device.
+        """
+        if memory not in [1, 2, 3, 4]:
+            raise ValueErorr(f"Invalid value for memory: '{memory}'")
+
+        # copy the requested memory contents to the edit memory
+        self.write(f"DATA:COPY EMEM,USER{memory}")
+
+        self.write("DATA:DATA? EMEM")
+        self.visa_handle.read_bytes(1)  # the first character is '#', skip it
+        # how many digits does the size of the data have?
+        n_digits_in_n_bytes = int(self.visa_handle.read_bytes(1))
+        # the actual size of the data in bytes
+        n_bytes = int(self.visa_handle.read_bytes(n_digits_in_n_bytes))
+        # actually read the data
+        wf_bytes = self.visa_handle.read_bytes(n_bytes)
+
+        # convert bytes to numbers and apply appropriate scaling
+        # ">u2" means "two-byte unsigned integer in big endian format"
+        wf_codes = np.frombuffer(wf_bytes, dtype=">u2")
+        return (wf_codes * 1.0 / (2**14-2) - 0.5) * 2
+
 
 class AFG3252(AFG3000):
     pass

From c5e0c4a6011361aa02eb7a6f9d44c9ba68dfcffc Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Thu, 5 May 2022 20:17:02 +0300
Subject: [PATCH 03/14] Revert "Attempt at readin back waveform data from AFG"

This reverts commit 0dbf56bed84ed957075f89829fe1a6c7d60190ad.
---
 .../drivers/Tektronix/AFG3000.py              | 34 -------------------
 1 file changed, 34 deletions(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index a08b55c8a..247738b69 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -561,15 +561,6 @@ def __init__(self, name: str, address: str, **kwargs: Any):
             vals=vals.Enum('INTernal', 'INT', 'EXTernal', 'EXT')
         )
 
-        self.add_parameter(
-            name='ememory_points',
-            label='Number of points in the editable memory',
-            get_cmd='DATA:POINts? EMEM',
-            get_parser=int,
-            set_cmd='DATA:POINts EMEM, {}',
-            vals=vals.Ints(MIN_WAVEFORM_LENGTH, MAX_WAVEFORM_LENGTH),
-        )
-
         # Trigger parameters
         self.add_parameter(
             name='trigger_slope',
@@ -686,31 +677,6 @@ def upload_waveform(self, waveform: List[float], memory: int):
         # copy data from editable memory to USER.
         self.write(f"DATA:COPY USER{memory},EMEM")
 
-    def read_waveform(self, memory: int) -> np.ndarray:
-        """
-        Copy the waveform stored in one of the user memories to the edit memory
-        and read the waveform data from the device.
-        """
-        if memory not in [1, 2, 3, 4]:
-            raise ValueErorr(f"Invalid value for memory: '{memory}'")
-
-        # copy the requested memory contents to the edit memory
-        self.write(f"DATA:COPY EMEM,USER{memory}")
-
-        self.write("DATA:DATA? EMEM")
-        self.visa_handle.read_bytes(1)  # the first character is '#', skip it
-        # how many digits does the size of the data have?
-        n_digits_in_n_bytes = int(self.visa_handle.read_bytes(1))
-        # the actual size of the data in bytes
-        n_bytes = int(self.visa_handle.read_bytes(n_digits_in_n_bytes))
-        # actually read the data
-        wf_bytes = self.visa_handle.read_bytes(n_bytes)
-
-        # convert bytes to numbers and apply appropriate scaling
-        # ">u2" means "two-byte unsigned integer in big endian format"
-        wf_codes = np.frombuffer(wf_bytes, dtype=">u2")
-        return (wf_codes * 1.0 / (2**14-2) - 0.5) * 2
-
 
 class AFG3252(AFG3000):
     pass

From 6b0b313505ceca3a114de21bb03bee1962e19462 Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Thu, 5 May 2022 20:40:01 +0300
Subject: [PATCH 04/14] Use built-in prefix functionality instead of
 calculating it manually

---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index 247738b69..012a20589 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -662,16 +662,14 @@ def upload_waveform(self, waveform: List[float], memory: int):
 
         # convert waveform to two-byte integer values in the range 0..16382 (= 2**14-2)
         wf_codes = ((np.array(waveform) + 1) * 0.5 * (2**14-2)).astype(np.uint16)
-        n_bytes = wf_codes.nbytes
-        n_digits_in_n_bytes = len(str(n_bytes))
 
         # write data to the editable memory
         self.visa_handle.write_binary_values(
-            f"DATA:DATA EMEM,#{n_digits_in_n_bytes}{n_bytes}",
+            f"DATA:DATA EMEM,",
             wf_codes,
             datatype="H", # unsigned short (16 bits)
             is_big_endian=True, # the AFG expects data in big endian order
-            header_fmt="empty", # do not prefix data with header
+            header_fmt="ieee",
         )
 
         # copy data from editable memory to USER.

From f511193c5c8f8c826225f290b449dbcb7cd71b71 Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Fri, 6 May 2022 13:10:24 +0300
Subject: [PATCH 05/14] Add note on voltage levels in docstring

---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index 012a20589..0a19d3cdb 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -646,6 +646,11 @@ def upload_waveform(self, waveform: List[float], memory: int):
         Upload a waveform to the editable memory (EMEM), and then copy it to the
         USER1, USER2, USER3 or USER4 memory.
 
+        The waveform data should contain values in the range -1..1. Note that
+        the actual voltage values that are output will depend on the values of
+        the `voltage_low1/2` and `voltage_high1/2` parameters; -1 will be
+        mapped to `voltage_low` and +1 to `voltage_high`.
+
         Args:
             waveform: list of points containing the waveform data,
                 containing values from -1 to 1.

From 3439a01ce164773ea2cc23683ef3525302a2d7d3 Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Fri, 6 May 2022 15:34:23 +0300
Subject: [PATCH 06/14] Change waveform data range to be 0..1

This is easier to understand if the voltage_low/hi is asymmetric.
---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index 0a19d3cdb..9e531099f 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -646,14 +646,14 @@ def upload_waveform(self, waveform: List[float], memory: int):
         Upload a waveform to the editable memory (EMEM), and then copy it to the
         USER1, USER2, USER3 or USER4 memory.
 
-        The waveform data should contain values in the range -1..1. Note that
+        The waveform data should contain values in the range 0..1. Note that
         the actual voltage values that are output will depend on the values of
-        the `voltage_low1/2` and `voltage_high1/2` parameters; -1 will be
-        mapped to `voltage_low` and +1 to `voltage_high`.
+        the `voltage_low1/2` and `voltage_high1/2` parameters; 0 will be
+        mapped to `voltage_low` and 1 to `voltage_high`.
 
         Args:
             waveform: list of points containing the waveform data,
-                containing values from -1 to 1.
+                containing values from 0 to 1.
             memory: The USER# memory where to to store the waveform, from 1 to 4.
         """
         if (len(waveform) < MIN_WAVEFORM_LENGTH or
@@ -666,7 +666,7 @@ def upload_waveform(self, waveform: List[float], memory: int):
         self.reset_edit_memory(len(waveform))
 
         # convert waveform to two-byte integer values in the range 0..16382 (= 2**14-2)
-        wf_codes = ((np.array(waveform) + 1) * 0.5 * (2**14-2)).astype(np.uint16)
+        wf_codes = (np.array(waveform) * (2**14-2)).astype(np.uint16)
 
         # write data to the editable memory
         self.visa_handle.write_binary_values(

From 729e71fde480ec8e685817074188dcc3016c2003 Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Tue, 24 May 2022 12:39:21 +0300
Subject: [PATCH 07/14] Add example notebook for AFG3000 with arbitrary
 waveform output

---
 docs/examples/Tektronix_AFG3000_series.ipynb | 1177 ++++++++++++++++++
 1 file changed, 1177 insertions(+)
 create mode 100644 docs/examples/Tektronix_AFG3000_series.ipynb

diff --git a/docs/examples/Tektronix_AFG3000_series.ipynb b/docs/examples/Tektronix_AFG3000_series.ipynb
new file mode 100644
index 000000000..c848f714a
--- /dev/null
+++ b/docs/examples/Tektronix_AFG3000_series.ipynb
@@ -0,0 +1,1177 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Tektronix AFG3000 series arbitrary function generator"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%matplotlib notebook\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "from qcodes_contrib_drivers.drivers.Tektronix.AFG3000 import AFG3000"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {
+    "scrolled": true
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Connected to: TEKTRONIX AFG3252 (serial:C010219, firmware:SCPI:99.0 FV:3.2.4) in 3.94s\n"
+     ]
+    }
+   ],
+   "source": [
+    "afg = AFG3000(\"AFG\", address=\"TCPIP0::10.0.100.108::inst0::INSTR\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "AFG:\n",
+      "\tparameter              value\n",
+      "--------------------------------------------------------------------------------\n",
+      "IDN                     :\t{'vendor': 'TEKTRONIX', 'model': 'AFG3252', 'serial...\n",
+      "am_depth1               :\t50 (%)\n",
+      "am_depth2               :\t50 (%)\n",
+      "am_internal_efile1      :\t\"\" \n",
+      "am_internal_efile2      :\t\"\" \n",
+      "am_internal_freq1       :\t10000 (Hz)\n",
+      "am_internal_freq2       :\t10000 (Hz)\n",
+      "am_internal_function1   :\tSIN \n",
+      "am_internal_function2   :\tSIN \n",
+      "am_internal_source1     :\tINT \n",
+      "am_internal_source2     :\tINT \n",
+      "am_state1               :\tFalse \n",
+      "am_state2               :\tFalse \n",
+      "burst_mode1             :\tTRIG \n",
+      "burst_mode2             :\tTRIG \n",
+      "burst_ncycles1          :\t1 \n",
+      "burst_ncycles2          :\t5 \n",
+      "burst_state1            :\tTrue \n",
+      "burst_state2            :\tFalse \n",
+      "burst_tdelay1           :\t0 (s)\n",
+      "burst_tdelay2           :\t0 (s)\n",
+      "center_freq1            :\t5.5e+05 (Hz)\n",
+      "center_freq2            :\t5.5e+05 (Hz)\n",
+      "combine1                :\t\"\" \n",
+      "combine2                :\t\"\" \n",
+      "fm_deviation1           :\t1e+06 (Hz)\n",
+      "fm_deviation2           :\t1e+06 (Hz)\n",
+      "fm_internal_efile1      :\t\"\" \n",
+      "fm_internal_efile2      :\t\"\" \n",
+      "fm_internal_freq1       :\t10000 (Hz)\n",
+      "fm_internal_freq2       :\t10000 (Hz)\n",
+      "fm_internal_function1   :\tSIN \n",
+      "fm_internal_function2   :\tSIN \n",
+      "fm_internal_source1     :\tINT \n",
+      "fm_internal_source2     :\tINT \n",
+      "fm_state1               :\tFalse \n",
+      "fm_state2               :\tFalse \n",
+      "freq_concurrent1        :\tFalse \n",
+      "freq_concurrent2        :\tFalse \n",
+      "freq_cw1                :\t10000 (Hz)\n",
+      "freq_cw2                :\t1e+06 (Hz)\n",
+      "freq_mode1              :\tCW \n",
+      "freq_mode2              :\tCW \n",
+      "freq_span1              :\t9e+05 (Hz)\n",
+      "freq_span2              :\t9e+05 (Hz)\n",
+      "freq_start1             :\t1e+05 (Hz)\n",
+      "freq_start2             :\t1e+05 (Hz)\n",
+      "freq_stop1              :\t1e+06 (Hz)\n",
+      "freq_stop2              :\t1e+06 (Hz)\n",
+      "fsk_freq1               :\t1e+06 (Hz)\n",
+      "fsk_freq2               :\t1e+06 (Hz)\n",
+      "fsk_internal_rate1      :\t50 (Hz)\n",
+      "fsk_internal_rate2      :\t50 (Hz)\n",
+      "fsk_source1             :\tINT \n",
+      "fsk_source2             :\tINT \n",
+      "fsk_state1              :\tFalse \n",
+      "fsk_state2              :\tFalse \n",
+      "function_efile1         :\t\"\" \n",
+      "function_efile2         :\t\"\" \n",
+      "function_ramp_symmetry1 :\t50 (%)\n",
+      "function_ramp_symmetry2 :\t50 (%)\n",
+      "function_shape1         :\tUSER \n",
+      "function_shape2         :\tSIN \n",
+      "impedance_output1       :\t50 (Ohm)\n",
+      "impedance_output2       :\t50 (Ohm)\n",
+      "noise_level3            :\t10 (%)\n",
+      "noise_level4            :\t10 (%)\n",
+      "phase1                  :\t0 (degrees)\n",
+      "phase2                  :\t0 (degrees)\n",
+      "pm_deviation1           :\t1.5708 (degrees)\n",
+      "pm_deviation2           :\t1.5708 (degrees)\n",
+      "pm_internal_efile1      :\t\"\" \n",
+      "pm_internal_efile2      :\t\"\" \n",
+      "pm_internal_freq1       :\t10000 (Hz)\n",
+      "pm_internal_freq2       :\t10000 (Hz)\n",
+      "pm_internal_function1   :\tSIN \n",
+      "pm_internal_function2   :\tSIN \n",
+      "pm_internal_source1     :\tINT \n",
+      "pm_internal_source2     :\tINT \n",
+      "pm_state1               :\tFalse \n",
+      "pm_state2               :\tFalse \n",
+      "polarity_output1        :\tNORM \n",
+      "polarity_output2        :\tNORM \n",
+      "pulse_delay1            :\t0 (s)\n",
+      "pulse_delay2            :\t0 (s)\n",
+      "pulse_duty_cycle1       :\t50 (%)\n",
+      "pulse_duty_cycle2       :\t50 (%)\n",
+      "pulse_hold1             :\tDUTY \n",
+      "pulse_hold2             :\tDUTY \n",
+      "pulse_period1           :\t1e-06 (s)\n",
+      "pulse_period2           :\t1e-06 (s)\n",
+      "pulse_trans_lead1       :\t2.5e-09 (s)\n",
+      "pulse_trans_lead2       :\t2.5e-09 (s)\n",
+      "pulse_trans_trail1      :\t2.5e-09 (s)\n",
+      "pulse_trans_trail2      :\t2.5e-09 (s)\n",
+      "pulse_width1            :\t5e-07 (s)\n",
+      "pulse_width2            :\t5e-07 (s)\n",
+      "pwm_duty_deviation1     :\t5 (%)\n",
+      "pwm_duty_deviation2     :\t5 (%)\n",
+      "pwm_internal_efile1     :\t\"\" \n",
+      "pwm_internal_efile2     :\t\"\" \n",
+      "pwm_internal_freq1      :\t10000 (Hz)\n",
+      "pwm_internal_freq2      :\t10000 (Hz)\n",
+      "pwm_internal_function1  :\tSIN \n",
+      "pwm_internal_function2  :\tSIN \n",
+      "pwm_internal_source1    :\tINT \n",
+      "pwm_internal_source2    :\tINT \n",
+      "pwm_state1              :\tFalse \n",
+      "pwm_state2              :\tFalse \n",
+      "ref_osc_source          :\tINT \n",
+      "state_output1           :\tTrue \n",
+      "state_output2           :\tFalse \n",
+      "sweep_hold_time1        :\t0 (s)\n",
+      "sweep_hold_time2        :\t0 (s)\n",
+      "sweep_mode1             :\tAUTO \n",
+      "sweep_mode2             :\tAUTO \n",
+      "sweep_return_time1      :\t0.001 (s)\n",
+      "sweep_return_time2      :\t0.001 (s)\n",
+      "sweep_spacing1          :\tLIN \n",
+      "sweep_spacing2          :\tLIN \n",
+      "sweep_time1             :\t0.01 (s)\n",
+      "sweep_time2             :\t0.01 (s)\n",
+      "timeout                 :\t20 (s)\n",
+      "trigger_mode            :\tTRIG \n",
+      "trigger_slope           :\tPOS \n",
+      "trigger_source          :\tTIM \n",
+      "trigger_timer           :\t0.001 (s)\n",
+      "voltage_amplitude1      :\t1 \n",
+      "voltage_amplitude2      :\t1 \n",
+      "voltage_concurrent1     :\tFalse \n",
+      "voltage_concurrent2     :\tFalse \n",
+      "voltage_high1           :\t0.5 (V)\n",
+      "voltage_high2           :\t0.5 (V)\n",
+      "voltage_limit_high1     :\t1 (V)\n",
+      "voltage_limit_high2     :\t5 (V)\n",
+      "voltage_limit_low1      :\t-1 (V)\n",
+      "voltage_limit_low2      :\t-5 (V)\n",
+      "voltage_low1            :\t-0.5 (V)\n",
+      "voltage_low2            :\t-0.5 (V)\n",
+      "voltage_offset1         :\t0 (V)\n",
+      "voltage_offset2         :\t0 (V)\n",
+      "voltage_unit1           :\tVPP \n",
+      "voltage_unit2           :\tVPP \n"
+     ]
+    }
+   ],
+   "source": [
+    "afg.print_readable_snapshot(update=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Upload an arbitrary waveform to the AFG and output it\n",
+    "\n",
+    "Note that the waveform data values are in the range 0..1, but the actual voltages output by the AFG depend on the values of the `afg.voltage_low1/2` and `afg.voltage_high1/2` parameters."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Define the waveform we're going to upload. Note that the values of the time axis don't really mean anything; the duration of the waveform is determined by the `afg.freq_cw1/2` parameters (see below)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {
+    "scrolled": false
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/javascript": [
+       "/* Put everything inside the global mpl namespace */\n",
+       "window.mpl = {};\n",
+       "\n",
+       "\n",
+       "mpl.get_websocket_type = function() {\n",
+       "    if (typeof(WebSocket) !== 'undefined') {\n",
+       "        return WebSocket;\n",
+       "    } else if (typeof(MozWebSocket) !== 'undefined') {\n",
+       "        return MozWebSocket;\n",
+       "    } else {\n",
+       "        alert('Your browser does not have WebSocket support. ' +\n",
+       "              'Please try Chrome, Safari or Firefox ≥ 6. ' +\n",
+       "              'Firefox 4 and 5 are also supported but you ' +\n",
+       "              'have to enable WebSockets in about:config.');\n",
+       "    };\n",
+       "}\n",
+       "\n",
+       "mpl.figure = function(figure_id, websocket, ondownload, parent_element) {\n",
+       "    this.id = figure_id;\n",
+       "\n",
+       "    this.ws = websocket;\n",
+       "\n",
+       "    this.supports_binary = (this.ws.binaryType != undefined);\n",
+       "\n",
+       "    if (!this.supports_binary) {\n",
+       "        var warnings = document.getElementById(\"mpl-warnings\");\n",
+       "        if (warnings) {\n",
+       "            warnings.style.display = 'block';\n",
+       "            warnings.textContent = (\n",
+       "                \"This browser does not support binary websocket messages. \" +\n",
+       "                    \"Performance may be slow.\");\n",
+       "        }\n",
+       "    }\n",
+       "\n",
+       "    this.imageObj = new Image();\n",
+       "\n",
+       "    this.context = undefined;\n",
+       "    this.message = undefined;\n",
+       "    this.canvas = undefined;\n",
+       "    this.rubberband_canvas = undefined;\n",
+       "    this.rubberband_context = undefined;\n",
+       "    this.format_dropdown = undefined;\n",
+       "\n",
+       "    this.image_mode = 'full';\n",
+       "\n",
+       "    this.root = $('<div/>');\n",
+       "    this._root_extra_style(this.root)\n",
+       "    this.root.attr('style', 'display: inline-block');\n",
+       "\n",
+       "    $(parent_element).append(this.root);\n",
+       "\n",
+       "    this._init_header(this);\n",
+       "    this._init_canvas(this);\n",
+       "    this._init_toolbar(this);\n",
+       "\n",
+       "    var fig = this;\n",
+       "\n",
+       "    this.waiting = false;\n",
+       "\n",
+       "    this.ws.onopen =  function () {\n",
+       "            fig.send_message(\"supports_binary\", {value: fig.supports_binary});\n",
+       "            fig.send_message(\"send_image_mode\", {});\n",
+       "            if (mpl.ratio != 1) {\n",
+       "                fig.send_message(\"set_dpi_ratio\", {'dpi_ratio': mpl.ratio});\n",
+       "            }\n",
+       "            fig.send_message(\"refresh\", {});\n",
+       "        }\n",
+       "\n",
+       "    this.imageObj.onload = function() {\n",
+       "            if (fig.image_mode == 'full') {\n",
+       "                // Full images could contain transparency (where diff images\n",
+       "                // almost always do), so we need to clear the canvas so that\n",
+       "                // there is no ghosting.\n",
+       "                fig.context.clearRect(0, 0, fig.canvas.width, fig.canvas.height);\n",
+       "            }\n",
+       "            fig.context.drawImage(fig.imageObj, 0, 0);\n",
+       "        };\n",
+       "\n",
+       "    this.imageObj.onunload = function() {\n",
+       "        fig.ws.close();\n",
+       "    }\n",
+       "\n",
+       "    this.ws.onmessage = this._make_on_message_function(this);\n",
+       "\n",
+       "    this.ondownload = ondownload;\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._init_header = function() {\n",
+       "    var titlebar = $(\n",
+       "        '<div class=\"ui-dialog-titlebar ui-widget-header ui-corner-all ' +\n",
+       "        'ui-helper-clearfix\"/>');\n",
+       "    var titletext = $(\n",
+       "        '<div class=\"ui-dialog-title\" style=\"width: 100%; ' +\n",
+       "        'text-align: center; padding: 3px;\"/>');\n",
+       "    titlebar.append(titletext)\n",
+       "    this.root.append(titlebar);\n",
+       "    this.header = titletext[0];\n",
+       "}\n",
+       "\n",
+       "\n",
+       "\n",
+       "mpl.figure.prototype._canvas_extra_style = function(canvas_div) {\n",
+       "\n",
+       "}\n",
+       "\n",
+       "\n",
+       "mpl.figure.prototype._root_extra_style = function(canvas_div) {\n",
+       "\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._init_canvas = function() {\n",
+       "    var fig = this;\n",
+       "\n",
+       "    var canvas_div = $('<div/>');\n",
+       "\n",
+       "    canvas_div.attr('style', 'position: relative; clear: both; outline: 0');\n",
+       "\n",
+       "    function canvas_keyboard_event(event) {\n",
+       "        return fig.key_event(event, event['data']);\n",
+       "    }\n",
+       "\n",
+       "    canvas_div.keydown('key_press', canvas_keyboard_event);\n",
+       "    canvas_div.keyup('key_release', canvas_keyboard_event);\n",
+       "    this.canvas_div = canvas_div\n",
+       "    this._canvas_extra_style(canvas_div)\n",
+       "    this.root.append(canvas_div);\n",
+       "\n",
+       "    var canvas = $('<canvas/>');\n",
+       "    canvas.addClass('mpl-canvas');\n",
+       "    canvas.attr('style', \"left: 0; top: 0; z-index: 0; outline: 0\")\n",
+       "\n",
+       "    this.canvas = canvas[0];\n",
+       "    this.context = canvas[0].getContext(\"2d\");\n",
+       "\n",
+       "    var backingStore = this.context.backingStorePixelRatio ||\n",
+       "\tthis.context.webkitBackingStorePixelRatio ||\n",
+       "\tthis.context.mozBackingStorePixelRatio ||\n",
+       "\tthis.context.msBackingStorePixelRatio ||\n",
+       "\tthis.context.oBackingStorePixelRatio ||\n",
+       "\tthis.context.backingStorePixelRatio || 1;\n",
+       "\n",
+       "    mpl.ratio = (window.devicePixelRatio || 1) / backingStore;\n",
+       "\n",
+       "    var rubberband = $('<canvas/>');\n",
+       "    rubberband.attr('style', \"position: absolute; left: 0; top: 0; z-index: 1;\")\n",
+       "\n",
+       "    var pass_mouse_events = true;\n",
+       "\n",
+       "    canvas_div.resizable({\n",
+       "        start: function(event, ui) {\n",
+       "            pass_mouse_events = false;\n",
+       "        },\n",
+       "        resize: function(event, ui) {\n",
+       "            fig.request_resize(ui.size.width, ui.size.height);\n",
+       "        },\n",
+       "        stop: function(event, ui) {\n",
+       "            pass_mouse_events = true;\n",
+       "            fig.request_resize(ui.size.width, ui.size.height);\n",
+       "        },\n",
+       "    });\n",
+       "\n",
+       "    function mouse_event_fn(event) {\n",
+       "        if (pass_mouse_events)\n",
+       "            return fig.mouse_event(event, event['data']);\n",
+       "    }\n",
+       "\n",
+       "    rubberband.mousedown('button_press', mouse_event_fn);\n",
+       "    rubberband.mouseup('button_release', mouse_event_fn);\n",
+       "    // Throttle sequential mouse events to 1 every 20ms.\n",
+       "    rubberband.mousemove('motion_notify', mouse_event_fn);\n",
+       "\n",
+       "    rubberband.mouseenter('figure_enter', mouse_event_fn);\n",
+       "    rubberband.mouseleave('figure_leave', mouse_event_fn);\n",
+       "\n",
+       "    canvas_div.on(\"wheel\", function (event) {\n",
+       "        event = event.originalEvent;\n",
+       "        event['data'] = 'scroll'\n",
+       "        if (event.deltaY < 0) {\n",
+       "            event.step = 1;\n",
+       "        } else {\n",
+       "            event.step = -1;\n",
+       "        }\n",
+       "        mouse_event_fn(event);\n",
+       "    });\n",
+       "\n",
+       "    canvas_div.append(canvas);\n",
+       "    canvas_div.append(rubberband);\n",
+       "\n",
+       "    this.rubberband = rubberband;\n",
+       "    this.rubberband_canvas = rubberband[0];\n",
+       "    this.rubberband_context = rubberband[0].getContext(\"2d\");\n",
+       "    this.rubberband_context.strokeStyle = \"#000000\";\n",
+       "\n",
+       "    this._resize_canvas = function(width, height) {\n",
+       "        // Keep the size of the canvas, canvas container, and rubber band\n",
+       "        // canvas in synch.\n",
+       "        canvas_div.css('width', width)\n",
+       "        canvas_div.css('height', height)\n",
+       "\n",
+       "        canvas.attr('width', width * mpl.ratio);\n",
+       "        canvas.attr('height', height * mpl.ratio);\n",
+       "        canvas.attr('style', 'width: ' + width + 'px; height: ' + height + 'px;');\n",
+       "\n",
+       "        rubberband.attr('width', width);\n",
+       "        rubberband.attr('height', height);\n",
+       "    }\n",
+       "\n",
+       "    // Set the figure to an initial 600x600px, this will subsequently be updated\n",
+       "    // upon first draw.\n",
+       "    this._resize_canvas(600, 600);\n",
+       "\n",
+       "    // Disable right mouse context menu.\n",
+       "    $(this.rubberband_canvas).bind(\"contextmenu\",function(e){\n",
+       "        return false;\n",
+       "    });\n",
+       "\n",
+       "    function set_focus () {\n",
+       "        canvas.focus();\n",
+       "        canvas_div.focus();\n",
+       "    }\n",
+       "\n",
+       "    window.setTimeout(set_focus, 100);\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._init_toolbar = function() {\n",
+       "    var fig = this;\n",
+       "\n",
+       "    var nav_element = $('<div/>');\n",
+       "    nav_element.attr('style', 'width: 100%');\n",
+       "    this.root.append(nav_element);\n",
+       "\n",
+       "    // Define a callback function for later on.\n",
+       "    function toolbar_event(event) {\n",
+       "        return fig.toolbar_button_onclick(event['data']);\n",
+       "    }\n",
+       "    function toolbar_mouse_event(event) {\n",
+       "        return fig.toolbar_button_onmouseover(event['data']);\n",
+       "    }\n",
+       "\n",
+       "    for(var toolbar_ind in mpl.toolbar_items) {\n",
+       "        var name = mpl.toolbar_items[toolbar_ind][0];\n",
+       "        var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
+       "        var image = mpl.toolbar_items[toolbar_ind][2];\n",
+       "        var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
+       "\n",
+       "        if (!name) {\n",
+       "            // put a spacer in here.\n",
+       "            continue;\n",
+       "        }\n",
+       "        var button = $('<button/>');\n",
+       "        button.addClass('ui-button ui-widget ui-state-default ui-corner-all ' +\n",
+       "                        'ui-button-icon-only');\n",
+       "        button.attr('role', 'button');\n",
+       "        button.attr('aria-disabled', 'false');\n",
+       "        button.click(method_name, toolbar_event);\n",
+       "        button.mouseover(tooltip, toolbar_mouse_event);\n",
+       "\n",
+       "        var icon_img = $('<span/>');\n",
+       "        icon_img.addClass('ui-button-icon-primary ui-icon');\n",
+       "        icon_img.addClass(image);\n",
+       "        icon_img.addClass('ui-corner-all');\n",
+       "\n",
+       "        var tooltip_span = $('<span/>');\n",
+       "        tooltip_span.addClass('ui-button-text');\n",
+       "        tooltip_span.html(tooltip);\n",
+       "\n",
+       "        button.append(icon_img);\n",
+       "        button.append(tooltip_span);\n",
+       "\n",
+       "        nav_element.append(button);\n",
+       "    }\n",
+       "\n",
+       "    var fmt_picker_span = $('<span/>');\n",
+       "\n",
+       "    var fmt_picker = $('<select/>');\n",
+       "    fmt_picker.addClass('mpl-toolbar-option ui-widget ui-widget-content');\n",
+       "    fmt_picker_span.append(fmt_picker);\n",
+       "    nav_element.append(fmt_picker_span);\n",
+       "    this.format_dropdown = fmt_picker[0];\n",
+       "\n",
+       "    for (var ind in mpl.extensions) {\n",
+       "        var fmt = mpl.extensions[ind];\n",
+       "        var option = $(\n",
+       "            '<option/>', {selected: fmt === mpl.default_extension}).html(fmt);\n",
+       "        fmt_picker.append(option);\n",
+       "    }\n",
+       "\n",
+       "    // Add hover states to the ui-buttons\n",
+       "    $( \".ui-button\" ).hover(\n",
+       "        function() { $(this).addClass(\"ui-state-hover\");},\n",
+       "        function() { $(this).removeClass(\"ui-state-hover\");}\n",
+       "    );\n",
+       "\n",
+       "    var status_bar = $('<span class=\"mpl-message\"/>');\n",
+       "    nav_element.append(status_bar);\n",
+       "    this.message = status_bar[0];\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.request_resize = function(x_pixels, y_pixels) {\n",
+       "    // Request matplotlib to resize the figure. Matplotlib will then trigger a resize in the client,\n",
+       "    // which will in turn request a refresh of the image.\n",
+       "    this.send_message('resize', {'width': x_pixels, 'height': y_pixels});\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.send_message = function(type, properties) {\n",
+       "    properties['type'] = type;\n",
+       "    properties['figure_id'] = this.id;\n",
+       "    this.ws.send(JSON.stringify(properties));\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.send_draw_message = function() {\n",
+       "    if (!this.waiting) {\n",
+       "        this.waiting = true;\n",
+       "        this.ws.send(JSON.stringify({type: \"draw\", figure_id: this.id}));\n",
+       "    }\n",
+       "}\n",
+       "\n",
+       "\n",
+       "mpl.figure.prototype.handle_save = function(fig, msg) {\n",
+       "    var format_dropdown = fig.format_dropdown;\n",
+       "    var format = format_dropdown.options[format_dropdown.selectedIndex].value;\n",
+       "    fig.ondownload(fig, format);\n",
+       "}\n",
+       "\n",
+       "\n",
+       "mpl.figure.prototype.handle_resize = function(fig, msg) {\n",
+       "    var size = msg['size'];\n",
+       "    if (size[0] != fig.canvas.width || size[1] != fig.canvas.height) {\n",
+       "        fig._resize_canvas(size[0], size[1]);\n",
+       "        fig.send_message(\"refresh\", {});\n",
+       "    };\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.handle_rubberband = function(fig, msg) {\n",
+       "    var x0 = msg['x0'] / mpl.ratio;\n",
+       "    var y0 = (fig.canvas.height - msg['y0']) / mpl.ratio;\n",
+       "    var x1 = msg['x1'] / mpl.ratio;\n",
+       "    var y1 = (fig.canvas.height - msg['y1']) / mpl.ratio;\n",
+       "    x0 = Math.floor(x0) + 0.5;\n",
+       "    y0 = Math.floor(y0) + 0.5;\n",
+       "    x1 = Math.floor(x1) + 0.5;\n",
+       "    y1 = Math.floor(y1) + 0.5;\n",
+       "    var min_x = Math.min(x0, x1);\n",
+       "    var min_y = Math.min(y0, y1);\n",
+       "    var width = Math.abs(x1 - x0);\n",
+       "    var height = Math.abs(y1 - y0);\n",
+       "\n",
+       "    fig.rubberband_context.clearRect(\n",
+       "        0, 0, fig.canvas.width / mpl.ratio, fig.canvas.height / mpl.ratio);\n",
+       "\n",
+       "    fig.rubberband_context.strokeRect(min_x, min_y, width, height);\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.handle_figure_label = function(fig, msg) {\n",
+       "    // Updates the figure title.\n",
+       "    fig.header.textContent = msg['label'];\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.handle_cursor = function(fig, msg) {\n",
+       "    var cursor = msg['cursor'];\n",
+       "    switch(cursor)\n",
+       "    {\n",
+       "    case 0:\n",
+       "        cursor = 'pointer';\n",
+       "        break;\n",
+       "    case 1:\n",
+       "        cursor = 'default';\n",
+       "        break;\n",
+       "    case 2:\n",
+       "        cursor = 'crosshair';\n",
+       "        break;\n",
+       "    case 3:\n",
+       "        cursor = 'move';\n",
+       "        break;\n",
+       "    }\n",
+       "    fig.rubberband_canvas.style.cursor = cursor;\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.handle_message = function(fig, msg) {\n",
+       "    fig.message.textContent = msg['message'];\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.handle_draw = function(fig, msg) {\n",
+       "    // Request the server to send over a new figure.\n",
+       "    fig.send_draw_message();\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.handle_image_mode = function(fig, msg) {\n",
+       "    fig.image_mode = msg['mode'];\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.updated_canvas_event = function() {\n",
+       "    // Called whenever the canvas gets updated.\n",
+       "    this.send_message(\"ack\", {});\n",
+       "}\n",
+       "\n",
+       "// A function to construct a web socket function for onmessage handling.\n",
+       "// Called in the figure constructor.\n",
+       "mpl.figure.prototype._make_on_message_function = function(fig) {\n",
+       "    return function socket_on_message(evt) {\n",
+       "        if (evt.data instanceof Blob) {\n",
+       "            /* FIXME: We get \"Resource interpreted as Image but\n",
+       "             * transferred with MIME type text/plain:\" errors on\n",
+       "             * Chrome.  But how to set the MIME type?  It doesn't seem\n",
+       "             * to be part of the websocket stream */\n",
+       "            evt.data.type = \"image/png\";\n",
+       "\n",
+       "            /* Free the memory for the previous frames */\n",
+       "            if (fig.imageObj.src) {\n",
+       "                (window.URL || window.webkitURL).revokeObjectURL(\n",
+       "                    fig.imageObj.src);\n",
+       "            }\n",
+       "\n",
+       "            fig.imageObj.src = (window.URL || window.webkitURL).createObjectURL(\n",
+       "                evt.data);\n",
+       "            fig.updated_canvas_event();\n",
+       "            fig.waiting = false;\n",
+       "            return;\n",
+       "        }\n",
+       "        else if (typeof evt.data === 'string' && evt.data.slice(0, 21) == \"data:image/png;base64\") {\n",
+       "            fig.imageObj.src = evt.data;\n",
+       "            fig.updated_canvas_event();\n",
+       "            fig.waiting = false;\n",
+       "            return;\n",
+       "        }\n",
+       "\n",
+       "        var msg = JSON.parse(evt.data);\n",
+       "        var msg_type = msg['type'];\n",
+       "\n",
+       "        // Call the  \"handle_{type}\" callback, which takes\n",
+       "        // the figure and JSON message as its only arguments.\n",
+       "        try {\n",
+       "            var callback = fig[\"handle_\" + msg_type];\n",
+       "        } catch (e) {\n",
+       "            console.log(\"No handler for the '\" + msg_type + \"' message type: \", msg);\n",
+       "            return;\n",
+       "        }\n",
+       "\n",
+       "        if (callback) {\n",
+       "            try {\n",
+       "                // console.log(\"Handling '\" + msg_type + \"' message: \", msg);\n",
+       "                callback(fig, msg);\n",
+       "            } catch (e) {\n",
+       "                console.log(\"Exception inside the 'handler_\" + msg_type + \"' callback:\", e, e.stack, msg);\n",
+       "            }\n",
+       "        }\n",
+       "    };\n",
+       "}\n",
+       "\n",
+       "// from http://stackoverflow.com/questions/1114465/getting-mouse-location-in-canvas\n",
+       "mpl.findpos = function(e) {\n",
+       "    //this section is from http://www.quirksmode.org/js/events_properties.html\n",
+       "    var targ;\n",
+       "    if (!e)\n",
+       "        e = window.event;\n",
+       "    if (e.target)\n",
+       "        targ = e.target;\n",
+       "    else if (e.srcElement)\n",
+       "        targ = e.srcElement;\n",
+       "    if (targ.nodeType == 3) // defeat Safari bug\n",
+       "        targ = targ.parentNode;\n",
+       "\n",
+       "    // jQuery normalizes the pageX and pageY\n",
+       "    // pageX,Y are the mouse positions relative to the document\n",
+       "    // offset() returns the position of the element relative to the document\n",
+       "    var x = e.pageX - $(targ).offset().left;\n",
+       "    var y = e.pageY - $(targ).offset().top;\n",
+       "\n",
+       "    return {\"x\": x, \"y\": y};\n",
+       "};\n",
+       "\n",
+       "/*\n",
+       " * return a copy of an object with only non-object keys\n",
+       " * we need this to avoid circular references\n",
+       " * http://stackoverflow.com/a/24161582/3208463\n",
+       " */\n",
+       "function simpleKeys (original) {\n",
+       "  return Object.keys(original).reduce(function (obj, key) {\n",
+       "    if (typeof original[key] !== 'object')\n",
+       "        obj[key] = original[key]\n",
+       "    return obj;\n",
+       "  }, {});\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.mouse_event = function(event, name) {\n",
+       "    var canvas_pos = mpl.findpos(event)\n",
+       "\n",
+       "    if (name === 'button_press')\n",
+       "    {\n",
+       "        this.canvas.focus();\n",
+       "        this.canvas_div.focus();\n",
+       "    }\n",
+       "\n",
+       "    var x = canvas_pos.x * mpl.ratio;\n",
+       "    var y = canvas_pos.y * mpl.ratio;\n",
+       "\n",
+       "    this.send_message(name, {x: x, y: y, button: event.button,\n",
+       "                             step: event.step,\n",
+       "                             guiEvent: simpleKeys(event)});\n",
+       "\n",
+       "    /* This prevents the web browser from automatically changing to\n",
+       "     * the text insertion cursor when the button is pressed.  We want\n",
+       "     * to control all of the cursor setting manually through the\n",
+       "     * 'cursor' event from matplotlib */\n",
+       "    event.preventDefault();\n",
+       "    return false;\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._key_event_extra = function(event, name) {\n",
+       "    // Handle any extra behaviour associated with a key event\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.key_event = function(event, name) {\n",
+       "\n",
+       "    // Prevent repeat events\n",
+       "    if (name == 'key_press')\n",
+       "    {\n",
+       "        if (event.which === this._key)\n",
+       "            return;\n",
+       "        else\n",
+       "            this._key = event.which;\n",
+       "    }\n",
+       "    if (name == 'key_release')\n",
+       "        this._key = null;\n",
+       "\n",
+       "    var value = '';\n",
+       "    if (event.ctrlKey && event.which != 17)\n",
+       "        value += \"ctrl+\";\n",
+       "    if (event.altKey && event.which != 18)\n",
+       "        value += \"alt+\";\n",
+       "    if (event.shiftKey && event.which != 16)\n",
+       "        value += \"shift+\";\n",
+       "\n",
+       "    value += 'k';\n",
+       "    value += event.which.toString();\n",
+       "\n",
+       "    this._key_event_extra(event, name);\n",
+       "\n",
+       "    this.send_message(name, {key: value,\n",
+       "                             guiEvent: simpleKeys(event)});\n",
+       "    return false;\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.toolbar_button_onclick = function(name) {\n",
+       "    if (name == 'download') {\n",
+       "        this.handle_save(this, null);\n",
+       "    } else {\n",
+       "        this.send_message(\"toolbar_button\", {name: name});\n",
+       "    }\n",
+       "};\n",
+       "\n",
+       "mpl.figure.prototype.toolbar_button_onmouseover = function(tooltip) {\n",
+       "    this.message.textContent = tooltip;\n",
+       "};\n",
+       "mpl.toolbar_items = [[\"Home\", \"Reset original view\", \"fa fa-home icon-home\", \"home\"], [\"Back\", \"Back to previous view\", \"fa fa-arrow-left icon-arrow-left\", \"back\"], [\"Forward\", \"Forward to next view\", \"fa fa-arrow-right icon-arrow-right\", \"forward\"], [\"\", \"\", \"\", \"\"], [\"Pan\", \"Pan axes with left mouse, zoom with right\", \"fa fa-arrows icon-move\", \"pan\"], [\"Zoom\", \"Zoom to rectangle\", \"fa fa-square-o icon-check-empty\", \"zoom\"], [\"\", \"\", \"\", \"\"], [\"Download\", \"Download plot\", \"fa fa-floppy-o icon-save\", \"download\"]];\n",
+       "\n",
+       "mpl.extensions = [\"eps\", \"pdf\", \"png\", \"ps\", \"raw\", \"svg\"];\n",
+       "\n",
+       "mpl.default_extension = \"png\";var comm_websocket_adapter = function(comm) {\n",
+       "    // Create a \"websocket\"-like object which calls the given IPython comm\n",
+       "    // object with the appropriate methods. Currently this is a non binary\n",
+       "    // socket, so there is still some room for performance tuning.\n",
+       "    var ws = {};\n",
+       "\n",
+       "    ws.close = function() {\n",
+       "        comm.close()\n",
+       "    };\n",
+       "    ws.send = function(m) {\n",
+       "        //console.log('sending', m);\n",
+       "        comm.send(m);\n",
+       "    };\n",
+       "    // Register the callback with on_msg.\n",
+       "    comm.on_msg(function(msg) {\n",
+       "        //console.log('receiving', msg['content']['data'], msg);\n",
+       "        // Pass the mpl event to the overridden (by mpl) onmessage function.\n",
+       "        ws.onmessage(msg['content']['data'])\n",
+       "    });\n",
+       "    return ws;\n",
+       "}\n",
+       "\n",
+       "mpl.mpl_figure_comm = function(comm, msg) {\n",
+       "    // This is the function which gets called when the mpl process\n",
+       "    // starts-up an IPython Comm through the \"matplotlib\" channel.\n",
+       "\n",
+       "    var id = msg.content.data.id;\n",
+       "    // Get hold of the div created by the display call when the Comm\n",
+       "    // socket was opened in Python.\n",
+       "    var element = $(\"#\" + id);\n",
+       "    var ws_proxy = comm_websocket_adapter(comm)\n",
+       "\n",
+       "    function ondownload(figure, format) {\n",
+       "        window.open(figure.imageObj.src);\n",
+       "    }\n",
+       "\n",
+       "    var fig = new mpl.figure(id, ws_proxy,\n",
+       "                           ondownload,\n",
+       "                           element.get(0));\n",
+       "\n",
+       "    // Call onopen now - mpl needs it, as it is assuming we've passed it a real\n",
+       "    // web socket which is closed, not our websocket->open comm proxy.\n",
+       "    ws_proxy.onopen();\n",
+       "\n",
+       "    fig.parent_element = element.get(0);\n",
+       "    fig.cell_info = mpl.find_output_cell(\"<div id='\" + id + \"'></div>\");\n",
+       "    if (!fig.cell_info) {\n",
+       "        console.error(\"Failed to find cell for figure\", id, fig);\n",
+       "        return;\n",
+       "    }\n",
+       "\n",
+       "    var output_index = fig.cell_info[2]\n",
+       "    var cell = fig.cell_info[0];\n",
+       "\n",
+       "};\n",
+       "\n",
+       "mpl.figure.prototype.handle_close = function(fig, msg) {\n",
+       "    var width = fig.canvas.width/mpl.ratio\n",
+       "    fig.root.unbind('remove')\n",
+       "\n",
+       "    // Update the output cell to use the data from the current canvas.\n",
+       "    fig.push_to_output();\n",
+       "    var dataURL = fig.canvas.toDataURL();\n",
+       "    // Re-enable the keyboard manager in IPython - without this line, in FF,\n",
+       "    // the notebook keyboard shortcuts fail.\n",
+       "    IPython.keyboard_manager.enable()\n",
+       "    $(fig.parent_element).html('<img src=\"' + dataURL + '\" width=\"' + width + '\">');\n",
+       "    fig.close_ws(fig, msg);\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.close_ws = function(fig, msg){\n",
+       "    fig.send_message('closing', msg);\n",
+       "    // fig.ws.close()\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.push_to_output = function(remove_interactive) {\n",
+       "    // Turn the data on the canvas into data in the output cell.\n",
+       "    var width = this.canvas.width/mpl.ratio\n",
+       "    var dataURL = this.canvas.toDataURL();\n",
+       "    this.cell_info[1]['text/html'] = '<img src=\"' + dataURL + '\" width=\"' + width + '\">';\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.updated_canvas_event = function() {\n",
+       "    // Tell IPython that the notebook contents must change.\n",
+       "    IPython.notebook.set_dirty(true);\n",
+       "    this.send_message(\"ack\", {});\n",
+       "    var fig = this;\n",
+       "    // Wait a second, then push the new image to the DOM so\n",
+       "    // that it is saved nicely (might be nice to debounce this).\n",
+       "    setTimeout(function () { fig.push_to_output() }, 1000);\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._init_toolbar = function() {\n",
+       "    var fig = this;\n",
+       "\n",
+       "    var nav_element = $('<div/>');\n",
+       "    nav_element.attr('style', 'width: 100%');\n",
+       "    this.root.append(nav_element);\n",
+       "\n",
+       "    // Define a callback function for later on.\n",
+       "    function toolbar_event(event) {\n",
+       "        return fig.toolbar_button_onclick(event['data']);\n",
+       "    }\n",
+       "    function toolbar_mouse_event(event) {\n",
+       "        return fig.toolbar_button_onmouseover(event['data']);\n",
+       "    }\n",
+       "\n",
+       "    for(var toolbar_ind in mpl.toolbar_items){\n",
+       "        var name = mpl.toolbar_items[toolbar_ind][0];\n",
+       "        var tooltip = mpl.toolbar_items[toolbar_ind][1];\n",
+       "        var image = mpl.toolbar_items[toolbar_ind][2];\n",
+       "        var method_name = mpl.toolbar_items[toolbar_ind][3];\n",
+       "\n",
+       "        if (!name) { continue; };\n",
+       "\n",
+       "        var button = $('<button class=\"btn btn-default\" href=\"#\" title=\"' + name + '\"><i class=\"fa ' + image + ' fa-lg\"></i></button>');\n",
+       "        button.click(method_name, toolbar_event);\n",
+       "        button.mouseover(tooltip, toolbar_mouse_event);\n",
+       "        nav_element.append(button);\n",
+       "    }\n",
+       "\n",
+       "    // Add the status bar.\n",
+       "    var status_bar = $('<span class=\"mpl-message\" style=\"text-align:right; float: right;\"/>');\n",
+       "    nav_element.append(status_bar);\n",
+       "    this.message = status_bar[0];\n",
+       "\n",
+       "    // Add the close button to the window.\n",
+       "    var buttongrp = $('<div class=\"btn-group inline pull-right\"></div>');\n",
+       "    var button = $('<button class=\"btn btn-mini btn-primary\" href=\"#\" title=\"Stop Interaction\"><i class=\"fa fa-power-off icon-remove icon-large\"></i></button>');\n",
+       "    button.click(function (evt) { fig.handle_close(fig, {}); } );\n",
+       "    button.mouseover('Stop Interaction', toolbar_mouse_event);\n",
+       "    buttongrp.append(button);\n",
+       "    var titlebar = this.root.find($('.ui-dialog-titlebar'));\n",
+       "    titlebar.prepend(buttongrp);\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._root_extra_style = function(el){\n",
+       "    var fig = this\n",
+       "    el.on(\"remove\", function(){\n",
+       "\tfig.close_ws(fig, {});\n",
+       "    });\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._canvas_extra_style = function(el){\n",
+       "    // this is important to make the div 'focusable\n",
+       "    el.attr('tabindex', 0)\n",
+       "    // reach out to IPython and tell the keyboard manager to turn it's self\n",
+       "    // off when our div gets focus\n",
+       "\n",
+       "    // location in version 3\n",
+       "    if (IPython.notebook.keyboard_manager) {\n",
+       "        IPython.notebook.keyboard_manager.register_events(el);\n",
+       "    }\n",
+       "    else {\n",
+       "        // location in version 2\n",
+       "        IPython.keyboard_manager.register_events(el);\n",
+       "    }\n",
+       "\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype._key_event_extra = function(event, name) {\n",
+       "    var manager = IPython.notebook.keyboard_manager;\n",
+       "    if (!manager)\n",
+       "        manager = IPython.keyboard_manager;\n",
+       "\n",
+       "    // Check for shift+enter\n",
+       "    if (event.shiftKey && event.which == 13) {\n",
+       "        this.canvas_div.blur();\n",
+       "        event.shiftKey = false;\n",
+       "        // Send a \"J\" for go to next cell\n",
+       "        event.which = 74;\n",
+       "        event.keyCode = 74;\n",
+       "        manager.command_mode();\n",
+       "        manager.handle_keydown(event);\n",
+       "    }\n",
+       "}\n",
+       "\n",
+       "mpl.figure.prototype.handle_save = function(fig, msg) {\n",
+       "    fig.ondownload(fig, null);\n",
+       "}\n",
+       "\n",
+       "\n",
+       "mpl.find_output_cell = function(html_output) {\n",
+       "    // Return the cell and output element which can be found *uniquely* in the notebook.\n",
+       "    // Note - this is a bit hacky, but it is done because the \"notebook_saving.Notebook\"\n",
+       "    // IPython event is triggered only after the cells have been serialised, which for\n",
+       "    // our purposes (turning an active figure into a static one), is too late.\n",
+       "    var cells = IPython.notebook.get_cells();\n",
+       "    var ncells = cells.length;\n",
+       "    for (var i=0; i<ncells; i++) {\n",
+       "        var cell = cells[i];\n",
+       "        if (cell.cell_type === 'code'){\n",
+       "            for (var j=0; j<cell.output_area.outputs.length; j++) {\n",
+       "                var data = cell.output_area.outputs[j];\n",
+       "                if (data.data) {\n",
+       "                    // IPython >= 3 moved mimebundle to data attribute of output\n",
+       "                    data = data.data;\n",
+       "                }\n",
+       "                if (data['text/html'] == html_output) {\n",
+       "                    return [cell, data, j];\n",
+       "                }\n",
+       "            }\n",
+       "        }\n",
+       "    }\n",
+       "}\n",
+       "\n",
+       "// Register the function which deals with the matplotlib target/channel.\n",
+       "// The kernel may be null if the page has been refreshed.\n",
+       "if (IPython.notebook.kernel != null) {\n",
+       "    IPython.notebook.kernel.comm_manager.register_target('matplotlib', mpl.mpl_figure_comm);\n",
+       "}\n"
+      ],
+      "text/plain": [
+       "<IPython.core.display.Javascript object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/html": [
+       "<img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAoAAAAHgCAYAAAA10dzkAAAgAElEQVR4nOzdeXhU9b0/8PRHBX24bZ+n97m97e1tD6KyKGoblS4qVNtq1Vbb27pVKbVqC9iyWNsTEIisyo4IAgKCLLIoiHCyQ0JCFgKBBEIWQkJ2AiQhO1nnvH9/nDmHBJLJzJzvOcNk3q/nmT8aZs58jd963nzP9/v5BIGIiIiIAkqQrwdARERERPZiACQiIiIKMAyARERERAGGAZCIiIgowDAAEhEREQUYBkAiIiKiAMMASERERBRgGACJiIiIAgwDIBEREVGAYQAkIiIiCjAMgEREREQBhgGQiIiIKMAwABIREREFGAZAIiIiogDDAEhEREQUYBgAiYiIiAIMAyARERFRgGEAJCIiIgowDIBEREREAYYBkIiIiCjAMAASERERBRgGQCIiIqIAwwBIREREFGAYAImIiIgCDAMgERERUYBhACQiIiIKMAyARERERAGGAZCIiIgowDAAEhEREQUYBkAiIiKiAMMASERERBRgGACJiIiIAgwDIBEREVGAYQAkIiIiCjAMgEREREQBhgGQiIiIKMAwABIREREFGAZAIiIiogDDAEhEREQUYBgAiYiIiAIMAyARERFRgGEAJCIiIgowDIBEREREAYYBkIiIiCjAMAASERERBRgGQCIiIqIAwwBIREREFGAYAImIiIgCDAMgERERUYBhACQiIiIKMAyARERERAGGAZCIiIgowDAAEhEREQUYBkAiIiKiAMMASERERBRgGACJiIiIAgwDoAkOhwOlpaWora1FXV0dX3zxxRdffPHlB6/a2lqUlpbC4XD4Okr4DAOgCaWlpQgKCuKLL7744osvvvzwVVpa6uso4TMMgCbU1tYaE8jXf5vhiy+++OKLL77ce+kLOLW1tb6OEj7DAGhCXV0dgoKCUFdX5+uhEBERkZt4/2YANIUTiIiIyP/w/s0AaAonEBERkf/h/ZsB0BROICIiIv/D+zcDoCmcQERERP6H928GQFM4gYiIiPwP798MgKZwAhEREfkf3r8ZAE3hBCIiIvI/vH8zAJrCCUREROR/eP9mADSFE4iIiMj/8P7NAGgKJxAREZH/4f2bAdAUTiAiIiL/w/s3A6ApnEBERET+h/dvBkBTboQJFJ11AbP2ZaGyocVnYyAiIvInN8L929cYAE3w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\" width=\"640\">"
+      ],
+      "text/plain": [
+       "<IPython.core.display.HTML object>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "data": {
+      "text/plain": [
+       "[<matplotlib.lines.Line2D at 0xa471608>]"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "t = np.arange(0, 1000)\n",
+    "\n",
+    "wf = np.exp(-t / 200) * np.sin(0.02 * np.pi * t) * 0.5 + 0.5\n",
+    "\n",
+    "plt.figure().gca().plot(wf)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Upload the waveform to the memory slot `USER1`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "afg.upload_waveform(wf, memory=1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Configure the AFG to output the waveform stored in `USER1` on channel 1."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "afg.state_output1(1) # enable output on ch1\n",
+    "afg.function_shape1(\"USER1\")\n",
+    "afg.burst_state1(1)  # set the run mode to burst, so we get a pulse on each trigger\n",
+    "afg.trigger_source(\"TIM\") # use internal trigger so we get output continuously"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Adjust the timing of the waveform. The `freq_cw1` parameter sets the inverse of the waveform length, while `trigger_timer` sets the repetition rate of the internal trigger."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# set the waveform length to 100 us\n",
+    "afg.freq_cw1(1/100e-6)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# repeat the waveform every 1 ms\n",
+    "afg.trigger_timer(1e-3)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Adjust the range of voltage values."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# the waveform is scaled to +-0.5V (assuming that afg.voltage_limit_low1/high1 are large enough)\n",
+    "afg.voltage_low1(-0.5)\n",
+    "afg.voltage_high1(0.5)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# the waveform is scaled to 0..1V\n",
+    "afg.voltage_low1(0)\n",
+    "afg.voltage_high1(1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Stop output and disconnect."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "afg.state_output1(0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "afg.close()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.7.4"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

From df51ebcc1d3b49ca9319b57dcca59cf70610d6a7 Mon Sep 17 00:00:00 2001
From: Marton Gunyho <andras.gunyho@aalto.fi>
Date: Tue, 24 May 2022 12:46:54 +0300
Subject: [PATCH 08/14] Tweak wording

---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index 9e531099f..ffe5bc257 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -633,7 +633,7 @@ def reset_edit_memory(self, points: int = 1000):
         `points`.
 
         Each point will be initialized with the value 8191, which corresponds
-        to zero amplitude.
+        to the voltage half-way between `voltage_low` and `voltage_high`.
         """
         if (points < MIN_WAVEFORM_LENGTH or
             points > MAX_WAVEFORM_LENGTH):

From 8a66fc20fa3e3718f6094bc1662094ec60108bc2 Mon Sep 17 00:00:00 2001
From: Aalto QCD labs <->
Date: Tue, 24 May 2022 13:53:09 +0300
Subject: [PATCH 09/14] Disable notebook execution

---
 docs/examples/Tektronix_AFG3000_series.ipynb | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/examples/Tektronix_AFG3000_series.ipynb b/docs/examples/Tektronix_AFG3000_series.ipynb
index c848f714a..0ff3fd148 100644
--- a/docs/examples/Tektronix_AFG3000_series.ipynb
+++ b/docs/examples/Tektronix_AFG3000_series.ipynb
@@ -1170,6 +1170,9 @@
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
    "version": "3.7.4"
+  },
+  "nbsphinx": {
+   "execute": "never"
   }
  },
  "nbformat": 4,

From e3503eb94fdba3bc188946240caba5ff07f83214 Mon Sep 17 00:00:00 2001
From: Marton Gunyho <andras.gunyho@aalto.fi>
Date: Tue, 24 May 2022 15:25:35 +0300
Subject: [PATCH 10/14] Add bounds checking to waveform data before upload

---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index ffe5bc257..402749ffd 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -663,10 +663,18 @@ def upload_waveform(self, waveform: List[float], memory: int):
         if memory not in [1, 2, 3, 4]:
             raise ValueErorr(f"Invalid value for memory: '{memory}'")
 
+        # raise ValueError if array contains inf or nan
+        waveform = np.asarray_chkfinite(waveform)
+
+        if np.any(waveform > 1.0):
+            raise ValueError("Waveform contains data above 1.0")
+        if np.any(waveform < 0.0):
+            raise ValueError("Waveform contains data below 0.0")
+
         self.reset_edit_memory(len(waveform))
 
         # convert waveform to two-byte integer values in the range 0..16382 (= 2**14-2)
-        wf_codes = (np.array(waveform) * (2**14-2)).astype(np.uint16)
+        wf_codes = (waveform * (2**14-2)).astype(np.uint16)
 
         # write data to the editable memory
         self.visa_handle.write_binary_values(

From 06b5eab77684f60e5958e50b89838c70974467a8 Mon Sep 17 00:00:00 2001
From: Marton Gunyho <andras.gunyho@aalto.fi>
Date: Tue, 24 May 2022 16:27:09 +0300
Subject: [PATCH 11/14] Don't reuse variable

This should make mypy happy.
---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index 402749ffd..b25ce9eeb 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -663,18 +663,18 @@ def upload_waveform(self, waveform: List[float], memory: int):
         if memory not in [1, 2, 3, 4]:
             raise ValueErorr(f"Invalid value for memory: '{memory}'")
 
-        # raise ValueError if array contains inf or nan
-        waveform = np.asarray_chkfinite(waveform)
+        # convert to numpy array and raise ValueError if data contains inf or nan
+        wf_array = np.asarray_chkfinite(waveform)
 
-        if np.any(waveform > 1.0):
+        if np.any(wf_array > 1.0):
             raise ValueError("Waveform contains data above 1.0")
-        if np.any(waveform < 0.0):
+        if np.any(wf_array < 0.0):
             raise ValueError("Waveform contains data below 0.0")
 
         self.reset_edit_memory(len(waveform))
 
         # convert waveform to two-byte integer values in the range 0..16382 (= 2**14-2)
-        wf_codes = (waveform * (2**14-2)).astype(np.uint16)
+        wf_codes = (wf_array * (2**14-2)).astype(np.uint16)
 
         # write data to the editable memory
         self.visa_handle.write_binary_values(

From 0b8d21de21a23f6dd0841662f79cb242c4ce1b07 Mon Sep 17 00:00:00 2001
From: Marton Gunyho <andras.gunyho@aalto.fi>
Date: Tue, 24 May 2022 16:29:49 +0300
Subject: [PATCH 12/14] Change type hint to Sequence

---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index b25ce9eeb..f396abefc 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -1,4 +1,4 @@
-from typing import Any, Tuple, List
+from typing import Any, Tuple, Sequence
 
 import numpy as np
 from qcodes import VisaInstrument
@@ -641,7 +641,7 @@ def reset_edit_memory(self, points: int = 1000):
 
         self.write(f"DATA:DEFINE EMEM,{points}")
 
-    def upload_waveform(self, waveform: List[float], memory: int):
+    def upload_waveform(self, waveform: Sequence[float], memory: int):
         """
         Upload a waveform to the editable memory (EMEM), and then copy it to the
         USER1, USER2, USER3 or USER4 memory.
@@ -652,7 +652,7 @@ def upload_waveform(self, waveform: List[float], memory: int):
         mapped to `voltage_low` and 1 to `voltage_high`.
 
         Args:
-            waveform: list of points containing the waveform data,
+            waveform: sequence of points containing the waveform data,
                 containing values from 0 to 1.
             memory: The USER# memory where to to store the waveform, from 1 to 4.
         """

From 90dfea4b11ec33e5d3b710ec819b2d8215c46e91 Mon Sep 17 00:00:00 2001
From: Marton Gunyho <andras.gunyho@aalto.fi>
Date: Tue, 24 May 2022 16:37:25 +0300
Subject: [PATCH 13/14] Fix typos

---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index f396abefc..bbaaeca24 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -637,7 +637,7 @@ def reset_edit_memory(self, points: int = 1000):
         """
         if (points < MIN_WAVEFORM_LENGTH or
             points > MAX_WAVEFORM_LENGTH):
-            raise ValueErorr(f"Trying to reset edit memory with invalid length: {points}")
+            raise ValueError(f"Trying to reset edit memory with invalid length: {points}")
 
         self.write(f"DATA:DEFINE EMEM,{points}")
 
@@ -658,10 +658,10 @@ def upload_waveform(self, waveform: Sequence[float], memory: int):
         """
         if (len(waveform) < MIN_WAVEFORM_LENGTH or
             len(waveform) > MAX_WAVEFORM_LENGTH):
-            raise ValueErorr(f"Invalid waveform length: {len(waveform)}")
+            raise ValueError(f"Invalid waveform length: {len(waveform)}")
 
         if memory not in [1, 2, 3, 4]:
-            raise ValueErorr(f"Invalid value for memory: '{memory}'")
+            raise ValueError(f"Invalid value for memory: '{memory}'")
 
         # convert to numpy array and raise ValueError if data contains inf or nan
         wf_array = np.asarray_chkfinite(waveform)

From 5a327c92ad80fb7a4aa5ff9af0fd758687bdc33f Mon Sep 17 00:00:00 2001
From: Marton Gunyho <andras.gunyho@aalto.fi>
Date: Tue, 24 May 2022 16:49:41 +0300
Subject: [PATCH 14/14] Add cast to fix typing

---
 qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
index bbaaeca24..173d2c1b2 100644
--- a/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
+++ b/qcodes_contrib_drivers/drivers/Tektronix/AFG3000.py
@@ -1,4 +1,4 @@
-from typing import Any, Tuple, Sequence
+from typing import Any, Tuple, Sequence, cast
 
 import numpy as np
 from qcodes import VisaInstrument
@@ -679,7 +679,7 @@ def upload_waveform(self, waveform: Sequence[float], memory: int):
         # write data to the editable memory
         self.visa_handle.write_binary_values(
             f"DATA:DATA EMEM,",
-            wf_codes,
+            cast(Sequence[float], wf_codes), # cast to make types correct
             datatype="H", # unsigned short (16 bits)
             is_big_endian=True, # the AFG expects data in big endian order
             header_fmt="ieee",