parallel_chess_engine.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Parallelizing a chess engine\n",
    "\n",
    "## Summary\n",
    "\n",
    "One of our university chess club's project is to implement a decent chess playing engine. The co-author and I decided to take one of the engines designed by our classmates and improve it. \n",
    "\n",
    "This notebook illustrates the steps taken towards optimizing this simple chess engine in an incremental way, starting by parallelizing it's search algorithm, then applying some optimization techniques, and finally trying out the iterative deepening variation of the classical minimax algorithm.\n",
    "\n",
    "At each step, a simulation is executed to test the performance of the improvement. A simulation is a succession of chess games played between two different versions of the engine, comparing search time between them. It does not matter which of the two engines wins, as it is not part of this work to make it play \"smarter\", the heuristic estimation functions for all the versions in this notebook are the same, we put the focus only on execution time.\n",
    "\n",
    "We recommend that the reader knows the minimax alpha-beta pruning algorithm in order to fully understand the challenges faced in parallelizing it, and the improvement steps taken.\n",
    "\n",
    "\n",
    "## Introduction \n",
    "\n",
    "   One of the most classical challenges in artificial intelligence and computer science in general is chess programming. At first glance, it may appear relatively easy and straightforward compared to others problems, but when we think about it, we quickly realize that it is not easy at all given the necessity to enumerate every single possible move imaginable. If that is not enough, there exist 10 to the power of 120 (that is 1 followed by 120 zeros) possibilities. The entire universe contains nearly 10 to the power of 80 atoms! Quite a gap, isn’t it?\n",
    "   \n",
    "This outstriking number gave chess programming all the interest in computer science research we witness today. Fortunately for us, there exist an algorithm which gives computers the ability to play chess, that is the Minimax algorithm. The minimax; from a given node in the search tree, computes all its children (that is the set of all the possibles moves from the current configuration) and visits each child one by one, computing each time an evaluation function that gives away a kind of performance of that child. We repeat that recursively until we reach the leaves. At the end, the algorithm chooses the branch with the highest evaluation. However, the search tree being too large, we generally stop at a maximum depth, otherwise it would be computationally heavy or worse:impossible.\n",
    "\n",
    "Discussing the nitty-gritties of the minimax detailed functioning comes outside the scope of this notebook, for this reason, we give a few links for those who want to know more about it.\n",
    "\n",
    "So yes, we stop at a given depth. Obviously, the deeper we dive the better. But which depth exactly can we reach? This depends heavily on the machine used and the algorithm. Of course, most of the time, we use the minimax, but we can also tweak it, make it more robust, make it dive deeper, and that’s exactly what we try to tackle in this notebook. By parallelizing the search, we can compute independent branches simultaneously, gaining a considerable time that we could use to visit an extra layer and thus resulting in a more confident response from the minimax algorithm.\n",
    "\n",
    "For this task, we were given an already existing working chess engine written in C, as building a new one from grounds up would take too much time and is out of the scope of this work. Instead, we focused on optimizing it by parallelizing the computation of independent branches. To show off some results, we also wrote a python script to compute some statistics and plot them for easy visualization.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## What we will do\n",
    "\n",
    "   In this notebook, we are going to incrementally improve the given chess engine by employing an extra optimization technique each time, and then compare it to the previous one by simulating chess games at different depths between the engine and its improved version. But first things first, before we start parallelizing stuff, we must find an algorithm that allows this parallelization while still taking advantage of the alpha-beta pruning technique. This is not straightforward given the sequential nature of the alpha-beta pruning in a minimax search. After reading a few theses about the matter, we will present in this notebook the most used parallelization techniques, and implement one of them. And then we will try to improve the engine further by trying out a few optimization techniques.\n",
    "   \n",
    "## Overview of parallel search algorithms\n",
    "\n",
    "### 1- Younger Brothers Wait Concept\n",
    "\n",
    "One method to approach the problem of parallelizing the game search tree is to use the younger brothers wait concept. \n",
    "The main idea of this algorithm resides in visiting the leftmost branch to establish an alpha bound. After establishing this bound, work on the rest of the tree can be divided and scheduled to processors. \n",
    "You may find more information on this technique here: https://pdfs.semanticscholar.org/8e1c/9f70aa4849475199e26ccd3e21c662e2d801.pdf\n",
    "\n",
    "### 2- Lazy SMP\n",
    "\n",
    "The lazy SMP algorithm is considered the state of the art in parallelization techniques. It is a very different algorithm used in Stock Fish chess engine. In lazy SMP, threads have minimal to no communication at all except for the use of a common hash table. \n",
    "It trades synchronization overhead with greater search operations. The idea behind lazy SMP is quite simple and straightforward. All we want to do is to minimize the communication overhead between threads, and thus by letting them compute whatever branches they want, storing the results, of course, in a shared hash table in order to avoid computing the same branch more than once. The effort in lazy SMP resides in making threads search slightly different branches each time.\n",
    "You can read more about lazy SMP here: https://www.duo.uio.no/bitstream/handle/10852/53769/master.pdf?sequence=1\n",
    "\n",
    "### 3- Root splitting\n",
    "\n",
    "\n",
    "The main idea of this technique is to ensure that each node except for the root, is visited by only one processor. To keep the effect of the alpha beta pruning, we split the children nodes of the root into clusters, each cluster being served by only one thread. Each child is then processed as the root of a sub search tree that will be visited in a sequential fashion, thus respecting the alpha beta constraints. \n",
    "When a thread finishes computing it’s subtree(s) and returns its evaluation to the root node, that evaluation is compared to the current best evaluation (that’s how minimax works), and that best evaluation may be updated. So to ensure coherent results, given that multiple threads may be returning to the root node at the same time, threads must do this part of the work in mutual exclusion: meaning that comparing to and updating the best evaluation of the root node must be inside a critical section so that it’s execution remains sequential. And that’s about everything about this algorithm!\n",
    "\n",
    "Given the time allowed for this project and the relative simplicity of implementation, we came to choose this algorithm for our project. \n",
    "We used the openmp library to do multithreading for its simplicity and efficiency. The full implementation of the root splitting algorithm can be found on the repository. We'll just illustrate the key (changed) parts of the original C code here.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "![Root splitting](Root_splitting.png \"Splitting the search tree at the root\")\n",
    "\n",
    "We said that we parallelize at the root level, so for that we parallelize the for loop that iterates over the children of the root node for calling the minimax function on them.\n",
    "for that, we use the following two openmp directives:\n",
    "\n",
    "\\#pragma omp parallel private (/*variables private to thread here */)\n",
    "\\#pragma omp for schedule (dynamic)\n",
    "\n",
    "The two above directives need to be put right before the for loop to parallelize. In the first one we declared the variables that must be private to each thread.\n",
    "In the second directive we specified a dynamic scheduling between threads, meaning that if a thread finishes his assigned iterations before others do, he'll get assigned some iterations from another thread, that way making better use of the available threads.\n",
    "\n",
    "Then we must ensure inside our for loop that after each minimax call returns, the thread enters in a critical section in mutual exclusion to compare (and modify) the best evaluation of the root node. \n",
    "We do that using the following directive:\n",
    "\n",
    "\\#pragma omp critical\n",
    "{\n",
    "    // Code here is executed in mutual exclusion\n",
    "}\n",
    "\n",
    "All the code written inside this directive will be run by at most one thread at a time, ensuring thus the coherence of the value of our best evaluation variable."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## The simulation code\n",
    "\n",
    "To compare the performance  of the parallelized version of the chess engine against the sequential one, we wrote a python script that computes some statistics. This simple program makes the old engine play against the parallel one at different search depths. For each depth, we make them play 10 games, we record the time taken for each move  (in chess terms: each ply) of the game for both players (separately, of course!) and then we compute the mean of all the moves for all the games. In addition to execution times, we store the number of nodes visited to compare the search spaces explored by both players.\n",
    "The machine used has Intel I5 4th generation processor and 8 GB of RAM.\n",
    "\n",
    "Here is the simulation python code:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [],
   "source": [
    "from subprocess import call\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "\n",
    "from collections import namedtuple"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [],
   "source": [
    "def simulation(progName, nGames=10, depth=4):\n",
    "\n",
    "    \n",
    "    fileName = \"results.txt\"\n",
    "    #To store the timing values (means) for a specific depth\n",
    "    oldMeanPerDepth = []\n",
    "    newMeanPerDepth = []\n",
    "\n",
    "    #To store the number of nodes visited from root until a specific depth\n",
    "    oldNodeNumPerDepth = []\n",
    "    newNodeNumPerDepth = []\n",
    "\n",
    "    #To store the timing values (means) for all depths [THose that are going to be used for plottig]\n",
    "    oldGlobalMean = []\n",
    "    newGlobalMean = []\n",
    "\n",
    "    #To store the number of noes visited for all depths [THose that are going to be used for plottig]\n",
    "    oldNodeNum = []\n",
    "    newNodeNum = []\n",
    "\n",
    "     #the result\n",
    "    stats = namedtuple(\"Stats\", [\"oldGlobalMean\", \"newGlobalMean\", \"oldNodeNum\", \"newNodeNum\"])\n",
    "\n",
    "    #generate all the possible depths\n",
    "    depths = range(1, depth + 1)\n",
    "\n",
    "    for h in depths:\n",
    "        for g in range(nGames):\n",
    "            retCode = call([progName, str(h)])\n",
    "            with open(fileName, \"r\") as f: #filename is the file path to the file generated by the chess engine written in C\n",
    "                #first two lines in the file represent the number of nodes visited for both the first algorithm aand the second one respectively\n",
    "                oldNodeNumPerDepth.append(float(f.readline().strip(\" \")))\n",
    "                newNodeNumPerDepth.append(float(f.readline().strip(\" \")))\n",
    "\n",
    "                #we calculate for each depth, for each game the mean of the time taken by one program to perform a move\n",
    "                old = list(map(float, f.readline().strip().split()))\n",
    "                new = list(map(float, f.readline().strip().split()))\n",
    "                oldMeanPerDepth.append(sum(old) / len(old))\n",
    "                newMeanPerDepth.append(sum(new) / len(new))\n",
    "\n",
    "        #we assigne the infomation relative to each depth to the global lists\n",
    "        oldGlobalMean.append(sum(oldMeanPerDepth) / len(oldMeanPerDepth))\n",
    "        newGlobalMean.append(sum(newMeanPerDepth) / len(newMeanPerDepth))\n",
    "        oldNodeNum.append(int(sum(oldNodeNumPerDepth) / len(oldNodeNumPerDepth)))\n",
    "        newNodeNum.append(int(sum(newNodeNumPerDepth) / len(newNodeNumPerDepth)))\n",
    "        oldMeanPerDepth  = []\n",
    "        newMeanPerDepth = []\n",
    "        oldNodeNumPerDepth = []\n",
    "        newNodeNumPerDepth = []\n",
    "\n",
    "    #assign everything to the named tuple \n",
    "    stats.oldGlobalMean = oldGlobalMean\n",
    "    stats.newGlobalMean = newGlobalMean\n",
    "    stats.oldNodeNum = oldNodeNum\n",
    "    stats.newNodeNum = newNodeNum\n",
    "    return stats\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The above function runs the C code simulation, gets the generated statistics from a text file, calculates the appropriate means and returns those stats in a named tuple.\n",
    "The following function plots these stats:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [],
   "source": [
    "def plotting(stats, old_name, new_name, depth=4):\n",
    "    \n",
    "    #generate all the possible depths\n",
    "    depths = range(1, depth + 1)\n",
    "\n",
    "    #Only for plotting purposes\n",
    "    offset = 0.2\n",
    "    figure = plt.subplot(121)\n",
    "    figure.bar(np.array(depths) - offset, stats.oldGlobalMean, width=2*offset, color=\"lime\")\n",
    "    figure.bar(np.array(depths) + offset, stats.newGlobalMean, width=2*offset, color=\"cyan\")\n",
    "    plt.xlabel(\"Depth\")\n",
    "    plt.ylabel(\"Execution time (s)\")\n",
    "    plt.legend([old_name, new_name])\n",
    "\n",
    "    figure = plt.subplot(122)\n",
    "    figure.bar(np.array(depths) - offset, stats.oldNodeNum, width=2*offset, color=\"lime\")\n",
    "    figure.bar(np.array(depths) + offset, stats.newNodeNum, width=2*offset, color=\"cyan\")\n",
    "    plt.xlabel(\"Depth\")\n",
    "    plt.ylabel(\"Visited nodes\")\n",
    "    plt.legend([old_name, new_name])\n",
    "    plt.show()\n",
    "    plt.close()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To run the simulation, we'll specify the C program name for the simulate function. The code to compile that program is on the repository. Our first C program makes the sequential engine play against the parallel one.\n",
    "Let's go with 3 full games at depth 4:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [],
   "source": [
    "stats = simulation(\"src/seq_vs_paral\", nGames=3)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "And we plot the results:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAtQAAAF+CAYAAACiQo3lAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMS4yLCBo\ndHRwOi8vbWF0cGxvdGxpYi5vcmcvNQv5yAAAIABJREFUeJzt3XmcnWV99/HPjyQQNBEriQokJCkG\nCwQSwrAJhSigoAgFoRCFGkFSLYtbsRF9BBXbPohQtbGURRBlE7QaeaBYlFVZsjRACIIpi4zgQ1gC\n5GFJAr/nj3MSh2GWO3PPfc6Zmc+b17xy7uWc8517mCu/XOe6rysyE0mSJEl9s0GzA0iSJEkDmQW1\nJEmSVIIFtSRJklSCBbUkSZJUggW1JEmSVIIFtSRJklSCBbUkqVIR8b2IeCIilhQ49+yIWFz/eiAi\nVjQioySVEc5DLUmqUkTsBawELs7MKevxvBOBHTPzmMrCSVI/sIdaklSpzLwZeLrjvojYKiL+MyIW\nRsQtEfEXXTx1JnBZQ0JKUgnDmx1AkjQknQt8IjN/FxG7At8F3rP2YERMACYBv2pSPkkqzIJaktRQ\nETEKeBdwZUSs3b1Rp9OOBK7KzFcamU2S+sKCWpLUaBsAKzJzWg/nHAkc36A8klSKY6glSQ2Vmc8B\nD0XE4QBRM3Xt8Yh4J/BnwG1NiihJ68WCWpJUqYi4jFpx/M6IaI+IY4GPAMdGxF3AvcDBHZ4yE7g8\nnYZK0gDhtHmSJElSCfZQS5IkSSVYUEuSJEklDLhZPsaMGZMTJ05sdgxJWm8LFy58MjPHNjtHI9lm\nSxrIirbbA66gnjhxIgsWLGh2DElabxHxSLMzNJpttqSBrGi77ZAPSZIkqYRKC+qI2D8i7o+IZREx\np4vjZ0fE4vrXAxGxoso8kiRJUn+rbMhHRAwD5gL7Ae3A/IiYl5lL156TmZ/pcP6JwI5V5ZEkSZKq\nUOUY6l2AZZn5IEBEXE5t4v6l3Zw/Ezi1L2+0evVq2tvbeemll/oUVNUYOXIk48aNY8SIEc2OIqmF\n2Ga3Jttsqe+qLKi3AB7tsN0O7NrViRExAZgE/Kqb47OB2QBbbrnl6463t7czevRoJk6cSESUjK3+\nkJk89dRTtLe3M2nSpGbHkdRCbLNbj222VE6VY6i7aiW7W5bxSOCqzHylq4OZeW5mtmVm29ixr5+5\n5KWXXmLTTTe1YW4hEcGmm25qD5Sk17HNbj222VI5VRbU7cD4DtvjgMe6OfdI4LIyb2bD3Hr8mUjq\nju1D6/FnIvVdlQX1fGByREyKiA2pFc3zOp8UEe8E/gy4rcIsDfH1r3+d7bbbjh122IFp06Zxxx13\nNDXPjTfeyG9+85t12+eccw4XX3xxj8857bTTOPPMM6uOJklNZ5stqb9UNoY6M9dExAnAdcAw4HuZ\neW9EfBVYkJlri+uZwOWZ2d1wkPUWXY426bvsdqTKn9x2221cffXVLFq0iI022ognn3ySVatW9WuO\n9XXjjTcyatQo3vWudwHwiU98oql5JKkrttk1ttnSwFXpPNSZeU1mbp2ZW2Xm1+v7vtyhmCYzT8vM\n181RPdA8/vjjjBkzho022giAMWPGsPnmm7Nw4UL23ntvdtppJ973vvfx+OOPA7Bw4UKmTp3K7rvv\nzsknn8yUKVMAuOiiizjhhBPWve6BBx7IjTfeCMAvfvELdt99d6ZPn87hhx/OypUrgdpKZKeeeirT\np09n++2357e//S0PP/ww55xzDmeffTbTpk3jlltueU1PxnnnncfOO+/M1KlT+dCHPsQLL7zQqEsl\nSU1nmy2pP7lSYj9573vfy6OPPsrWW2/N3/3d33HTTTexevVqTjzxRK666ioWLlzIMcccwxe/+EUA\nPvaxj/Htb3+b224rNtLlySef5PTTT+f6669n0aJFtLW1cdZZZ607PmbMGBYtWsQnP/lJzjzzTCZO\nnMgnPvEJPvOZz7B48WL+8i//8jWvd+ihhzJ//nzuuusuttlmGy644IL+uxiS1OJssyX1pyqnzRtS\nRo0axcKFC7nlllu44YYbOOKII/jSl77EkiVL2G+//QB45ZVX2GyzzXj22WdZsWIFe++9NwBHH300\n1157bY+vf/vtt7N06VL22GMPAFatWsXuu+++7vihhx4KwE477cRPfvKTXvMuWbKEL33pS6xYsYKV\nK1fyvve9r0/ftyQNRLbZkvqTBXU/GjZsGDNmzGDGjBlsv/32zJ07l+222+51PRorVqzo9m7q4cOH\n8+qrr67bXjuFUWay3377cdllXU+GsvZjy2HDhrFmzZpes86aNYuf/vSnTJ06lYsuumjdR5SSNFTY\nZkvqLw756Cf3338/v/vd79ZtL168mG222Ybly5eva5xXr17Nvffey5vf/GY22WQTbr31VgAuueSS\ndc+bOHEiixcv5tVXX+XRRx/lzjvvBGC33Xbj17/+NcuWLQPghRde4IEHHugx0+jRo3n++ee7PPb8\n88+z2WabsXr16te8v1RGNOE/qS9ss6XmiSZ8Vc0e6n6ycuVKTjzxRFasWMHw4cN5xzvewbnnnsvs\n2bM56aSTePbZZ1mzZg2f/vSn2W677bjwwgs55phjeMMb3vCaj+722GMPJk2axPbbb8+UKVOYPn06\nAGPHjuWiiy5i5syZvPzyywCcfvrpbL311t1m+uAHP8hhhx3Gz372M77zne+85tjXvvY1dt11VyZM\nmMD222/fbSMuSYORbbak/hT9OFtdQ7S1teWCBQtes+++++5jm222aVKi8h5++GEOPPBAlixZ0uwo\n/W6g/2y0fprRY1xkirRWERELM7Ot2TkayTZ7YBnoPxsNDM34bLGvf1MUbbcd8iFJkiSVYEHdAiZO\nnDgoezokaTCyzZbUmQW1JEmSVIIFtSRJklSCBbUkSZJUggW1JEmSVIIFdT8ZNmwY06ZNY8qUKXzw\ngx9kxYoVfXqdhx9+mEsvvbRfMs2aNYurrroKgI9//OMsXboUgH/8x39cd86KFSv47ne/u277scce\n47DDDuuX95ekVmWbLak/DcqCuhmr62y88cYsXryYJUuW8Ja3vIW5c+f2KXt/Ns4dnX/++Wy77bZA\nz43z5ptvvq5Bl6RGsM1+PdtsaWAZlAV1s+2+++784Q9/ACAzOfnkk5kyZQrbb789V1xxRY/758yZ\nwy233MK0adM4++yzX/O6jz/+OHvttde6XpVbbrkFgFGjRvG5z32O6dOns88++7B8+fLXZZoxYwYL\nFixgzpw5vPjii0ybNo2PfOQjzJkzh//5n/9h2rRpnHzyyTz88MNMmTIFgIsuuohDDz2U/fffn8mT\nJ/P5z39+3etdcMEFbL311syYMYPjjjuOE044of8vpCQ1gG22pNIyc0B97bTTTtnZ0qVLX7Pd329a\nxBvf+MbMzFyzZk0edthhee2112Zm5lVXXZX77rtvrlmzJv/4xz/m+PHj87HHHut2/w033JAf+MAH\nunyPM888M08//fR17/Pcc8/Vvl/IH/7wh5mZ+ZWvfCWPP/74zMz86Ec/mldeeWVmZu699945f/78\n12TNzHzooYdyu+2263L7wgsvzEmTJuWKFSvyxRdfzC233DJ///vf5x/+8IecMGFCPvXUU7lq1arc\nc889171nZ51/NhrcaMJ/AwmwIFugHW3kl222bbbUWTMaoz5nLdhu20PdT9b2IGy66aY8/fTT7Lff\nfgDceuutzJw5k2HDhvG2t72Nvffem/nz53e7vyc777wzF154Iaeddhr33HMPo0ePBmCDDTbgiCOO\nAOCoo47i1ltv7bfva5999mGTTTZh5MiRbLvttjzyyCPceeed7L333rzlLW9hxIgRHH744f32fpLU\nCLbZkvqTBXU/WTse75FHHmHVqlXrxuPV/nHzet3t78lee+3FzTffzBZbbMHRRx/NxRdf3OV5EUVH\nEfZuo402Wvd42LBhrFmzpk/ZJamV2GZL6k8W1P1sk0024dvf/jZnnnkmq1evZq+99uKKK67glVde\nYfny5dx8883ssssu3e4fPXo0zz//fJev/cgjj/DWt76V4447jmOPPZZFixYB8Oqrr667KeXSSy9l\nzz337DHjiBEjWL16NUCP79edXXbZhZtuuolnnnmGNWvW8OMf/3i9ni9JrcI2W1J/GN7sAIPRjjvu\nyNSpU7n88ss56qijuO2225g6dSoRwRlnnMHb3/52DjnkkC73b7rppgwfPpypU6cya9YsPvOZz6x7\n3RtvvJFvfOMbjBgxglGjRq3r7XjjG9/Ivffey0477cQmm2yy7maZ7syePZsddtiB6dOnc8kll7DH\nHnswZcoUDjjgAI4//vhev78tttiCU045hV133ZXNN9+cbbfdlk022aTcRZOkJrHNllRWDLSPgtra\n2nLBggWv2XffffexzTbbNClR840aNYqVK1c29D1XrlzJqFGjWLNmDYcccgjHHHMMhxxyyOvOG+o/\nm6EmCk9a1n+SgdOGRcTCzGxrdo5Gss1+PdtsDXWN/5uCPv9NUbTddsiH+uS0005bNxXUpEmT+Ku/\n+qtmR5IkdcM2W6qWQz4GgUb3dACceeaZDX9PSRoMbLOlwcceakmSJKmEQVNQD7Sx4EOBPxNJ3bF9\naD3+TKS+GxQF9ciRI3nqqadsDFpIZvLUU08xcuTIZkeRVEBEfC8inoiIJd0c/0hE3F3/+k1ETO3r\ne9lmtx7bbKmcQTGGety4cbS3t7N8+fJmR1EHI0eOZNy4cc2OIamYi4B/BbpefQQeAvbOzGci4gDg\nXGDXvryRbXZrss2W+m5QFNQjRoxg0qRJzY4hSQNWZt4cERN7OP6bDpu3A32uvGyzJQ02g2LIhySp\noY4Fru3uYETMjogFEbHAXmhJQ4EFtSSpsIh4N7WC+h+6Oyczz83MtsxsGzt2bOPCSVKTDIohH5Kk\n6kXEDsD5wAGZ+VSz80hSq7CHWpLUq4jYEvgJcHRmPtDsPJLUSuyhliQREZcBM4AxEdEOnAqMAMjM\nc4AvA5sC340IgDWZ2dactJLUWiyoJUlk5sxejn8c+HiD4kjSgOKQD0mSJKkEC2pJkiSpBAtqSZIk\nqYRKC+qI2D8i7o+IZRExp5tz/joilkbEvRFxaZV5JEmSpP5W2U2JETEMmAvsB7QD8yNiXmYu7XDO\nZOALwB6Z+UxEvLWqPJIkSVIVquyh3gVYlpkPZuYq4HLg4E7nHAfMzcxnADLziQrzSJIkSf2uyoJ6\nC+DRDtvt9X0dbQ1sHRG/jojbI2L/rl4oImZHxIKIWLB8+fKK4kqSJEnrr8p5qKOLfdnF+0+mtpjA\nOOCWiJiSmSte86TMc4FzAdra2jq/hiRJkvoguizXqjb4Srkqe6jbgfEdtscBj3Vxzs8yc3VmPgTc\nT63AliRJkgaEKgvq+cDkiJgUERsCRwLzOp3zU+DdABExhtoQkAcrzCRJkiT1q8oK6sxcA5wAXAfc\nB/woM++NiK9GxEH1064DnoqIpcANwMmZ+VRVmSRJkqT+VuUYajLzGuCaTvu+3OFxAp+tf0mSJEkD\njislSpIkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEkl\nWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVY\nUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQ\nS5IkSSVYUEuSJEklWFBLkgCIiO9FxBMRsaSb4xER346IZRFxd0RMb3RGSWpFFtSSpLUuAvbv4fgB\nwOT612zg3xqQSZJangW1JAmAzLwZeLqHUw4GLs6a24E3R8RmjUknSa3LglqSVNQWwKMdttvr+yRp\nSLOgliQVFV3sy9edFDE7IhZExILly5c3IJYkNZcFtSSpqHZgfIftccBjnU/KzHMzsy0z28aOHduw\ncJLULBbUkqSi5gF/U5/tYzfg2cx8vNmhJKnZhjc7gCSpNUTEZcAMYExEtAOnAiMAMvMc4Brg/cAy\n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\nYWA3YF5XNyZm5rmZ2ZaZbWPHjq0wsiS1hip7qHsdj5eZN2TmC/XN26k14JKkxpsPTI6ISRGxIXAk\nMG/twcx8NjPHZObEzJxIrc0+KDMXNCeuJLWOKgvqXsfjdXIscG2FeSRJ3cjMNcAJwHXAfcCPMvPe\niPhqRBzU3HSS1NqGV/jaPY7He82JEUcBbcDe3RyfDcwG2HLLLfsrnySpg8y8Brim074vd3PujEZk\nkqSBoMoe6t7G4wEQEfsCX6T20eHLXb2Q4/EkSZLUqqosqHscjwfrpmD6d2rF9BMVZpEkSZIqUVlB\nXXA83jeAUcCVEbE4IuZ183KSJElSS6pyDHWv4/Eyc98q31+SJEmqmislSpIkSSVYUEuSJEklWFBL\nkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuS\nJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5Ik\nSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJ\nJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEkl\nWFBLkgCIiP0j4v6IWBYRc7o4/tmIWBoRd0fELyNiQjNySlKrsaCWJBERw4C5wAHAtsDMiNi202n/\nDbRl5g7AVcAZjU0pSa2p0oK6QG/HXhGxKCLWRMRhVWaRJPVoF2BZZj6YmauAy4GDO56QmTdk5gv1\nzduBcQ3OKEktqbKCumBvx++BWcClVeWQJBWyBfBoh+32+r7uHAtc29WBiJgdEQsiYsHy5cv7MaIk\ntaYqe6iL9HY8nJl3A69WmEOS1LvoYl92eWLEUUAb8I2ujmfmuZnZlpltY8eO7ceIktSaqiyo17e3\no1v2dkhS5dqB8R22xwGPdT4pIvYFvggclJkvNyibJLW0Kgvqwr0dvbG3Q5IqNx+YHBGTImJD4Ehg\nXscTImJH4N+pFdNPNCGjJLWkKgvqQr0dkqTmy8w1wAnAdcB9wI8y896I+GpEHFQ/7RvAKODKiFgc\nEfO6eTlJGlKGV/ja63o7gD9Q6+34cIXvJ0kqITOvAa7ptO/LHR7v2/BQkjQAVNZDXaS3IyJ2joh2\n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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff8ad8dce48>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%matplotlib inline\n",
    "import matplotlib\n",
    "matplotlib.rcParams['figure.figsize'] = (12, 6) \n",
    "\n",
    "plotting(stats, \"Sequential\", \"Root splitting\")\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The parallel seems to be clearly faster at depths 3 and 4, even if the number of visited nodes is slightly higher for the parallel engine."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "2.0005785385413235"
      ]
     },
     "execution_count": 20,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "stats.oldGlobalMean[-1]/stats.newGlobalMean[-1]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We can see that the speedup at depth 4 is 2. Even though 4 threads are used, going two times faster is a good result.\n",
    "Can we do better?"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Move reordering\n",
    "\n",
    "   In the previous section we saw that adding parallelization considerably increased the performance of the engine in terms of execution time, but why stop when things are going so well? We can improve our model further by adding what we call move reordering.\n",
    "\n",
    "We know that the minimax algorithm enumerates all the possible moves from a given node. At each step, the minimax evaluates the current node and assesses it as being promising or average. It is the job of the alpha beta technique to cut off the worst nodes, preventing the minimax from visiting them, thus gaining significant amounts of time.\n",
    "\n",
    "The sooner we prune the better, as cutting off a node eliminates its entire descendance from the search tree. \n",
    "Reordering the children of a given node in a way to start exploring the most promising branches (a priori) generates more cut-offs. To reorder child nodes before exploring them, we must rely on the estimation function to evaluate those nodes. Improving the estimation function will of course give much better results, but that is the work of chess experts and is out of the scope of this notebook. The estimation we are working with is good enough, and is unchanged for all versions of the engine in this simulation.\n",
    "\n",
    "The C code to add this feature is as simple as calling the evaluation function for all children nodes before exploring them, and sorting those nodes using the qsort builtin C function.\n",
    "\n",
    "Let's test it: we'll run the simulation with our second C program as a parameter. It makes two parallel engine play against each other, one of them using the move reordering feature.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAtQAAAF+CAYAAACiQo3lAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMS4yLCBo\ndHRwOi8vbWF0cGxvdGxpYi5vcmcvNQv5yAAAIABJREFUeJzt3X2cVnWd//HXR8AwIUrEMu63H2aE\nMOiIubKAeZPmXZR3pK6USttq226tRu4vs7ZfteZWW6u/Ik0rE7yr1m012wpFd0tBMxVI11QUsR+E\nklooDH5+f1wX0zDMzcWcuW5meD19zIPrnPM913nPGebrh3N9z/lGZiJJkiSpZ3apdwBJkiSpL7Og\nliRJkgqwoJYkSZIKsKCWJEmSCrCgliRJkgqwoJYkSZIKsKCWJFVVRHwzItZGxEMVtP1SRNxf/nok\nIjbUIqMkFRE+h1qSVE0RMQN4Efh2Zk7agf0+BEzNzPdXLZwk9QKvUEuSqiozlwDPtl0XEW+KiB9F\nxL0RcWdE7NvBrnOAhTUJKUkFDKx3AEnSTmkB8FeZ+T8RcRBwOfD2rRsjYiwwHvhZnfJJUsUsqCVJ\nNRURQ4A/B26IiK2rX9Wu2anAjZm5pZbZJKknLKglSbW2C7AhM5u6aHMqcG6N8khSIY6hliTVVGY+\nDzweEScBRMmUrdsj4s3A64Cf1ymiJO0QC2pJUlVFxEJKxfGbI2J1RJwFnAacFRG/ApYDJ7TZZQ6w\nKH0MlaQ+wsfmSZIkSQV4hVqSJEkqwIJakiRJKqDPPeVjzz33zHHjxtU7hiTtsHvvvfd3mTmi3jlq\nyT5bUl9Wab/d5wrqcePGsWzZsnrHkKQdFhGr6p2h1uyzJfVllfbbDvmQJEmSCrCgliRJkgqwoJYk\nSZIK6HNjqDuyefNmVq9ezUsvvVTvKFJDGTx4MKNGjWLQoEH1jiK1ss+WOmaf3Xf1i4J69erVDB06\nlHHjxhER9Y4jNYTMZP369axevZrx48fXO47Uyj5b2p59dt/WL4Z8vPTSSwwfPtyOWWojIhg+fLhX\nAdVw7LOl7dln9239oqAG7JilDvh7oUbl301pe/5e9F39pqCutwEDBtDU1MSkSZM47rjj2LBhQ4/e\n54knnuDaa6/tlUxz587lxhtvBODss89mxYoVAHz2s59tbbNhwwYuv/zy1uU1a9Zw4okn9srxJalR\n2WdL6k1VK6gj4psRsTYiHupke0TEVyLi0Yh4ICL277Vj9/J/ldhtt924//77eeihh9hjjz247LLL\nepS9Nzvntq644gomTpwIdN05v/GNb2zt0CWpFuyzt2efLfUt1bxCfTVwVBfbjwYmlL/mAf+3illq\n6uCDD+bpp58GSjcZnH/++UyaNIn99tuP6667rsv18+fP584776SpqYkvfelL27zvM888w4wZM1qv\nqtx5550ADBkyhI9+9KPsv//+HHbYYaxbt267TLNmzWLZsmXMnz+fjRs30tTUxGmnncb8+fP5zW9+\nQ1NTE+effz5PPPEEkyZNAuDqq6/m3e9+N0cddRQTJkzgggsuaH2/K6+8kn322YdZs2ZxzjnncN55\n5/X+iZSkGrDPllRYZlbtCxgHPNTJtq8Dc9osPwzs3d17HnDAAdneihUrtlmml/+rxO67756ZmS0t\nLXniiSfmrbfempmZN954Yx5++OHZ0tKSv/3tb3P06NG5Zs2aTtcvXrw4jznmmA6Pcemll+ZnPvOZ\n1uM8//zzpe8X8pprrsnMzE996lN57rnnZmbmmWeemTfccENmZs6cOTOXLl26TdbMzMcffzzf+ta3\ndrh81VVX5fjx43PDhg25cePGHDNmTD755JP59NNP59ixY3P9+vW5adOmnD59eusx1Xja/36ofoBl\nWcU+txG/7LPts7Vj7LMbS6X9dj3HUI8EnmqzvLq8rk/aegVh+PDhPPvssxxxxBEA3HXXXcyZM4cB\nAwbw+te/npkzZ7J06dJO13flwAMP5KqrruLiiy/mwQcfZOjQoQDssssunHLKKQCcfvrp3HXXXb32\nfR122GEMGzaMwYMHM3HiRFatWsU999zDzJkz2WOPPRg0aBAnnXRSrx1PkmrBPltSb6pnQd3RQLfs\nsGHEvIhYFhHLOvporBFsHY+3atUqNm3a1Doer/SPm+11tr4rM2bMYMmSJYwcOZIzzjiDb3/72x22\n6827hF/1qle1vh4wYAAtLS09yi5JjcQ+W1JvqmdBvRoY3WZ5FLCmo4aZuSAzmzOzecSIETUJ11PD\nhg3jK1/5CpdeeimbN29mxowZXHfddWzZsoV169axZMkSpk2b1un6oUOH8sILL3T43qtWrWKvvfbi\nnHPO4ayzzuK+++4D4JVXXmm9KeXaa69l+vTpXWYcNGgQmzdvBujyeJ2ZNm0ad9xxB8899xwtLS3c\ndNNNO7S/1JuiTl/qH+yztbPr7ZuCe+vG4b6mnjMl3gycFxGLgIOA32fmM3XM02umTp3KlClTWLRo\nEaeffjo///nPmTJlChHBJZdcwhve8AZmz57d4frhw4czcOBApkyZwty5c/m7v/u71ve9/fbb+cIX\nvsCgQYMYMmRI69WO3XffneXLl3PAAQcwbNiw1ptlOjNv3jwmT57M/vvvz3e/+10OOeQQJk2axNFH\nH825557b7fc3cuRILrzwQg466CDe+MY3MnHiRIYNG1bspElSndhnSyoqqvVRUEQsBGYBewL/D/gk\nMAggM78Wpc+4/pXSk0D+CLwvM5d1977Nzc25bNm2zVauXMlb3vKWXs3flwwZMoQXX3yxpsd88cUX\nGTJkCC0tLcyePZv3v//9zJ49u6YZVJn+/vtRr2sdPek5I+LezGzu9TC9ICK+CRwLrM3MSZ20mQV8\nmVJf/rvMnNnd+9pnb88+W12p9e9HPa4YZ4960PqotN+u2hXqzJzTzfYEuv+ntRrSxRdfzE9+8hNe\neukljjzySN71rnfVO5KkYq6mdJGjw4G+EfFa4HLgqMx8MiL2qmE2FWSfLVVXPYd8qJfU+koHwKWX\nXlrzY0qqnsxcEhHjumjyXuB7mflkuf3aWuTqj+yzpf7HqcclSZXYB3hdRNweEfdGxF921rAvPJlJ\nknqTBbUkqRIDgQOAY4B3AJ+IiH06atiXnswkSb3BIR+SpEqspnQj4h+AP0TEEmAK8Eh9Y0lS/XmF\nWpJUiX8D/iIiBkbEqyk97nRlnTNJUkOwoO4lAwYMoKmpiUmTJnHcccexYcOGHr3PE088wbXXXtsr\nmebOnds6ecDZZ5/NihUrAPjsZz/b2mbDhg1cfvnlrctr1qzhxBNP7JXj76hx48bxF3/xF9us23pO\n+6rbb7+dY489dof2qefPQDuv8qNOfw68OSJWR8RZEfFXEfFXAJm5EvgR8ABwD3BFZj5Uv8TF2GcX\nZ59dYp8t6KcFdT1mRNs6je1DDz3EHnvs0TqN7Y7qzc65rSuuuIKJEycCXXfOb3zjG1s79N40d+5c\nbr/99m7bvfDCCzz11FNA6VmctbRly5a6v0dLS0vVfgZSVzJzTmbunZmDMnNUZl6ZmV/LzK+1afOF\nzJyYmZMy88u9dWz77O3ZZ3fPPluNpF8W1PV28MEH8/TTTwOQmZx//vlMmjSJ/fbbr3VGrM7Wz58/\nnzvvvJOmpia+9KUvbfO+zzzzDDNmzGi9AnDnnXcCpUkCPvrRj7L//vtz2GGH0dFd9bNmzWLZsmXM\nnz+fjRs30tTUxGmnncb8+fP5zW9+Q1NTE+effz5PPPFE69WFq6++mne/+90cddRRTJgwgQsuuKD1\n/a688kr22WcfZs2axTnnnMN5553XK+fu5JNPbj0XCxcuZM6cPz3O/KWXXuJ973sf++23H1OnTmXx\n4sUAHHTQQSxfvnyb7/Xee+/lD3/4A+9///s58MADmTp1Kv/2b/+23fFuv/12Dj30UN773vey3377\nAXDNNdcwbdo0mpqa+MAHPtDa4S5cuJD99tuPSZMm8bGPfaz1PYYMGcJFF13EQQcdxM9//nN+9KMf\nse+++zJ9+nS+973vtbbrLM/VV1/NSSedxHHHHceRRx5Z95+BtLOxz+45+2z7bJVlZp/6OuCAA7K9\nFStWbLPc2wetxO67756ZmS0tLXniiSfmrbfempmZN954Yx5++OHZ0tKSv/3tb3P06NG5Zs2aTtcv\nXrw4jznmmA6Pcemll+ZnPvOZ1uM8//zzpe8X8pprrsnMzE996lN57rnnZmbmmWeemTfccENmZs6c\nOTOXLl26TdbMzMcffzzf+ta3drh81VVX5fjx43PDhg25cePGHDNmTD755JP59NNP59ixY3P9+vW5\nadOmnD59eusxO3PmmWfm4sWLu2wzduzYfPjhh/Pggw/OzMympqZcvnx5a55LL700586dm5mZK1eu\nzNGjR+fGjRvzi1/8Yl500UWZmblmzZqcMGFCZmZ+/OMfz+985zuZmfncc8/lhAkT8sUXX9zmmIsX\nL85Xv/rV+dhjj2Vm6e/Ssccem5s2bcrMzA9+8IP5rW99K59++ukcPXp0rl27Njdv3pyHHnpofv/7\n3289/9ddd11mZm7cuDFHjRqVjzzySL7yyit50kkntf48O8tz1VVX5ciRI3P9+vVV+Rm0//3ob+rV\nGfUoKyyrY2T77Dbss+2zM+2zMzOpw399SaX9tleoe8nWKwjDhw/n2Wef5YgjjgDgrrvuYs6cOQwY\nMIDXv/71zJw5k6VLl3a6visHHnggV111FRdffDEPPvggQ4cOBWCXXXbhlFNOAeD000/nrrvu6rXv\n67DDDmPYsGEMHjyYiRMnsmrVKu655x5mzpzJHnvswaBBgzjppJM63Pe2226jqamJpqYmbr75Zs4+\n+2yampo46KCDOj3eHnvswete9zoWLVrEW97yFl796le3brvrrrs444wzANh3330ZO3YsjzzyCCef\nfDI33HADANdff31rnh//+Md8/vOfp6mpiVmzZvHSSy/x5JNPbnfMadOmMX78eAB++tOfcu+993Lg\ngQfS1NTET3/6Ux577DGWLl3KrFmzGDFiBAMHDuS0005jyZIlQGks5nve8x4Afv3rXzN+/HgmTJhA\nRHD66ae3HqerPEcccQR77LFHr/8MJHXMPnt79tn22eo5C+pesnU83qpVq9i0aVPreLzSP26219n6\nrsyYMYMlS5YwcuRIzjjjDL797Q5nCCai0lGE3XvVq17V+nrAgAG0tLRUnP0d73gH999/P/fffz/H\nH388V1xxBffffz933313l/udcsopnHvuudt8dAidn7ORI0cyfPhwHnjgAa677jpOPfXU1vY33XRT\na4Ynn3ySt7zlLdvtv/vuu29zjDPPPLN1n4cffpiLL764y+958ODBDBgwoHW5s/PfVZ62Gdor8jOQ\n1DH77O3ZZ2/LPls7woK6lw0bNoyvfOUrXHrppWzevJkZM2Zw3XXXsWXLFtatW8eSJUuYNm1ap+uH\nDh3KCy+80OF7r1q1ir322otzzjmHs846i/vuuw+AV155pfWGiGuvvZbp06d3mXHQoEFs3rwZoMvj\ndWbatGnccccdPPfcc7S0tHDTTTft0P7dmT17NhdccAHveMc7tlk/Y8YMvvvd7wLwyCOP8OSTT/Lm\nN78ZgFNPPZVLLrmE3//+963j6t7xjnfw1a9+tbUj++Uvf9ntsQ877DBuvPFG1q4tzar87LPPsmrV\nKg466CDuuOMOfve737FlyxYWLlzIzJkzt9t/33335fHHH+c3v/kNUBrDt1VP8nSm2j8DaWdhn12c\nfXb37LP7PwvqKpg6dSpTpkxh0aJFzJ49m8mTJzNlyhTe/va3c8kll/CGN7yh0/WTJ09m4MCBTJky\nZbsbXG6//XaampqYOnUqN910Ex/+8IeB0r+Uly9fzgEHHMDPfvYzLrrooi7zzZs3j8mTJ3Paaacx\nfPhwDjnkECZNmsT5559f0fc3cuRILrzwQg466CAOP/xwJk6cyLBhw3p2sjowdOhQPvaxj7Hrrrtu\ns/6v//qv2bJlC/vttx+nnHIKV199deuVgBNPPJFFixZx8sknt7b/xCc+webNm5k8eTKTJk3iE5/4\n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\nSQ3JglqSBBXMbgvsA+wTEf8VEb+IiA6f9uTstpJ2NhbUkiToZnbbsoHABGAWMAe4IiJeu91Ozm4r\naSdjQS1Jgu5nt93a5t8yc3NmPg48TKnAlqSdmgW1JAm6md227AfAoQARsSelISCP1TSlJDUgC2pJ\nUqWz294GrI+IFcBi4PzMXF+fxJLUOLqbKVGStJPobnbbzEzgI+UvSVKZV6glSZKkAiyoJUmSpAIs\nqCVJkqQCLKglSZKkAiyoJUmSpAIsqCVJkqQCLKglSZKkAiyoJUmSpAIsqCVJkqQCLKglSZKkAiyo\nJUmSpAIsqCVJkqQCLKglSZKkAiyoJUmSpAIsqCVJkqQCLKglSZKkAiyoJUmSpAIsqCVJkqQCLKgl\nSZKkAiyoJUmSpAIsqCVJkqQCLKglSZKkAiyoJUmSpAIsqCVJkqQCLKglSZKkAiyoJUmSpAIsqCVJ\nkqQCLKglSZKkAiyoJUmSpAIsqCVJAETEURHxcEQ8GhHzu2h3YkRkRDTXMp8kNSoLakkSETEAuAw4\nGpgIzImIiR20Gwr8DXB3bRNKUuOyoJYkAUwDHs3MxzJzE7AIOKGDdv8IXAK8VMtwktTILKglSQAj\ngafaLK8ur2sVEVOB0Zn5w67eKCLmRcSyiFi2bt263k8qSQ3GglqSBBAdrMvWjRG7AF8CPtrdG2Xm\ngsxszszmESNG9GJESWpMFtSSJChdkR7dZnkUsKbN8lBgEnB7RDwBvA242RsTJcmCWpJUshSYEBHj\nI2JX4FTg5q0bM/P3mblnZo7LzHHAL4DjM3NZfeJKUuOwoJYkkZktwHnAbcBK4PrMXB4Rn46I4+ub\nTpIa28B6B5AkNYbMvAW4pd26izppO6sWmSSpL/AKtSRJklSABbUkSZJUgAW1JEmSVIAFtSRJklSA\nBbUkSZJUQFUL6og4KiIejohHI2J+B9s/EhErIuKBiPhpRIytZh5JkiSpt1WtoI6IAcBlwNHARGBO\nRExs1+yXQHNmTgZuBC6pVh5JkiSpGqp5hXoa8GhmPpaZm4BFwAltG2Tm4sz8Y3nxF5SmupUkSZL6\njGoW1COBp9osry6v68xZwK0dbYiIeRGxLCKWrVu3rhcjSpIkScVUs6CODtZlhw0jTgeagS90tD0z\nF2Rmc2Y2jxgxohcjSpIkScVUc+rx1cDoNsujgDXtG0XE4cA/ADMz8+Uq5pEkSZJ6XTWvUC8FJkTE\n+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\nYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff8ad913240>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "stats = simulation(\"src/parallel_vs_parallel_with_reordering\", nGames=3)\n",
    "\n",
    "plotting(stats, \"Root splitting\", \"Root splitting + Move reordering\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Reordering the moves seems to give out worse results! But why on earth would that happen? In fact, this behavior makes sense. \n",
    "\n",
    "Reordering the moves means computing the estimation function for every child of the visited node, and then sorting them. While we do get more cut-offs as expected (a lot less nodes visited than before), we lose time in the overhead of sorting and computing the estimation at every single node visited. \n",
    "This leads us to our next attempt..!\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Beam search\n",
    "\n",
    "The beam search technique uses the move reordering to only explore the most promising nodes of the search tree; that is, after we reorder the children of a given node, we only explore a subset of those child nodes, by ignoring the least promising ones (according to the estimation function!), and thus making the search faster.\n",
    "Of course the trade-off of doing so is to risk not exploring parts of the search tree that might lead to better moves.\n",
    "More on Beam Search: \n",
    "https://en.wikipedia.org/wiki/Beam_search\n",
    "\n",
    "To implement this feature, we only need to make the slight change of iterating through n/2 child nodes instead of n in the minimax function. We chose to only consider the most promising half of the children nodes.\n",
    "\n",
    "Simulation..."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAtQAAAF+CAYAAACiQo3lAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMS4yLCBo\ndHRwOi8vbWF0cGxvdGxpYi5vcmcvNQv5yAAAIABJREFUeJzt3XuYXGWV6P/vIgQSLjpIwhkOCSQo\nyiUkIXSQiIZ4SYwiAUQG4qjcJB6FgXM8owM6P8Kg84wDXhlRjGMEVMKMOPjEMU4AJYAKSIOIkHDJ\nQBhaOKRJhJBJQuiwfn9Udaw0falkd1V1d30/PPX0vrx779W76ZXVb72138hMJEmSJO2YnRodgCRJ\nkjSYWVBLkiRJBVhQS5IkSQVYUEuSJEkFWFBLkiRJBVhQS5IkSQVYUEuSaioiFkbE6oh4sIq2X4mI\n+8uvRyPi+XrEKElFhM+hliTVUkRMB9YD12bmhO047q+AIzLzrJoFJ0n9wB5qSVJNZebtwNrKbRHx\n+oj4j4i4NyLuiIiDuzl0LrCoLkFKUgE7NzoASVJTWgD8r8x8LCLeDHwDeEfnzog4ABgP/KJB8UlS\n1SyoJUl1FRF7AG8BfhgRnZt37dLsNOCGzNxSz9gkaUdYUEuS6m0n4PnMnNxLm9OAc+sUjyQV4hhq\nSVJdZeY64ImIOAUgSiZ17o+INwF7AXc2KERJ2i4W1JKkmoqIRZSK4zdFRFtEnA38JXB2RPwOeAg4\noeKQucD16WOoJA0SPjZPkiRJKsAeakmSJKkAC2pJkiSpgEH3lI9Ro0bluHHjGh2GJG23e++997nM\nHN3oOOrJnC1pMKs2bw+6gnrcuHG0trY2OgxJ2m4R8WSjY6g3c7akwazavO2QD0mSJKkAC2pJkiSp\nAAtqSZIkqYBBN4a6Oy+//DJtbW1s2rSp0aGon4wYMYIxY8YwfPjwRociqZ+Zs4cm87aa2ZAoqNva\n2thzzz0ZN24cEdHocFRQZrJmzRra2toYP358o8OR1M/M2UOPeVvNbkgM+di0aRN77723iXmIiAj2\n3ntve6+kIcqcPfSYt9XshkRBDZiYhxh/ntLQ5u/40OPPVM1syBTUjRYRfPjDH9663tHRwejRo3nf\n+97XwKiKufrqqznvvPO265jW1lbOP//8GkUkSf3DnF1izpb6x5AYQ91V0L9/JSfZZ5vdd9+dBx98\nkI0bNzJy5Ehuvvlm9ttvv36NozcdHR3svPOO/zgzk8xkp512/G+sjo4OWlpaaGlp2eFzSKqtiFgI\nvA9YnZkTutn/KeAvy6s7A4cAozNzbUSsAl4EtgAdmdkvv+zm7O1nzpYGFnuo+9F73vMefvrTnwKw\naNEi5s6du3Xf2rVrOfHEE5k4cSJHH300DzzwAK+88grjxo3j+eef39ruDW94A88++yzt7e2cfPLJ\nTJ06lalTp/KrX/3qVde7+uqrOeWUUzj++OOZNWsWAJdffjlTp05l4sSJzJ8/f2vbL3/5y0yYMIEJ\nEybw1a9+FYBVq1ZxyCGH8IlPfIIpU6bw1FNP8d3vfpc3vvGNHHvssdtcs6d4LrnkEubNm8esWbP4\nyEc+wrJly7b28FxyySWcddZZzJgxgwMPPJArrrhi6/k+97nPcfDBBzNz5kzmzp3LF7/4xcL3X1JV\nrgZm97QzMy/PzMmZORm4CLgtM9dWNHl7ef+gr8LM2eZsqd90/pU7WF5HHnlkdrV8+fJt1unn/6qx\n++675+9+97s8+eSTc+PGjTlp0qS89dZb87jjjsvMzPPOOy8vueSSzMz8+c9/npMmTcrMzPPPPz8X\nLlyYmZl33XVXvvOd78zMzLlz5+Ydd9yRmZlPPvlkHnzwwa+65ne/+93cb7/9cs2aNZmZuXTp0jzn\nnHPylVdeyS1btuRxxx2Xt912W7a2tuaECRNy/fr1+eKLL+ahhx6a9913Xz7xxBMZEXnnnXdmZubT\nTz+dY8eOzdWrV+dLL72Ub3nLW/Lcc8/tNZ758+fnlClTcsOGDZmZ23zP8+fPz2nTpuWmTZuyvb09\nX/e61+XmzZvznnvuyUmTJuWGDRty3bp1+YY3vCEvv/zyPn+u0mAHtOYAyKPAOODBKtpdB5xTsb4K\nGLU91zJn/8lQz9nd/Wylwa7avD0kh3w0ysSJE1m1ahWLFi3ive997zb7fvnLX/KjH/0IgHe84x2s\nWbOGF154gVNPPZVLL72UM888k+uvv55TTz0VgFtuuYXly5dvPX7dunW8+OKL7Lnnntucd+bMmbzu\nda8D4KabbuKmm27iiCOOAGD9+vU89thjrF+/npNOOondd98dgPe///3ccccdzJkzhwMOOICjjz4a\ngLvvvpsZM2YwevRoAE499VQeffTRXuMBmDNnDiNHjuz2nhx33HHsuuuu7Lrrruyzzz48++yz/PKX\n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\nwP8PX2ETW58UCK4AAAAASUVORK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff8ad53d978>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "stats = simulation(\"src/move_reorder_vs_beam_search\", nGames=3)\n",
    "plotting(stats, \"Move reordering\", \"Beam search\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As expected, the execution time is reduced due to exploring less nodes, at the risk of losing some good moves due to a bad estimation. So for this technique to give good results, the estimation function must be goood (notice the extra ‘o’).\n",
    "There is a huge difference in the number of visited nodes! It makes sense because we only considered half the child nodes at each minimax call, we probably would want to consider a little more than half of them if we were at a chess engine competition though.\n",
    "\n",
    "Let's now test it against the initial sequential engine:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\nxEknncSECRM46qijePrppwf+JEpSg9hnSyotMwfVz7Rp07KrFStWbLU90F9axA477JCTJ0/O/fff\nP1/4whfm4sWLMzPz2muvzZNOOimfe+653LRpU77hDW/IG2+8MTMzH3/88czMXLduXU6YMCEfe+yx\nWn7IhQsXZmbmm970ppw1a1auX78+ly1blpMnT37ed3/pS1/Kc845JzMzN27cmE8++WSuXr06X/nK\nV+batWszM/OLX/xifu5zn9vqezMz3/Wud+WCBQsyM/OII47ID33oQ1uOvf3tb8/zzz9/y+euWbMm\nf//732dbW1v+5je/yczM4447Lr/zne88L1PXPxNtH2jC/wYTaqvENr0fbeSPffbg6LMz7be3V/bb\nvSvab3t/aIB0vn1466238p73vIfly5dz3XXXcd1113HwwQcDsHbtWu6//34OP/xwvva1r/HjH/8Y\ngIceeoj777+fPffckx133JHZs2cDMGnSJHbaaSeGDx/OpEmTePDBB5/33dOnT+f9738/GzZs4E1v\nehNTpkzhxhtvZMWKFRx2WG0hyvXr1zNjxgwAbrjhBs4991zWrVvHn/70JyZMmMAb3/hGAN7xjnds\n+dxf/vKXXH755UBtvOGLXvQi/vznPzN+/HimTJkCwLRp07rNJEmtzD5b0kCyoK7AjBkzeOyxx1i9\nejWZyemnn84HPvCBrdosWrSI66+/nltvvZVdd92VmTNn8swzzwAwfPhwImqjCnfYYQd22mmnLa83\nbtz4vO87/PDDuemmm/jFL37Bu9/9bk499VT22GMPZs2axRVXXLFV22eeeYYPf/jDLF68mDFjxnDW\nWWdt+V6AF7zgBX3+/jbngVqn7e1DSYOZfbakshxDXYF77rmHTZs2seeee/La176Wyy67bMtYuD/+\n8Y88+uijPPHEE+yxxx7suuuu3HPPPdx22239/r4//OEPvPjFL+akk07ixBNPZOnSpRx66KH8+te/\nZtWqVQCsW7eO++67b0tHPHLkSNauXcvVV1/d4+e+5jWv4aKLLgJqY/CefPLJfmeUpFZlny2pLK9Q\nD5Cnn356yy21zOTb3/42bW1tHHXUUaxcuXLLrbsRI0bw3e9+l9mzZ3PxxRdz0EEHsf/++3PooYf2\n+7sXLVrEeeedx/DhwxkxYgSXX345o0aNYv78+cyZM4dnn30WgHPOOYf99tuPk046iUmTJjFu3Dim\n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\nBwARcSTwGeCYzHy2uw/y9qEkVSszNwInA9cCK4GrMvPuiDg7Io5pbjpJam1VXqHu9WoHbHnA5d+A\n2Zn5aIVZJEl9yMyFwMIu+87ooe3MRmSSpMGgsivUBa92nAeMAH4QEcsiYkFVeSRJkqQqVHmFus+r\nHZl5ZJXfL0mSJFXNlRIlSZKkEiyoJUmSpBIsqCVJkqQSLKglSZKkEiyoJUmSpBIsqCVJkqQSLKgl\nSZKkEiyoJUmSpBIsqCVJkqQSLKglSZKkEiyoJUmSpBIsqCVJkqQSLKglSZKkEiyoJUmSpBIsqCVJ\nkqQSLKglSZKkEiyoJUmSpBIsqCVJkqQSLKglSZKkEiyoJUmSpBIsqCVJkqQSLKglSZKkEiyoJUmS\npBIsqCVJkqQSLKglSZKkEiyoJUmSpBIsqCVJkqQSLKglSZKkEiyoJUmSpBIsqCVJAETE7Ii4NyJW\nRcRp3Rz/RESsiIi7IuK/ImKfZuSUpFZTaUFdoHM+PCKWRsTGiHhblVkkST2LiDbgQuB1wIHAnIg4\nsEuz3wDtmXkQcDVwbmNTSlJrqqygLtg5/zdwAvD9qnJIkgo5BFiVmQ9k5nrgSuDYzg0y84bMXFff\nvA0Y3eCMktSSqrxCXaRzfjAz7wKeqzCHJKlvewMPddruqO/ryYnANZUmkqRBYliFn91d5/yyCr9P\nktR/0c2+7LZhxLuAduCIHo7PBeYCjB07dqDySVLLqvIKdeHOuc8PipgbEYsjYvHq1atLxpIkdaMD\nGNNpezTwcNdGEXEk8BngmMx8trsPysx5mdmeme2jRo2qJKwktZIqC+pCnXMRds6SVLk7gX0jYnxE\n7AgcDyzo3CAiDgb+jVox/WgTMkpSS6qyoO6zc5YktYbM3AicDFwLrASuysy7I+LsiDim3uw8YATw\ng4hYFhH26ZJEhWOoM3NjRGzunNuAyzZ3zsDizFwQEdOBHwN7AG+MiM9l5oSqMkmSepaZC4GFXfad\n0en1kQ0PJUmDQJUPJRbpnO/EaZckSZI0iLlSoiRJklSCBbUkSZJUggW1JEmSVIIFtSRJklSCBbUk\nSZJUggW1JEmSVIIFtSRJklSCBbUkSZJUQqULu0iSJEmdRRO+Myv+fK9QS5IkSSVYUEuSJEklWFBL\nkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSVYUEuSJEklWFBLkiRJJVhQS5IkSSW49Li0\n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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff8ad56aba8>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "stats = simulation(\"src/sequential_vs_beam_search\", nGames=3)\n",
    "plotting(stats, \"Sequential\", \"Beam search\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "3.4676852224462276"
      ]
     },
     "execution_count": 24,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "stats.oldGlobalMean[-1]/stats.newGlobalMean[-1]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The speedup this time is 3.4!! That is impressive, but also expected. We're exploring a lot less nodes, first because we generate more cut-offs thanks to the reordering, and second because we consider less possibilities using beam search. The latter is risky, but gives good results when the estimation function has a low probability of giving inaccurate evaluations."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Iterative deepening\n",
    "\n",
    "The iterative deepening is a variation of the minimax fixed-depth \"d\" search algorithm. It does the following:\n",
    "Explore at all depths from 1 to \"d\", and after each exploration, reorder the child nodes according to the value returned by that exploration.\n",
    "Of course this means exploring all the nodes between depth 1 and d-1 many times. This may seem redondant and time wasting, but the overhead of expanding the same nodes many times is small in comparison to growth of the exponential search tree. \n",
    "\n",
    "At each depth explored, we get a better estimation of the child nodes, and thus a better reordering that leads to a better exploring of the tree, which generates more pruning and significantly decreases the search tree size.\n",
    "\n",
    "This technique is often preferred over other search methods for large search trees where the depth is not known, as it is for the chess search tree.\n",
    "\n",
    "Implementing the iterative deepening technique is fairly easy, here is a pseudocode that does it:\n",
    "\n",
    "for depth in range(d): <br>\n",
    "----for node in nodes: <br>\n",
    "--------node.value = minimax_alpha_beta(node, mode (MIN or MAX), alpha and beta bounds)\n",
    "----sort nodes by value\n",
    "        \n",
    "That's it! Let's give it a try"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n1Vp7dT75yU+ybNkyAL72ta/VJLZml19+OU899VSbbdXKwoULOeKII2p6zO6YN28eF154Yb3DkFQD\n9tv221KtDKhEO2r8qkbzVL733nsvQ4YM4ZJLLqk63o0bN1Zdt7t++MMfMmbMGKB7HXZHMbbusFu2\n1d8cddRRnHXWWfUOQ+p37Ldfz367Nuy31RMGVKJdb+95z3s2TbN7zDHHMGnSJMaOHcucOXM21dl2\n220599xz2W+//Vi0aBHnn38+++67L+PGjWPWrFl0NsHQLbfcwv7778/EiROZPn06a9as6bB+8xWT\ns846i3Xr1jFhwgROPPFEAP7jP/6DyZMnM2HCBD796U9v6pyrifHaa6+lsbGRE088kQkTJrBu3bpN\nbV188cWceeaZm2K4/PLL+Zu/+ZsO22zpl7/8JXvvvTcHHnggP/3pTzeV//nPf+YTn/gE++67L+96\n17v4+c9/DlT+UfnCF77Avvvuy/jx4/n+978PVK6qvPe97+XDH/4wY8aM4TOf+Qyvvvpqh+dx5MiR\nnHfeeUycOJF99tmHBx54YNNnOO2004DKVau//du/5d3vfjd77rnnpitYr776Kp/73OcYO3YsRxxx\nBIcffnin0zNLqi/7bftt+21tlszsF69JkyZla8uWLXvNeq0brcYb3vCGzMxcv359HnXUUfm9730v\nMzNXrVqVmZlr167NsWPH5rPPPluJEfKqq67atH9zvczMk046KefNm5eZmTNmzMhrrrkmMzPf9773\n5ZIlS3LlypX5nve8J9esWZOZmRdeeGF++ctffk2d1lqWN8eaWTl3RxxxRL7yyiuZmfnZz342586d\n26UYW7fZvL5ixYp861vfuql82rRp+d///d8dttls3bp1OWLEiHzooYfy1VdfzenTp+eHPvShzMw8\n++yz88c//nFmZj733HM5evToXLNmTX7/+9/Pr3zlK5mZ+dJLL+WkSZPy0UcfzQULFuRWW22Vjzzy\nSG7YsCE/+MEP5jXXXNPhedxjjz1y9uzZmZl50UUX5cyZMzMz87LLLstTTz1109/NRz/60dy4cWPe\nd999mz7rNddck4cddlhu3Lgxn3766dxhhx02/R221vpntz+gDn/6EqAxe0Ff2pMv+2377f7Sb9tn\n167X7ulXt89PlX22M0OWrPlqA1SujMycOROA2bNnc/311wPw5JNP8vDDDzNs2DAGDRrEscceu2n/\nBQsW8PWvf521a9eyevVqxo4dy5FHHtlmW4sXL2bZsmUccMABALzyyivsv//+3Yr7tttuY+nSpey7\n776bPsfOO+8MsFkxAgwfPpw999yTxYsXM3r0aB588EEOOOAALrroonbbbPbAAw8watQoRo8eDcBJ\nJ5206crSLbfcwrx58/jGN74BwEsvvcQTTzzBLbfcwu9///tNVyGef/55Hn74YYYMGcLkyZPZc889\nATjhhBO4/fbbGTp0aIfn8SMf+QgAkyZNes2VmZaOOeYYtthiC8aMGcMzzzwDwO2338706dPZYost\neMtb3sL73//+jv8SJNWF/fbr2W/bb6t7TLRL1jzWr6WFCxdy6623smjRIrbZZhumTp3KSy+9BMDQ\noUMZNGgQUOlwPve5z9HY2Mhuu+3Gl770pU312pKZHHzwwVx55ZWbHXdmMmPGDP75n//5dds2J8Zm\nxx13HFdffTV77703H/7wh4mIDttsKaLtkZaZyXXXXcdee+31uvLvfOc7HHrooa8pX7hw4euO1RxH\nR+dxq622Air/cG3YsKHDOs3tt3yX1LvZb7fNflvqOsdo18Hzzz/PjjvuyDbbbMMDDzzA4sWL26zX\n3PHttNNOrFmzptNxYVOmTOGOO+7YNJ5w7dq1PPTQQ1XHNXjwYNavXw/AQQcdxLXXXsuKFSsAWL16\nNY8//niXYtxuu+148cUX22zrIx/5CD/72c+48sorOe6446puc++99+axxx7jkUceAXhNp3rooYfy\nne98Z1PH+Lvf/W5T+cUXX7zpsz300EP8+c9/BuCuu+7iscce49VXX+Wqq67iwAMP3Ozz2J4DDzyQ\n6667jldffZVnnnmGhQsXbvYxJfUM+237bfttdYeJdh1MmzaNDRs2MH78eM455xymTJnSZr0ddtiB\nT33qU+yzzz4cc8wxm76aa8/w4cO5/PLLOeGEExg/fjxTpkzZdNNHNWbNmsX48eM58cQTGTNmDBdc\ncAGHHHII48eP5+CDD+bpp5/uUownn3wyn/nMZzbdVNPSjjvuyJgxY3j88ceZPHkyQFVtDh06lDlz\n5vChD32IAw88kD322GPTtnPOOYf169czfvx4xo0bxznnnANUHk81ZswYJk6cyLhx4/j0pz+96YrG\n/vvvz1lnncW4ceMYNWoUH/7whzf7PLbn2GOPZcSIEZti2G+//XjjG9+42ceVVD77bftt+211R/SX\n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\n/yc+8WLOyU+FAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7ff8ad481a20>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "stats = simulation(\"src/parallel_vs_parallel_iterative_deeepening\", nGames=1)\n",
    "plotting(stats, \"Parallel\", \"Parallel iterative deepening\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The results are quite impressive! Although the execution time is clearly better, I am mainly referring to the number of explored nodes.\n",
    "It looks like the iterative deepening explored slightly less nodes than the regular minimax search. \n",
    "But recall that the iterative deepening method explores the same nodes at many depths, so there is a lot of redundancy, and our implementation increments the number of explored nodes even if the node being explored has been seen already at a different depth! \n",
    "\n",
    "So even if many nodes are explored many times, the total number of explored nodes (with repetitions) is less than the previous version. \n",
    "\n",
    "This gives an idea about the HUGE reduction of the search tree size by using iterative deepening. This is what made it run faster, because otherwise it would be a lot slower that the original one, since we explore the nodes many times, and each time, re-do many of the computation that has been done already.\n",
    "\n",
    "Note that this is a very naïve implementation of the iterative deepening method. We did not implement any transposition tables (which are basically hash tables that operates like cache memory). \n",
    "\n",
    "With the addition of transposition tables to the iterative deepening method, all the calculations done at each node (finding all the possible moves, estimating those moves,..) could be cached, and when that node is revisited for the next exploration, those cached informations are directly retrieved.\n",
    "\n",
    "This would save a lot of computation and would further reduce the execution time of the engine.\n",
    "\n",
    "## Final notes\n",
    "\n",
    "We'd like to finish this notebook by saying that this work was done mainly for learning and for fun, and because parallelizing sounded cool! Otherwise, this engine is far from being good for competition. For that it would need a complete rebuid, and an addition to a whole lot of other chess-specific techniques.\n",
    "\n",
    "Building a competitive chess engine requires a lot more work. For some, it has been their entire masters thesis to implement a decent parallel chess engine (you may find a couple theses about that in the references).\n",
    "\n",
    "Nevertheless, the engine is quite good at playing, you can download the code and/or this notebook and play around with it, by watching games between different versions at different depths. \n",
    "\n",
    "And with some (not so hard) additional code, you can make it play against you and see if you can beat it!\n",
    "\n",
    "Contact us if you'd like to ask or say anything about this work.\n",
    "\n",
    "### Authors\n",
    "\n",
    "HENNI Mohammed  & GACI Yacine\n",
    "\n",
    "https://github.com/dz-pyrate/\n",
    "\n",
    "## References \n",
    "\n",
    "* https://fr.slideshare.net/JamesSwafford2/jfsmasters1\n",
    "* https://www.duo.uio.no/bitstream/handle/10852/53769/master.pdf?sequence=1\n",
    "* https://pdfs.semanticscholar.org/8e1c/9f70aa4849475199e26ccd3e21c662e2d801.pdf\n",
    "* https://chessprogramming.wikispaces.com/Iterative+Deepening\n",
    "* https://chessprogramming.wikispaces.com/Minimax"
   ]
  }
 ],
 "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.6.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}