{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Your owe a bike store. During week $t$, the (random) demand is $D_t$ units. \n",
    "On Monday morning you may choose to command $a_t$ additional units: they are delivered immediately before the shop opens. For each week:\n",
    "\n",
    "  * Maintenance cost: $h(s)$ for $s$ units in stock left from the previous week (no maintenance is needed for newly commanded items)\n",
    "  * Command cost: $C(a)$ for $a$ units\n",
    "  * Sales profit: $f(q)$ for $q$ units sold\n",
    "  * Constraint: \n",
    "    - your warehouse has a maximal capacity of $M$ unit (any additionnal bike gets stolen)\n",
    "    - you cannot sell bikes that you don't have in stock\n",
    "\n",
    "\n",
    "* State: number of bikes in stock left from the last week => state space $\\mathcal{S} = \\{0,\\dots, M\\}$\n",
    "* Action: number of bikes commanded at the beginning of the week => action space $\\mathcal{A} = \\{0, \\dots ,M\\}$ \n",
    "* Reward = balance of the week: if you command $A_t$ bikes,\n",
    "$$X_t = - C(A_t) - h(S_t) + f\\big(\\min(D_t, S_t+A_t, M) \\big)$$\n",
    "* Transitions: you end the week with $S_{t+1} = \\max\\big(0, \\min(M, S_t + A_t)  - D_t \\big)$ bikes"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* State: number of bikes in stock left from the last week => state space $\\mathcal{S} = \\{0,\\dots, M\\}$\n",
    "* Action: number of bikes commanded at the beginning of the week => action space $\\mathcal{A} = \\{0, \\dots ,M\\}$ \n",
    "* Reward = balance of the week: if you command $A_t$ bikes,\n",
    "$$X_t = - C(A_t) - h(S_t) + f\\big(\\min(D_t, S_t+A_t, M) \\big)$$\n",
    "* Transitions: you end the week with $S_{t+1} = \\max\\big(0, \\min(M, S_t + A_t)  - D_t \\big)$ bikes"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here we assume that $h(s) = h\\cdot s$, $f(q) = p\\cdot q$, $C(a) = c_0 \\mathbb{1}\\{a>0\\} + c\\cdot a$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Using matplotlib backend: Qt5Agg\n",
      "Populating the interactive namespace from numpy and matplotlib\n"
     ]
    }
   ],
   "source": [
    "%pylab\n",
    "\n",
    "## Constants of the problem\n",
    "M = 15 # stock capacity\n",
    "h = 0.3 # maintenance cost per unit and per week-end\n",
    "p = 1 # selling price per unit\n",
    "c0 = 0.8 # shpping cost per command\n",
    "c = 0.5 # buying price per unit\n",
    "\n",
    "s0 = M # initial stock\n",
    "gamma = 0.99 # discount factor: I do not care what happens after more than 100 weeks (but in fact the optimal policy has a limit when gamma tends to 1)\n",
    "\n",
    "## The demand \n",
    "\n",
    "avgdem = 9 # average demand\n",
    "# demande distribution function (everything >=M is grouped together since at most M bikes can be sold anyway)\n",
    "# pdem = [exp(-avgdem) * avgdem^(big(k)) / factorial(big(k)) for k in 0:M] # Poisson demand (small tail)\n",
    "pdem = [1/(1+avgdem)*(1-1/(1+avgdem))**k for k in range(M+1)]# Exponential demand (large tail)\n",
    "pdem[M] = 1 - sum(pdem[0:M])\n",
    "cpdem = cumsum(pdem)\n",
    "def rdemand():\n",
    "    u = random.random()# random demand generator\n",
    "    return( sum(u>cpdem) )"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Transition and Reward functions\n",
    "\n",
    "def reward(s, a, d):\n",
    "    return( -h*(s) -c0*(a>0) - c*a + p * min(d, s+a, M) )\n",
    "\n",
    "def nextState(s, a, d):\n",
    "    return( max(0, min(M, s+a)-d) )\n",
    "\n",
    "def simu(T, pi):\n",
    "    X = zeros(T+1)\n",
    "    S = s0\n",
    "    for t in range(T+1):\n",
    "        A = pi(S)\n",
    "        D = rdemand()\n",
    "        X[t] = reward(S, A, D)\n",
    "        S = nextState(S, A, D)\n",
    "    return(X)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA0UAAAGpCAYAAABCnp1lAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjAsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+17YcXAAAgAElEQVR4nOzdd3xUVfrH8c9NJw3S6ISEDoFAKIKAFFlsIAKi2FDEXtayq/7c1dV11222XXXtjVWxo4Jgw0JTkC6995IQegKk398fJ8mdSSYhwEwmId/365UX59x7584zSYB55pzzHMu2bUREREREROqqAH8HICIiIiIi4k9KikREREREpE5TUiQiIiIiInWakiIREREREanTlBSJiIiIiEidFuTvALwhPj7eTkpK8ncYIiIiIiJSQy1evHifbdsJns6dEUlRUlISixYt8ncYIiIiIiJSQ1mWta2ic5o+JyIiIiIidZqSIhERERERqdOUFImIiIiISJ12Rqwp8iQ/P5+dO3eSk5Pj71DkJIWFhdG8eXOCg4P9HYqIiIiI1AFnbFK0c+dOoqKiSEpKwrIsf4cjVWTbNvv372fnzp0kJyf7OxwRERERqQPO2OlzOTk5xMXFKSGqZSzLIi4uTiN8IiIiIlJtztikCFBCVEvp5yYiIiIi1emMTopERERERERORElRLZKUlMS+ffv8HQaRkZEA7N69mzFjxvg5GhERERGR06OkqBrYtk1RUZG/w/C6pk2b8sknn/g7DBERERGR06KkyEe2bt1Kx44duf322+nevTs7duzgtttuo2fPnqSkpPDoo4+WXpuUlMSjjz5K9+7d6dKlC2vXrgVg//79nHfeeaSlpXHLLbdg23bpY5555hk6d+5M586d+c9//lP6nB06dODGG2+kc+fOXH311Xz33Xf069ePtm3bsmDBgnJxTpw4kUsuuYQLLriA9u3b89hjj1X6HGVfY+fOnQEoLCzkvvvuo0uXLqSmpvL888/z/fffM2rUqNLrZ8yYwejRo0/zOysiIiIi4l1nbEluV0kPTvfZvbf+c1iF59atW8dbb73Fiy++CMDf/vY3YmNjKSwsZMiQISxfvpzU1FQA4uPjWbJkCS+++CJPPfUUr7/+Oo899hj9+/fnkUceYfr06bz66qsALF68mLfeeotffvkF27bp3bs3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EyaQmZlJQkICb731FomJiYwfP57o6GgWLVpEeno6TzzxBGPGjGHPnj2MHTuWI0eOUFBQwEsvvcT06dM5fvw43bp1IyUlhUmTJjFy5Eh27NhBTk4Od999NzffbDanjIyM5O6772batGnUq1ePKVOmsGnTJqZOncqsWbN4/PHHmTx5Mq1bO/sIjB8/nrCwMFatWkVGRgbPPPMMw4cPJycnh9tuu41FixYRFBTEM888w+DBg91es+tmsBkZGdx6661s3rwZgJdeeomvvvqK+Ph47r77bgAeeughGjVqxF133VVNPxWp9bbPhx//7vQH3AetBprRo5gk90/R4tqaMq6uYpJMFaCN3wG2SaTGfwkJ7Xwfu4hICds2hQh2LTbrIzPXmUpexw+6XxcUZtaQpI6FFmeZNS2/fmCmLo143ryZbXEW9L/XTPnasxw2/QAbviletN8eWvQ2b+KtANj4PWycYe4d1RSueK/6EiIwlezCok/vHpblOWbLgqR+5uvCf5nv0+KJzohMo85mVGn7PGekyXVNqhVo1jeFRJjRlpBwiGhoqu4l9TfTyCpK5CzL/BxO5jU07eb5XHwbGPKI58c07mK+Bv6fmVa5fZ752TbsBOu+NFXv7CIzknXuw2ZEruwoT1xr6HBR1WOtI+rGSNGf6/vuyf982OPhVatWMXr0aH766Sfi4+M5cOAAsbGxXHzxxYwZM4brrruON998k6lTp/L5558zfvx4jh49yocffsjatWsZMWIEGzdu5OmnnyYnJ4eHHnqIwsJCjh07RlRUVLmRopL7Hz9+nF69ejFr1izi4uKwLIupU6dy8cUX88ADDxAdHc3DDz9c6UjR+PHjSU9P58svv2TTpk0MHjyYjRs38sILL7By5Ureeust1q5dy3nnncf69euZP39+6UiRa1I0duxYzj77bO655x4KCwvJzs7m4MGDjB49miVLllBUVETbtm1ZsGABcXFxbjFopEg8OnYAXhlg5tUDJJ4N101zpl/M/Td892fn+orWDGWsgjcvcErKRjaGCV9DbPKJY8jea6YlxCSdzisRkbosfSVM/135RfSuIhvDoAfNgvowL7+P2bfBJGNthkJE3Imvr81s2ySbgSHu++SsnGxKi+cUv4+LbASXTYSWff0Sptcc3GY+HGzZV4WEPNBIkR/88MMPjBkzhvh4U4UjNjYWgHnz5vHp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Bn/19XHccHrRUf38TqS4JEVm9iYwMMahB4BfAW8DdwGnAnOB4cDvgIWHJEWvOudeau+9NFMkIiIiEptz7qg26rdMjJIMHr7qK1wz+fAbwpZW1HDvC5+yYlukKEFGio9rJw/m/ktHk+JPoq4pSPmBRobkZpDsMz4s3cOzH2/Bl2Q8cNkYCnLS2VRZyxPvbWJ9RQ079zeQnuzjl1eOO+GFLbqr+at38fi7G+mVnszpw3J5b33lYRX1zODy8fmMy+/No29viCauyT5jclEuXxufz+nDc1lctpfXPtvF+4dUXPQnWbRAx7Hon53KyQW9aQ6FyclI4RunFHDOSf1YsHEPsxZsYfHmvSz46fTjKtDRUbriTNHrwEPOuXe95xuBKcAtoOVzIiIiIvGwu7qReSt2cMbwvFbV7WIJhML4zI6qFLl0rHDY8eKy7Tz2Timbq+o7/f19ScZZxXl8c/JgLhw7ILqsLpaaxgDZXhn4eOuKSdEPgXzn3D+b2UnAW8AQYAzwFw4WWngLKFGhBRERERGR1sJhx8JNVTz1YRlvra1odWxwbjppfh8bKmpjvtYMppb0Y0huOq98Ws6++gCDeqdx89nDKD/QyHOfbKExEOa0obk8ePkYslL9fLypiiQzpo/qT9+stm9U3FV1xaQoBXgKmAA0E9lT9LZ37AHge0RKdd/tnHvtSNdTUiQiIiIiiWzplr3MfGMDmypruWFKEbdMHUaq3xe9/9G8FTsp21PH2PxeTB/Vn4vGDmRwbqSsenMwcv+ooXmZ0VmfAw0BKqobKe4f+55S3VGXS4o6mpIiERERERFpT3tJUdsLAEVERERERBKAkiIREREREUloSopERERERCShKSkSEREREZGEpqRIREREREQSmpIiERERERFJaEqKREREREQkoSkpEhERERGRhKakSEREREREEpqSIhERERERSWhKikREREREJKEpKRIRERERkYSmpEhERERERBKakiIREREREUloSopERERERCShmXMu3n04bmZWCWyJdz9ayAP2xLsT0uEU155Lse25FNueS7HtuRTbnqkrxLXIOdcv1oEekRR1NWa2xDk3Od79kI6luPZcim3Ppdj2XIptz6XY9kxdPa5aPiciIiIiIglNSZGIiIiIiCQ0JUUnxh/j3QE5IRTXnkux7bkU255Lse25FNueqUvHVXuKREREREQk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\n",
      "text/plain": [
       "<Figure size 1008x504 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Simulation: comparing two (basic) policies\n",
    "\n",
    "def randomPolicy(s):\n",
    "    return( random.choice(range(M+1)) )\n",
    "\n",
    "def constantPolicy(s):\n",
    "    return(6)\n",
    "\n",
    "T = int(3/(1-gamma))\n",
    "X1 = simu(T, randomPolicy)\n",
    "X2 = simu(T, constantPolicy)\n",
    "\n",
    "\n",
    "figure(figsize = [14, 7])\n",
    "plotDiscount = True\n",
    "if plotDiscount:\n",
    "    plot(cumsum(X1 * [gamma**t for t in range(T+1)]), linewidth=3)\n",
    "    plot(cumsum(X2* [gamma**t for t in range(T+1)]), linewidth=3)\n",
    "    legend([\"random policy\", \"constant policy\"])\n",
    "    xlabel(\"week\")\n",
    "    ylabel(\"cumulated profit\")\n",
    "else:\n",
    "    plot(cumsum(X1), linewidth=3)#\n",
    "    plot(cumsum(X2), linewidth=3) \n",
    "    legend([\"random policy\", \"constant policy\"])\n",
    "    xlabel(\"week\")\n",
    "    ylabel(\"cumulated profit\")\n",
    "    \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Transition and Reward kernels\n",
    "K = dict() # K[s,a][ns] = probability to skip from state s to state ns for the action a\n",
    "avgR = dict() # avgR[s,a] = average reward received in state s when playing action a\n",
    "\n",
    "## initialization\n",
    "for a in range(M+1):\n",
    "    for s in range(M+1):\n",
    "        K[s,a] = zeros(1+M)\n",
    "        avgR[s,a] = 0\n",
    "\n",
    "\n",
    "## computation: iterate over all possible states, actions, and possible demand values\n",
    "for a in range(M+1):\n",
    "    for s in range(M+1):\n",
    "        for d in range(M+1):\n",
    "            ns = nextState(s, a, d)\n",
    "            K[s,a][ns] += pdem[d]\n",
    "            avgR[s,a] += pdem[d] * reward(s, a, d)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([47.53820009, 47.68531763, 47.76434917, 47.77853042, 47.73159355,\n",
       "       47.62965037, 47.4782015 , 47.28219752, 47.04609394, 46.77390072,\n",
       "       46.47390072, 46.17390072, 45.87390072, 45.57390072, 45.27390072,\n",
       "       44.97390072])"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Markov transition matrix of a *deterministic* policy pi\n",
    "\n",
    "def policyTransitionMatrix(pi): # warning: requires pi to be *deterministic*\n",
    "    Kpi = zeros((1+M, 1+M))\n",
    "    for s in range(M+1):\n",
    "        Kpi[s,:] = K[s, pi(s)]\n",
    "    return(Kpi)\n",
    "\n",
    "\n",
    "def policyAvgReward(pi):\n",
    "    avgRpi = zeros(1+M)\n",
    "    for s in range(M+1):\n",
    "        avgRpi[s] = avgR[s, pi(s)]\n",
    "    return(avgRpi)\n",
    "  \n",
    "# example: for the constant policy\n",
    "# Kpi = policyTransitionMatrix(constantPolicy)\n",
    "# avgRpi = policyAvgReward(constantPolicy)\n",
    "\n",
    "# policy evaluation\n",
    "\n",
    "def evaluatePolicy(pi):\n",
    "    Kpi = policyTransitionMatrix(pi)\n",
    "    avgRpi = policyAvgReward(pi)\n",
    "    return(solve(identity(M+1) - gamma * Kpi, avgRpi) )\n",
    "\n",
    "evaluatePolicy(constantPolicy)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Planning"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[118.22021144 118.42021144 118.62021144 118.82021144 119.12239576\n",
      " 119.52292585 119.88971505 120.22280083 120.52222058 120.78801168\n",
      " 121.02021144 121.21885715 121.38398606 121.51563535 121.61384219\n",
      " 121.6786437 ]\n",
      "[10  9  8  7  0  0  0  0  0  0  0  0  0  0  0  0]\n"
     ]
    }
   ],
   "source": [
    "# Bellmann Operator\n",
    "def BellmannOperator(V): # TODO maybe: merge BellmannOperator and greedyPolicy by having BellmannOperator return the associated policy\n",
    "    nV = copy(V)    \n",
    "    for s in range(M+1):\n",
    "        nV[s] = max([avgR[s, a] + gamma * dot(K[s,a], V) for a in range(M+1)]) \n",
    "    return(nV)\n",
    "\n",
    "# Value Iteration\n",
    "def valueIteration(epsilon=1e-6): # epsilon = guaranteed precision\n",
    "    V = zeros(1+M)  # in theory, can be anything\n",
    "    oV = [v + 2*epsilon for v in V]\n",
    "    while norm(V-oV, inf) > epsilon*(1-gamma)/gamma:\n",
    "        oV = copy(V)\n",
    "        V = BellmannOperator(V)\n",
    "    return(V)\n",
    "\n",
    "def greedyPolicy(V):\n",
    "    pi = arange(M+1)# zeros(M+1)\n",
    "    for s in range(M+1):\n",
    "        w = [avgR[s, a] + gamma * dot(K[s,a], V) for a in range(M+1)]\n",
    "        pi[s] = w.index(max(w))\n",
    "    return(pi)\n",
    "\n",
    "optimalValue = valueIteration()\n",
    "print(optimalValue)\n",
    "piOpt = greedyPolicy(optimalValue)\n",
    "print(piOpt)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([10,  9,  8,  7,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0])"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Policy Iteration\n",
    "def policyIteration():\n",
    "    pi = random.choice(M+1, 1+M)\n",
    "    opi = (M+1)*ones(1+M)\n",
    "    while any(pi!=opi):\n",
    "        opi = copy(pi)\n",
    "        V = evaluatePolicy(lambda x:pi[x])\n",
    "        pi = greedyPolicy(V)\n",
    "    return(pi)\n",
    "\n",
    "policyIteration()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "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": [
    "# computing the optimal Q-table\n",
    "optimalQ = zeros((M+1, M+1))\n",
    "for s in range(M+1):\n",
    "    for a in range(M+1):\n",
    "        optimalQ[s, a]= avgR[s, a] + gamma * sum([K[s, a][ns] * optimalValue[ns] for ns in range(M+1) ])\n",
    "\n",
    "lS = [1, int(floor(M/3)), M-2]\n",
    "for s in lS:\n",
    "    plot(range(M+1), optimalQ[s, :], linewidth=3)\n",
    "xlabel(\"action\") \n",
    "ylabel(\"Q(s,a)\")\n",
    "legend([\"s=\"+str(x) for x in lS]);\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Stochastic Approximation for Policy Evaluation: TD(0) and TD($\\lambda$)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[47.93003137 47.98471526 47.92031067 48.07103879 48.14882099 48.06137495\n",
      " 48.07997386 47.8629625  47.61474379 47.0309938  46.84153945 46.67741362\n",
      " 46.50043005 46.62209525 45.49887849 46.16562477]\n",
      "[47.53820009 47.68531763 47.76434917 47.77853042 47.73159355 47.62965037\n",
      " 47.4782015  47.28219752 47.04609394 46.77390072 46.47390072 46.17390072\n",
      " 45.87390072 45.57390072 45.27390072 44.97390072]\n"
     ]
    }
   ],
   "source": [
    "def TD0(pi, T):\n",
    "    V = zeros(1+M) # V[S] = estimated value of each state under policy pi\n",
    "    V = 46*ones(1+M) # cheating a little (see comment at the end)\n",
    "    N = zeros(1+M) # N[S] = number of visits to state s in the loop\n",
    "    S = s0\n",
    "    for t in range(T):\n",
    "        N[S] = N[S] + 1\n",
    "        A = pi(S)\n",
    "        D = rdemand()\n",
    "        X = reward(S, A, D)\n",
    "        nS = nextState(S, A, D) \n",
    "        alpha = 1/(1+N[S])**0.5 \n",
    "        V[S] = (1-alpha)*V[S] + alpha * (X + gamma*V[nS])\n",
    "        S = nS\n",
    "    return(V)\n",
    "\n",
    "T = 10**6\n",
    "print(TD0(constantPolicy, T))\n",
    "print(evaluatePolicy(constantPolicy))\n",
    "# requires a huge number of iterations to converge... at least 10^7\n",
    "# because the initialization is too far from the solution: it takes forever to raise from 0 to 47"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Model-free Learning: Q-learning"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "0%\t\n",
      "10%\t\n",
      "20%\t\n",
      "30%\t\n",
      "40%\t\n",
      "50%\t\n",
      "60%\t\n",
      "70%\t\n",
      "80%\t\n",
      "90%\t\n",
      "[11.  8.  9.  9.  0.  0.  0.  0.  0.  0.  0.  0.  0.  0.  0.  0.]\n",
      "[117.83347294 118.00177058 118.23347294 118.39902958 118.7340041\n",
      " 119.13496525 119.50218505 119.83570094 120.13555033 120.40177058\n",
      " 120.63439903 120.83347294 120.99902958 121.13110613 121.22973975\n",
      " 121.29496756]\n",
      "[118.22021144 118.42021144 118.62021144 118.82021144 119.12239576\n",
      " 119.52292585 119.88971505 120.22280083 120.52222058 120.78801168\n",
      " 121.02021144 121.21885715 121.38398606 121.51563535 121.61384219\n",
      " 121.6786437 ]\n"
     ]
    }
   ],
   "source": [
    "def Qlearning(T):\n",
    "    # Q = zeros((1+M, 1+M) # Q-table\n",
    "    Q = 118*ones((1+M, 1+M)) # Q-table cheating with initialization\n",
    "    N = zeros(1+M) # number of visits to state s # rather take state-value?\n",
    "    epsilon = 0.3\n",
    "    S = s0\n",
    "    for t in range(T):\n",
    "        if mod(t, floor(T/10))==0:\n",
    "            print(int(100*t/T), \"%\\t\", sep=''); \n",
    "            if t==T:\n",
    "                print(\"\")\n",
    "        N[S] = N[S] + 1\n",
    "        if random.random()<epsilon: # /t^(1/4) # epsilon-greedy choice of action\n",
    "            A = random.choice(M+1)\n",
    "        else:\n",
    "            w = Q[S, :].tolist()\n",
    "            A = w.index(max(w)) # greedy action            \n",
    "\n",
    "        D = rdemand()\n",
    "        X = reward(S, A, D)\n",
    "        nS = nextState(S, A, D)\n",
    "        delta = X + gamma * max(Q[nS, :]) - Q[S, A]\n",
    "        alpha = 1/(1+N[S])**0.5 # alpha = 1/t^0.3 # warning: alpha should not be taken for an integer...\n",
    "        Q[S, A] = Q[S, A] + alpha * delta\n",
    "        S = nS        \n",
    "\n",
    "    pi = zeros(M+1)\n",
    "    for s in range(M+1):\n",
    "        w = Q[s,:].tolist()\n",
    "        pi[s] = w.index(max(w))\n",
    "    return(pi)\n",
    "\n",
    "T = 10**6\n",
    "pi = Qlearning(T)\n",
    "print(pi)\n",
    "print(evaluatePolicy(lambda s:pi[s]))\n",
    "print(optimalValue)\n",
    "\n",
    "\n",
    "# for T >= 10^7, we obtain correct policies\n",
    "# for T >= 10^8, we almost obtain the right one"
   ]
  }
 ],
 "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
}
