{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Systèmes de recommandation et algorithmes de bandits\n",
    "\n",
    "### Introduction :\n",
    "Les **systèmes de recommandation automatiques** à très grande échelle sont aujourd'hui omniprésents sur internet : ouvrages conseillés à l'achat dans les librairies en ligne, articles recommandés sur les sites d'information, sans parler des cadres publicitaires qui financent l'essentiel de très nombreux sites aujourd'hui... \n",
    "\n",
    "Trouver la meilleure recommandation à faire à un visiteur peut être considéré comme un **\"problème de bandits\"** : il faut en même temps apprendre ses préférences, et utiliser les interactions déjà passées pour maximiser le nombre de recommandations suivies, tout en restant capable de gérer des flux de données très importants. \n",
    "\n",
    "Nous présentons ici quelques-uns des algorithmes les plus célèbres pour résoudre ce type de problèmes, et notamment l'algorithme **$\\epsilon$-greedy**, l'algorithme **UCB** (Upper Confidence Bound), et l'algorithme **EXP3** (Exponential weights for Exploration and Exploitation). Leurs mérites respectifs sont soulignés et discutés, avec la présentation des résultats théoriques les plus importants les concernant. \n",
    "\n",
    "Nous montrons en outre comment expérimenter l'efficacité de ces méthodes pour la recommandation : ceci pose une difficulté particulière, car des jeux de données statiques rendent peu aisée l'évaluation de méthodes vouées à interagir avec des utilisateurs. Nous montrons en particulier comment mettre en place des expériences sur deux jeux de données célèbres : *movielens* et *jester*."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## I. Systèmes de recommandation"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Les **systèmes de recommandation (SR)** ont pour objectif de proposer à l’utilisateur des items (documents, objets, films, musiques, informations, etc.) susceptibles de l’intéresser. Deux approches principales sont mises en œuvre dans les SR : **le filtrage basé sur le contenu** recommande à un utilisateur des items similaires à ceux qu’il a déjà aimés par le passé et **le filtrage collaboratif** (FC) recommande les items appréciés par les utilisateurs qui ont auparavant fait des choix similaires à ceux de l’utilisateur. D’autres approches existent comme, par exemple, le filtrage démographique qui se base sur ce que l’on sait de l’utilisateur (âge, données démographiques, sexe, etc.) ; le filtrage communautaire qui utilise les décisions faites par les contacts de cet utilisateur (cette méthode est notamment utilisée dans les SR sociaux).\n",
    "\n",
    "De nombreux SR recommandent à chaque instant plusieurs objets à un utilisateur simultanément; ils sont qualifiés de **SR à tirages multiples**. L’utilisateur peut choisir de sélectionner un ou plusieurs objets parmi ceux qui lui ont été recommandés. Les recommandations sélectionnées sont généralement considérées comme pertinentes. L’utilisateur peut ne pas sélectionner de recommandation dans la liste qui lui est proposée. Il s’agit d’un **abandon** qui correspond donc au cas où aucune des recommandations n’est sélectionnée par l’utilisateur. Dans le but d’optimiser les performances d’un SR, nous considérons le problème de la minimisation de l’abandon, particulièrement adapté à la recommandation à tirages multiples. Ce problème peut également être vu comme la maximisation du nombre de fois où les utilisateurs sélectionnent au moins un objet parmi ceux recommandés simultanément.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## II. Modèles de bandits\n",
    "\n",
    "Afin d’améliorer la pertinence des recommandations pour l’utilisateur courant, un SR peut considérer l’historique des interactions passées avec les utilisateurs. Pour cela, il convient de mettre en place **une stratégie permettant d’apprendre sur la pertinence des objets tout en continuant de recommander des objets pertinents**. Lorsque toutes les\n",
    "données sont connues, il est possible d’estimer la pertinence des objets, c’est le cadre d’apprentissage supervisé (Hastie et al., 2009). Ce n’est pas un cadre réaliste pour un SR : de nouveaux utilisateurs et de nouveaux objets apparaissent continuellement. De plus, le choix des objets à recommander à chaque interaction est réalisé en fonction\n",
    "des interactions passées. \n",
    "\n",
    "Un tel environnement s’inscrit dans le cadre de ce que l’on appelle **l’apprentissage par renforcement** (Sutton et Barto, 1999). Il s’agit d’implémenter une stratégie pour obtenir de nouvelles informations (exploration), tout en assurant que le SR recommande des objets pertinents (exploitation). Ce problème est connu sous le nom de **\"dilemme exploration/exploitation\"**. \n",
    "\n",
    "\n",
    "Les **modèles de bandit** sont connus pour offrir une première approche formelle à ce dilemme.\n",
    "L'étude mathématique des problèmes de bandits remonte  à  l'article pionnier [1].  De  nombreux travaux  ont\n",
    "suivi, notamment dans  le champ de l'apprentissage statistique, en relation avec la théorie des jeux, l'apprentissage actif, et l'agrégation d'estimateurs : on pourra par exemple  se référer à l'ouvrage de  référence [2].  Dans\n",
    "cette littérature,  de nombreux problèmes tant  théoriques que computationnels\n",
    "sont abordés,  en combinant théorie des probabilités  et optimisation convexe.\n",
    "La   communauté  statistique   a  également   contribué,  notamment   sous  la\n",
    "dénomination   d'*inférence  séquentielle* (voir [3,4] et les références citées), avec un point de vue essentiellement asymptotique.\n",
    "\n",
    "Dans la version stochastique, la plus simple du problème, \n",
    "\n",
    " - à chaque étape $t=1,2,\\dots$ **l'agent choisit un bras** $A_t\\in\\{1,\\dots,K\\}$,\n",
    " - et **il reçoit une récompense** $X_t$ telle que, conditionnellement au choix des bras $A_1,A_2,\\dots$, les récompenses soient indépendantes et identiquement distribuées, d'espérances $\\mu_{A_1},\\mu_{A_2},\\dots$\n",
    " \n",
    "On appelle *politique* la règle de décision (potentiellement randomisée) qui, aux observations passées $(A_1,X_1,\\dots, A_{t-1}, X_{t-1})$, associe le prochain choix $A_t$. \n",
    "\n",
    "Le meilleur choix (inconnu de l'agent) est le bras $a^*$ qui correspond à la récompense moyenne maximale $\\mu_{a^*}$. La performance d'une politique est mesurée par le **regret $R_n$**, qui est défini comme la différence moyenne entre les récompenses qu'elle permet d'accumuler jusqu'au temps $t=n$ et ce qui aurait pu être obtenu pendant la même période si  le meilleur bras était connu à l'avance~:\n",
    "$$R_n = n \\mu_{a^*} - \\mathbb{E}\\left[\\sum_{t=1}^n X_t \\right]\\;.$$\n",
    "\n",
    "Un algorithme de bandit ne peut pas être arbritrairement bon : il existe une **borne inférieure** au regret qu'il doit encourir dès lors qu'il offre des garanties uniformes de performance. \n",
    "La plus célèbre de ces bornes inférieures est celle de Lai et Robbins [6] (voir [7] pour une preuve moderne et plus générale). Dans le cas de récompenses binaires, elle stipule que si une \n",
    "politique assure dans tout environnement un regret sous-polynômial, alors celui-ci est **toujours au moins logarithmique** : quels que soient $\\mu_1,\\dots,\\mu_K\\in ]0,1[$, \n",
    "$$\n",
    "  R_n \\geq  \\left(\\sum_{a: \\mu_a<\\mu_{a^*}} \\frac{\\mu_{a^*}-\\mu_a}{\\mathrm{kl}\\left( \\mu_{a}, \\mu_{a^*}\\right)}\\right)\\;\\log(n) \\;\\big(1-\\mathrm{o}(1)\\big),\n",
    "$$\n",
    "\n",
    "où $\\mathrm{kl}$ désigne l'entropie binaire: $\\mathrm{kl}(x,y = x\\log(x/y) + (1-x)\\log\\big((1-x)/(1-y)\\big)$."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## III. Algorithmes de bandits"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### III.1 Politique  $\\epsilon$-Greedy [9]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    " A chaque instant $t$ :\n",
    "   <ul>\n",
    "    <li>Avec une probabilité de $1 - \\epsilon_t$, recommander le document ayant le plus fort taux de clics estimé (<b>Exploitation</b>);\n",
    "    <li>Avec une probabilité de $\\epsilon_t$, recommander un document tiré selon une loi uniforme (<b>Exploration</b>). \n",
    "    </ul>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Epsilon-greedy : cas 2 bras suivant une loi de bernoulli, arm1 : 0.4, arm2: 0.3\n"
     ]
    },
    {
     "data": {
      "image/png": [
       "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\n",
       "pLj/D9WpksJTtQ4sAAAAAElFTkSuQmCC\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff06d2f3bd0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": [
       "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\n",
       "ehF+F90t38VleNvI+3j76b707bPH3UcfB85oealFRERERERERERERERERERERERERERERERERGTg\n",
       "+P+NSzkfgL4o5AAAAABJRU5ErkJggg==\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff06d21fcd0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Exemple epsilon-greedy algorithm\n",
    "\n",
    "%matplotlib inline\n",
    "from pylab import * \n",
    "import matplotlib.pyplot as pyplot\n",
    "import re\n",
    "import math\n",
    "import random\n",
    "import numpy\n",
    "\n",
    "\n",
    "class EpsilonGreedy():\n",
    "    def __init__(self, epsilon = 0.05, counts = [], values = [], n_arms = 0):\n",
    "        \"\"\"Récupère les paramètres spécifiés lors de la création d'un objet de cette classe\"\"\"\n",
    "        self.epsilon = epsilon\n",
    "        self.counts = [0 for col in range(n_arms)]\n",
    "        self.values = [0.0 for col in range(n_arms)]\n",
    "    \n",
    "    def select_arm(self):\n",
    "        \"\"\" Selectionne le bras avec la valeur la plus haute si random.random() > Epsilon, sinon choisi au hasard un bras\"\"\" \n",
    "        if sum(self.values) == 0:\n",
    "            return int(random.random() * len(self.values))\n",
    "        else:\n",
    "            return self.values.index(max(self.values)) if random.random() > self.epsilon else int(random.random() * len(self.values))\n",
    "        \n",
    "    def update(self, chosen_arm, reward):\n",
    "        \"\"\" Met à jour la liste self.values en fonction des rewards obtenus \"\"\"\n",
    "        self.counts[chosen_arm] += 1\n",
    "        new_value = ((self.counts[chosen_arm] - 1) /float(self.counts[chosen_arm])) * self.values[chosen_arm] + (1 / float(self.counts[chosen_arm])) * reward\n",
    "        self.values[chosen_arm] =  new_value\n",
    "        \n",
    "\n",
    "#Simulation part\n",
    "def simulate_arm_bernoulli(proba):\n",
    "    return 1 if random.random() < proba else 0\n",
    "\n",
    "def bernoulli_epsilongreedy(nb_try, epsilon,  proba_arm_1, proba_arm_2):\n",
    "    print \"Epsilon-greedy : cas 2 bras suivant une loi de bernoulli, arm1 : %s, arm2: %s\" % (proba_arm_1, proba_arm_2)\n",
    "\n",
    "    algo = EpsilonGreedy(epsilon,[],[], 2)\n",
    "    i = 0\n",
    "    vector_arms_chosen = []\n",
    "    reward_vect = []\n",
    "    reward_cum = 0\n",
    "    while i < nb_try :\n",
    "        chosen_arm = algo.select_arm()\n",
    "        vector_arms_chosen.append(chosen_arm)\n",
    "        reward =  simulate_arm_bernoulli(proba_arm_1) if chosen_arm == 0 else simulate_arm_bernoulli(proba_arm_2)\n",
    "        algo.update(chosen_arm, reward)\n",
    "        reward_cum = reward_cum + reward\n",
    "        if i != 0:\n",
    "            reward_vect.append(reward_cum / float(i))\n",
    "        else:\n",
    "            reward_vect.append(0)\n",
    "        i += 1\n",
    "    return reward_vect, algo.values, algo.counts, vector_arms_chosen\n",
    "\n",
    "\n",
    "#features\n",
    "iteration_nb = 1000\n",
    "arm_1_probability = 0.4\n",
    "arm_2_probability = 0.3\n",
    "epsilon = 0.1\n",
    "\n",
    "#Simulation\n",
    "rewards_vect, values, count, arms_chosen = bernoulli_epsilongreedy(iteration_nb, epsilon, arm_1_probability, arm_2_probability)\n",
    "offline_solution = [max(arm_1_probability, arm_2_probability) for x in range(iteration_nb)]\n",
    "\n",
    "#PLOTTING\n",
    "cum_sum_arm_2 = cumsum(arms_chosen) #arm_chosen = 1 if arm2 selected, else arm_chosen = 0\n",
    "cum_sum_arm_1 = [ x - cum_sum_arm_2[x] for x in range(iteration_nb)]\n",
    "plot(range(iteration_nb),cum_sum_arm_1, range(iteration_nb), cum_sum_arm_2);\n",
    "title(\"Nombre de tirages de chaque bras\");\n",
    "legend([\"arm1 Proba %s\" % arm_1_probability, \"arm2 p= %s\" % arm_2_probability], loc=\"upper left\");\n",
    "figure();\n",
    "\n",
    "#plot\n",
    "plot(range(iteration_nb), offline_solution, 'k-', range(iteration_nb), rewards_vect, 'r--');\n",
    "axis([0,iteration_nb,0.25,0.45]);\n",
    "title(\"Gain moyen par tour\");\n",
    "legend([\"Offline\",r\"$\\epsilon$-greedy $\\epsilon$ = %s\" % epsilon], loc=\"lower right\");\n",
    "    "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Dans les expérimentations appliquées, il n'est pas rare de voir un choix $\\epsilon_t=\\epsilon$ constant. Il n'est cependant pas difficile de rendre le regret négligeable devant $n$, en choisissant une suite $(\\epsilon_t)$ décroissant (pas trop vite) vers $0$.\n",
    "Cependant, il n'est pas possible d'atteindre le regret asymptotiquement optimal suggéré par la borne de Lai et Robbins : cette politique paye donc sa grande simplicité par une performance moindre que ses concurrentes."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### III.2 Politique UCB: Upper-Confidence Bound [10]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<ol>\n",
    "    <li> Recommander une fois chaque document\n",
    "    <li> A chaque instant $t > m$ :\n",
    "    <ul>\n",
    "        <li>Calculer la <b>borne supérieure de confiance associée</b> à chaque document <br/>\n",
    "\t$$ \\hat{x_i} + \\sqrt{\\frac{2\\ln t}{t_i}} $$ <br/>\n",
    "        <ul>\n",
    "              <li>où <b>$\\hat{x_i}$</b> est la proportion de clics observée pour le document $i$\n",
    "              <li>et <b>$t_i$</b> est le nombre de fois où le document $i$ a été recommandé\n",
    "        </ul>\n",
    "        <li>Recommander le document avec la borne supérieure de confiance associ\\'ee la plus forte\n",
    "   </ul>\n",
    "</ol>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "UCB1 : cas 2 arms, suivant une loi de bernoulli, arm1 : 0.5, arm2: 0.2\n"
     ]
    },
    {
     "data": {
      "image/png": [
       "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\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff06d173ed0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": [
       "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\n",
       "QmCC\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff06d2ba610>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Exemple UCB1 algorithm\n",
    "\n",
    "class UCB1():\n",
    "    def __init__(self, counts = [], values = [], n_arms = 0):\n",
    "        self.counts = [0 for col in range(n_arms)]\n",
    "        self.values = [0.0 for col in range(n_arms)]\n",
    "        self.n_arms = n_arms\n",
    "    \n",
    "    def select_arm(self):\n",
    "        \"\"\" Selectionne le bras avec la valeur de l'estimateur la plus haute\"\"\"\n",
    "        for arm in range(self.n_arms):\n",
    "            if self.counts[arm] == 0:\n",
    "                return arm\n",
    "            \n",
    "        ucb_values = [0.0 for arm in range(self.n_arms)]\n",
    "        total_counts = sum(self.counts)\n",
    "        for arm in range(self.n_arms):\n",
    "            bonus = math.sqrt((2 * math.log(total_counts)) / float(self.counts[arm]))\n",
    "            ucb_values[arm] = self.values[arm] + bonus\n",
    "        \n",
    "        value_max = max(ucb_values)\n",
    "        return ucb_values.index(value_max)\n",
    " \n",
    "\n",
    "    \n",
    "    def update(self, chosen_arm, reward):\n",
    "        self.counts[chosen_arm] += 1\n",
    "        n = self.counts[chosen_arm]\n",
    "        value = self.values[chosen_arm]\n",
    "        new_value = ((n - 1) /float(n)) * value + (1 / float(n)) * reward\n",
    "        self.values[chosen_arm] =  new_value\n",
    "        \n",
    "        \n",
    "#Simulation part\n",
    "def bernoulli_UCB1(nb_try, proba_arm_1, proba_arm_2):\n",
    "    print \"UCB1 : cas 2 arms, suivant une loi de bernoulli, arm1 : %s, arm2: %s\" % (proba_arm_1, proba_arm_2)\n",
    "    vector_arms_chosen = []\n",
    "    reward_vect = []\n",
    "    reward_cum = 0\n",
    "    algo = UCB1([],[], 2)\n",
    "    \n",
    "    i = 0\n",
    "    while i < nb_try :\n",
    "        chosen_arm = algo.select_arm()\n",
    "        vector_arms_chosen.append(chosen_arm)\n",
    "        if chosen_arm == 0 :\n",
    "            reward = 1 if random.random() < proba_arm_1 else 0\n",
    "        else:\n",
    "            reward = 1 if random.random() < proba_arm_2 else 0\n",
    "        algo.update(chosen_arm, reward)\n",
    "        reward_cum = reward_cum + reward\n",
    "        i += 1\n",
    "        reward_vect.append(reward_cum / float(i))\n",
    "    return reward_vect, algo.values, algo.counts, vector_arms_chosen\n",
    "\n",
    "\n",
    "\n",
    "#features\n",
    "iteration_nb = 100\n",
    "arm_1_probability = 0.5\n",
    "arm_2_probability = 0.2\n",
    "\n",
    "#bandit algorithm\n",
    "rewards_vect, values, count, arms_chosen = bernoulli_UCB1(iteration_nb, arm_1_probability, arm_2_probability)\n",
    "\n",
    "offline_solution = [max(arm_1_probability, arm_2_probability) for x in range(iteration_nb)]\n",
    "\n",
    "cum_sum_arm_2 = cumsum(arms_chosen) #arm_chosen = 1 if arm2 selected, else arm_chosen = 0\n",
    "cum_sum_arm_1 = [x - cum_sum_arm_2[x] for x in range(iteration_nb)]\n",
    "plot(range(iteration_nb),cum_sum_arm_1, range(iteration_nb), cum_sum_arm_2);\n",
    "title(\"Nombre de tirages de chaque bras\");\n",
    "legend([\"arm1 Proba %s\" % arm_1_probability, \"arm2 Proba %s\" % arm_2_probability], loc=\"upper left\");\n",
    "figure();\n",
    "\n",
    "#plot\n",
    "plot(range(iteration_nb), offline_solution, 'k-', range(iteration_nb), rewards_vect, 'r--');\n",
    "title(\"Gain moyen par tour\");\n",
    "legend([\"Offline\",\"UCB1\"], loc=\"lower right\");\n",
    "    "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Il est prouvé dans [10] une **borne de regret logarithmique** (non-asymptotique). Toutefois, l'algorithme ci-dessus a un comportement sous-optimal qui peut s'avérer assez décevant dans le cas (fréquent en recommandation) où les récompenses moyennes sont toutes très faibles (cela se conçoit bien : la borne de Hoeffding est alors très pessimiste). \n",
    "\n",
    "Heureusement, l'analyse peut être significativement renforcée, et [11] présente une variante pour laquelle une borne non-asymptotique de regret est montrée d'où peut être déduite l'**optimalité au sens de la borne de Lai et Robbins**.\n",
    "Le calcul de la borne supérieure de confiance est un peu plus complexe, mais le gain de performance n'est pas seulement théorique. \n",
    "\n",
    "Les méthodes de type UCB présentent donc de grandes qualités ; elles posent toutefois des difficultés dans les modèles plus complexes (par exemple, dans le cas où les récompenses dépendent de façon non triviale de covariables) où il devient difficile de construire des intervalles de confiance précis avec les bonnes garanties non asymptotiques.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### III.3 Politique EXP3: Exponential Weightsfor Exploration and Exploitation [2,5]\n",
    "\n",
    "Plusieurs variantes ont été envisagées, la plus simple consiste à \n",
    "\n",
    "- donner un poids initial $w^t_a=1$ à chaque action $a\\in\\{1,\\dots,K\\}$;\n",
    "- tirer, au temps $t$, l'action $A_t=a$ avec une probabilité $p_t(a)$ proportionnelle à son poids $w_a^t$;\n",
    "- une fois obervée la récompense $X_t$, mettre à jour le poids de l'action $A_t$ en le multipliant par $\\exp(-\\eta_t X_t/p_t(a))$, où $\\eta_t$ est un paramètre de l'algorithme. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "exp3 : cas 2 bras suivant une loi de bernoulli, arm1 : 0.4, arm2: 0.3\n"
     ]
    },
    {
     "data": {
      "image/png": [
       "iVBORw0KGgoAAAANSUhEUgAAAX4AAAEKCAYAAAAVaT4rAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\n",
       "AAALEgAACxIB0t1+/AAAIABJREFUeJzt3Xe4XFXVx/HvpFdSSEiFJKA06R0ECR0pglQRMBGsNEGR\n",
       "JLwCo/iiRAEVBRXpUgVBmoGABHwVCEJAJARIaOmhGSB0WO8faw9z7twzt2XunNkzv8/zzHOnnllz\n",
       "7sw6++yzz14gIiIiIiIiIiIiIiIiIiIiIiIiIiIinexjYM0qvdfY8H5dKrS8O4AjK7SsapkI/L3C\n",
       "yxwPzK/wMjvDZcCZWQchLavUj1Pa5wVgKdAncd/XgHsziaZ25IErS+7bK+U+qV0WLlLDlPiz0wX4\n",
       "TtZBpOiadQDtEFOsjSTXxud169QopCwl/mwY8HPgZGBAmedsBzwM/BeYCWybeGwGvjv9D+BN4BZg\n",
       "CHAVsDw8f0zJ8vYG5gEvA1Mp/jgnhuWcC7wCnAH0CPG9CCwBLgR6lYmzS3juy2H5e5c8PgC4GFgE\n",
       "LAhxp33v9gSmAIeGzzQr8VmPbiHWNYG/hdsvA3+k6TrdLCzrDeB64DqadkXsAzwGvB6WvWHisUkh\n",
       "5jeAOcDOZdbBqvj/YDnwELBWyePrAtOBV8NyDi6zHIDBwKXAQuA14KaSx7+L7y0uwtdHwd7hcy4H\n",
       "XsLXTdKR+P/zFeBUfK+z8Hkuo+k6GU/TbqWRwI3AMuA54PgW4gf/Lt6Fr7cZwBqJxz4GjgGeBZ4O\n",
       "9/0yxLwc+BewfeL5W4X7luPfxXNaeW+RmvU8sAv+Yyr84JJdPYPxRHQ4niS/hCeBQeHxGcAzwDhg\n",
       "FeBJ/Ie0M94Kvhy4JPF+HwP3AAOB1fEfXDKZfgAcG96rF3AecHN4fj88qZ1V5rN8C3gKGBXiuxf4\n",
       "iGJyvwnfcPQGhuKJ8RtllnUGcEXJffcCR7UQ61r4uuyOJ5z7QvzgG7AX8UTVFfgi8B7wo/D4pngS\n",
       "3RLfEH4F/990B9bBk9Hw8Nw1KH+c5Npw6Q18Bt9Y3B8e64sn0Qkh5k3wDdR6ZZZ1O3ANvvHqBuwQ\n",
       "7h8fPns+fJbPAysobuR2DO8NvvFaAuwXbq+Pb0y3D+vknLCsQuK/NLFOCu9VSPxdgEeAH4R4xuEb\n",
       "+N3LxH8ZnvAL7/ULmh7v+Bi4E/9u9Qz3HY5/d7rgG7bF4bUAD4THwbtGty7zviI173n8R/cZvEU/\n",
       "hKaJ/0jgwZLX/BNPHoTnTUk89nM8YRTsQ7HFDP5jS/5Qvw3cHa5PxJNjQQ54i6ZJblu8pZfmbzRN\n",
       "5LtRPLg7DHiXpnsLh4XXpMnTvD+/NPG/SMv2Bx4N1z+HJ+Gkv1NMchfSNOGBt8g/h29QllLcqJTT\n",
       "FXgfWDtx3/9STHaHUtwIFPwOOD1lWSPwjWbaXuB44G2a7i0txVvEaX6B7xkR3uvqxGN98A1gMvGX\n",
       "a/FvTfN1PoWmDYuky0reqy/wId4wAP9ujC/z2oLXKO553Yd/L4a08hppB3X1ZOtJ4DZgMk0PiI3E\n",
       "W5tJL4b7C5Ymrr+L74Ynb/creX1y1/2lkmUlHxuKJ4ZH8L2O14G/Uv6HNyJl2QVj8KS5OLGs34b3\n",
       "6KjSkS3D8Nb2Arw74Eq86wX8My5s4fVjgO8lYnsdGI1/pnnAiXjSWYq3wkekxDMUbwm3tA62LnmP\n",
       "L4e4S62OJ73lKY+BdxV9nLj9NsX/89b4RnIZ3pj4Jk3Xw4KS171a5j1KjQmvT8Y/BVitzPOt5L1W\n",
       "4J+p3PcNvMtzdoj7dXzDV/i+HY1vVJ/CuzBLuxKlA5T4s3cG8HWKLSLwZFXaRz+G5kmsoC2jKNYo\n",
       "uZ5cVvL1rwDv4N0Dg8JlIN6llGZxyrIL5uMty1UTyxpA0370pI/L3J9U+lnPwlvJG4RlH0nxe72Y\n",
       "puu1NL6X8Nb5oMSlH34cADzZ74CvewPOTonnZbxFW24dvIS3WpPv0R/vrio1H+/mK3fcpyVX491z\n",
       "o/H/128pHsdZhG9UCvpQ3CiAJ+fkCLPhievz8T3UZPyr4HuV5STfqx/+mRYl7kv+D3cAvo8f9xgY\n",
       "lr88EftcfEM5FF//N+BdarISlPizNw9PNMkRPn/FWzmH4a3JQ/EDhLclnpMrc72ckyn28Z9AMbmV\n",
       "+hi4CO8qKLTMR1G+T/f6sLxCH//kxGOL8YN85+LJrgvehfK5Mstaip8H0NZRIeCJZQXerzwKTyIF\n",
       "D+AbhePw9bgf3p9fcBF+jGKr8J598RZlP3z974z3Q7+H70V9lPL+HwF/xvcMeuMbzAkUk9vtYVlH\n",
       "4Hs/3UMM66YsazH+v78A/191p/y6KtUPby2/Hz7PlxOP3Ygn6s/ifec/oulv/zF82OwgPOmfmHhs\n",
       "Jn584JTw+briG9ktysSRC8sqvNeZ+P+hXKOlP77hfCU8/3SaNjKOoPg9XI6v17Y0EKQFSvy14Ud4\n",
       "i6uQLF7Ff6jfw38QJ4fbryVeYyXXS1vCpbf/gnffzMI3IBe38NpJeEvrQfzHNp2mfdhJF+EH6x7H\n",
       "R1/cWLK8r+A/6Nkh/j/RtEWZ9Kfw99WwrFJpsf4QH7mzHLi15P3fBw7AuwsKB8tvC/eDr4+vA78O\n",
       "sT0b4gVP+D/BW/SL8a6H5HGVpOPwxLsE7/tO9n+/iW80v4Qnv8VhuT1IdyR+4HUOviE8oeTzl3MM\n",
       "/j16AziNphv2J/E9jKvxlvdrNO2OuRL//70ATMO7zgrv9RH+3dsEP87zMvB7yu8BGj667Az8/7gp\n",
       "nrzLfYZp4fJMeP93aNpVtgfwH3w9noevx/fKvLdU0HeAJ/CVX2iVDsaTwTN4i25g4vlT8B/QHMq3\n",
       "EkWy8hDFg+SNrDDAQKSZDfCk3wvfxZuO76pPxXf9wFuHPw3X18d3G7vju+xz0V6FZOtz+B5GNzzh\n",
       "ryD9wGqjUeJvYK0l5XXxFlKhf/M+4EDgC/hYccLf/cP1/fADYh/gu21zKT/cTKQa1qF4gtZJwEE0\n",
       "HRElIiXWxU/2GYz3Qf8T+BX+IyrIJW6fT/FkC4A/4BsKERGpEa3NlTEHH0J1F76L/BjNRza0NimT\n",
       "JmwSEakhbZkkKTlK4X/x0QBL8X7TJfhJLYWThxbSdAzvaNKHcc2l+XwmIiLSsnnAp6rxRoUz9NbA\n",
       "z54bgB/cnRTun0zzg7s9KM7pkTYmW3sBRfmsA6gh+awDqCH5rAOoIfmsA6ghFcmdbWnx34Cf5fcB\n",
       "PlZ4OZ7or8fHR78AHBKeOzvcPxs/KeOYSgUqIiKV0ZbEn3bm4GvArmWefxblZ3IUEZGMaYx99mZk\n",
       "HUANmZF1ADVkRtYB1JAZWQcglaHuHxGR9qtaH381JYuNiCS9jp9PIiKRKrfV0p6AlKPvhkiFfgfq\n",
       "4xcRaTBK/CIiDUaJX0SkwSjxC6QXOReROqXEX1uOwytPvQtc2spzJ+IT5r2Jn009i44Xoq70gdOT\n",
       "8EpTy/FKX+WqTSV9BS+pd3SFYxGREkr8nadrB16zEK9ReklrTwz+gdcsHYgn2OtJL9TdWiztqXHb\n",
       "mj3weZx2xouUr4mXR2zJIOBUvMqbRu+IdDIl/vaZjM8s+gZex3T/xGMT8UR8Ll4nN4+32i8A7sBb\n",
       "5n/HZzX9JT4u/Sm8lmnBTXht3FfbGE8hYVt4r974zH15fI6lK/FW9wRgJHBLWPazwNcSyzG8ytq1\n",
       "4bM9AmzUxs9dagJeh+Ep4L94HdiJrXyOn+DrpK2fW0RWghJ/+8wFtscLTf8Q+CNNy/hthc9Iuho+\n",
       "hXUOOBj4H7xY9/t4AfOH8ZORbsA3FKXa2wLvhifyN/E6yOBV0v6E7wFcjSf1l/BptA/C51PaKfF+\n",
       "++F7DIPC82+muKeQ9rnLFUxfHy/cXfBvfB2VOzFvK7xY+m/b8kFFJF4rcQKX2cpfKmYWnmDBW7Uv\n",
       "ljx+KfC7xO3j8BZzwYY0rWZWcCZt6+P/ILz+Zbw6WqGGap6m85usjs+W2jdx31mJ98iH1xfkgEV4\n",
       "sk+T/Nyl5gK7J253x/vu10h5bld8I1goz3kvcFSZ5aoLSKROp2xog1wl+6Pb6yv4gcux4XY/fMrq\n",
       "gvkpr1mWuP5uye13wjJKtfUzPgjsUOaxBYnrI/HpMFYk7nsJ2KLM8y3cHhFut/a5k97C9wwKCscc\n",
       "3kx57jH4HsHMxH1Z/n9FGoK6etpuDPB74Fi8m2YQfjAymagq1Spd2eWUlsNchMec3MisQdNkn6yc\n",
       "1gWvnraItn3upCdpetxiY7xiW9qezc7AF/ERQIuB7YBz8LrOItJJlPjbri+eTF/B19tXgQ1aeU17\n",
       "W69d8YOs3cL1nnRsdFDp+87Hu3J+Epa5Ed6l8sfEczbHk3A34ER87+RB2v+5r8CHZK6HbyROo3y3\n",
       "1URgXXzjsAk+lDWPHxMRkU7SlsQ/BW/FPYEf9OuJt/ym4wcS78KHEyaf/yxeqH136sdsvDX6AF5r\n",
       "eAPg/xKPpxWdL72v3HMKTgPexodDHoF3BZVLgi0VuU977DC8q2YR8GfgdOBvieffDByKdwkdDhyA\n",
       "nyfQ2ucudSdemvNevDrbPOCMxON34KOEwEccLQuXpfjB7zdI7xYSaXA2tFrvNBZ4Dk/2ANfhw/Wm\n",
       "AqeE+ybRvOZu9/DauaRvXDQ7p7SXvhvSoKwf2PfAllGl38Fg4Gl8l70bcCuwG96aLwxjHB5ug7f2\n",
       "JyVePw3YJmW5SvzSXvpuSAOyTcCeBpsGtj5V/B18A9/1XkZxPpfkgbpc4vb5eDdBwR+AA1OWqcQv\n",
       "7aXvhjQQy4EdA/YyWDKnVmU451r4gb6xeH/sn/C+5yYRthJMucfyieszUF1NERHABuKN5rVgv5Pg\n",
       "lk/TNF92ukNDAAVHAr/BT8cvnLk5gmJXz2SKB+7Au3q2TlmuWvzSXvpuSAOwrcCeAzsfrFfaE6oR\n",
       "xcb4mO3eeJfO5fh47qkU+/In0/zgbg9gHD6iI21IoxK/tJe+G1LHbFWwC/0Arh3Q0hOrFdEpFIdz\n",
       "Xo6P2BkM3E36cM5T8dE8c/CZGtMo8Ut76bshdco+C/YS2AVgaVObNHlyVULqJEr80l76bkidsdXA\n",
       "bg6t/H3a+qJODamTKfFLe+m7IXXEdgJbCPZTsFVaf37xhZ0WUhUo8deWPLVfelHfDakD1hUsD7YY\n",
       "rFxXeIsLqEQUmqundvTAq2i9gE9bMAvYs4XnTyT+0our4sVrXqH4GVoq8iISMRsF3IPPqLsZ5O7M\n",
       "OKCqa4QWf3snV+uDz2lTOLizN74BGFPm+ROB+8P1HD7X/wo6VnoxT+Va/Hvgc/qshx/0vxefHC5N\n",
       "T2Adig2Q/fD5etKmqq6n74Y0HPs82BKw07zV3/EFVSykDMSa+NtTerFQTKU9pRdLPY7PmJlmYlhe\n",
       "QV+84MnmNC+9eBQtl148Az85rxKlF68Gfpy4vRPe+m9NF2BffBK5tD2EWv9uiKSw7mBTweaD7ViJ\n",
       "BVZgGZmJNfEfRPHEtUPwoiOFOYsm4hWxjsWTWC/gMrw61qZ46/YevCvnCLyVfibFGTJLDcNn51y7\n",
       "zOMTKSb+bsB38CTfH0/871OsktUL3zv4NZ5UN8an4CiUXiw8/wB87+B7+OR8hZZJ2ucuV3rxMbzc\n",
       "ZMGq+AapXOlF8GIs7+EbpbQT/qD2vxsiJWws2ANgt1dwZs0GrcCVr8AHz3e4ytMNievX45PSbY23\n",
       "pMFbq78J19/F/0l/xvuuwYupf5viPPjX4100pboDV+EbjmdSHi/YBt9z+BBvxX+R4pTG/0zENRQv\n",
       "cvJ5PME/jp+R/RW8KwZ8Lvw/h+vn4sl/W3wK5rTPvVVi+Un98A1QwRvhb3/Si7GA7130AL4J3IjP\n",
       "0f9WmeeKRMAOwOtInw2cB7mPMw6oiRgTf72XXuyCd9G8S/pGISn20otJ7+OT/B0D7AL8pZXni9Qg\n",
       "6wX8DNgH2BdyD2UcUCqN6mm7apRezOGjYIbis5p+1MHlxFJ6MU03mm6gRCJha+MFi0YAm9Zq0gcl\n",
       "/vaoRunFC/Fuji/gfd4dFUvpxa2B7fFunt74/E+9wvuKRMS+jA/uuAg4GHL/zTigFinxt11nl14c\n",
       "g9c+2Dgs/81wOaxMPPVQerEnfsD5Fbzr6XP4uQvq35dI2Ppgj+EDJHaD3AWQ00CEMmId1SPZ0XdD\n",
       "aojlwCaGQilfA6tWIzrq34ESv7SXvhtSI2wjsPvAngRrrbu34m9e5ferKCV+aS99NyRjlgP7Vmjl\n",
       "HwPWJ4sgMnjPilHil/bSd0MyZAPArvf+fFsny0AyfO+VpsQv7aXvhmTEtgSbB/Yb0sshVjWYar3R\n",
       "OviZp4XLcuAEfEz3dNKrcE3BzySdA+yeskwlfmkvfTekyiwHdlIolHJQ1tEEmfwOuuATbq2OD9k7\n",
       "Jdw/ieZ1d7vjwwfn0nzYqBK/tJe+G1JFtirYLWAPgY3LOpqETH4Hu1OcGGwOxQnKhofb4K39SYnX\n",
       "TMPnlEkqF/xrFMeg66JL8vIaIlVh2+M1cH8OVq6WRFasEgtp71w9XwKuCdeH4afiE/4WNgIjaXrm\n",
       "5QJgVBuXP7id8YiIVIh1wU8uPAE4GnK3ZxxQp2lP4u+Bz5c+KeWxQqusnLTH8onrM8JFRCQDNhyf\n",
       "HLEnsAXkFrTygmoZHy6Z2Q/vtimYQ3FO9hEUu3omUzwln/Ca0jnWK7K7IiKy8mxXsEVgZ4LV+ozF\n",
       "Vc+d1wITErenUmz9T6b5wd0ewDh8rpbSScOU+EUkY9YN7MdgC8F2yTqaNqpq7uyLT6TVP3HfYOBu\n",
       "0odznoqP5pmD12AtpcQvIhmy0WB/B7sLbFjrz68ZUefOqIMXkZjZPmBLwaZQvcnVKiXq3Bl18CIS\n",
       "I+sBdk4YqvnZrKPpoKhzZ9TBi0hsbE2wmfhJWeXKhsYg6twZdfAiEgvrBXYcPqPmiWBZ1uyuhKhz\n",
       "Z9TBi0gMbG2wWWB/A9sy62gqJOrcGXXwIlLr7PDQyv92HbTyk6LOnVEHLyK1ylYDuwTsabCNs46m\n",
       "E0SdO6MOXkRqjeXAjgJ7HexisH5ZR9RJos6dUQcvIrXE+oP9Eew/YJ/JOppOFnXujDp4EakFn9TA\n",
       "fR3sIrKpgVttUefOqIMXkax9UgN3FthGWUdTRVHnzqiDF5GsWA7sBLA3wX5N9jVwqy3q3Bl18CKS\n",
       "BRsMdjPYw2DrZR1NRqLOnVEHLyLVZEPAzgZbAXZuDZZDrKaoc2fUwYtItdjnwOaDXQ72qayjqQFR\n",
       "586ogxeRzmZdwX4AtgTs81lHU0Oizp1RBy8incmGg90Ndh/YqKyjqTFVzZ0DgRuAp4DZeA3dwcB0\n",
       "0itwTQGexStw7Z6yPCV+EUlhu4X6tz+MoP5tFqqaOy8HjgrXuwED8Jq7p4T7JtG85m53YCxegrG0\n",
       "yo0Sv4gk2GiwC0P9252zjqaGVS13DgCeS7l/DlCoVTk83AZv7U9KPG8asE3Ja5X4RSSwvUNf/vk+\n",
       "yZq0oCK5sy27UuOAl4FLgY2BR4AT8aS/NDxnKcWNwEjgwcTrFwDqpxOREtYDOAs4BDgIcv+XcUAN\n",
       "oy2JvxuwGXAc8DDwC2ByyXOMlrdEaY/lE9dnhIuI1D3L4Q3Ka4BlwKaQezXbmGrW+HCpuuHA84nb\n",
       "2wO34wd6h4f7RlDs6plM0w3DNPxgcJK6ekQakq0Vat++XSelEKutIrmz9KBrmiXAfGDtcHtX4Eng\n",
       "VmBCuG8CcHO4fgvwJaAHvlX/NDCzEsGKSMzsUOAB4EqgL+R+ATk1AmvYxng3z+PAn/EDvoOBu0kf\n",
       "znkqPppnDrBHyvL0zxZpGLYO2HVgc8E2zzqayEWdO6MOXkTawvqC/SjUvv0R2CpZR1QHos6dUQcv\n",
       "Iq2xTcCeBLsBbIOso6kjUefOqIMXkXKsP9iVYMvBJurgbcVFnTujDl5E0tgmYM+A/aFByiBmIerc\n",
       "GXXwIpJkQ8HOCX35X846mjoXde6MOngRgUQZxLfALvEx+tLJos6dUQcvIk3KIK6ZdTQNJOrcGXXw\n",
       "Io3JuoDtA3YU2Asqg5iJqHNn1MGLNB7bAewpsFlg14Dtm3VEDSrq3Bl18CKNo0kJxANVHCVzUefO\n",
       "qIMXaQwqgViDos6dUQcvUv9UArFGRZ07ow5epH7ZaLCrwBaA7ZR1NNJM1Lkz6uBF6o91BzsNbCnY\n",
       "WX5SltSgqHNn1MGL1A9bA+xksMfB/gq2adYRSYuizp1RBy8SP+sJdibYMrDLwA72cfpS46qaO18A\n",
       "/g3MolhNazAwnfRCLFOAZ/FCLLunLE+JXyQzdhDY7HDm7YZZRyPtUtXc+Tye6JOmAqeE65OAn4br\n",
       "6wOPAd2BsXglrtKWhBK/SNXZnmCXhkpY+2vK5ChVPfGvWnLfHGBYuD6cYrH1KfiGoGAasE3Ja5X4\n",
       "RarG+oBdFKZMViWsuFWt2Hrhze4G/gV8Pdw3DFgari+luBEYCSxIvHYBoJM/RKrOeochmTOB3sDm\n",
       "kDsdcm9kHJhkrK0nZnwWWAwMxfv155Q8brS8JVILX6SqbEPgOuAj4FzgUsjpdyhA2xP/4vD3ZeAm\n",
       "YCu8lT8cWAKMAJaF5ywEVk+8dnS4r1Q+cX1GuIjISrFVgAuA/YBjIXdFxgHJyhkfLlXXB+gfrvcF\n",
       "/oGP1JlKsS9/Ms0P7vYAxgHzgNKDSGp5iFSU5cCOAVsB9nuvfSt1qGq5cxyeyB8D/oMfvAUf5XM3\n",
       "6cM5T8VH88wB9khZphK/SMXYQLAbwB4FWzfraKRTRZ07ow5epDbYKmDfAHse7Fd+UpbUuahzZ9TB\n",
       "i2TPtg1VsO4E2zvraKRqos6dUQcvkh0bCnYb2OtgX8g6Gqm6qHNn1MGLVJetCnYI2AVg74NNVa3b\n",
       "hhV17ow6eJHqsBzYrmALwe4JRVFGZx2VZCrq3Bl18CKdz0aHZL/Ek78IEHnujDp4kc5jo8H+APYe\n",
       "2OlgXbOOSGpK1Lkz6uBFOoftHVr454GtlnU0UpOizp1RBy9SWTYW7HKwl8C2zzoaqWlR586ogxep\n",
       "HDsgVME620fviLQo6twZdfAiK896gZ0fzrrdOutoJBpR586ogxdZOfbpMK/ODT7PjkibRZ07ow5e\n",
       "pGNs3TBE89Uwk6ZKH0p7RZ07ow5epH2sO9hRYC+HhD8i64gkWlHnzqiDF2k7+wzYk2CzQlUskZUR\n",
       "de6MOniR1ll/sJ+FVv6ErKORuhF17ow6eJGW2SZgz4BdAbZ21tFIXalq7uwKzAJuDbcH40XX06pv\n",
       "TQGexatv7V5meUr8UocsB3ZsaOUflnU0Upeqmju/C1wF3BJuTwVOCdcn0bzebndgLF5+sUvK8pT4\n",
       "pc7YQLAbwR4B+1TW0UjdqlruHI3X1t2JYot/DjAsXB8eboO39iclXjsN2CZlmUr8UicsB7ZLOBHr\n",
       "lyp/KJ2sIrmzWxuecx7wfWCVxH3DgKXh+lKKG4GRwIOJ5y0ARq1kjCI1yrYDLgH6AsdD7uaMAxJp\n",
       "k7RumKR9gGV4/365k02MlrdCat1LnbGhYBcDNwE/AMYq6UtMWmvxbwd8AdgL6IW3+q/EW/nDgSXA\n",
       "CHzjALAQWD3x+tHhvjT5xPUZ4SJS42w88EfgBmAzyJX7fotUwvhwycyOFPv4p1Lsy59M84O7PYBx\n",
       "wDzS9xS0FyCRseFgV4ItBtsj62ikYVU9d+5IcVTPYPyAb9pwzlPx0TxzgHI/ECV+iYjtBrYoFDkf\n",
       "nnU00tCizp1RBy+NwvYEuz0UO98562hEiDx3Rh281DvrHlr38326BRuadUQiQdS5M+rgpZ7ZWLAH\n",
       "QktfCV9qTdS5M+rgpR5Zz1Dk/B2w74G1NtRZJAtR586og5d6Y2uB/QvsJrXypcZFnTujDl7qhfUC\n",
       "mxwmVTteFbEkAlHnzqiDl3pg64I9DnYb2KZZRyPSRlHnzqiDl9jZkaGV/w218iUyUefOqIOXWNkG\n",
       "YPeCPaUyiBKpqHNn1MFLbCwH9rXQyj8OrE/WEYl0UNS5M+rgJSa2Ctg1YE+ArZd1NCIrKercGXXw\n",
       "EgvbDOxZsN+C9c46GpEKiDp3Rh281DrLgZ0Atgzs0KyjEamgqHNn1MFLLbMtwe4MJ2StlXU0IhUW\n",
       "de6MOnipRdYF7GSwpWDfVe1bqVNR586og5daY0PCpGoPgI3JOhqRThR17ow6eKkltmOYPvlsn05Z\n",
       "pK5VJXf2Ah7CyynOBn4S7h8MTCe9AtcU4Fm8AtfuZZarxC8ryVYDOyuUQtwz62hEqqRqubNwsks3\n",
       "4EFge7zm7inh/kk0r7nbHRiLl2BMm95WiV9Wgu0aSiFeDTYy62hEqqjqubMP8DDwGbw1PyzcPzzc\n",
       "Bm/tT0q8ZhqwTcqylPilA2xUmFRtIdguWUcjkoGK5M62FJvogrfilwL3Ak/iSX9peHwpxY3ASGBB\n",
       "4rULgFGVCFQamXX36ZN5BJgJrAe5ezIOSiRa3drwnI+BTYABwJ3ATiWPGy1vhco9lk9cnxEuIiVs\n",
       "DHAN8CawL+QezjggkWoaHy6ZOg04Ge/aGR7uG0Gxq2dyuBRMA7ZOWY66eqQNbP8wLv9klUIUAaqU\n",
       "O4dQHLHTG7gf2AU/uFvoy59M84O7PYBxwDwgbb5zJX5pgfUE+xXY82Bpx4hEGlVVcueGwKN4Mv83\n",
       "8P1w/2DgbtKHc56Kj+aZA+xRZrlK/FKGfQrsEbAbwQZlHY1IjYk6d0YdvHQWOyzMmX+sKmOJpIo6\n",
       "d0YdvFSarQb2B7BnVP9WpEVR586og5dKsglgr4NdAtY/62hEalzUuTPq4KUSrB/YFWCzvRauiLRB\n",
       "1Lkz6uBlZVh/sG+BPQ12MVjfrCMSiUjUuTPq4KWjPimFeBPYIVlHIxKhqHNn1MFLe1kO7PgwYudL\n",
       "WUcjErGoc2fUwUt72KDQwv+Xj9EXkZUQde6MOnhpK9sW7AWwX6gUokhFRJ07ow5eWmNDwH4W5tnZ\n",
       "L+toROpI1Lkz6uClnE8Kni8Gu0z1b0UqLurcGXXwksbGhwIp94NtmXU0InUq6twZdfBSYF3BDgab\n",
       "Hkoh7qk5dkQ6VdS5M+rgxbqF4ZlPhMvhYEOzjkqkAUSdO6MOvrHZrmAPgM0A+6K3+kWkSqLOnVEH\n",
       "33ish594ZXeAvQT2DVXEEslE1Lkz6uAbi30xTLPwMNi3wQa2/hoR6SRVy52rA/cCTwL/AU4I9w8G\n",
       "ppNehWsTogjUAAAOtElEQVQK8CxehWv3lGUq8dc86wV2PthzYHvpoK1ITaha7hwObBKu9wOeBtbD\n",
       "6+6eEu6fRPO6u92BsXgZxtJuASX+mmaH4vVub1ALX6SmZJY7bwZ2xVvzw8J9w8Nt8Nb+pMTzpwGl\n",
       "BbOV+GuSbQv2+9C1s5ta+SI1pyK5s70H6MYCmwIP4Ul/abh/KcWNwEhgQeI1C4BRHQ9ROp8dAnYj\n",
       "cDXwPrA55KZDThtokTrUrR3P7QfcCHwHeLPkMaPlLVHaY/nE9RnhIlVjvYCdgG8C6wAXABMg91am\n",
       "YYlI0vhwyUR34E7gxMR9c/AuHoARFLt6JodLwTRg65LlqSWZGesf5tN5A+xJsCmqgiUSjarlzhxw\n",
       "BXBeyf1TKfblT6b5wd0ewDhgXlhGkhJ/1VkObN/Qf/9XsHWzjkhE2ihPH/KsSoVyZ1u6ej4LHAH8\n",
       "G5gV7puCJ/rrgaOBF4BCKb3Z4f7ZwIfAMZUKVjrKtgB+D/QBfgC56zIOSCRueXoBq4Rb/YDNaN7A\n",
       "bYs+wOb48dbRQFqxohzeiH6nA8tPldWoDcvwvRuIDQKOA44HTgauhdz72cYkUgF5+uEJF7yXoTBX\n",
       "1BBgg5Jnr0OxW7pSRgIfUDy++SjQ0eNjjwHLgXeBh4GPUp6zjDzLqFDubM/BXYmKbQtcg38ht4Hc\n",
       "cxkHJFKUZwCQPLaUwxP24DKv2ADYEU/s4K3jQqJ9BT/BFDxpPoSPTiuYgZ98Wsmeh7fI81IFl1dV\n",
       "avHXHVsDOAcfCXA05G7JNh5pSHkG4Yl9FPBpYGOKZ/f3APYD3i551RL8BNE0y4D78C5kgNfJfzKc\n",
       "vJFUJHcq8dcN60pxRNUFwE8h93q2MUldyrMZ8JnEPWvgrfE1w+0c3rXyOt598S9gPj69S8HfyDOv\n",
       "84OtO+rqkQLbCT94uxhYD3ILWnmBSHnefz4k5ZExwJ7AV4G7KXadvIOP/JsJfBzue4U8/+3kSKWD\n",
       "lPijZl2B04GvA98GboNc2oEhkfLyn4zcG4aPThkCvErzPvG38e6WzcmzsKoxSkWpqydaNgq4Ch8y\n",
       "ewTklmQckNS6PD2Ag/C+9y3xRL8p0BX4HT4s+xHg5TCCRGqP+vgbl+0FXAKcj/flq5UvLs9gPKFv\n",
       "CfQCvkxxbHhv4An8pMrngBfx/veXyDc70Cq1SYm/8di+wLl88oPO/T3jgKTa8gylmNj7AHsAWySe\n",
       "MQBYhNfDWIiPC78jPPYxsJi8TqiMmBJ/Y7Ax+AlYB+C75F8F/gm5dzMNS6onTw4f/vg/+MlKC/Bh\n",
       "j4vx4Y23AO+FZ68gz/IswpSq0Kie+mbjgFOBw4DLw9/HIPdeiy+TOOUZAawabq2PD48cCWwF9ARe\n",
       "Bn4M3EK+2ey4Iu2iFn9NskPx/vurgLN14DZSeVbBa1j0wGeo7Yon86/SvNHVEz+4Cn4m6n342aZz\n",
       "8HoXr5Hnw06PWWqdWvz1xdYG9sJHWWwH7Am5R7ONSZrws1HHhFuFM1JHAgfTtOZ0QW/8IOqHeBJ/\n",
       "BZ/fZTw0GzXzNvnKTcIl0hK1+DNlffEaB8fjB+quxk9bPwdy2p2vBj9Yunq4lcPHsfdPPGNvigdP\n",
       "e+Fnn36E96nPxMe2/wV4KmXpH6pbRipMLf642UbAdfhBur2A2Tpg2wZ5euPTBXTBR7b0LnlGF3ya\n",
       "2z5lljAWn+K2MLKlO96dUjjjdD40mUrgBuDA8PwPNOxR6oFa/FVlffH6BWfgG90TIHd5tjFlIM/m\n",
       "wC6JewYDG7byqoF4N1h3vNX9Dp6g56c893koO3PiCnzseiHxf0AebXAlFmrxx8P6AZ8DfokPxdsR\n",
       "eKZu5sb3vu91gNXwWRi3AjYhfb4X8O6Ry+GTg5UfARdTHJKY5mO8a+UdtbpFVk5bthyX4P2cyyi2\n",
       "ygbj3RRjKFbfKkzINAU4Cv8xnwDclbLMBmnx2yB88rQD8GILP4PctdnGVCFeBu4gfCO2E75BexdP\n",
       "zo/j86PPLvPqDzRCRaRDqnYC1w54wYMrKCb+qfgIhULd3UH4dMDr4wcot8RHPdwNrE2x/7SgzhO/\n",
       "5YAJeJfOLcCpkFuRbUwrKc/G+AZ9U4pDE/8K3INPsfvvDKMTaRRV6+r5O35ALOkLeEsPfJd9Bp74\n",
       "98OrPn2A7wnMxXf7H1zZQONgXfBROkfiezzHQu6Oll9TQ/KMxWdp7ApshPer5/DuGwP+CPwEr+r1\n",
       "qlrtInHqaB//MPik+s3ScBt8THMyyS/AW/4NwLYDzsRHmXwfuL/m+/DzjMK76VYDvoHP2ngRXkDj\n",
       "boqFMxYBczTHi0h9qMTB3UKx4ZYeT5NPXJ8RLhGyHYAf4q3iM4HfQO6DbGNK4fO9rI53vW2Cd9kc\n",
       "DNyIDyndA3hEyV2kpowPl4rqaOJfipdWWwKMoHgW4kKKJ8OAF0QuV7Ah38H3rhE2BDgJ7/c+C9gd\n",
       "ctl1fXhi74av/43wsexdKJ6QtDresn8QHwL5GHCMJvQSqWkzaNooPqMSC+1o4r8FP3h5dvh7c+L+\n",
       "q/GpgwuntM9cyRhrkO0OXIYf/9gMcos7/S193pdt8ZOXDqT5AZ4x+MZ4Bb7OHwHeBK7Fx7u/Azyq\n",
       "Fr2ItCXxX4MfyB2CtxRPB34KXI+fjPQC3k8MPnzv+vD3Q+AYWu4Gioh1x3e5dgUO90vu3k59S6+Y\n",
       "9Fl8OO0R+BzrS/GtfulY9hXkebxT4xGRuqAzd1tlI4GJ+IyKb+JdJJMhV/nSdF779Cz8AHEXvMvm\n",
       "WeBe4HLyPFzx9xSRmKgQS+eynviwzP/FR7hcAUyHXOk5CSsnT3e8Vf9jvGvsJHwYLMALqn0qIgma\n",
       "sqHz2Fr4mcnvA/tBrnLnIeTpi0+7/EN8tsdx+AlyJwP3kOeVir2XiEgKJf5m7FDg1/jQzPMht/LH\n",
       "KPJsiZfNWwsfTrkIT/TPA8vJN5kNUkSkU6mr5xPWG/gFPmvkoZB7pN2LyDMAr7Y0AR8rvxH+OYeE\n",
       "Zd+Jd9/8t+wyRETKUx//yrO+eMt7F7x/fQbwTci9UfYleQbje0rd8OkoeuPDLMfjrfkVwD/wJD8T\n",
       "n3HyRY2XF5EKUOLv4Fv3A87DD6iuio+YuRH4Nz5VcvOunTzd8GmVD8GHVb6Nx/8UPrxyDl4j9SFV\n",
       "XBKRTqSDu+1j/fHzDo7FT7w6BJ9GeB75HMDO+FmuSRvgZybvCbwBTANGqfUuIjGr8xa/Dcenjf48\n",
       "3s/+IHAh5G4HIM9AYF3gNLyrp7Rf/2V8XvnH8dZ8nZyMJiKRUou/PBuIF4E5GR+WOQFYArkXgcK8\n",
       "Nt/Ez0B+DfgtcAh54p4zX0SkDeoo8dtgvCLUAXihkHuBTSE3LyT6vYFTgN3x8fOvAVuT5+mMAhYR\n",
       "yUTkXT3WBS/+cjg+h84MfDTNbZCbT54+eL/99/ETpe4AbsCT/nzy1N70ySIi5TVyV4/1w0tC/hKf\n",
       "P+dG4HjILQ5VpE7GD9aOBRbjE80dQr7FYt4iIg0hsha/fRo/A/ZA4EXgB8Ct5HOGd/EUWv4XA7cC\n",
       "/yH/SaUwEZHYNUqL37bDi7zvj89x8ztgY/K59/Di7j/BZ898AW/5TyBP+ROwREQaXA23+G0UXsD9\n",
       "i3jf/FPs+7Xr2PzijYCv4GPrXwTuBy4EniFPZWfOFBGpLTXd4t8Tn5umK/AHvFJXG9mG+NTEewF/\n",
       "ATYjn9sMOA6fuvhpvGV/krpxRETarzNa/F3x5LwrXm/3YeAwfHqDgsRWy7oDWwDfwrt0xjJq5mXs\n",
       "/a33GTlrBF4ndgO88td08izohJizNJ5oC81X3Hi0LgrGo3VRMB6ti4KabfFvhRcSeSHcvhYfcvlU\n",
       "86d+Mu/9KvR84yoOOfBt1rwnR86+Ge5/Ap+6eAZ5Xu2EWGvBePSlLhiP1kXBeLQuCsajdVFRnZH4\n",
       "R+G1eQsW4CdUNdXjjZ8zZObRDH3qIvaf+BE5DsX3EM4E7iLPW50Qm4hIw+uMxN+2+WwmDT4J6/IS\n",
       "3d7fFW/ZHwfcq/lwREQ6V2f08W8D5PEDvABTgI9peoB3Ll6NSkRE2m4e8Kmsg0jTDQ9uLF6N6jFg\n",
       "vSwDEhGRzvd5fGTPXLzFLyIiIiIijWJPvFThs3iRlHq2Oj499JPAf/AaAQCDgenAM8BdwMDEa6bg\n",
       "62YOPoV0vekKzMLnUoLGXRcD8ZlinwJm4yPfGnVdTMF/I08AVwM9aZx1cQlevvWJxH0d+eybh2U8\n",
       "i09eWVO64t0/Y4Hu1H///3Bgk3C9H979tR4wFa8NAL7x+2m4vj6+Trrj62gu0KVKsVbLd4GrgFvC\n",
       "7UZdF5cDR4Xr3YABNOa6GAs8hyd7KBZOapR1sQOwKU0Tf3s+e2GAzkz8HCrwKW4Kg2tqwrZ43dqC\n",
       "yeHSKG7Gz2ieAwwL9w0Pt8G35sm9oGn4KKl6MRq4G9iJYou/EdfFADzZlWrEdTEYbxANwjeAtwK7\n",
       "0VjrYixNE397P/sImp4g+yW8qmBZ1d5Spp3cNarKMWRlLL5lfwj/pxbmGVpK8Z88EppMSVFv6+c8\n",
       "vChOcjK9RlwX4/B6zpcCjwIXAX1pzHXxGnAO8BKwCPgv3s3RiOuioL2fvfT+hbSyTqqd+Bv15Kx+\n",
       "+MRy38ELxyQZLa+Xelln+wDL8P79cuePNMq66IZXhrsg/F1B8z3fRlkXawEn4g2jkfhv5YiS5zTK\n",
       "ukjT2mfvkGon/oX4Ac+C1aHuJl0r1R1P+lfiXT3gW/Hh4foIPCFC8/UzOtxXD7YDvoDPvXQNXiHt\n",
       "ShpzXSwIl4fD7RvwDcASGm9dbAH8E3gV+BD4M94l3IjroqA9v4kF4f7RJffX1DpptJO7csAVeBdH\n",
       "0lSKfXWTaX7wpgfeHTCP7GomdKYdKfbxN+q6uB9YO1zP4+uhEdfFxviIt974Z7ocOJbGWhdjaX5w\n",
       "t72f/SF8ZFiOGjy4C411ctf2eH/2Y3gXxyz8HzIYP8iZNlzrVHzdzAH2qGawVbQjxVE9jbouNsZb\n",
       "/I/jrdwBNO66OIXicM7L8b3kRlkX1+DHNt7Hj39+lY599sJwzrnArzo9ahERERERERERERERERER\n",
       "ERERERERERERERERSff/GjA3GYIlWv0AAAAASUVORK5CYII=\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff06d0dd350>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": [
       "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\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff06d1669d0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Exemple Exp3 algorithm\n",
    "\n",
    "class Exp3():\n",
    "    def __init__(self, counts = [], values = [], n_arms = 0):\n",
    "\n",
    "        self.n_arms = n_arms\n",
    "        self.counts = [0 for col in range(n_arms)]\n",
    "        self.G = [0 for col in range(n_arms)]\n",
    "        init_proba = float(1/float(n_arms))\n",
    "        self.weights = [1 for col in range(n_arms)]\n",
    "        self.values = values\n",
    "        self.t = 0\n",
    "\n",
    "    \n",
    "    def select_arm(self, eta):\n",
    "        def tirage_aleatoire_avec_proba(proba_vect):\n",
    "            valeur_test = random.uniform(0, 1)\n",
    "            arm_chosen = -1\n",
    "            i = 0\n",
    "            sum_partiel = 0\n",
    "            while i <= len(proba_vect) and arm_chosen == -1 :\n",
    "                sum_partiel += (proba_vect[i])\n",
    "                if sum_partiel > valeur_test :\n",
    "                    arm_chosen = i\n",
    "                i += 1\n",
    "            return arm_chosen\n",
    "        self.recalcul_proba = False        \n",
    "        self.proba_vect = [0 for col in range(self.n_arms)]\n",
    "            \n",
    "        \n",
    "        #####################################\n",
    "        #ALGO CALCUL DU Pi\n",
    "        max_G = max(self.G)\n",
    "        sum_exp_eta_x_Gjt_max_G = 0 \n",
    "        self.t += 1\n",
    "        \n",
    "        for i in range(len(self.G)):\n",
    "            sum_exp_eta_x_Gjt_max_G += math.exp(eta*(self.G[i] - max_G))\n",
    "        for i in range(len(self.proba_vect)):\n",
    "            self.proba_vect[i] = math.exp(eta*(self.G[i] - max_G)) / float(sum_exp_eta_x_Gjt_max_G)\n",
    "            \n",
    "        ######################################    \n",
    "            \n",
    "        arm_chosen = tirage_aleatoire_avec_proba(self.proba_vect)\n",
    "\n",
    "        return arm_chosen\n",
    "    \n",
    "    \n",
    "    def update(self, chosen_arm, reward):\n",
    "        self.counts[chosen_arm] += 1\n",
    "        if not (self.recalcul_proba):\n",
    "            if self.counts[chosen_arm] != 1:\n",
    "                if self.proba_vect[chosen_arm] != 0:\n",
    "                    if self.proba_vect[chosen_arm] < 0.01: #Pour eviter les problemes de limite de calcul\n",
    "                        self.G[chosen_arm] =  float(self.G[chosen_arm]) + (float(reward)/0.01)\n",
    "                    else :\n",
    "                        self.G[chosen_arm] =  float(self.G[chosen_arm]) + (float(reward)/float(self.proba_vect[chosen_arm]))\n",
    "            else:\n",
    "                self.G[chosen_arm] = reward\n",
    "        else :\n",
    "            if self.counts[chosen_arm] != 1:\n",
    "                if self.proba_vect[chosen_arm] != 0:\n",
    "                    if self.proba_vect[chosen_arm] < 0.01:\n",
    "                        self.G[chosen_arm] =  float(self.G[chosen_arm]) + (float(reward)/0.01)\n",
    "                    else :\n",
    "                        self.G[chosen_arm] =  float(self.G[chosen_arm]) + (float(reward)/float(self.proba_vect_2[chosen_arm]))\n",
    "            else:\n",
    "                self.G[chosen_arm] = reward\n",
    "        \n",
    "\n",
    "        \n",
    "\n",
    "#Simulation part\n",
    "def simulate_arm_bernoulli(proba):\n",
    "    return 1 if random.random() < proba else 0\n",
    "\n",
    "def bernoulli_exp3(nb_try,  proba_arm_1, proba_arm_2, eta):\n",
    "    print \"exp3 : cas 2 bras suivant une loi de bernoulli, arm1 : %s, arm2: %s\" % (proba_arm_1, proba_arm_2)\n",
    "\n",
    "    algo = Exp3([],[], 2)\n",
    "    i = 0\n",
    "    vector_arms_chosen = []\n",
    "    reward_vect = []\n",
    "    reward_cum = 0\n",
    "    while i < nb_try :\n",
    "        chosen_arm = algo.select_arm(eta)\n",
    "        vector_arms_chosen.append(chosen_arm)\n",
    "        if chosen_arm == 0 :\n",
    "            reward =  simulate_arm_bernoulli(proba_arm_1)\n",
    "        else:\n",
    "            reward = simulate_arm_bernoulli(proba_arm_2)\n",
    "        algo.update(chosen_arm, reward)\n",
    "        reward_cum = reward_cum + reward\n",
    "        i += 1\n",
    "        reward_vect.append(reward_cum / float(i))\n",
    "    return reward_vect, algo.values, algo.counts, vector_arms_chosen\n",
    "\n",
    "#features\n",
    "iteration_nb = 1000\n",
    "arm_1_probability = 0.4\n",
    "arm_2_probability = 0.3\n",
    "eta= 0.05\n",
    "\n",
    "#bandit algorithm\n",
    "rewards_vect, values, count, arms_chosen = bernoulli_exp3(iteration_nb, arm_1_probability, arm_2_probability, eta)\n",
    "\n",
    "#Offline solution\n",
    "best_arm = [max(arm_1_probability, arm_2_probability) for x in range(iteration_nb)]\n",
    "\n",
    "cum_sum_arm_2 = cumsum(arms_chosen) #arm_chosen = 1 if arm2 selected, else arm_chosen = 0\n",
    "cum_sum_arm_1 = [ x - cum_sum_arm_2[x] for x in range(iteration_nb)]\n",
    "plot(range(iteration_nb),cum_sum_arm_1, range(iteration_nb), cum_sum_arm_2);\n",
    "title(\"Nombre de tirages de chaque bras\");\n",
    "legend([\"arm1 Proba %s\" % arm_1_probability, \"arm2 Proba %s\" % arm_2_probability], loc=\"upper left\");\n",
    "figure();\n",
    "\n",
    "#plot\n",
    "plot(range(iteration_nb), best_arm, 'k-', range(iteration_nb), rewards_vect, 'r--');\n",
    "title(\"Gain moyen par tour\");\n",
    "legend([\"Offline\",\"UCB1\"], loc=\"lower right\");\n",
    "    "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Dans le cas des bandits bornés entre $0$ et $1$, un choix adéquat pour le paramètre est $\\eta_t = \\sqrt{\\log(K)/(Kt)}$. Pour ce choix, on arrive à contrôler \\emph{uniformément} le regret~: $R_n \\leq 2\\sqrt{nK\\log(K)}$ (voir [2]). \n",
    "\n",
    "Cette borne de regret peut sembler décevante en regard des taux logarithmiques obtenus pour UCB, mais il convient de noter qu'il s'agit de bornes uniformes qui ne font pas intervenir les récompenses moyennes du problème considéré (et on peut prouver que, pour de telles bornes uniformes, on ne peut pas faire mieux). En outre, cette borne est en fait vraie au sens des séquences individuelles, ce qui est beaucoup plus fort (en particulier, elle ne nécessite pas de supposer que les récompenses sont i.i.d. conditionnellement aux actions).\n",
    "\n",
    "On pourra retenir que les algorithmes softmax sont moins performants mais plus robustes. Noter qu'il est en partie possible de combiner le \"meilleur des deux mondes\" (cf. par exemple [11]).\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## IV. Evaluation d'un système de recommandation : données Jester et MovieLens "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Nous utilisons le cadre expérimental défini par Kohli et al. [12]. Les expérimentations\n",
    "font appel aux jeux de données MovieLens-100 et Jester."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### IV.1 Jeu de données MovieLens"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    " MovieLens-100 contient 943 utilisateurs qui ont noté 100 films. Les notes sont comprises entre 1 (mauvais) et 5 (bon) (si un film n’est pas noté par un utilisateur, la note minimale lui est affectée). Pour traduire les notes en actions utilisateurs, Kohli et al. (2013) ont choisi de fixer un seuil de pertinence.\n",
    "Dans leurs expérimentations, deux valeurs ont été utilisées : 2 et 4. Lorsque le seuil est 4, tous les films qui ont une note strictement supérieure à 4 sont considérés comme pertinents, c’est-à-dire que l’utilisateur les a apprécié. La même logique est suivie pour le seuil de valeur 2."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "100\n"
     ]
    }
   ],
   "source": [
    "def get_first_100_docs():\n",
    "    \"\"\"Récupère les 100 premiers films du jeu u.data\"\"\"\n",
    "    first_100_docs = []\n",
    "    with open(r\"Datasets/ml_100K/u.data\") as f:\n",
    "        for line in f:\n",
    "            line = re.sub(\"\\n\", \"\", line)\n",
    "            line_tab = re.split(\"\\t\", line)\n",
    "            if line_tab[1] not in first_100_docs and len(first_100_docs) < 100  :\n",
    "                first_100_docs.append(line_tab[1])\n",
    "    return first_100_docs\n",
    "\n",
    "\n",
    "def replace_empty_cells_by_worst_rate():\n",
    "    first_100_docs = get_first_100_docs()\n",
    "    list_users = [] \n",
    "    hashtable_docs_corresponding = {}\n",
    "    nb_docs = len(first_100_docs)\n",
    "    for i, doc in enumerate(first_100_docs):\n",
    "        hashtable_docs_corresponding[doc] = i\n",
    "    rates_hashtable = {}\n",
    "\n",
    "    with open(r\"lib/movielens100.data\") as f:  \n",
    "        for line in f:\n",
    "            line = re.sub(\"\\n\", \"\", line)\n",
    "            current_user, current_doc, rate, timestamp = re.split(\"\\t\", line)\n",
    "            if current_user not in rates_hashtable.keys(): #si pas de données sur cet utilisateur, initialisation d'un tableau de hachage contenant les notes par documents\n",
    "                rates_hashtable[current_user] = {}\n",
    "                for doc in first_100_docs:\n",
    "                    rates_hashtable[current_user][hashtable_docs_corresponding[doc]] = 0.0\n",
    "                rates_hashtable[current_user][hashtable_docs_corresponding[current_doc]] = float(rate)\n",
    "                list_users.append(current_user)\n",
    "            else:\n",
    "                rates_hashtable[current_user][hashtable_docs_corresponding[current_doc]] = float(rate)\n",
    "    return rates_hashtable, list_users,  nb_docs      \n",
    "rates_hashtable, list_users,  nb_docs  = replace_empty_cells_by_worst_rate()\n",
    "print nb_docs"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### IV.2 Jeu de données Jester"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Jester contient 25000 utilisateurs qui ont noté 100 blagues. Les notes sont comprises entre -10 (pas drôle) et 10 (très drôle). Kohli et al. (2013) ont choisi de fixer le seuil de pertinence à 7 comme seuil à partir duquel les blagues recommandées sont considérées comme pertinentes."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "100\n"
     ]
    }
   ],
   "source": [
    "import re\n",
    "\n",
    "def import_jester_collection(): \n",
    "    user_id = 0\n",
    "    list_users = [] \n",
    "    nb_docs = 100\n",
    "    rates_hashtable = {}\n",
    "    with open(r\"Datasets/Jester/jester-data-1.csv\") as f:\n",
    "        for line in f:\n",
    "            list_users.append(user_id)\n",
    "            rates_hashtable[user_id] = {}\n",
    "            line = re.sub(\"\\n\",\"\",line)\n",
    "            line = re.split(\",\", line)\n",
    "            line = line[1:101] # Conserve uniquement les 100 blagues les plus notées\n",
    "            for i in range(100):\n",
    "                if line[i] == \"99.00\":\n",
    "                    line[i] = \"-10.00\"\n",
    "                rates_hashtable[user_id][i] = float(line[i])\n",
    "            user_id += 1\n",
    "    return rates_hashtable, list_users, nb_docs\n",
    "\n",
    "rates_hashtable, list_users, nb_docs = import_jester_collection()\n",
    "print nb_docs"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## V. Bandits à actions multiples : approche RBA "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": false
   },
   "source": [
    "L’approche RBA (Algorithme 1) a été développée par Radlinski et al. [13] et\n",
    "nécessite **l’utilisation en parallèle d'autant d'instances d’un algorithme de bandit à tirages simples qu'il y a de recommandations à faire à chaque instant**. À chaque instant t, les m objets choisis par les m instances d’algorithme\n",
    "de bandit sont recommandés à l’utilisateur. L’information de chaque instance\n",
    "est mise à jour de la manière suivante : l’instance correspondant au premier objet\n",
    "cliqué obtient une récompense de 1, tandis que tous les autres obtiennent une récompense\n",
    "de 0. De cette manière, la première instance tend à recommander l’objet avec\n",
    "le taux de clics le plus haut. La deuxième instance peut recevoir une récompense de 1\n",
    "uniquement si le premier objet n’est pas cliqué. Elle tend ainsi à recommander l’objet\n",
    "avec le taux de clics le plus haut quand l’objet avec le taux de clics le plus haut n’est\n",
    "pas cliqué. Et ainsi de suite pour les instances suivantes.\n",
    "\n",
    "Algorithme 1 : Ranked Bandits Algorithm\n",
    ">BTS(i): instance d’un algorithme de bandit à tirages simples pour la recommandation en position i\n",
    "\n",
    "    Pour t = 1, . . . , T faire\n",
    "        Pour i = 1, . . . , nb_documents_a_recommander faire  \n",
    "            document(i) ← SélectionnerObjet(BTS(i), K)  \n",
    "            si document(i) ∈ {document(1), . . . , document(i−1)} alors  \n",
    "                document(i) ← choix arbitraire parmi les documents non sélectionnés  \n",
    "            fin  \n",
    "        fin  \n",
    "        A(t) ← ∪ a(i)  \n",
    "        Recommander A(t) à l’utilisateur, récupérer le retour utilisateur X(t)  \n",
    "        Pour i = 1, . . . , m faire  \n",
    "            Retour utilisateur : z(i) = 1 si le document(i) est le premier cliqué, 0 sinon  \n",
    "            Mise à jour de l'estimateur de la pertinence du document(i) pour BTS(i) en fonction du retour z(i)\n",
    "        fin  \n",
    "    fin  \n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": [
       "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\n",
       "gg==\n"
      ],
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff06d31b0d0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[0.0, 0.38, 0.4, 0.37, 0.39, 0.46, 0.49, 0.5, 0.49, 0.46, 0.48, 0.47, 0.47, 0.47, 0.5, 0.46, 0.47, 0.5, 0.48, 0.5, 0.53, 0.51, 0.49, 0.47, 0.47, 0.48, 0.51, 0.49, 0.47, 0.49, 0.48, 0.48, 0.48, 0.48, 0.48, 0.49, 0.49, 0.51, 0.51, 0.49, 0.49, 0.48, 0.49, 0.48, 0.49, 0.48, 0.49, 0.48, 0.48, 0.47, 0.46, 0.5, 0.48, 0.49, 0.5, 0.46, 0.48, 0.47, 0.46, 0.51, 0.47, 0.47, 0.47, 0.44, 0.47, 0.49, 0.49, 0.47, 0.52, 0.54, 0.51, 0.48, 0.49, 0.53, 0.49, 0.55, 0.52, 0.55, 0.55, 0.53, 0.54, 0.53, 0.55, 0.54, 0.53, 0.55, 0.55, 0.58, 0.56, 0.5, 0.55, 0.55, 0.53, 0.53, 0.53, 0.55, 0.53, 0.55, 0.55, 0.56]\n"
     ]
    }
   ],
   "source": [
    "import math \n",
    "import random\n",
    "import time\n",
    "\n",
    "# some elements of the code\n",
    "\n",
    "\n",
    "class RBA():\n",
    "    def __init__(self, nb_ranks,algorithm):\n",
    "        self.nb_ranks = nb_ranks \n",
    "        list_algorithms = [\"UCB1\",\"EpsilonGreedy\",\"Exp3\"]\n",
    "        if algorithm not in list_algorithms:\n",
    "            print 'Les algorithmes disponibles pour le IBA sont : %s' % list_algorithms\n",
    "            quit()\n",
    "        self.algorithm = algorithm\n",
    "            \n",
    "    def initialize(self, nb_arms):\n",
    "        self.nb_arms = nb_arms\n",
    "        self.MBA_ranks = []\n",
    "        for i in range(self.nb_ranks):\n",
    "            if self.algorithm == \"UCB1\":\n",
    "                self.MBA_ranks.append(UCB1([], [], self.nb_arms))\n",
    "            if self.algorithm == \"EpsilonGreedy\":\n",
    "                self.MBA_ranks.append(EpsilonGreedy(0.05, [], [], self.nb_arms))\n",
    "            if self.algorithm == \"Exp3\":\n",
    "                self.MBA_ranks.append(Exp3([], [], self.nb_arms))\n",
    "                \n",
    "                \n",
    "    def select_arms(self, eta = 0):\n",
    "        arms_chosen = []\n",
    "        if self.algorithm == \"Exp3\":\n",
    "            for i in range(self.nb_ranks):\n",
    "                arm_chosen = self.MBA_ranks[i].select_arm(eta)\n",
    "                arms_chosen.append(arm_chosen)\n",
    "        else:\n",
    "            for i in range(self.nb_ranks):\n",
    "                arm_chosen = self.MBA_ranks[i].select_arm()\n",
    "                arms_chosen.append(arm_chosen)\n",
    "        return arms_chosen\n",
    "    \n",
    "    def update_arms(self, arms_chosen, rewards):\n",
    "        #print arms_chosen\n",
    "        #print rewards\n",
    "        for i in range(len(arms_chosen)) :\n",
    "            #print \"1 : %s\" %  self.MBA_ranks[i].values\n",
    "            #print \"%s, %s\"% (arms_chosen[i], rewards[i])\n",
    "            self.MBA_ranks[i].update(arms_chosen[i], rewards[i])\n",
    "            #print \"2 : %s\" %  self.MBA_ranks[i].values\n",
    "\n",
    "#Méthode responsable de l'allocation des rcompenses\n",
    "def get_rewards(arms_chosen, hashtable_users_data, user_chosen, threshold):\n",
    "    hashtable_pertinence = hashtable_users_data[user_chosen]\n",
    "    rewards = []\n",
    "    first_clic_found = False\n",
    "    for arm in arms_chosen :\n",
    "        if hashtable_pertinence[arm] > threshold and not first_clic_found : \n",
    "            rewards.append(1)\n",
    "            first_clic_found = True\n",
    "        else :\n",
    "            rewards.append(0)\n",
    "    return rewards\n",
    "\n",
    "# Utilisation de l'algorithme RBA sur nos collections\n",
    "def use_RBA(threshold, hashtable_users_data, list_users, bandit_algorithm, nb_docs):   \n",
    "    RBA_item = RBA(5, bandit_algorithm)\n",
    "    RBA_item.initialize(nb_docs)\n",
    "    cum_rewards = []\n",
    "    rewards_vect = [0 for i in range(100)]\n",
    "    for i in range(100000):\n",
    "        user_chosen = list_users[int(random.random()*len(list_users))]\n",
    "        arms_chosen = RBA_item.select_arms(eta)\n",
    "        rewards = get_rewards(arms_chosen, hashtable_users_data, user_chosen, threshold)\n",
    "        RBA_item.update_arms(arms_chosen, rewards)\n",
    "        if 1 in rewards : #non abandonment\n",
    "            cum_rewards.append(1)\n",
    "        else:\n",
    "            cum_rewards.append(0)\n",
    "        if i % 1000 == 0 and i != 0 :\n",
    "            rewards_vect[i/1000] = (sum(cum_rewards) / float(1000))\n",
    "            cum_rewards = []\n",
    "    return rewards_vect\n",
    "        \n",
    "# Permet de représenter l'évolution de l'abandon en fonction du temps passé\n",
    "def tracer_graphique(threshold, rewards_tab, legend_list):\n",
    "    \"Graphique\" \n",
    "    fig = pyplot.figure()\n",
    "    ax = fig.add_subplot(1,1,1)\n",
    "    style = ['k', 'c', 'b', 'b-.', 'b--', 'r', 'r-.', 'r--', 'g', 'g-.', 'g--', 'y', 'y-.', 'y--', 'm', \"m-.\", \"m--\"]\n",
    "    for i, rewards in enumerate(rewards_tab) :\n",
    "        ax.plot(range(0, 100000, 1000), rewards, style[i])\n",
    "        \n",
    "        \n",
    "    ax.set_xscale('log')\n",
    "    ax.xaxis.set_tick_params(size=5)\n",
    "    ax.xaxis.set_ticks_position('bottom')\n",
    "    ax.yaxis.set_ticks_position('left')\n",
    "    ax.set_xticks([1000, 5000, 10000, 50000, 100000])\n",
    "    ax.set_xticklabels(['1000', '5000', '10000', '50000', '100000'])\n",
    "    ax.legend(legend_list, loc=\"lower right\")\n",
    "    xlabel(\"Time Steps\")\n",
    "    ylabel(\"Fraction of Relevant Sets (1 - Abandonment)\")\n",
    "    show()   \n",
    "    \n",
    "##################\n",
    "#### FEATURES ####\n",
    "##################\n",
    "threshold = 4 #2 ou 4 pour MovieLens, 7 pour Jester\n",
    "nb_try = 1\n",
    "collection = \"MovieLens\"\n",
    "bandit_subroutine = \"EpsilonGreedy\"\n",
    "rewards_type = \"1 - abandon\"\n",
    "eta= 0.05\n",
    "\n",
    "#Importation des données\n",
    "if collection == \"MovieLens\":\n",
    "    hashtable_users_data, list_users, nb_docs = replace_empty_cells_by_worst_rate()\n",
    "elif collection == \"Jester\":\n",
    "    hashtable_users_data, list_users, nb_docs = import_jester_collection()\n",
    "else:\n",
    "    print \"Unknown collection\\n\"\n",
    "    error_message()\n",
    "\n",
    "# Utilisation de l'algorithme RBA\n",
    "rewards_vect = use_RBA(threshold, hashtable_users_data, list_users, bandit_subroutine, nb_docs)\n",
    "\n",
    "#Solutions optimales (en fonction du seuil et de la collection)\n",
    "if threshold == 4 :\n",
    "    rewards_vect_max = [529/float(len(list_users)) for col in range(100)]\n",
    "    rewards_vect_max_no_diversity = [524/float(len(list_users)) for col in range(100)]\n",
    "\n",
    "elif threshold == 2 : \n",
    "    rewards_vect_max = [866/float(len(list_users)) for col in range(100)]\n",
    "    rewards_vect_max_no_diversity = [825/float(len(list_users)) for col in range(100)]\n",
    "else :\n",
    "    rewards_vect_max = [12981/float(len(list_users)) for col in range(100)]\n",
    "    rewards_vect_max_no_diversity = [12672/float(len(list_users)) for col in range(100)]\n",
    "\n",
    "#Graphiques\n",
    "try:\n",
    "    tracer_graphique(threshold, [rewards_vect_max, rewards_vect_max_no_diversity, rewards_vect], [\" offline diversity\", \"offline no diversity\", \"RBA E-greedy\", \"IBA E-greedy\"])\n",
    "except:\n",
    "    print \"impossible de tracer le graphique\"\n",
    "\n",
    "print [round(x,2) for x in rewards_vect]\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "# Quelques références \n",
    "\n",
    "[1] Thompson, W. (1933), On the likelihood that one unknown probability exceeds another in\n",
    "  view of the evidence of two sample {Bulletin of the {A}merican mathematics society}, 25:285--294.\n",
    "\n",
    "[2] Bubeck, S. and Cesa-Bianchi, N. (2012), Regret analysis of stochastic and nonstochastic multi-armed bandit\n",
    "  problems, {Foundations and trends in machine learning}, 5(1):1--122.  \n",
    "  \n",
    "[3] Hu, F. and Rosenberger, W.~F. (2006), {The theory of response-adaptive randomization in clinical\n",
    "  trials}, Wiley Series in Probability and Statistics. Wiley-Interscience [John  Wiley & Sons], Hoboken, NJ.\n",
    "  \n",
    "[4] Jennison, C. and Turnbull, B.~W. (2000), {Group sequential methods with applications to clinical trials}, Chapman & Hall/CRC, Boca Raton, FL.  \n",
    "  \n",
    "[5] Cesa-Bianchi, N. and Lugosi, G. (2006), {Prediction, Learning, and Games}, Cambridge University Press.\n",
    "\n",
    "[6] Lai, T. and Robbins, H. (1985), Asymptotically efficient adaptive allocation rules, {Advances in Applied Mathematics}, 6(1):4--22.\n",
    "\n",
    "[7] Kaufmann, E. and Cappé, O. and Garivier, A. (2015), Complexity of Best-Arm Identification in Multi-Armed Bandits, {Journal of Machine Learning Research}.\n",
    "\n",
    "[8] Kaufmann, E. and Korda, N. and Munos, R. (2012), Thompson Sampling : an Asymptotically Optimal Finite-Time Analysis, { Algorithmic Learning Theory (ALT)}.\n",
    "\n",
    "[9] Sutton, R.S. and Barto, A.G. (1998), {Reinforcement learning: An introduction}, The MIT press.\n",
    "\n",
    "[10] Auer, P. and Cesa-Bianchi, N. and Fischer, P. (2002), Finite-time analysis of the multiarmed bandit problem, {Machine Learning}, 47(2):235--256.\n",
    "\n",
    "[11] Bubeck, S. and Slivkins, A. (2012), The best of both worlds: stochastic and adversarial bandits, {Conference On Learning Theory (COLT)}.\n",
    "\n",
    "[12] Kohli, P. and Salek, M. and Stoddard, G. (2013), A Fast Bandit Algorithm for Recommendation to Users With Heterogeneous Tastes, 27th AAAI Conference on Artificial Intellignece, 1135--1141.\n",
    "\n",
    "[13] Radlinski, F. and Kleinberg, R. and Joachims, T. (2008) Learning Diverse Rankings with Multi-Armed Bandits, {25th International Conference on  Machine Learning},  784--791.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\u001b[0m\u001b[01;34malgorithms\u001b[0m/  \u001b[01;34mapplications\u001b[0m/  \u001b[01;34mdata\u001b[0m/  \u001b[01;34mDatasets\u001b[0m/  demoBandits.ipynb  \u001b[01;34mdemo_package\u001b[0m/  \u001b[01;34mJDS15\u001b[0m/  \u001b[01;34mlib\u001b[0m/  \u001b[01;34mmultiarms_algorithms\u001b[0m/  \u001b[01;34mtest_package\u001b[0m/  \u001b[01;34mtraitement_collections\u001b[0m/  \u001b[01;34mTravaux\u001b[0m/  \u001b[01;34muse_algorithms\u001b[0m/\r\n"
     ]
    }
   ],
   "source": []
  }
 ],
 "metadata": {
  "celltoolbar": "Raw Cell Format",
  "kernelspec": {
   "display_name": "Python 2",
   "language": "python",
   "name": "python2"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 2
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython2",
   "version": "2.7.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}
