examples/tutorial_4_variational.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Tutorial IV: Constructing variational algorithms"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Variational quantum algorithms are a broad set of methods which involve optimizing a parameterized quantum circuit ansatz applied to some initial state (called the \"reference\") in order to minimize a cost function defined with respect to the output state. In the context of quantum simulation, very often the goal is to prepare ground states and the cost function is the expectation value of a Hamiltonian. Thus, if we define the reference (initial state) as $\\lvert \\psi\\rangle$, the Hamiltonian as $H$ and the parameterized quantum circuit as $U(\\vec{\\theta})$ where $\\vec{\\theta}$ are the varaitional parameters, then the goal is to minimize the cost function\n",
    "$$\n",
    "E(\\vec \\theta) =  \\langle \\psi \\rvert\n",
    "U^\\dagger(\\vec{\\theta}) H U(\\vec{\\theta})\n",
    "\\lvert \\psi\\rangle.\n",
    "$$\n",
    "A classical optimization algorithm can be used to find the $\\vec{\\theta}$ that minimizes the value of the expression. The performance of a variational algorithm depends crucially on the choice of ansatz circuit $U(\\vec{\\theta})$, the choice of reference, and the strategy for choosing the initial parameters $\\vec{\\theta}$ since typically global optimizing is challenging and one needs to begin reasonably close to the intended state. One possibility is to use an ansatz of the form\n",
    "$$\n",
    "U(\\vec{\\theta}) = \\prod_j \\exp(-i \\theta_j H_j)\n",
    "$$\n",
    "where the $H = \\sum_j H_j$. This ansatz is inspired by a low Trotter-number Trotter-Suzuki based approximation to adiabatic state preparation. OpenFermion-Cirq contains routines for constructing ansatzes of this form which use as templates the Trotter step algorithms implemented in the `trotter` module."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Jellium with a Linear Swap Network\n",
    "\n",
    "We will first demonstrate the construction and optimization of a variational ansatz for a jellium Hamiltonian. We will use an ansatz based on the `LINEAR_SWAP_NETWORK` Trotter step, which takes as input a DiagonalCoulombHamiltonian. Later, we will show how one can create a custom circuit ansatz and apply it to the H$_2$ molecule in a minimal basis."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "The ground energy of the jellium Hamiltonian at 2 electrons is -0.2697672439172563\n",
      "Created a variational ansatz with the following circuit:\n",
      "0       1            2         3\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_0_1_0 XXYY──────XXYY^T_2_3_0\n",
      "│       │            │         │\n",
      "@───────@^V_0_1_0    @─────────@^V_2_3_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n",
      "│       @────────────@^V_0_3_0 │\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_1_3_0 XXYY──────XXYY^T_0_2_0\n",
      "│       │            │         │\n",
      "@───────@^V_1_3_0    @─────────@^V_0_2_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n",
      "Z^U_3_0 @────────────@^V_1_2_0 Z^U_0_0\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "│       Z^U_2_0      Z^U_1_0   │\n",
      "│       │            │         │\n",
      "│       @────────────@^V_1_2_0 │\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "@───────@^V_1_3_0    @─────────@^V_0_2_0\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_1_3_0 XXYY──────XXYY^T_0_2_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n",
      "│       @────────────@^V_0_3_0 │\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "@───────@^V_0_1_0    @─────────@^V_2_3_0\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_0_1_0 XXYY──────XXYY^T_2_3_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n"
     ]
    }
   ],
   "source": [
    "import openfermion\n",
    "import openfermioncirq\n",
    "\n",
    "# Set parameters of jellium model.\n",
    "wigner_seitz_radius = 5. # Radius per electron in Bohr radii.\n",
    "n_dimensions = 2 # Number of spatial dimensions.\n",
    "grid_length = 2 # Number of grid points in each dimension.\n",
    "spinless = True # Whether to include spin degree of freedom or not.\n",
    "n_electrons = 2 # Number of electrons.\n",
    "\n",
    "# Figure out length scale based on Wigner-Seitz radius and construct a basis grid.\n",
    "length_scale = openfermion.wigner_seitz_length_scale(\n",
    "    wigner_seitz_radius, n_electrons, n_dimensions)\n",
    "grid = openfermion.Grid(n_dimensions, grid_length, length_scale)\n",
    "\n",
    "# Initialize the model and compute its ground energy in the correct particle number manifold\n",
    "fermion_hamiltonian = openfermion.jellium_model(grid, spinless=spinless, plane_wave=False)\n",
    "hamiltonian_sparse = openfermion.get_sparse_operator(fermion_hamiltonian)\n",
    "ground_energy, _ = openfermion.jw_get_ground_state_at_particle_number(\n",
    "    hamiltonian_sparse, n_electrons)\n",
    "print('The ground energy of the jellium Hamiltonian at {} electrons is {}'.format(\n",
    "    n_electrons, ground_energy))\n",
    "\n",
    "# Convert to DiagonalCoulombHamiltonian type.\n",
    "hamiltonian = openfermion.get_diagonal_coulomb_hamiltonian(fermion_hamiltonian)\n",
    "\n",
    "# Define the objective function\n",
    "objective = openfermioncirq.HamiltonianObjective(hamiltonian)\n",
    "\n",
    "# Create a swap network Trotter ansatz.\n",
    "iterations = 1  # This is the number of Trotter steps to use in the ansatz.\n",
    "ansatz = openfermioncirq.SwapNetworkTrotterAnsatz(\n",
    "    hamiltonian,\n",
    "    iterations=iterations)\n",
    "\n",
    "print('Created a variational ansatz with the following circuit:')\n",
    "print(ansatz.circuit.to_text_diagram(transpose=True))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In the last lines above we instantiated a class called SwapNetworkTrotterAnsatz which inherits from the general VariationalAnsatz class in OpenFermion-Cirq. A VariationalAnsatz is essentially a parameterized circuit that one constructs so that parameters can be supplied symbolically. This way one does not (necessarily) need to recompile the circuit each time the variational parameters change. We also instantiated a HamiltonianObjective which represents the objective function being the expectation value of our Hamiltonian.\n",
    "\n",
    "Optimizing an ansatz requires the creation of a VariationalStudy object. A VariationalStudy is responsible for performing optimizations and storing the results. By default, it evaluates parameters by simulating the quantum circuit and computing the objective function, in this case the expectation value of the Hamiltonian, on the final state. It includes an optional state preparation circuit to be applied prior to the ansatz circuit. For this example, we will prepare the initial state as an eigenstate of the one-body operator of the Hamiltonian. Since the one-body operator is a quadratic Hamiltonian, its eigenstates can be prepared using the `prepare_gaussian_state` method. The SwapNetworkTrotterAnsatz class also includes a default setting of parameters which is inspired by the idea of state preparation by adiabatic evolution from the mean-field state."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Created a variational study with 4 qubits and 14 parameters\n",
      "The value of the objective with default initial parameters is -0.19655859516666632\n",
      "The circuit of the study is\n",
      "0       1            2         3\n",
      "│       │            │         │\n",
      "X       X            │         │\n",
      "│       │            │         │\n",
      "│       YXXY─────────#2^0.995  │\n",
      "│       │            │         │\n",
      "YXXY────#2^-0.502    Z^0       │\n",
      "│       │            │         │\n",
      "│       Z^0          YXXY──────#2^-0.498\n",
      "│       │            │         │\n",
      "│       YXXY─────────#2^0.005  Z^0\n",
      "│       │            │         │\n",
      "│       │            Z^0       │\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_0_1_0 XXYY──────XXYY^T_2_3_0\n",
      "│       │            │         │\n",
      "@───────@^V_0_1_0    @─────────@^V_2_3_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n",
      "│       @────────────@^V_0_3_0 │\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_1_3_0 XXYY──────XXYY^T_0_2_0\n",
      "│       │            │         │\n",
      "@───────@^V_1_3_0    @─────────@^V_0_2_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n",
      "Z^U_3_0 @────────────@^V_1_2_0 Z^U_0_0\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "│       Z^U_2_0      Z^U_1_0   │\n",
      "│       │            │         │\n",
      "│       @────────────@^V_1_2_0 │\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "@───────@^V_1_3_0    @─────────@^V_0_2_0\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_1_3_0 XXYY──────XXYY^T_0_2_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n",
      "│       @────────────@^V_0_3_0 │\n",
      "│       │            │         │\n",
      "│       ×ᶠ───────────×ᶠ        │\n",
      "│       │            │         │\n",
      "@───────@^V_0_1_0    @─────────@^V_2_3_0\n",
      "│       │            │         │\n",
      "XXYY────XXYY^T_0_1_0 XXYY──────XXYY^T_2_3_0\n",
      "│       │            │         │\n",
      "×ᶠ──────×ᶠ           ×ᶠ────────×ᶠ\n",
      "│       │            │         │\n"
     ]
    }
   ],
   "source": [
    "# Use preparation circuit for mean-field state\n",
    "import cirq\n",
    "preparation_circuit = cirq.Circuit(\n",
    "    openfermioncirq.prepare_gaussian_state(\n",
    "        ansatz.qubits,\n",
    "        openfermion.QuadraticHamiltonian(hamiltonian.one_body),\n",
    "        occupied_orbitals=range(n_electrons)))\n",
    "\n",
    "# Create a Hamiltonian variational study\n",
    "study = openfermioncirq.VariationalStudy(\n",
    "    'jellium_study',\n",
    "    ansatz,\n",
    "    objective,\n",
    "    preparation_circuit=preparation_circuit)\n",
    "\n",
    "print(\"Created a variational study with {} qubits and {} parameters\".format(\n",
    "    len(study.ansatz.qubits), study.num_params))\n",
    "\n",
    "print(\"The value of the objective with default initial parameters is {}\".format(\n",
    "    study.value_of(ansatz.default_initial_params())))\n",
    "\n",
    "print(\"The circuit of the study is\")\n",
    "print(study.circuit.to_text_diagram(transpose=True))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As we can see, our initial guess isn't particularly close to the target energy. Optimizing the study requires the creation of an OptimizationParams object. The most import component of this object is the optimization algorithm to use. OpenFermion-Cirq includes a wrapper around the the `minimize` method of Scipy's `optimize` module and more optimizers will be included in the future. Let's perform an optimization using the COBYLA method. Since this is just an example, we will set the maximum number of function evaluations to 100 so that it doesn't run too long."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "-0.2693602901295287\n"
     ]
    }
   ],
   "source": [
    "# Perform an optimization run.\n",
    "from openfermioncirq.optimization import ScipyOptimizationAlgorithm, OptimizationParams\n",
    "algorithm = ScipyOptimizationAlgorithm(\n",
    "    kwargs={'method': 'COBYLA'},\n",
    "    options={'maxiter': 100},\n",
    "    uses_bounds=False)\n",
    "optimization_params = OptimizationParams(\n",
    "    algorithm=algorithm)\n",
    "result = study.optimize(optimization_params)\n",
    "print(result.optimal_value)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In practice, the expectation value of the Hamiltonian cannot be measured exactly due to errors from finite sampling. This manifests as an error, or noise, in the measured value of the energy which can be reduced at the cost of more measurements. The HamiltonianVariationalStudy class incorporates a realistic model of this noise (shot-noise). The OptimizationParams object can have a `cost_of_evaluate` parameter which in this case represents the number of measurements used to estimate the energy for a set of parameters. If we are interested in how well an optimizer performs in the presence of noise, then we may want to repeat the optimization several times and see how the results vary between repetitions.\n",
    "\n",
    "Below, we will perform the same optimization, but this time using the noise model. We will allow one million measurements per energy evaluation and repeat the optimization three times. Since this time the function evaluations are noisy, we'll also indicate that the final parameters of the study should be reevaluated according to a noiseless simulation. Finally, we'll print out a summary of the study, which includes all results obtained so far (including from the previous cell)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "This study contains 2 trial results.\n",
      "The optimal value found among all trial results is -0.2693602901295287.\n",
      "It was found by the run with identifier 0.\n",
      "Result details:\n",
      "    Identifier: 0\n",
      "        Optimal value: -0.2693602901295287\n",
      "        Number of repetitions: 1\n",
      "        Optimal value 1st, 2nd, 3rd quartiles:\n",
      "            [-0.2693602901295287, -0.2693602901295287, -0.2693602901295287]\n",
      "        Num evaluations 1st, 2nd, 3rd quartiles:\n",
      "            [100.0, 100.0, 100.0]\n",
      "        Cost spent 1st, 2nd, 3rd quartiles:\n",
      "            [nan, nan, nan]\n",
      "        Time spent 1st, 2nd, 3rd quartiles:\n",
      "            [0.6766312122344971, 0.6766312122344971, 0.6766312122344971]\n",
      "    Identifier: COBYLA with maxiter=100, noisy\n",
      "        Optimal value: -0.2678661682532\n",
      "        Number of repetitions: 3\n",
      "        Optimal value 1st, 2nd, 3rd quartiles:\n",
      "            [-0.2670300806160921, -0.2661939929789843, -0.2650438210386521]\n",
      "        Num evaluations 1st, 2nd, 3rd quartiles:\n",
      "            [100.0, 100.0, 100.0]\n",
      "        Cost spent 1st, 2nd, 3rd quartiles:\n",
      "            [nan, nan, nan]\n",
      "        Time spent 1st, 2nd, 3rd quartiles:\n",
      "            [0.6606414318084717, 0.6620919704437256, 0.6714916229248047]\n"
     ]
    }
   ],
   "source": [
    "optimization_params = OptimizationParams(\n",
    "    algorithm=algorithm,\n",
    "    cost_of_evaluate=1e6)\n",
    "study.optimize(\n",
    "    optimization_params,\n",
    "    identifier='COBYLA with maxiter=100, noisy',\n",
    "    repetitions=3,\n",
    "    reevaluate_final_params=True,\n",
    "    use_multiprocessing=True)\n",
    "print(study)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We see then that in the noisy study the optimizer fails to converge to the final result with high enough accuracy. Apparently then one needs more measurements, a more stable optimizer, or both!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### H$_2$ with a custom ansatz"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The above example shows one of the nice built-in ansatz offered in OpenFermion-Cirq that can be applied to many different types of physical systems without the need for much input by the user.  In some research cases, however, one may wish to design their own paramterized ansatz.  Here will give an example of how to do this for the simple case of the H$_2$ molecule in a minimal basis.\n",
    "\n",
    "To provide some brief background, in a minimal basis H$_2$ is discretized into two slater-type spatial orbitals, each of which is expressed as a sum of 3 Gaussians (STO-3G).  After pre-processing with a mean-field, Hartree-Fock, procedure, the best meanfield approximation of the ground state is found to be the symmetric superposition of these two spatial orbitals.  After including spin in the problem by assigning each spatial orbital an alpha and beta spin, or equivalently the tensor product of the spatial and spin-$1/2$ degree of freedom, the mean-field state is expressed as\n",
    "\\begin{equation}\n",
    "\\vert \\Psi_{\\text{initial}} \\rangle = a^\\dagger_1 a^\\dagger_0 \\vert \\rangle.\n",
    "\\end{equation}\n",
    "\n",
    "Within the Jordan-Wigner encoding of fermionic systems, this is equivalent to a computational basis state with the first two qubits being in the 1 state and the second two qubits in the 0 state.  This can be prepared via a simple circuit as\n",
    "\\begin{equation}\n",
    "| \\Psi_{\\text{initial}} \\rangle = X_1 X_0 \\vert 0 0 0 0 \\rangle = \\vert 1 1 0 0 \\rangle.\n",
    "\\end{equation}\n",
    "\n",
    "As a result of the symmetries present in this system, only one transition is allowed, and it completely characterizes the freedom required to move from this initial guess to the exact ground state solution for all geometries of H$_2$ in the minimal basis.  That is the concerted transitions of electrons from spin-orbitals 0, 1 to 2, 3.  This corresponds to the fermionic operator $a_3^\\dagger a_2^\\dagger a_1 a_0$, which is of course not unitary, but one may lift this operation to the anti-hermitian generator of a rotation as in unitary coupled cluster to yield the unitary\n",
    "\\begin{equation}\n",
    "\\exp \\left[ \\theta \\left(a_3^\\dagger a_2^\\dagger a_1 a_0 - a_0^\\dagger a_1^\\dagger a_2 a_3\\right) \\right]\n",
    "\\end{equation}\n",
    "\n",
    "which may be decomposed exactly using a combination of the Jordan-Wigner transformation and standard identites from Nielsen and Chuang.  However, as has been noted before, the essential action of concerted electron movement can be captured in only a single of the Jordan-Wigner terms, hence the simpler operation\n",
    "\\begin{equation}\n",
    "\\exp \\left[ -i \\theta Y_3 X_2 X_1 X_0 \\right]\n",
    "\\end{equation}\n",
    "suffices.  This is what we use here in combination with standard gate identities to parameterize an ansatz for H$_2$.\n",
    "\n",
    "In the following code we first load up one example geometry of the H$_2$ molecule, as this data is included with OpenFermion. To compute such Hamiltonians for arbitrary molecules in different basis sets geometries, etc., one can use plugins such as [OpenFermion-Psi4](https://github.com/quantumlib/OpenFermion-Psi4) or [OpenFermion-PySCF](https://github.com/quantumlib/OpenFermion-PySCF). Later we will use these same techniques to load and evaluate the full curve with our ansatz."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Bond Length in Angstroms: 0.7414\n",
      "Hartree Fock (mean-field) energy in Hartrees: -1.116684386906734\n",
      "FCI (Exact) energy in Hartrees: -1.137270174625328\n"
     ]
    }
   ],
   "source": [
    "import openfermion\n",
    "\n",
    "diatomic_bond_length = .7414\n",
    "geometry = [('H', (0., 0., 0.)), \n",
    "            ('H', (0., 0., diatomic_bond_length))]\n",
    "basis = 'sto-3g'\n",
    "multiplicity = 1\n",
    "charge = 0\n",
    "description = format(diatomic_bond_length)\n",
    "\n",
    "molecule = openfermion.MolecularData(\n",
    "    geometry,\n",
    "    basis,\n",
    "    multiplicity,\n",
    "    description=description)\n",
    "molecule.load()\n",
    "\n",
    "hamiltonian = molecule.get_molecular_hamiltonian()\n",
    "print(\"Bond Length in Angstroms: {}\".format(diatomic_bond_length))\n",
    "print(\"Hartree Fock (mean-field) energy in Hartrees: {}\".format(molecule.hf_energy))\n",
    "print(\"FCI (Exact) energy in Hartrees: {}\".format(molecule.fci_energy))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we design a custom ansatz with a single parameter based on the simplfied unitary above.  The ansatz class makes convenient use of named parameters which are specified by the params routine.  The parameterized circuit then makes use of these parameters within its operations method."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [],
   "source": [
    "import cirq\n",
    "import openfermioncirq\n",
    "import sympy\n",
    "\n",
    "class MyAnsatz(openfermioncirq.VariationalAnsatz):\n",
    "    \n",
    "    def params(self):\n",
    "        \"\"\"The parameters of the ansatz.\"\"\"\n",
    "        return [sympy.Symbol('theta_0')]\n",
    "    \n",
    "    def operations(self, qubits):\n",
    "        \"\"\"Produce the operations of the ansatz circuit.\"\"\"\n",
    "        q0, q1, q2, q3 = qubits\n",
    "        yield cirq.H(q0), cirq.H(q1), cirq.H(q2)\n",
    "        yield cirq.XPowGate(exponent=-0.5).on(q3)\n",
    "        \n",
    "        yield cirq.CNOT(q0, q1), cirq.CNOT(q1, q2), cirq.CNOT(q2, q3)\n",
    "        yield cirq.ZPowGate(exponent=sympy.Symbol('theta_0')).on(q3)\n",
    "        yield cirq.CNOT(q2, q3), cirq.CNOT(q1, q2), cirq.CNOT(q0, q1)\n",
    "        \n",
    "        yield cirq.H(q0), cirq.H(q1), cirq.H(q2)\n",
    "        yield cirq.XPowGate(exponent=0.5).on(q3)\n",
    "\n",
    "    def _generate_qubits(self):\n",
    "        \"\"\"Produce qubits that can be used by the ansatz circuit.\"\"\"\n",
    "        return cirq.LineQubit.range(4)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "After this custom ansatz is designed, we can instantiate it and package it into a variational study class along with an initial state preparation cirucit that makes it more convenient to study parts of an ansatz.  In this case our initial state is the doubly occupied computational basis state mentioned above."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "0: ───X───H────────@───────────────────────────────────@───H───\n",
      "                   │                                   │\n",
      "1: ───X───H────────X───@───────────────────────@───────X───H───\n",
      "                       │                       │\n",
      "2: ───────H────────────X───@───────────────@───X───────H───────\n",
      "                           │               │\n",
      "3: ───────X^-0.5───────────X───Z^theta_0───X───X^0.5───────────\n"
     ]
    }
   ],
   "source": [
    "ansatz = MyAnsatz()\n",
    "objective = openfermioncirq.HamiltonianObjective(hamiltonian)\n",
    "q0, q1, _, _ = ansatz.qubits\n",
    "preparation_circuit = cirq.Circuit(\n",
    "    cirq.X(q0),\n",
    "    cirq.X(q1))\n",
    "study = openfermioncirq.VariationalStudy(\n",
    "    name='my_hydrogen_study',\n",
    "    ansatz=ansatz,\n",
    "    objective=objective,\n",
    "    preparation_circuit=preparation_circuit)\n",
    "print(study.circuit)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With this this paramterized circuit and state preparation packaged into a variational study, it is now straightfoward to attach an optimizer and find the optimal value as was done in the example above.  Note that we can also set an initial guess for the angle as determined by any number of methods, and we demonstrate this here.  Note that as the built-in simulator for Cirq is based on single precision, the solution may appear sub-variational past this precision due to round off errors that accumlate, however it is far below the accuracy one is typically concerned with for this type of problem."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Initial state energy in Hartrees: -1.116684386906734\n",
      "Optimized energy result in Hartree: -1.1372701552464972\n",
      "Exact energy result in Hartees for reference: -1.137270174625328\n"
     ]
    }
   ],
   "source": [
    "# Perform optimization.\n",
    "import numpy\n",
    "from openfermioncirq.optimization import COBYLA, OptimizationParams\n",
    "optimization_params = OptimizationParams(\n",
    "    algorithm=COBYLA,\n",
    "    initial_guess=[0.01])\n",
    "result = study.optimize(optimization_params)\n",
    "print(\"Initial state energy in Hartrees: {}\".format(molecule.hf_energy))\n",
    "print(\"Optimized energy result in Hartree: {}\".format(result.optimal_value))\n",
    "print(\"Exact energy result in Hartees for reference: {}\".format(molecule.fci_energy))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Using this same circuit and approach, we can now build a curve for the length of the H$_2$ molecule and plot it in the following way. Note that running the code in the cell above is required for this example."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "R=0.3\t Optimized Energy: -0.6018035675227398\n",
      "R=0.4\t Optimized Energy: -0.9141496409228792\n",
      "R=0.5\t Optimized Energy: -1.055159752249402\n",
      "R=0.6\t Optimized Energy: -1.1162859643054646\n",
      "R=0.7\t Optimized Energy: -1.13618942709292\n",
      "R=0.8\t Optimized Energy: -1.1341476185091992\n",
      "R=0.9\t Optimized Energy: -1.1205602616286472\n",
      "R=1.0\t Optimized Energy: -1.1011503067765511\n",
      "R=1.1\t Optimized Energy: -1.079192927373109\n",
      "R=1.2\t Optimized Energy: -1.0567407114641352\n",
      "R=1.3\t Optimized Energy: -1.035186257867059\n",
      "R=1.4\t Optimized Energy: -1.015468220529388\n",
      "R=1.5\t Optimized Energy: -0.9981493419143923\n",
      "R=1.6\t Optimized Energy: -0.9834727107045589\n",
      "R=1.7\t Optimized Energy: -0.9714266833873014\n",
      "R=1.8\t Optimized Energy: -0.9618169299971958\n",
      "R=1.9\t Optimized Energy: -0.9543388245412123\n",
      "R=2.0\t Optimized Energy: -0.9486410987128432\n",
      "R=2.1\t Optimized Energy: -0.9443746746029322\n",
      "R=2.2\t Optimized Energy: -0.9412240092714697\n",
      "R=2.3\t Optimized Energy: -0.9389223694773261\n",
      "R=2.4\t Optimized Energy: -0.9372549459930383\n",
      "R=2.5\t Optimized Energy: -0.9360549176573433\n"
     ]
    }
   ],
   "source": [
    "bond_lengths = ['{0:.1f}'.format(0.3 + 0.1 * x) for x in range(23)]\n",
    "hartree_fock_energies = []\n",
    "optimized_energies = []\n",
    "exact_energies = []\n",
    "\n",
    "for diatomic_bond_length in bond_lengths:\n",
    "    geometry = [('H', (0., 0., 0.)), \n",
    "                ('H', (0., 0., diatomic_bond_length))]\n",
    "\n",
    "    description = format(diatomic_bond_length)\n",
    "\n",
    "    molecule = openfermion.MolecularData(geometry, basis,\n",
    "                                         multiplicity, description=description)\n",
    "    molecule.load()\n",
    "    hamiltonian = molecule.get_molecular_hamiltonian()\n",
    "    \n",
    "    study = openfermioncirq.VariationalStudy(\n",
    "        name='my_hydrogen_study',\n",
    "        ansatz=ansatz,\n",
    "        objective=openfermioncirq.HamiltonianObjective(hamiltonian),\n",
    "        preparation_circuit=preparation_circuit)\n",
    "    \n",
    "    result = study.optimize(optimization_params)\n",
    "    hartree_fock_energies.append(molecule.hf_energy)\n",
    "    optimized_energies.append(result.optimal_value)\n",
    "    exact_energies.append(molecule.fci_energy)\n",
    "    \n",
    "    print(\"R={}\\t Optimized Energy: {}\".format(diatomic_bond_length, result.optimal_value))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now that we've collected that data, we can easily visualize it with standard matplotlib routines"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjMAAAG7CAYAAAA2WRTqAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjEsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8QZhcZAAAgAElEQVR4nOzdd3yV5cHG8d+dvQOBLMKUKQIGCENwgQM3OFBxgkXcYq30xdZXaast1fat21ZRASdK68aFiooDiBKQaRghBDKBnJM9Tu73jwQKmEBCcvJkXN/PJx/OeM55rhNGLu7nfu7HWGsRERERaa18nA4gIiIi0hgqMyIiItKqqcyIiIhIq6YyIyIiIq2ayoyIiIi0aiozIiIi0qqpzIiIiEirpjIj0kYYY9KMMWc2077mG2MePJZtjTHrjTGney1c3TmOeb9OZRaR+lGZEXFYbSXEGDPVGLPcqUzeZK09wVq7rKXut7bfD6cyi0j9qMyIiLRixhg/pzOIOE1lRqRtGWGM2WCM2WeMedEYE7T/CWPM8caYZcaY/JrDJhcd9FyaMeYeY8xaY4zLGLPosNcONcb8aIwpMMYsAoKow9G2PXjkwxjzP8aYXTXbbjbGnHGkx+vxOboZY/5jjMk1xuwxxjxZx35nG2O21rz/BmPMxTWPvwR0B94zxhQaY35by2vr3H99vpeHbXukvNYY0+eg+wcO19Xs43+MMWuBoprbiw9778eMMY/X3O5ijPl3zX62G2PurOv3T6Q1UpkRaVuuBiYAvYF+wH0Axhh/4D3gEyAGuAN4xRjT/6DXXg6cA/QChgBTa14bALwNvAREAW8Cl9a28wZu2x+4HRhhrQ2vyZ1W1+NH+xzGGF/gfWAH0BNIAF6v4/u0FTgFiAT+ALxsjIm31l4LpAMXWmvDrLUPH5a5Pt9HqON7edh7NSRvbaYA5wMdal53njEm/KD3vhx41RjjU5N5Tc0+zgDuMsZMaMC+RFo0lRmRluHtmv/p5xtj8oGn9z9hjBlpjPnOGPOVMea1mh+odXnSWrvTWrsXeIjqH3gAo4EwYK61ttxa+znVP0inHPTax621u2te+x6QeNBr/YFHrbUV1trFwKo69t+QbT1AIDDQGONvrU2z1m49wuNH+xwjgS7ALGttkbW21Fpb67wja+2bNZ+1ylq7CEitef3R1Of7CHV/Lw9W77x1eLzm97rEWrsD+BG4uOa58UCxtfZ7YAQQba39Y03mbcBzwJUN2JdIi6YyI9IyTLLWdtj/Bdx60HM7gfHW2lOpHqGYeIT32XnQ7R1U/7Ck5ted1tqqw55POOh+1kG3i6n+ob3/tbustfaw19am3ttaa7cAdwFzgBxjzOvGmC51PV6Pz9EN2GGtrawj2wHGmOuMMSkHlcdBQOejve4o+z9YXd/Lg9U7bx12Hnb/Vf5bqq6quQ/QA+hyWFn+HRB7jPsVaXFUZkRaOGttprW2pOZuOVB1hM27HXS7O7C75vZuoFvNIYeDn99VjwiZQIIxxhz22sZui7X2VWvtyVT/wLXAX4/0+FE+x06guznKhFhjTA+qRyZuBzrVlMd1wP7Mtq7XHmX/DXW0vMVAyEH34w57/vCcbwKnG2O6Uj1Cs7/M7AS2H1yWrbXh1trzjiGzSIukMiPSStT8ED6b6sMWdbnNGNPVGBMF/B5YVPP4Cqp/OP7WGONvqtdMuZD6zdH4DqgE7qx57SXUfUim3tvWzHMZb4wJBEqBEqCqrsfr8TlWUl2m5hpjQo0xQcaYsbXsOpTqIpBbk2Ma1SMz+2UDx9Xx+RrzfTzc0fKmAFcZY3yNMecApx3pzay1ucAy4EWqy8vGg/ZTUDNJOLjm/QYZY0YcQ2aRFkllRqQVMMZEUD2pdqq1tuIIm75K9eTUbVRPcn0QwFpbTvUP3XOBPKrn5Fxnrd10tH3XvPYSqiex7gWuAP7T2G2pnhcztyZPFtUTau89wuNH/BzWWk/Nc32onsSbUbP/wzNuAP5OdfHKBgYD3xy0yV+A+2oOydxTy+c7pu9jLTmOlndmzfP5VE/sfrseb/sqcCb/HZXZv58LqJ63s70m9zyqJz+LtAnm0EPbItLS1ByGeBf4u7X2M6fziIi0NBqZEWn5pgCjgP+tWd/kF6MNIiLtmUZmREREpFXTyIyIiIi0aiozIiIi0qqpzIiIiEir1iavtnrOOefYjz76yOkYIiIi0rRMbQ+2yZGZvLw8pyOIiIhIM2mTZUZERETaD5UZERERadVUZkRERKRVU5kRERGRVk1lRkRERFo1lRkRERFp1VRmREREpFVTmREREZFWTWVGRESkBQgLCzvk/vz587n99tsb9B4pKSksWbKkKWMdYv78+URHR5OYmEhiYiLXXXddg99j2bJlXHDBBU2aq01ezkBERKS9qaysJCUlheTkZM4777xan/fza/yP/SuuuIInn3yy0e/TlDQyIyIi0sK99957jBo1iqFDh3LmmWeSnZ0NwJw5c7j22msZO3Ys1157Lffffz+LFi0iMTGRRYsW/eJ5j8fDrFmzGDFiBEOGDOFf//rXgX088sgjBx5/4IEHGpQvJSWF0aNHM2TIEC6++GL27dsHwJYtWzjzzDM58cQTGTZsGFu3bj3kdatWrWLo0KG/eLyhNDIjIiJykD+8t54Nu91N+p4Du0TwwIUnHHGbkpISEhMTD9zfu3cvF110EQAnn3wy33//PcYY5s2bx8MPP8zf//53ADZs2MDy5csJDg5m/vz5JCcnHxg5mTNnziHPP/vss0RGRrJq1SrKysoYO3YsZ599NqmpqaSmprJy5UqstVx00UV89dVXnHrqqb/IuWjRIpYvXw7AzJkzmTZtGtdddx1PPPEEp512Gvfffz9/+MMfePTRR7n66quZPXs2F198MaWlpVRVVbFz504Avv32W+644w7eeecdunfv3qjvr8qMiIhICxAcHExKSsqB+/uLCUBGRgZXXHEFmZmZlJeX06tXrwPbXXTRRQQHB9f5vgc//8knn7B27VoWL14MgMvlIjU1lU8++YRPPvmEoUOHAlBYWEhqamqtZebww0wul4v8/HxOO+00AK6//nomT55MQUEBu3bt4uKLLwYgKCjowGs2btzIjBkz+OSTT+jSpUvDvlG1UJkRERE5yNFGUJxwxx13cPfdd3PRRRexbNky5syZc+C50NDQI7724OettTzxxBNMmDDhkG0+/vhj7r33Xm666aZDHn/qqad47rnnAJp0YnF8fDylpaWsXr26ScqM5szUU0m5h42ZborLK52OIiIi7YzL5SIhIQGABQsW1LldeHg4BQUFdT4/YcIEnnnmGSoqKgD4+eefKSoqYsKECbzwwgsUFhYCsGvXLnJycrjttttISUkhJSWlztIRGRlJx44d+frrrwF46aWXOO200wgPD6dr1668/fbbAJSVlVFcXAxAhw4d+OCDD7j33ntZtmxZw74ZtVCZqacV2/dw7mNfN/lxVBERkaOZM2cOkydPZvjw4XTu3LnO7caNG8eGDRsOTAA+3PTp0xk4cCDDhg1j0KBB3HTTTVRWVnL22Wdz1VVXcdJJJzF48GAuu+yy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\n",
      "text/plain": [
       "<Figure size 720x504 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib\n",
    "import matplotlib.pyplot as pyplot\n",
    "%matplotlib inline\n",
    "\n",
    "# Plot the energy mean and std Dev\n",
    "fig = pyplot.figure(figsize=(10,7))\n",
    "bkcolor = '#ffffff'\n",
    "ax = fig.add_subplot(1, 1, 1)\n",
    "pyplot.subplots_adjust(left=.2)\n",
    "ax.set_xlabel('R (Angstroms)')\n",
    "ax.set_ylabel(r'E Hartrees')\n",
    "ax.set_title(r'H$_2$ bond dissociation curve')\n",
    "ax.spines['right'].set_visible(False)\n",
    "ax.spines['top'].set_visible(False)\n",
    "bond_lengths = [float(x) for x in bond_lengths]\n",
    "ax.plot(bond_lengths, hartree_fock_energies, label='Hartree-Fock')\n",
    "ax.plot(bond_lengths, optimized_energies, '*', label='Optimized')\n",
    "ax.plot(bond_lengths, exact_energies, '--', label='Exact')\n",
    "\n",
    "ax.legend(frameon=False)\n",
    "pyplot.show()"
   ]
  }
 ],
 "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": 2
}