{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "55959b7c",
   "metadata": {},
   "source": [
    "(sec-tutorial-ops-qubits)=\n",
    "\n",
    "# Tutorial: Operations and Qubits\n",
    "\n",
    "```{seealso}\n",
    "The complete source code of this tutorial can be found in\n",
    "\n",
    "{nb-download}`Operations and Qubits.ipynb`\n",
    "```\n",
    "\n",
    "## Gates, measurements and qubits\n",
    "\n",
    "In the previous tutorials, experiments were created on the {ref}`quantum-device level<sec-user-guide-quantum-device>`. On this level,\n",
    "operations are defined in terms of explicit signals and locations on the chip, rather than the qubit and the intended operation.\n",
    "To work at a greater level of abstraction, `quantify-scheduler` allows creating operations on the\n",
    "{ref}`quantum-circuit level<sec-user-guide-quantum-circuit>`.\n",
    "Instead of signals, clocks, and ports, operations are defined by the effect they have on specific qubits. This representation of the schedules can be compiled to the quantum-device level to create the pulse schemes.\n",
    "\n",
    "In this tutorial we show how to define operations on the {ref}`quantum-circuit level<sec-user-guide-quantum-circuit>`, combine them into schedules, and show their circuit-level visualization.\n",
    "We go through the configuration file needed to compile the schedule to the quantum-device level and show how these configuration files can be created automatically and dynamically.\n",
    "Finally, we showcase the hybrid nature of `quantify-scheduler`, allowing the scheduling of circuit-level and device-level operations side by side in the same schedule.\n",
    "\n",
    "Many of the gates used in the circuit layer description are defined in\n",
    "{class}`~quantify_scheduler.operations.gate_library` such as {class}`~quantify_scheduler.operations.gate_library.Reset`, {class}`~quantify_scheduler.operations.gate_library.X90` and\n",
    "{class}`~quantify_scheduler.operations.gate_library.Measure`.\n",
    "Operations are instantiated by providing them with the name of the qubit(s) on which\n",
    "they operate:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "2cf1c0bf",
   "metadata": {},
   "outputs": [],
   "source": [
    "from quantify_scheduler.operations import CZ, Measure, Reset, X90\n",
    "\n",
    "q0, q1 = (\"q0\", \"q1\")\n",
    "X90(q0)\n",
    "Measure(q1)\n",
    "CZ(q0, q1)\n",
    "Reset(q0);\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "db0690aa",
   "metadata": {},
   "source": [
    "Let's investigate the different components present in the circuit-level description of\n",
    "the operation. As an example, we create a 45 degree rotation operation over the\n",
    "x-axis."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "a53dc79c",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'acquisition_info': [],\n",
      " 'gate_info': {'device_overrides': {},\n",
      "               'operation_type': 'Rxy',\n",
      "               'phi': 0.0,\n",
      "               'plot_func': 'quantify_scheduler.schedules._visualization.circuit_diagram.gate_box',\n",
      "               'qubits': ['q0'],\n",
      "               'tex': '$R_{xy}^{45, 0}$',\n",
      "               'theta': 45.0,\n",
      "               'unitary': array([[0.92387953+0.j        , 0.        -0.38268343j],\n",
      "       [0.        -0.38268343j, 0.92387953+0.j        ]])},\n",
      " 'logic_info': {},\n",
      " 'name': \"Rxy(45, 0, 'q0')\",\n",
      " 'pulse_info': []}\n"
     ]
    }
   ],
   "source": [
    "from pprint import pprint\n",
    "from quantify_scheduler.operations import Rxy\n",
    "\n",
    "rxy45 = Rxy(theta=45.0, phi=0.0, qubit=q0)\n",
    "pprint(rxy45.data)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "90b5d8e6",
   "metadata": {},
   "source": [
    "As we can see, the structure of a circuit-level operation is similar to a pulse-level\n",
    "operation. However, the information is contained inside the {code}`gate_info` entry rather\n",
    "than the {code}`pulse_info` entry of the data dictionary.\n",
    "Importantly, there is no device-specific information coupled to the operation such that\n",
    "it represents the abstract notion of this qubit rotation, rather than how to perform it\n",
    "on any physical qubit implementation.\n",
    "\n",
    "The entries present above are documented in the `operation` schema.\n",
    "Generally, these schemas are only important when defining custom operations, which is\n",
    "not part of this tutorial. This schema can be inspected via:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "ccecc24a",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'operation_type': {'description': 'Defines what class of operations this gate '\n",
      "                                   'refers to (e.g. Rxy, CZ etc.).',\n",
      "                    'type': 'string'},\n",
      " 'plot_func': {'description': 'reference to a function for plotting this '\n",
      "                              'operation. If not specified, defaults to using '\n",
      "                              ':func:`~quantify_scheduler.schedules._visualization.circuit_diagram.gate_box`.',\n",
      "               'type': ['string', 'null']},\n",
      " 'qubits': {'description': 'A list of strings indicating the qubits the gate '\n",
      "                           'acts on. Valid qubits are strings that appear in '\n",
      "                           'the device_config.json file.',\n",
      "            'type': 'array'},\n",
      " 'symmetric': {'description': 'A boolean to indicate whether a two qubit gate '\n",
      "                              'is symmetric. This is used in the device config '\n",
      "                              'compilation stage. By default, it is set as '\n",
      "                              'False',\n",
      "               'type': 'boolean'},\n",
      " 'tex': {'description': 'latex snippet for plotting', 'type': 'string'},\n",
      " 'unitary': {'description': 'A unitary matrix describing the operation.'}}\n"
     ]
    }
   ],
   "source": [
    "import importlib.resources\n",
    "import json\n",
    "from quantify_scheduler import schemas\n",
    "\n",
    "operation_schema = json.loads(importlib.resources.read_text(schemas, \"operation.json\"))\n",
    "pprint(operation_schema[\"properties\"][\"gate_info\"][\"properties\"])\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8ff0e9c5",
   "metadata": {},
   "source": [
    "## Schedule creation from the circuit layer (Bell)\n",
    "\n",
    "The circuit-level operations can be used to create a {class}`~quantify_scheduler.schedules.schedule.Schedule` within\n",
    "`quantify-scheduler` using the same method as for the pulse-level operations.\n",
    "This enables creating schedules on a more abstract level.\n",
    "Here, we demonstrate this extra layer of abstraction by creating a {class}`~quantify_scheduler.schedules.schedule.Schedule` for measuring\n",
    "Bell violations.\n",
    "\n",
    "```{note}\n",
    "Within a single {class}`~quantify_scheduler.schedules.schedule.Schedule`, high-level circuit layer operations can be mixed with quantum-device level operations. This mixed representation is useful for experiments where some pulses cannot easily be represented as qubit gates. An example of this is given by the `Chevron` experiment given in {ref}`Mixing pulse and circuit layer operations (Chevron)`.\n",
    "```\n",
    "\n",
    "As the first example, we want to create a schedule for performing the\n",
    "[Bell experiment](https://en.wikipedia.org/wiki/Bell%27s_theorem).\n",
    "The goal of the Bell experiment is to create a Bell state\n",
    "{math}`|\\Phi ^+\\rangle=\\frac{1}{2}(|00\\rangle+|11\\rangle)` which is a perfectly entangled state, followed by a measurement.\n",
    "By rotating the measurement basis, or equivalently one of the qubits, it is possible\n",
    "to observe violations of the CSHS inequality.\n",
    "\n",
    "We create this experiment using the\n",
    "{ref}`quantum-circuit level<sec-user-guide-quantum-circuit>` description.\n",
    "This allows defining the Bell schedule as:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "86c33482",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Schedule \"Bell experiment\" containing (66) 147  (unique) operations."
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import numpy as np\n",
    "from quantify_scheduler import Schedule\n",
    "from quantify_scheduler.operations import CZ, Measure, Reset, Rxy, X90\n",
    "\n",
    "sched = Schedule(\"Bell experiment\")\n",
    "\n",
    "for acq_idx, theta in enumerate(np.linspace(0, 360, 21)):\n",
    "    sched.add(Reset(q0, q1))\n",
    "    sched.add(X90(q0))\n",
    "    sched.add(X90(q1), ref_pt=\"start\")  # Start at the same time as the other X90\n",
    "    sched.add(CZ(q0, q1))\n",
    "    sched.add(Rxy(theta=theta, phi=0, qubit=q0))\n",
    "\n",
    "    sched.add(Measure(q0, acq_index=acq_idx), label=\"M q0 {:.2f} deg\".format(theta))\n",
    "    sched.add(  \n",
    "        Measure(q1, acq_index=acq_idx),\n",
    "        label=\"M q1 {:.2f} deg\".format(theta),\n",
    "        ref_pt=\"start\",  # Start at the same time as the other measure\n",
    "    )\n",
    "\n",
    "sched\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "5a471d68",
   "metadata": {},
   "source": [
    "By scheduling 7 operations for 21 different values for {code}`theta` we indeed get a schedule containing 7\\*21=147 operations. To minimize the size of the schedule, identical operations are stored only once. For example, the {class}`~quantify_scheduler.operations.gate_library.CZ` operation is stored only once but used 21 times, which leaves only 66 unique operations in the schedule.\n",
    "\n",
    "```{note}\n",
    "The acquisitions are different for every iteration due to their different {code}`acq_index`. The {class}`~quantify_scheduler.operations.gate_library.Rxy`-gate rotates over a different angle every iteration and must therefore also be different for every iteration (except for the last since {math}`R^{360}=R^0`). Hence the number of unique operations is 3\\*21-1+4=66.\n",
    "```\n",
    "\n",
    "(sec-tutorial-ops-qubits-vis)=\n",
    "## Visualizing the quantum circuit\n",
    "\n",
    "We can directly visualize the created schedule on the\n",
    "{ref}`quantum-circuit level<sec-user-guide-quantum-circuit>` with the {meth}`~quantify_scheduler.schedules.schedule.ScheduleBase.plot_circuit_diagram` method.\n",
    "This visualization shows every operation on a line representing the different qubits."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "db56c812",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAzEAAADECAYAAACvIa+3AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjkuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8hTgPZAAAACXBIWXMAAA9hAAAPYQGoP6dpAAAs/UlEQVR4nO3deXxU1f3/8deZyQIIhCWETTAssgURK4gKAgqaQCi7pVZcIlXRQrX0pyKbVqEVpQouX6EoWrFaSkEdwaKyBCgKfr9oRTDIYlhECQQkbELIzPn9MSFNQgKZZJKZm7yfj8c8wtx75tzPDJn7yefec8811lpEREREREScwhXqAERERERERAKhIkZERERERBxFRYyIiIiIiDiKihgREREREXEUFTEiIiIiIuIoKmJERERERMRRVMSIiIiIiIijqIgRERERERFHUREjIiIiIiKOoiJGRKSKMMakGmNS8z2PN8ZYY8ydoYuq/BV+3yIi4nwqYkREwowx5s7c4iL/44AxZpUxpl+o45PgM8Y0McY8bozpHOpYREScICLUAYiISLGmAOmAARoCdwIfGGN+bq1dEsrAHOamUAdQAk2Ax4BdwH9CGomIiAOoiBERCV//stb+39knxphXgQzgFkBFzAUYY2pYa09aa7NDHYuIiASXhpOJiDjHEeAnICf/QmOMyxjzoDFmizHmlDEmwxgzxxhTN1gbNsbUMcbMNMbsNcacNsbsMMY8Yoxx5a43ucPdDhpj4vK9LsoY85UxZqcx5qLcZY/nDpFrZ4z5hzHmqDHmkDFmljGmWhHbHmmM2WiM+ckYc9gY83djTLNCbVKNMZuNMVcaY9YYY04Cf8y3LjVf29652/+FMeYxY8w+Y8wxY8w/jTExxpjo3Pd6wBhz3BjzmjEmuoxxdcj9fE7mbu/h/PEA/5v79LV8QwjvDPC/SUSkytCZGBGR8BVjjInFP5wsDhgL1ATeLNRuDv6hZq8BzwMtgDHAFcaY7tbaM2UJwhhTA1gNNM3d1h7gWuBPQGPgQWutNcbcBWwCZgNDc1/+ByAB6G2tPVGo63/gHz71KHA18FugLnB7vm1PBJ7MbfsK0AD/57DGGHOFtfZIvv7qA/8C/o7/M8q4wFt7FH9R+BTQOrffM4AvN47Hc+O6E/+wvidKGVddYBmwOLf9cGC6MeYra+2/gDT8QwefAP4CrM193ScXiF9EpOqy1uqhhx566BFGD/x/NNsiHqeAOwq17ZG77leFlicWXg6kAqn5nsfntrnzAvFMAo4DlxZa/if8Z4Wa5Vt2T26ftwLdctc/V+h1j+e2ea/Q8pdyl3fKfX5J7usnFGrXEX+xMaHQe7PAvUXEX/h9985t+xUQmW/5W/gLmA8Kvf4TYFe+56WJ67Z8y6KAH4B/5lvWpST/F3rooYceevgfGk4mIhK+fgPcmPsYCawCXjHGDM3X5mYgC/jYGBN79gFsxF94XB+EOG7Gf3bgx0LbWA64gZ5nG1pr/wJ8CLwAzAd2AhOK6felQs9fyP3ZP/fnUPzDnv9RaLv7ge2c+95O4z8bVVJv2IJnqTbgP+s1r1C7DUAzY8zZ0QuBxnWcfGfPrP8anc+AlgHEKiIi+Wg4mYhI+PrMFryw/23gC+BFY8yS3D+GLwVigAPF9BFXzPJAXAp0Ag6WcBuj8BcvlwLXWmt/KuZ12ws934n/TEh8vu2aItqdVXiY3D4b2EX8ewo9z8r9ubeI5S78n/OhUsT1nbXWFlr2I/7PVERESkFFjIiIQ1hrfcaYVcAD+P+Q3oL/j+sD+IdvFaW4wiMQLuBj4Oli1m8r9Lw3cPZC+MuAT0u4ncJ/6Ltyl/UDvEW0P17oeXHFUnGK6vN8y00p47pQfyIiEiAVMSIiznJ2v10z9+dOoC+w7jxnPMpqJ1DTWrv8Qg2NMY3xDwv7CMgGZhhjPrTW7i6i+aX4L5g/qzX+AmFXvu0aIN1aW7hQCqXyiKtwASciIueha2JERBzCGBOJ/8aN2fhntAL/bFduYHIR7SOMMXWCsOl/ANcYYxKL2EadfNeKAMzFn1tG4b/IPwd41RhT1FmH3xR6Pjb3579yfy7GfxbjscKvz53SuX7A7yQ4yiOuszO31SljbCIiVYLOxIiIhK9+xph2uf+OA36F/+zFU9baowDW2tXGmDnAo8aYzvjPgJzJbXcz/qFn/yxjHM8AA4ElxpjX8U8acBH+oWLD8V/DkmmMSQGS8c+w9R2AMWYs/ova7wP+p1C/LYwxHvzTD1+Df/KCt6y1X+a+t53GmEn4Z0GLN8a8CxzDP4X0EPzTEc8o43sLWDnFtRP/fYBGG2OO4S9qNlhr08/7KhGRKkpFjIhI+Hoi379PAVvxFwNz8jey1o42xmwE7sV/g8cc/EOy3gTWlTUIa+1JY0wv/LOM3Yz/Pi5H8V8L8xiQZYy5GHgOeN9a+9d8r/2bMWYY8LQx5l+F/igfkfsen8qN+UXgoULbfsoYsw34Xe62wH/h/UeAp6zvrbSCHZe19owx5g78hdFs/Pk5hYLD7UREJJc5d8IUERGR8mOMeRz/H/4NrLWZIQ5HREQcSNfEiIiIiIiIo6iIERERERERR1ERIyIiIiIijqJrYkRERERExFF0JkZERERERBxFRYyIiIiIiDiKihgREREREXGUcL3ZpS7UERERERGpekxJGulMjIiIiIiIOIqKGBERERERcRQVMSIiIiIi4igqYkRERERExFFUxIiIiIiIiKOoiBEREREREUdRESMiIiIiIo6iIkZERERERBxFRYyIiIiIiDiKihgREREREXEUFTEiIiIiIuIoKmJERERERMRRVMSIiIiIiIijqIgRERERERFHUREjIiIiIiKOoiJGREREREQcRUWMiIiIiIg4iooYERERERFxlIhQByAV44WVu0IdQkiMvSE+1CGInNfWrVtDHUJItGvXLtQhVCnKASLhSTmg9HQmRkREREREHEVFjIiIiIiIOIqKGBERERERcRQVMSIiIiIi4igqYkREpEgnTpxg9+7doQ5DRERCINxzgIoYERE5h8/n4+GHHyYpKYm0tLRQhyMiIhXICTlARYyIiJxj7ty5rFy5EgC32x3iaEREpCI5IQeoiBERkQLWrFnDrFmz8p5HRkaGMBoREalITskButmlSBiw1pKemc2OA6fZ+2M22TmWqAhDs7pRtI6LpkVsFMaYUIcpVcCePXsYN25cgWVRUVEhikakalAOkHDhpBygIkYkhHK8luVpR1myKYsfsnIAcLsACxjw+vztGsdEMKBTDH3b1ybCrUQm5ePkyZPcf//9nDp1Cmtt3vJwTWAiTqccIOHEaTlARYxIiOw5lM3MFQfYfSi7wPKzSYv/7j/4ISuHuWsP8dHXx3iwTxzN64fnDkWcy1rLxIkTSU9Px+fzFVgXrglMxMmUAyScODEH6JoYkRDY8v1PPLJoH3sPZ1+4cT57D2fzyKJ9bPn+p3KKTKqq+fPns2zZsnOSF4RvAhNxKuUACTdOzAEqYgpJTU0lPj4+oNfMmzePrVu3lk9AYcrn8zH1zj4sefWZAsu3rF/J7xLb8OXaZSGKLPztOZTN1CX7OeOz+OyF2+fns3DGZ5m6ZD97DgWW/ETO5/Dhw0DRs9CEawIrD8oBJaMcUHrKARKOnJgDVMSUwEsvvUR8fDzVqlWjW7dufPbZZwXWb9iwgTlz5oQoutBwuVzceMv9rH1vPj8dPwrA3m2bee3JsQy8+xEuvy4pxBGGpxyvZeaKA+T4LDbA5HWWtZDjs8xacYAcbyk7ESnkgQceYNy4cXi9XsD/HTfG4HK5wnZ6zYqiHHAu5YDSUQ6QcOXEHBD0a2KMMUOB0cCVQD3gCmvtf4K9nYqyYMECxo0bx+zZs+nWrRszZ84kMTGRb775hri4OAAGDRrE2LFjee6550IcbcXq0ncQy+bPYs17b9C17xDmTBrF1UnDuX74qFCHFraWpx09Z/xzafgs7DqUzfK0oyR1jAlCZFIZWWvZv38/27Zty3t89913HDt2jOPHj2OMoWbNmtSqVYtmzZqRlpaGy+XC5/NRr149OnbsSOPGjUP9NkJKOaB4ygGBUw6QilTZc0B5XNh/EfBv4B/A3HLov0I9++yz3H333aSkpAAwe/Zsli5dyrx58xg/fjwAffr0ISMjg82bN9OxY8dQhluh3O4I+o4YzZLX/sznK9+nedtODP3NY6EOK2xZa1myKSto/Rlg6aajJCbU1tSbkufkyZMsX74cj8fDunXrSvy6L774osDzzMxMALp27cqpU6eoVq1aUON0CuWA4ikHBEY5QCpCVcoBARcxxpiLgJeBocAxYAbwc+A/1toHrbXzc9vFBzHOkMjOzmbjxo08+uijectcLhd9+/bl008/zVsWHR3NTTfdhMfjqVIJDPxH4hb/zxNQrwF3Tnwel6tkIxRfn/pbrhs4kqWvP8uxHw/hdrtJvG0sV/RKLueIQyc9MztvCs1gsMD3WWdIz8ymZYPooPUrzuP1elm/fj0ejwePxxO0flNTU0lNTQVg2LBhDBw4kC5dupT4e+50ygEXphxQcsoBUl6qag4ozZmYZ4BewCDgAPBH4GfAf4IXVnjIzMzE6/XSsGHDAssbNmx4zkWcgwYN4uWXX2bChAkVGWLILXzef9TtRNZhTAl/qX0+H5nf7ya2aTxD75/Cxa07cPTwQZ4Z/XM6XHU90dVrlGfIIbPjwOny6ffgaSWwKspay8cff8zEiRM5fvx4kW3at29PQkICbdq0oW3btsTHx1OjRo28CzWzs7M5ceIEo0aN4ttvv8VaS3R0NKdPF/x9XbRoEYsWLSI2NpapU6fSq1evcn9/oaYccGHKASWnHCDBVtVzQEBFjDGmJjAKGGmtXZG77A7gu9IGYIyJBgp8+3bs2FGuMyE0a9Ys6H3279+flJQUMjMziY2NLbLN3r17g77dUFr62p/ZsmEV415czIsP3canHyyg5+Db89Zn7NnJc78dTvWatalW4yIO7tvNxa07MOS+STS7tCMx9eOIqe8fU167XgMuiqnLyWNHgprAwukz/3qPF7eBYF6H6TaQtvsw7WsFb4iCOMPWrVt58skn+fzzz89Z16dPHwYPHkzPnj0vuC+NioriyJEj7Ny5EwBjDOPHj2fw4MGsWrWK9957j9WrV+e1z8zMZPTo0XTv3p0JEybQsmXLUsUfyu+mckBwKAcERjlAgqky54CS7qMDPRPTCogCNpxdYK09bIz5JsB+8nsUKDCItmfPnmXo7sL27dtXonaxsbG43W4yMjIKLM/IyKBRo0YFlqWnp1OnTh3q1KlTbH9XX311wLEGy/j5JR8XWRKfLH2blQtfYcyMt2jaqgO9h6WwYsEcug+4BXdEJAANm7civn1nBt79CE1atmPqHTdw31N/JXXxPNp1ua5Af3u2fYX1+agb1ySocYbyMy+sRfLDNOjUD5c7eJeincnJYeE7/+LpXz8dtD6lYq1YsSKg9j/++COzZs1iwYIFBZY3b96clJQUkpKSzrsfKorH48m7mNPtdpOUlES1atXo168f/fr14/Dhw3zwwQfMnTuXAwcOALBu3TqSk5O5/fbbGTNmDLVq1Qpom6H8bioHlJ1yQOCUA6QoygHnKuk+ujwu7A/Un4Bn8y9Ys2ZNVjjMSR0VFcWVV17JihUrGDx4MOA/Db5ixQrGjBlToK3H46F///5ERBT/ka5fv748wz2vd7d7g9bXlg2rWPjC49w56XladLgCgJ6Dbmflgr/w2cfvcE2/X+S1zdj7LXHNWpJ96id8Ph/R1Wuw7fNP6Dnov0frThw9wptP/Z5f/v5PQYvxrFB+5oUt2uzlk92+oB6Fi4yI4OYhgxg6eWjwOpUKdeLEiRK33bRpE7feeis5OQXH1T/xxBMMHTq0VNNgWmtZvHhxXvLq1avXOQmwXr16jBw5khEjRrBgwQKmTZuWt+6NN97gnXfeYf78+bRt27bE2w2n72ZxlAOKphxQOsoBUhTlgNILtIjZCZwBugF7AIwxdYE2wOrzvK5Y1trTQPkMFA2CcePGcccdd9ClSxeuuuoqZs6cyYkTJ/JmqjnL4/EwefLk8/ZVHkMYSmz7rqB0s2fbV7z2xBgG3T2ey3sk5i2vXrM2PYfcyfK3X6bbTcNwud2cOnmciMgoIiKj2L3zSxo2b8Wpk8ex1kf1mrUBOJN9mlem3EPfW0bTMuHKoMSYX0g/80I6HD3K2l2ZQe3Ta6H9JfVo1qx2UPuVilPSmyQuXLiQKVOmFFh21113MXr06ICPgOW3adOmvKNeXq8374/1okRGRjJy5EiSk5N58cUXeeuttwA4duwYgwcPZsaMGSQnl+zC7HD6bp6PckBBygGlpxwgRVEOKL2Aihhr7XFjzKvAM8aYQ/gv7J8G+M62McbUA5oDZ88Jt82d+m+/tXZ/mSOuYCNGjODgwYNMmTKF/fv307lzZ5YtW1bgQs/09HS++eYbkpIq/829mre5jBlLtxS5LjllHMkp4/Ke79+9nUaXtAYgY88O4i5uwbYvPuHSztcA/ur/b08/xKVXXMtVN1b+o0it48rnwsvWuqCz0jtw4ADTp0/Pe964cWPmzp1Lq1atyty3x+PB7Xbj9XqpWbNmiYbz1q1bl8mTJzN8+HBSUlLIyvKPx582bRo9evQgJqby3LdCOaAg5YDSUw6Q0lIOKFpp5kh7CFgLvA8sx39PmI351g8EvgCW5j7/e+7z0aUPM7TGjBnD7t27OX36NBs2bKBbt24F1ns8Hnr37l2mSrgy+mHXdhrHtwEgqloNtm78N2n/u4Z2V/rHQn+7+f/4InUJX637iOn39Gf6Pf35/tuSHZFwohaxUTSOCd4ITgM0iYmkRWzoh15K+YqLi+PZZ/2jbhMTE3n//feDkryys7PxeDx4vV7cbjcDBgwIaFKV9u3b8+GHH9KjRw8Ann/++UpVwJylHFA6ygEFKQdIaSkHFC3gb5O19jhwW+4DAGNMcr71rwOvByE2x/B4PAwdWvmPIgUq/7jozj370blnP565byA3j/0DAK0u68qs5d+GKrwKZ4xhQKcY5q49FJT+LJDcSTc5qyp69uzJwoULSUhICNr/+dq1a/Om5fR6vQwcODDgPmJiYpgzZw5paWkkJCQEJS6nUQ4omnJAQcoBUhbKAecKhwv7HS/QmSWqsodeDt5NmJyob/vafPT1MfYezsZXhos7XQaa14vixg4aB12VBPtGiu+++27eMIKmTZvSuXPnUvXjcrmqbAEDygGBUA5QDpDSUw4otN0K32KYi4+P58EHHwx1GFJJRbgND/aJI8JlKO2BFGMgwmV4oE8cbpeOwEnpZGVlkZqaitfrxeVyMWTIEB3RRTlAypdygISLypADglLEWGt7W2sfDEZfoaYEJuWtef0oJg1oRKTLEGj+cRmIdBkmDWhE8/oaBy2lt2zZsrxpOn0+X6mGEVRGygFS3pQDJBxUhhygMzEiIZDQpDrThzWleb2SJaGzea55vSimD2tKQpPq5RecVAmLFy/GGIMxhk6dOoXVVLQilZ1ygIRaZcgBuiZGJESa1/cno+VpR1myKYsfsgrevMrtAm/u5OWNYyJJ7lSbvu1rE+F21uleCT979+5l06ZNec+HDRsWwmhEqiblAAmVypIDVMSIhFCE25DUMYbEhNqkZ2azdf8pXv23f+aavu1rER8bTesG0bSIjXLcWFUJX8uWLcv7d0REBImJiedpLSLlRTlAQqGy5AAVMSJhwBhDywbRNKkTmZfAbr+mPtUiNeJTgq9r167Ur1+fQ4cOccMNN1TKe7uIOIlygFSkypIDVMSIiFQxnTt3ZvXq1WzZsoV27dqFOhwREalAlSUHqIgREamC3G43nTp1CnUYIiISApUhB+g8pYiIiIiIOIqKGBERERERcRQVMSIiIiIi4igqYkRERERExFF0YX8VMfaG+FCHICJFcPLMMOIcygEi4Uk5oPR0JkZERERERBxFRYyIiIiIiDiKihgREREREXEUFTEiIiIiIuIoKmJERERERMRRVMSIiIiIiIijqIgRERERERFHUREjIiIiIiKOoiJGREREREQcRUWMiIiIiIg4iooYERERERFxFBUxIiIiIiLiKCpiRERERETEUVTEiIiIiIiIo6iIERERERERR1ERIyIiIiIijqIiRkREREREHEVFjIiIiIiIOIqKGBERERERcRQVMSIiIiIi4igqYkRERERExFFUxIiIiIiIiKOoiBEREREREUdRESMiIiIiIo6iIkZERERERBxFRYyIiIiIiDiKihgREREREXEUFTEiIiIiIuIoKmJERERERMRRVMSIiIiIiIijqIgRERERERFHUREjIiIiIiKOoiJGREREREQcRUWMiIiIiIg4iooYERERERFxFBUxIiIi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",
      "text/plain": [
       "<Figure size 1000x200 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "\n",
    "_, ax = sched.plot_circuit_diagram()\n",
    "# all gates are plotted, but it doesn't all fit in a matplotlib figure.\n",
    "# Therefore we use :code:`set_xlim` to limit the number of gates shown.\n",
    "ax.set_xlim(-0.5, 9.5)\n",
    "plt.show()\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "f600d99d",
   "metadata": {},
   "source": [
    "In previous tutorials, we visualized the `schedules` on the pulse level using {meth}`~quantify_scheduler.schedules.schedule.ScheduleBase.plot_pulse_diagram` .\n",
    "Up until now, however, all gates have been defined on the\n",
    "{ref}`quantum-circuit level<sec-user-guide-quantum-circuit>` without defining the\n",
    "corresponding pulse shapes.\n",
    "Therefore, trying to run {meth}`~quantify_scheduler.schedules.schedule.ScheduleBase.plot_pulse_diagram` will raise an error which\n",
    "signifies no {code}`pulse_info` is present in the schedule:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "cf71dd7e",
   "metadata": {
    "tags": [
     "raises-exception"
    ]
   },
   "outputs": [
    {
     "ename": "KeyError",
     "evalue": "'abs_time'",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mKeyError\u001b[0m                                  Traceback (most recent call last)",
      "Cell \u001b[0;32mIn[6], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[43msched\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mplot_pulse_diagram\u001b[49m\u001b[43m(\u001b[49m\u001b[43m)\u001b[49m\n",
      "File \u001b[0;32m/usr/local/lib/python3.9/site-packages/quantify_scheduler/schedules/schedule.py:437\u001b[0m, in \u001b[0;36mScheduleBase.plot_pulse_diagram\u001b[0;34m(self, port_list, sampling_rate, modulation, modulation_if, plot_backend, x_range, combine_waveforms_on_same_port, **backend_kwargs)\u001b[0m\n\u001b[1;32m    431\u001b[0m \u001b[38;5;66;03m# NB imported here to avoid circular import\u001b[39;00m\n\u001b[1;32m    433\u001b[0m \u001b[38;5;28;01mfrom\u001b[39;00m \u001b[38;5;21;01mquantify_scheduler\u001b[39;00m\u001b[38;5;21;01m.\u001b[39;00m\u001b[38;5;21;01mschedules\u001b[39;00m\u001b[38;5;21;01m.\u001b[39;00m\u001b[38;5;21;01m_visualization\u001b[39;00m\u001b[38;5;21;01m.\u001b[39;00m\u001b[38;5;21;01mpulse_diagram\u001b[39;00m \u001b[38;5;28;01mimport\u001b[39;00m (\n\u001b[1;32m    434\u001b[0m     sample_schedule,\n\u001b[1;32m    435\u001b[0m )\n\u001b[0;32m--> 437\u001b[0m sampled_pulses_and_acqs \u001b[38;5;241m=\u001b[39m \u001b[43msample_schedule\u001b[49m\u001b[43m(\u001b[49m\n\u001b[1;32m    438\u001b[0m \u001b[43m    \u001b[49m\u001b[38;5;28;43mself\u001b[39;49m\u001b[43m,\u001b[49m\n\u001b[1;32m    439\u001b[0m \u001b[43m    \u001b[49m\u001b[43msampling_rate\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43msampling_rate\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    440\u001b[0m \u001b[43m    \u001b[49m\u001b[43mport_list\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43mport_list\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    441\u001b[0m \u001b[43m    \u001b[49m\u001b[43mmodulation\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43mmodulation\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    442\u001b[0m \u001b[43m    \u001b[49m\u001b[43mmodulation_if\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43mmodulation_if\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    443\u001b[0m \u001b[43m    \u001b[49m\u001b[43mx_range\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43mx_range\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    444\u001b[0m \u001b[43m    \u001b[49m\u001b[43mcombine_waveforms_on_same_port\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43mcombine_waveforms_on_same_port\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    445\u001b[0m \u001b[43m\u001b[49m\u001b[43m)\u001b[49m\n\u001b[1;32m    447\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m plot_backend \u001b[38;5;241m==\u001b[39m \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mmpl\u001b[39m\u001b[38;5;124m\"\u001b[39m:\n\u001b[1;32m    448\u001b[0m     \u001b[38;5;66;03m# NB imported here to avoid circular import\u001b[39;00m\n\u001b[1;32m    450\u001b[0m     \u001b[38;5;28;01mfrom\u001b[39;00m \u001b[38;5;21;01mquantify_scheduler\u001b[39;00m\u001b[38;5;21;01m.\u001b[39;00m\u001b[38;5;21;01mschedules\u001b[39;00m\u001b[38;5;21;01m.\u001b[39;00m\u001b[38;5;21;01m_visualization\u001b[39;00m\u001b[38;5;21;01m.\u001b[39;00m\u001b[38;5;21;01mpulse_diagram\u001b[39;00m \u001b[38;5;28;01mimport\u001b[39;00m (\n\u001b[1;32m    451\u001b[0m         pulse_diagram_matplotlib,\n\u001b[1;32m    452\u001b[0m     )\n",
      "File \u001b[0;32m/usr/local/lib/python3.9/site-packages/quantify_scheduler/schedules/_visualization/pulse_diagram.py:441\u001b[0m, in \u001b[0;36msample_schedule\u001b[0;34m(schedule, port_list, modulation, modulation_if, sampling_rate, x_range, combine_waveforms_on_same_port)\u001b[0m\n\u001b[1;32m    438\u001b[0m pulse_infos: \u001b[38;5;28mdict\u001b[39m[\u001b[38;5;28mstr\u001b[39m, \u001b[38;5;28mlist\u001b[39m[ScheduledInfo]] \u001b[38;5;241m=\u001b[39m defaultdict(\u001b[38;5;28mlist\u001b[39m)\n\u001b[1;32m    439\u001b[0m acq_infos: \u001b[38;5;28mdict\u001b[39m[\u001b[38;5;28mstr\u001b[39m, \u001b[38;5;28mlist\u001b[39m[ScheduledInfo]] \u001b[38;5;241m=\u001b[39m defaultdict(\u001b[38;5;28mlist\u001b[39m)\n\u001b[0;32m--> 441\u001b[0m \u001b[43m_extract_schedule_infos\u001b[49m\u001b[43m(\u001b[49m\n\u001b[1;32m    442\u001b[0m \u001b[43m    \u001b[49m\u001b[43mschedule\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    443\u001b[0m \u001b[43m    \u001b[49m\u001b[43mport_list\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    444\u001b[0m \u001b[43m    \u001b[49m\u001b[38;5;241;43m0\u001b[39;49m\u001b[43m,\u001b[49m\n\u001b[1;32m    445\u001b[0m \u001b[43m    \u001b[49m\u001b[43moffset_infos\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    446\u001b[0m \u001b[43m    \u001b[49m\u001b[43mpulse_infos\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    447\u001b[0m \u001b[43m    \u001b[49m\u001b[43macq_infos\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m    448\u001b[0m \u001b[43m\u001b[49m\u001b[43m)\u001b[49m\n\u001b[1;32m    450\u001b[0m x_min, x_max \u001b[38;5;241m=\u001b[39m x_range\n\u001b[1;32m    452\u001b[0m sampled_pulses \u001b[38;5;241m=\u001b[39m get_sampled_pulses_from_voltage_offsets(\n\u001b[1;32m    453\u001b[0m     schedule\u001b[38;5;241m=\u001b[39mschedule,\n\u001b[1;32m    454\u001b[0m     offset_infos\u001b[38;5;241m=\u001b[39moffset_infos,\n\u001b[0;32m   (...)\u001b[0m\n\u001b[1;32m    458\u001b[0m     modulation_if\u001b[38;5;241m=\u001b[39mmodulation_if,\n\u001b[1;32m    459\u001b[0m )\n",
      "File \u001b[0;32m/usr/local/lib/python3.9/site-packages/quantify_scheduler/schedules/_visualization/pulse_diagram.py:338\u001b[0m, in \u001b[0;36m_extract_schedule_infos\u001b[0;34m(operation, port_list, time_offset, offset_infos, pulse_infos, acq_infos)\u001b[0m\n\u001b[1;32m    336\u001b[0m     \u001b[38;5;28;01mfor\u001b[39;00m schedulable \u001b[38;5;129;01min\u001b[39;00m operation\u001b[38;5;241m.\u001b[39mschedulables\u001b[38;5;241m.\u001b[39mvalues():\n\u001b[1;32m    337\u001b[0m         inner_operation \u001b[38;5;241m=\u001b[39m operation\u001b[38;5;241m.\u001b[39moperations[schedulable[\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124moperation_id\u001b[39m\u001b[38;5;124m\"\u001b[39m]]\n\u001b[0;32m--> 338\u001b[0m         abs_time \u001b[38;5;241m=\u001b[39m \u001b[43mschedulable\u001b[49m\u001b[43m[\u001b[49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[38;5;124;43mabs_time\u001b[39;49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[43m]\u001b[49m\n\u001b[1;32m    339\u001b[0m         _extract_schedule_infos(\n\u001b[1;32m    340\u001b[0m             inner_operation,\n\u001b[1;32m    341\u001b[0m             port_list,\n\u001b[0;32m   (...)\u001b[0m\n\u001b[1;32m    345\u001b[0m             acq_infos,\n\u001b[1;32m    346\u001b[0m         )\n\u001b[1;32m    347\u001b[0m \u001b[38;5;28;01melif\u001b[39;00m \u001b[38;5;28misinstance\u001b[39m(operation, ConditionalOperation):\n",
      "File \u001b[0;32m/usr/local/lib/python3.9/collections/__init__.py:1058\u001b[0m, in \u001b[0;36mUserDict.__getitem__\u001b[0;34m(self, key)\u001b[0m\n\u001b[1;32m   1056\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m \u001b[38;5;28mhasattr\u001b[39m(\u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39m\u001b[38;5;18m__class__\u001b[39m, \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124m__missing__\u001b[39m\u001b[38;5;124m\"\u001b[39m):\n\u001b[1;32m   1057\u001b[0m     \u001b[38;5;28;01mreturn\u001b[39;00m \u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39m\u001b[38;5;18m__class__\u001b[39m\u001b[38;5;241m.\u001b[39m\u001b[38;5;21m__missing__\u001b[39m(\u001b[38;5;28mself\u001b[39m, key)\n\u001b[0;32m-> 1058\u001b[0m \u001b[38;5;28;01mraise\u001b[39;00m \u001b[38;5;167;01mKeyError\u001b[39;00m(key)\n",
      "\u001b[0;31mKeyError\u001b[0m: 'abs_time'"
     ]
    }
   ],
   "source": [
    "sched.plot_pulse_diagram()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e427eb46",
   "metadata": {},
   "source": [
    "And similarly for the {code}`timing_table`:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "d1177392",
   "metadata": {
    "tags": [
     "raises-exception"
    ]
   },
   "outputs": [
    {
     "ename": "ValueError",
     "evalue": "Absolute time has not been determined yet. Please compile your schedule.",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mValueError\u001b[0m                                Traceback (most recent call last)",
      "Cell \u001b[0;32mIn[7], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[43msched\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mtiming_table\u001b[49m\n",
      "File \u001b[0;32m/usr/local/lib/python3.9/site-packages/quantify_scheduler/schedules/schedule.py:628\u001b[0m, in \u001b[0;36mScheduleBase.timing_table\u001b[0;34m(self)\u001b[0m\n\u001b[1;32m    534\u001b[0m \u001b[38;5;250m\u001b[39m\u001b[38;5;124;03m\"\"\"\u001b[39;00m\n\u001b[1;32m    535\u001b[0m \u001b[38;5;124;03mA styled pandas dataframe containing the absolute timing of pulses and acquisitions in a schedule.\u001b[39;00m\n\u001b[1;32m    536\u001b[0m \n\u001b[0;32m   (...)\u001b[0m\n\u001b[1;32m    625\u001b[0m \n\u001b[1;32m    626\u001b[0m \u001b[38;5;124;03m\"\"\"\u001b[39;00m  \u001b[38;5;66;03m# noqa: E501\u001b[39;00m\n\u001b[1;32m    627\u001b[0m timing_table_list \u001b[38;5;241m=\u001b[39m []\n\u001b[0;32m--> 628\u001b[0m \u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43m_generate_timing_table_list\u001b[49m\u001b[43m(\u001b[49m\u001b[38;5;28;43mself\u001b[39;49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;241;43m0\u001b[39;49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mtiming_table_list\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;28;43;01mNone\u001b[39;49;00m\u001b[43m)\u001b[49m\n\u001b[1;32m    629\u001b[0m timing_table \u001b[38;5;241m=\u001b[39m pd\u001b[38;5;241m.\u001b[39mconcat(timing_table_list, ignore_index\u001b[38;5;241m=\u001b[39m\u001b[38;5;28;01mTrue\u001b[39;00m)\n\u001b[1;32m    630\u001b[0m timing_table \u001b[38;5;241m=\u001b[39m timing_table\u001b[38;5;241m.\u001b[39msort_values(by\u001b[38;5;241m=\u001b[39m\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mabs_time\u001b[39m\u001b[38;5;124m\"\u001b[39m)\n",
      "File \u001b[0;32m/usr/local/lib/python3.9/site-packages/quantify_scheduler/schedules/schedule.py:488\u001b[0m, in \u001b[0;36mScheduleBase._generate_timing_table_list\u001b[0;34m(cls, operation, time_offset, timing_table_list, operation_id)\u001b[0m\n\u001b[1;32m    485\u001b[0m     \u001b[38;5;28;01mfor\u001b[39;00m schedulable \u001b[38;5;129;01min\u001b[39;00m operation\u001b[38;5;241m.\u001b[39mschedulables\u001b[38;5;241m.\u001b[39mvalues():\n\u001b[1;32m    486\u001b[0m         \u001b[38;5;28;01mif\u001b[39;00m \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mabs_time\u001b[39m\u001b[38;5;124m\"\u001b[39m \u001b[38;5;129;01mnot\u001b[39;00m \u001b[38;5;129;01min\u001b[39;00m schedulable:\n\u001b[1;32m    487\u001b[0m             \u001b[38;5;66;03m# when this exception is encountered\u001b[39;00m\n\u001b[0;32m--> 488\u001b[0m             \u001b[38;5;28;01mraise\u001b[39;00m \u001b[38;5;167;01mValueError\u001b[39;00m(\n\u001b[1;32m    489\u001b[0m                 \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mAbsolute time has not been determined yet. \u001b[39m\u001b[38;5;124m\"\u001b[39m\n\u001b[1;32m    490\u001b[0m                 \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mPlease compile your schedule.\u001b[39m\u001b[38;5;124m\"\u001b[39m\n\u001b[1;32m    491\u001b[0m             )\n\u001b[1;32m    492\u001b[0m         \u001b[38;5;28mcls\u001b[39m\u001b[38;5;241m.\u001b[39m_generate_timing_table_list(\n\u001b[1;32m    493\u001b[0m             operation\u001b[38;5;241m.\u001b[39moperations[schedulable[\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124moperation_id\u001b[39m\u001b[38;5;124m\"\u001b[39m]],\n\u001b[1;32m    494\u001b[0m             time_offset \u001b[38;5;241m+\u001b[39m schedulable[\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mabs_time\u001b[39m\u001b[38;5;124m\"\u001b[39m],\n\u001b[1;32m    495\u001b[0m             timing_table_list,\n\u001b[1;32m    496\u001b[0m             schedulable[\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124moperation_id\u001b[39m\u001b[38;5;124m\"\u001b[39m],\n\u001b[1;32m    497\u001b[0m         )\n\u001b[1;32m    498\u001b[0m \u001b[38;5;28;01melif\u001b[39;00m \u001b[38;5;28misinstance\u001b[39m(operation, LoopOperation):\n",
      "\u001b[0;31mValueError\u001b[0m: Absolute time has not been determined yet. Please compile your schedule."
     ]
    }
   ],
   "source": [
    "sched.timing_table"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "5c43da5e",
   "metadata": {},
   "source": [
    "## Device configuration\n",
    "\n",
    "Up until now, the schedule is not specific to any qubit implementation.\n",
    "The aim of this section is to add device-specific information to the schedule.\n",
    "This knowledge is contained in the {ref}`device configuration<sec-device-config>`, which we introduce in this section.\n",
    "By compiling the schedule to the quantum-device layer, we incorporate the device configuration into the schedule (for example by adding pulse information to every gate) and thereby enable it to run on a specific qubit implementation.\n",
    "\n",
    "To start this section, we will unpack the structure of the device configuration.\n",
    "Here we will use an example device configuration for a transmon-based system that is used in the\n",
    "`quantify-scheduler` test suite."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "id": "ba80f37c",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "['clocks', 'elements', 'edges', 'scheduling_strategy', 'compilation_passes']"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from quantify_scheduler.backends.circuit_to_device import DeviceCompilationConfig\n",
    "from quantify_scheduler.schemas import example_transmon_cfg\n",
    "\n",
    "device_cfg = DeviceCompilationConfig.model_validate(example_transmon_cfg)\n",
    "\n",
    "list(device_cfg.model_dump())"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "a59093b8",
   "metadata": {},
   "source": [
    "Before explaining how this can be used to compile schedules, let us first investigate\n",
    "the contents of the device configuration."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "id": "00eafe30",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[SimpleNodeConfig(name='circuit_to_device', compilation_func=<function compile_circuit_to_device_with_config_validation at 0x7d677e61ab80>)]"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "device_cfg.compilation_passes\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ed06f7bb",
   "metadata": {},
   "source": [
    "The compilation passes of the device configuration specifies which function(s) will be used to \n",
    "compile the {class}`~.Schedule` to the {ref}`sec-user-guide-quantum-device`. In other words, \n",
    "it specifies how to interpret the qubit parameters present in the device configuration and achieve\n",
    "the required gates. Let us briefly investigate the compilation function:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "id": "7fb7f82a",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Help on function compile_circuit_to_device_with_config_validation in module quantify_scheduler.backends.circuit_to_device:\n",
      "\n",
      "compile_circuit_to_device_with_config_validation(schedule: 'Schedule', config: 'CompilationConfig') -> 'Schedule'\n",
      "    Add pulse information to all gates in the schedule.\n",
      "    \n",
      "    Before calling this function, the schedule can contain abstract operations (gates or\n",
      "    measurements). This function adds pulse and acquisition information with respect to\n",
      "    ``config`` as they are expected to arrive to device (latency or distortion corrections\n",
      "    are not taken into account).\n",
      "    \n",
      "    From a point of view of :ref:`sec-compilation`, this function converts a schedule\n",
      "    defined on a quantum-circuit layer to a schedule defined on a quantum-device layer.\n",
      "    \n",
      "    Parameters\n",
      "    ----------\n",
      "    schedule\n",
      "        The schedule to be compiled.\n",
      "    config\n",
      "        Compilation config for\n",
      "        :class:`~quantify_scheduler.backends.graph_compilation.QuantifyCompiler`, of\n",
      "        which only the :attr:`.CompilationConfig.device_compilation_config`\n",
      "        is used in this compilation step.\n",
      "    \n",
      "    Returns\n",
      "    -------\n",
      "    :\n",
      "        The modified ``schedule`` with pulse information added to all gates, or the unmodified\n",
      "        schedule if circuit to device compilation is not necessary.\n",
      "\n"
     ]
    }
   ],
   "source": [
    "help(device_cfg.compilation_passes[0].compilation_func)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e12f3d7b",
   "metadata": {},
   "source": [
    "The {ref}`device configuration <sec-device-config>` also contains the\n",
    "parameters required by the backend for all qubits and edges."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "id": "46f660b9",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['q0', 'q1']\n",
      "['q0_q1']\n",
      "['q0.01', 'q0.ro', 'q1.01', 'q1.ro']\n"
     ]
    }
   ],
   "source": [
    "print(list(device_cfg.elements))\n",
    "print(list(device_cfg.edges))\n",
    "print(list(device_cfg.clocks))\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ab50376c",
   "metadata": {},
   "source": [
    "For every qubit and edge, we can investigate the contained parameters."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "id": "3a4350af",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'reset': OperationCompilationConfig(factory_func=<class 'quantify_scheduler.operations.pulse_library.IdlePulse'>, factory_kwargs={'duration': 0.0002}, gate_info_factory_kwargs=None), 'Rxy': OperationCompilationConfig(factory_func=<function rxy_drag_pulse at 0x7d6795339ee0>, factory_kwargs={'amp180': 0.32, 'motzoi': 0.45, 'port': 'q0:mw', 'clock': 'q0.01', 'duration': 2e-08}, gate_info_factory_kwargs=['theta', 'phi']), 'Rz': OperationCompilationConfig(factory_func=<function phase_shift at 0x7d67952f4280>, factory_kwargs={'clock': 'q0.01'}, gate_info_factory_kwargs=['theta']), 'H': OperationCompilationConfig(factory_func=<function hadamard_as_y90z at 0x7d67952bedc0>, factory_kwargs={'qubit': 'q0'}, gate_info_factory_kwargs=None), 'measure': OperationCompilationConfig(factory_func=<function dispersive_measurement_transmon at 0x7d67952c81f0>, factory_kwargs={'port': 'q0:res', 'clock': 'q0.ro', 'pulse_type': 'SquarePulse', 'pulse_amp': 0.25, 'pulse_duration': 1.6e-07, 'acq_delay': 1.2e-07, 'acq_duration': 3e-07, 'acq_channel': 0, 'acq_rotation': 0, 'acq_threshold': 0, 'freq': None}, gate_info_factory_kwargs=['acq_channel_override', 'acq_index', 'bin_mode', 'acq_protocol'])}\n",
      "{'amp180': 0.32, 'motzoi': 0.45, 'port': 'q0:mw', 'clock': 'q0.01', 'duration': 2e-08}\n"
     ]
    }
   ],
   "source": [
    "print(device_cfg.elements[\"q0\"])\n",
    "print(device_cfg.elements[\"q0\"][\"Rxy\"].factory_kwargs)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "id": "8cf18f98",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'q0_q1': {'CZ': OperationCompilationConfig(factory_func=<function composite_square_pulse at 0x7d67952f4310>, factory_kwargs={'square_port': 'q0:fl', 'square_clock': 'cl0.baseband', 'square_amp': 0.5, 'square_duration': 2e-08, 'virt_z_parent_qubit_phase': 44, 'virt_z_parent_qubit_clock': 'q0.01', 'virt_z_child_qubit_phase': 63, 'virt_z_child_qubit_clock': 'q1.01'}, gate_info_factory_kwargs=None)}}\n"
     ]
    }
   ],
   "source": [
    "print(device_cfg.edges)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "id": "fb5411b4",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'q0.01': 6020000000.0, 'q0.ro': 7040000000.0, 'q1.01': 5020000000.0, 'q1.ro': 6900000000.0}\n"
     ]
    }
   ],
   "source": [
    "print(device_cfg.clocks)\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "00b70dd2",
   "metadata": {},
   "source": [
    "Lastly, the complete example device configuration (also see {class}`~quantify_scheduler.backends.graph_compilation.DeviceCompilationConfig`):"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "id": "1ea3c760",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{'clocks': {'q0.01': 6020000000.0,\n",
      "            'q0.ro': 7040000000.0,\n",
      "            'q1.01': 5020000000.0,\n",
      "            'q1.ro': 6900000000.0},\n",
      " 'compilation_passes': [{'compilation_func': 'quantify_scheduler.backends.circuit_to_device.compile_circuit_to_device_with_config_validation',\n",
      "                         'name': 'circuit_to_device'}],\n",
      " 'edges': {'q0_q1': {'CZ': {'factory_func': 'quantify_scheduler.operations.pulse_factories.composite_square_pulse',\n",
      "                            'factory_kwargs': {'square_amp': 0.5,\n",
      "                                               'square_clock': 'cl0.baseband',\n",
      "                                               'square_duration': 2e-08,\n",
      "                                               'square_port': 'q0:fl',\n",
      "                                               'virt_z_child_qubit_clock': 'q1.01',\n",
      "                                               'virt_z_child_qubit_phase': 63,\n",
      "                                               'virt_z_parent_qubit_clock': 'q0.01',\n",
      "                                               'virt_z_parent_qubit_phase': 44}}}},\n",
      " 'elements': {'q0': {'H': {'factory_func': 'quantify_scheduler.operations.composite_factories.hadamard_as_y90z',\n",
      "                           'factory_kwargs': {'qubit': 'q0'}},\n",
      "                     'Rxy': {'factory_func': 'quantify_scheduler.operations.pulse_factories.rxy_drag_pulse',\n",
      "                             'factory_kwargs': {'amp180': 0.32,\n",
      "                                                'clock': 'q0.01',\n",
      "                                                'duration': 2e-08,\n",
      "                                                'motzoi': 0.45,\n",
      "                                                'port': 'q0:mw'},\n",
      "                             'gate_info_factory_kwargs': ['theta', 'phi']},\n",
      "                     'Rz': {'factory_func': 'quantify_scheduler.operations.pulse_factories.phase_shift',\n",
      "                            'factory_kwargs': {'clock': 'q0.01'},\n",
      "                            'gate_info_factory_kwargs': ['theta']},\n",
      "                     'measure': {'factory_func': 'quantify_scheduler.operations.measurement_factories.dispersive_measurement_transmon',\n",
      "                                 'factory_kwargs': {'acq_channel': 0,\n",
      "                                                    'acq_delay': 1.2e-07,\n",
      "                                                    'acq_duration': 3e-07,\n",
      "                                                    'acq_rotation': 0,\n",
      "                                                    'acq_threshold': 0,\n",
      "                                                    'clock': 'q0.ro',\n",
      "                                                    'freq': None,\n",
      "                                                    'port': 'q0:res',\n",
      "                                                    'pulse_amp': 0.25,\n",
      "                                                    'pulse_duration': 1.6e-07,\n",
      "                                                    'pulse_type': 'SquarePulse'},\n",
      "                                 'gate_info_factory_kwargs': ['acq_channel_override',\n",
      "                                                              'acq_index',\n",
      "                                                              'bin_mode',\n",
      "                                                              'acq_protocol']},\n",
      "                     'reset': {'factory_func': 'quantify_scheduler.operations.pulse_library.IdlePulse',\n",
      "                               'factory_kwargs': {'duration': 0.0002}}},\n",
      "              'q1': {'Rxy': {'factory_func': 'quantify_scheduler.operations.pulse_factories.rxy_drag_pulse',\n",
      "                             'factory_kwargs': {'amp180': 0.4,\n",
      "                                                'clock': 'q1.01',\n",
      "                                                'duration': 2e-08,\n",
      "                                                'motzoi': 0.25,\n",
      "                                                'port': 'q1:mw'},\n",
      "                             'gate_info_factory_kwargs': ['theta', 'phi']},\n",
      "                     'Rz': {'factory_func': 'quantify_scheduler.operations.pulse_factories.phase_shift',\n",
      "                            'factory_kwargs': {'clock': 'q1.01'},\n",
      "                            'gate_info_factory_kwargs': ['theta']},\n",
      "                     'measure': {'factory_func': 'quantify_scheduler.operations.measurement_factories.dispersive_measurement_transmon',\n",
      "                                 'factory_kwargs': {'acq_channel': 1,\n",
      "                                                    'acq_delay': 1.2e-07,\n",
      "                                                    'acq_duration': 3e-07,\n",
      "                                                    'acq_rotation': 0,\n",
      "                                                    'acq_threshold': 0,\n",
      "                                                    'clock': 'q1.ro',\n",
      "                                                    'freq': None,\n",
      "                                                    'port': 'q1:res',\n",
      "                                                    'pulse_amp': 0.21,\n",
      "                                                    'pulse_duration': 1.6e-07,\n",
      "                                                    'pulse_type': 'SquarePulse'},\n",
      "                                 'gate_info_factory_kwargs': ['acq_channel_override',\n",
      "                                                              'acq_index',\n",
      "                                                              'bin_mode',\n",
      "                                                              'acq_protocol']},\n",
      "                     'reset': {'factory_func': 'quantify_scheduler.operations.pulse_library.IdlePulse',\n",
      "                               'factory_kwargs': {'duration': 0.0002}}}}}\n"
     ]
    }
   ],
   "source": [
    "pprint(example_transmon_cfg)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "195c7bac",
   "metadata": {},
   "source": [
    "## Quantum Devices and Elements\n",
    "\n",
    "The {ref}`device configuration<sec-device-config>` contains all knowledge\n",
    "of the physical device under test (DUT).\n",
    "To generate these device configurations on the fly, `quantify-scheduler` provides the\n",
    "{class}`~quantify_scheduler.device_under_test.quantum_device.QuantumDevice` and\n",
    "{class}`~quantify_scheduler.device_under_test.device_element.DeviceElement` classes.\n",
    "\n",
    "These classes contain the information necessary to generate the device configs and allow\n",
    "changing their parameters on-the-fly.\n",
    "The {class}`~quantify_scheduler.device_under_test.quantum_device.QuantumDevice` class\n",
    "represents the DUT containing different {class}`~quantify_scheduler.device_under_test.device_element.DeviceElement` s.\n",
    "Currently, `quantify-scheduler` contains the\n",
    "{class}`~quantify_scheduler.device_under_test.transmon_element.BasicTransmonElement` class\n",
    "to represent a fixed-frequency transmon qubit connected to a feedline. We show their interaction below:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "id": "f90f16a6",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(<QuantumDevice: DUT>, ['qubit'])"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from quantify_scheduler import BasicTransmonElement, QuantumDevice\n",
    "\n",
    "# First create a device under test\n",
    "dut = QuantumDevice(\"DUT\")\n",
    "\n",
    "# Then create a transmon element\n",
    "qubit = BasicTransmonElement(\"qubit\")\n",
    "\n",
    "# Finally, add the transmon element to the QuantumDevice\n",
    "dut.add_element(qubit)\n",
    "dut, dut.elements()\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "721234b5",
   "metadata": {},
   "source": [
    "The different transmon properties can be set through attributes of the {class}`~quantify_scheduler.device_under_test.transmon_element.BasicTransmonElement` class instance, e.g.:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "id": "488204a7",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['reset', 'rxy', 'measure', 'pulse_compensation', 'ports', 'clock_freqs']\n",
      "\n",
      "qubit.reset: ['duration']\n",
      "qubit.rxy: ['amp180', 'motzoi', 'duration']\n",
      "qubit.measure: ['pulse_type', 'pulse_amp', 'pulse_duration', 'acq_channel', 'acq_delay', 'integration_time', 'reset_clock_phase', 'acq_weights_a', 'acq_weights_b', 'acq_weights_sampling_rate', 'acq_weight_type', 'acq_rotation', 'acq_threshold', 'num_points']\n",
      "qubit.pulse_compensation: ['max_compensation_amp', 'time_grid', 'sampling_rate']\n",
      "qubit.ports: ['microwave', 'flux', 'readout']\n",
      "qubit.clock_freqs: ['f01', 'f12', 'readout']\n"
     ]
    }
   ],
   "source": [
    "qubit.clock_freqs.f01(6e9)\n",
    "\n",
    "print(list(qubit.submodules.keys()))\n",
    "print()\n",
    "for submodule_name, submodule in qubit.submodules.items():\n",
    "    print(f\"{qubit.name}.{submodule_name}: {list(submodule.parameters.keys())}\")\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "09c5e667",
   "metadata": {},
   "source": [
    "The device configuration is now simply obtained using {code}`dut.generate_device_config()`.\n",
    "In order for this command to provide a correct device configuration, the different properties need to be set to applicable values in the {class}`~quantify_scheduler.device_under_test.transmon_element.BasicTransmonElement` and {class}`~quantify_scheduler.device_under_test.quantum_device.QuantumDevice` objects."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "id": "314274d0",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "DeviceCompilationConfig(clocks={'qubit.01': 6000000000.0, 'qubit.12': nan, 'qubit.ro': nan}, elements={'qubit': {'reset': OperationCompilationConfig(factory_func=<class 'quantify_scheduler.operations.pulse_library.IdlePulse'>, factory_kwargs={'duration': 0.0002}, gate_info_factory_kwargs=None), 'Rxy': OperationCompilationConfig(factory_func=<function rxy_drag_pulse at 0x7d6795339ee0>, factory_kwargs={'amp180': nan, 'motzoi': 0, 'port': 'qubit:mw', 'clock': 'qubit.01', 'duration': 2e-08, 'reference_magnitude': None}, gate_info_factory_kwargs=['theta', 'phi']), 'Rz': OperationCompilationConfig(factory_func=<function phase_shift at 0x7d67952f4280>, factory_kwargs={'clock': 'qubit.01'}, gate_info_factory_kwargs=['theta']), 'H': OperationCompilationConfig(factory_func=<function hadamard_as_y90z at 0x7d67952bedc0>, factory_kwargs={'qubit': 'qubit'}, gate_info_factory_kwargs=None), 'pulse_compensation': OperationCompilationConfig(factory_func=None, factory_kwargs={'port': 'qubit:mw', 'clock': 'qubit.01', 'max_compensation_amp': nan, 'time_grid': nan, 'sampling_rate': nan}, gate_info_factory_kwargs=None), 'measure': OperationCompilationConfig(factory_func=<function dispersive_measurement_transmon at 0x7d67952c81f0>, factory_kwargs={'port': 'qubit:res', 'clock': 'qubit.ro', 'pulse_type': 'SquarePulse', 'pulse_amp': 0.25, 'pulse_duration': 3e-07, 'acq_delay': 0, 'acq_duration': 1e-06, 'acq_channel': 0, 'acq_protocol_default': 'SSBIntegrationComplex', 'reset_clock_phase': True, 'reference_magnitude': None, 'acq_weights_a': array([], dtype=float64), 'acq_weights_b': array([], dtype=float64), 'acq_weights_sampling_rate': None, 'acq_rotation': 0, 'acq_threshold': 0, 'num_points': None, 'freq': None}, gate_info_factory_kwargs=['acq_channel_override', 'acq_index', 'bin_mode', 'acq_protocol', 'feedback_trigger_label'])}}, edges={}, scheduling_strategy='asap', compilation_passes=[SimpleNodeConfig(name='circuit_to_device', compilation_func=<function compile_circuit_to_device_with_config_validation at 0x7d677e61ab80>), SimpleNodeConfig(name='set_pulse_and_acquisition_clock', compilation_func=<function set_pulse_and_acquisition_clock at 0x7d677e61ae50>), SimpleNodeConfig(name='process_compensation_pulses', compilation_func=<function process_compensation_pulses at 0x7d677e5dc5e0>), SimpleNodeConfig(name='determine_absolute_timing', compilation_func=<function _determine_absolute_timing at 0x7d6788a43d30>)])\n"
     ]
    }
   ],
   "source": [
    "pprint(dut.generate_device_config())\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e0ab78cd",
   "metadata": {},
   "source": [
    "## Specifying pulse magnitudes\n",
    "\n",
    "```{warning}\n",
    "Please note that currently only the user interface of the reference magnitude is defined. The physical magnitude scaling has not yet been implemented in any hardware backend. Therefore, changing the reference magnitude parameter will not have any physical effect in the current version of `quantify-scheduler`.\n",
    "```\n",
    "\n",
    "In the course of a quantum experiment, we may use a variety of electronic pulses of varying amplitudes or powers. The size of the pulses can potentially vary across many orders of magnitude. Additionally, there are many ways in which we might express the magnitude of said pulses (such as amplitude in volts, current in amps or power in dBm), which we may use in different contexts. When generating arbitrary waveforms, it is typical to use a DAC with limited dynamic range, so only a limited range of pulse amplitudes may be generated electronically. Therefore, devices such as variable attenuators or amplifiers are often used to produce pulses over many different orders of magnitude. In quantify, we provide the functionality to express the absolute magnitude of pulses in a range of different units, as well as to define the amplitude of any signal produced by an arbitrary waveform generator.\n",
    "\n",
    "In the definition of any pulse operation in `quantify-scheduler`, there will typically be two parameters related to the magnitude of the pulse: the `amplitude` and the `reference_magnitude`. The `amplitude` is a unitless parameter which expresses the amplitude of the signal produced by the DAC of the signal generator, relative to the maximum output level of the DAC. The `amplitude` can vary from -1 to 1, where 1 is the maximum output level. Since `amplitude` is a relative scale, it does not express the absolute power level of the signal that reaches the device. This will be affected by a number of different variables, including any attenuation or gain that is applied to the signal after it produced by the DAC. In order to specify the magnitude of the signal in absolute terms, we have the `reference_magnitude` parameter. This provides a reference scale for the absolute magnitude of the signal when it reaches the device port in question. The reference magnitude can be specified in a number of different units: Volts, current in Amperes or power in dBm or W, depending on the physical implementation of the control pulse. The scaling is defined such that the power/amplitude of a pulse with amplitude 1 will have a value equal to the `reference_magnitude` when it reaches the port. How exactly this scaling is implemented physically will depend on the hardware backend. For example, it may be that a variable attenuation is applied to the pulse in order to scale its power to the right level. Or the gain of an amplifier will be varied. Whenever a quantify schedule is compiled, the quantify compilation backend will automatically compile all instructions necessary for all hardware instruments required to scale the pulse magnitude to the correct level.\n",
    "\n",
    "The reference magnitude and amplitude of a pulse can both be configured via QCoDeS parameters in the device element. The pulse amplitude can be configured via a standard QCoDeS parameter, for example `qubit.rxy.amp180` can be used to set the pi-pulse amplitude of an RXY operation of a transmon qubit (between -1 and 1). The reference magnitude is configured slightly differently. Because of the need to express the reference magnitude in a variety of different units in different contexts, the reference magnitude is configured via a custom QCoDeS submodule within the device element - of class {class}`~quantify_scheduler.device_under_test.transmon_element.ReferenceMagnitude`. For example, we may have the submodule `qubit.rxy.reference_magnitude`, which is used to scale the amplitudes of the aforementioned RXY pulses. The {class}`~quantify_scheduler.device_under_test.transmon_element.ReferenceMagnitude` submodule contains three parameters, one for each of the possible units which the reference magnitude may be expressed in: Volts, dBm and Amperes. Only one of these unit parameters may have a defined numerical value at any given time. That is, if `reference_magnitude.dBm` is set to a particular value, both of the other parameters will automatically be set to `nan`. This allows the reference magnitude to be uniquely defined with respect to a particular unit. The defined unit and value of reference magnitude can be inquired via the `get_val_unit` method of the submodule, which returns both the numerical value and the unit in a tuple. If all of the reference magnitude parameters are `nan`, then no reference magnitude is defined and no extra scaling will be applied to the pulse.\n",
    "\n",
    "## Mixing pulse and circuit layer operations (Chevron)\n",
    "\n",
    "As well as defining our schedules in terms of gates, we can also mix the circuit layer\n",
    "representation with pulse-level operations.\n",
    "This can be useful for experiments involving pulses not easily represented by Gates,\n",
    "such as the Chevron experiment.\n",
    "In this experiment, we want to vary the length and amplitude of a square pulse between\n",
    "X gates on a pair of qubits."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "id": "bf957892",
   "metadata": {},
   "outputs": [],
   "source": [
    "from quantify_scheduler import ClockResource, Schedule\n",
    "from quantify_scheduler.operations import Measure, Reset, SquarePulse, X, X90\n",
    "\n",
    "sched = Schedule(\"Chevron Experiment\")\n",
    "acq_idx = 0\n",
    "\n",
    "for duration in np.linspace(start=20e-9, stop=60e-9, num=6):\n",
    "    for amp in np.linspace(start=0.1, stop=1.0, num=10):\n",
    "        reset = sched.add(Reset(\"q0\", \"q1\"))\n",
    "        sched.add(X(\"q0\"), ref_op=reset, ref_pt=\"end\")  # Start at the end of the reset\n",
    "        # We specify a clock for tutorial purposes, Chevron experiments do not necessarily use modulated square pulses\n",
    "        square = sched.add(SquarePulse(amp=amp, duration=duration, port=\"q0:mw\", clock=\"q0.01\"))\n",
    "        sched.add(X90(\"q0\"), ref_op=square)  # Start at the end of the square pulse\n",
    "        sched.add(X90(\"q1\"), ref_op=square)\n",
    "        sched.add(Measure(q0, acq_index=acq_idx), label=f\"M q0 {acq_idx}\")\n",
    "        sched.add(\n",
    "            Measure(q1, acq_index=acq_idx),\n",
    "            label=f\"M q1 {acq_idx}\",\n",
    "            ref_pt=\"start\",  # Start at the same time as the other measure\n",
    "        )\n",
    "\n",
    "        acq_idx += 1\n",
    "\n",
    "\n",
    "# Specify the frequencies for the clocks; this can also be done via the DeviceElement (BasicTransmonElement) instead\n",
    "sched.add_resources([ClockResource(\"q0.01\", 6.02e9), ClockResource(\"q1.01\", 6.02e9), ClockResource(\"q0.ro\", 5.02e9), ClockResource(\"q1.ro\", 5.02e9)]) "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "id": "c592cece",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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REqC4pADAnIlxlp7VSCOEw6UwESkJFiwYEHWMJ1er7dAzQiKI+UAESkJikMOUHMyEZESaM6cOVln3Vq0aKHhf0VESpDikANUxIiIlDA7d+5kzZo1WfP9+/cPYTQiIlKUiksOUJ8YEZESZsGCBVnPo6Ki6N69+1m2FhGR4qS45AAVMSIiJUzbtm2pWrUqAF26dCmW93YREZHcFZccoOZkIiIlTKtWrVi2bBnr1q2jcePGoQ5HRESKUHHJASpiRERKoMjISFq2bBnqMEREJASKQw5QczIREREREXEVFTEiIiIiIuIqKmJERERERMRVVMSIiIiIiIirGGttqGPITVgGJSIiIiIiQWXyspGuxIiIiIiIiKuoiBEREREREVdRESMiIiIiIq6iIkZERERERFxFRYyIiIiIiLiKihgREREREXEVFTEiIiIiIuIqKmJERERERMRVVMSIiIiIiIirqIgRERERERFXUREjIiIiIiKuoiJGRERERERcRUWMiIiIiIi4iooYERERERFxFRUxIiIiIiLiKipiREqg2NhYJk2aFOowREQkBJQDpDhQESMlzr59+xg2bBh169aldOnSXHDBBXTv3p0VK1aEOrQ8ue222zDGYIwhOjqahg0b8sQTT3Dy5MlQhyYiEvaUA0SKh6hQByBS1Pr3709GRgZvv/029evXJyUlhcWLF7N///6QxpWRkUF0dHSetu3RowfTp08nPT2dTz75hLvvvptSpUoxZsyYIEcpIuJuygEixYOuxEiJcujQIZYvX86ECRO4+uqrqVevHu3atWPMmDH07dsXgM2bN9OpUyfKlClD06ZNWbhwIcYY5s2bB0BSUhLGGA4dOpR13O+//x5jDNu2bQNg//793HzzzdSuXZty5crRokUL3n//fb9YrrrqKkaMGMHIkSOpVq0a3bt3B2Dt2rX07NmTmJgYatSowa233kpqaqrfvplnD+vVq8ewYcPo1q0biYmJWccdOXKk3/YJCQncdtttuX4m1lrGjx+fdVayVq1a3HvvvVnr09PTeeCBB6hduzbly5enffv2JCUl5eNTFxEJD8oBp1MOELdSESMlSkxMDDExMcybN4/09PTT1nu9Xvr160d0dDSrVq3itdde4+GHH8736xw/fpzWrVszf/581q5dy1133cWtt97KV1995bfd22+/TXR0NCtWrOC1117j0KFD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",
      "text/plain": [
       "<Figure size 1000x200 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "fig, ax = sched.plot_circuit_diagram()\n",
    "ax.set_xlim(-0.5, 9.5)\n",
    "for t in ax.texts:\n",
    "    if t.get_position()[0] > 9.5:\n",
    "        t.set_visible(False)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "db493725",
   "metadata": {},
   "source": [
    "This example shows that we add gates using the same interface as pulses. Gates are Operations, and\n",
    "as such support the same timing and reference operators as Pulses.\n",
    "\n",
    "\n",
    "## Device and Hardware compilation combined: Serial Compiler\n",
    "\n",
    "{class}`~quantify_scheduler.backends.graph_compilation.SerialCompiler` can be used to execute the device and hardware compilation separately, or execute both in one call. Here we will not set the hardware configuration thus only executing device compilation. The {ref}`Compiling to Hardware <sec-tutorial-compiling>` tutorial demonstrates how to set the hardware configuration.\n",
    "\n",
    "{class}`~quantify_scheduler.backends.graph_compilation.SerialCompiler` requires a {class}`~quantify_scheduler.backends.graph_compilation.CompilationConfig` and this holds both the device and hardware configurations (when set). In the example below, we generate a {class}`~quantify_scheduler.backends.graph_compilation.CompilationConfig` via  {meth}`~quantify_scheduler.device_under_test.quantum_device.QuantumDevice.generate_compilation_config` of {class}`~quantify_scheduler.device_under_test.quantum_device.QuantumDevice`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "id": "0c4cada5",
   "metadata": {},
   "outputs": [],
   "source": [
    "from quantify_scheduler import BasicTransmonElement, QuantumDevice, SerialCompiler\n",
    "\n",
    "dut.close()\n",
    "dut = QuantumDevice(\"DUT\")\n",
    "q0 = BasicTransmonElement(\"q0\")\n",
    "q1 = BasicTransmonElement(\"q1\")\n",
    "dut.add_element(q0)\n",
    "dut.add_element(q1)\n",
    "dut.get_element(\"q0\").rxy.amp180(0.65)\n",
    "dut.get_element(\"q1\").rxy.amp180(0.55)\n",
    "dut.get_element(\"q0\").measure.pulse_amp(0.28)\n",
    "dut.get_element(\"q1\").measure.pulse_amp(0.22)\n",
    "\n",
    "compiler = SerialCompiler(name='compiler')\n",
    "compiled_sched = compiler.compile(schedule=sched, config=dut.generate_compilation_config())"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "02f6e534",
   "metadata": {},
   "source": [
    "So, finally, we can show the timing table associated with the Chevron schedule and plot\n",
    "its pulse diagram:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "id": "751efb0e",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<style type=\"text/css\">\n",
       "</style>\n",
       "<table id=\"T_c8431\">\n",
       "  <thead>\n",
       "    <tr>\n",
       "      <th class=\"blank level0\" >&nbsp;</th>\n",
       "      <th id=\"T_c8431_level0_col1\" class=\"col_heading level0 col1\" >port</th>\n",
       "      <th id=\"T_c8431_level0_col2\" class=\"col_heading level0 col2\" >clock</th>\n",
       "      <th id=\"T_c8431_level0_col3\" class=\"col_heading level0 col3\" >abs_time</th>\n",
       "      <th id=\"T_c8431_level0_col4\" class=\"col_heading level0 col4\" >duration</th>\n",
       "      <th id=\"T_c8431_level0_col5\" class=\"col_heading level0 col5\" >is_acquisition</th>\n",
       "      <th id=\"T_c8431_level0_col6\" class=\"col_heading level0 col6\" >operation</th>\n",
       "      <th id=\"T_c8431_level0_col7\" class=\"col_heading level0 col7\" >wf_idx</th>\n",
       "      <th id=\"T_c8431_level0_col8\" class=\"col_heading level0 col8\" >operation_hash</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th id=\"T_c8431_level0_row0\" class=\"row_heading level0 row0\" >0</th>\n",
       "      <td id=\"T_c8431_row0_col1\" class=\"data row0 col1\" >None</td>\n",
       "      <td id=\"T_c8431_row0_col2\" class=\"data row0 col2\" >cl0.baseband</td>\n",
       "      <td id=\"T_c8431_row0_col3\" class=\"data row0 col3\" >0.0 ns</td>\n",
       "      <td id=\"T_c8431_row0_col4\" class=\"data row0 col4\" >200,000.0 ns</td>\n",
       "      <td id=\"T_c8431_row0_col5\" class=\"data row0 col5\" >False</td>\n",
       "      <td id=\"T_c8431_row0_col6\" class=\"data row0 col6\" >Reset('q0','q1')</td>\n",
       "      <td id=\"T_c8431_row0_col7\" class=\"data row0 col7\" >0</td>\n",
       "      <td id=\"T_c8431_row0_col8\" class=\"data row0 col8\" >-3941754483174485827</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th id=\"T_c8431_level0_row1\" class=\"row_heading level0 row1\" >1</th>\n",
       "      <td id=\"T_c8431_row1_col1\" class=\"data row1 col1\" >None</td>\n",
       "      <td id=\"T_c8431_row1_col2\" class=\"data row1 col2\" >cl0.baseband</td>\n",
       "      <td id=\"T_c8431_row1_col3\" class=\"data row1 col3\" >0.0 ns</td>\n",
       "      <td id=\"T_c8431_row1_col4\" class=\"data row1 col4\" >200,000.0 ns</td>\n",
       "      <td id=\"T_c8431_row1_col5\" class=\"data row1 col5\" >False</td>\n",
       "      <td id=\"T_c8431_row1_col6\" class=\"data row1 col6\" >Reset('q0','q1')</td>\n",
       "      <td id=\"T_c8431_row1_col7\" class=\"data row1 col7\" >1</td>\n",
       "      <td id=\"T_c8431_row1_col8\" class=\"data row1 col8\" >-3941754483174485827</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th id=\"T_c8431_level0_row2\" class=\"row_heading level0 row2\" >2</th>\n",
       "      <td id=\"T_c8431_row2_col1\" class=\"data row2 col1\" >q0:mw</td>\n",
       "      <td id=\"T_c8431_row2_col2\" class=\"data row2 col2\" >q0.01</td>\n",
       "      <td id=\"T_c8431_row2_col3\" class=\"data row2 col3\" >200,000.0 ns</td>\n",
       "      <td id=\"T_c8431_row2_col4\" class=\"data row2 col4\" >20.0 ns</td>\n",
       "      <td id=\"T_c8431_row2_col5\" class=\"data row2 col5\" >False</td>\n",
       "      <td id=\"T_c8431_row2_col6\" class=\"data row2 col6\" >X(qubit='q0')</td>\n",
       "      <td id=\"T_c8431_row2_col7\" class=\"data row2 col7\" >0</td>\n",
       "      <td id=\"T_c8431_row2_col8\" class=\"data row2 col8\" >5780733487522084625</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th id=\"T_c8431_level0_row3\" class=\"row_heading level0 row3\" >3</th>\n",
       "      <td id=\"T_c8431_row3_col1\" class=\"data row3 col1\" >q0:mw</td>\n",
       "      <td id=\"T_c8431_row3_col2\" class=\"data row3 col2\" >q0.01</td>\n",
       "      <td id=\"T_c8431_row3_col3\" class=\"data row3 col3\" >200,020.0 ns</td>\n",
       "      <td id=\"T_c8431_row3_col4\" class=\"data row3 col4\" >20.0 ns</td>\n",
       "      <td id=\"T_c8431_row3_col5\" class=\"data row3 col5\" >False</td>\n",
       "      <td id=\"T_c8431_row3_col6\" class=\"data row3 col6\" >SquarePulse(amp=0.1,duration=2e-08,port='q0:mw',clock='q0.01',reference_magnitude=None,t0=0)</td>\n",
       "      <td id=\"T_c8431_row3_col7\" class=\"data row3 col7\" >0</td>\n",
       "      <td id=\"T_c8431_row3_col8\" class=\"data row3 col8\" >-8676569594798655100</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th id=\"T_c8431_level0_row4\" class=\"row_heading level0 row4\" >4</th>\n",
       "      <td id=\"T_c8431_row4_col1\" class=\"data row4 col1\" >q0:mw</td>\n",
       "      <td id=\"T_c8431_row4_col2\" class=\"data row4 col2\" >q0.01</td>\n",
       "      <td id=\"T_c8431_row4_col3\" class=\"data row4 col3\" >200,040.0 ns</td>\n",
       "      <td id=\"T_c8431_row4_col4\" class=\"data row4 col4\" >20.0 ns</td>\n",
       "      <td id=\"T_c8431_row4_col5\" class=\"data row4 col5\" >False</td>\n",
       "      <td id=\"T_c8431_row4_col6\" class=\"data row4 col6\" >X90(qubit='q0')</td>\n",
       "      <td id=\"T_c8431_row4_col7\" class=\"data row4 col7\" >0</td>\n",
       "      <td id=\"T_c8431_row4_col8\" class=\"data row4 col8\" >6494696150505104553</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th id=\"T_c8431_level0_row5\" class=\"row_heading level0 row5\" >5</th>\n",
       "      <td id=\"T_c8431_row5_col1\" class=\"data row5 col1\" >q1:mw</td>\n",
       "      <td id=\"T_c8431_row5_col2\" class=\"data row5 col2\" >q1.01</td>\n",
       "      <td id=\"T_c8431_row5_col3\" class=\"data row5 col3\" >200,040.0 ns</td>\n",
       "      <td id=\"T_c8431_row5_col4\" class=\"data row5 col4\" >20.0 ns</td>\n",
       "      <td id=\"T_c8431_row5_col5\" class=\"data row5 col5\" >False</td>\n",
       "      <td id=\"T_c8431_row5_col6\" class=\"data row5 col6\" >X90(qubit='q1')</td>\n",
       "      <td id=\"T_c8431_row5_col7\" class=\"data row5 col7\" >0</td>\n",
       "      <td id=\"T_c8431_row5_col8\" class=\"data row5 col8\" >-3704365720677669505</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n"
      ],
      "text/plain": [
       "<pandas.io.formats.style.Styler at 0x7d677d577e80>"
      ]
     },
     "execution_count": 22,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "compiled_sched.timing_table.hide(slice(11, None), axis=\"index\").hide(\n",
    "    \"waveform_op_id\", axis=\"columns\"\n",
    ")\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "id": "f8c6a6dc",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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doiIyESv18NgMFR/oQ0KCwvRp08fvPXWW3a9ryti2HERt041L2I3FhFRvRQfH4+pU6di6tSpCAgIQEhICF555RWY77t948YNJCYmokmTJvD29sbgwYNx9uxZ+fzatWsRGBiIjRs3IjY2Fh4eHpgwYQLWrVuH77//HpIkQZKkSldFLiwsRGJiInx9fREREYFFixYhPj4e06dPl68ZO3Ys5syZg4SEBKufzdSuH374ATExMfD29sbDDz+MoqIirFu3Di1btkSTJk3w7LPPQq83/kf7+++/j06dOsn32LBhAyRJwsqVK+VjCQkJePnll61uh62cHnYuXryIxx57DMHBwfDy8kLnzp1x4MAB+bwQAnPmzEFERAS8vLyQkJBg8QsBANevX8eYMWPg7++PwMBATJw4EQUFBY5+lFoxVXIkyfi6WMvKDhGRBSEATaFzvsyCijXWrVsHNzc37Nu3D++99x7effddrFq1Sj4/fvx4HDhwABs3bkRqaiqEELj//vuh1Wrla4qKivDWW29h1apVOHnyJJYuXYpHHnkEgwYNwuXLl3H58mXcddddFX7+zJkzkZKSgu+//x7btm1DcnIyDh06ZPO3fPz48YiPj7c4VlRUhKVLl+Lrr7/Gli1bkJycjL///e/YtGkTNm3ahM8++wwffvgh/vOf/wAA+vbti1OnTuHKlSsAgJSUFISEhMhBTavVIjU1tdzn2JNT98a6ceMG7r77btx3333YvHkzmjZtirNnz6JJkybyNQsXLsTSpUuxbt06tGrVCq+88goGDhyIU6dOyVu9jxkzBpcvX8b27duh1Wrx+OOPY9KkSfjyyy+d9Wg2M1V2/D3dkVesRTG7sYiILGmLgPmRzvnsly4BKh+rL4+KisLixYshSRJiYmJw/PhxLF68GElJSTh79iw2btyIX3/9VQ4rX3zxBaKiorBhwwaMHDkSgDEErFixAl27dpXv6+XlBbVajfDw8Eo/u6CgAKtXr8bnn3+O/v37AzCGr+bNm9v82BEREeW6z7RaLT744AO0adMGAPDwww/js88+Q3Z2Nnx9fREbG4v77rsPu3btwqOPPopOnTohKCgIKSkpePjhh5GcnIznn38e7733HgBg37590Gq1lQY3e3BqZeett95CVFQU1qxZgzvvvBOtWrXCgAED5G+gEAJLlizByy+/jGHDhqFLly749NNP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",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "f, ax = compiled_sched.plot_pulse_diagram(x_range=(200e-6, 200.4e-6))"
   ]
  }
 ],
 "metadata": {
  "file_format": "mystnb",
  "kernelspec": {
   "display_name": "python3",
   "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.9.20"
  },
  "mystnb": {
   "execution_timeout": 120
  },
  "source_map": [
   8,
   38,
   47,
   53,
   60,
   73,
   81,
   106,
   129,
   144,
   153,
   162,
   167,
   171,
   175,
   188,
   195,
   200,
   203,
   210,
   213,
   218,
   223,
   227,
   233,
   238,
   242,
   246,
   249,
   267,
   280,
   284,
   292,
   297,
   300,
   323,
   352,
   359,
   371,
   387,
   392,
   399
  ]
 },
 "nbformat": 4,
 "nbformat_minor": 5
}