{ "cells": [ { "cell_type": "markdown", "source": [ "# Pulses" ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "ZPGenerator is a time-dynamic simulation framework, meaning that sources are time-evolving quantum systems. Capturing the quantum time dynamics in this way is necessary to explore how errors will arise in an information processing setting. This is very similar to how errors in stationary qubits, like superconducting circuits, arise due to the finite pulse shapes used to implement gates.\n", "\n", "Control pulses are created using the Pulse factory class. Let's take a look at some of the basic features of this class." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 2, "outputs": [], "source": [ "from zpgenerator import *" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T20:46:05.715501Z", "start_time": "2024-02-08T20:46:05.713040Z" } } }, { "cell_type": "markdown", "source": [ "The pulse class currently has three class methods that can be used to instantiate common pulse shapes: (1) the dirac() method, (2) the square() method, and the (3) gaussian() method." ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "## Dirac" ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "The Dirac pulse is an instantaneous pulse applied to a component at an instant in time. This is often used to explore idealised behaviour where operations are applied instantly to the quantum state of a source." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 6, "outputs": [ { "data": { "text/plain": "['area', 'delay', 'phase']" }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "instant_pulse = Pulse.dirac()\n", "instant_pulse.parameters" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T20:48:09.463761Z", "start_time": "2024-02-08T20:48:09.458179Z" } } }, { "cell_type": "markdown", "source": [ "The Dirac pulse has three parameters. The 'area' is the integrated area of the pulse, determining how strongly the pulse interacts with the system; the 'delay' parameter determines the instant that pulse interacts with the system; and the 'phase' parameter determines the complex phase of the pulse amplitude." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 7, "outputs": [ { "data": { "text/plain": "{'area': 3.141592653589793, 'phase': 0, 'delay': 0}" }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "instant_pulse.default_parameters" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T20:48:20.659035Z", "start_time": "2024-02-08T20:48:20.653910Z" } } }, { "cell_type": "markdown", "source": [ "By default, the Dirac pulse arrives at time $t=0$ with a phase of 0 and an integrated area of $\\pi$. This type of pulse would instantaneously invert a two-level emitter." ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "## Square" ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "The square pulse is a pulse with a constant amplitude during a specified interval of time. This is often the first generalisation taken to mimic a realistic pulse because it allows for emission to occur during the pulse timescale, which can cause errors to arise relative to an ideal protocol." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 16, "outputs": [ { "data": { "text/plain": "{'width': 0.1, 'area': 3.141592653589793, 'phase': 0, 'delay': 0}" }, "execution_count": 16, "metadata": {}, "output_type": "execute_result" } ], "source": [ "square_pulse = Pulse.square()\n", "square_pulse.default_parameters" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T20:57:37.314616Z", "start_time": "2024-02-08T20:57:37.309876Z" } } }, { "cell_type": "markdown", "source": [ "In addition to the three parameters seen for the Dirac pulse, we also have a 'width' parameter. Thus, the pulse will begin at 'delay' - 'width'/2 and end at time 'delay' + 'width'/2. For the default values, this corresponds to time $t=-0.05$ until time $t=0.05$.\n", "\n", "For non-instantaneous pulses, we can visualise their shapes easily using the plot().show() method that calls matplotlib." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 17, "outputs": [ { "data": { "text/plain": "
", "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjIAAAG0CAYAAAAozc0BAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy88F64QAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9OElEQVR4nO3deXwU9f3H8fcm5DQkgQAJkSAgiAc3FowHIkQCtSBKreIBWItXQAURTVUQpAa1FaoFrJRDaxFFBQ8UiiiIEkBuEMwPKAIKAYsk4Uww+f7+sDuwkoTsldnNvp6Pxz5kZ2dnP8P6Hd77ne93xmGMMQIAAAhCYXYXAAAA4CmCDAAACFoEGQAAELQIMgAAIGgRZAAAQNAiyAAAgKBFkAEAAEGLIAMAAIJWLbsL8LeysjLt3btXtWvXlsPhsLscAABQBcYYHT58WKmpqQoLq7jfpcYHmb179yotLc3uMgAAgAf27NmjRo0aVfh6jQ8ytWvXlvTzX0R8fLzN1QAAgKooKipSWlqa9e94RWp8kHGeToqPjyfIAAAQZM42LITBvgAAIGgRZAAAQNAiyAAAgKBV48fIAADgK6WlpTp58qTdZdQI4eHhqlWrlteXRiHIAABQBUeOHNF3330nY4zdpdQYsbGxatiwoSIjIz3eBkEGAICzKC0t1XfffafY2FjVr1+fC6x6yRijkpIS/fDDD9q5c6datGhR6UXvKkOQAQDgLE6ePCljjOrXr6+YmBi7y6kRYmJiFBERoV27dqmkpETR0dEebYfBvgAAVBE9Mb7laS+MyzZ8UAcAAIAtCDIAACBoEWQAAEC5mjRpookTJ9pdRqUIMgAA1FCDBg2Sw+GQw+FQZGSkmjdvrrFjx+qnn36yuzSfYdYSQtZ3h47p7TXf6WRpmd2lACErPjpCt3ZurNrREXaXUmP17NlTM2bMUHFxsT766CNlZWUpIiJC2dnZdpfmEwQZhKwJi7bpnbXf2V0GEPIia4Xpziua2l2GW4wxOn6y1JbPjokId2v2VFRUlFJSUiRJ9913n+bOnav3339fCxcuVLt27VxOHfXt21eJiYmaOXPmGdsxxmjMmDGaPn269u/fr6SkJP32t7/Viy++KEkqLi7W448/rjfeeEMFBQVq1aqVnn32WXXt2tWb3T0rggxC1uETP19m/PLzk9QypbbN1QChZ/n2g8rbf1hHTgTfaY7jJ0t18aiFtnz2lrGZio30/J/vmJgYHTx4UFFRUW6975133tGECRM0e/ZsXXLJJcrPz9eGDRus14cMGaItW7Zo9uzZSk1N1dy5c9WzZ09t2rRJLVq08LjesyHIIGQ5LzL+mzapurVzY1trAUJR9rublLf/sLjgf/Uwxmjx4sVauHChhg4dqq+++sqt9+/evVspKSnKyMhQRESEGjdurE6dOlmvzZgxQ7t371ZqaqokacSIEVqwYIFmzJihZ555xuf740SQAQDATTER4doyNtO2z3bHhx9+qLi4OJ08eVJlZWW69dZb9dRTT+m6665zazs33XSTJk6cqGbNmqlnz5769a9/rd69e6tWrVratGmTSktLdcEFF7i8p7i4WElJSW59jrsIMghZzvu+caFOwB7OtheM92B0OBxend6pTtdcc42mTJmiyMhIpaamqlatn+sOCws74waYld3ZOy0tTXl5efrkk0+0aNEi3X///Xr++ee1dOlSHTlyROHh4VqzZo3Cw12DVlxcnO936jTB8S0AfhGER0+gBjK0Rb8655xz1Lx58zOW169fX/v27bOel5aWavPmzbrmmmsq3FZMTIx69+6t3r17KysrSxdeeKE2bdqk9u3bq7S0VAcOHNBVV13ll/2oCEEGIY8OGcAetD17devWTcOHD9f8+fN1/vnn64UXXlBBQUGF68+cOVOlpaXq3LmzYmNj9frrrysmJkbnnXeekpKSdNttt2nAgAH6y1/+ovbt2+uHH37Q4sWL1aZNG7dPY7mDIIOQxaklwF7BfGqpJvj973+vDRs2aMCAAapVq5aGDRtWaW9MYmKixo8fr+HDh6u0tFStW7fWBx98YI2BmTFjhsaNG6eHH35Y33//verVq6fLLrtMv/nNb/y6HwQZAABqqPKuB+MUERGhyZMna/LkyRWu8+2331p/7tu3r/r27Vvp9saMGaMxY8Z4UKnnuEUBQpbzR6CDDm7AFs62R4cMvEGQQcj65Wh9ADahLcILtgaZKVOmqE2bNoqPj1d8fLzS09P18ccfW6+fOHFCWVlZSkpKUlxcnPr166f9+/fbWDFqJDpkAFswPg2+YGuQadSokcaPH681a9Zo9erV6tatm66//np9/fXXkqRhw4bpgw8+0Jw5c7R06VLt3btXN954o50lowbhNyAQGGiL8Iatg3179+7t8vxP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mTdvntmwYYPp06ePadq0qcv35cnfYSDsX0FBgcnIyDBvvvmm+eabb0xubq7p1KmT6dixo8t2zjvvPDN27FiX7+nIkSM+3z9/7KMxxgwcOND07NnTpf4ff/zRZTvB+h0aY844Xk6fPt04HA6zY8cOa53q+g7d3b9Vq1aZESNGmDfeeMOkpKSYCRMmeLTNqhx33UGQMcZs2bLFSDJfffWVtezjjz82DofDfP/992d9v/Mg/8sgU5XtTp482dSpU8cUFxdb6zz66KOmZcuWXu6VK0/2saCgwERERJg5c+ZYy7Zu3Wokmdzc3HLfc+DAARMREWFee+01a1lFfz++5M/9k2Tmzp1b4WePHDnSXHLJJS7Lbr75ZpOZmenh3pSvur5DY4y5//77zTXXXGM998d32KlTJ5OVlWU9Ly0tNampqSYnJ6fc9X/3u9+Z6667zmVZ586dzT333GOMMaasrMykpKSY559/3nq9oKDAREVFmTfeeMMY431bd4ev9688q1atMpLMrl27rGXnnXdeuf/A+IM/9nHgwIHm+uuvr/Aza9p3eP3115tu3bq5LKuu79Dd/TtdRTWebZueHpMqw6klSbm5uUpMTNSll15qLcvIyFBYWJhWrlzp1+3m5uaqS5cuioyMtNbJzMxUXl6eDh065PFne1LLL61Zs0YnT55URkaGtezCCy9U48aNlZubW+57XnvtNcXGxuq3v/3tGa+1a9dODRs21LXXXqsvv/zSyz1y5e/9y8rKUr169dSpUydNnz7d5bbyubm5LtuQfv4OK/o78lR1fYeSVFhYqLp1656x3FffYUlJidasWeNSV1hYmDIyMiqs62x/zzt37lR+fr7LOgkJCercubO1jr/aenXsX3kKCwvlcDiUmJjosnz8+PFKSkpS+/bt9fzzz+unn37yfGcq4M99XLJkiRo0aKCWLVvqvvvu08GDB122UVO+w/3792v+/Pm66667znjN39+hJ/vni216ekyqTI2/aWRV5Ofnq0GDBi7LatWqpbp163o1BqAq283Pz1fTpk1d1klOTrZeq1Onjsef724t5b0nMjLyjINkcnJyhe+ZNm2abr31VsXExFjLGjZsqJdfflmXXnqpiouL9Y9//ENdu3bVypUr1aFDB+927LRa/bV/Y8eOVbdu3RQbG6t///vfuv/++3XkyBE98MAD1nac39np2ygqKtLx48dd/i68UV3f4fLly/Xmm29q/vz51jJff4f//e9/VVpaWu7f2zfffFPhvpS3/ultybmssnX80dZ/yR/790snTpzQo48+qv79+7vcrO+BBx5Qhw4dVLduXS1fvlzZ2dnat2+fXnjhBS/3ypW/9rFnz5668cYb1bRpU+3YsUN//OMf1atXL+Xm5io8PLxGfYevvvqqateurRtvvNFleXV8h57sny+26ckx6WxqdJB57LHH9Oyzz1a6ztatW6upGv8IpH3Mzc3V1q1b9c9//tNlecuWLdWyZUvr+eWXX64dO3ZowoQJZ6z7S4Gwf08++aT15/bt2+vo0aN6/vnnrSDjrUDYR6fNmzfr+uuv1+jRo9WjRw9ruTffIXzv5MmT+t3vfidjjKZMmeLy2vDhw60/t2nTRpGRkbrnnnuUk5MTFJfJv+WWW6w/t27dWm3atNH555+vJUuWqHv37jZW5nvTp0/XbbfdpujoaJflwf4dVrcaHWQefvhhDRo0qNJ1mjVrppSUFGuGjdNPP/2kH3/8USkpKR5/flW2m5KScsZobefzqny2P/cxJSVFJSUlKigocEnP+/fvL/c9//jHP9SuXTt17NjxrHV36tRJX3zxxVnXC6T9c+rcubOefvppFRcXKyoqqsLvMD4+vkq9MYGyj1u2bFH37t11991364knnjhr3VX9DstTr149hYeHl/v3Vtm+VLa+87/79+9Xw4YNXdZp166dtY4/2vov+WP/nJwhZteuXfr0009demPK07lzZ/3000/69ttvXcKot/y5j6dr1qyZ6tWrp+3bt6t79+414juUpGXLlikvL09vvvnmWWvxx3foyf75YpueHncr5dHImhrGOXhs9erV1rKFCxf6bLBvZdt1DvYtKSmx1snOzvbbYF939tE5KOvtt9+2ln3zzTflDso6fPiwiYuLc5npUpmMjAxzww03eLAn5fP3/p1u3Lhxpk6dOtbzkSNHmlatWrms079/f78N9vXHPm7evNk0aNDAPPLII1Wux9vvsFOnTmbIkCHW89LSUnPuuedWOpDyN7/5jcuy9PT0Mwb7/vnPf7ZeLywsLHewr6dt3R2+3j9jjCkpKTF9+/Y1l1xyiTlw4ECV6nj99ddNWFjYGTN/fMEf+/hLe/bsMQ6Hw7z33nvGmOD/Dp0GDhx4xoyzivjrO3R3/05X2WDfyrbp6XG3MgSZ/+nZs6dp3769Wblypfniiy9MixYtXKbzfffdd6Zly5Zm5cqV1rJ9+/aZdevWmalTpxpJ5vPPPzfr1q0zBw8erPJ2CwoKTHJysrnjjjvM5s2bzezZs01sbKzfpl+7u4/33nuvady4sfn000/N6tWrTXp6uklPTz9j2//4xz9MdHR0ubNaJkyYYObNm2e2bdtmNm3aZB588EETFhZmPvnkk4Dfv/fff99MnTrVbNq0yWzbts1MnjzZxMbGmlGjRlnrOKdfP/LII2br1q1m0qRJfp1+7et93LRpk6lfv765/fbbXaZ7nv4PpT++w9mzZ5uoqCgzc+ZMs2XLFnP33XebxMREk5+fb4wx5o477jCPPfaYtf6XX35patWqZf785z+brVu3mtGjR5c7/ToxMdG89957ZuPGjeb6668vd/p1ZX+HvuLr/SspKTF9+vQxjRo1MuvXr3f5rpyzHpcvX24mTJhg1q9fb3bs2GFef/11U79+fTNgwACf758/9vHw4cNmxIgRJjc31+zcudN88sknpkOHDqZFixbmxIkT1naC9Tt0KiwsNLGxsWbKlClnfGZ1fofu7l9xcbFZt26dWbdunWnYsKEZMWKEWbdundm2bVuVt2lM1f9dqSqCzP8cPHjQ9O/f38TFxZn4+Hhz5513msOHD1uv79y500gyn332mbVs9OjRRtIZjxkzZlR5u8YYs2HDBnPllVeaqKgoc+6555rx48cHzD4eP37c3H///aZOnTomNjbW3HDDDWbfvn1nbDs9Pd3ceuut5X7us88+a84//3wTHR1t6tata7p27Wo+/fTToNi/jz/+2LRr187ExcWZc845x7Rt29a8/PLLZ1w/5bPPPjPt2rUzkZGRplmzZi7/DwT6Plb0//F5551nreOv7/Cll14yjRs3NpGRkaZTp05mxYoV1mtXX321GThwoMv6b731lrngggtMZGSkueSSS8z8+fNdXi8rKzNPPvmkSU5ONlFRUaZ79+4mLy/PZZ2qtElf8eX+Ob/b8h7O73vNmjWmc+fOJiEhwURHR5uLLrrIPPPMMy4hIJD38dixY6ZHjx6mfv36JiIiwpx33nlm8ODBLv8IGhO836HT3//+dxMTE2MKCgrOeK26v0N39q+i/wdPv27Y2bZpTNX/XakqhzGnzSMFAAAIIlxHBgAABC2CDAAACFoEGQAAELQIMgAAIGgRZAAAQNAiyAAAgKBFkAEAAEGLIAMAAIIWQQYAAAQtggwAn+jataseeughu8tw28GDB9WgQQN9++23Xm/rlltu0V/+8hfviwJQZdyiAMBZORyOSl8fPXq0HnjgAUVERKh27drVVFXlhg0bpl27dundd9+tdL3hw4fr8OHDmjp1qhYuXKiePXtWuv7ChQvVo0ePcl/bvHmzunTpop07dyohIcHj2gFUXS27CwAQ+Pbt22f9+c0339SoUaOUl5dnLYuLi1NcXJwdpVVo1apVuu666ypd59ixY5o2bZoWLlwoSerSpYvLvrZq1Ur333+/7r//fmtZ/fr1K9xeq1atdP755+v1119XVlaWl3sAoCo4tQTgrFJSUqxHQkKCHA6Hy7K4uLgzTi117dpVQ4cO1UMPPaQ6deooOTlZU6dO1dGjR3XnnXeqdu3aat68uT7++GPrPWVlZcrJyVHTpk0VExOjtm3b6u2333ar1pKSEkVERGj58uV6/PHH5XA4dNlll5W77kcffaSoqCjr9ZiYGGufSktLdfDgQV111VUu+xoeHl7p5/fu3VuzZ892q2YAniPIAPCbV199VfXq1dOqVas0dOhQ3Xfffbrpppt0+eWXa+3aterRo4fuuOMOHTt2TJKUk5Oj1157TS+//LK+/vprDRs2TLfffruWLl1a5c+sVauWvvzyS0nS+vXrtW/fPi1YsKDcdZctW6aOHTuW+9q6deskSR06dHBnl9WpUyetWrVKxcXFbr0PgGcIMgD8pm3btnriiSfUokULZWdnKzo6WvXq1dPgwYPVokULjRo1SgcPHtTGjRtVXFysZ555RtOnT1dmZqaaNWumQYMG6fbbb9ff//73Kn9mWFiY9u7dq6SkJLVt21YpKSlKTEwsd91du3YpNTW13NfWrl2rtLQ0JSUluSy/4YYbVKdOHf32t78t932pqakqKSlRfn5+lWsG4DnGyADwmzZt2lh/Dg8PV1JSklq3bm0tS05OliQdOHBA27dv17Fjx3Tttde6bKOkpETt27d363PXrVuntm3bnnW948ePKzo6utzX1q5dW25vzIMPPqjf//73evXVV8t9X0xMjCRZvUwA/IsgA8BvIiIiXJ47HA6XZc7ZUGVlZTpy5Igkaf78+Tr33HNd3hcVFeXW565fv75KQaZevXo6dOhQua+tXbtWf/jDH85Y3rVrVy1ZsqTCbf7444+SKh8UDMB3CDIAAsLFF1+sqKgo7d69W1dffbVX29q0aZP69et31vXat2+v119//Yzl//3vf7Vnzx63x8dIP0/BbtSokerVq+f2ewG4jyADICDUrl1bI0aM0LBhw1RWVqYrr7xShYWF+vLLLxUfH6+BAwdWeVtlZWXKy8vT3r17dc4551R4TZfMzExlZ2fr0KFDqlOnjrV87dq1ktwf6Cv9PIC4ouvMAPA9BvsCCBhPP/20nnzySeXk5Oiiiy5Sz549NX/+fDVt2tRaZ+bMmWe9QN+4ceM0c+ZMnXvuuRo3blyF67Vu3VodOnTQW2+95bJ83bp1Sk5OrnAgcEVOnDihefPmafDgwW69D4DnuLIvgKAyevRoLV26tNJxKu6YP3++HnnkEW3evFlhYVX7bbdkyRL97W9/O+MaN1OmTNHcuXP173//2ye1ATg7Ti0BCCoff/yx/va3v/lse9ddd522bdum77//XmlpaWddPyMjQxs2bNDRo0fVqFEjzZkzR+np6ZJ+Htz80ksv+aw2AGdHjwwAAAhajJEBAABBiyADAACCFkEGAAAELYIMAAAIWgQZAAAQtAgyAAAgaBFkAABA0CLIAACAoEWQAQAAQYsgAwAAghZBBgAABC2CDAAACFr/DxXRP6TLBB61AAAAAElFTkSuQmCC" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "square_pulse.plot(start=-0.1, end=0.1).show()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T20:57:37.805073Z", "start_time": "2024-02-08T20:57:37.732049Z" } } }, { "cell_type": "markdown", "source": [ "## Gaussian" ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "The Gaussian pulse is a much more realistic shape to model a laser pulse." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 18, "outputs": [ { "data": { "text/plain": "{'width': 0.1,\n 'area': 3.141592653589793,\n 'delay': 0,\n 'detuning': 0,\n 'phase': 0,\n 'window': 6}" }, "execution_count": 18, "metadata": {}, "output_type": "execute_result" } ], "source": [ "gaussian_pulse = Pulse.gaussian()\n", "gaussian_pulse.default_parameters" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T20:57:39.459576Z", "start_time": "2024-02-08T20:57:39.455320Z" } } }, { "cell_type": "markdown", "source": [ "In addition to the parameters already seen for the previous two pulses, we also have the 'window' parameter. This parameter is in units of the width, which is the standard deviation of the Gaussian shape. The window determines how many standard deviations to evaluate before assuming the pulse has an amplitude of exactly 0." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 19, "outputs": [ { "data": { "text/plain": "
", "image/png": "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" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "gaussian_pulse.plot().show()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T20:57:44.653803Z", "start_time": "2024-02-08T20:57:44.593634Z" } } }, { "cell_type": "markdown", "source": [ "## Custom" ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "In addition to the three basic pulse shapes, the Pulse class also allows for custom shapes to be created using the custom() method. To use this method, we simply need to provide a function f(t, args) along with an interval of time, or 'gate', over which to evaluate the function. Note that even if we do not use the args dictionary, we must always provide it as an argument. If we do use args to parameterise the pulse, we must specify a dictionary of default values using the 'parameters' keyword." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 29, "outputs": [ { "data": { "text/plain": "
", "image/png": "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QUFB53T9DB8+XPfff79+97vfqWnTpoqKitLcuXNVWFioqVOnKjg4WG3atNGXX37p/B6Hw6HZs2crMTFRAQEB6t69uz744AOXai0pKZGvr6/WrVunxx57TDabTf3796/x3C+++EJ2u935fEBAgPNnKi8vV05OjoYMGVLtZ/X29j7v+0+YMEELFixwqWYAl4agAuCivPXWW4qIiNDGjRt1//3365577tENN9yggQMHKjk5WaNHj9akSZNUVFQkSZo9e7befvttvfrqq9q5c6emT5+uW2+9VStXrrzg9/Tx8dHatWslSVu2bFFGRoaWLFlS47mrV69W7969a3wuJSVFktSrVy9XfmT17dtXGzduVHFxsUvfB+DiEVQAXJTu3bvr8ccfV9u2bTVz5kz5+/srIiJCd955p9q2basnnnhCOTk52rZtm4qLi/Xcc8/pzTff1JgxY5SUlKTbbrtNt956q1577bULfk8vLy8dPXpU4eHh6t69u6KjoxUWFlbjuYcPH1ZMTEyNzyUnJys+Pl7h4eHVjl977bVq2rSpfv3rX9f4fTExMSopKVFmZuYF1wzg0jBGBcBF6datm/PP3t7eCg8PV9euXZ3HoqKiJEnZ2dnat2+fioqKdMUVV1R7jZKSEvXs2dOl901JSVH37t1/8bzTp0/L39+/xueSk5NrbE158MEHdfvtt+utt96q8fsCAgIkydlKBKD+EVQAXBRfX99qj202W7VjlbOJHA6HTp06JUn6/PPPFRsbW+377Ha7S++7ZcuWCwoqEREROnnyZI3PJScn64477jjn+PDhw7VixYpaX/PEiROSzj/oFkDdIqgAqHedOnWS3W5Xamqqhg0bdkmvtX37dl1//fW/eF7Pnj31zjvvnHP8+PHjSktLc3l8ilQxRTkuLk4REREufy+Ai0NQAVDvgoOD9fDDD2v69OlyOBwaPHiw8vLytHbtWoWEhGjKlCkX/FoOh0N79uzR0aNH1aRJk1rXNBkzZoxmzpypkydPqmnTps7jycnJklwfSCtVDNCtbZ0VAPWDwbQAGsQzzzyjP/3pT5o9e7Y6duyosWPH6vPPP1diYqLznPnz5//iAnTPPvus5s+fr9jYWD377LO1nte1a1f16tVL77//frXjKSkpioqKqnWgbW3OnDmjjz76SHfeeadL3wfg0rAyLQDLmDVrllauXHnecSKu+Pzzz/XII49ox44d8vK6sN/LVqxYoZdffvmcNV7mzJmjxYsX66uvvqqT2gBcGLp+AFjGl19+qZdffrnOXm/8+PH68ccflZ6ervj4+F88f9SoUdq6dasKCwsVFxenhQsXasCAAZIqBg+/9NJLdVYbgAtDiwoAALAsxqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADLIqgAAADL+v9cSMDfwg4hggAAAABJRU5ErkJggg==" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "my_pulse = Pulse.custom(shape=lambda t, args: args['a'] + args['b'] * t + args['c'] * t**2,\n", " gate=[0, 1],\n", " parameters={'a': 3, 'b': 2, 'c': 1})\n", "my_pulse.plot().show()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T21:05:17.410357Z", "start_time": "2024-02-08T21:05:17.352652Z" } } }, { "cell_type": "markdown", "source": [ "Having parameterised the pulse allows for easy modification of the pulse later on." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 33, "outputs": [ { "data": { "text/plain": "
", "image/png": "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P/xwzc9zcnICMM0SCSEaniQqQog6sbOzqzbW6XTVrl3eTWQ0GiksLARg5cqVBAUFVfs8BweHWr1ubGxsjRIVb29vLl68eM3HDh48yJ///Oerrg8ZMoQtW7Zc9zlzcnKAGxfdCiHqlyQqQogG16FDBxwcHEhKSmLw4MG39FxHjhzhjjvuuOl9Xbt25ccff7zqelZWFsnJybWuTwF1i3JwcDDe3t61/lwhRN1IoiKEaHCurq48//zzPPvssxiNRgYMGEBeXh47d+7Ezc2NadOm1fi5jEYjp06dIjU1lWbNml23p8no0aOZOXMmFy9exNPT03T94MGDQO0LaUEt0L1enxUhRMOQYlohRKN46623eP3115k3bx7t27dnzJgxrFy5koiICNM933///U0b0L399tt8//33BAUF8fbbb1/3vk6dOtGtWzd+/fXXatdjYmLw8/O7bqHt9ZSWlrJ06VIee+yxWn2eEOLWSGdaIYTZmD17Nlu3br1hnUhtrFy5khdeeIGjR4+i19fs77ItW7bw2WefXdXj5csvv2TJkiWsW7euXmITQtSMLP0IIczG6tWr+eyzz+rt+caPH8+ZM2dISUkhJCTkpvePGDGCQ4cOUVRURHBwMAsXLqRv376AWjz86aef1ltsQoiakRkVIYQQQpgtqVERQgghhNmSREUIIYQQZksSFSGEEEKYLUlUhBBCCGG2JFERQgghhNmSREUIIYQQZksSFSGEEEKYLUlUhBBCCGG2JFERQgghhNmSREUIIYQQZksSFSGEEEKYLUlUhBBCCGG2/h+R0PLKtlZe7wAAAABJRU5ErkJggg==" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "my_pulse.plot(parameters={'a': 1}, label='a=1')\n", "my_pulse.plot(parameters={'a': 1, 'b': 5}, label='a=1, b=5')\n", "my_pulse.plot(parameters={'a': 2}, label='a=2').show()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T21:05:56.189788Z", "start_time": "2024-02-08T21:05:56.090461Z" } } }, { "cell_type": "markdown", "source": [ "## Pulse area" ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "The integrated area of a pulse will influence many aspects of the quantum system evolution. For this reason, it is either specified as a parameter for pre-built shapes, or one can evaluate it for custom shapes using the area() method." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 42, "outputs": [ { "data": { "text/plain": "1.9999999999999996" }, "execution_count": 42, "metadata": {}, "output_type": "execute_result" } ], "source": [ "my_pulse.area()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T21:10:36.133973Z", "start_time": "2024-02-08T21:10:36.130329Z" } } }, { "cell_type": "markdown", "source": [ "In addition, when creating a custom pulse, it is possible to have the shape be automatically normalised. When using this feature, it is best to give the shape an 'area' parameter that multiplies the entire shape, and set its default value to 1." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 43, "outputs": [ { "data": { "text/plain": "0.9999999999999998" }, "execution_count": 43, "metadata": {}, "output_type": "execute_result" } ], "source": [ "my_pulse = Pulse.custom(shape=lambda t, args: args['area'] * (args['a'] + args['b'] * t + args['c'] * t**2),\n", " gate=[0, 1],\n", " parameters={'a': 3, 'b': 2, 'c': 1, 'area': 1},\n", " auto_normalise=True)\n", "my_pulse.area()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T21:10:36.569366Z", "start_time": "2024-02-08T21:10:36.562370Z" } } }, { "cell_type": "markdown", "source": [ "The default pulse area can be updated afterward." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 44, "outputs": [ { "data": { "text/plain": "1.9999999999999996" }, "execution_count": 44, "metadata": {}, "output_type": "execute_result" } ], "source": [ "my_pulse.update_default_parameters({'area': 2})\n", "my_pulse.area()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T21:10:36.944246Z", "start_time": "2024-02-08T21:10:36.938819Z" } } }, { "cell_type": "markdown", "source": [ "## Sequences" ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [ "Most often, pulses need to be combined into pulse sequences to control a quantum system. Alternatively, more complex shapes might be most easily constructed by summing together multiple basic shapes. In either case, the Pulse class also serves as a way to collect and organise multiple pulses into one object.\n", "\n", "As a simple example, we can add together some of the pulses we built earlier and then visualise the new composite pulse using the plot() method." ], "metadata": { "collapsed": false } }, { "cell_type": "code", "execution_count": 64, "outputs": [ { "data": { "text/plain": "
", "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjIAAAG0CAYAAAAozc0BAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy88F64QAAAACXBIWXMAAA9hAAAPYQGoP6dpAAB740lEQVR4nO3dd3zU9f3A8df3Lpe99yYJe4Y9K2JBERW1tXVRi1onOBEHLW4FbdWiFrX6q6vV4gKlDhwoikzZO4zsRfaed/f9/XHckUASkpC7793l/Xw8ribf+f5ew+Wdz+f9+XwUVVVVhBBCCCFckE7rAIQQQgghuksSGSGEEEK4LElkhBBCCOGyJJERQgghhMuSREYIIYQQLksSGSGEEEK4LElkhBBCCOGyJJERQgghhMvy0DoAezObzeTn5xMQEICiKFqHI4QQQohOUFWV6upqYmNj0enab3dx+0QmPz+fhIQErcMQQgghRDfk5OQQHx/f7n63T2QCAgIAyxsRGBiocTRCCCGE6IyqqioSEhJsv8fb4/aJjLU7KTAwUBIZIYQQwsWcqSxEin2FEEII4bIkkRFCCCGEy5JERgghhBAuy+1rZIQQwlWpqorRaMRkMmkdihA9Tq/X4+HhcdZTo0giI4QQTqipqYmCggLq6uq0DkUIu/H19SUmJgZPT89uX0MSGSGEcDJms5mMjAz0ej2xsbF4enrKhJ7CraiqSlNTE8XFxWRkZNC/f/8OJ73riCQyQgjhZJqamjCbzSQkJODr66t1OELYhY+PDwaDgaysLJqamvD29u7WdTQt9v3pp5+YPXs2sbGxKIrCp59+2u6xt912G4qisGzZMofFJ4QQWuruX6hCuIqe+BnX9F9JbW0tqampLF++vMPjVq1axebNm4mNjXVQZEIIIYRwBZp2Lc2aNYtZs2Z1eExeXh533nknX3/9NRdffLGDIhNCCCGEK3Dqdkuz2cx1113H/fffz9ChQ7UORwghhBt4++23CQ4O1joM0UOcOpF59tln8fDw4K677ur0OY2NjVRVVbV6CSGEcJzCwkLuvvtu+vXrh7e3N1FRUUyZMoVXX33VKYaTX3XVVRw+fFjrMEQPcdpRS9u3b+fFF19kx44dXRp2uHTpUh5//HE7RiaE6/gi/Quqm6r5deKvifSN1Doc0Qukp6czZcoUgoODWbJkCcOHD8fLy4u9e/fy+uuvExcXx6WXXqppjD4+Pvj4+Ggag+g5Ttsis379eoqKikhMTMTDwwMPDw+ysrK47777SEpKave8RYsWUVlZaXvl5OQ4LmghnMiximM8tP4hnt7yNBd+ciHvHXxP65BEN6mqSl2TUZOXqqpdinXevHl4eHiwbds2rrzySgYPHkxKSgqXXXYZX3zxBbNnzwbghRdeYPjw4fj5+ZGQkMC8efOoqamxXeexxx5j5MiRra69bNmyVp//69atY/z48fj5+REcHMyUKVPIysoCYPfu3Zx33nkEBAQQGBjImDFj2LZtG3B619KxY8e47LLLiIqKwt/fn3HjxvHdd9+1undSUhJLlizhxhtvJCAggMTERF5//fUuvTfCPpy2Rea6665jxowZrbbNnDmT6667jhtuuKHd87y8vPDy8rJ3eEI4vfKGctvXzeZmntn6DPXGem4afpOGUYnuqG82MeSRrzW594EnZuLr2blfFaWlpXzzzTcsWbIEPz+/No+xtrDrdDpeeuklkpOTSU9PZ968eTzwwAO88sornbqX0Wjk8ssv5+abb+a///0vTU1NbN261Xb9OXPmMGrUKF599VX0ej27du3CYDC0ea2amhouuuginn76aby8vHj33XeZPXs2aWlpJCYm2o57/vnnefLJJ/nzn//Mxx9/zO233865557LwIEDOxWzsA9NE5mamhqOHj1q+z4jI4Ndu3YRGhpKYmIiYWFhrY43GAxER0fLD40QndBsbgagf0h/Lkq+iBd3vMiLO15kUOggfhX3K42jE+7o6NGjqKp62md0eHg4DQ0NAMyfP59nn32We+65x7Y/KSmJp556ittuu63TiUxVVRWVlZVccskl9O3bF4DBgwfb9mdnZ3P//fczaNAgAPr379/utVJTU0lNTbV9/+STT7Jq1SpWr17NHXfcYdt+0UUXMW/ePAAefPBB/v73v/PDDz/I7ySNaZrIbNu2jfPOO8/2/YIFCwCYO3cub7/9tkZRCeEerImMQWfgpuE3UVhbyAdpH/DU5qf49LJP8fbo3iyawvF8DHoOPDFTs3ufra1bt2I2m5kzZw6NjY0AfPfddyxdupRDhw5RVVWF0WikoaGBurq6Ts1mHBoayvXXX8/MmTM5//zzmTFjBldeeSUxMTGA5ffJTTfdxL///W9mzJjB73//e1vCc6qamhoee+wxvvji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E6PRyOWXX865557Lnj172LRpE7fccovtHnPmzCE+Pp5ffvmF7du389BDD2EwtL1cR01NDRdddBFr165l586dXHjhhcyePZvs7OxWxz3//POMHTuWnTt3Mm/ePG6//XbS0uzz76OsrIw1a9a0+352pcbn4Ycf5sCBA3z11VccPHiQV199lfDwcAC2bt0KwHfffUdBQQErV64E4MUXX+T555/nueeeY8+ePcycOZNLL72UI0eOtLr2o48+yuLFi9mxYwceHh5ce+21PPDAA7z44ousX7+eo0eP8sgjj3TzXeiczs9dbgc//fQTf/vb39i+fTsFBQWsWrWKyy+/HIDm5mYWL17Ml19+SXp6OkFBQcyYMYNnnnmG2NhYLcMWwmmsPPoxAAP8phPo7dupc3Q6hTkTElny5SE+3JbDNeMT2zxucOhgjtcd51DZIcZEjemxmEXX1RvrmfD+BE3uveXaLfgazvyzdfToUVRVZeDAga22h4eH09DQAMD8+fN59tlnAbjnnntsxyQlJfHUU09x22238corr3QqrqqqKiorK7nkkkvo29fSyjh48GDb/uzsbO6//34GDbLUhfXv37/da6WmppKammr7/sknn2TVqlWsXr2aO+64w7b9oosuYt68eQA8+OCD/P3vf+eHH3447Zl7gvX9tMZ/NrKzsxk1ahRjx44FaNWqFRERAUBYWBjR0dG27c899xwPPvggV199NQDPPvssP/zwA8uWLWP58uW24xYuXMjMmTMBuPvuu7nmmmtYu3YtU6ZMAeBPf/pTl7rTukPTFpna2lpSU1NbvSlWdXV17Nixg4cffpgdO3awcuVK0tLSuPTSSzWIVAjnk11eTKnZUsNy6+iru3Tu5aPi0CmwM7uCrNLaNo8ZFGb5AD1QeuDsAhW92tatW9m1axdDhw6lsbHRtv27775j+vTpxMXFERAQwHXXXUdpaWmnC4JDQ0O5/vrrmTlzJrNnz+bFF1+koKDAtn/BggXcdNNNtj+Ajx071u61ampqWLhwIYMHDyY4OBh/f38OHjx4WovMiBEjbF8rikJ0dDRFRUXtXnfJkiX4+/vbXuvXr+e2225rte3Ue1j15KKtt99+OytWrGDkyJE88MADbNy4scPjq6qqyM/PtyUjVlOmTOHgwYOttrV8T6KiLK24w4cPb7Wto/eoJ2jaIjNr1ixmzZrV5r6g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UFBQt2MXQnSeh9YBCCGcX0FBge3rDz74gEceeYS0tDTbNn9/f/z9/bUIrV1bt27l4osv7vCYuro6/vWvf/H1118DMHXq1FbPOmzYMObNm8e8efNs2yIiItq93rBhw+jbty//+c9/mD9//lk+gRCiM6RrSQhxRtHR0bZXUFAQiqK02ubv739a19K0adO48847ueeeewgJCSEqKoo33niD2tpabrjhBgICAujXrx9fffWV7Ryz2czSpUtJTk7Gx8eH1NRUPv744y7F2tTUhMFgYOPGjfzlL39BURQmTpzY5rFffvklXl5etv0+Pj62ZzKZTJSWlnLOOee0ela9Xt/h/WfPns2KFSu6FLMQovskkRFC2M0777xDeHg4W7du5c477+T222/n97//PZMnT2bHjh1ccMEFXHfdddTV1QGwdOlS3n33XV577TX279/Pvffeyx/+8Ad+/PHHTt/Tw8ODDRs2ALBr1y4KCgpYs2ZNm8euX7+eMWPGtLlv586dAIwePborj8z48ePZunUrjY2NXTpPCNE9ksgIIewmNTWVxYsX079/fxYtWoS3tzfh4eHcfPPN9O/fn0ceeYTS0lL27NlDY2MjS5Ys4c0332TmzJmkpKRw/fXX84c//IF//vOfnb6nTqcjPz+fsLAwUlNTiY6OJjg4uM1js7KyiI2NbXPfjh07SEhIICwsrNX23/zmN4SEhPC73/2uzfNiY2NpamqisLCw0zELIbpPamSEEHYzYsQI29d6vZ6wsDCGDx9u2xYVFQVAUVERR48epa6ujvPPP7/VNZqamhg1alSX7rtz505SU1PPeFx9fT3e3t5t7tuxY0ebrTF33303N954I++8806b5/n4+ADYWpmEEPYliYwQwm4MBkOr7xVFabXNOhrKbDZTU1MDwBdffEFcXFyr87y8vLp03127dnUqkQkPD6e8vLzNfTt27OCmm246bfu0adNYt25du9csKysDOi4KFkL0HElkhBBOYciQIXh5eZGdnc255557Vtfau3cvV1xxxRmPGzVqFP/5z39O215SUkJOTk6X62PAMgQ7Pj6e8PDwLp8rhOg6SWSEEE4hICCAhQsXcu+992I2m/nVr35FZWUlGzZsIDAwkLlz53b6WmazmbS0NPLz8/Hz82t3TpeZM2eyaNEiysvLCQkJsW3fsWMH0PVCX7AUELc3z4wQoudJsa8Qwmk8+eSTPPzwwyxdupTBgwdz4YUX8sUXX5CcnGw75u233z7jBH1PPfUUb7/9NnFxcTz11FPtHjd8+HBGjx7Nhx9+2Gr7zp07iYqKarcQuD0NDQ18+umn3HzzzV06TwjRfTKzrxDCpTz66KP8+OOPHdapdMUXX3zB/fffz759+9DpOve33bp16/jHP/5x2hw3r776KqtWreKbb77pkdiEEGcmXUtCCJfy1Vdf8Y9//KPHrnfxxRdz5MgR8vLySEhIOOPxM2bMYPfu3dTW1hIfH89HH33EpEmTAEtx88svv9xjsQkhzkxaZIQQQgjhsqRGRgghhBAuSxIZIYQQQrgsSWSEEEII4bIkkRFCCCGEy5JERgghhBAuSxIZIYQQQrgsSWSEEEII4bIkkRFCCCGEy5JERgghhBAuSxIZIYQQQrgsSWSEEEII4bIkkRFCCCGEy/p/+1mCOIs+eg8AAAAASUVORK5CYII=" }, "metadata": {}, "output_type": "display_data" } ], "source": [ "sequence = Pulse()\n", "sequence.add(gaussian_pulse)\n", "sequence.add(my_pulse)\n", "\n", "gaussian_pulse.plot(label='Gaussian')\n", "my_pulse.plot(label='Custom')\n", "sequence.plot(label='Gaussian + Custom').show()" ], "metadata": { "collapsed": false, "ExecuteTime": { "end_time": "2024-02-08T21:17:18.160574Z", "start_time": "2024-02-08T21:17:18.092128Z" } } }, { "cell_type": "markdown", "source": [ "Combined with parameter namespaces (see [Parameters](parameters.ipynb)), pulse sequences are extremely useful for manipulating the parameters of large sequences of pulses. See also the [Pulsed Sources](pulsed_sources.ipynb) tutorial for a detailed introduction to using the Pulse class along with the Source class to produce light with different characteristics." ], "metadata": { "collapsed": false } }, { "cell_type": "markdown", "source": [], "metadata": { "collapsed": false } } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 2 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython2", "version": "2.7.6" } }, "nbformat": 4, "nbformat_minor": 0 }