{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "67b87b66",
   "metadata": {},
   "source": [
    "# Quick Start"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ceb957a2d72e49ed",
   "metadata": {},
   "source": [
    "Let us create a pulse that implements a CZ gate on two atoms in the perfect Rydberg blockade regime."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "993cd5239bf336bf",
   "metadata": {
    "ExecuteTime": {
     "end_time": "2025-11-29T17:16:03.935633Z",
     "start_time": "2025-11-29T17:16:02.997193Z"
    }
   },
   "outputs": [],
   "source": [
    "# %pip install -q --progress-bar off rydopt # Uncomment for installation on Colab\n",
    "\n",
    "import rydopt as ro\n",
    "import numpy as np"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "d9820d79460ae60",
   "metadata": {},
   "source": [
    "First, we create the target gate, by specifying the gate phases, the interaction between the atoms and the Rydberg-state decay rate."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "304aeddde0908214",
   "metadata": {
    "ExecuteTime": {
     "end_time": "2025-11-29T17:16:03.941927Z",
     "start_time": "2025-11-29T17:16:03.940236Z"
    }
   },
   "outputs": [],
   "source": [
    "gate = ro.gates.TwoQubitGate(phi=None, theta=np.pi, Vnn=float(\"inf\"), decay=0.0)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "3614e8b18eb99467",
   "metadata": {},
   "source": [
    "Then we choose a pulse ansatz that consists of a constant detuning and a sweep of the laser phase. The Rabi frequency amplitude is constant and fixed."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "51803009cfb742a8",
   "metadata": {
    "ExecuteTime": {
     "end_time": "2025-11-29T17:16:03.948572Z",
     "start_time": "2025-11-29T17:16:03.947016Z"
    }
   },
   "outputs": [],
   "source": [
    "pulse_ansatz = ro.pulses.PulseAnsatz(\n",
    "    detuning_ansatz=ro.pulses.const, phase_ansatz=ro.pulses.sin_crab\n",
    ")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "3e5480112b7a3352",
   "metadata": {},
   "source": [
    "A guess of pulse parameters can serve as input for the optimization. Here, we choose to optimize four pulse parameters."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "9cb296616a8b8649",
   "metadata": {
    "ExecuteTime": {
     "end_time": "2025-11-29T17:16:03.952967Z",
     "start_time": "2025-11-29T17:16:03.951502Z"
    }
   },
   "outputs": [],
   "source": [
    "initial_params = (7.0, [0.0], [0.0, 0.0], [])"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "f3e2471e0359cf73",
   "metadata": {},
   "source": [
    "Now, we perform the optimization, specifying a target gate infidelity (which also serves as tolerance for the differential equation solver)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "f68ae25336698ec5",
   "metadata": {
    "ExecuteTime": {
     "end_time": "2025-11-29T17:16:07.496526Z",
     "start_time": "2025-11-29T17:16:03.955934Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Started optimization using 1 process\n",
      "\n"
     ]
    },
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "2e810a679bbf4d0abf10e32716aa60a2",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "proc00:   0%|           | 0/1000 [00:00<?, ?it/s]"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "=== Optimization finished using Adam ===\n",
      "\n",
      "Duration: 8.386 seconds\n",
      "Gates with infidelity below tol=1.0e-10: 1\n",
      "\n",
      "Optimized gate:\n",
      "> infidelity <= tol\n",
      "> parameters = (7.626643597908443, [-0.03125944], [0.81977751 0.66389043], [])\n",
      "> duration = 7.626643597908443\n"
     ]
    }
   ],
   "source": [
    "opt_result = ro.optimization.optimize(gate, pulse_ansatz, initial_params, tol=1e-10)\n",
    "optimized_params = opt_result.params"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b7158c159a033f80",
   "metadata": {},
   "source": [
    "Finally, we can plot the resulting pulse."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "1dcbb0e378a481e4",
   "metadata": {
    "ExecuteTime": {
     "end_time": "2025-11-29T17:16:08.001093Z",
     "start_time": "2025-11-29T17:16:07.540615Z"
    }
   },
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "ro.characterization.plot_pulse(pulse_ansatz, optimized_params);"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.13.1"
  },
  "widgets": {
   "application/vnd.jupyter.widget-state+json": {
    "state": {
     "1abe1062e05d4382a5e7e49567965949": {
      "model_module": "@jupyter-widgets/base",
      "model_module_version": "2.0.0",
      "model_name": "LayoutModel",
      "state": {
       "flex": "2"
      }
     },
     "2e810a679bbf4d0abf10e32716aa60a2": {
      "model_module": "@jupyter-widgets/controls",
      "model_module_version": "2.0.0",
      "model_name": "HBoxModel",
      "state": {
       "children": [
        "IPY_MODEL_f0f69820e69a4aeba774df7edf942573",
        "IPY_MODEL_7995e7ba8a984230a22cd119cf8c5924",
        "IPY_MODEL_48dcc2e7d4f74916990aa98b77d778f1"
       ],
       "layout": "IPY_MODEL_8793459176ba45feb7ecaf6537ab9355"
      }
     },
     "3e643e4ffcc64f2aa0e53e0433bde4aa": {
      "model_module": "@jupyter-widgets/base",
      "model_module_version": "2.0.0",
      "model_name": "LayoutModel",
      "state": {}
     },
     "48dcc2e7d4f74916990aa98b77d778f1": {
      "model_module": "@jupyter-widgets/controls",
      "model_module_version": "2.0.0",
      "model_name": "HTMLModel",
      "state": {
       "layout": "IPY_MODEL_6d9282e02b8d4b338f5d556dcaf54561",
       "style": "IPY_MODEL_8effff66a89f4b03a832dba64ac38315",
       "value": " 1000/1000 [00:03&lt;00:00, 277.11it/s, infidelity=7.57e-11, converged=1/1]"
      }
     },
     "6d9282e02b8d4b338f5d556dcaf54561": {
      "model_module": "@jupyter-widgets/base",
      "model_module_version": "2.0.0",
      "model_name": "LayoutModel",
      "state": {}
     },
     "7995e7ba8a984230a22cd119cf8c5924": {
      "model_module": "@jupyter-widgets/controls",
      "model_module_version": "2.0.0",
      "model_name": "FloatProgressModel",
      "state": {
       "bar_style": "success",
       "layout": "IPY_MODEL_1abe1062e05d4382a5e7e49567965949",
       "max": 1000,
       "style": "IPY_MODEL_8ef1b0974ad748429e7290fd44338f01",
       "value": 1000
      }
     },
     "8793459176ba45feb7ecaf6537ab9355": {
      "model_module": "@jupyter-widgets/base",
      "model_module_version": "2.0.0",
      "model_name": "LayoutModel",
      "state": {
       "display": "inline-flex",
       "flex_flow": "row wrap",
       "width": "100%"
      }
     },
     "8ef1b0974ad748429e7290fd44338f01": {
      "model_module": "@jupyter-widgets/controls",
      "model_module_version": "2.0.0",
      "model_name": "ProgressStyleModel",
      "state": {
       "description_width": ""
      }
     },
     "8effff66a89f4b03a832dba64ac38315": {
      "model_module": "@jupyter-widgets/controls",
      "model_module_version": "2.0.0",
      "model_name": "HTMLStyleModel",
      "state": {
       "description_width": "",
       "font_size": null,
       "text_color": null
      }
     },
     "d8ed32c7c6f14c8da0b195252b452b2d": {
      "model_module": "@jupyter-widgets/controls",
      "model_module_version": "2.0.0",
      "model_name": "HTMLStyleModel",
      "state": {
       "description_width": "",
       "font_size": null,
       "text_color": null
      }
     },
     "f0f69820e69a4aeba774df7edf942573": {
      "model_module": "@jupyter-widgets/controls",
      "model_module_version": "2.0.0",
      "model_name": "HTMLModel",
      "state": {
       "layout": "IPY_MODEL_3e643e4ffcc64f2aa0e53e0433bde4aa",
       "style": "IPY_MODEL_d8ed32c7c6f14c8da0b195252b452b2d",
       "value": "proc00: 100%"
      }
     }
    },
    "version_major": 2,
    "version_minor": 0
   }
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}