challenge-1.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## IBM Quantum Challenge Fall 2021\n",
    "# Challenge 1: Optimizing your portfolio with quantum computers\n",
    "\n",
    "<div class=\"alert alert-block alert-info\">\n",
    "    \n",
    "We recommend that you switch to **light** workspace theme under the Account menu in the upper right corner for optimal experience."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Introduction: What is portfolio optimization?\n",
    "Portfolio optimization is a crucial process for anyone who wants to maximize returns from their investments. \n",
    "Investments are usually a collection of so-called assets (stock, credits, bonds, derivatives, calls, puts, etc..) and this collection of assets is called a **portfolio**. \n",
    "<center><img src=\"resources/ex1-01.png\" width=\"270\"></center>\n",
    "The goal of portfolio optimization is to minimize risks (financial loss) and maximize returns (financial gain). But this process is not as simple as it may seem. Gaining high returns with little risk is indeed too good to be true. Risks and returns usually have a trade-off relationship which makes optmizing your portfolio a little more complicated. As Dr. Harry Markowitz states in his Moderbn Portfolio Theory he created in 1952,  \"risk is an inherrent part of higher reward.\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Modern Portfolio Theory (MPT)** <br>\n",
    "An investment theory based on the idea that investors are risk-averse, meaning that when given two portfolios that offer the same expected return they will prefer the less risky one. Investors can construct portfolios to maximize expected return based on a given level of market risk, emphasizing that risk is an inherent part of higher reward. It is one of the most important and influential economic theories dealing with finance and investment. Dr. Harry Markowitz created the modern portfolio theory (MPT) in 1952 and won the Nobel Prize in Economic Sciences in 1990 for it. <br><br>\n",
    "**Reference:** [<b>Modern Portfolio Theory<i>](https://en.wikipedia.org/wiki/Modern_portfolio_theory)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Challenge\n",
    "\n",
    "<div class=\"alert alert-block alert-success\">\n",
    "\n",
    "**Goal**\n",
    "\n",
    "Portfolio optimization is a crucial process for anyone who wants to maximize returns from their investments. In this first challenge, you will learn some of the basic theory behind portfolio optimization and how to formulate the problem so it can be solved by quantum computers. During the process, you will learn about Qiskit's Finance application class and methods to solve the problem efficiently.\n",
    "\n",
    "1. **Challenge 1a**: Learn how to use the PortfolioOptimization() method in Qiskit's Finance module to convert the portfolio optimization into a quadratic program.\n",
    "    \n",
    "2. **Challenge 1b**: Implement VQE to solve a four-stock portfolio optimization problem based on the instance created in challenge 1a.\n",
    "    \n",
    "    \n",
    "3. **Challenge 1c**: Solve the same problem using QAOA with three budgets and double weights for any of the assets in your portfolio. \n",
    "\n",
    "</div>\n",
    "<div class=\"alert alert-block alert-info\">\n",
    "\n",
    "Before you begin, we recommend watching the [**Qiskit Finance Demo Session with Julien Gacon**](https://youtu.be/UtMVoGXlz04?t=2022) and check out the corresponding [**demo notebook**](https://github.com/qiskit-community/qiskit-application-modules-demo-sessions/tree/main/qiskit-finance) to learn about Qiskit's Finance module and its appications in portfolio optimization.\n",
    "\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## 1. Finding the efficient frontier\n",
    "The Modern portfolio theory (MPT) serves as a general framework to determine an ideal portfolio for investors.  The MPT is also referred to as mean-variance portfolio theory because it assumes that any investor will choose the optimal portfolio from the set of portfolios that\n",
    "- Maximizes expected return for a given level of risk; and\n",
    "- Minimizes risks for a given level of expected returns.\n",
    "\n",
    "The figure below shows the minimum variance frontier of modern portfolio theory where the horizontal axis shows the risk and the vertical axis shows expected return.  \n",
    "\n",
    "<center><img src=\"resources/ex1-02.png\" width=\"600\"></center>\n",
    "\n",
    "Consider a situation where you have two stocks to choose from: A and B. You can invest your entire wealth in one of these two stocks. Or you can invest 10% in A and 90% in B, or 20% in A and 80% in B, or 70% in A and 30% in B, etc ... There is a huge number of possible combinations and this is a simple case when considering two stocks. Imagine the different combinations you have to consider when you have thousands of stocks.\n",
    "\n",
    "The minimum variance frontier shows the minimum variance that can be achieved for a given level of expected return. To construct a minimum-variance frontier of a portfolio:\n",
    "\n",
    "- Use historical data to estimate the mean, variance of each individual stock in the portfolio, and the correlation of each pair of stocks.\n",
    "- Use a computer program to find out the weights of all stocks that minimize the portfolio variance for each pre-specified expected return.\n",
    "- Calculate the expected returns and variances for all the minimum variance portfolios determined in step 2 and then graph the two variables.\n",
    "\n",
    "Investors will never want to hold a portfolio below the minimum variance point. They will always get higher returns along the positively sloped part of the minimum-variance frontier. And the positively sloped part of the minimum-variance frontier is called the **efficient frontier**.\n",
    "\n",
    "The **efficient frontier** is where the optimal portfolios are. And it helps narrow down the different portfolios from which the investor may choose. \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## 2. Goal Of Our Exercise\n",
    "The goal of this exercise is to find the efficent frontier for an inherent risk using a quantum approach. We will use Qiskit's Finance application modules to convert our portfolio optimization problem into a quadratic program so we can then use variational quantum algorithms such as VQE and QAOA to solve our optimization problem. Let's first start by looking at the actual problem we have at hand. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "fragment"
    }
   },
   "source": [
    "## 3. Four-Stock Portfolio Optimization Problem\n",
    "\n",
    "Let us consider a portfolio optimization problem where you have a total of four assets (e.g. STOCK0, STOCK1, STOCK2, STOCK3) to choose from. Your goal is to find out a combination of two assets that will minimize the tradeoff between risk and return which is the same as finding the efficient frontier for the given risk. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## 4. Formulation\n",
    "\n",
    "How can we formulate this problem?<br>\n",
    "The function which describes the efficient frontier can be formulated into a quadratic program with linear constraints as shown below. <br>\n",
    "The terms that are marked in red are associated with risks and the terms in blue are associated with returns.\n",
    "You can see that our goal is to minimize the tradeoff between risk and return. In general, the function we want to optimize is called an objective function. <br> <br>\n",
    "\n",
    "<div align=\"center\"> <font size=5em >$\\min_{x \\in \\{0, 1\\}^n}: $</font> <font color='red', size=5em >$q x^n\\Sigma x$</font> - <font color='blue', size=5em>$\\mu^n x$</font> </div>\n",
    "\n",
    "<div align=\"center\"> <font size=5em >$subject$</font> <font size=5em >$to: 1^n x = B$</font> </div>\n",
    "\n",
    "\n",
    "- <font size=4em >$x$</font> indicates asset allocation.\n",
    "- <font size=4em >$Σ$</font> (sigma) is a covariance matrix. \n",
    "A covariance matrix is a useful math concept that is widely applied in financial engineering. It is a statistical measure of how two asset prices are varying with respect to each other. When the covariance between two stocks is high, it means that one stock experiences heavy price movements and is volatile if the price of the other stock changes.\n",
    "- <font size=4em >$q$</font> is called a risk factor (risk tolerance), which is an evaluation of an individual's willingness or ability to take risks. For example, when you use the automated financial advising services, the so-called robo-advising, you will usually see different risk tolerance levels. This q value is the same as such and takes a value between 0 and 1. \n",
    "- <font size=4em >$𝝁$</font> (mu) is the expected return and is something we obviously want to maximize.\n",
    "- <font size=4em >$n$</font> is the number of different assets we can choose from\n",
    "- <font size=4em >$B$</font> stands for Budget.\n",
    "And budget in this context means the number of assets we can allocate in our portfolio. \n",
    "\n",
    "\n",
    "\n",
    "#### Goal:\n",
    "Our goal is to find the **x** value. The x value here indicates which asset to pick (𝑥[𝑖]=1) and which not to pick (𝑥[𝑖]=0). \n",
    "\n",
    "\n",
    "#### Assumptions:\n",
    "We assume the following simplifications:\n",
    "- all assets have the same price (normalized to 1),\n",
    "- the full budget $B$ has to be spent, i.e. one has to select exactly $B$ assets.\n",
    "- the equality constraint $1^n x = B$ is mapped to a penalty term $(1^n x - B)^2$ which is scaled by a parameter and subtracted from the objective function. \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Step 1. Import necessary libraries"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-07-13T20:35:05.710593Z",
     "start_time": "2020-07-13T20:34:57.647535Z"
    },
    "slideshow": {
     "slide_type": "fragment"
    }
   },
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "Matplotlib is building the font cache; this may take a moment.\n"
     ]
    }
   ],
   "source": [
    "#Let us begin by importing necessary libraries.\n",
    "from qiskit import Aer\n",
    "from qiskit.algorithms import VQE, QAOA, NumPyMinimumEigensolver\n",
    "from qiskit.algorithms.optimizers import *\n",
    "from qiskit.circuit.library import TwoLocal\n",
    "from qiskit.utils import QuantumInstance\n",
    "from qiskit.utils import algorithm_globals\n",
    "from qiskit_finance import QiskitFinanceError\n",
    "from qiskit_finance.applications.optimization import PortfolioOptimization\n",
    "from qiskit_finance.data_providers import *\n",
    "from qiskit_optimization.algorithms import MinimumEigenOptimizer \n",
    "from qiskit_optimization.applications import OptimizationApplication\n",
    "from qiskit_optimization.converters import QuadraticProgramToQubo\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "%matplotlib inline\n",
    "import datetime\n",
    "import warnings\n",
    "from sympy.utilities.exceptions import SymPyDeprecationWarning\n",
    "warnings.simplefilter(\"ignore\", SymPyDeprecationWarning)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Step 2. Generate time series data (Financial Data)\n",
    "Let's first generate a random time series financial data for a total number of stocks n=4. We use RandomDataProvider for this. We are going back in time and retrieve financial data from November 5, 1955 to October 26, 1985."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-07-13T20:35:15.224327Z",
     "start_time": "2020-07-13T20:35:15.213892Z"
    },
    "slideshow": {
     "slide_type": "fragment"
    }
   },
   "outputs": [],
   "source": [
    "# Set parameters for assets and risk factor\n",
    "num_assets = 4     # set number of assets to 4\n",
    "q = 0.5                   # set risk factor to 0.5\n",
    "budget = 2           # set budget as defined in the problem\n",
    "seed = 132     #set random seed\n",
    "\n",
    "# Generate time series data\n",
    "stocks = [(\"STOCK%s\" % i) for i in range(num_assets)]\n",
    "data = RandomDataProvider(tickers=stocks,\n",
    "                 start=datetime.datetime(1955,11,5),   \n",
    "                 end=datetime.datetime(1985,10,26),  \n",
    "                 seed=seed)\n",
    "data.run()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Let's plot our finanical data\n",
    "for (cnt, s) in enumerate(data._tickers):\n",
    "    plt.plot(data._data[cnt], label=s)\n",
    "plt.legend()\n",
    "plt.xticks(rotation=90)\n",
    "plt.xlabel('days')\n",
    "plt.ylabel('stock value')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "<div id='problem'></div>\n",
    "<div class=\"alert alert-block alert-danger\">\n",
    "    \n",
    "**WARNING** Please do not change the start/end dates that are given to the RandomDataProvider in this challenge. Otherwise, your answers will not be graded properly.\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Step 3. Quadratic Program Formulation\n",
    "\n",
    "Let's generate the expected return first and then the covariance matrix which are both needed to create our portfolio."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "fragment"
    }
   },
   "source": [
    "### Expected Return μ\n",
    "Expected return of a portfolio is the anticipated amount of returns that a portfolio may generate, making it the mean (average) of the portfolio's possible return distribution. \n",
    "For example, let's say stock A, B and C each weighted 50%, 20% and 30% respectively in the portfolio.  If the expected return for each stock was 15%, 6% and 9% respectively, the expected return of the portfolio would be:\n",
    "\n",
    "\n",
    "<div align=\"center\"> μ = (50% x 15%) + (20% x 6%) + (30% x 9%) = 11.4% </div>\n",
    "\n",
    "For the problem data we generated earlier, we can calculate the expected return over the 30 years period from 1955 to 1985 by using the following `get_period_return_mean_vector()` method which is provided by Qiskit's RandomDataProvider."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "slideshow": {
     "slide_type": "fragment"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[1.59702144e-04 4.76518943e-04 2.39123234e-04 9.85029012e-05]\n"
     ]
    }
   ],
   "source": [
    "#Let's calculate the expected return for our problem data\n",
    "\n",
    "mu = data.get_period_return_mean_vector()   # Returns a vector containing the mean value of each asset's expected return.\n",
    "\n",
    "print(mu)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "### Covariance Matrix Σ\n",
    "Covariance Σ is a statistical measure of how two asset's mean returns vary with respect to each other and helps us understand the amount of risk involved from an investment portfolio's perspective to make an informed decision about buying or selling stocks. \n",
    "\n",
    "If you have 'n' stocks in your porfolio, the size of the covariance matrix will be n x n.\n",
    "Let us plot the covariance marix for our 4 stock portfolio which will be a 4 x 4 matrix. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "slideshow": {
     "slide_type": "subslide"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[[ 4.88319903e-05 -1.07868619e-06 -2.12961489e-06  7.06600109e-07]\n",
      " [-1.07868619e-06  9.97360142e-04  3.51594354e-06  3.68715793e-07]\n",
      " [-2.12961489e-06  3.51594354e-06  2.87365468e-04  3.20819120e-06]\n",
      " [ 7.06600109e-07  3.68715793e-07  3.20819120e-06  1.92316728e-04]]\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 2 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Let's plot our covariance matrix Σ（sigma）\n",
    "sigma = data.get_period_return_covariance_matrix() #Returns the covariance matrix of the four assets\n",
    "print(sigma)\n",
    "fig, ax = plt.subplots(1,1)\n",
    "im = plt.imshow(sigma, extent=[-1,1,-1,1])\n",
    "x_label_list = ['stock3', 'stock2', 'stock1', 'stock0']\n",
    "y_label_list = ['stock3', 'stock2', 'stock1', 'stock0']\n",
    "ax.set_xticks([-0.75,-0.25,0.25,0.75])\n",
    "ax.set_yticks([0.75,0.25,-0.25,-0.75])\n",
    "ax.set_xticklabels(x_label_list)\n",
    "ax.set_yticklabels(y_label_list)\n",
    "plt.colorbar()\n",
    "plt.clim(-0.000002, 0.00001)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "subslide"
    }
   },
   "source": [
    "The left-to-right diagonal values (yellow boxes in the figure below) show the relation of a stock with 'itself'. And the off-diagonal values show the deviation of each stock's mean expected return with respect to each other.  A simple way to look at a covariance matrix is:\n",
    "\n",
    " - If two stocks increase and decrease simultaneously then the covariance value will be positive.\n",
    " - If one increases while the other decreases then the covariance will be negative.\n",
    "\n",
    "<center><img src= \"resources/ex1-05.png\" width=\"370\"></center>\n",
    "\n",
    "You may have heard the phrase \"Don't Put All Your Eggs in One Basket.\" If you invest in things that always move in the same direction, there will be a risk of losing all your money at the same time. Covariance matrix is a nice measure to help investors diversify their assets to reduce such risk. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "Now that we have all the values we need to build our portfolio for optimization, we will look into Qiskit's Finance application class that will help us contruct the quadratic program for our problem."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Qiskit Finance application class\n",
    "\n",
    "In Qiskit, there is a dedicated [`PortfolioOptimization`](https://qiskit.org/documentation/finance/stubs/qiskit_finance.applications.PortfolioOptimization.html#qiskit_finance.applications.PortfolioOptimization) application to construct the quadratic program for portfolio optimizations.\n",
    "\n",
    "PortfolioOptimization class creates a porfolio instance by taking the following **five arguments** then converts the instance into a quadratic program.\n",
    "\n",
    "Arguments of the PortfolioOptimization class:\n",
    "- expected_returns\n",
    "- covariances\n",
    "- risk_factor\n",
    "- budget\n",
    "- bounds\n",
    "\n",
    "Once our portfolio instance is converted into a quadratic program, then we can use quantum variational algorithms suchs as Variational Quantum Eigensolver (VQE) or the Quantum Approximate Optimization Algorithm (QAOA) to find the optimal solution to our problem.<br>\n",
    "\n",
    "We already obtained expected_return and covariances from Step 3 and have risk factor and budget pre-defined. So, let's build our portfolio using the [`PortfolioOptimization`](https://qiskit.org/documentation/finance/stubs/qiskit_finance.applications.PortfolioOptimization.html#qiskit_finance.applications.PortfolioOptimization) class.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
     "slide_type": "slide"
    }
   },
   "source": [
    "## Challenge 1a: Create the portfolio instance using PortfolioOptimization class\n",
    "<div id='u-definition'></div>\n",
    "<div class=\"alert alert-block alert-success\">\n",
    "\n",
    "**Challenge 1a** <br>\n",
    "Complete the code to generate the portfolio instance using the [**PortfolioOptimization**](https://qiskit.org/documentation/finance/stubs/qiskit_finance.applications.PortfolioOptimization.html#qiskit_finance.applications.PortfolioOptimization) class. Make sure you use the **five arguments** and their values which were obtained in the previos steps and convert the instance into a quadratic program **qp**. \n",
    "</div>\n",
    "\n",
    "<div id='problem'></div>\n",
    "<div class=\"alert alert-block alert-info\">\n",
    "    \n",
    "**Note:** A binary list [1. 1. 0. 0.] indicates a portfolio consisting STOCK2 and STOCK3.\n",
    "    \n",
    "</div>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-07-13T20:35:15.231767Z",
     "start_time": "2020-07-13T20:35:15.226490Z"
    },
    "slideshow": {
     "slide_type": "fragment"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\\ This file has been generated by DOcplex\n",
      "\\ ENCODING=ISO-8859-1\n",
      "\\Problem name: Portfolio optimization\n",
      "\n",
      "Minimize\n",
      " obj: - 0.000159702144 x_0 - 0.000476518943 x_1 - 0.000239123234 x_2\n",
      "      - 0.000098502901 x_3 + [ 0.000048831990 x_0^2 - 0.000002157372 x_0*x_1\n",
      "      - 0.000004259230 x_0*x_2 + 0.000001413200 x_0*x_3 + 0.000997360142 x_1^2\n",
      "      + 0.000007031887 x_1*x_2 + 0.000000737432 x_1*x_3 + 0.000287365468 x_2^2\n",
      "      + 0.000006416382 x_2*x_3 + 0.000192316728 x_3^2 ]/2\n",
      "Subject To\n",
      " c0: x_0 + x_1 + x_2 + x_3 = 2\n",
      "\n",
      "Bounds\n",
      " 0 <= x_0 <= 1\n",
      " 0 <= x_1 <= 1\n",
      " 0 <= x_2 <= 1\n",
      " 0 <= x_3 <= 1\n",
      "\n",
      "Binaries\n",
      " x_0 x_1 x_2 x_3\n",
      "End\n",
      "\n"
     ]
    }
   ],
   "source": [
    "##############################\n",
    "# Provide your code here\n",
    "\n",
    "portfolio = PortfolioOptimization(expected_returns=mu, covariances=sigma, risk_factor=q, budget=budget, bounds=None)\n",
    "qp = portfolio.to_quadratic_program()\n",
    "\n",
    "##############################\n",
    "print(qp)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you were able to successfully generate the code, you should see a standard representation of the formulation of our qudratic program. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Submitting your answer for 1a. Please wait...\n",
      "Congratulations 🎉! Your answer is correct and has been submitted.\n"
     ]
    }
   ],
   "source": [
    "# Check your answer and submit using the following code\n",
    "from qc_grader import grade_ex1a\n",
    "grade_ex1a(qp)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Minimum Eigen Optimizer\n",
    "\n",
    "Interestingly, our portfolio optimization problem can be solved as a ground state search of a Hamiltonian. You can think of a Hamiltonian as an energy function representing the total energy of a physical system we want to simulate such as a molecule or a magnet. The physical system can be further represented by a mathemetical model called an [**Ising model**](https://en.wikipedia.org/wiki/Ising_model) which gives us a framework to convert our binary variables into a so called spin up (+1) or spin down (-1) state. \n",
    "    \n",
    "When it comes to applyting the optimization algorithms, the algorithms usually require problems to satisfy certain criteria to be applicable. For example, variational algorithms such as VQE and QAOA can only be applied to [**Quadratic Unconstrained Binary Optimization (QUBO)**](https://en.wikipedia.org/wiki/Quadratic_unconstrained_binary_optimization) problems, thus Qiskit provides converters to automatically map optimization problems to these different formats whenever possible.\n",
    "\n",
    "<center><img src= \"resources/ex1-04.png\" width=\"700\"></center>\n",
    "\n",
    "Solving a QUBO is equivalent to finding a ground state of a Hamiltonian. And the Minimum Eigen Optimizer translates the Quadratic Program to a Hamiltonian, then calls a given Mimimum Eigensolver such as VQE or QAOA to compute the ground states and returns the optimization results for us.\n",
    "    \n",
    "This approach allows us to utilize computing ground states in the context of solving optimization problems as we will demonstrate in the next step in our challenge exercise."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 5. Solve with classical optimizer as a reference\n",
    "Lets solve the problem. First classically...\n",
    "\n",
    "We can now use the Operator we built above without regard to the specifics of how it was created. We set the algorithm for the NumPyMinimumEigensolver so we can have a classical reference. Backend is not required since this is computed classically not using quantum computation. The result is returned as a dictionary."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-07-13T20:35:15.264319Z",
     "start_time": "2020-07-13T20:35:15.245811Z"
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "optimal function value: -0.00023285626449450194\n",
      "optimal value: [1. 0. 1. 0.]\n",
      "status: SUCCESS\n"
     ]
    }
   ],
   "source": [
    "exact_mes = NumPyMinimumEigensolver()\n",
    "exact_eigensolver = MinimumEigenOptimizer(exact_mes)\n",
    "result = exact_eigensolver.solve(qp)\n",
    "\n",
    "print(result)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The optimal value indicates your asset allocation. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Challenge1b: Solution using VQE\n",
    "\n",
    "**Variational Quantum Eigensolver (VQE)** is a classical-quantum hybrid algorithm which outsources some of the processing workload to a classical computer to efficiently calculate the ground state energy (lowest energy) of a [**Hamiltonian**](https://en.wikipedia.org/wiki/Hamiltonian_(quantum_mechanics)). As we discussed earlier, we can reformulate the quadratic program as a ground state energy search to be solved by [**VQE**](https://qiskit.org/documentation/stubs/qiskit.algorithms.VQE.html) where the ground state corresponds to the optimal solution we are looking for. In this challenge exercise, you will be asked to find the optimal solution using VQE.  <br> \n",
    "\n",
    "\n",
    "<div id='u-definition'></div>\n",
    "<div class=\"alert alert-block alert-success\">\n",
    "\n",
    "**Challenge 1b** <br>\n",
    "Find the same solution by using Variational Quantum Eigensolver (VQE) to solve the problem.　We will specify the optimizer and variational form to be used.\n",
    "</div>\n",
    "\n",
    "<div id='problem'></div>\n",
    "<div class=\"alert alert-block alert-info\">\n",
    "\n",
    "**HINT:** If you are stuck, check out [**this qiskit tutorial**](https://qiskit.org/documentation/finance/tutorials/01_portfolio_optimization.html) and adapt it to our problem: \n",
    "    \n",
    "</div>\n",
    "\n",
    "Below is some code to get you started. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-07-13T20:35:28.570970Z",
     "start_time": "2020-07-13T20:35:26.539093Z"
    },
    "scrolled": true
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "optimal function value: -0.00023285626449450194\n",
      "optimal value: [1. 0. 1. 0.]\n",
      "status: SUCCESS\n"
     ]
    }
   ],
   "source": [
    "optimizer = SLSQP(maxiter=1000)  \n",
    "algorithm_globals.random_seed = 1234\n",
    "backend = Aer.get_backend('statevector_simulator')\n",
    "\n",
    "\n",
    "##############################\n",
    "# Provide your code here\n",
    "quantum_instance = QuantumInstance(backend=backend)\n",
    "\n",
    "vqe = VQE(ansatz=None, \n",
    "          optimizer=optimizer, \n",
    "          initial_point=None, \n",
    "          gradient=None, \n",
    "          expectation=None, \n",
    "          include_custom=False, \n",
    "          max_evals_grouped=1, \n",
    "          callback=None, \n",
    "          quantum_instance=quantum_instance, \n",
    "          sort_parameters_by_name=None)\n",
    "\n",
    "\n",
    "##############################\n",
    "\n",
    "vqe_meo = MinimumEigenOptimizer(vqe)  #please do not change this code\n",
    "\n",
    "result = vqe_meo.solve(qp)  #please do not change this code\n",
    "\n",
    "print(result)    #please do not change this code"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Submitting your answer for 1b. Please wait...\n",
      "Congratulations 🎉! Your answer is correct and has been submitted.\n"
     ]
    }
   ],
   "source": [
    "# Check your answer and submit using the following code\n",
    "from qc_grader import grade_ex1b\n",
    "grade_ex1b(vqe, qp)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "VQE should give you the same optimal results as the reference solution."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Challenge 1c: Portfolio optimization for B=3, n=4 stocks\n",
    "\n",
    "In this exercise, solve the same problem where one can allocate double weights (can allocate twice the amount) for a single asset.  (For example, if you allocate twice for STOCK3 one for STOCK2, then your portfolio can be represented as [2, 1, 0, 0]. If you allocate a single weight for STOCK0, STOCK1, STOCK2 then your portfolio will look like [0, 1, 1, 1]) <br>\n",
    "Furthermore, change the constraint to B=3.  With this new constraint, find the optimal portfolio that minimizes the tradeoff between risk and return.\n",
    "\n",
    "<div id='u-definition'></div>\n",
    "<div class=\"alert alert-block alert-success\">\n",
    "\n",
    "**Challenge 1c** <br>\n",
    "Complete the code to generate the portfolio instance using the PortfolioOptimization class. <br>\n",
    "Find the optimal portfolio for budget=3 where one can allocate double weights for a single asset.<br>\n",
    "Use QAOA to find your optimal solution and submit your answer.\n",
    "    \n",
    "</div>\n",
    "\n",
    "<div id='problem'></div>\n",
    "<div class=\"alert alert-block alert-info\">\n",
    "    \n",
    "**HINT:**  Remember that any one of STOCK0, STOCK1, STOCK2, STOCK3 can have double weights in our portfolio. How can we change our code to accommodate integer variables? <br>\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 1: Import necessary libraries"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [],
   "source": [
    "#Step 1: Let us begin by importing necessary libraries\n",
    "import qiskit\n",
    "from qiskit import Aer\n",
    "from qiskit.algorithms import VQE, QAOA, NumPyMinimumEigensolver\n",
    "from qiskit.algorithms.optimizers import *\n",
    "from qiskit.circuit.library import TwoLocal\n",
    "from qiskit.utils import QuantumInstance\n",
    "from qiskit.utils import algorithm_globals\n",
    "from qiskit_finance import QiskitFinanceError\n",
    "from qiskit_finance.applications.optimization import *\n",
    "from qiskit_finance.data_providers import *\n",
    "from qiskit_optimization.algorithms import MinimumEigenOptimizer\n",
    "from qiskit_optimization.applications import OptimizationApplication\n",
    "from qiskit_optimization.converters import QuadraticProgramToQubo\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "%matplotlib inline\n",
    "import datetime\n",
    "import warnings\n",
    "from sympy.utilities.exceptions import SymPyDeprecationWarning\n",
    "warnings.simplefilter(\"ignore\",SymPyDeprecationWarning)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 2: Generate Time Series Data (Financial Data)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Step 2. Generate time series data for four assets. \n",
    "# Do not change start/end dates specified to generate problem data.\n",
    "seed = 132 \n",
    "num_assets = 4\n",
    "stocks = [(\"STOCK%s\" % i) for i in range(num_assets)]\n",
    "data = RandomDataProvider(tickers=stocks,\n",
    "                 start=datetime.datetime(1955,11,5),   \n",
    "                 end=datetime.datetime(1985,10,26),  \n",
    "                 seed=seed)\n",
    "data.run()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Let's plot our finanical data (We are generating the same time series data as in the previous example.)\n",
    "for (cnt, s) in enumerate(data._tickers):\n",
    "    plt.plot(data._data[cnt], label=s)\n",
    "plt.legend()\n",
    "plt.xticks(rotation=90)\n",
    "plt.xlabel('days')\n",
    "plt.ylabel('stock value')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 3: Calculate expected return mu and covariance sigma"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[1.59702144e-04 4.76518943e-04 2.39123234e-04 9.85029012e-05] [[ 4.88319903e-05 -1.07868619e-06 -2.12961489e-06  7.06600109e-07]\n",
      " [-1.07868619e-06  9.97360142e-04  3.51594354e-06  3.68715793e-07]\n",
      " [-2.12961489e-06  3.51594354e-06  2.87365468e-04  3.20819120e-06]\n",
      " [ 7.06600109e-07  3.68715793e-07  3.20819120e-06  1.92316728e-04]]\n"
     ]
    }
   ],
   "source": [
    "# Step 3. Calculate mu and sigma for this problem\n",
    "\n",
    "mu2 = data.get_period_return_mean_vector()   #Returns a vector containing the mean value of each asset.\n",
    "sigma2 = data.get_period_return_covariance_matrix() #Returns the covariance matrix associated with the assets.\n",
    "print(mu2, sigma2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 4: Set parameters and constraints based on this challenge 1c."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Step 4. Set parameters and constraints based on this challenge 1c\n",
    "\n",
    "##############################\n",
    "# Provide your code here\n",
    "\n",
    "q2 = 0.5     #Set risk factor to 0.5\n",
    "budget2 = 3     #Set budget to 3\n",
    "\n",
    "##############################"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 5: Complete code to generate the portfolio instance"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Step 5. Complete code to generate the portfolio instance\n",
    "\n",
    "\n",
    "##############################\n",
    "# Provide your code here\n",
    "\n",
    "bounds2 = [(0,2)]*4\n",
    "portfolio2 = PortfolioOptimization(expected_returns=mu2, covariances=sigma2, risk_factor=q2, budget=budget2, bounds=bounds2)\n",
    "qp2 = portfolio2.to_quadratic_program()\n",
    "\n",
    "##############################"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 6: Let's solve the problem using QAOA\n",
    "\n",
    "**Quantum Approximate Optimization Algorithm (QAOA)** is another variational algorithm that has applications for solving combinatorial optimization problems on near-term quantum systems. This algorithm can also be used to calculate ground states of a Hamiltonian and can be easily implemented by using Qiskit's [**QAOA**](https://qiskit.org/documentation/stubs/qiskit.algorithms.QAOA.html) application. (You will get to learn about QAOA in detail in challenge 4. Let us first focus on the basic implementation of QAOA using Qiskit in this exercise.)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "optimal function value: -0.00032144003832501437\n",
      "optimal value: [2. 0. 1. 0.]\n",
      "status: SUCCESS\n"
     ]
    }
   ],
   "source": [
    "# Step 6. Now let's use QAOA to solve this problem. \n",
    "\n",
    "optimizer = SLSQP(maxiter=1000)  \n",
    "algorithm_globals.random_seed = 1234\n",
    "backend = Aer.get_backend('statevector_simulator')\n",
    "\n",
    "##############################\n",
    "# Provide your code here \n",
    "\n",
    "quantum_instance2 = QuantumInstance(backend=backend)\n",
    "\n",
    "qaoa = QAOA(optimizer=optimizer, \n",
    "           reps=1, \n",
    "           initial_state=None, \n",
    "           mixer=None, \n",
    "           initial_point=None, \n",
    "           gradient=None, \n",
    "           expectation=None, \n",
    "           include_custom=False, \n",
    "           max_evals_grouped=1, \n",
    "           callback=None, \n",
    "           quantum_instance=quantum_instance2)\n",
    "\n",
    "\n",
    "##############################\n",
    "\n",
    "qaoa_meo = MinimumEigenOptimizer(qaoa) #please do not change this code\n",
    "\n",
    "result2 = qaoa_meo.solve(qp2)  #please do not change this code\n",
    "\n",
    "print(result2) #please do not change this code"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note: The QAOA execution may take up to a few minutes to complete. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Submit your answer"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Submitting your answer for 1c. Please wait...\n",
      "Congratulations 🎉! Your answer is correct and has been submitted.\n"
     ]
    }
   ],
   "source": [
    "# Check your answer and submit using the following code\n",
    "from qc_grader import grade_ex1c\n",
    "grade_ex1c(qaoa, qp2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Further Reading:\n",
    "For those who have successfully solved the first introductory level challenge, **congratulations!** <br>\n",
    "I hope you were able to learn something about optimizing portfolios and how you can use Qiskit's Finance module to solve the example problem. <br> If you are interested in further reading, here are a few literature to explore:\n",
    "<br>\n",
    "1. [**Quantum optimization using variational algorithms on near-term quantum devices. Moll et al. 2017**](https://arxiv.org/abs/1710.01022)<br>\n",
    "2. [**Improving Variational Quantum Optimization using CVaR. Barkoutsos et al. 2019.**](https://arxiv.org/abs/1907.04769)<br>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Good luck and have fun with the challenge!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Additional information\n",
    "\n",
    "**Created by:** Yuri Kobayashi\n",
    "\n",
    "**Version:** 1.0.1"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Qiskit v0.31.0 (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.8.10"
  },
  "varInspector": {
   "cols": {
    "lenName": 16,
    "lenType": 16,
    "lenVar": 40
   },
   "kernels_config": {
    "python": {
     "delete_cmd_postfix": "",
     "delete_cmd_prefix": "del ",
     "library": "var_list.py",
     "varRefreshCmd": "print(var_dic_list())"
    },
    "r": {
     "delete_cmd_postfix": ") ",
     "delete_cmd_prefix": "rm(",
     "library": "var_list.r",
     "varRefreshCmd": "cat(var_dic_list()) "
    }
   },
   "types_to_exclude": [
    "module",
    "function",
    "builtin_function_or_method",
    "instance",
    "_Feature"
   ],
   "window_display": false
  },
  "widgets": {
   "application/vnd.jupyter.widget-state+json": {
    "state": {},
    "version_major": 2,
    "version_minor": 0
   }
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}