diff --git a/search.ipynb b/search.ipynb index 718161391..5366cb3bf 100644 --- a/search.ipynb +++ b/search.ipynb @@ -13,7 +13,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 1, "metadata": { "collapsed": true, "scrolled": true @@ -21,7 +21,7 @@ "outputs": [], "source": [ "from search import *\n", - "from notebook import psource, show_map, final_path_colors, display_visual\n", + "from notebook import psource, show_map, final_path_colors, display_visual, plot_NQueens\n", "\n", "# Needed to hide warnings in the matplotlib sections\n", "import warnings\n", @@ -85,7 +85,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 2, "metadata": { "collapsed": true }, @@ -113,9 +113,159 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 3, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
class Problem(object):\n",
+       "\n",
+       "    """The abstract class for a formal problem. You should subclass\n",
+       "    this and implement the methods actions and result, and possibly\n",
+       "    __init__, goal_test, and path_cost. Then you will create instances\n",
+       "    of your subclass and solve them with the various search functions."""\n",
+       "\n",
+       "    def __init__(self, initial, goal=None):\n",
+       "        """The constructor specifies the initial state, and possibly a goal\n",
+       "        state, if there is a unique goal. Your subclass's constructor can add\n",
+       "        other arguments."""\n",
+       "        self.initial = initial\n",
+       "        self.goal = goal\n",
+       "\n",
+       "    def actions(self, state):\n",
+       "        """Return the actions that can be executed in the given\n",
+       "        state. The result would typically be a list, but if there are\n",
+       "        many actions, consider yielding them one at a time in an\n",
+       "        iterator, rather than building them all at once."""\n",
+       "        raise NotImplementedError\n",
+       "\n",
+       "    def result(self, state, action):\n",
+       "        """Return the state that results from executing the given\n",
+       "        action in the given state. The action must be one of\n",
+       "        self.actions(state)."""\n",
+       "        raise NotImplementedError\n",
+       "\n",
+       "    def goal_test(self, state):\n",
+       "        """Return True if the state is a goal. The default method compares the\n",
+       "        state to self.goal or checks for state in self.goal if it is a\n",
+       "        list, as specified in the constructor. Override this method if\n",
+       "        checking against a single self.goal is not enough."""\n",
+       "        if isinstance(self.goal, list):\n",
+       "            return is_in(state, self.goal)\n",
+       "        else:\n",
+       "            return state == self.goal\n",
+       "\n",
+       "    def path_cost(self, c, state1, action, state2):\n",
+       "        """Return the cost of a solution path that arrives at state2 from\n",
+       "        state1 via action, assuming cost c to get up to state1. If the problem\n",
+       "        is such that the path doesn't matter, this function will only look at\n",
+       "        state2.  If the path does matter, it will consider c and maybe state1\n",
+       "        and action. The default method costs 1 for every step in the path."""\n",
+       "        return c + 1\n",
+       "\n",
+       "    def value(self, state):\n",
+       "        """For optimization problems, each state has a value.  Hill-climbing\n",
+       "        and related algorithms try to maximize this value."""\n",
+       "        raise NotImplementedError\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(Problem)" ] @@ -155,9 +305,171 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 4, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
class Node:\n",
+       "\n",
+       "    """A node in a search tree. Contains a pointer to the parent (the node\n",
+       "    that this is a successor of) and to the actual state for this node. Note\n",
+       "    that if a state is arrived at by two paths, then there are two nodes with\n",
+       "    the same state.  Also includes the action that got us to this state, and\n",
+       "    the total path_cost (also known as g) to reach the node.  Other functions\n",
+       "    may add an f and h value; see best_first_graph_search and astar_search for\n",
+       "    an explanation of how the f and h values are handled. You will not need to\n",
+       "    subclass this class."""\n",
+       "\n",
+       "    def __init__(self, state, parent=None, action=None, path_cost=0):\n",
+       "        """Create a search tree Node, derived from a parent by an action."""\n",
+       "        self.state = state\n",
+       "        self.parent = parent\n",
+       "        self.action = action\n",
+       "        self.path_cost = path_cost\n",
+       "        self.depth = 0\n",
+       "        if parent:\n",
+       "            self.depth = parent.depth + 1\n",
+       "\n",
+       "    def __repr__(self):\n",
+       "        return "<Node {}>".format(self.state)\n",
+       "\n",
+       "    def __lt__(self, node):\n",
+       "        return self.state < node.state\n",
+       "\n",
+       "    def expand(self, problem):\n",
+       "        """List the nodes reachable in one step from this node."""\n",
+       "        return [self.child_node(problem, action)\n",
+       "                for action in problem.actions(self.state)]\n",
+       "\n",
+       "    def child_node(self, problem, action):\n",
+       "        """[Figure 3.10]"""\n",
+       "        next_node = problem.result(self.state, action)\n",
+       "        return Node(next_node, self, action,\n",
+       "                    problem.path_cost(self.path_cost, self.state,\n",
+       "                                      action, next_node))\n",
+       "\n",
+       "    def solution(self):\n",
+       "        """Return the sequence of actions to go from the root to this node."""\n",
+       "        return [node.action for node in self.path()[1:]]\n",
+       "\n",
+       "    def path(self):\n",
+       "        """Return a list of nodes forming the path from the root to this node."""\n",
+       "        node, path_back = self, []\n",
+       "        while node:\n",
+       "            path_back.append(node)\n",
+       "            node = node.parent\n",
+       "        return list(reversed(path_back))\n",
+       "\n",
+       "    # We want for a queue of nodes in breadth_first_search or\n",
+       "    # astar_search to have no duplicated states, so we treat nodes\n",
+       "    # with the same state as equal. [Problem: this may not be what you\n",
+       "    # want in other contexts.]\n",
+       "\n",
+       "    def __eq__(self, other):\n",
+       "        return isinstance(other, Node) and self.state == other.state\n",
+       "\n",
+       "    def __hash__(self):\n",
+       "        return hash(self.state)\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(Node)" ] @@ -200,9 +512,148 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 5, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
class GraphProblem(Problem):\n",
+       "\n",
+       "    """The problem of searching a graph from one node to another."""\n",
+       "\n",
+       "    def __init__(self, initial, goal, graph):\n",
+       "        Problem.__init__(self, initial, goal)\n",
+       "        self.graph = graph\n",
+       "\n",
+       "    def actions(self, A):\n",
+       "        """The actions at a graph node are just its neighbors."""\n",
+       "        return list(self.graph.get(A).keys())\n",
+       "\n",
+       "    def result(self, state, action):\n",
+       "        """The result of going to a neighbor is just that neighbor."""\n",
+       "        return action\n",
+       "\n",
+       "    def path_cost(self, cost_so_far, A, action, B):\n",
+       "        return cost_so_far + (self.graph.get(A, B) or infinity)\n",
+       "\n",
+       "    def find_min_edge(self):\n",
+       "        """Find minimum value of edges."""\n",
+       "        m = infinity\n",
+       "        for d in self.graph.graph_dict.values():\n",
+       "            local_min = min(d.values())\n",
+       "            m = min(m, local_min)\n",
+       "\n",
+       "        return m\n",
+       "\n",
+       "    def h(self, node):\n",
+       "        """h function is straight-line distance from a node's state to goal."""\n",
+       "        locs = getattr(self.graph, 'locations', None)\n",
+       "        if locs:\n",
+       "            if type(node) is str:\n",
+       "                return int(distance(locs[node], locs[self.goal]))\n",
+       "\n",
+       "            return int(distance(locs[node.state], locs[self.goal]))\n",
+       "        else:\n",
+       "            return infinity\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(GraphProblem)" ] @@ -216,7 +667,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 6, "metadata": { "collapsed": true }, @@ -265,7 +716,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 7, "metadata": { "collapsed": true }, @@ -292,9 +743,17 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 8, "metadata": {}, - "outputs": [], + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'Arad': (91, 492), 'Bucharest': (400, 327), 'Craiova': (253, 288), 'Drobeta': (165, 299), 'Eforie': (562, 293), 'Fagaras': (305, 449), 'Giurgiu': (375, 270), 'Hirsova': (534, 350), 'Iasi': (473, 506), 'Lugoj': (165, 379), 'Mehadia': (168, 339), 'Neamt': (406, 537), 'Oradea': (131, 571), 'Pitesti': (320, 368), 'Rimnicu': (233, 410), 'Sibiu': (207, 457), 'Timisoara': (94, 410), 'Urziceni': (456, 350), 'Vaslui': (509, 444), 'Zerind': (108, 531)}\n" + ] + } + ], "source": [ "romania_locations = romania_map.locations\n", "print(romania_locations)" @@ -309,7 +768,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 9, "metadata": { "collapsed": true }, @@ -345,11 +804,22 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 10, "metadata": { "scrolled": true }, - "outputs": [], + "outputs": [ + { + "data": { + "image/png": "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\nQ9kJIM+rXr26evTooddff93aUQAAAB5rHh4emjZtmr777jv9/fffqlq1qsLDw3X16lVrRwNyhWEY\nOn36tA4cOKA9e/bowIEDOn36tAzDsHY0ANmEshPAYyEiIkJbtmzRoUOHrB0FAADYsNDQUJlMJk2a\nNMli++7du2UymXTx4kUrJUsXExMjV1fXRz5OyZIl9dZbb+nQoUM6deqUKlWqpDfffFM3btzIhpRA\n3pOamqpDhw5p7ty5WrFihWJjY7V7927FxsZqxYoVmjt3rg4dOqTU1FRrRwXwiCg7ATwWihQpoqio\nKA0ePFhpaWnWjgMAAGxYwYIFNX369HyxxLtcuXKKiYnR7t279eWXX6pSpUr6z3/+o6SkJGtHA7JN\nUlKSli9fru3bt+vKlStKTk42l5qpqalKTk7WlStXtH37di1fvjxX/vuPiYmRyWTK8uHu7p4j5wwN\nDVXZsmVz5NgPy2QyKSIiwtoxYGMoO2FT/vrrL6v/tB05p1evXpKk5cuXWzkJAACwZc2aNVPZsmU1\nceLEO4754Ycf1LZtW7m5ucnLy0vdu3fXH3/8YX794MGDatWqlTw9PVW4cGE1btxYcXFxFscwmUxa\nsGCBOnbsKGdnZ1WuXFm7du3SmTNnFBgYKBcXF9WuXVtHjhyRlD679KWXXlJiYqK5FMmukqBatWpa\nt26dNm3apI8++khVq1bV8uXLmeWGx15qaqpWrVqls2fPKjk5+a5jk5OTdfbsWa1atSrX/ttfu3at\n4uLiLB6xsbG5cm7AVlF2wqZERETo3XfftXYM5BA7OzvNmzdPr7/+OteVAgAAOcbOzk5Tp07V22+/\nrZMnT2Z6/dy5c3rmmWdUo0YNffXVV4qNjdX169fVoUMH8wqUhIQE9ezZU/v27dNXX32l2rVrq02b\nNpl+MD9p0iR169ZNR48elb+/v7p3767evXtr4MCB+vrrr1WyZEmFhoZKkp566ilFR0fL2dlZ586d\n07lz5zRixIhsfe/+/v7atm2bYmJitGjRItWsWVPr16/neoZ4bH399dc6d+7cfZeXqampOnfunL7+\n+uscTpaudu3aatiwocXD398/V879KG7dumXtCMAdUXbCZty6dUurV69W586drR0FOahevXpq06aN\nIiMjrR0FAADYsDZt2ujpp5/W2LFjM722YMEC1apVS9OmTZOvr6/8/Py0fPlyHTx40Hx98WeffVY9\n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\n3XWStZ08efJfh1T/k4SEBBYsWMClS5f+scPT1taWIkWK0L59+2z1N0XJkiWpVasW8+fPNzqKZCPP\n+3uVlWmMgFiE0NBQXnvttec+j5+fHxEREc8fSNLda6+9hoeHB5999pnRUURERETkT4oXL/7YguXF\nixc5ceIEw4cP56OPPg0oDVEAACAASURBVGLnzp28++67TJs2jbt376rQKenCzs6OTp060ahRI/Lm\nzYutrW3qEG1ra2tsbW3Jly8fjRo1olOnTtmq0Ckij9IwdskStm7dSr169R77et26ddmyZcszn//T\nTz99ZGJ3yVlMJhNTpkyhRo0atG/fPnXFPxERERHJuooUKULlypXJmzdv6jZ3d3d+/vlnDh8+TPXq\n1UlKSmLu3Ll069bNwKSS3VlbW1O5cmUqVarEhQsXiIuLIyEhATs7O4oVK/bY7mMRyX7U2SlZQo0a\nNbh06dIjjxkzZmAymejVq9cznTcpKQmz2UyePHnSfICSnMnLy4s333yTwYMHGx1FRERERP7F3r17\n6dChAydPniQ4OJg+ffqwc+dOpk+fjoeHB/nz5wfg6NGjvPXWW5QoUULDdOW5mUwmihcvTrVq1ahT\npw7VqlX7x+7j7ODs2bP63RD5ExU7JUuws7OjcOHCaR43b95k4MCBDBs2LHXS5ri4OEJCQsiXLx/5\n8uWjWbNm/PTTT6nniYiIwM/Pjzlz5lC6dGns7e2Jj49/ZBh73bp16dWrF8OGDcPV1ZWCBQsSHh5O\nSkpK6j5XrlyhRYsWODo6UqJECSIjIzPvDZFnNnz4cDZv3sz3339vdBQREREReYx79+5Rv359ihYt\nypQpU1ixYgXr1q0jPDycBg0a8MEHH1C2bFngjwVmEhMTCQ8Pp3///nh6erJ27VqD70BERLIqFTsl\nS7p16xYtW7bk5ZdfZuzYsQDcvXuXevXq4eDgwLZt29i9ezdFihThlVde4e7du6nHnjlzhoULF7Jk\nyRIOHz6Mg4PD315jwYIF2NjYsGvXLqZNm8aUKVOIjo5OfT00NJTTp0+zceNGli9fzrx58zh79myG\n3rc8P2dnZz766CN69+79RKstioiIiEjmW7RoEX5+fgwbNozatWsTGBjI9OnTuXjxIm+99RY1a9YE\nwGw2pz7CwsKIi4vjtddeo2nTpvTv3z/N3wEiIiKgYqdkQSkpKbRr1w5ra2vmz5+fOpwgKioKs9nM\n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\nf+WZjv01/ld2X9idzonSSk5OJikpKfWRnJz8r8fExsYyYMAAwsPDWbp0KYUKFeKNN97gzJkzqfvE\nxcVRokQJPv30U9atW8d7773HunXreO211546Y5UqVQBo06YN69evJz4+/rH7dujQgYkTJ9KlSxdW\nr15Np06deP/99+nWrdtTX/ev3nrrLUJDQwHYvXs3u3fv5vvvv3/s/p9//jmhoaG8+OKLLF++nPHj\nx7NmzRrq1q3L3btpi99btmzhs88+Y/z48URFRZGQkMBrr73G77///ty5xRgaxi4iFicpKQkbGxvs\n7OxISkpi8ODBzJo1i5o1az71BNsiIiIikrVYWVnRpk0bWrVqxbx582jbti3+/v6MGzeO8uXLGx1P\n0km/tf04dPnQP+5z4fcLT93V+dDdxLt0WtYJt9xuj92nQuEKTGky5ZnOD+Dt7Z3mec2aNf91QaJr\n166xc+dOPDw8AChfvjxFixZlyZIlDBo0CIB69epRr1691GNq1KiBh4cH9erV4+jRo7z44otPnLF+\n/fqMHDmS999/n82bN2NtbU1AQACBgYH069eP3LlzA3D48GGWLFnC2LFjGT58OACNGjXCysqK0aNH\nM2TIEMqVK/fE1/0rNzc3ihUrBvCvQ9aTkpIYNWoUDRo0YMGCBanbvby8qFevHnPmzKFXr16p2+/c\nucP69evJkycPAC+88ALVq1dn7dq1tGnT5pkzi3HU2SkiFuHnn3/mp59+Akgd7jB37lxKlCjB8uXL\nGTFiBJGRkTRp0sTImCIiIiKSTmxsbOjatSuxsbE0bNiQxo0b07ZtW2JjY42OJpkkOSUZM882FN2M\nmeSUf++0fB7Lli1j3759qY9Zs2b96zHe3t6phU6AIkWK4Orqyrlz51K3PXjwgHHjxuHt7Y2joyO2\ntrapxc8ff/zxqXOOHj2aX375hf/+97906NCBq1evMmrUKPz8/Lh69SoA27ZtA3hk0aGHzx++nhlO\nnDjBtWvXHslSt25dihUr9kiWmjVrphY6gdRi8J/fU8le1NkpIhZhwYIFLFq0iJMnTxITE0NYWBjH\njh2jXbt2dO7cmfLly+Pg4GB0TBERERFJZ/b29vTp04euXbvy2WefUbNmTVq2bMnIkSMpXry40fHk\nGT1JR+WUPVMYvHEwCckJT31+e2t7+lXrR99qGTevv5+f32MXKHqc/PnzP7LN3t6e+/fvpz4fNGgQ\n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\nSN02Y8YMPvjgA4KCgpg4caKB6URERERERDJPSkoKixcvZsSIEbi7uzN+/HiqVatmdCwRkWxLxU7J\nVL///jv58uXjp59+wsPDg+TkZKytrUlKSuLLL78kPDycBg0aMHXqVEqWLGl0XBERERERkUyRmJjI\n3LlzGT16NBUrVmTs2LH4+/sbHUtEJNvRGGHJVLlz5+bq1at4eHgAYG1tDfwxR2KvXr2YO3cux44d\no0+fPty9e9fIqCJpmM1mkpOTjY4hIiIiIjmUra0tb775Jj/99BP16tWjUaNGtG/fntOnTxsdTUQk\nW1GxUzJd/vz5H/taUFAQkydP5tq1azg5OWViKpF/Fh8fT/Hixbl48aLRUUREREQkB3NwcKBfv36c\nPn2acuXKUa1aNSZMmKCV20VEnpCGsUuWdPPmTfLly2d0DJE0hg0bxrlz55g/f77RUURERETEQty4\ncYP//e9/VK5c2egoIiLZgoqdYhiz2YzJZDI6hsgTu3PnDj4+PixatIhatWoZHUdERERERERE/kLD\n2MUwZ8+eJSkpyegYIk/M2dmZiRMnEhYWpvk7RURERERERLIgFTvFMG3btmXt2rVGxxB5KsHBweTJ\nk4cvv/zS6CgiIiIiIiIi8hcaxi6GOH78OI0aNeKXX37BxsbG6DgiT+XIkSO88sornDx5kgIFChgd\nR0RERERERET+jzo7xRCRkZF07txZhU7Jlvz9/QkODmb48OFGRxERERERERGRP1Fnp2S6hIQE3Nzc\n2LVrF56enkbHEXkmN2/exMfHh++++46AgACj44iIiIiIiIgI6uwUA6xatQofHx8VOiVby5cvH2PH\njiUsLAx9ZyQiIiIiIiKSNajYKZkuMjKSbt26GR1D5Ll17dqV+/fvs2DBAqOjiIiIiIiIiAgaxi6Z\nLC4ujhdffJELFy7g5ORkdByR57Znzx7eeOMNTp06hYuLi9FxRERERERERCyaOjslU82ZM4egoCAV\nOiXHqFatGg0bNmTs2LFGRxERERERERGxeOrslEyTkpJCmTJlWLRoEVWqVDE6jki6uXz5Mn5+fnz/\n/feULVvW6DgiIiIiYsESExM5evQoFStWNDqKiIgh1NkpmWb79u04OTnx0ksvGR1FJF0VLlyYYcOG\n0bdvXy1WJCIiIiKGa926Ndu3bzc6hoiIIVTslEwza9YsunXrhslkMjqKSLoLCwvj3LlzrFy50ugo\n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\n1oQJExJ9QNC6dWs1adJEo0aNUu7cuZUvXz5J0rx58+Tj4yNPT0/lyJFDLVu2VHh4eMJx0dHR6tGj\nh3LlyiUXFxflzZtX/v7+SfATAwDAthYsWKCXXnpJVatWNR0FgB04mQ6A1Ic5OwHYi8Vi0ZAhQzRi\nxAj5+vrKYrGYjgTYzL1799S3b1+VLFlSERERGj58uHx9fXXo0CE5Ozvr9u3b8vX1VYMGDbRo0SKd\nO3dOffr0SXSOuLg4vfjii1q2bJm8vLy0fft2denSRV5eXmrbtm3Cfhs3blSGDBn0ww8/JBRCY2Ji\nNGLECBUpUkRXr17Vxx9/rFatWmnTpk2SpEmTJikkJETLli3Tiy++qPPnz+vYsWNJ9wMCAMAGYmJi\nFBwcrHnz5pmOAsBOLFbGAsLGxo8fr8uXL2vChAmmowBIheLj41WqVClNmDBB9erVMx0HeCrt2rXT\nwoUL5erqmrDttdde07p16x7a9/bt28qUKZNCQ0NVqVIlTZs2TQEBATp//nzC8fPnz1fbtm21ZcuW\nx3an9OvXTwcPHtT69esl/dXZ+eOPP+rs2bNKly7dY7MePHhQJUuWVHh4uHLmzKnu3bvr+PHj2rBh\nAx80AABSrNmzZ2vRokX68ccfTUcBYCcMY4fNMWcnAHtycHDQkCFDNHz4cObuRIr0+uuva+/evQmP\nmTNnSpKOHTumd999Vy+99JIyZMigF154QVarVWfPnpUkHTlyRKVKlUpUKK1YseJD5582bZp8fHzk\n5eUlDw8PTZkyJeEcD5QsWfKhQufu3bvVqFEj5cuXT56engnnfnBs+/bttXv3bhUpUkQ9e/bUunXr\nFB8fb7sfDAAAdvZgrs6AgADTUQDYEcVO2BzD2AHY29tvv60bN27ol19+MR0FeGrp06dXoUKFEh65\nc+eWJDVs2FA3btzQjBkztGPHDv32229ycHBIWEDIarX+a0fl119/rX79+qlDhw7asGGD9u7dq65d\nuz60CJG7u3ui53fu3FHdunXl6emphQsXateuXVq7dq2k/1/AqHz58jp9+rSCg4MVExOj1q1bq379\n+nzoAABIMRYuXKj8+fPrtddeMx0FgB0xZydsjgWKANibo6OjfvrpJ+XKlct0FMAmLl++rGPHjmnW\nrFkJf4Dt3LkzUedksWLFtHTpUkVFRcnFxSVhn7/bunWrqlSpou7duydsO378+L9e//Dhw7px44bG\n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\n3TM5BbM0AAAAAElFTkSuQmCC\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "show_map(romania_graph_data)" ] @@ -372,9 +842,144 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 11, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
class SimpleProblemSolvingAgentProgram:\n",
+       "\n",
+       "    """Abstract framework for a problem-solving agent. [Figure 3.1]"""\n",
+       "\n",
+       "    def __init__(self, initial_state=None):\n",
+       "        """State is an abstract representation of the state\n",
+       "        of the world, and seq is the list of actions required\n",
+       "        to get to a particular state from the initial state(root)."""\n",
+       "        self.state = initial_state\n",
+       "        self.seq = []\n",
+       "\n",
+       "    def __call__(self, percept):\n",
+       "        """[Figure 3.1] Formulate a goal and problem, then\n",
+       "        search for a sequence of actions to solve it."""\n",
+       "        self.state = self.update_state(self.state, percept)\n",
+       "        if not self.seq:\n",
+       "            goal = self.formulate_goal(self.state)\n",
+       "            problem = self.formulate_problem(self.state, goal)\n",
+       "            self.seq = self.search(problem)\n",
+       "            if not self.seq:\n",
+       "                return None\n",
+       "        return self.seq.pop(0)\n",
+       "\n",
+       "    def update_state(self, state, percept):\n",
+       "        raise NotImplementedError\n",
+       "\n",
+       "    def formulate_goal(self, state):\n",
+       "        raise NotImplementedError\n",
+       "\n",
+       "    def formulate_problem(self, state, goal):\n",
+       "        raise NotImplementedError\n",
+       "\n",
+       "    def search(self, problem):\n",
+       "        raise NotImplementedError\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(SimpleProblemSolvingAgentProgram)" ] @@ -409,7 +1014,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 12, "metadata": { "collapsed": true }, @@ -452,9 +1057,19 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 13, "metadata": {}, - "outputs": [], + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Left\n", + "Suck\n", + "Right\n" + ] + } + ], "source": [ "state1 = [(0, 0), [(0, 0), \"Dirty\"], [(1, 0), [\"Dirty\"]]]\n", "state2 = [(1, 0), [(0, 0), \"Dirty\"], [(1, 0), [\"Dirty\"]]]\n", @@ -509,7 +1124,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 14, "metadata": { "collapsed": true }, @@ -562,7 +1177,7 @@ " \n", " return None\n", "\n", - "def breadth_first_tree_search(problem):\n", + "def breadth_first_tree_search_(problem):\n", " \"Search the shallowest nodes in the search tree first.\"\n", " iterations, all_node_colors, node = tree_search_for_vis(problem, FIFOQueue())\n", " return(iterations, all_node_colors, node)" @@ -577,15 +1192,15 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 15, "metadata": {}, "outputs": [], "source": [ "all_node_colors = []\n", "romania_problem = GraphProblem('Arad', 'Fagaras', romania_map)\n", - "a, b, c = breadth_first_tree_search(romania_problem)\n", + "a, b, c = breadth_first_tree_search_(romania_problem)\n", "display_visual(romania_graph_data, user_input=False, \n", - " algorithm=breadth_first_tree_search, \n", + " algorithm=breadth_first_tree_search_, \n", " problem=romania_problem)" ] }, @@ -599,13 +1214,13 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 16, "metadata": { "collapsed": true }, "outputs": [], "source": [ - "def depth_first_tree_search(problem):\n", + "def depth_first_tree_search_graph(problem):\n", " \"Search the deepest nodes in the search tree first.\"\n", " # This algorithm might not work in case of repeated paths\n", " # and may run into an infinite while loop.\n", @@ -615,14 +1230,14 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 17, "metadata": {}, "outputs": [], "source": [ "all_node_colors = []\n", "romania_problem = GraphProblem('Arad', 'Oradea', romania_map)\n", "display_visual(romania_graph_data, user_input=False, \n", - " algorithm=depth_first_tree_search, \n", + " algorithm=depth_first_tree_search_graph, \n", " problem=romania_problem)" ] }, @@ -639,13 +1254,13 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 18, "metadata": { "collapsed": true }, "outputs": [], "source": [ - "def breadth_first_search(problem):\n", + "def breadth_first_search_graph(problem):\n", " \"[Figure 3.11]\"\n", " \n", " # we use these two variables at the time of visualisations\n", @@ -703,14 +1318,14 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 19, "metadata": {}, "outputs": [], "source": [ "all_node_colors = []\n", "romania_problem = GraphProblem('Arad', 'Bucharest', romania_map)\n", "display_visual(romania_graph_data, user_input=False, \n", - " algorithm=breadth_first_search, \n", + " algorithm=breadth_first_search_graph, \n", " problem=romania_problem)" ] }, @@ -724,7 +1339,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 20, "metadata": { "collapsed": true }, @@ -790,7 +1405,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 21, "metadata": {}, "outputs": [], "source": [ @@ -812,7 +1427,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 22, "metadata": { "collapsed": true }, @@ -899,13 +1514,13 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 23, "metadata": { "collapsed": true }, "outputs": [], "source": [ - "def uniform_cost_search(problem):\n", + "def uniform_cost_search_graph(problem):\n", " \"[Figure 3.14]\"\n", " #Uniform Cost Search uses Best First Search algorithm with f(n) = g(n)\n", " iterations, all_node_colors, node = best_first_graph_search_for_vis(problem, lambda node: node.path_cost)\n", @@ -914,14 +1529,14 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 24, "metadata": {}, "outputs": [], "source": [ "all_node_colors = []\n", "romania_problem = GraphProblem('Arad', 'Bucharest', romania_map)\n", "display_visual(romania_graph_data, user_input=False, \n", - " algorithm=uniform_cost_search, \n", + " algorithm=uniform_cost_search_graph, \n", " problem=romania_problem)" ] }, @@ -935,7 +1550,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 25, "metadata": { "collapsed": true }, @@ -952,7 +1567,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 26, "metadata": {}, "outputs": [], "source": [ @@ -974,13 +1589,13 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 27, "metadata": { "collapsed": true }, "outputs": [], "source": [ - "def astar_search(problem, h=None):\n", + "def astar_search_graph(problem, h=None):\n", " \"\"\"A* search is best-first graph search with f(n) = g(n)+h(n).\n", " You need to specify the h function when you call astar_search, or\n", " else in your Problem subclass.\"\"\"\n", @@ -992,20 +1607,20 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 28, "metadata": {}, "outputs": [], "source": [ "all_node_colors = []\n", "romania_problem = GraphProblem('Arad', 'Bucharest', romania_map)\n", "display_visual(romania_graph_data, user_input=False, \n", - " algorithm=astar_search, \n", + " algorithm=astar_search_graph, \n", " problem=romania_problem)" ] }, { "cell_type": "code", - "execution_count": null, + "execution_count": 29, "metadata": { "scrolled": false }, @@ -1037,12 +1652,30 @@ "example:- \n", "\n", " Initial State Goal State\n", - " | 7 | 2 | 4 | | 0 | 1 | 2 |\n", - " | 5 | 0 | 6 | | 3 | 4 | 5 |\n", - " | 8 | 3 | 1 | | 6 | 7 | 8 |\n", + " | 7 | 2 | 4 | | 1 | 2 | 3 |\n", + " | 5 | 0 | 6 | | 4 | 5 | 6 |\n", + " | 8 | 3 | 1 | | 7 | 8 | 0 |\n", " \n", "We have a total of 9 blank tiles giving us a total of 9! initial configuration but not all of these are solvable. The solvability of a configuration can be checked by calculating the Inversion Permutation. If the total Inversion Permutation is even then the initial configuration is solvable else the initial configuration is not solvable which means that only 9!/2 initial states lead to a solution.\n", - "\n", + "
\n", + "Let's define our goal state." + ] + }, + { + "cell_type": "code", + "execution_count": 30, + "metadata": { + "collapsed": true + }, + "outputs": [], + "source": [ + "goal = [1, 2, 3, 4, 5, 6, 7, 8, 0]" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ "#### Heuristics :-\n", "\n", "1) Manhattan Distance:- For the 8 puzzle problem Manhattan distance is defined as the distance of a tile from its goal state( for the tile numbered '1' in the initial configuration Manhattan distance is 4 \"2 for left and 2 for upward displacement\").\n", @@ -1051,23 +1684,23 @@ "\n", "3) Sqrt of Manhattan Distance:- It calculates the square root of Manhattan distance.\n", "\n", - "4) Max Heuristic:- It assign the score as the maximum between \"Manhattan Distance\" and \"No. of Misplaced Tiles\". " + "4) Max Heuristic:- It assign the score as the maximum between \"Manhattan Distance\" and \"No. of Misplaced Tiles\"." ] }, { "cell_type": "code", - "execution_count": null, + "execution_count": 31, "metadata": { "collapsed": true }, "outputs": [], "source": [ "# Heuristics for 8 Puzzle Problem\n", + "def linear(node):\n", + " return sum([1 if node.state[i] != goal[i] else 0 for i in range(8)])\n", "\n", - "def linear(state,goal):\n", - " return sum([1 if state[i] != goal[i] else 0 for i in range(8)])\n", - "\n", - "def manhanttan(state,goal):\n", + "def manhattan(node):\n", + " state = node.state\n", " index_goal = {0:[2,2], 1:[0,0], 2:[0,1], 3:[0,2], 4:[1,0], 5:[1,1], 6:[1,2], 7:[2,0], 8:[2,1]}\n", " index_state = {}\n", " index = [[0,0], [0,1], [0,2], [1,0], [1,1], [1,2], [2,0], [2,1], [2,2]]\n", @@ -1084,7 +1717,8 @@ " \n", " return mhd\n", "\n", - "def sqrt_manhanttan(state,goal):\n", + "def sqrt_manhattan(node):\n", + " state = node.state\n", " index_goal = {0:[2,2], 1:[0,0], 2:[0,1], 3:[0,2], 4:[1,0], 5:[1,1], 6:[1,2], 7:[2,0], 8:[2,1]}\n", " index_state = {}\n", " index = [[0,0], [0,1], [0,2], [1,0], [1,1], [1,2], [2,0], [2,1], [2,2]]\n", @@ -1101,25 +1735,300 @@ " \n", " return math.sqrt(mhd)\n", "\n", - "def max_heuristic(state,goal):\n", - " score1 = manhanttan(state, goal)\n", - " score2 = linear(state, goal)\n", + "def max_heuristic(node):\n", + " score1 = manhattan(node)\n", + " score2 = linear(node)\n", " return max(score1, score2)" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can solve the puzzle using the `astar_search` method." + ] + }, { "cell_type": "code", - "execution_count": null, + "execution_count": 32, "metadata": {}, - "outputs": [], + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 32, + "metadata": {}, + "output_type": "execute_result" + } + ], "source": [ "# Solving the puzzle \n", - "puzzle = EightPuzzle()\n", - "puzzle.checkSolvability([2,4,3,1,5,6,7,8,0]) # checks whether the initialized configuration is solvable or not\n", - "puzzle.solve([2,4,3,1,5,6,7,8,0], [1,2,3,4,5,6,7,8,0],max_heuristic) # Max_heuristic\n", - "puzzle.solve([2,4,3,1,5,6,7,8,0], [1,2,3,4,5,6,7,8,0],linear) # Linear\n", - "puzzle.solve([2,4,3,1,5,6,7,8,0], [1,2,3,4,5,6,7,8,0],manhanttan) # Manhattan\n", - "puzzle.solve([2,4,3,1,5,6,7,8,0], [1,2,3,4,5,6,7,8,0],sqrt_manhanttan) # Sqrt_manhattan" + "puzzle = EightPuzzle((2, 4, 3, 1, 5, 6, 7, 8, 0))\n", + "puzzle.check_solvability((2, 4, 3, 1, 5, 6, 7, 8, 0)) # checks whether the initialized configuration is solvable or not" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This case is solvable, let's proceed.\n", + "
\n", + "The default heuristic function returns the number of misplaced tiles." + ] + }, + { + "cell_type": "code", + "execution_count": 33, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['UP', 'LEFT', 'UP', 'LEFT', 'DOWN', 'RIGHT', 'RIGHT', 'DOWN']" + ] + }, + "execution_count": 33, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "astar_search(puzzle).solution()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the following cells, we use different heuristic functions.\n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": 34, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['UP', 'LEFT', 'UP', 'LEFT', 'DOWN', 'RIGHT', 'RIGHT', 'DOWN']" + ] + }, + "execution_count": 34, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "astar_search(puzzle, linear).solution()" + ] + }, + { + "cell_type": "code", + "execution_count": 35, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['LEFT', 'UP', 'UP', 'LEFT', 'DOWN', 'RIGHT', 'DOWN', 'RIGHT']" + ] + }, + "execution_count": 35, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "astar_search(puzzle, manhattan).solution()" + ] + }, + { + "cell_type": "code", + "execution_count": 36, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['LEFT', 'UP', 'UP', 'LEFT', 'DOWN', 'RIGHT', 'DOWN', 'RIGHT']" + ] + }, + "execution_count": 36, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "astar_search(puzzle, sqrt_manhattan).solution()" + ] + }, + { + "cell_type": "code", + "execution_count": 37, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['LEFT', 'UP', 'UP', 'LEFT', 'DOWN', 'RIGHT', 'DOWN', 'RIGHT']" + ] + }, + "execution_count": 37, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "astar_search(puzzle, max_heuristic).solution()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Even though all the heuristic functions give the same solution, the difference lies in the computation time.\n", + "
\n", + "This might make all the difference in a scenario where high computational efficiency is required.\n", + "
\n", + "Let's define a few puzzle states and time `astar_search` for every heuristic function.\n", + "We will use the %%timeit magic for this." + ] + }, + { + "cell_type": "code", + "execution_count": 38, + "metadata": { + "collapsed": true + }, + "outputs": [], + "source": [ + "puzzle_1 = EightPuzzle((2, 4, 3, 1, 5, 6, 7, 8, 0))\n", + "puzzle_2 = EightPuzzle((1, 2, 3, 4, 5, 6, 0, 7, 8))\n", + "puzzle_3 = EightPuzzle((1, 2, 3, 4, 5, 7, 8, 6, 0))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The default heuristic function is the same as the `linear` heuristic function, but we'll still check both." + ] + }, + { + "cell_type": "code", + "execution_count": 39, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "11.3 ms ± 2.28 ms per loop (mean ± std. dev. of 7 runs, 100 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "astar_search(puzzle_1)\n", + "astar_search(puzzle_2)\n", + "astar_search(puzzle_3)" + ] + }, + { + "cell_type": "code", + "execution_count": 40, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "10.7 ms ± 591 µs per loop (mean ± std. dev. of 7 runs, 100 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "astar_search(puzzle_1, linear)\n", + "astar_search(puzzle_2, linear)\n", + "astar_search(puzzle_3, linear)" + ] + }, + { + "cell_type": "code", + "execution_count": 41, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "8.44 ms ± 870 µs per loop (mean ± std. dev. of 7 runs, 100 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "astar_search(puzzle_1, manhattan)\n", + "astar_search(puzzle_2, manhattan)\n", + "astar_search(puzzle_3, manhattan)" + ] + }, + { + "cell_type": "code", + "execution_count": 42, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "91.7 ms ± 1.89 ms per loop (mean ± std. dev. of 7 runs, 10 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "astar_search(puzzle_1, sqrt_manhattan)\n", + "astar_search(puzzle_2, sqrt_manhattan)\n", + "astar_search(puzzle_3, sqrt_manhattan)" + ] + }, + { + "cell_type": "code", + "execution_count": 43, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "8.53 ms ± 601 µs per loop (mean ± std. dev. of 7 runs, 100 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "astar_search(puzzle_1, max_heuristic)\n", + "astar_search(puzzle_2, max_heuristic)\n", + "astar_search(puzzle_3, max_heuristic)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can infer that the `manhattan` heuristic function works the fastest.\n", + "
\n", + "`sqrt_manhattan` has an extra `sqrt` operation which makes it quite a lot slower than the others.\n", + "
\n", + "`max_heuristic` should have been a bit slower as it calls two functions, but in this case, those values were already calculated which saved some time.\n", + "Feel free to play around with these functions." ] }, { @@ -1143,11 +2052,124 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 44, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
def hill_climbing(problem):\n",
+       "    """From the initial node, keep choosing the neighbor with highest value,\n",
+       "    stopping when no neighbor is better. [Figure 4.2]"""\n",
+       "    current = Node(problem.initial)\n",
+       "    while True:\n",
+       "        neighbors = current.expand(problem)\n",
+       "        if not neighbors:\n",
+       "            break\n",
+       "        neighbor = argmax_random_tie(neighbors,\n",
+       "                                     key=lambda node: problem.value(node.state))\n",
+       "        if problem.value(neighbor.state) <= problem.value(current.state):\n",
+       "            break\n",
+       "        current = neighbor\n",
+       "    return current.state\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(hill_climbing)" ] @@ -1165,7 +2187,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 45, "metadata": { "collapsed": true }, @@ -1217,11 +2239,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 46, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "['Arad', 'Bucharest', 'Craiova', 'Drobeta', 'Eforie', 'Fagaras', 'Giurgiu', 'Hirsova', 'Iasi', 'Lugoj', 'Mehadia', 'Neamt', 'Oradea', 'Pitesti', 'Rimnicu', 'Sibiu', 'Timisoara', 'Urziceni', 'Vaslui', 'Zerind']\n" + ] + } + ], "source": [ "distances = {}\n", "all_cities = []\n", @@ -1243,7 +2271,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 47, "metadata": { "collapsed": true }, @@ -1270,7 +2298,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 48, "metadata": { "collapsed": true }, @@ -1319,7 +2347,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 49, "metadata": { "collapsed": true }, @@ -1338,11 +2366,39 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 50, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['Arad',\n", + " 'Timisoara',\n", + " 'Lugoj',\n", + " 'Mehadia',\n", + " 'Drobeta',\n", + " 'Craiova',\n", + " 'Pitesti',\n", + " 'Giurgiu',\n", + " 'Bucharest',\n", + " 'Urziceni',\n", + " 'Eforie',\n", + " 'Hirsova',\n", + " 'Vaslui',\n", + " 'Iasi',\n", + " 'Neamt',\n", + " 'Fagaras',\n", + " 'Rimnicu',\n", + " 'Sibiu',\n", + " 'Oradea',\n", + " 'Zerind']" + ] + }, + "execution_count": 50, + "metadata": {}, + "output_type": "execute_result" + } + ], "source": [ "hill_climbing(tsp)" ] @@ -1466,11 +2522,122 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 51, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
def genetic_algorithm(population, fitness_fn, gene_pool=[0, 1], f_thres=None, ngen=1000, pmut=0.1):\n",
+       "    """[Figure 4.8]"""\n",
+       "    for i in range(ngen):\n",
+       "        population = [mutate(recombine(*select(2, population, fitness_fn)), gene_pool, pmut)\n",
+       "                      for i in range(len(population))]\n",
+       "\n",
+       "        fittest_individual = fitness_threshold(fitness_fn, f_thres, population)\n",
+       "        if fittest_individual:\n",
+       "            return fittest_individual\n",
+       "\n",
+       "\n",
+       "    return argmax(population, key=fitness_fn)\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(genetic_algorithm)" ] @@ -1507,11 +2674,114 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 52, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
def recombine(x, y):\n",
+       "    n = len(x)\n",
+       "    c = random.randrange(0, n)\n",
+       "    return x[:c] + y[c:]\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(recombine)" ] @@ -1527,11 +2797,121 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 53, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
def mutate(x, gene_pool, pmut):\n",
+       "    if random.uniform(0, 1) >= pmut:\n",
+       "        return x\n",
+       "\n",
+       "    n = len(x)\n",
+       "    g = len(gene_pool)\n",
+       "    c = random.randrange(0, n)\n",
+       "    r = random.randrange(0, g)\n",
+       "\n",
+       "    new_gene = gene_pool[r]\n",
+       "    return x[:c] + [new_gene] + x[c+1:]\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(mutate)" ] @@ -1547,11 +2927,122 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 54, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
def init_population(pop_number, gene_pool, state_length):\n",
+       "    """Initializes population for genetic algorithm\n",
+       "    pop_number  :  Number of individuals in population\n",
+       "    gene_pool   :  List of possible values for individuals\n",
+       "    state_length:  The length of each individual"""\n",
+       "    g = len(gene_pool)\n",
+       "    population = []\n",
+       "    for i in range(pop_number):\n",
+       "        new_individual = [gene_pool[random.randrange(0, g)] for j in range(state_length)]\n",
+       "        population.append(new_individual)\n",
+       "\n",
+       "    return population\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(init_population)" ] @@ -1603,7 +3094,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 55, "metadata": { "collapsed": true }, @@ -1623,7 +3114,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 56, "metadata": { "collapsed": true }, @@ -1649,7 +3140,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 57, "metadata": { "collapsed": true }, @@ -1667,7 +3158,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 58, "metadata": { "collapsed": true }, @@ -1685,7 +3176,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 59, "metadata": { "collapsed": true }, @@ -1710,7 +3201,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 60, "metadata": { "collapsed": true }, @@ -1728,7 +3219,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 61, "metadata": { "collapsed": true }, @@ -1739,7 +3230,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 62, "metadata": { "collapsed": true }, @@ -1758,7 +3249,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 63, "metadata": { "collapsed": true }, @@ -1780,7 +3271,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 64, "metadata": { "collapsed": true }, @@ -1798,7 +3289,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 65, "metadata": { "collapsed": true }, @@ -1816,11 +3307,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 66, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "['J', 'y', 'O', 'e', ' ', 'h', 'c', 'r', 'C', 'W', 'H', 'o', 'r', 'R', 'y', 'P', 'U']\n" + ] + } + ], "source": [ "print(current_best)" ] @@ -1834,11 +3331,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 67, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "JyOe hcrCWHorRyPU\n" + ] + } + ], "source": [ "current_best_string = ''.join(current_best)\n", "print(current_best_string)" @@ -1857,7 +3360,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 68, "metadata": { "collapsed": true }, @@ -1881,7 +3384,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 69, "metadata": { "collapsed": true }, @@ -1912,11 +3415,122 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 70, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
def genetic_algorithm(population, fitness_fn, gene_pool=[0, 1], f_thres=None, ngen=1000, pmut=0.1):\n",
+       "    """[Figure 4.8]"""\n",
+       "    for i in range(ngen):\n",
+       "        population = [mutate(recombine(*select(2, population, fitness_fn)), gene_pool, pmut)\n",
+       "                      for i in range(len(population))]\n",
+       "\n",
+       "        fittest_individual = fitness_threshold(fitness_fn, f_thres, population)\n",
+       "        if fittest_individual:\n",
+       "            return fittest_individual\n",
+       "\n",
+       "\n",
+       "    return argmax(population, key=fitness_fn)\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], "source": [ "psource(genetic_algorithm)" ] @@ -1930,11 +3544,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 71, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Current best: Genetic Algorithm\t\tGeneration: 985\t\tFitness: 17\r" + ] + } + ], "source": [ "population = init_population(max_population, gene_pool, len(target))\n", "solution, generations = genetic_algorithm_stepwise(population, fitness_fn, gene_pool, f_thres, ngen, mutation_rate)" @@ -1977,7 +3597,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 72, "metadata": { "collapsed": true }, @@ -2002,11 +3622,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 73, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[['R', 'G', 'G', 'G'], ['G', 'R', 'R', 'G'], ['G', 'G', 'G', 'G'], ['G', 'R', 'G', 'G'], ['G', 'G', 'G', 'R'], ['G', 'R', 'R', 'G'], ['G', 'R', 'G', 'G'], ['G', 'G', 'R', 'G']]\n" + ] + } + ], "source": [ "population = init_population(8, ['R', 'G'], 4)\n", "print(population)" @@ -2023,7 +3649,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 74, "metadata": { "collapsed": true }, @@ -2042,11 +3668,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 75, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "['R', 'G', 'R', 'G']\n" + ] + } + ], "source": [ "solution = genetic_algorithm(population, fitness, gene_pool=['R', 'G'])\n", "print(solution)" @@ -2061,11 +3693,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 76, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "4\n" + ] + } + ], "source": [ "print(fitness(solution))" ] @@ -2100,11 +3738,17 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 77, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[[2, 6, 2, 0, 2, 3, 4, 7], [7, 2, 0, 6, 3, 3, 0, 6], [2, 3, 0, 6, 6, 2, 5, 5], [2, 6, 4, 2, 3, 5, 5, 5], [3, 1, 5, 1, 5, 1, 0, 3]]\n" + ] + } + ], "source": [ "population = init_population(100, range(8), 8)\n", "print(population[:5])" @@ -2125,7 +3769,7 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 78, "metadata": { "collapsed": true }, @@ -2157,11 +3801,18 @@ }, { "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": true - }, - "outputs": [], + "execution_count": 79, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[2, 5, 7, 1, 3, 6, 4, 6]\n", + "25\n" + ] + } + ], "source": [ "solution = genetic_algorithm(population, fitness, f_thres=25, gene_pool=range(8))\n", "print(solution)\n", @@ -2179,7 +3830,583 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "With that this tutorial on the genetic algorithm comes to an end. Hope you found this guide helpful!" + "This is where we conclude Genetic Algorithms." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### N-Queens Problem\n", + "Here, we will look at the generalized cae of the Eight Queens problem.\n", + "
\n", + "We are given a `N` x `N` chessboard, with `N` queens, and we need to place them in such a way that no two queens can attack each other.\n", + "
\n", + "We will solve this problem using search algorithms.\n", + "To do this, we already have a `NQueensProblem` class in `search.py`." + ] + }, + { + "cell_type": "code", + "execution_count": 80, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
class NQueensProblem(Problem):\n",
+       "\n",
+       "    """The problem of placing N queens on an NxN board with none attacking\n",
+       "    each other.  A state is represented as an N-element array, where\n",
+       "    a value of r in the c-th entry means there is a queen at column c,\n",
+       "    row r, and a value of -1 means that the c-th column has not been\n",
+       "    filled in yet.  We fill in columns left to right.\n",
+       "    >>> depth_first_tree_search(NQueensProblem(8))\n",
+       "    <Node (7, 3, 0, 2, 5, 1, 6, 4)>\n",
+       "    """\n",
+       "\n",
+       "    def __init__(self, N):\n",
+       "        self.N = N\n",
+       "        self.initial = tuple([-1] * N)\n",
+       "        Problem.__init__(self, self.initial)\n",
+       "\n",
+       "    def actions(self, state):\n",
+       "        """In the leftmost empty column, try all non-conflicting rows."""\n",
+       "        if state[-1] is not -1:\n",
+       "            return []  # All columns filled; no successors\n",
+       "        else:\n",
+       "            col = state.index(-1)\n",
+       "            return [row for row in range(self.N)\n",
+       "                    if not self.conflicted(state, row, col)]\n",
+       "\n",
+       "    def result(self, state, row):\n",
+       "        """Place the next queen at the given row."""\n",
+       "        col = state.index(-1)\n",
+       "        new = list(state[:])\n",
+       "        new[col] = row\n",
+       "        return tuple(new)\n",
+       "\n",
+       "    def conflicted(self, state, row, col):\n",
+       "        """Would placing a queen at (row, col) conflict with anything?"""\n",
+       "        return any(self.conflict(row, col, state[c], c)\n",
+       "                   for c in range(col))\n",
+       "\n",
+       "    def conflict(self, row1, col1, row2, col2):\n",
+       "        """Would putting two queens in (row1, col1) and (row2, col2) conflict?"""\n",
+       "        return (row1 == row2 or  # same row\n",
+       "                col1 == col2 or  # same column\n",
+       "                row1 - col1 == row2 - col2 or  # same \\ diagonal\n",
+       "                row1 + col1 == row2 + col2)   # same / diagonal\n",
+       "\n",
+       "    def goal_test(self, state):\n",
+       "        """Check if all columns filled, no conflicts."""\n",
+       "        if state[-1] is -1:\n",
+       "            return False\n",
+       "        return not any(self.conflicted(state, state[col], col)\n",
+       "                       for col in range(len(state)))\n",
+       "\n",
+       "    def h(self, node):\n",
+       "        """Return number of conflicting queens for a given node"""\n",
+       "        num_conflicts = 0\n",
+       "        for (r1, c1) in enumerate(node.state):\n",
+       "            for (r2, c2) in enumerate(node.state):\n",
+       "                if (r1, c1) != (r2, c2):\n",
+       "                    num_conflicts += self.conflict(r1, c1, r2, c2)\n",
+       "\n",
+       "        return num_conflicts\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "psource(NQueensProblem)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In [`csp.ipynb`](https://github.com/aimacode/aima-python/blob/master/csp.ipynb) we have seen that the N-Queens problem can be formulated as a CSP and can be solved by \n", + "the `min_conflicts` algorithm in a way similar to Hill-Climbing. \n", + "Here, we want to solve it using heuristic search algorithms and even some classical search algorithms.\n", + "The `NQueensProblem` class derives from the `Problem` class and is implemented in such a way that the search algorithms we already have, can solve it.\n", + "
\n", + "Let's instantiate the class." + ] + }, + { + "cell_type": "code", + "execution_count": 81, + "metadata": { + "collapsed": true + }, + "outputs": [], + "source": [ + "nqp = NQueensProblem(8)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let's use `depth_first_tree_search` first.\n", + "
\n", + "We will also use the %%timeit magic with each algorithm to see how much time they take." + ] + }, + { + "cell_type": "code", + "execution_count": 82, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "4.82 ms ± 498 µs per loop (mean ± std. dev. of 7 runs, 100 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "depth_first_tree_search(nqp)" + ] + }, + { + "cell_type": "code", + "execution_count": 83, + "metadata": { + "collapsed": true + }, + "outputs": [], + "source": [ + "dfts = depth_first_tree_search(nqp).solution()" + ] + }, + { + "cell_type": "code", + "execution_count": 84, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\ni42ZrZLUJWmMc25x2vWJm5m9KqnLOZfLhVPM7F5JP3bO3WNmwyWNcs71pl2vuPXHi9clzXHONXNh\nr1BF6mFfLOkV59x+59y7krZK+kzKdYqNc+4ZScfTrkdSnHNvOOf29r8+JennkqakW6t4Oc9b/W/b\n+x+5+UVtZlMlXSHpnn58C9IAAAJTSURBVLTrgqEzszGS5knaKEnOuXfzGKz7fVLSL1opWEvFCthT\nJL1W9v6gcvYfflGY2Qcl/Z6k59OtSfz6h4xflHRU0g+dc3n6jN+U9GVJ/z3tiiTISdpuZnvMbHna\nlYnZDEnHJG3qP61xj5mdm3alErJU0pa0K1GtSAHbbzHa3PReisLM3ifpQUkrnXMn065P3JxzZ51z\nF0qaKuliM8vF6Q0zWyzpqHNuT9p1Sdhc59xFkhZK+o/9p6ryok3SRZL+xjn3e5LelpSruUCS1D/U\nf6Wk76Vdl2pFCtgHJU0rez9V0qGU6oI69J/XfVDSfc65f0i7PknqH2rcIenTKVclLnMlXdl/jner\npMvM7O/SrVL8nHOH+p+PSnpI3qm4vDgo6WDZqM/fywvgebNQ0l7n3JG0K1KtSAH7nyR92Mym9/+C\nWippW8p1QkT9E7I2Svq5c25d2vVJgpl1mtm4/tfnSFog6V/TrVU8nHO3OOemOuc+KO9v70fOuc+m\nXK1Ymdm5/RMi1T9U/EeScnPVhnPusKTXzOwj/Zs+KSk3kz7LLFMLDodLrXF7zaZwzp0xsxslPSFp\nmKS/dc69nHK1YmNmWyTNlzTRzA5K+opzbmO6tYrVXEnXSvqX/nO8krTGOfePKdYpbu+XdG//DNV/\nJ+kB51wuL3/KqcmSHuq/FWSbpO865x5Pt0qx+6Kk+/o7Pfsl3ZByfWJlZqPkXUn0H9Kui5/CXNYF\nAECWFWlIHACAzCJgAwCQAQRsAAAygIANAEAGELABAMgAAjYAABlAwAYAIAP+fzFY3dTllVswAAAA\nAElFTkSuQmCC\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "plot_NQueens(dfts)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "`breadth_first_tree_search`" + ] + }, + { + "cell_type": "code", + "execution_count": 85, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "88.6 ms ± 2.01 ms per loop (mean ± std. dev. of 7 runs, 10 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "breadth_first_tree_search(nqp)" + ] + }, + { + "cell_type": "code", + "execution_count": 86, + "metadata": { + "collapsed": true + }, + "outputs": [], + "source": [ + "bfts = breadth_first_tree_search(nqp).solution()" + ] + }, + { + "cell_type": "code", + "execution_count": 87, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\nubfMrFPSdklfcs49l3LVYmNmyyX1SBrlnFuQdn3iZmavSupxzuVy4RQzu0fSj51zd5vZUEkjnHO5\nu+t8f7x4XdJM51wrF/YKVaQe9kWSXnHO7XHOvStpk6TPpFyn2DjnnpF0JO16JMU594Zzblf/6xOS\nfi5pUrq1ipfzvNX/tl2ok/MAAAJgSURBVLP/kZtf1GY2WdLlku5Ouy6on5mNkjRb0jpJcs69m8dg\n3e+Tkn7RTsFaKlbAniTptbL3+5Sz//CLwsw+KOn3JT2fbk3i1z9k/KKkQ5J+5JzL02f8pqQvS/of\naVckQU7SFjPbaWZL0q5MzKZJOixpff9pjbvN7Oy0K5WQRZI2pl2JakUK2H6L0eam91IUZvY+SQ9I\nWuacO552feLmnDvjnLtA0mRJF5lZLk5vmNkCSYecczvTrkvCZjnnLpQ0T9J/6j9VlRcdki6U9DfO\nud+X9LakXM0FkqT+of4rJH0/7bpUK1LA3idpStn7yZL2p1QXNKD/vO4Dku51zv1D2vVJUv9Q41ZJ\nn065KnGZJemK/nO8myRdamZ/l26V4uec29//fEjSg/JOxeXFPkn7ykZ9/l5eAM+beZJ2OecOpl2R\nakUK2P8k6cNmNrX/F9QiSZtTrhMi6p+QtU7Sz51zq9OuTxLMrNvMxvS/PkvSXEn/mm6t4uGcu9k5\nN9k590F5f3tPOec+m3K1YmVmZ/dPiFT/UPEfS8rNVRvOuQOSXjOzj/Rv+qSk3Ez6LLNYbTgcLrXH\n7TVbwjl32sxukPS4pCGS/tY593LK1YqNmW2UNEfSeDPbJ+krzrl16dYqVrMkXSPpX/rP8UrSSufc\nP6ZYp7i9X9I9/TNUf0fS/c65XF7+lFMTJT3YfyvIDknfc849lm6VYvdFSff2d3r2SLo+5frEysxG\nyLuS6D+mXRc/hbmsCwCALCvSkDgAAJlFwAYAIAMI2AAAZAABGwCADCBgAwCQAQRsAAAygIANAEAG\n/P+uMuaa/akHvAAAAABJRU5ErkJggg==\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "plot_NQueens(bfts)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "`uniform_cost_search`" + ] + }, + { + "cell_type": "code", + "execution_count": 88, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "1.08 s ± 154 ms per loop (mean ± std. dev. of 7 runs, 1 loop each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "uniform_cost_search(nqp)" + ] + }, + { + "cell_type": "code", + "execution_count": 89, + "metadata": { + "collapsed": true + }, + "outputs": [], + "source": [ + "ucs = uniform_cost_search(nqp).solution()" + ] + }, + { + "cell_type": "code", + "execution_count": 90, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAewAAAHwCAYAAABkPlyAAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMS4wLCBo\ndHRwOi8vbWF0cGxvdGxpYi5vcmcvpW3flQAAIABJREFUeJzt3X+4FNWd7/vPd9gbEMOvDRtMgGtg\nkifnTow4skecIXKJIWNAMHru3Bm4Ro/m5nJu7jEEwcmMPM88MXlONFcFQuLcycmRAc8ZA5pxjKgT\nJf4AA0adDaNMTGbuY8BERH5sgYBiInDW/aN2u7t7V1VXd1d1dVW9X8/TT3dXrVprdS82316rVq0y\n55wAAEB7+520KwAAAGojYAMAkAEEbAAAMoCADQBABhCwAQDIAAI2AAAZQMAGACADCNgAAGQAARto\nM2b2QTP7RzM7amYHzOwuM+sIST/GzP6mP+1JM/sXM/sPrawzgOQRsIH28/9KOiTp/ZIukPS/SPq/\n/RKa2VBJT0g6V9IfShot6c8l3W5mS1tSWwAtQcAG2s9USfc7537jnDsg6TFJHw1Ie42k/0nS/+ac\n2+ucO+Wce0zSUkn/2cxGSpKZOTP7UOkgM9tgZv+57P0CM3vRzI6Z2bNmdn7Zvg+Y2QNmdtjM9pb/\nEDCzW8zsfjP7b2Z2wsxeNrOesv1/YWav9+/7NzP7ZDxfEVA8BGyg/ayVtMjMRpjZJEnz5AVtP5+S\n9EPn3NtV2x+QNELSxbUKM7MLJf2tpP8oaZyk/yJps5kNM7PfkfSwpJckTZL0SUnLzOyysiyukLRJ\n0hhJmyXd1Z/vRyTdIOkPnHMjJV0m6dVa9QHgj4ANtJ9t8nrUxyXtk9Qr6QcBacdLeqN6o3PutKQ+\nSd0Ryvs/Jf0X59zzzrkzzrl7JP1WXrD/A0ndzrmvOefedc7tkfRfJS0qO367c+4fnXNnJP13SdP7\nt5+RNEzS75lZp3PuVefcLyLUB4APAjbQRvp7tI9L+gdJZ8sLyGMl/T8Bh/TJO9ddnU9H/7GHIxR7\nrqQV/cPhx8zsmKQpkj7Qv+8DVftWSppYdvyBstcnJQ03sw7n3CuSlkm6RdIhM9tkZh+IUB8APgjY\nQHvpkhcs73LO/dY596ak9ZLmB6R/QtI8Mzu7avv/KumUpBf635+UN0Reck7Z69ckfd05N6bsMcI5\nt7F/396qfSOdc0H1qeCc+55z7uPyAr9T8A8PADUQsIE24pzrk7RX0hfMrMPMxkj6D/LOIfv57/KG\nzb/ffzlYZ//55W9Jut059+v+dC9K+t/NbIiZfVrezPOS/yrp/zKzmeY528wu75+w9oKk4/2Tx87q\nP/48M/uDWp/FzD5iZpea2TBJv5H0jrxhcgANIGAD7effS/q0vOHsVySdlnSjX0Ln3G8lzZXXE35e\nXlB8TNI3JX21LOmXJC2UdEzS1So7J+6c65V3HvsuSUf7y7yuf9+Z/uMukPdDok/S3fIuH6tlmKRv\n9B9zQNIEecPpABpgzrm06wAgJmbWKemHkl6XdJ3jDxzIDXrYQI44507JO3/9C0kfSbk6AGJEDxsA\ngAyghw0AQAYE3lCgVcaPH+8++MEPpl2NxOzcuTPtKiRqxowZaVchcbRhttF+2Zf3NpTU55yruchR\n6kPiPT09rre3t/mMdlrzecyI/7swi6FebSztfz+tQBtmG+2XfXlvQ0k7nXM9tRJle0j84B1eoI4j\nWEsDeR1cFU9+AADEJJsB+9SbXmDd9+Vk8t93k5f/qYPJ5A8AQJ1SP4ddt7h601Hs7l+9MYGhcgAA\n6pGtHnYrg3U7lAsAQL9sBOxdw9IPmjtNOrIp3ToAAAqr/QP2TpPcu01nc8PtMdRl7+L0fzgAAAqp\nvc9h7xredBZWNlH+r+/3nl2zV5HtGiZd+NsmMwEAILr27mG72kGxe6507w/991nAVW1B2yOLoccP\nAEA92jdg1xh6th7v0XdM+uxfNR+ES/mVHuf9aXP1AwAgTu0ZsGsEw2/f57+90aDtd9zLeyIcSNAG\nALRI+wXs04dqJll6RwvqoYg/AE73JV4PAADaL2C/NDG2rIImlzU96azcSzXXawcAoGntNUv8jYFr\nr/x6t6VA63qjD3+7XunESWnUbOn4M9LIEdGrs/4rA6/D6qMDa6RzboyeMQAAdWqvHvb+v5AUHIz3\nlY2Wz5o+eH9Qz7kUpIOCddBx1y30nn91wH//e/V8fbl/AgAAYtJeAbuGKfMHXm9fVxlow4a5P3yV\n9zzu0uA01XmVvz93QX31BAAgbu0TsJuccf16yFy1V17zno8cD04Tti8SZowDABLUPgE7gvmzgvdN\nnh+8L4qw3veCS5rLGwCAZrVlwD65w3/7o2tbW4+Sh9f4b3/n2dbWAwBQXO0RsE9Vzuo6a5h3Dvms\nYQPbolyKteHhxop/aFvtNOXljxjuvR8+tCrRqcONVQAAgBraI2Dvfr/v5pM7pFPPe6+jXMZ1/VcH\nbzt9pvJ937HBaa5cUTvvUvnHtkpvbw9ItHtC7YwAAGhAewTsEB1Dmjt+6MWV77vnNpff6Pc1dzwA\nAI1o+4BdLkove9HKyvfOhaf/3NfiKRcAgCRlKmBHcd+W+tKv35xMPQAAiFMiAdvMPm1m/2Zmr5jZ\nX9ZKv3x1HXm3uLdbT3n1fA4AAOoRe8A2syGS/lrSPEm/J2mxmf1e2DGrY17Z8wu3RUsX912/4v4c\nAACUJNHDvkjSK865Pc65dyVtkvSZOAtYsCx8/3ce8J637fLfv/kZ7znovtol1bPHr728dt0AAEhC\nEgF7kqTXyt7v69/2HjNbYma9ZtZ7+HDta5enfqDy/aNBl1VVmbPEf/tnIvaEq6/PvsfnsjEAAFoh\niYDtt6h2xVxt59x3nXM9zrme7u7a95P+8d2Dt81bGn5MV8hSo5I09hPh+5etCt8PAEArJRGw90ma\nUvZ+sqT9oUdMD+9lT/JZj+SxGsuCHq1xM49jJ8L3r90Yvt/X+X0NHAQAQG1JBOx/kvRhM5tqZkMl\nLZIUfvFUx/iGCkpqxvhVNzV4YOe4WOsBAEBJR9wZOudOm9kNkh6XNETS3zrnXo67nCT9YGvaNQAA\noFLsAVuSnHP/KOkf48xzYpd08EicOdZn5nnplQ0AQPusdDYjfA3RA3WuYFbuYx+S5l4k/e7kxvN4\nbkONBDXqDwBAMxLpYSfF9Qaft54/q7n7ZV92g7TlueByAQBIU3sF7Ml3SvvCZ3wd2yqNmeO9PrhF\nmtBVuf+6W6R7Hole5Kzp0vZ10uN3DWzbu1+adoX3OlLPfsq3ohcIAEAD2mdIXJIm1r4xden2lq7X\nC9abtni97tKjnmAtSTteqjx+4+PeQi2lXvXErvDjJUkTvlhfoQAA1MlcrftPJqynp8f19paNOZ86\nLO32ufC6StRLuhbOlq5fKM2ZIR09If1kt3Treulne2ofG2ko/Py+0Mu5zPzWkcmPtP/9tAJtmG20\nX/blvQ0l7XTO1Yxq7TUkLkmdtVc+C7J5tRegg4wdJU2bJF09r3L79helSz7fYKFcew0AaIH2C9iS\nN+N6Z/gvqtIEtM4O6d2qyWL1LKjieqWPXzDQm+6cKZ0+E7F3zcxwAECLtGfAliIFbWkgWDe66ln5\ncWdekE49HzEvgjUAoIXaa9JZtam1F/QuTRbzc8sS6ejTXm+59Di5w9vuZ8hFEYP11O9HSAQAQHza\nb9JZtYBednVgvXKO9OCdjddj8Upvxnm5wGHxOnrXeZ8skfa/n1agDbON9su+vLehMjvprNoMJ+0a\nIbl3Bu3qe1IaN7py28jZ0lsno2ffNUp68ylp463eQ5K+sUG6+S6fxFM3Sl2LomcOAEBM2j9gS9KF\n/RG4qrfdMUSaeoX0avjNO0MdOV7ZW//lI4N72pI4Zw0ASFV7n8OuVhY0Xa/00LbmgrWfcxd4121X\nDIcTrAEAKctGD7vcDCedOiLtHqdrL5euvTzBss4/1NR14QAAxCVbPeySzi4vcE9Zk0z+U9Z6+ROs\nAQBtIns97HITlnkPKdI12zUx9A0AaFPZ7GH7meEGHtOPDtq9wq8zfv4blccBANCmst3DDtIxZlAA\nXvV3KdUFAIAY5KeHDQBAjhGwAQDIAAI2AAAZQMAGACADUr/5h5nlenp22t9v0gqwKD9tmHG0X/YV\noA0j3fyDHjYAwNeYkZW3J3a90vKrB287Z1zaNS0GetgJS/v7TRq/7rMv721I+9Un8LbCdai+/XGz\nCtCG9LABALXddM1AbzkO5b1xxIcedsLS/n6TlvfemUQbZh3tF6xrlPTmUzFWJsDEP5YOHWn8+AK0\nYaQedj5XOgMAhIqrNx3FwS3ec9xD5UXDkDgAFEwrg3U7lJsXBGwAKIjfPJt+0HS90p99Kt06ZBUB\nGwAKwPVKw4Y2n88Ntzefx6bb0v/hkEVMOktY2t9v0vI+YUmiDbOO9pPe2SENH9ZkOT7nn5sNur99\nVxr+R7XTFaANuawLABAtWHfPle79of++oMlizU4ii6PHXyT0sBOW9vebtLz3ziTaMOuK3n61esFR\nes5hgblW2o9Ok356f/11qCgj/21IDxsAiqxWsP72ff7bG+05+x338p7ax3E+OxoCNgDkUHdX7TRL\n70i+HlK0HwDjRidfj6wjYANADh3aEl9eQT3gOHvGfU/Gl1desdIZAOTMn18z8DrsHLXrjT787Xql\nEyelUbOl489II0dEr8/6r0Srz7LF0jc3Rs+3aOhhA0DO3P4l7zkoGO87NPB61vTB+4N6zqUgHRSs\ng467bqH3/KsD/vtL9Vyzwn8/PARsACiYKfMHXm9fVxlow4a5P3yV9zzu0uA01XmVvz93QX31RCUC\nNgDkSLPnlV8/FLzvlde85yPHg9OE7YuCGePBCNgAUDDzZwXvmzw/eF8UYb3vBZc0l3fREbABIKdO\n7vDf/uja1taj5OE1/tvfeba19cgqAjYA5MTEcZXvzxrmDTGfVbY0aZQh5w0PN1b+Q9tqpykvf8Rw\n7/3wqiVKx49prPy8Y2nShKX9/SYt78taSrRh1hWp/cKC8ekzUufM4HTVM8qr05QfL0mHnxgcWGvl\nUZ7m2FZp9PuC61ueVwHakKVJAQCejiHNHT/04sr33XObyy8sWMMfARsACibKYimLVla+r9XJ/dzX\n4ikXwWIP2Gb2t2Z2yMx+GnfeAIDWuK/OpU3Xb06mHhiQRA97g6RPJ5AvACDE8tXR07a6t1tPefV8\njiKJPWA7556RdCTufAEA4VYvjze/L9wWLV3cd/2K+3PkBeewAaCgFiwL3/+dB7znbbv8929+xnsO\nuq92yZVVa4Rfe3ntumGwVAK2mS0xs14zYxE6AGiRqR+ofP/o9mjHzVniv/0zEXvC1ddn3/PVaMeh\nUioB2zn3XedcT5TrzgAA8fjx3YO3zVsafkxXyFKjkjT2E+H7l60K34/oGBIHgJwY/8nw/ZMmDN72\nWI1lQY/WuJnHsRPh+9c2cH/rsPXIiyyJy7o2SvqJpI+Y2T4z+z/iLgMAMNibv27suKRmjF91U2PH\nNXvHr7zqiDtD59ziuPMEAGTPD7amXYN8YUgcAApkYle65c88L93ys4ybfyQs7e83aXm/cYREG2Zd\nEduv1h25Gh0C/9iHvIC/d7/0i32N5dFI3QrQhpFu/hH7kDgAoL253uCgPX9Wc/fLvuwGactzweWi\ncQRsAMiZFWukVTeGpzm2VRozx3t9cIs0oWqo/LpbpHseiV7mrOnS9nXS43cNbNu7X5p2hff6QIS1\nyb8Y84ppecOQeMLS/n6TlvfhVIk2zLqitl+U3qz1DKTbtEVavDI8fT2+93Vp8WWDy6lVHz8FaMNI\nQ+IE7ISl/f0mLe//2Uu0YdYVtf3Gj5EOPxHh+IjnsxfOlq5fKM2ZIR09If1kt3Treulne2ofGyVY\nj7s0+HKuArQh57ABoKj6jjV+7ObVXoAOMnaUNG2SdPW8yu3bX5Qu+XxjZXLtdW30sBOW9vebtLz3\nziTaMOuK3n5Rh6I7O6R3nxu8ParqcjpnSqfPNDcU/l7e+W9DetgAUHRRzx+XgnWjl3yVH3fmBenU\n89HyavV9ubOMhVMAIOcW3Vw7jfUEB89blkhHn/YCf+lxcoe33c+Qi6IF4j/5cu00GMCQeMLS/n6T\nlvfhVIk2zDrazxPUy64OrFfOkR68s/H6LF7pzThvpOwgBWhDZom3g7S/36Tl/T97iTbMOtpvwNvb\npRHDq47vkfqelMaNrtw+crb01sno9egaJb35VOW2b2yQbr5rcMBedLN034+i512ANuQcNgBgwNkf\n956rA2jHEGnqFdKr+xvP+8jxyh7zLx8Z3NOWOGfdDM5hA0DBlAdN1ys9tK25YO3n3AXeddvlPw4I\n1s1hSDxhaX+/Scv7cKpEG2Yd7Rds7EjpyNMxViZA99zmrgsvQBtGGhKnhw0ABXX0hNfrXbYqmfyX\n3tF/jryJYI0B9LATlvb3m7S8984k2jDraL/6xHFHrbiHvgvQhvSwAQD1KV2PbT0Dd/Mqt2LN4G3n\nXFZ5HJJBDzthaX+/Sct770yiDbOO9su+ArQhPWwAAPKCgA0AQAYQsAEAyIDUVzqbMWOGentjmJbY\npvJ+finv55Yk2jDraL/sy3sbRkUPGwCADEi9hw0gR3bG0BOakf8eI9AIetgAmnPwDi9QxxGspYG8\nDia0/BaQUQRsAI059aYXWPd9OZn8993k5X/qYDL5AxnDkDiA+sXVm45i9zneM0PlKDh62ADq08pg\n3Q7lAm2CgA0gml3D0g+aO006sindOgApIWADqG2nSe7dprO54fYY6rJ3cfo/HIAUcA4bQLhdw5vO\novwOTn99v/fc9G0cdw2TLvxtk5kA2UEPG0A4Vzsods+V7v2h/76g2y02fRvGGHr8QJYQsAEEqzH0\nXLr/cd8x6bN/1XwQLr+nsvVI5/1pc/UD8oSADcBfjWD47fv8tzcatP2Oe3lPhAMJ2igIAjaAwU4f\nqplk6R0tqIci/gA43Zd4PYC0EbABDPbSxNiyCppc1vSks3IvdceYGdCemCUOoNIbA9de+fVuS4HW\n9UYf/na90omT0qjZ0vFnpJEjoldn/VcGXofVRwfWSOfcGD1jIGPoYQOotP8vJAUH431lo+Wzpg/e\nH9RzLgXpoGAddNx1C73nXx3w3/9ePV9f7p8AyAkCNoC6TJk/8Hr7uspAGzbM/eGrvOdxlwanqc6r\n/P25C+qrJ5A3BGwAA5qccf16yFy1V17zno8cD04Tti8SZowjxwjYAOoyf1bwvsnzg/dFEdb7XnBJ\nc3kDWUfABuDr5A7/7Y+ubW09Sh5e47/9nWdbWw8gLQRsAJ5TlbO6zhrmnUM+a9jAtiiXYm14uLHi\nH9pWO015+SOGe++HD61KdOpwYxUA2hwBG4Bn9/t9N5/cIZ163nsd5TKu6786eNvpM5Xv+44NTnPl\nitp5l8o/tlV6e3tAot0TamcEZBABG0BNHUOaO37oxZXvu+c2l9/o9zV3PJBFBGwAdYnSy160svK9\nc+HpP/e1eMoF8oyADSB2922pL/36zcnUA8iT2AO2mU0xs6fN7Odm9rKZfSnuMgDEb/nq6Glb3dut\np7x6PgeQJUn0sE9LWuGc+58lXSzpP5nZ7yVQDoAYrY55Zc8v3BYtXdx3/Yr7cwDtIvaA7Zx7wzm3\nq//1CUk/lzQp7nIApGvBsvD933nAe962y3//5me856D7apdUzx6/9vLadQPyKNFz2Gb2QUm/L+n5\nqu1LzKzXzHoPH+aaSSALpn6g8v2jQZdVVZmzxH/7ZyL2hKuvz77H57IxoAgSC9hm9j5JD0ha5pyr\nWCHYOfdd51yPc66nu5v72AJZ8OO7B2+btzT8mK6QpUYlaewnwvcvWxW+HyiSRAK2mXXKC9b3Ouf+\nIYkyAMRsevho1ySf9Ugeq7Es6NEaN/M4diJ8/9qN4ft9nd/XwEFA+0tilrhJWifp58455msCWdEx\nvqHDkpoxftVNDR7YOS7WegDtIoke9ixJ10i61Mxe7H80eQ8fAEXzg61p1wBoLx1xZ+ic2y6Jm9IC\nOTSxSzp4JL3yZ56XXtlA2ljpDMCAGeFriB6ocwWzch/7kDT3Iul3Jzeex3MbaiSoUX8gy2LvYQPI\nN9cbfN56/qzm7pd92Q3SlueCywWKjIANoNLkO6V94TO+jm2VxszxXh/cIk3oqtx/3S3SPY9EL3LW\ndGn7Ounxuwa27d0vTbvCex2pZz/lW9ELBDKIIXEAlSbWvjF16faWrtcL1pu2eL3u0qOeYC1JO16q\nPH7j495CLaVe9cSu8OMlSRO+WF+hQMaYq3Xfu4T19PS43t78jnV5V7nlV9r/flqhkG146rC02+fC\n6ypRL+laOFu6fqE0Z4Z09IT0k93Sreuln+2JUL8o/z2c3xd4OVch2y9n8t6GknY652r+NTEkDmCw\nzsZXINy82gvQQcaOkqZNkq6eV7l9+4vSJZ9vsFCuvUYBELAB+JvhpJ3hPZvSBLTODundqsli9Syo\n4nqlj18w0JvunCmdPhOxd83McBQEARtAsAhBWxoI1o2uelZ+3JkXpFPPR8yLYI0CYdIZgHBTay/o\nXZos5ueWJdLRp73eculxcoe33c+QiyIG66nfj5AIyA8mnSUs75Ml0v730wq0oQJ72dWB9co50oN3\nNl6XxSu9GeflAofFI/auab/sy3sbiklnAGIzw0m7RkjunUG7+p6Uxo2u3DZytvTWyejZd42S3nxK\n2nir95Ckb2yQbr7LJ/HUjVLXouiZAzlBwAYQzYX9Ebiqt90xRJp6hfTq/sazPnK8srf+y0cG97Ql\ncc4ahcY5bAD1KQuarld6aFtzwdrPuQu867YrhsMJ1ig4etgA6jfDSaeOSLvH6drLpWsvT7Cs8w81\ndV04kBf0sAE0prPLC9xT1iST/5S1Xv4Ea0ASPWwAzZqwzHtIka7Zromhb8AXPWwA8ZnhBh7Tjw7a\nvcKvM37+G5XHAfBFDxtAMjrGDArAq/4upboAOUAPGwCADCBgAwCQAQRsAAAygIANAEAGpH7zDzPL\n9bTQtL/fpBVgUX7aMONov+wrQBty8w8AAAKdOSq92FWxacUaadWNVenO3y91vr919QpADzthaX+/\nSePXffblvQ1pv+yLtQ3bcHGfqD1szmEDAPLt4B1eoI4jWEsDeR1cFU9+EdHDTlja32/S+HWffXlv\nQ9ov+xpuw1NvSrvHx1sZP+cfkDonNnw457ABAMUVV286it3neM8JL63LkDgAIF9aGaxbWC4BGwCQ\nD7uGpResS3aadGRTIlkTsAEA2bfTJPdu09nccHsMddm7OJEfDkw6S1ja32/SmPCSfXlvQ9ov+2q2\n4a7hkvttU2WYz5Qv19tUlpINlS6sXS8u6wIAFEOEYN09V7r3h/77/IJ12PbIYujxl6OHnbC0v9+k\n8es++/LehrRf9oW2YY2h5yg957DAXCvtR6dJP70/tAo1Z4/TwwYA5FuNYP3t+/y3N9pz9jvu5T0R\nDozpfDYBGwCQPacP1Uyy9I4W1EMRfwCc7mu6HAI2ACB7Xmp8ZbFqQZPLmp50Vu6l7qazYKUzAEC2\nvDFw7VXYOWrXG3342/VKJ05Ko2ZLx5+RRo6IXp31Xxl4HXrO/MAa6ZzqW4FFRw8bAJAt+/9CUnAw\n3lc2Wj5r+uD9QT3nUpAOCtZBx1230Hv+1QH//e/V8/Xl/gkiImADAHJlyvyB19vXVQbasGHuD1/l\nPY+7NDhNdV7l789dUF8960XABgBkR5Mzrl8Pmav2ymve85HjwWnC9kXSRP0J2ACAXJk/K3jf5PnB\n+6II630vuKS5vGshYAMAMunkDv/tj65tbT1KHl7jv/2dZ+PJn4ANAMiGU5Wzus4a5p1DPmvYwLYo\nl2JteLix4h/aVjtNefkjhnvvhw+tSnTqcEPlszRpwtL+fpNW+GURcyDvbUj7Zd97bRhy/vf0Galz\nZn96n6BdPaO8Ok358ZJ0+Alp/Jj68ihPc2yrNPp9gdWtWK6UpUkBAIXRMaS544deXPm+e25z+YUG\n6wYRsAEAuRJlsZRFKyvf1xqI+dzX4im3GbEHbDMbbmYvmNlLZvaymX017jIAAGjGfVvqS79+czL1\nqEcSPezfSrrUOTdd0gWSPm1mF9c4BgCAUMtXR0+bdG+3mfLq+RzlYg/YzvNW/9vO/ke+Z30AABK3\nurmVPQf5wm3R0sV9169GP0ci57DNbIiZvSjpkKQfOeeer9q/xMx6zSzOe6EAAPCeBcvC93/nAe95\n2y7//Zuf8Z6D7qtdcuWKyvfXXl67bo1I9LIuMxsj6UFJX3TO/TQgTa5731xSkn20YbbRftkX5bIu\nSZp2hbR3f9Wx/d3CoCHrWnf0CtsflHek23K222VdzrljkrZK+nSS5QAA8OO7B2+btzT8mK6QpUYl\naewnwvcvWxW+P05JzBLv7u9Zy8zOkjRX0r/GXQ4AoGCmh68QNmnC4G2P1VgW9GiNm3kcOxG+f+3G\n8P2+zu9r4CCpo6Gjwr1f0j1mNkTeD4L7nXOPJFAOAKBIOsY3dFhSM8avuqnBAzvHNXRY7AHbObdb\n0u/HnS8AAO3kB1tbWx4rnQEAcmNiV7rlzzwvuby5+UfC0v5+k1aoGao5lfc2pP2yb1Ab1pgt3ugQ\n+Mc+5AX8vfulX+xrLI+aM8RnDP73GHWWeBLnsAEASE3YpVjzZzV3v+zLbpC2PBdcbpII2ACAbJl8\np7QvfMbXsa3SmDne64NbpAlVQ+XX3SLdU8d06FnTpe3rpMfvGti2d7937bckHYiyNvmUb0Uv0AdD\n4glL+/tNWiGH43Im721I+2WfbxvWGBaXvF52qde7aYu0eGV4+np87+vS4ssGlxPKZzhcij4kTsBO\nWNrfb9IK+59FjuS9DWm/7PNtw1OHpd0+F15XiXo+e+Fs6fqF0pwZ0tET0k92S7eul362J0L9ogTr\n8/sCL+fiHDYAIL86uxs+dPNqL0AHGTtKmjZJunpe5fbtL0qXfL7BQhu89rocPeyEpf39Jq2wv+5z\nJO9tSPtlX2gbRhwa7+yQ3n1u8PbIdajqRXfOlE6faW4o/L160MMGAOTeDBcpaJeCdaOXfJUfd+YF\n6dTzEfOqEazrwcIpAIBsm1pjBNUvAAAgAElEQVR7QW/rCQ6wtyyRjj7t9ZZLj5M7vO1+hlwUMVhP\n/X6ERNExJJ6wtL/fpBV+OC4H8t6GtF/2RWrDgF52dWC9co704J2N12XxSm/GebnAYfGIvWtmibeJ\ntL/fpPGfRfblvQ1pv+yL3Ia7RkjunYpN1iP1PSmNG12ZdORs6a2T0evQNUp686nKbd/YIN18l0/A\nnrpR6loUOW/OYQMAiuXC/ghc1dvuGCJNvUJ6dX/jWR85Xtlb/+Ujg3vakmI9Z12Nc9gAgHwpC5qu\nV3poW3PB2s+5C7zrtit61wkGa4kh8cSl/f0mjeG47Mt7G9J+2ddwG546Iu1u/vrnms4/1NR14VGH\nxOlhAwDyqbPL6/VOWZNM/lPWevk3EazrQQ87YWl/v0nj13325b0Nab/si7UNI1yzXVPMQ9/0sAEA\nqDbDDTymHx20e4VfZ/z8NyqPSwk97ISl/f0mjV/32Zf3NqT9sq8AbUgPGwCAvCBgAwCQAQRsAAAy\nIPWVzmbMmKHe3ij3J8umvJ9fyvu5JYk2zDraL/vy3oZR0cMGACADUu9hI7pIN0qvodF7wQIA0kUP\nu83ddM3A/VnjUMpr+dXx5AcAaA0CdpvqGuUF1ju+lEz+q2708p/QlUz+AIB4MSTehuLqTUdxsP/2\ncAyVA0B7o4fdZloZrNuhXABANATsNvGbZ9MPmq5X+rNPpVsHAIA/AnYbcL3SsKHN53PD7c3nsem2\n9H84AAAG4xx2yt7Z0Xwe5eef//p+77nZoPubZ6Xhf9RcHgCA+NDDTtnwYbXTdM+V7v2h/76gyWLN\nTiKLo8cPAIgPATtFtXrB1uM9+o5Jn/2r5oNwKb/S47w/ba5+AIDWIWCnpFYw/PZ9/tsbDdp+x728\np/ZxBG0AaA8E7BR0R1isZOkdyddDivYDYNzo5OsBAAhHwE7BoS3x5RXUA46zZ9z3ZHx5AQAawyzx\nFvvzawZe+/VuS4HW9UYf/na90omT0qjZ0vFnpJEjotdn/Vei1WfZYumbG6PnCwCIFz3sFru9f23w\noGC879DA61nTB+8P6jmXgnRQsA467rqF3vOvDvjvL9VzzQr//QCA1iBgt5kp8wdeb19XGWjDhrk/\nfJX3PO7S4DTVeZW/P3dBffUEALQWAbuFmj2v/Pqh4H2vvOY9HzkenCZsXxTMGAeA9BCw28z8WcH7\nJs8P3hdFWO97wSXN5Q0ASBYBOyUnA5YkfXRta+tR8vAa/+3vPNvaegAA/BGwW2TiuMr3Zw3zhpjP\nKluaNMqQ84aHGyv/oW2105SXP2K493541RKl48c0Vj4AoDkE7BY58Lj/9pM7pFPPe6+jXMZ1/VcH\nbzt9pvJ937HBaa6MMMu7VP6xrdLb2/3THH6idj4AgPgRsNtAx5Dmjh96ceX77rnN5Tf6fc0dDwCI\nHwG7zUTpZS9aWfneufD0n/taPOUCANKTSMA2syFm9s9m9kgS+RfdfXUubbp+czL1AAC0TlI97C9J\n+nlCeWfS8tXR07a6t1tPefV8DgBAfGIP2GY2WdLlku6OO+8sW7083vy+cFu0dHHf9SvuzwEAiCaJ\nHvY3JX1Z0v8ISmBmS8ys18x6Dx8+nEAVsm/BsvD933nAe962y3//5me856D7apdUzx6/9vLadQMA\ntF6sAdvMFkg65JzbGZbOOfdd51yPc66nu7s7zipk1tQPVL5/NOCyqmpzlvhv/0zEnnD19dn3+Fw2\nBgBIX9w97FmSrjCzVyVtknSpmf1dzGXk0o99TiDMWxp+TFfIUqOSNPYT4fuXrQrfDwBoH7EGbOfc\nzc65yc65D0paJOkp59xn4ywjq8Z/Mnz/pAmDtz1WY1nQozVu5nHsRPj+tQ3c3zpsPXIAQHK4DrtF\n3vx1Y8clNWP8qpsaO67ZO34BABrTkVTGzrmtkrYmlT+a84OtadcAAFAPethtZGJXuuXPPC/d8gEA\nwQjYLVRrePtAnSuYlfvYh6S5F0m/O7nxPJ7bEL6f5UsBID2JDYmjMa43ODDOn9Xc/bIvu0Ha8lxw\nuQCA9kXAbrEVa6RVN4anObZVGjPHe31wizShaqj8uluke+pYpX3WdGn7Ounxuwa27d0vTbvCex2l\nZ//FmFdMAwDUx1ytWz0lrKenx/X25rd7Z2aDtkXpzVrPQLpNW6TFK8PT1+N7X5cWXza4nFr18ZP2\nv59W8GvDPMl7G9J+2Zf3NpS00zlX86QjATthfv/Qxo+RDj8R4diI54wXzpauXyjNmSEdPSH9ZLd0\n63rpZ3tqHxslWI+7NPhyrrT//bRC3v+zyHsb0n7Zl/c2VMSAzZB4CvqONX7s5tVegA4ydpQ0bZJ0\n9bzK7dtflC75fGNlcu01AKSPgJ2SKEPRpQlonR3Su1WTxeqZse16pY9fMFBe50zp9JnmhsIBAK1F\nwE5R1PPHpWDdaPAsP+7MC9Kp56PlRbAGgPbBddgpW3Rz7TTWExw8b1kiHX3aC/ylx8kd3nY/Qy6K\nFoj/5Mu10wAAWodJZwmLMlkiqJddHVivnCM9eGfjdVm80ptx3kjZQdL+99MKeZ/wkvc2pP2yL+9t\nKCadZYf1SG9vl0YMH7yv70lp3OjKbSNnS2+djJ5/1yjpzaekjbd6D0n6xgbp5rsGp110s3Tfj6Ln\nDQBoDQJ2mzj7495zdY+3Y4g09Qrp1f2N533keGWP+ZePDO5pS5yzBoB2xjnsNlMeNF2v9NC25oK1\nn3MXeNdtl/84IFgDQHujh92GrEcaO1I68rR07eXeIyndc5u7LhwA0Br0sNvU0RNe4F62Kpn8l97h\n5U+wBoBsoIfd5tZu9B5SPHfUYugbALKJHnaGlK7Htp6Bu3mVW7Fm8LZzLqs8DgCQTfSwM+rXb/kH\n4NX3tr4uAIDk0cMGACADCNgAAGQAARsAgAxIfS1xM8v1Qrhpf79JK8Aav7RhxtF+2VeANoy0ljg9\nbAAAMoBZ4kCr7IyhJzQj3z0NAMHoYQNJOniHF6jjCNbSQF4HE1oCD0Db4hx2wtL+fpPG+bMAp96U\ndo+PvzLVzj8gdU5sKou8tyF/g9lXgDbkfthAKuLqTUex+xzvmaFyIPcYEgfi1Mpg3Q7lAmgZAjYQ\nh13D0g+aO006sindOgBIDAEbaNZOk9y7TWdzw+0x1GXv4vR/OABIBJPOEpb295u0wk942TVccr9t\nKn+/m7g0fStVGypdGK1eeW9D/gazrwBtyMIpQOIiBOvuudK9P/TfF3TL06ZvhRpDjx9Ae6GHnbC0\nv9+kFfrXfY2h5yg957DAXCvtR6dJP70/tAqRZo/nvQ35G8y+ArQhPWwgMTWC9bfv89/eaM/Z77iX\n90Q4kPPZQG4QsIF6nT5UM8nSO1pQD0X8AXC6L/F6AEgeARuo10vNrSxWLmhyWdOTzsq91B1jZgDS\nwkpnQD3eGLj2KuwcteuNPvzteqUTJ6VRs6Xjz0gjR0SvzvqvDLwOPWd+YI10zo3RMwbQduhhA/XY\n/xeSgoPxvrLR8lnTB+8P6jmXgnRQsA467rqF3vOvDvjvf6+ery/3TwAgMwjYQIymzB94vX1dZaAN\nG+b+8FXe87hLg9NU51X+/twF9dUTQPYQsIGompxx/XrIXLVXXvOejxwPThO2LxJmjAOZRsAGYjR/\nVvC+yfOD90UR1vtecElzeQNofwRsoAEnd/hvf3Rta+tR8vAa/+3vPNvaegBIDgEbiOJU5ayus4Z5\n55DPGjawLcqlWBsebqz4h7bVTlNe/ojh3vvhQ6sSnTrcWAUApI6lSROW9vebtMIsixhy/vf0Galz\nZn9an6BdPaO8Ok358ZJ0+Alp/Jj68ihPc2yrNPp9gdUdtFxp3tuQv8HsK0AbsjQp0AodQ5o7fujF\nle+75zaXX2iwBpBZBGwgRlEWS1m0svJ9rc7D574WT7kAsi2RgG1mr5rZv5jZi2YW5yKLQObdt6W+\n9Os3J1MPANmSZA/7E865C6KMywPtbvnq6Glb3dutp7x6PgeA9sKQOBDB6phX9vzCbdHSxX3Xr7g/\nB4DWSSpgO0lbzGynmS2p3mlmS8ysl+Fy5NWCZeH7v/OA97xtl//+zc94z0H31S65ckXl+2svr103\nANmUyGVdZvYB59x+M5sg6UeSvuiceyYgba7n6xfgcoS0q5C4Wpd1SdK0K6S9+6uO6/85GjRkXeuO\nXmH7g/KOdFtOLuvKlby3n1SINkzvsi7n3P7+50OSHpR0URLlAO3ix3cP3jZvafgxXSFLjUrS2E+E\n71+2Knw/gHyJPWCb2dlmNrL0WtIfS/pp3OUALTU9fIWwSRMGb3usxrKgR2vczOPYifD9azeG7/d1\nfl8DBwFoBx0J5DlR0oP9wzQdkr7nnHssgXKA1ukY39BhSc0Yv+qmBg/sHBdrPQC0TuwB2zm3R9L0\nuPMFMOAHW9OuAYBW47IuICYTu9Itf+Z56ZYPIFnc/CNhaX+/SSvcDNUas8UbHQL/2Ie8gL93v/SL\nfY3lUXOG+Az/f4t5b0P+BrOvAG0YaZZ4EuewgcIKuxRr/qzm7pd92Q3SlueCywWQbwRsoB6T75T2\nhc/4OrZVGjPHe31wizShaqj8ulukex6JXuSs6dL2ddLjdw1s27vfu/Zbkg5EWZt8yreiFwigLTEk\nnrC0v9+kFXI4rsawuOT1sku93k1bpMUrw9PX43tflxZfNricUAHD4VL+25C/wewrQBtGGhInYCcs\n7e83aYX8z+LUYWm3z4XXVaKez144W7p+oTRnhnT0hPST3dKt66Wf7YlQtyjB+vy+0Mu58t6G/A1m\nXwHakHPYQCI6uxs+dPNqL0AHGTtKmjZJunpe5fbtL0qXfL7BQrn2GsgFetgJS/v7TVqhf91HHBrv\n7JDefW7w9sjlV/WiO2dKp880PxT+Xl1y3ob8DWZfAdqQHjaQqBm1bwoiDQTrRi/5Kj/uzAvSqecj\n5hUhWAPIDhZOAZoxtfaC3tYTHGBvWSIdfdrrLZceJ3d42/0MuShisJ76/QiJAGQJQ+IJS/v7TRrD\ncQrsZVcH1ivnSA/e2Xg9Fq/0ZpxX1C1oWLyO3nXe25C/wewrQBsyS7wdpP39Jo3/LPrtGiG5dyo2\nWY/U96Q0bnRl0pGzpbdORi+/a5T05lOV276xQbr5Lp+APXWj1LUoeubKfxvyN5h9BWhDzmEDLXNh\nfwSu6m13DJGmXiG9ur/xrI8cr+yt//KRwT1tSZyzBnKOc9hAnMqCpuuVHtrWXLD2c+4C77rtit41\nwRrIPYbEE5b295s0huMCnDoi7W7B9c/nH2rqunAp/23I32D2FaANIw2J08MGktDZ5fV6p6xJJv8p\na738mwzWALKDHnbC0v5+k8av+zpEuGa7pgSGvvPehvwNZl8B2pAeNtBWZriBx/Sjg3av8OuMn/9G\n5XEACosedsLS/n6Txq/77Mt7G9J+2VeANqSHDQBAXhCwAQDIAAI2AAAZkPpKZzNmzFBvb5T7BGZT\n3s8v5f3ckkQbZh3tl315b8Oo6GEDAJABBGwAADIg9SFxAMiKwNuZ1iHS/cwBH/SwASDETdd4gTqO\nYC0N5LX86njyQ3EQsAHAR9coL7De8aVk8l91o5f/hK5k8kf+MCQOAFXi6k1HcbD/3uYMlaMWetgA\nUKaVwbodykV2ELABQNJvnk0/aLpe6c8+lW4d0L4I2AAKz/VKw4Y2n88Ntzefx6bb0v/hgPbEOWwA\nhfbOjubzKD///Nf3e8/NBt3fPCsN/6Pm8kC+0MMGUGjDh9VO0z1XuveH/vuCJos1O4ksjh4/8oWA\nDaCwavWCrcd79B2TPvtXzQfhUn6lx3l/2lz9UCwEbACFVCsYfvs+/+2NBm2/417eU/s4gjZKCNgA\nCqc7wmIlS+9Ivh5StB8A40YnXw+0PwI2gMI5tCW+vIJ6wHH2jPuejC8vZBezxAEUyp9fM/Dar3db\nCrSuN/rwt+uVTpyURs2Wjj8jjRwRvT7rvxKtPssWS9/cGD1f5A89bACFcnv/2uBBwXjfoYHXs6YP\n3h/Ucy4F6aBgHXTcdQu9518d8N9fqueaFf77URwEbAAoM2X+wOvt6yoDbdgw94ev8p7HXRqcpjqv\n8vfnLqivnigeAjaAwmj2vPLrh4L3vfKa93zkeHCasH1RMGO82AjYAFBm/qzgfZPnB++LIqz3veCS\n5vJG/hGwARTSyYAlSR9d29p6lDy8xn/7O8+2th5oXwRsAIUwcVzl+7OGeUPMZ5UtTRplyHnDw42V\n/9C22mnKyx8x3Hs/vGqJ0vFjGisf2UfABlAIBx73335yh3Tqee91lMu4rv/q4G2nz1S+7zs2OM2V\nEWZ5l8o/tlV6e7t/msNP1M4H+UTABlB4HUOaO37oxZXvu+c2l9/o9zV3PPIpkYBtZmPM7O/N7F/N\n7Odm9odJlAMAcYvSy160svK9c+HpP/e1eMpFsSXVw14r6THn3L+TNF3SzxMqBwBa7r46lzZdvzmZ\neqBYYg/YZjZK0mxJ6yTJOfeuc87njA4AtM7y1dHTtrq3W0959XwO5EsSPexpkg5LWm9m/2xmd5vZ\n2QmUAwCRrV4eb35fuC1aurjv+hX350B2JBGwOyRdKOlvnHO/L+ltSX9ZnsDMlphZr5n1Hj58OIEq\nAEBzFiwL3/+dB7znbbv8929+xnsOuq92SfXs8Wsvr103FFMSAXufpH3Ouf4LJfT38gL4e5xz33XO\n9Tjnerq7uxOoAgDUZ+oHKt8/GnBZVbU5S/y3fyZiT7j6+ux7fC4bA6QEArZz7oCk18zsI/2bPinp\nZ3GXAwBx+vHdg7fNWxp+TFfIUqOSNPYT4fuXrQrfD5RLapb4FyXda2a7JV0g6daEygGASMZ/Mnz/\npAmDtz1WY1nQozVu5nHsRPj+tQ3c3zpsPXLkW0cSmTrnXpTEVYUA2sabv27suKRmjF91U2PHNXvH\nL2QXK50BQAp+sDXtGiBrCNgA0G9iV7rlzzwv3fLR3gjYAAqj1vD2gTpXMCv3sQ9Jcy+Sfndy43k8\ntyF8P8uXFlsi57ABIKtcb3BgnD+ruftlX3aDtOW54HKBMARsAIWyYo206sbwNMe2SmPmeK8PbpEm\nVA2VX3eLdM8j0cucNV3avk56/K6BbXv3S9Ou8F5H6dl/MeYV05A95mrdZiZhPT09rrc3vz8tzSzt\nKiQq7X8/rUAbZptf+0XpzVrPQLpNW6TFK8PT1+N7X5cWXza4nFr18ZP39pPy/zcoaadzruYJDwJ2\nwvL+Dy3tfz+tQBtmm1/7jR8jHX4iwrERzxkvnC1dv1CaM0M6ekL6yW7p1vXSz/bUPjZKsB53afDl\nXHlvPyn/f4OKGLAZEgdQOH1N3D9w82ovQAcZO0qaNkm6el7l9u0vSpd8vrEyufYaEgEbQEFFGYou\nTUDr7JDerZosVs+MbdcrffyCgfI6Z0qnzzQ3FI7iIWADKKyo549LwbrR4Fl+3JkXpFPPR8uLYI1y\nXIcNoNAW3Vw7jfUEB89blkhHn/YCf+lxcoe33c+Qi6IF4j/5cu00KBYmnSUs75Ml0v730wq0YbZF\nab+gXnZ1YL1yjvTgnY3XZfFKb8Z5I2UHyXv7Sfn/GxSTzgAgGuuR3t4ujRg+eF/fk9K40ZXbRs6W\n3joZPf+uUdKbT0kbb/UekvSNDdLNdw1Ou+hm6b4fRc8bxUHABgBJZ3/ce67u8XYMkaZeIb26v/G8\njxyv7DH/8pHBPW2Jc9YIxzlsAChTHjRdr/TQtuaCtZ9zF3jXbZf/OCBYoxZ62ABQxXqksSOlI09L\n117uPZLSPbe568JRHPSwAcDH0RNe4F62Kpn8l97h5U+wRlT0sAEgxNqN3kOK545aDH2jUfSwASCi\n0vXY1jNwN69yK9YM3nbOZZXHAY2ihw0ADfj1W/4BePW9ra8LioEeNgAAGUDABgAgAwjYAABkQOpr\niZtZrhfCTfv7TVoB1vilDTOO9su+ArRhpLXE6WEDAJABzBJH2+AaVwAIRg8bqbrpmoF7CMehlNfy\nq+PJDwDaBeewE5b295u0Rs+flW43mLSJfywdOtJcHrRhttF+2VeANuR+2GhPcfWmozjYfwtDhsoB\nZB1D4mipVgbrdigXAOJCwEZL/ObZ9IOm65X+7FPp1gEAGkXARuJcrzRsaPP53HB783lsui39Hw4A\n0AgmnSUs7e83abUmvLyzQxo+rMkyfM4/Nxt0f/uuNPyPoqUtehtmHe2XfQVoQxZOQfqiBOvuudK9\nP/TfFzRZrNlJZHH0+AGglehhJyzt7zdpYb/ua/WCo/ScwwJzrbQfnSb99P766zConAK3YR7QftlX\ngDakh4301ArW377Pf3ujPWe/417eU/s4zmcDyAoCNmLX3VU7zdI7kq+HFO0HwLjRydcDAJpFwEbs\nDm2JL6+gHnCcPeO+J+PLCwCSwkpniNWfXzPwOuwcteuNPvzteqUTJ6VRs6Xjz0gjR0Svz/qvRKvP\nssXSNzdGzxcAWo0eNmJ1+5e856BgvO/QwOtZ0wfvD+o5l4J0ULAOOu66hd7zrw747y/Vc80K//0A\n0C4I2GipKfMHXm9fVxlow4a5P3yV9zzu0uA01XmVvz93QX31BIB2Q8BGbJo9r/z6oeB9r7zmPR85\nHpwmbF8UzBgH0M4I2Gip+bOC902eH7wvirDe94JLmssbANJGwEYiTu7w3/7o2tbWo+ThNf7b33m2\ntfUAgEYRsBGLieMq3581zBtiPqtsadIoQ84bHm6s/Ie21U5TXv6I4d774VVLlI4f01j5AJA0liZN\nWNrfb9JKyyKGBePTZ6TOmQpMVz2jvDpN+fGSdPiJwYG1Vh7laY5tlUa/L7i+g/IqSBvmFe2XfQVo\nQ5YmRXvoGNLc8UMvrnzfPbe5/MKCNQC0KwI2WirKYimLVla+r/Xj+nNfi6dcAGhnsQdsM/uImb1Y\n9jhuZsviLgf5dV+dS5uu35xMPQCgncQesJ1z/+acu8A5d4GkGZJOSnow7nLQXpavjp621b3desqr\n53MAQCslPST+SUm/cM79MuFykLLVy+PN7wu3RUsX912/4v4cABCXpAP2IkmDbqlgZkvMrNfMWFuq\noBbUOEnynQe85227/PdvfsZ7DrqvdsmVVWuEX3t57boBQDtK7LIuMxsqab+kjzrnDoaky/V8/QJc\njiCp9jXW066Q9u6v3FY6JmjIutYdvcL2B+Ud5VpwLuvKF9ov+wrQhqlf1jVP0q6wYI3i+PHdg7fN\nWxp+TFfIUqOSNPYT4fuXrQrfDwBZkmTAXiyf4XDk0/hPhu+fNGHwtsdqLAt6tMbNPI6dCN+/toF/\nfWHrkQNAmhIJ2GY2QtKnJP1DEvmj/bz568aOS2rG+FU3NXZcs3f8AoCkdCSRqXPupKRxNRMCCfnB\n1rRrAADxYqUztMzErnTLn3leuuUDQDO4+UfC0v5+k1Y9Q7XWLOxGh8A/9iEv4O/dL/1iX2N5NFq3\norVh3tB+2VeANow0SzyRIXEgSNilWPNnNXe/7MtukLY8F1wuAGQZARuxWrFGWnVjeJpjW6Uxc7zX\nB7dIE6qGyq+7RbrnkehlzpoubV8nPX7XwLa9+71rvyXpQIS1yb8Y84ppABA3hsQTlvb3mzS/4bio\ni5OU0m3aIi1eGZ6+Ht/7urT4ssHl1KpPkCK2YZ7QftlXgDaMNCROwE5Y2t9v0vz+sxg/Rjr8RIRj\nI57PXjhbun6hNGeGdPSE9JPd0q3rpZ/tqX1slGA97tLwy7mK2IZ5QvtlXwHakHPYSEffscaP3bza\nC9BBxo6Spk2Srp5XuX37i9Iln2+sTK69BpAF9LATlvb3m7SwX/dRh6I7O6R3nxu8ParqcjpnSqfP\nND8U/l7+BW7DPKD9sq8AbUgPG+mKev64FKwbveSr/LgzL0inno+WV6vvyw0AzWDhFCRq0c2101hP\ncPC8ZYl09Gkv8JceJ3d42/0MuShaIP6TL9dOAwDthCHxhKX9/SYtynBcUC+7OrBeOUd68M7G67J4\npTfjvJGyw9CG2Ub7ZV8B2pBZ4u0g7e83aVH/s3h7uzRieNWxPVLfk9K40ZXbR86W3joZvQ5do6Q3\nn6rc9o0N0s13DQ7Yi26W7vtR9Lwl2jDraL/sK0Abcg4b7ePsj3vP1QG0Y4g09Qrp1f2N533keGWP\n+ZePDO5pS5yzBpBtnMNGS5UHTdcrPbStuWDt59wF3nXb5T8OCNYAso4h8YSl/f0mrdHhuLEjpSNP\nx1wZH91zm7suXKINs472y74CtGGkIXF62EjF0RNer3fZqmTyX3pH/znyJoM1ALQLetgJS/v7TVqc\nv+7juKNWEkPftGG20X7ZV4A2pIeNbCldj209A3fzKrdizeBt51xWeRwA5BU97ISl/f0mjV/32Zf3\nNqT9sq8AbUgPGwCAvCBgAwCQAQRsAAAyoB1WOuuT9MsWlje+v8yWSOn8Uks/Ywry3oa0X4xov9i1\n/PMVoA3PjZIo9UlnrWZmvVFO7mdZ3j8jny/b+HzZlvfPJ7XvZ2RIHACADCBgAwCQAUUM2N9NuwIt\nkPfPyOfLNj5ftuX980lt+hkLdw4bAIAsKmIPGwCAzCFgAwCQAYUK2Gb2aTP7NzN7xcz+Mu36xMnM\n/tbMDpnZT9OuSxLMbIqZPW1mPzezl83sS2nXKW5mNtzMXjCzl/o/41fTrlPczGyImf2zmT2Sdl2S\nYGavmtm/mNmLZhbD/efai5mNMbO/N7N/7f9b/MO06xQXM/tIf7uVHsfNbFna9SpXmHPYZjZE0v8n\n6VOS9kn6J0mLnXM/S7ViMTGz2ZLekvTfnHPnpV2fuJnZ+yW93zm3y8xGStop6cq8tJ8kmbc6xNnO\nubfMrFPSdklfcs49l3LVYmNmyyX1SBrlnFuQdn3iZmavSupxzuVy4RQzu0fSj51zd5vZUEkjnHO5\nu+t8f7x4XdJM51wrF/YKVaQe9kWSXnHO7XHOvStpk6TPpFyn2DjnnpF0JO16JMU594Zzblf/6xOS\nfi5pUrq1ipfzvNX/tl2ok/MAAAJgSURBVLP/kZtf1GY2WdLlku5Ouy6on5mNkjRb0jpJcs69m8dg\n3e+Tkn7RTsFaKlbAniTptbL3+5Sz//CLwsw+KOn3JT2fbk3i1z9k/KKkQ5J+5JzL02f8pqQvS/of\naVckQU7SFjPbaWZL0q5MzKZJOixpff9pjbvN7Oy0K5WQRZI2pl2JakUK2H6L0eam91IUZvY+SQ9I\nWuacO552feLmnDvjnLtA0mRJF5lZLk5vmNkCSYecczvTrkvCZjnnLpQ0T9J/6j9VlRcdki6U9DfO\nud+X9LakXM0FkqT+of4rJH0/7bpUK1LA3idpStn7yZL2p1QXNKD/vO4Dku51zv1D2vVJUv9Q41ZJ\nn065KnGZJemK/nO8myRdamZ/l26V4uec29//fEjSg/JOxeXFPkn7ykZ9/l5eAM+beZJ2OecOpl2R\nakUK2P8k6cNmNrX/F9QiSZtTrhMi6p+QtU7Sz51zq9OuTxLMrNvMxvS/PkvSXEn/mm6t4uGcu9k5\nN9k590F5f3tPOec+m3K1YmVmZ/dPiFT/UPEfS8rNVRvOuQOSXjOzj/Rv+qSk3Ez6LLNYbTgcLrXH\n7TVbwjl32sxukPS4pCGS/tY593LK1YqNmW2UNEfSeDPbJ+krzrl16dYqVrMkXSPpX/rP8UrSSufc\nP6ZYp7i9X9I9/TNUf0fS/c65XF7+lFMTJT3YfyvIDknfc849lm6VYvdFSff2d3r2SLo+5frEysxG\nyLuS6D+mXRc/hbmsCwCALCvSkDgAAJlFwAYAIAMI2AAAZAABGwCADCBgAwCQAQRsAAAygIANAEAG\n/P+uMuaa/akHvAAAAABJRU5ErkJggg==\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "plot_NQueens(ucs)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "`depth_first_tree_search` is almost 20 times faster than `breadth_first_tree_search` and more than 200 times faster than `uniform_cost_search`." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can also solve this problem using `astar_search` with a suitable heuristic function. \n", + "
\n", + "The best heuristic function for this scenario will be one that returns the number of conflicts in the current state." + ] + }, + { + "cell_type": "code", + "execution_count": 91, + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "\n", + "\n", + "\n", + "\n", + " \n", + " \n", + " \n", + "\n", + "\n", + "

\n", + "\n", + "
    def h(self, node):\n",
+       "        """Return number of conflicting queens for a given node"""\n",
+       "        num_conflicts = 0\n",
+       "        for (r1, c1) in enumerate(node.state):\n",
+       "            for (r2, c2) in enumerate(node.state):\n",
+       "                if (r1, c1) != (r2, c2):\n",
+       "                    num_conflicts += self.conflict(r1, c1, r2, c2)\n",
+       "\n",
+       "        return num_conflicts\n",
+       "
\n", + "\n", + "\n" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "psource(NQueensProblem.h)" + ] + }, + { + "cell_type": "code", + "execution_count": 92, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "8.85 ms ± 424 µs per loop (mean ± std. dev. of 7 runs, 100 loops each)\n" + ] + } + ], + "source": [ + "%%timeit\n", + "astar_search(nqp)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "`astar_search` is faster than both `uniform_cost_search` and `breadth_first_tree_search`." + ] + }, + { + "cell_type": "code", + "execution_count": 93, + "metadata": { + "collapsed": true + }, + "outputs": [], + "source": [ + "astar = astar_search(nqp).solution()" + ] + }, + { + "cell_type": "code", + "execution_count": 94, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAewAAAHwCAYAAABkPlyAAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMS4wLCBo\ndHRwOi8vbWF0cGxvdGxpYi5vcmcvpW3flQAAIABJREFUeJzt3X+4FdWd7/nP93IOIIZfBw6YAGOg\nkyczHSO2nBa7iQwxpA0IRmd6umGMXs1kuJO5hqDY6Zbn6Scmz41mVCB07OncXGnw3jagaduI2lGi\nEQwYtQ+00jHpnseAiYj8OMIJKCYCd80fdbZn/6iqXWfvql27qt6v59nP3rtq1Vpr73Xgu9eqVavM\nOScAANDe/l3aFQAAAPURsAEAyAACNgAAGUDABgAgAwjYAABkAAEbAIAMIGADAJABBGwAADKAgA20\nGTP7oJn9o5kdM7ODZna3mXWEpB9nZn8zkPakmf2Lmf37VtYZQPII2ED7+X8lHZb0fkkXSPqfJf3f\nfgnNbLikJyWdK+kPJI2V9GeS7jCz5S2pLYCWIGAD7We6pAecc79xzh2U9LikjwakvUbS/yDpf3PO\n7XPOnXLOPS5puaT/ZGajJcnMnJl9qHSQmW00s/9U9n6Rmb1oZv1m9qyZnV+27wNm9qCZHTGzfeU/\nBMzsVjN7wMz+q5mdMLOXzaynbP+fm9nrA/v+zcw+Gc9XBBQPARtoP+skLTGzUWY2RdICeUHbz6ck\n/cA593bV9gcljZJ0cb3CzOxCSX8r6T9ImiDpP0vaYmYjzOzfSXpE0kuSpkj6pKQVZnZZWRZXSNos\naZykLZLuHsj3I5JukPT7zrnRki6T9Gq9+gDwR8AG2s92eT3q45L2S+qV9P2AtBMlvVG90Tl3WlKf\npO4I5f2fkv6zc+5559wZ59y9kn4rL9j/vqRu59zXnHPvOuf2SvovkpaUHb/DOfePzrkzkv6bpJkD\n289IGiHpd82s0zn3qnPuFxHqA8AHARtoIwM92ick/YOks+UF5PGS/p+AQ/rkneuuzqdj4NgjEYo9\nV9LKgeHwfjPrlzRN0gcG9n2gat8qSZPLjj9Y9vqkpJFm1uGce0XSCkm3SjpsZpvN7AMR6gPABwEb\naC9d8oLl3c653zrn3pS0QdLCgPRPSlpgZmdXbf9fJZ2S9MLA+5PyhshLzil7/ZqkrzvnxpU9Rjnn\n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\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "plot_NQueens(astar)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "
\n", + "This concludes the notebook.\n", + "Hope you learned something new!" ] } ], @@ -2199,7 +4426,40 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.6.3" + "version": "3.6.1" + }, + "widgets": { + "state": { + "1516e2501ddd4a2e8e3250bffc0164db": { + "views": [ + { + "cell_index": 59 + } + ] + }, + "17be64c89a9a4a43b3272cb018df0970": { + "views": [ + { + "cell_index": 59 + } + ] + }, + "ac05040009a340b0af81b0ee69161fbc": { + "views": [ + { + "cell_index": 59 + } + ] + }, + "d9735ffe77c24f13ae4ad3620ce84334": { + "views": [ + { + "cell_index": 59 + } + ] + } + }, + "version": "1.2.0" } }, "nbformat": 4, diff --git a/search.py b/search.py index 7480d28ca..7296429af 100644 --- a/search.py +++ b/search.py @@ -1120,31 +1120,32 @@ class NQueensProblem(Problem): """The problem of placing N queens on an NxN board with none attacking each other. A state is represented as an N-element array, where a value of r in the c-th entry means there is a queen at column c, - row r, and a value of None means that the c-th column has not been + row r, and a value of -1 means that the c-th column has not been filled in yet. We fill in columns left to right. >>> depth_first_tree_search(NQueensProblem(8)) - + """ def __init__(self, N): self.N = N - self.initial = [None] * N + self.initial = tuple([-1] * N) + Problem.__init__(self, self.initial) def actions(self, state): """In the leftmost empty column, try all non-conflicting rows.""" - if state[-1] is not None: + if state[-1] is not -1: return [] # All columns filled; no successors else: - col = state.index(None) + col = state.index(-1) return [row for row in range(self.N) if not self.conflicted(state, row, col)] def result(self, state, row): """Place the next queen at the given row.""" - col = state.index(None) - new = state[:] + col = state.index(-1) + new = list(state[:]) new[col] = row - return new + return tuple(new) def conflicted(self, state, row, col): """Would placing a queen at (row, col) conflict with anything?""" @@ -1160,11 +1161,21 @@ def conflict(self, row1, col1, row2, col2): def goal_test(self, state): """Check if all columns filled, no conflicts.""" - if state[-1] is None: + if state[-1] is -1: return False return not any(self.conflicted(state, state[col], col) for col in range(len(state))) + def h(self, node): + """Return number of conflicting queens for a given node""" + num_conflicts = 0 + for (r1, c1) in enumerate(node.state): + for (r2, c2) in enumerate(node.state): + if (r1, c1) != (r2, c2): + num_conflicts += self.conflict(r1, c1, r2, c2) + + return num_conflicts + # ______________________________________________________________________________ # Inverse Boggle: Search for a high-scoring Boggle board. A good domain for # iterative-repair and related search techniques, as suggested by Justin Boyan. diff --git a/tests/test_search.py b/tests/test_search.py index f35755315..3a9279c3e 100644 --- a/tests/test_search.py +++ b/tests/test_search.py @@ -7,6 +7,7 @@ LRTA_problem = OnlineSearchProblem('State_3', 'State_5', one_dim_state_space) eight_puzzle = EightPuzzle((1, 2, 3, 4, 5, 7, 8, 6, 0)) eight_puzzle2 = EightPuzzle((1, 0, 6, 8, 7, 5, 4, 2), (0, 1, 2, 3, 4, 5, 6, 7, 8)) +nqueens = NQueensProblem(8) def test_find_min_edge(): assert romania_problem.find_min_edge() == 70 @@ -15,6 +16,7 @@ def test_find_min_edge(): def test_breadth_first_tree_search(): assert breadth_first_tree_search( romania_problem).solution() == ['Sibiu', 'Fagaras', 'Bucharest'] + assert breadth_first_search(nqueens).solution() == [0, 4, 7, 5, 2, 6, 1, 3] def test_breadth_first_search(): @@ -40,6 +42,11 @@ def test_best_first_graph_search(): def test_uniform_cost_search(): assert uniform_cost_search( romania_problem).solution() == ['Sibiu', 'Rimnicu', 'Pitesti', 'Bucharest'] + assert uniform_cost_search(nqueens).solution() == [0, 4, 7, 5, 2, 6, 1, 3] + + +def test_depth_first_tree_search(): + assert depth_first_tree_search(nqueens).solution() == [7, 3, 0, 2, 5, 1, 6, 4] def test_depth_first_graph_search(): @@ -68,6 +75,7 @@ def test_astar_search(): assert astar_search(romania_problem).solution() == ['Sibiu', 'Rimnicu', 'Pitesti', 'Bucharest'] assert astar_search(eight_puzzle).solution() == ['LEFT', 'LEFT', 'UP', 'RIGHT', 'RIGHT', 'DOWN', 'LEFT', 'UP', 'LEFT', 'DOWN', 'RIGHT', 'RIGHT'] assert astar_search(EightPuzzle((1, 2, 3, 4, 5, 6, 0, 7, 8))).solution() == ['RIGHT', 'RIGHT'] + assert astar_search(nqueens).solution() == [7, 1, 3, 0, 6, 4, 2, 5] def test_find_blank_square(): @@ -110,6 +118,10 @@ def test_goal_test(): assert eight_puzzle2.goal_test((3, 4, 1, 7, 6, 0, 2, 8, 5)) == False assert eight_puzzle2.goal_test((1, 2, 3, 4, 5, 6, 7, 8, 0)) == False assert eight_puzzle2.goal_test((0, 1, 2, 3, 4, 5, 6, 7, 8)) == True + assert nqueens.goal_test((7, 3, 0, 2, 5, 1, 6, 4)) == True + assert nqueens.goal_test((0, 4, 7, 5, 2, 6, 1, 3)) == True + assert nqueens.goal_test((7, 1, 3, 0, 6, 4, 2, 5)) == True + assert nqueens.goal_test((0, 1, 2, 3, 4, 5, 6, 7)) == False def test_check_solvability(): @@ -125,6 +137,17 @@ def test_check_solvability(): assert eight_puzzle.check_solvability((7, 0, 2, 8, 5, 3, 6, 4, 1)) == False +def test_conflict(): + assert not nqueens.conflict(7, 0, 1, 1) + assert not nqueens.conflict(0, 3, 6, 4) + assert not nqueens.conflict(2, 6, 5, 7) + assert not nqueens.conflict(2, 4, 1, 6) + assert nqueens.conflict(0, 0, 1, 1) + assert nqueens.conflict(4, 3, 4, 4) + assert nqueens.conflict(6, 5, 5, 6) + assert nqueens.conflict(0, 6, 1, 7) + + def test_recursive_best_first_search(): assert recursive_best_first_search( romania_problem).solution() == ['Sibiu', 'Rimnicu', 'Pitesti', 'Bucharest']