{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Calculation of control fields for state-to-state transfer of a 2 qubit system using CRAB algorithm" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Jonathan Zoller (jonathan.zoller@uni-ulm.de)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Example to demonstrate using the control library to determine control\n", "pulses using the ctrlpulseoptim.optimize_pulse_unitary function.\n", "The CRAB algorithm is used to optimize pulse shapes to minimize the fidelity\n", "error, which is equivalent maximising the fidelity to an optimal value of 1.\n", "\n", "The system in this example are two qubits, where the interaction can be\n", "controlled. The target is to perform a pure state transfer from a down-down\n", "state to an up-up state.\n", "\n", "The user can experiment with the timeslicing, by means of changing the\n", "number of timeslots and/or total time for the evolution.\n", "Different initial (starting) pulse types can be tried as well as\n", "boundaries on the control and a smooth ramping of the pulse when\n", "switching the control on and off (at the beginning and close to the end).\n", "The initial and final pulses are displayed in a plot\n", "\n", "An in depth discussion of using methods of this type can be found in [1,2]" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "%matplotlib inline\n", "import numpy as np\n", "import matplotlib.pyplot as plt\n", "import datetime" ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "from qutip import Qobj, identity, sigmax, sigmaz, tensor\n", "import random\n", "import qutip.logging_utils as logging\n", "logger = logging.get_logger()\n", "#Set this to None or logging.WARN for 'quiet' execution\n", "log_level = logging.INFO\n", "#QuTiP control modules\n", "import qutip.control.pulseoptim as cpo\n", "\n", "example_name = '2qubitInteract'" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Defining the physics" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The dynamics of the system are governed by the combined Hamiltonian:\n", "H(t) = H_d + sum(u1(t)*Hc1 + u2(t)*Hc2 + ....)\n", "That is the time-dependent Hamiltonian has a constant part (called here the drift) and time vary parts, which are the control Hamiltonians scaled by some functions u_j(t) known as control amplitudes\n", "In this example we describe an Ising like Hamiltonian, encompassing random coefficients in the drift part and controlling the interaction of the qubits:\n", "\n", "$ \\hat{H} = \\sum_{i=1}^2 \\alpha_i \\sigma_x^i + \\beta_i \\sigma_z^i + u(t) \\cdot \\sigma_z \\otimes \\sigma_z $\n", "\n", "Initial $\\newcommand{\\ket}[1]{\\left|{#1}\\right\\rangle} \\ket{\\psi_0} = \\text{U_0}$ and target state $\\ket{\\psi_t} = \\text{U_targ}$ are chosen to be:\n", "\n", "$ \\ket{\\psi_0} = \\begin{pmatrix} 1 \\\\ 0 \\\\ 0 \\\\ 0 \\end{pmatrix}$\n", "\n", "$ \\ket{\\psi_t} = \\begin{pmatrix} 0 \\\\ 0 \\\\ 0 \\\\ 1 \\end{pmatrix}$" ] }, { "cell_type": "code", "execution_count": 3, "metadata": {}, "outputs": [], "source": [ "random.seed(20)\n", "alpha = [random.random(),random.random()]\n", "beta = [random.random(),random.random()]\n", "\n", "Sx = sigmax()\n", "Sz = sigmaz()\n", "\n", "H_d = (alpha[0]*tensor(Sx,identity(2)) + \n", " alpha[1]*tensor(identity(2),Sx) +\n", " beta[0]*tensor(Sz,identity(2)) +\n", " beta[1]*tensor(identity(2),Sz))\n", "H_c = [tensor(Sz,Sz)]\n", "# Number of ctrls\n", "n_ctrls = len(H_c)\n", "\n", "q1_0 = q2_0 = Qobj([[1], [0]])\n", "q1_targ = q2_targ = Qobj([[0], [1]])\n", "\n", "psi_0 = tensor(q1_0, q2_0)\n", "psi_targ = tensor(q1_targ, q2_targ)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Defining the time evolution parameters" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To solve the evolution the control amplitudes are considered constant within piecewise timeslots, hence the evolution during the timeslot can be calculated using U(t_k) = expm(-i*H(t_k)*dt). Combining these for all the timeslots gives the approximation to the evolution from an initial state $\\psi_0$ at t=0 to U(T) at the t=evo_time.\n", "The number of timeslots and evo_time have to be chosen such that the timeslot durations (dt) are small compared with the dynamics of the system." ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [], "source": [ "# Number of time slots\n", "n_ts = 100\n", "# Time allowed for the evolution\n", "evo_time = 18" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Set the conditions which will cause the pulse optimisation to terminate" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "At each iteration the fidelity of the evolution is tested by comparaing the calculated evolution U(T) with the target U_targ. For unitary systems such as this one this is typically:\n", "f = normalise(overlap(U(T), U_targ)). The maximum fidelity (for a unitary system) calculated this way would be 1, and hence the error is calculated as fid_err = 1 - fidelity. As such the optimisation is considered completed when the fid_err falls below such a target value.\n", "\n", "In some cases the optimisation either gets stuck in some local minima, or the fid_err_targ is just not achievable, therefore some limits are set to the time/effort allowed to find a solution.\n", "\n", "The algorithm uses the CRAB algorithm to determine optimized coefficients that lead to a minimal fidelity error. The underlying optimization procedure is set to be the Nelder-Mead downhill simplex. Therefore, when all vertices shrink together, the algorithm will terminate." ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [], "source": [ "# Fidelity error target\n", "fid_err_targ = 1e-3\n", "# Maximum iterations for the optisation algorithm\n", "max_iter = 500\n", "# Maximum (elapsed) time allowed in seconds\n", "max_wall_time = 120" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Set the initial pulse type" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The control amplitudes must be set to some initial values. Typically these are just random values for each control in each timeslot. These do however result in erratic optimised pulses. For this example, a solution will be found for any initial pulse, and so it can be interesting to look at the other initial pulse alternatives." ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [], "source": [ "# pulse type alternatives: RND|ZERO|LIN|SINE|SQUARE|SAW|TRIANGLE|\n", "p_type = 'DEF'" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Give an extension for output files" ] }, { "cell_type": "code", "execution_count": 7, "metadata": {}, "outputs": [], "source": [ "#Set to None to suppress output files\n", "f_ext = \"{}_n_ts{}_ptype{}.txt\".format(example_name, n_ts, p_type)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Run the optimisation" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "In this step, the actual optimization is performed. At each iteration the Nelder-Mead algorithm calculates a new set of coefficients that improves the currently worst set among all set of coefficients. For details see [1,2] and a textbook about static search methods. The algorithm continues until one of the termination conditions defined above has been reached. If undesired results are achieved, rerun the algorithm and/or try to change the number of coefficients to be optimized for, as this is a very crucial parameter." ] }, { "cell_type": "code", "execution_count": 8, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO:qutip.control.dynamics:Setting memory optimisations for level 0\n", "INFO:qutip.control.dynamics:Internal operator data type choosen to be \n", "INFO:qutip.control.dynamics:phased dynamics generator caching True\n", "INFO:qutip.control.dynamics:propagator gradient caching True\n", "INFO:qutip.control.dynamics:eigenvector adjoint caching True\n", "INFO:qutip.control.dynamics:use sparse eigen decomp False\n", "INFO:qutip.control.pulseoptim:System configuration:\n", "Drift Hamiltonian:\n", "Quantum object: dims = [[2, 2], [2, 2]], shape = (4, 4), type = oper, isherm = True\n", "Qobj data =\n", "[[ 1.67112549 0.68625416 0.90563968 0. ]\n", " [ 0.68625416 -0.13810698 0. 0.90563968]\n", " [ 0.90563968 0. 0.13810698 0.68625416]\n", " [ 0. 0.90563968 0.68625416 -1.67112549]]\n", "Control 1 Hamiltonian:\n", "Quantum object: dims = [[2, 2], [2, 2]], shape = (4, 4), type = oper, isherm = True\n", "Qobj data =\n", "[[ 1. 0. 0. 0.]\n", " [ 0. -1. 0. 0.]\n", " [ 0. 0. -1. 0.]\n", " [ 0. 0. 0. 1.]]\n", "Initial state / operator:\n", "Quantum object: dims = [[2, 2], [1, 1]], shape = (4, 1), type = ket\n", "Qobj data =\n", "[[ 1.]\n", " [ 0.]\n", " [ 0.]\n", " [ 0.]]\n", "Target state / operator:\n", "Quantum object: dims = [[2, 2], [1, 1]], shape = (4, 1), type = ket\n", "Qobj data =\n", "[[ 0.]\n", " [ 0.]\n", " [ 0.]\n", " [ 1.]]\n", "INFO:qutip.control.pulseoptim:Initial amplitudes output to file: ctrl_amps_initial_2qubitInteract_n_ts100_ptypeDEF.txt\n", "INFO:qutip.control.optimizer:Optimising pulse(s) using CRAB with 'fmin' (Nelder-Mead) method\n", "INFO:qutip.control.pulseoptim:Final amplitudes output to file: ctrl_amps_final_2qubitInteract_n_ts100_ptypeDEF.txt\n" ] } ], "source": [ "result = cpo.opt_pulse_crab_unitary(H_d, H_c, psi_0, psi_targ, n_ts, evo_time, \n", " fid_err_targ=fid_err_targ, \n", " max_iter=max_iter, max_wall_time=max_wall_time, \n", " init_coeff_scaling=5.0, num_coeffs=5, \n", " method_params={'xtol':1e-3},\n", " guess_pulse_type=None, guess_pulse_action='modulate',\n", " out_file_ext=f_ext,\n", " log_level=log_level, gen_stats=True)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Report the results" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Firstly the performace statistics are reported, which gives a breakdown of the processing times. In this example it can be seen that the majority of time is spent calculating the propagators, i.e. exponentiating the combined Hamiltonian.\n", "\n", "The optimised U(T) is reported as the 'final evolution', which is essentially the string representation of the Qobj that holds the full time evolution at the point when the optimisation is terminated.\n", "\n", "The key information is in the summary (given last). Here the final fidelity is reported and the reason for termination of the algorithm." ] }, { "cell_type": "code", "execution_count": 9, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "\n", "------------------------------------\n", "---- Control optimisation stats ----\n", "**** Timings (HH:MM:SS.US) ****\n", "Total wall time elapsed during optimisation: 0:00:05.187298\n", "Wall time computing Hamiltonians: 0:00:00.096692 (1.86%)\n", "Wall time computing propagators: 0:00:04.988672 (96.17%)\n", "Wall time computing forward propagation: 0:00:00.027030 (0.52%)\n", "Wall time computing onward propagation: 0:00:00.019223 (0.37%)\n", "Wall time computing gradient: 0:00:00 (0.00%)\n", "\n", "**** Iterations and function calls ****\n", "Number of iterations: 125\n", "Number of fidelity function calls: 192\n", "Number of times fidelity is computed: 192\n", "Number of gradient function calls: 0\n", "Number of times gradients are computed: 0\n", "Number of times timeslot evolution is recomputed: 192\n", "\n", "**** Control amplitudes ****\n", "Number of control amplitude updates: 191\n", "Mean number of updates per iteration: 1.528\n", "Number of timeslot values changed: 19099\n", "Mean number of timeslot changes per update: 99.99476439790575\n", "Number of amplitude values changed: 19099\n", "Mean number of amplitude changes per update: 99.99476439790575\n", "------------------------------------\n", "Final evolution\n", "Quantum object: dims = [[2, 2], [1, 1]], shape = (4, 1), type = ket\n", "Qobj data =\n", "[[ 0.03046450-0.00243049j]\n", " [-0.01434436-0.00097183j]\n", " [-0.00583341-0.00069853j]\n", " [ 0.97780868-0.20667602j]]\n", "\n", "********* Summary *****************\n", "Final fidelity error 0.0005877800057074722\n", "Final gradient normal 0.0\n", "Terminated due to Goal achieved\n", "Number of iterations 125\n", "Completed in 0:00:05.187298 HH:MM:SS.US\n" ] } ], "source": [ "result.stats.report()\n", "print(\"Final evolution\\n{}\\n\".format(result.evo_full_final))\n", "print(\"********* Summary *****************\")\n", "print(\"Final fidelity error {}\".format(result.fid_err))\n", "print(\"Final gradient normal {}\".format(result.grad_norm_final))\n", "print(\"Terminated due to {}\".format(result.termination_reason))\n", "print(\"Number of iterations {}\".format(result.num_iter))\n", "print(\"Completed in {} HH:MM:SS.US\".format(\n", " datetime.timedelta(seconds=result.wall_time)))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Plot the initial and final amplitudes" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here the (random) starting pulse is plotted along with the pulse (control amplitudes) that was found to produce the target gate evolution to within the specified error." ] }, { "cell_type": "code", "execution_count": 12, "metadata": {}, "outputs": [ { "data": { "image/png": "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\nRU5ErkJggg==\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "fig1 = plt.figure()\n", "ax1 = fig1.add_subplot(2, 1, 1)\n", "ax1.set_title(\"Initial Control amps\")\n", "ax1.set_ylabel(\"Control amplitude\")\n", "ax1.step(result.time, \n", " np.hstack((result.initial_amps[:, 0], result.initial_amps[-1, 0])), \n", " where='post')\n", "\n", "ax2 = fig1.add_subplot(2, 1, 2)\n", "ax2.set_title(\"Optimised Control Amplitudes\")\n", "ax2.set_xlabel(\"Time\")\n", "ax2.set_ylabel(\"Control amplitude\")\n", "ax2.step(result.time, \n", " np.hstack((result.final_amps[:, 0], result.final_amps[-1, 0])), \n", " where='post')\n", "plt.tight_layout()\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Versions" ] }, { "cell_type": "code", "execution_count": 11, "metadata": {}, "outputs": [ { "data": { "text/html": [ "
SoftwareVersion
QuTiP4.1.0
Numpy1.11.3
SciPy0.18.1
matplotlib2.0.0
Cython0.25.2
Number of CPUs4
BLAS InfoINTEL MKL
IPython5.1.0
Python3.6.0 |Anaconda 4.3.1 (64-bit)| (default, Dec 23 2016, 12:22:00) \n", "[GCC 4.4.7 20120313 (Red Hat 4.4.7-1)]
OSposix [linux]
Fri Jul 14 11:59:44 2017 BST
" ], "text/plain": [ "" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qutip.ipynbtools import version_table\n", "\n", "version_table()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### References" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "[1] Doria, P., Calarco, T. & Montangero, S.: Optimal Control Technique for Many-Body Quantum Dynamics. Phys. Rev. Lett. 106, 1–4 (2011).\n", "\n", "[2] Caneva, T., Calarco, T. & Montangero, S.: Chopped random-basis quantum optimization. Phys. Rev. A - At. Mol. Opt. Phys. 84, (2011)." ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.7.3" } }, "nbformat": 4, "nbformat_minor": 1 }