doc/pub/NeuralNet/ipynb/NeuralNet.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- dom:TITLE: Data Analysis and Machine Learning: Neural networks, from the simple perceptron to deep learning -->\n",
    "# Data Analysis and Machine Learning: Neural networks, from the simple perceptron to deep learning\n",
    "<!-- dom:AUTHOR: Morten Hjorth-Jensen at Department of Physics, University of Oslo & Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University -->\n",
    "<!-- Author: -->  \n",
    "**Morten Hjorth-Jensen**, Department of Physics, University of Oslo and Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University\n",
    "\n",
    "Date: **Oct 4, 2019**\n",
    "\n",
    "Copyright 1999-2019, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n",
    "\n",
    "\n",
    "\n",
    "\n",
    "## Neural networks\n",
    "\n",
    "Artificial neural networks are computational systems that can learn to\n",
    "perform tasks by considering examples, generally without being\n",
    "programmed with any task-specific rules. It is supposed to mimic a\n",
    "biological system, wherein neurons interact by sending signals in the\n",
    "form of mathematical functions between layers. All layers can contain\n",
    "an arbitrary number of neurons, and each connection is represented by\n",
    "a weight variable.\n",
    "\n",
    "\n",
    "## Artificial neurons\n",
    "\n",
    "The field of artificial neural networks has a long history of\n",
    "development, and is closely connected with the advancement of computer\n",
    "science and computers in general. A model of artificial neurons was\n",
    "first developed by McCulloch and Pitts in 1943 to study signal\n",
    "processing in the brain and has later been refined by others. The\n",
    "general idea is to mimic neural networks in the human brain, which is\n",
    "composed of billions of neurons that communicate with each other by\n",
    "sending electrical signals.  Each neuron accumulates its incoming\n",
    "signals, which must exceed an activation threshold to yield an\n",
    "output. If the threshold is not overcome, the neuron remains inactive,\n",
    "i.e. has zero output.\n",
    "\n",
    "This behaviour has inspired a simple mathematical model for an artificial neuron."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"artificialNeuron\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " y = f\\left(\\sum_{i=1}^n w_ix_i\\right) = f(u)\n",
    "\\label{artificialNeuron} \\tag{1}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here, the output $y$ of the neuron is the value of its activation function, which have as input\n",
    "a weighted sum of signals $x_i, \\dots ,x_n$ received by $n$ other neurons.\n",
    "\n",
    "Conceptually, it is helpful to divide neural networks into four\n",
    "categories:\n",
    "1. general purpose neural networks for supervised learning,\n",
    "\n",
    "2. neural networks designed specifically for image processing, the most prominent example of this class being Convolutional Neural Networks (CNNs),\n",
    "\n",
    "3. neural networks for sequential data such as Recurrent Neural Networks (RNNs), and\n",
    "\n",
    "4. neural networks for unsupervised learning such as Deep Boltzmann Machines.\n",
    "\n",
    "In natural science, DNNs and CNNs have already found numerous\n",
    "applications. In statistical physics, they have been applied to detect\n",
    "phase transitions in 2D Ising and Potts models, lattice gauge\n",
    "theories, and different phases of polymers, or solving the\n",
    "Navier-Stokes equation in weather forecasting.  Deep learning has also\n",
    "found interesting applications in quantum physics. Various quantum\n",
    "phase transitions can be detected and studied using DNNs and CNNs,\n",
    "topological phases, and even non-equilibrium many-body\n",
    "localization. Representing quantum states as DNNs quantum state\n",
    "tomography are among some of the impressive achievements to reveal the\n",
    "potential of DNNs to facilitate the study of quantum systems.\n",
    "\n",
    "In quantum information theory, it has been shown that one can perform\n",
    "gate decompositions with the help of neural. \n",
    "\n",
    "The applications are not limited to the natural sciences. There is a\n",
    "plethora of applications in essentially all disciplines, from the\n",
    "humanities to life science and medicine.\n",
    "\n",
    "## Neural network types\n",
    "\n",
    "An artificial neural network (ANN), is a computational model that\n",
    "consists of layers of connected neurons, or nodes or units.  We will\n",
    "refer to these interchangeably as units or nodes, and sometimes as\n",
    "neurons.\n",
    "\n",
    "It is supposed to mimic a biological nervous system by letting each\n",
    "neuron interact with other neurons by sending signals in the form of\n",
    "mathematical functions between layers.  A wide variety of different\n",
    "ANNs have been developed, but most of them consist of an input layer,\n",
    "an output layer and eventual layers in-between, called *hidden\n",
    "layers*. All layers can contain an arbitrary number of nodes, and each\n",
    "connection between two nodes is associated with a weight variable.\n",
    "\n",
    "Neural networks (also called neural nets) are neural-inspired\n",
    "nonlinear models for supervised learning.  As we will see, neural nets\n",
    "can be viewed as natural, more powerful extensions of supervised\n",
    "learning methods such as linear and logistic regression and soft-max\n",
    "methods we discussed earlier.\n",
    "\n",
    "\n",
    "## Feed-forward neural networks\n",
    "\n",
    "The feed-forward neural network (FFNN) was the first and simplest type\n",
    "of ANNs that were devised. In this network, the information moves in\n",
    "only one direction: forward through the layers.\n",
    "\n",
    "Nodes are represented by circles, while the arrows display the\n",
    "connections between the nodes, including the direction of information\n",
    "flow. Additionally, each arrow corresponds to a weight variable\n",
    "(figure to come).  We observe that each node in a layer is connected\n",
    "to *all* nodes in the subsequent layer, making this a so-called\n",
    "*fully-connected* FFNN.\n",
    "\n",
    "\n",
    "\n",
    "## Convolutional Neural Network\n",
    "\n",
    "A different variant of FFNNs are *convolutional neural networks*\n",
    "(CNNs), which have a connectivity pattern inspired by the animal\n",
    "visual cortex. Individual neurons in the visual cortex only respond to\n",
    "stimuli from small sub-regions of the visual field, called a receptive\n",
    "field. This makes the neurons well-suited to exploit the strong\n",
    "spatially local correlation present in natural images. The response of\n",
    "each neuron can be approximated mathematically as a convolution\n",
    "operation.  (figure to come)\n",
    "\n",
    "Convolutional neural networks emulate the behaviour of neurons in the\n",
    "visual cortex by enforcing a *local* connectivity pattern between\n",
    "nodes of adjacent layers: Each node in a convolutional layer is\n",
    "connected only to a subset of the nodes in the previous layer, in\n",
    "contrast to the fully-connected FFNN.  Often, CNNs consist of several\n",
    "convolutional layers that learn local features of the input, with a\n",
    "fully-connected layer at the end, which gathers all the local data and\n",
    "produces the outputs. They have wide applications in image and video\n",
    "recognition.\n",
    "\n",
    "## Recurrent neural networks\n",
    "\n",
    "So far we have only mentioned ANNs where information flows in one\n",
    "direction: forward. *Recurrent neural networks* on the other hand,\n",
    "have connections between nodes that form directed *cycles*. This\n",
    "creates a form of internal memory which are able to capture\n",
    "information on what has been calculated before; the output is\n",
    "dependent on the previous computations. Recurrent NNs make use of\n",
    "sequential information by performing the same task for every element\n",
    "in a sequence, where each element depends on previous elements. An\n",
    "example of such information is sentences, making recurrent NNs\n",
    "especially well-suited for handwriting and speech recognition.\n",
    "\n",
    "## Other types of networks\n",
    "\n",
    "There are many other kinds of ANNs that have been developed. One type\n",
    "that is specifically designed for interpolation in multidimensional\n",
    "space is the radial basis function (RBF) network. RBFs are typically\n",
    "made up of three layers: an input layer, a hidden layer with\n",
    "non-linear radial symmetric activation functions and a linear output\n",
    "layer (''linear'' here means that each node in the output layer has a\n",
    "linear activation function). The layers are normally fully-connected\n",
    "and there are no cycles, thus RBFs can be viewed as a type of\n",
    "fully-connected FFNN. They are however usually treated as a separate\n",
    "type of NN due the unusual activation functions.\n",
    "\n",
    "## Multilayer perceptrons\n",
    "\n",
    "One uses often so-called fully-connected feed-forward neural networks\n",
    "with three or more layers (an input layer, one or more hidden layers\n",
    "and an output layer) consisting of neurons that have non-linear\n",
    "activation functions.\n",
    "\n",
    "Such networks are often called *multilayer perceptrons* (MLPs).\n",
    "\n",
    "## Why multilayer perceptrons?\n",
    "\n",
    "According to the *Universal approximation theorem*, a feed-forward\n",
    "neural network with just a single hidden layer containing a finite\n",
    "number of neurons can approximate a continuous multidimensional\n",
    "function to arbitrary accuracy, assuming the activation function for\n",
    "the hidden layer is a **non-constant, bounded and\n",
    "monotonically-increasing continuous function**.\n",
    "\n",
    "Note that the requirements on the activation function only applies to\n",
    "the hidden layer, the output nodes are always assumed to be linear, so\n",
    "as to not restrict the range of output values.\n",
    "\n",
    "\n",
    "## Mathematical model\n",
    "\n",
    "The output $y$ is produced via the activation function $f$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "y = f\\left(\\sum_{i=1}^n w_ix_i + b_i\\right) = f(z),\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This function receives $x_i$ as inputs.\n",
    "Here the activation $z=(\\sum_{i=1}^n w_ix_i+b_i)$. \n",
    "In an FFNN of such neurons, the *inputs* $x_i$ are the *outputs* of\n",
    "the neurons in the preceding layer. Furthermore, an MLP is\n",
    "fully-connected, which means that each neuron receives a weighted sum\n",
    "of the outputs of *all* neurons in the previous layer.\n",
    "\n",
    "## Mathematical model\n",
    "\n",
    "First, for each node $i$ in the first hidden layer, we calculate a weighted sum $z_i^1$ of the input coordinates $x_j$,"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto1\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation} z_i^1 = \\sum_{j=1}^{M} w_{ij}^1 x_j + b_i^1\n",
    "\\label{_auto1} \\tag{2}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here $b_i$ is the so-called bias which is normally needed in\n",
    "case of zero activation weights or inputs. How to fix the biases and\n",
    "the weights will be discussed below.  The value of $z_i^1$ is the\n",
    "argument to the activation function $f_i$ of each node $i$, The\n",
    "variable $M$ stands for all possible inputs to a given node $i$ in the\n",
    "first layer.  We define  the output $y_i^1$ of all neurons in layer 1 as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"outputLayer1\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " y_i^1 = f(z_i^1) = f\\left(\\sum_{j=1}^M w_{ij}^1 x_j  + b_i^1\\right)\n",
    "\\label{outputLayer1} \\tag{3}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where we assume that all nodes in the same layer have identical\n",
    "activation functions, hence the notation $f$. In general, we could assume in the more general case that different layers have different activation functions.\n",
    "In this case we would identify these functions with a superscript $l$ for the $l$-th layer,"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"generalLayer\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " y_i^l = f^l(u_i^l) = f^l\\left(\\sum_{j=1}^{N_{l-1}} w_{ij}^l y_j^{l-1} + b_i^l\\right)\n",
    "\\label{generalLayer} \\tag{4}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where $N_l$ is the number of nodes in layer $l$. When the output of\n",
    "all the nodes in the first hidden layer are computed, the values of\n",
    "the subsequent layer can be calculated and so forth until the output\n",
    "is obtained.\n",
    "\n",
    "\n",
    "\n",
    "## Mathematical model\n",
    "\n",
    "The output of neuron $i$ in layer 2 is thus,"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto2\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " y_i^2 = f^2\\left(\\sum_{j=1}^N w_{ij}^2 y_j^1 + b_i^2\\right) \n",
    "\\label{_auto2} \\tag{5}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"outputLayer2\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation} \n",
    " = f^2\\left[\\sum_{j=1}^N w_{ij}^2f^1\\left(\\sum_{k=1}^M w_{jk}^1 x_k + b_j^1\\right) + b_i^2\\right]\n",
    "\\label{outputLayer2} \\tag{6}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where we have substituted $y_k^1$ with the inputs $x_k$. Finally, the ANN output reads"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto3\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " y_i^3 = f^3\\left(\\sum_{j=1}^N w_{ij}^3 y_j^2 + b_i^3\\right) \n",
    "\\label{_auto3} \\tag{7}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto4\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation} \n",
    " = f_3\\left[\\sum_{j} w_{ij}^3 f^2\\left(\\sum_{k} w_{jk}^2 f^1\\left(\\sum_{m} w_{km}^1 x_m + b_k^1\\right) + b_j^2\\right)\n",
    "  + b_1^3\\right]\n",
    "\\label{_auto4} \\tag{8}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Mathematical model\n",
    "\n",
    "We can generalize this expression to an MLP with $l$ hidden\n",
    "layers. The complete functional form is,"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"completeNN\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    "y^{l+1}_i = f^{l+1}\\left[\\!\\sum_{j=1}^{N_l} w_{ij}^3 f^l\\left(\\sum_{k=1}^{N_{l-1}}w_{jk}^{l-1}\\left(\\dots f^1\\left(\\sum_{n=1}^{N_0} w_{mn}^1 x_n+ b_m^1\\right)\\dots\\right)+b_k^2\\right)+b_1^3\\right] \n",
    "\\label{completeNN} \\tag{9}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "which illustrates a basic property of MLPs: The only independent\n",
    "variables are the input values $x_n$.\n",
    "\n",
    "## Mathematical model\n",
    "\n",
    "This confirms that an MLP, despite its quite convoluted mathematical\n",
    "form, is nothing more than an analytic function, specifically a\n",
    "mapping of real-valued vectors $\\hat{x} \\in \\mathbb{R}^n \\rightarrow\n",
    "\\hat{y} \\in \\mathbb{R}^m$.\n",
    "\n",
    "Furthermore, the flexibility and universality of an MLP can be\n",
    "illustrated by realizing that the expression is essentially a nested\n",
    "sum of scaled activation functions of the form"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto5\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " f(x) = c_1 f(c_2 x + c_3) + c_4\n",
    "\\label{_auto5} \\tag{10}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where the parameters $c_i$ are weights and biases. By adjusting these\n",
    "parameters, the activation functions can be shifted up and down or\n",
    "left and right, change slope or be rescaled which is the key to the\n",
    "flexibility of a neural network.\n",
    "\n",
    "### Matrix-vector notation\n",
    "\n",
    "We can introduce a more convenient notation for the activations in an A NN. \n",
    "\n",
    "Additionally, we can represent the biases and activations\n",
    "as layer-wise column vectors $\\hat{b}_l$ and $\\hat{y}_l$, so that the $i$-th element of each vector \n",
    "is the bias $b_i^l$ and activation $y_i^l$ of node $i$ in layer $l$ respectively. \n",
    "\n",
    "We have that $\\mathrm{W}_l$ is an $N_{l-1} \\times N_l$ matrix, while $\\hat{b}_l$ and $\\hat{y}_l$ are $N_l \\times 1$ column vectors. \n",
    "With this notation, the sum becomes a matrix-vector multiplication, and we can write\n",
    "the equation for the activations of hidden layer 2 (assuming three nodes for simplicity) as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto6\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " \\hat{y}_2 = f_2(\\mathrm{W}_2 \\hat{y}_{1} + \\hat{b}_{2}) = \n",
    " f_2\\left(\\left[\\begin{array}{ccc}\n",
    "    w^2_{11} &w^2_{12} &w^2_{13} \\\\\n",
    "    w^2_{21} &w^2_{22} &w^2_{23} \\\\\n",
    "    w^2_{31} &w^2_{32} &w^2_{33} \\\\\n",
    "    \\end{array} \\right] \\cdot\n",
    "    \\left[\\begin{array}{c}\n",
    "           y^1_1 \\\\\n",
    "           y^1_2 \\\\\n",
    "           y^1_3 \\\\\n",
    "          \\end{array}\\right] + \n",
    "    \\left[\\begin{array}{c}\n",
    "           b^2_1 \\\\\n",
    "           b^2_2 \\\\\n",
    "           b^2_3 \\\\\n",
    "          \\end{array}\\right]\\right).\n",
    "\\label{_auto6} \\tag{11}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Matrix-vector notation  and activation\n",
    "\n",
    "The activation of node $i$ in layer 2 is"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto7\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    " y^2_i = f_2\\Bigr(w^2_{i1}y^1_1 + w^2_{i2}y^1_2 + w^2_{i3}y^1_3 + b^2_i\\Bigr) = \n",
    " f_2\\left(\\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\\right).\n",
    "\\label{_auto7} \\tag{12}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is not just a convenient and compact notation, but also a useful\n",
    "and intuitive way to think about MLPs: The output is calculated by a\n",
    "series of matrix-vector multiplications and vector additions that are\n",
    "used as input to the activation functions. For each operation\n",
    "$\\mathrm{W}_l \\hat{y}_{l-1}$ we move forward one layer.\n",
    "\n",
    "\n",
    "### Activation functions\n",
    "\n",
    "A property that characterizes a neural network, other than its\n",
    "connectivity, is the choice of activation function(s).  As described\n",
    "in, the following restrictions are imposed on an activation function\n",
    "for a FFNN to fulfill the universal approximation theorem\n",
    "\n",
    "  * Non-constant\n",
    "\n",
    "  * Bounded\n",
    "\n",
    "  * Monotonically-increasing\n",
    "\n",
    "  * Continuous\n",
    "\n",
    "### Activation functions, Logistic and Hyperbolic ones\n",
    "\n",
    "The second requirement excludes all linear functions. Furthermore, in\n",
    "a MLP with only linear activation functions, each layer simply\n",
    "performs a linear transformation of its inputs.\n",
    "\n",
    "Regardless of the number of layers, the output of the NN will be\n",
    "nothing but a linear function of the inputs. Thus we need to introduce\n",
    "some kind of non-linearity to the NN to be able to fit non-linear\n",
    "functions Typical examples are the logistic *Sigmoid*"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "f(x) = \\frac{1}{1 + e^{-x}},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and the *hyperbolic tangent* function"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "f(x) = \\tanh(x)\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Relevance\n",
    "\n",
    "The *sigmoid* function are more biologically plausible because the\n",
    "output of inactive neurons are zero. Such activation function are\n",
    "called *one-sided*. However, it has been shown that the hyperbolic\n",
    "tangent performs better than the sigmoid for training MLPs.  has\n",
    "become the most popular for *deep neural networks*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXwAAAEXCAYAAACu1P9TAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4wLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvqOYd8AAAIABJREFUeJzt3Xl4VPWh//F39j0BwhAIa0T4QgiLgqBVWqzYulRxAW21VVuXuty2tvXe2/tol9v7612eerXaWrXaX6u/ilrRKipiS8G6i8galq/sS0hIyL5MMjOZ+f0xgwkxmEmY5MxkPq/n4WHOnDMzH75MPhy+c+achEAggIiIDH6JTgcQEZGBocIXEYkTKnwRkTihwhcRiRMqfBGROKHCFxGJEyp8iQrGmDnGmGUD8DqXGmMePMG6UmPMgm7un2WM2W2MWW+MmRDhPD8xxiwK3f65Mea6SD6/SGfJTgcQAbDWrgMWD8DrLAeW9/JhlwJrrLU39UOkLwLbAKy1P+mH5xf5hApfBpQxJhv4AzAJ8AMfAd8GPg/8xlpbYoxxhbaZCFQDFUCptfZnxphW4H7gK0Au8M/AEmA6cBi4xFrbbIyZD/wSyAQ8wD3W2pXGmBuAxdbarxhjioH/G9pmB5DVTd5rgduBJGNMBvC3Y48Pre/8fH8EGkJZxoae86vW2iZjzDzgwdBreIC7gKnAHOCXxph2YFHoz3lvD/kvD43dpNC666y1pX36C5G4oikdGWiXAznW2lnAGaH7TumyzYPAVmvtVIJl/rlO69KAcmvtdOC3wOPAnUAxkAcsMsbkA8uA71lrZwDXA38yxhR1eZ2ngMdC2zwAjO8a1lr7FPAI8Ky19tow/nyzgQsIlnkhsMQYkwK8CPzcWlsC3Bx6vYeBdcA/W2v/cuwJwsj/BeA7oed6h+A/eiI9UuHLQHsbmGaMeQP4EfAra+2uLttcBPwOwFpbTrD8Ons+9PtuYIu1tsxa6wf2AsOAecAua+0HoefYSrAYFxx7glCpzgCeDG3zDhCJveSV1to2a60X2BLKMx1ot9a+Gnqtj6y100OZu9NT/o+stYdCt9eHXkOkRyp8GVDW2r3AqcB/EZySWWWM6Tp37wMSOi23d1nf1um2t5uX6e59nQikdFo+dhKpzq/jO0HszgJdHpPaZb27m219nV4PAGNMiTHmRFOqPeXv7jVEeqTClwFljLmN4Pz8X621/wq8DpR02exV4MbQ9vkEp4F6c5a/94MPNXNDzzGN4GcEbxzbwFpbQ/Dzg5tC25xOcE+8J1VAiTEmPVTYl4TxGAsEjDHnd3qt1QR//nwc/w9RWPlF+kKFLwPtSSAJ2GaMWUdwL/+BLtt8H5hijNlCcPpmP9AS7gtYa48SnPv/deg5lgLftNZ+3GXTrwFfDW3zY2B7GE//V+AfBD+QfYvgtE1PedqAK4CfGmM2EvxM4AprrQd4GbjXGHN9H/KL9EqCTo8s0cYYczuwwVr7njEmjWCx/tRa+5rD0URimg7LlGi0jeDebRLBOfLnVPYiJ097+CIicUJz+CIicUKFLyISJ5yew08j+G3Lcj59rLWIiHQvCRgFfMjx30v5TE4X/hkEj8AQEZHem0/w2+thcbrwywFqa5vx+5398Dg/P5vq6iZHM0QLjUUHjUUHjUUHp8ciMTGBoUOzINSh4XK68NsB/P6A44V/LIcEaSw6aCw6aCw6RMlY9GoqXB/aiojECRW+iEicUOGLiMQJFb6ISJxQ4YuIxAkVvohInFDhi4jECRW+iEicUOGLiMQJFb6ISJxQ4YuIxImwz6VjjMkF3gW+Yq3d12XdLOAxIA94E7jVWuuLYE4RETlJYe3hG2PmETwF5+QTbPIn4DvW2slAAnBzZOKJiEikhDulczNwB3C46wpjzHggw1r7fuiuPwJLIpJOREQiJqwpHWvtTQDGmO5WF3L8OZnLgTEnnUxERCIqEufDT+jmPn9vniA/PzsCMU6ey5XjdISoobHooLHooLHoEMmxaG/3427z0dLmo7XNR6unHXebjzZPO62e4DLA/FmjyUjre21HovDLgJGdlkfRzdTPZ6mubnL8YgIuVw5VVY2OZogWGosOGosOGosO3Y1Fm7edphYvTe6OX82tXppbfTS7vbS0+YKl3tpR7O5QsXt9Pe8jJyRAVkoik8cOITExoU87yidd+Nba/caYVmPM2dbad4DrgNdO9nlFRJzW7vdT3+ShtqmNukYP9c1t1DW14WmHI0ebaGjx0NDspdHtweM9cWmnpiSSlZ5CZloyGenJ5GamUjA0g8y0ZNJTk0lPSwr+npr0ya+0lCRSU4K/p6UkkZGWRGZ6ykn9efpc+MaYFcBPrLXrgGuBx4wxOcAG4MGTSiUiMgB87X6q61upqnNTVd/K0Xo31fWtVDe0UtPQRn2TB3/g+NmHxIQE8rJTyclIITcrlZHDssjJTAn9SiU7I4XsjBSyQr9npiWTkhwdX3nqVeFbayd0un1Rp9ubgLmRiyUiEhmBQIC6Jg+Hq5spP9rMkRo3FbUtHKlpobqhlc59npSYwLDcNPJz0ykeP5ShuWkMy0lnSE4aQ7PTGJKdSk5mKgUFuTE5veX0RcxFRCKmzdPOwcomDlQ2cqiqmUNVTZRVNeNu6/geaEZaEiOGZjJxdB5nTRvJiKEZuIZkMDwvnSHZaSQmdnccyuCgwheRmOT1tXOgsok9hxvYW97A/opGKqpbOLbDnpmWzBhXFmdOK6AwP4vC/ExGDc8iLyuVhITBW+qfRYUvIjGhye1l58E6dh6qZ2dZHfvKG2kPHd2Xl51K0chc5k4tYFxBNuNG5DAsNy1ui/1EVPgiEpVaPT7sgTq2769lx/5aDlY2EQCSkxKYMCqX888Yy8TCXE4pzGNoTprTcWOCCl9EokIgEKC8uoVNu49SuqeGnYfq8LUHSE5K5NTRuVw2vwgzbihFo3JISU5yOm5MUuGLiGP8gQC7DtWz/uMqNu46SmWtG4AxriwWzh7LtFOGMXlMngo+QlT4IjKgjpX8hzsq+chWUtfkITkpgSnjh/LlueOYOTGfYbnpTscclFT4IjIgKmpaeLe0gve3VnC0vpWU5ESmn5LPnCkuZk4cflLniJHwaIRFpN+0edtZt6OSf2w8zK6yehISoHjCMC6ffwqzJqnkB5pGW0Qirry6mdXry3i3tAJ3m4+CYZksOXciZ00byZBsHVHjFBW+iEREIBCgdG8Nf1t3kNI9NSQlJnDGlBF8YVYhk8cO0THxUUCFLyInxdfu58Ptlbz2wX4OVTWTl5XKZfOL+MKs0eRlpTodTzpR4YtIn/ja/by1uZwV7+2nuqGV0cOzuPHiqcwrLiA5KTrODinHU+GLSK/42v28s6WcV97dR3VDGxMLc7n2/MnMODWfRE3bRDUVvoiEJRAIsHb7EZ7/x26q6lopGpXL9RdMYVrRMM3PxwgVvoj0yB6o5b+eWs/Og3WMcWXxvcUzmDExX0UfY1T4InJCR+vdPLt6Fx/ZKobnpXPjxVM5a9rIQX3O+MFMhS8in+L1tfPaBwdY8d5+AC6fX8S1F0+joa7F4WRyMlT4InKcHftreWLlDo7UupkzZQRXn3sq+XnppKXoBGaxToUvIkDwAiPPrdnFW5vLcQ1J54dXz2Ja0TCnY0kEqfBFhI27jvLEaztobPFy4ZnjuPTsIu3RD0IqfJE45m7z8fTfd/L25nLGuLL5/lUzGVeQ43Qs6ScqfJE49fHBOh57eSs1jW1cfNZ4Fp1TpG/IDnIqfJE44/cHeOXdfbz0zl5ceRn829dnc+roPKdjyQBQ4YvEkdrGNn63fCv2YB1nTivgG18yOid9HNHftEic2LG/lkdeKqXN6+fGi6fyuZKR+qZsnFHhiwxygUCA19ceZNkbuxkxNIN/vmY6o4dnOR1LHKDCFxnE2jzt/H7FdtbtqGS2cfGti6ZqCieOhfU3b4y5BrgHSAXut9Y+1GX96cCjofUHga9ba+sinFVEeqGmoZUHn9/MwSNNLFkwkQvmjdMUTpzr8RgsY8xo4BfAOcBM4BZjTHGXzR4AfmKtnQlY4K5IBxWR8O0+XM9/PLGOylo331sygwvPHK+yl54LH1gIrLbW1lhrm4FlwOIu2yQBuaHbmYA7chFFpDfW7ajkf57aQEpyInd/YzYzJg53OpJEiXCmdAqB8k7L5cDcLtv8APibMeZXQDMwrzch8vOze7N5v3G59A3DYzQWHWJpLF56cze/X17KlPHDuPubc8nLTovo88fSWPS3WByLcAq/u/8H+o/dMMZkAL8HzrPWrjXG/AB4Erg43BDV1U34/YFwN+8XLlcOVVWNjmaIFhqLDrEyFv5AgD+v3sVfPzzI6ZNd3HJJMR63hyq3J2KvEStjMRCcHovExIQ+7SiHM6VTBozstDwKONxpuQRwW2vXhpYfBRb0OomI9Imv3c/vlm/lrx8e5LzZY7j9shJSdeIz6UY4hb8KOM8Y4zLGZAJXAis7rd8FjDXGmNDyIuDDyMYUke54vO385oUtrN1eyeIFE7lm4SRdjUpOqMfCt9aWAXcDa4CNwNLQ1M0KY8wca20tcAPwZ2PMZuBbwDf7MbOIEDzT5X1/3sSW3dVcd4HhIh2JIz0I6zh8a+1SYGmX+y7qdPs14LXIRhORE2lye7nv2Y0crGzilkunMa+4wOlIEgP0lTuRGNPk9nLvMxs4fLSZO66YzqxTddilhEeFLxJDGls83PvMRsqrW/jOlTOYfkq+05EkhqjwRWJEQ4uHe5/ewJFaN99bPEPXm5VeU+GLxIDmVi/3PbPxk7IvnqCyl97T9cxEopy7zcd9z27icHUz37liuspe+kyFLxLF2rztPPDcJg4caeS2y0oo0Zy9nAQVvkiU8rX7+c0LW9hZVs/NlxRz2iSX05EkxqnwRaKQ3x/g8Ve2sXVvDTdcOIW5U3WcvZw8Fb5IlAkEAjy16mPWbq9kybkTmT+j0OlIMkio8EWizEtv72XN+jIumDeOC+eNdzqODCIqfJEo8sbGMpa/s49zpo9iyYKJTseRQUaFLxIlNu06yv973TJjYj7XX2h0IjSJOBW+SBTYW97Awy+VMq4gh1sXTSMpUT+aEnl6V4k4rKrOzQPPbSI3M5U7F88gPVVfgJf+ocIXcVBLq5dfPbeJdn+A7181M+LXoBXpTIUv4hBfu5+HXyylstbN7ZdPZ1R+ltORZJBT4Ys4IBAIsHTVTrbuq+W6Lxumjh/qdCSJAyp8EQesWneINzaUceG8ccyfqS9WycBQ4YsMsNK91TyzeienTRrOlTrWXgaQCl9kAFXUtPDIi1sZPTybmy8pJlHH2ssAUuGLDJCWVh8PLttMYmIC371yug6/lAGnwhcZAH5/gEeXb6Wqzs0dl5cwfEiG05EkDqnwRQbAX97aw5Y91Vx7/mTMOB2RI85Q4Yv0s3U7Knn1vf18YVYhC04b7XQciWMqfJF+VFbVxO9f3c7EwlyuWTjZ6TgS51T4Iv2kpdXLr1/YQlpqErdfPp2UZP24ibP0DhTpB/5AgMdf2U51fSu3X1bC0BydI0ecF9ZxYcaYa4B7gFTgfmvtQ13WG+BRYChQAXzVWlsb4awiMWPFe/vZuOsoX1s4icljhzgdRwQIYw/fGDMa+AVwDjATuMUYU9xpfQKwHPhva+1MYAPwo/6JKxL9tu6r4S9v7WFecQELZ49xOo7IJ8KZ0lkIrLbW1lhrm4FlwOJO608Hmq21K0PL/wk8hEgcqmlo5dGXtjIqP4vrL9BVqyS6hDOlUwiUd1ouB+Z2Wj4VqDDGPAGcBmwBvtObEPn52b3ZvN+4XDlOR4gaGosO4Y6F1+fnf57eQLs/wI9vnMeYEYNvDPW+6BCLYxFO4Xe3i+Lv8hwLgM9ba9cZY/4DuA+4IdwQ1dVN+P2BcDfvFy5XDlVVjY5miBYaiw69GYulqz7G7q/l9stKSEtg0I2h3hcdnB6LxMSEPu0ohzOlUwaM7LQ8CjjcabkC2GmtXRdafprj/wcgMuh9uKOSVesOsXDOGOZMGeF0HJFuhVP4q4DzjDEuY0wmcCWwstP6dwGXMWZmaPkS4KPIxhSJXhU1LfxhRfDLVVede6rTcUROqMfCt9aWAXcDa4CNwFJr7VpjzApjzBxrrRu4HHjMGLMV+CLww/4MLRItPN52fvuXUpKTErl1UQnJSfpqi0SvsI7Dt9YuBZZ2ue+iTrc/QNM4EoeWrtrJoaom7lwyk/y8dKfjiHwm7Y6I9NF7Wyt4c9NhLj5rPDMm5jsdR6RHKnyRPiivbubJlZZJY/K4bH6R03FEwqLCF+mlNm87v32xlJTkRL596TSSEvVjJLFB71SRXnp61ceUVTVz8yXFDMvVvL3EDhW+SC+8v7WCNzeVc9GZ45l+iubtJbao8EXCVFHTwhOvW04dk8fln9e8vcQeFb5IGLy+dh55sZTkxARu1by9xCi9a0XC8OzqXRyobOLGizVvL7FLhS/Sg3U7Klm9vowvnTGWWZOGOx1HpM9U+CKfoaK6mT+8toOiUTksXjDR6TgiJyWsUyuIxCNfu5//XboBCPBtnSdHBgG9g0VO4IU392AP1HLDhVMZMSTD6TgiJ02FL9KNzburWfnBAS44awJn6Pz2Mkio8EW6qG1s4/FXtjHGlcVNi0qcjiMSMSp8kU78/gCPvbwVj6+d2y4rIS0lyelIIhGjwhfp5OV397HjQB1fP98wKj/L6TgiEaXCFwnZsb+W5e/s5axpIzl7+sieHyASY1T4IkBDi4dHX97KiKGZfOPLk0lISHA6kkjEqfAl7vkDAR5/eRvNbh+3LZpGeqq+niKDkwpf4t7KDw5QureGry2cxLiCHKfjiPQbFb7EtV2H6nnhH3uYM2UEC2YVOh1HpF+p8CVuNbm9PLK8lPy8NG64YIrm7WXQU+FLXPIHAjz+yjYamj3cdlkJmemat5fBT4Uvcen1tQfYvLuaq784iQkjc52OIzIgVPgSd3Ydquf5N/Ywx7j44umjnY4jMmBU+BJXmtxeHn6plOF56dxw4VTN20tcUeFL3PAHAjz28jYaWzRvL/EprMI3xlxjjNlmjNlljLnjM7a72BizN3LxRCLn1ff2s2VPNV9bOJnxI3W8vcSfHgvfGDMa+AVwDjATuMUYU9zNdgXAvYD+jyxRZ/u+Gl58aw9nFhfoeHuJW+Hs4S8EVltra6y1zcAyYHE32z0O/Hskw4lEQm1jG48u38rIYZlcd4HRvL3ErXAKvxAo77RcDozpvIEx5rvAeuD9yEUTOXm+dj+PvlRKq7ed2y+frvPkSFwL593f3e6Q/9gNY0wJcCVwHl3+IQhXfn52Xx4WcS6X5nWPGSxj8fhLpXx8qJ67rp3NrKl9O+XxYBmLSNBYdIjFsQin8MuA+Z2WRwGHOy0vCd23DkgFCo0xb1lrOz/mM1VXN+H3B8LdvF+4XDlUVTU6miFaDJaxWLv9CC+9uZvzZo+heGxen/5Mg2UsIkFj0cHpsUhMTOjTjnI4hb8K+JkxxgU0E9ybv+XYSmvtT4GfAhhjJgBv9KbsRfrD4aPN/GHFDiaOzuXqL57qdByRqNDjHL61tgy4G1gDbASWWmvXGmNWGGPm9HdAkd5yt/l46C9bSE1J5LZFJSQn6esmIhDeHj7W2qXA0i73XdTNdvuACZEIJtIXx06KdqTGzQ+/OothuelORxKJGtr1kUHl1ff2s2HnUa764qlMHT/U6TgiUUWFL4PG5t1HefHNPZw5rYDz5/TpgDGRQU2FL4PCkZoWfrd8G2NHZHO9LmYi0i0VvsS8llYfDz6/mcTEBO64YjppKUlORxKJSip8iWl+f4DfvbyVylo3t19WgmtIhtORRKKWCl9i2vNv7mbz7mquOX8yU/QhrchnUuFLzHpvawWvvX+Ac08bzbmn6cpVIj1R4UtM2nmojj+s2M6UcUP42sJJTscRiQkqfIk5lXVufv38FvJz07n98un6Jq1ImPSTIjGlpdXLA89tIhAIcOeSmWRnpDgdSSRmqPAlZvja/Tz8YimVtW7+6YrpFAzLdDqSSExR4UtMCAQCPPHaDrbuq+X6C6ZgxumIHJHeUuFLTHjp7b28U1rBonOKOGfGKKfjiMQkFb5EvTc3HWb5O/s4Z8YoLj17gtNxRGKWCl+i2qZdR3lypaWkaBjXfVkXIBc5GSp8iVofH6zjty+WMrYgm9su04VMRE6WfoIkKh2sbOKBZZsZlpvO96+aSUZaWNfqEZHPoMKXqFNZ5+a+ZzeSnprED6+eSW5mqtORRAYFFb5ElZqGVu59egO+dj8/uGomw/N09kuRSFHhS9Sob2rjl89spLnVyw+unsVoV7bTkUQGFRW+RIXGFg/3PruR2sZW7lwyk6JRuU5HEhl0VPjiuCa3l/99diOVtW6+d+UMJo0Z4nQkkUFJhS+OanJ7uffpDRw+2sIdl09n6oRhTkcSGbR0rJs4prHFw73PbKS8uoXvXjmdklPynY4kMqip8MURDc0e7n1mA0dq3Xx38XRKilT2Iv1NhS8Drrq+NfgBbUMr3108g2maxhEZECp8GVAVNS3c+8wG3G0+fnD1LCaP1Qe0IgMlrMI3xlwD3AOkAvdbax/qsn4R8O9AArAX+Ka1tjbCWSXGHTjSyH3PbiQA/MvXTmf8yBynI4nElR6P0jHGjAZ+AZwDzARuMcYUd1qfCzwMXGytnQlsBn7WL2klZm3bV8N/P7WepKREfnStyl7ECeEclrkQWG2trbHWNgPLgMWd1qcAt1try0LLm4FxkY0psey90gru//Mm8nPTufsbsxmVn+V0JJG4FM6UTiFQ3mm5HJh7bMFaWw28CGCMyQB+BPw6ghklRgUCAVa8v5/n/7GHKeOG8E9XTCczXRcdF3FKOIXf3RUn/F3vMMbkESz+TdbaJ3oTIj8/Os6Z4nJpmuGYkx0Lr6+dh5Zt4u8fHuTzp43mzq+eRkpyUoTSDSy9LzpoLDrE4liEU/hlwPxOy6OAw503MMaMAl4HVgPf722I6uom/P5Abx8WUS5XDlVVjY5miBYnOxYNzR5+85ct7DpUz6VnT+DSc4qoq22JYMKBo/dFB41FB6fHIjExoU87yuEU/irgZ8YYF9AMXAnccmylMSYJeAX4s7X2//Q6gQwqB4408uvnt9DQ4uHWRdOYO7XA6UgiEtJj4Vtry4wxdwNrCB6W+bi1dq0xZgXwE2AscBqQZIw59mHuOmvtTf0VWqLTu6XlPLnSkpmezI+uPV1nvBSJMmEdh2+tXQos7XLfRaGb69BJ2OKar93P03/fyZr1ZZixQ7j1shLysnSVKpFoo2/aykmpqnPz6PKt7DncwAVzx3HlglNIStS//yLRSIUvfbZ2+xGeWLkDSOD2y0qYM2WE05FE5DOo8KXX3G0+nvn7Tt7aXM7E0bl8+5JpDB+ia8+KRDsVvvTKxwfrePyVbVTXt3LxWeNZdE4RyUmawhGJBSp8CYvX184Lb+7hr2sPMnxIOv967ek606VIjFHhS4+276/lyZU7OFLrZsFpo7nq3Imkp+qtIxJr9FMrJ9Tk9vLnNbt4e3M5I4ZkcNdXZ1Gsi5WIxCwVvnyK3x/gzU2HWfbGblpafVx05nguPXsCqSmxeS4cEQlS4ctxdh+u5z+fWs+ug3VMGpPHtedPZlxB7J0kSkQ+TYUvAFTWuXnhH7tZu72SYblp3HJJMfOKC0hI6O5kqSISi1T4ca6hxcMr7+5jzfoykhIT+MrnJvCNi4tpbmx1OpqIRJgKP041ub2s/OAAf//oEB5fO/NnFLLonCKG5qSRmZ6iwhcZhFT4caa+2cOqdQdZ9dEhPJ52zpg6gkvPLqJwuC47KDLYqfDjRGWdm9c/OMDbW8rx+fzMnjKCRWdPYLQrOq42JiL9T4U/iAUCAeyBOlZ9dIgNO6tISkzgcyUj+fLccbqQuEgcUuEPQu42H+9vO8Ka9Yc4VNVMdkYKF84bz3mzxzA0J83peCLiEBX+IBEIBNh9uIE3Nx1m7fYjeLx+xo7I5psXTmFecYG+NCUiKvxYV1nn5v3SCt7dWkFlrZu0lCTOLC7g8zNHUzQqR8fRi8gnVPgx6Gidmw9tJet2VLK3vJEEwIwbwsVnjWeOGUFGmv5aReTT1AwxIBAIcOBIExt3HWXjzqPsP9IIwISROSxZMJF5xQUMy013OKWIRDsVfpRqbvWybV8tpXuqKd1bQ21jGwnAxDF5LFkwkdlTRjBCV5kSkV5Q4UeJVo+PXYfq2b6/lh0HatlX0UggABlpyUybMJTpp+Qz89Th5GalOh1VRGKUCt8BgUCA6oZW9hxuYNehenaW1XPwSBP+QICkxAROKczlks9NoKQon6LCHJISdQlBETl5Kvx+FggEqGvysL+ikf1HGtlf0cie8gYamj0ApCYnckphLhedNZ7JY/OYNHoIaak6hFJEIk+FH0FNbi/l1c2UV7dwqLKJQ1VNHKpqpsntBSABGJmfyfSiYRQV5lI0KpexI7J1EXARGRAq/F5yt/moqnNTWeumss7NkZoWjtS0UFHr/mSvHSAtJYnRrixOnzycMa5sJozMZcyILF0LVkQco/bpxNfup77JQ21TGzUNrdQ2tlHd0Ep1fesnvze3+o57TG5WKgVDM5gxMZ/C/CxG5WcyangWw/PSSdSXnkQkigzqwvcHArjbfDS5vTS1eGl0e2ls8QRvt3ipb26jodlDfbOXhhbPcXvox6SmJDI8L4P83HROKczDNSQdV14GriHBX5npg3oIRWQQCautjDHXAPcAqcD91tqHuqyfBTwG5AFvArdaa32feqIwBQIBvD4/bd522jzttHrbafW00+rxBZc97bjbfMFfodstrT5aQr83t3qDy60+/IFAt6+RkpxIXlYquVmpDM9LZ/qpw0lLSmBIThpDslMZlpPO0Nw0MtOSdXoCERkUeix8Y8xo4BfAbKANeNcYs8Zau63TZn8CbrLWvm+M+T1wM/BwuCHufWYD5Udb8Pja8Xj9eLztdF/Tn5aSnEhmWjIZaclkpieTlZ6Ma0g6WRkpZKUnk52eQlZGCjmZKWRnpJKTGbydlpJ0XJG7XDlUVTWGG1lEJOaEs4e/EFhtra0BMMYsAxYDPw8tjweue4IAAAAE5klEQVQyrLXvh7b/I/Dv9KLwC4ZmkpuZSmpyIqkpSaSlJJGakkh6ajJpKUmkpQbvS08N/UpLJjMtmfTUJB3hIiISpnAKvxAo77RcDsztYf2Y3oS485rZvdm837hcOU5HiBoaiw4aiw4aiw6xOBbhFH53E9j+XqzvUXV1E35/uJM4/UNTOh00Fh00Fh00Fh2cHovExATy83t/edJw5kPKgJGdlkcBh3uxXkREokA4hb8KOM8Y4zLGZAJXAiuPrbTW7gdajTFnh+66Dngt4klFROSk9Fj41toy4G5gDbARWGqtXWuMWWGMmRPa7FrgfmPMdiALeLC/AouISN+EdRy+tXYpsLTLfRd1ur2J4z/IFRGRKKNjGkVE4oQKX0QkTqjwRUTihApfRCROqPBFROKECl9EJE6o8EVE4oQKX0QkTqjwRUTihApfRCROqPBFROKE01fgToLguZ2jQbTkiAYaiw4aiw4aiw5OjkWn107qzeMSAie4yPcAOQd4y8kAIiIxbD7wdrgbO134acAZBC+L2O5kEBGRGJJE8GJTHwJt4T7I6cIXEZEBog9tRUTihApfRCROqPBFROKECl9EJE6o8EVE4oQKX0QkTqjwRUTihNOnVog6xpjTgPettWlOZ3GKMeZs4FdAClANfMtau9/ZVAPLGHMNcA+QCtxvrX3I4UiOMcb8FLgqtPiqtfZfnMwTDYwxvwRc1tobnM7SG9rD78QYkwn8huAPeTx7CrjRWjsrdPtBh/MMKGPMaOAXBE/9MRO4xRhT7GwqZxhjFgJfAk4DZgGzjTGXO5vKWcaY84AbnM7RFyr84/0vcL/TIZxkjEkD7rHWbg7dtRkY52AkJywEVltra6y1zcAyYLHDmZxSDvzQWuux1nqB7cTf++ETxphhBHcG/tPpLH2hKZ0QY8ylQKa1dpkxxuk4jrHWtgF/AjDGJAI/A150MpMDCgkW3THlwFyHsjjKWrv12G1jzCTgauBzziVy3KPA3cBYp4P0RdwVvjFmCZ/ei98B5BLcs4sbJxoLa+1CY0wq8ATB90hM7s2chO7Oe+sf8BRRxBgzDXgVuMtau9PpPE4wxtwEHLTW/t0Yc4PTefpCJ0/jk7/IfwMaQ3fNBDYB8621jSd84CBljMkGlhP8wPbrob3+uGGMuZ7g3/1NoeUfAwnW2p87m8wZoQ/xnwfutNY+43Qepxhj/kbwDJU+YBiQDTxhrf2+o8F6QYXfDWNMwFobt1d6MMa8CFQC37bWxt0bJPSh7dsEp3GagXeBW6y1ax0N5gBjzFhgPXC1tXa103miRWgPf0GsHaUTd1M68tlCh6UuArYBG0KfZxy21l7kaLABZK0tM8bcDawheMTW4/FY9iF3AenAfZ0+23rEWvuIc5Gkr7SHLyISJ3RYpohInFDhi4jECRW+iEicUOGLiMQJFb6ISJxQ4YuIxAkVvohInNAXr0S6MMbcAdzc6a5i4H+stT92KJJIROiLVyKfwRhzG/Atgl+jb3Y6j8jJ0B6+yAmELvRxF3C2yl4GA+3hi3QjdIbI54CF1tptTucRiQR9aCvSRehyhs8B16jsZTDRHr5IF8aY14HZwD46pj3XHTs/vkisUuGLiMQJTemIiMQJFb6ISJxQ4YuIxAkVvohInFDhi4jECRW+iEicUOGLiMQJFb6ISJz4/+CNHrgwUSZKAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%matplotlib inline\n",
    "\n",
    "\"\"\"The sigmoid function (or the logistic curve) is a \n",
    "function that takes any real number, z, and outputs a number (0,1).\n",
    "It is useful in neural networks for assigning weights on a relative scale.\n",
    "The value z is the weighted sum of parameters involved in the learning algorithm.\"\"\"\n",
    "\n",
    "import numpy\n",
    "import matplotlib.pyplot as plt\n",
    "import math as mt\n",
    "\n",
    "z = numpy.arange(-5, 5, .1)\n",
    "sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z)))\n",
    "sigma = sigma_fn(z)\n",
    "\n",
    "fig = plt.figure()\n",
    "ax = fig.add_subplot(111)\n",
    "ax.plot(z, sigma)\n",
    "ax.set_ylim([-0.1, 1.1])\n",
    "ax.set_xlim([-5,5])\n",
    "ax.grid(True)\n",
    "ax.set_xlabel('z')\n",
    "ax.set_title('sigmoid function')\n",
    "\n",
    "plt.show()\n",
    "\n",
    "\"\"\"Step Function\"\"\"\n",
    "z = numpy.arange(-5, 5, .02)\n",
    "step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0)\n",
    "step = step_fn(z)\n",
    "\n",
    "fig = plt.figure()\n",
    "ax = fig.add_subplot(111)\n",
    "ax.plot(z, step)\n",
    "ax.set_ylim([-0.5, 1.5])\n",
    "ax.set_xlim([-5,5])\n",
    "ax.grid(True)\n",
    "ax.set_xlabel('z')\n",
    "ax.set_title('step function')\n",
    "\n",
    "plt.show()\n",
    "\n",
    "\"\"\"Sine Function\"\"\"\n",
    "z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1)\n",
    "t = numpy.sin(z)\n",
    "\n",
    "fig = plt.figure()\n",
    "ax = fig.add_subplot(111)\n",
    "ax.plot(z, t)\n",
    "ax.set_ylim([-1.0, 1.0])\n",
    "ax.set_xlim([-2*mt.pi,2*mt.pi])\n",
    "ax.grid(True)\n",
    "ax.set_xlabel('z')\n",
    "ax.set_title('sine function')\n",
    "\n",
    "plt.show()\n",
    "\n",
    "\"\"\"Plots a graph of the squashing function used by a rectified linear\n",
    "unit\"\"\"\n",
    "z = numpy.arange(-2, 2, .1)\n",
    "zero = numpy.zeros(len(z))\n",
    "y = numpy.max([zero, z], axis=0)\n",
    "\n",
    "fig = plt.figure()\n",
    "ax = fig.add_subplot(111)\n",
    "ax.plot(z, y)\n",
    "ax.set_ylim([-2.0, 2.0])\n",
    "ax.set_xlim([-2.0, 2.0])\n",
    "ax.grid(True)\n",
    "ax.set_xlabel('z')\n",
    "ax.set_title('Rectified linear unit')\n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## The multilayer  perceptron (MLP)\n",
    "\n",
    "The multilayer perceptron is a very popular, and easy to implement approach, to deep learning. It consists of\n",
    "1. A neural network with one or more layers of nodes between the input and the output nodes.\n",
    "\n",
    "2. The multilayer network structure, or architecture, or topology, consists of an input layer, one or more hidden layers, and one output layer.\n",
    "\n",
    "3. The input nodes pass values to the first hidden layer, its nodes pass the information on to the second and so on till we reach the output layer.\n",
    "\n",
    "As a convention it is normal to call  a  network with one layer of input units, one layer of hidden\n",
    "units and one layer of output units as  a two-layer network. A network with two layers of hidden units is called a three-layer network etc etc.\n",
    "\n",
    "For an MLP network there is no direct connection between the output nodes/neurons/units and  the input nodes/neurons/units.\n",
    "Hereafter we will call the various entities of a layer for nodes.\n",
    "There are also no connections within a single layer.\n",
    "\n",
    "The number of input nodes does not need to equal the number of output\n",
    "nodes. This applies also to the hidden layers. Each layer may have its\n",
    "own number of nodes and activation functions.\n",
    "\n",
    "The hidden layers have their name from the fact that they are not\n",
    "linked to observables and as we will see below when we define the\n",
    "so-called activation $\\hat{z}$, we can think of this as a basis\n",
    "expansion of the original inputs $\\hat{x}$. The difference however\n",
    "between neural networks and say linear regression is that now these\n",
    "basis functions (which will correspond to the weights in the network)\n",
    "are learned from data. This results in  an important difference between\n",
    "neural networks and deep learning approaches on one side and methods\n",
    "like logistic regression or linear regression and their modifications on the other side.\n",
    "\n",
    "\n",
    "## From one to many layers, the universal approximation theorem\n",
    "\n",
    "\n",
    "A neural network with only one layer, what we called the simple\n",
    "perceptron, is best suited if we have a standard binary model with\n",
    "clear (linear) boundaries between the outcomes. As such it could\n",
    "equally well be replaced by standard linear regression or logistic\n",
    "regression. Networks with one or more hidden layers approximate\n",
    "systems with more complex boundaries.\n",
    "\n",
    "As stated earlier, \n",
    "an important theorem in studies of neural networks, restated without\n",
    "proof here, is the [universal approximation\n",
    "theorem](http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.441.7873&rep=rep1&type=pdf).\n",
    "\n",
    "It states that a feed-forward network with a single hidden layer\n",
    "containing a finite number of neurons can approximate continuous\n",
    "functions on compact subsets of real functions. The theorem thus\n",
    "states that simple neural networks can represent a wide variety of\n",
    "interesting functions when given appropriate parameters. It is the\n",
    "multilayer feedforward architecture itself which gives neural networks\n",
    "the potential of being universal approximators.\n",
    "\n",
    "\n",
    "## Deriving the back propagation code for a multilayer perceptron model\n",
    "\n",
    "\n",
    "**Note: figures will be inserted later!**\n",
    "\n",
    "As we have seen now in a feed forward network, we can express the final output of our network in terms of basic matrix-vector multiplications.\n",
    "The unknowwn quantities are our weights $w_{ij}$ and we need to find an algorithm for changing them so that our errors are as small as possible.\n",
    "This leads us to the famous [back propagation algorithm](https://www.nature.com/articles/323533a0).\n",
    "\n",
    "The questions we want to ask are how do changes in the biases and the\n",
    "weights in our network change the cost function and how can we use the\n",
    "final output to modify the weights?\n",
    "\n",
    "To derive these equations let us start with a plain regression problem\n",
    "and define our cost function as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "{\\cal C}(\\hat{W})  =  \\frac{1}{2}\\sum_{i=1}^n\\left(y_i - t_i\\right)^2,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where the $t_i$s are our $n$ targets (the values we want to\n",
    "reproduce), while the outputs of the network after having propagated\n",
    "all inputs $\\hat{x}$ are given by $y_i$.  Below we will demonstrate\n",
    "how the basic equations arising from the back propagation algorithm\n",
    "can be modified in order to study classification problems with $K$\n",
    "classes.\n",
    "\n",
    "## Definitions\n",
    "\n",
    "With our definition of the targets $\\hat{t}$, the outputs of the\n",
    "network $\\hat{y}$ and the inputs $\\hat{x}$ we\n",
    "define now the activation $z_j^l$ of node/neuron/unit $j$ of the\n",
    "$l$-th layer as a function of the bias, the weights which add up from\n",
    "the previous layer $l-1$ and the forward passes/outputs\n",
    "$\\hat{a}^{l-1}$ from the previous layer as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "z_j^l = \\sum_{i=1}^{M_{l-1}}w_{ij}^la_i^{l-1}+b_j^l,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where $b_k^l$ are the biases from layer $l$.  Here $M_{l-1}$\n",
    "represents the total number of nodes/neurons/units of layer $l-1$. The\n",
    "figure here illustrates this equation.  We can rewrite this in a more\n",
    "compact form as the matrix-vector products we discussed earlier,"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\hat{z}^l = \\left(\\hat{W}^l\\right)^T\\hat{a}^{l-1}+\\hat{b}^l.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With the activation values $\\hat{z}^l$ we can in turn define the\n",
    "output of layer $l$ as $\\hat{a}^l = f(\\hat{z}^l)$ where $f$ is our\n",
    "activation function. In the examples here we will use the sigmoid\n",
    "function discussed in our logistic regression lectures. We will also use the same activation function $f$ for all layers\n",
    "and their nodes.  It means we have"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "a_j^l = f(z_j^l) = \\frac{1}{1+\\exp{-(z_j^l)}}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Derivatives and the chain rule\n",
    "\n",
    "From the definition of the activation $z_j^l$ we have"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial z_j^l}{\\partial w_{ij}^l} = a_i^{l-1},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial z_j^l}{\\partial a_i^{l-1}} = w_{ji}^l.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With our definition of the activation function we have that (note that this function depends only on $z_j^l$)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial a_j^l}{\\partial z_j^{l}} = a_j^l(1-a_j^l)=f(z_j^l)(1-f(z_j^l)).\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Derivative of the cost function\n",
    "\n",
    "With these definitions we can now compute the derivative of the cost function in terms of the weights.\n",
    "\n",
    "Let us specialize to the output layer $l=L$. Our cost function is"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "{\\cal C}(\\hat{W^L})  =  \\frac{1}{2}\\sum_{i=1}^n\\left(y_i - t_i\\right)^2=\\frac{1}{2}\\sum_{i=1}^n\\left(a_i^L - t_i\\right)^2,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The derivative of this function with respect to the weights is"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial{\\cal C}(\\hat{W^L})}{\\partial w_{jk}^L}  =  \\left(a_j^L - t_j\\right)\\frac{\\partial a_j^L}{\\partial w_{jk}^{L}},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The last partial derivative can easily be computed and reads (by applying the chain rule)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial a_j^L}{\\partial w_{jk}^{L}} = \\frac{\\partial a_j^L}{\\partial z_{j}^{L}}\\frac{\\partial z_j^L}{\\partial w_{jk}^{L}}=a_j^L(1-a_j^L)a_k^{L-1},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Bringing it together, first back propagation equation\n",
    "\n",
    "We have thus"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial{\\cal C}(\\hat{W^L})}{\\partial w_{jk}^L}  =  \\left(a_j^L - t_j\\right)a_j^L(1-a_j^L)a_k^{L-1},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Defining"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^L = a_j^L(1-a_j^L)\\left(a_j^L - t_j\\right) = f'(z_j^L)\\frac{\\partial {\\cal C}}{\\partial (a_j^L)},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and using the Hadamard product of two vectors we can write this as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\hat{\\delta}^L = f'(\\hat{z}^L)\\circ\\frac{\\partial {\\cal C}}{\\partial (\\hat{a}^L)}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is an important expression. The second term on the right handside\n",
    "measures how fast the cost function is changing as a function of the $j$th\n",
    "output activation.  If, for example, the cost function doesn't depend\n",
    "much on a particular output node $j$, then $\\delta_j^L$ will be small,\n",
    "which is what we would expect. The first term on the right, measures\n",
    "how fast the activation function $f$ is changing at a given activation\n",
    "value $z_j^L$.\n",
    "\n",
    "Notice that everything in the above equations is easily computed.  In\n",
    "particular, we compute $z_j^L$ while computing the behaviour of the\n",
    "network, and it is only a small additional overhead to compute\n",
    "$f'(z^L_j)$.  The exact form of the derivative with respect to the\n",
    "output depends on the form of the cost function.\n",
    "However, provided the cost function is known there should be little\n",
    "trouble in calculating"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial {\\cal C}}{\\partial (a_j^L)}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With the definition of $\\delta_j^L$ we have a more compact definition of the derivative of the cost function in terms of the weights, namely"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial{\\cal C}(\\hat{W^L})}{\\partial w_{jk}^L}  =  \\delta_j^La_k^{L-1}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Derivatives in terms of $z_j^L$\n",
    "\n",
    "It is also easy to see that our previous equation can be written as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^L =\\frac{\\partial {\\cal C}}{\\partial z_j^L}= \\frac{\\partial {\\cal C}}{\\partial a_j^L}\\frac{\\partial a_j^L}{\\partial z_j^L},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "which can also be interpreted as the partial derivative of the cost function with respect to the biases $b_j^L$, namely"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^L = \\frac{\\partial {\\cal C}}{\\partial b_j^L}\\frac{\\partial b_j^L}{\\partial z_j^L}=\\frac{\\partial {\\cal C}}{\\partial b_j^L},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "That is, the error $\\delta_j^L$ is exactly equal to the rate of change of the cost function as a function of the bias. \n",
    "## Bringing it together\n",
    "\n",
    "We have now three equations that are essential for the computations of the derivatives of the cost function at the output layer. These equations are needed to start the algorithm and they are\n",
    "\n",
    "**The starting equations.**"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto8\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    "\\frac{\\partial{\\cal C}(\\hat{W^L})}{\\partial w_{jk}^L}  =  \\delta_j^La_k^{L-1},\n",
    "\\label{_auto8} \\tag{13}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto9\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    "\\delta_j^L = f'(z_j^L)\\frac{\\partial {\\cal C}}{\\partial (a_j^L)},\n",
    "\\label{_auto9} \\tag{14}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- Equation labels as ordinary links -->\n",
    "<div id=\"_auto10\"></div>\n",
    "\n",
    "$$\n",
    "\\begin{equation}\n",
    "\\delta_j^L = \\frac{\\partial {\\cal C}}{\\partial b_j^L},\n",
    "\\label{_auto10} \\tag{15}\n",
    "\\end{equation}\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "An interesting consequence of the above equations is that when the\n",
    "activation $a_k^{L-1}$ is small, the gradient term, that is the\n",
    "derivative of the cost function with respect to the weights, will also\n",
    "tend to be small. We say then that the weight learns slowly, meaning\n",
    "that it changes slowly when we minimize the weights via say gradient\n",
    "descent. In this case we say the system learns slowly.\n",
    "\n",
    "Another interesting feature is that is when the activation function,\n",
    "represented by the sigmoid function here, is rather flat when we move towards\n",
    "its end values $0$ and $1$ (see the above Python codes). In these\n",
    "cases, the derivatives of the activation function will also be close\n",
    "to zero, meaning again that the gradients will be small and the\n",
    "network learns slowly again.\n",
    "\n",
    "\n",
    "\n",
    "We need a fourth equation and we are set. We are going to propagate\n",
    "backwards in order to the determine the weights and biases. In order\n",
    "to do so we need to represent the error in the layer before the final\n",
    "one $L-1$ in terms of the errors in the final output layer.\n",
    "\n",
    "## Final back propagating equation\n",
    "\n",
    "We have that (replacing $L$ with a general layer $l$)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^l =\\frac{\\partial {\\cal C}}{\\partial z_j^l}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We want to express this in terms of the equations for layer $l+1$. Using the chain rule and summing over all $k$ entries we have"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^l =\\sum_k \\frac{\\partial {\\cal C}}{\\partial z_k^{l+1}}\\frac{\\partial z_k^{l+1}}{\\partial z_j^{l}}=\\sum_k \\delta_k^{l+1}\\frac{\\partial z_k^{l+1}}{\\partial z_j^{l}},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and recalling that"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "z_j^{l+1} = \\sum_{i=1}^{M_{l}}w_{ij}^{l+1}a_i^{l}+b_j^{l+1},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "with $M_l$ being the number of nodes in layer $l$, we obtain"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^l =\\sum_k \\delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l),\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This is our final equation.\n",
    "\n",
    "We are now ready to set up the algorithm for back propagation and learning the weights and biases.\n",
    "\n",
    "## Setting up the Back propagation algorithm\n",
    "\n",
    "\n",
    "\n",
    "The four equations  provide us with a way of computing the gradient of the cost function. Let us write this out in the form of an algorithm.\n",
    "\n",
    "First, we set up the input data $\\hat{x}$ and the activations\n",
    "$\\hat{z}_1$ of the input layer and compute the activation function and\n",
    "the pertinent outputs $\\hat{a}^1$.\n",
    "\n",
    "\n",
    "\n",
    "Secondly, we perform then the feed forward till we reach the output\n",
    "layer and compute all $\\hat{z}_l$ of the input layer and compute the\n",
    "activation function and the pertinent outputs $\\hat{a}^l$ for\n",
    "$l=2,3,\\dots,L$.\n",
    "\n",
    "\n",
    "\n",
    "Thereafter we compute the ouput error $\\hat{\\delta}^L$ by computing all"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^L = f'(z_j^L)\\frac{\\partial {\\cal C}}{\\partial (a_j^L)}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Then we compute the back propagate error for each $l=L-1,L-2,\\dots,2$ as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\delta_j^l = \\sum_k \\delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l).\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, we update the weights and the biases using gradient descent for each $l=L-1,L-2,\\dots,2$ and update the weights and biases according to the rules"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "w_{jk}^l\\leftarrow  = w_{jk}^l- \\eta \\delta_j^la_k^{l-1},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "b_j^l \\leftarrow b_j^l-\\eta \\frac{\\partial {\\cal C}}{\\partial b_j^l}=b_j^l-\\eta \\delta_j^l,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The parameter $\\eta$ is the learning parameter discussed in connection with the gradient descent methods.\n",
    "Here it is convenient to use stochastic gradient descent (see the examples below) with mini-batches with an outer loop that steps through multiple epochs of training.\n",
    "\n",
    "\n",
    "<!-- !split  -->\n",
    "## Setting up a Multi-layer perceptron model for classification\n",
    "\n",
    "We are now gong to develop an example based on the MNIST data\n",
    "base. This is a classification problem and we need to use our\n",
    "cross-entropy function we discussed in connection with logistic\n",
    "regression. The cross-entropy defines our cost function for the\n",
    "classificaton problems with neural networks.\n",
    "\n",
    "In binary classification with two classes $(0, 1)$ we define the\n",
    "logistic/sigmoid function as the probability that a particular input\n",
    "is in class $0$ or $1$.  This is possible because the logistic\n",
    "function takes any input from the real numbers and inputs a number\n",
    "between 0 and 1, and can therefore be interpreted as a probability. It\n",
    "also has other nice properties, such as a derivative that is simple to\n",
    "calculate.\n",
    "\n",
    "For an input $\\boldsymbol{a}$ from the hidden layer, the probability that the input $\\boldsymbol{x}$\n",
    "is in class 0 or 1 is just. We let $\\theta$ represent the unknown weights and biases to be adjusted by our equations). The variable $x$\n",
    "represents our activation values $z$. We have"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "P(y = 0 \\mid \\hat{x}, \\hat{\\theta}) = \\frac{1}{1 + \\exp{(- \\hat{x}})} ,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "P(y = 1 \\mid \\hat{x}, \\hat{\\theta}) = 1 - P(y = 0 \\mid \\hat{x}, \\hat{\\theta}) ,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where $y \\in \\{0, 1\\}$  and $\\hat{\\theta}$ represents the weights and biases\n",
    "of our network.\n",
    "\n",
    "\n",
    "## Defining the cost function\n",
    "\n",
    "Our cost function is given as (see the Logistic regression lectures)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\mathcal{C}(\\hat{\\theta}) = - \\ln P(\\mathcal{D} \\mid \\hat{\\theta}) = - \\sum_{i=1}^n\n",
    "y_i \\ln[P(y_i = 0)] + (1 - y_i) \\ln [1 - P(y_i = 0)] = \\sum_{i=1}^n \\mathcal{L}_i(\\hat{\\theta}) .\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This last equality means that we can interpret our *cost* function as a sum over the *loss* function\n",
    "for each point in the dataset $\\mathcal{L}_i(\\hat{\\theta})$.  \n",
    "The negative sign is just so that we can think about our algorithm as minimizing a positive number, rather\n",
    "than maximizing a negative number.  \n",
    "\n",
    "In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector:  \n",
    "\n",
    "$y = 5 \\quad \\rightarrow \\quad \\hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$ and\n",
    "\n",
    "\n",
    "$y = 1 \\quad \\rightarrow \\quad \\hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$ \n",
    "\n",
    "\n",
    "i.e. a binary bit string of length $C$, where $C = 10$ is the number of classes in the MNIST dataset (numbers from $0$ to $9$)..  \n",
    "\n",
    "If $\\hat{x}_i$ is the $i$-th input (image), $y_{ic}$ refers to the $c$-th component of the $i$-th\n",
    "output vector $\\hat{y}_i$.  \n",
    "The probability of $\\hat{x}_i$ being in class $c$ will be given by the softmax function:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "P(y_{ic} = 1 \\mid \\hat{x}_i, \\hat{\\theta}) = \\frac{\\exp{((\\hat{a}_i^{hidden})^T \\hat{w}_c)}}\n",
    "{\\sum_{c'=0}^{C-1} \\exp{((\\hat{a}_i^{hidden})^T \\hat{w}_{c'})}} ,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "which reduces to the logistic function in the binary case.  \n",
    "The likelihood of this $C$-class classifier\n",
    "is now given as:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "P(\\mathcal{D} \\mid \\hat{\\theta}) = \\prod_{i=1}^n \\prod_{c=0}^{C-1} [P(y_{ic} = 1)]^{y_{ic}} .\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Again we take the negative log-likelihood to define our cost function:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\mathcal{C}(\\hat{\\theta}) = - \\log{P(\\mathcal{D} \\mid \\hat{\\theta})}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "See the logistic regression lectures for a full definition of the cost function.\n",
    "\n",
    "The back propagation equations need now only a small change, namely the definition of a new cost function. We are thus ready to use the same equations as before!\n",
    "\n",
    "## Example: binary classification problem\n",
    "\n",
    "As an example of the above, relevant for project 2 as well, let us consider a binary class. As discussed in our logistic regression lectures, we defined a cost function in terms of the parameters $\\beta$ as"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\mathcal{C}(\\hat{\\beta}) = - \\sum_{i=1}^n \\left(y_i\\log{p(y_i \\vert x_i,\\hat{\\beta})}+(1-y_i)\\log{1-p(y_i \\vert x_i,\\hat{\\beta})}\\right),\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where we had defined the logistic (sigmoid) function"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "p(y_i =1\\vert x_i,\\hat{\\beta})=\\frac{\\exp{(\\beta_0+\\beta_1 x_i)}}{1+\\exp{(\\beta_0+\\beta_1 x_i)}},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "p(y_i =0\\vert x_i,\\hat{\\beta})=1-p(y_i =1\\vert x_i,\\hat{\\beta}).\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The parameters $\\hat{\\beta}$ were defined using a minimization method like gradient descent or Newton-Raphson's method. \n",
    "\n",
    "Now we replace $x_i$ with the activation $z_i^l$ for a given layer $l$ and the outputs as $y_i=a_i^l=f(z_i^l)$, with $z_i^l$ now being a function of the weights $w_{ij}^l$ and biases $b_i^l$. \n",
    "We have then"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "a_i^l = y_i = \\frac{\\exp{(z_i^l)}}{1+\\exp{(z_i^l)}},\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "with"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "z_i^l = \\sum_{j}w_{ij}^l a_j^{l-1}+b_i^l,\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where the superscript $l-1$ indicates that these are the outputs from layer $l-1$.\n",
    "Our cost function at the final layer $l=L$ is now"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\mathcal{C}(\\hat{W}) = - \\sum_{i=1}^n \\left(t_i\\log{a_i^L}+(1-t_i)\\log{(1-a_i^L)}\\right),\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "where we have defined the targets $t_i$. The derivatives of the cost function with respect to the output $a_i^L$ are then easily calculated and we get"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial \\mathcal{C}(\\hat{W})}{\\partial a_i^L} = \\frac{a_i^L-t_i}{a_i^L(1-a_i^L)}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In case we use another activation function than the logistic one, we need to evaluate other derivatives. \n",
    "\n",
    "\n",
    "## The Softmax function\n",
    "In case we employ the more general case given by the Softmax equation, we need to evaluate the derivative of the activation function with respect to the activation $z_i^l$, that is we need"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial f(z_i^l)}{\\partial w_{jk}^l} =\n",
    "\\frac{\\partial f(z_i^l)}{\\partial z_j^l} \\frac{\\partial z_j^l}{\\partial w_{jk}^l}= \\frac{\\partial f(z_i^l)}{\\partial z_j^l}a_k^{l-1}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "For the Softmax function we have"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "f(z_i^l) = \\frac{\\exp{(z_i^l)}}{\\sum_{m=1}^K\\exp{(z_m^l)}}.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Its derivative with respect to $z_j^l$ gives"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "\\frac{\\partial f(z_i^l)}{\\partial z_j^l}= f(z_i^l)\\left(\\delta_{ij}-f(z_j^l)\\right),\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "which in case of the simply binary model reduces to  having $i=j$. \n",
    "\n",
    "<!-- !split  -->\n",
    "## Developing a code for doing neural networks with back propagation\n",
    "\n",
    "\n",
    "One can identify a set of key steps when using neural networks to solve supervised learning problems:  \n",
    "\n",
    "1. Collect and pre-process data  \n",
    "\n",
    "2. Define model and architecture  \n",
    "\n",
    "3. Choose cost function and optimizer  \n",
    "\n",
    "4. Train the model  \n",
    "\n",
    "5. Evaluate model performance on test data  \n",
    "\n",
    "6. Adjust hyperparameters (if necessary, network architecture)\n",
    "\n",
    "## Collect and pre-process data\n",
    "\n",
    "Here we will be using the MNIST dataset, which is readily available through the **scikit-learn**\n",
    "package. You may also find it for example [here](http://yann.lecun.com/exdb/mnist/).  \n",
    "The *MNIST* (Modified National Institute of Standards and Technology) database is a large database\n",
    "of handwritten digits that is commonly used for training various image processing systems.  \n",
    "The MNIST dataset consists of 70 000 images of size $28\\times 28$ pixels, each labeled from 0 to 9.  \n",
    "The scikit-learn dataset we will use consists of a selection of 1797 images of size $8\\times 8$ collected and processed from this database.  \n",
    "\n",
    "To feed data into a feed-forward neural network we need to represent\n",
    "the inputs as a design/feature matrix $X = (n_{inputs}, n_{features})$.  Each\n",
    "row represents an *input*, in this case a handwritten digit, and\n",
    "each column represents a *feature*, in this case a pixel.  The\n",
    "correct answers, also known as *labels* or *targets* are\n",
    "represented as a 1D array of integers \n",
    "$Y = (n_{inputs}) = (5, 3, 1, 8,...)$.\n",
    "\n",
    "As an example, say we want to build a neural network using supervised learning to predict Body-Mass Index (BMI) from\n",
    "measurements of height (in m)  \n",
    "and weight (in kg). If we have measurements of 5 people the design/feature matrix could be for example:  \n",
    "\n",
    "$$ X = \\begin{bmatrix}\n",
    "1.85 & 81\\\\\n",
    "1.71 & 65\\\\\n",
    "1.95 & 103\\\\\n",
    "1.55 & 42\\\\\n",
    "1.63 & 56\n",
    "\\end{bmatrix} ,$$  \n",
    "\n",
    "and the targets would be:  \n",
    "\n",
    "$$ Y = (23.7, 22.2, 27.1, 17.5, 21.1) $$  \n",
    "\n",
    "Since each input image is a 2D matrix, we need to flatten the image\n",
    "(i.e. \"unravel\" the 2D matrix into a 1D array) to turn the data into a\n",
    "design/feature matrix. This means we lose all spatial information in the\n",
    "image, such as locality and translational invariance. More complicated\n",
    "architectures such as Convolutional Neural Networks can take advantage\n",
    "of such information, and are most commonly applied when analyzing\n",
    "images."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "inputs = (n_inputs, pixel_width, pixel_height) = (1797, 8, 8)\n",
      "labels = (n_inputs) = (1797,)\n",
      "X = (n_inputs, n_features) = (1797, 64)\n"
     ]
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAArkAAACiCAYAAABF0NXFAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4wLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvqOYd8AAAC3NJREFUeJzt3V9opflZB/DnaWeh1j9zXBQR25loRWG92NyIipU5A4IgSALLimDbyYiCV2YW9UbQZKReiBebES/0ajNdwYoWEtBFEJ1EtlW0sBnwZkFK2rVYbGVPuq0iWn9enAyEZXY3+7znzDnzy+cDgcyS531+b86T3/meN+/JZmstAACgJ+9Z9AIAAGDWhFwAALoj5AIA0B0hFwCA7gi5AAB0R8gFAKA7Qu5DZOZBZv7io67l8WNWOA9zwnmZFc7DnJxP1yE3M48z8ycXvY63klMfz8wvZubJ6eD90KLXdRE9BrPyh5n5tTMf/52Zbyx6XReNOeG8HoNZ+bnMfPX0ueffM/NuZn7botd10ZiT+eo65D4Gno2IX4iIn4iIJyPi7yPixYWuiKXUWvvl1tq3PPiIiD+JiD9b9LpYLuaEd+HTEfHjrbXLEfF9EXEpIj6+2CWxhB7rObmQITczvz0z/yIzv5yZr59+/oE3fdmHMvMfM/OrmbmfmU+eqf/RzPxMZk4y835mjotL+d6IeLm19rnW2jci4o8j4qnisZiDJZqVs2v65oh4JiLuDj0Ws2FOOK9lmZXW2mutta+c+U/fiIjvrxyL2TMns3EhQ25Mz/uFiLgaEVci4r8i4g/e9DUfi+lV1u+OiP+NiN+PiMjM74mIv4zpK5knI+LXIuJTmfmdb26SmVdOB+zKW6zjkzEd0h/IzCci4kZE/NXAc2O2lmVWznomIr4cEX9XOSHmwpxwXkszK5n54cw8iYg3YjovO8NOjRkyJzNwIUNua+0/Wmufaq39Z2vtjYj4nYi49qYve7G19s+tta9HxG9GxM9m5nsj4iMR8VJr7aXW2v+11v46Ij4bET/9kD5faK2NWmtfeIul/FtEvBwRr8Z0gJ+NiOdmcpLMxBLNylk3IuITrbU26OSYGXPCeS3TrLTWXj79NfQHIuL3IuJ4JifJYOZkNi5kyM3M92fmH2Xm5zPzqzG90jE6HY4HXjvz+ecj4omI+I6Yvqp69vSVzyQzJxHx4Zi+knq3fisifjgiPhgR74uI2xHxt5n5/sKxmIMlmpUH67kSEeOI+ET1GMyeOeG8lm1WIiJaa1+M6W8RPznkOMyOOZmNS4tewIL8akT8YET8SGvtS5m5GhGvRESe+ZoPnvn8SkT8T0R8JaZD9WJr7ZdmsI7ViPjT1tq/nv57NzN3Ynpf7mdncHyGW5ZZeeCjEfHp1trnZnhMhjMnnNeyzcoDlyLiQ3M4LjXmZAYuwpXcJzLzfWc+LkXEt8b09oDJ6Y3aWw+p+0hmPnV6VfW3I+LPz7w57Gcy86cy872nxxw/5Ibw8/inmL7a+q7MfE9mfjSmr8T+pXSmDLXMs/LAxyJid0A9w5kTzmtpZyUzf/7BfZiZeTWmvw7/m+J5Mow5mZOLEHJfiumgPPjYjulN098U01c8/xAPf7PXizF9kvhSTG8l+JWI6TsNI2ItIn4jpm/qeC0ifj0e8r3M6Q3dX8u3vqH7dyPifkQcRcQkpvfjPtNam7z702QGlnlWIjN/LKb3RPmTUItlTjivZZ6VpyLiM5n59Zj+mahXI2IeV/54Z+ZkTtJ7EgAA6M1FuJILAMAFI+QCANAdIRcAgO4IuQAAdGdefyf3kb+bbXd3t1S3vb1d7jkajUp1Ozv1/yPeeDwu1w6Q7/wlJY98Tg4ODkp11fmKiNjb2yvVnZyclHveu3evVDdwvuY1JxELmJX9/f1S3ebm5oxX8s6qcx0RsbKyMrN1vAtLtaccHx+XG1b38yF7SnVvuHz5crnn0dFRqW7gfC3dnjKZ1P/40SJmpbre6uMdsVx7iiu5AAB0R8gFAKA7Qi4AAN0RcgEA6I6QCwBAd4RcAAC6I+QCANAdIRcAgO4IuQAAdEfIBQCgO0IuAADdEXIBAOiOkAsAQHcuLXoBZx0cHJRrb968WapbW1sr9xyNRqW69fX1cs/JZFKuJeLWrVuluiHf942NjVLdnTt3yj2rs9mb4+Pjcu2Qn9NHbW9vr1xb/ZnoySK+B3fv3i3X3rt3r1Q3ZE/x3DM15PtQ/TkdshdVe+7u7pZ7bm9vl2tnzZVcAAC6I+QCANAdIRcAgO4IuQAAdEfIBQCgO0IuAADdEXIBAOiOkAsAQHeEXAAAuiPkAgDQHSEXAIDuCLkAAHRHyAUAoDtCLgAA3cnW2jyOWzrorVu3yg2Pj49LdXt7e+We4/G4VDcajco9h6x3gJzTcecyfG+nOidDHrPDw8NS3Y0bN8o9J5NJuXaAec1JxAJmZWdnp1S3urpa7nn9+vVS3bVr18o9Dw4OyrUDdLOnLEL1ufLo6Kjcs7M5ibggs1LNKUP2sereOdBDZ8WVXAAAuiPkAgDQHSEXAIDuCLkAAHRHyAUAoDtCLgAA3RFyAQDojpALAEB3hFwAALoj5AIA0B0hFwCA7gi5AAB0R8gFAKA7lxa9gLNWVlbKtcfHx6W67e3tcs/Dw8NS3SuvvFLuyTCTyaRUV52viIitra1S3Wg0KvesrnfIz2BvNjY2SnVD9pSq6l4UUV/vIs6TqdXV1VLd7u5uuWd17xyyj/Wmui+vr6/PdiHnsLOz88h7zoMruQAAdEfIBQCgO0IuAADdEXIBAOiOkAsAQHeEXAAAuiPkAgDQHSEXAIDuCLkAAHRHyAUAoDtCLgAA3RFyAQDojpALAEB3hFwAALqTrbV5HHcuB307q6urpbr79++Xe964caNUt7u7W+65IDmn45bmZH9/v9xwfX29XPs42draKtVtb28PaTuvOYkozsrR0VG54Xg8LtWdnJyUe1ZV96KI+mO+srJS7hlLtqdcFEMes+reubOzU+4ZS7inDFHdj6p7UUR9P3rhhRfKPTc2Nsq1Azx0VlzJBQCgO0IuAADdEXIBAOiOkAsAQHeEXAAAuiPkAgDQHSEXAIDuCLkAAHRHyAUAoDtCLgAA3RFyAQDojpALAEB3hFwAALqTrbV5HHcuB307q6urj7pljEajUt2Qte7s7JRrB8g5Hbc0JwcHB+WGe3t7pbqjo6Nyz+Pj40feszqbA81rTiIWMCvXr18v11atra2V6qpzvUBLtadcFOPx+JH3HPIzGEu4p0wmk1mv4x0N2c+rj3n1eWto7QAPnRVXcgEA6I6QCwBAd4RcAAC6I+QCANAdIRcAgO4IuQAAdEfIBQCgO0IuAADdEXIBAOiOkAsAQHeEXAAAuiPkAgDQHSEXAIDuCLkAAHTn0qIXMCuj0ahUNx6Pyz23t7dLddW1LqrnshnymJ2cnJTqdnd3yz3X19dLdT09ZosyZFY2NzdLdXfu3Cn3vHnzZrmWxdjf3y/VXb16tdzz6OjokdZF1J97enN4eFiu3draKtXdvn273HNjY6NUN2Qvmkwmpbp5POe5kgsAQHeEXAAAuiPkAgDQHSEXAIDuCLkAAHRHyAUAoDtCLgAA3RFyAQDojpALAEB3hFwAALoj5AIA0B0hFwCA7gi5AAB059KiFzArzz33XKlufX293PP27dulurW1tXLP0WhUriXi9ddfL9WdnJyUe25sbJRrefw8/fTT5dohewOL8fzzz5fqDg8Pyz0vX75cqhuyF9nHpq5du1auHY/HpbrqjEVETCaTUt3m5ma55zLlFFdyAQDojpALAEB3hFwAALoj5AIA0B0hFwCA7gi5AAB0R8gFAKA7Qi4AAN0RcgEA6I6QCwBAd4RcAAC6I+QCANAdIRcAgO4IuQAAdCdba4teAwAAzJQruQAAdEfIBQCgO0IuAADdEXIBAOiOkAsAQHeEXAAAuiPkAgDQHSEXAIDuCLkAAHRHyAUAoDtCLgAA3RFyAQDojpALAEB3hFwAALoj5AIA0B0hFwCA7gi5AAB0R8gFAKA7Qi4AAN0RcgEA6I6QCwBAd4RcAAC6I+QCANCd/wfBp2WqC3Q/FQAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<Figure size 864x864 with 5 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# import necessary packages\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "from sklearn import datasets\n",
    "\n",
    "\n",
    "# ensure the same random numbers appear every time\n",
    "np.random.seed(0)\n",
    "\n",
    "# display images in notebook\n",
    "%matplotlib inline\n",
    "plt.rcParams['figure.figsize'] = (12,12)\n",
    "\n",
    "\n",
    "# download MNIST dataset\n",
    "digits = datasets.load_digits()\n",
    "\n",
    "# define inputs and labels\n",
    "inputs = digits.images\n",
    "labels = digits.target\n",
    "\n",
    "print(\"inputs = (n_inputs, pixel_width, pixel_height) = \" + str(inputs.shape))\n",
    "print(\"labels = (n_inputs) = \" + str(labels.shape))\n",
    "\n",
    "\n",
    "# flatten the image\n",
    "# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64\n",
    "n_inputs = len(inputs)\n",
    "inputs = inputs.reshape(n_inputs, -1)\n",
    "print(\"X = (n_inputs, n_features) = \" + str(inputs.shape))\n",
    "\n",
    "\n",
    "# choose some random images to display\n",
    "indices = np.arange(n_inputs)\n",
    "random_indices = np.random.choice(indices, size=5)\n",
    "\n",
    "for i, image in enumerate(digits.images[random_indices]):\n",
    "    plt.subplot(1, 5, i+1)\n",
    "    plt.axis('off')\n",
    "    plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest')\n",
    "    plt.title(\"Label: %d\" % digits.target[random_indices[i]])\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Train and test datasets\n",
    "\n",
    "Performing analysis before partitioning the dataset is a major error, that can lead to incorrect conclusions.  \n",
    "\n",
    "We will reserve $80 \\%$ of our dataset for training and $20 \\%$ for testing.  \n",
    "\n",
    "It is important that the train and test datasets are drawn randomly from our dataset, to ensure\n",
    "no bias in the sampling.  \n",
    "Say you are taking measurements of weather data to predict the weather in the coming 5 days.\n",
    "You don't want to train your model on measurements taken from the hours 00.00 to 12.00, and then test it on data\n",
    "collected from 12.00 to 24.00."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Number of training images: 1437\n",
      "Number of test images: 360\n"
     ]
    }
   ],
   "source": [
    "from sklearn.model_selection import train_test_split\n",
    "\n",
    "# one-liner from scikit-learn library\n",
    "train_size = 0.8\n",
    "test_size = 1 - train_size\n",
    "X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size,\n",
    "                                                    test_size=test_size)\n",
    "\n",
    "# equivalently in numpy\n",
    "def train_test_split_numpy(inputs, labels, train_size, test_size):\n",
    "    n_inputs = len(inputs)\n",
    "    inputs_shuffled = inputs.copy()\n",
    "    labels_shuffled = labels.copy()\n",
    "    \n",
    "    np.random.shuffle(inputs_shuffled)\n",
    "    np.random.shuffle(labels_shuffled)\n",
    "    \n",
    "    train_end = int(n_inputs*train_size)\n",
    "    X_train, X_test = inputs_shuffled[:train_end], inputs_shuffled[train_end:]\n",
    "    Y_train, Y_test = labels_shuffled[:train_end], labels_shuffled[train_end:]\n",
    "    \n",
    "    return X_train, X_test, Y_train, Y_test\n",
    "\n",
    "#X_train, X_test, Y_train, Y_test = train_test_split_numpy(inputs, labels, train_size, test_size)\n",
    "\n",
    "print(\"Number of training images: \" + str(len(X_train)))\n",
    "print(\"Number of test images: \" + str(len(X_test)))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Define model and architecture\n",
    "\n",
    "Our simple feed-forward neural network will consist of an *input* layer, a single *hidden* layer and an *output* layer. The activation $y$ of each neuron is a weighted sum of inputs, passed through an activation function. In case of the simple perceptron model we have \n",
    "\n",
    "$$ z = \\sum_{i=1}^n w_i a_i ,$$\n",
    "\n",
    "$$ y = f(z) ,$$\n",
    "\n",
    "where $f$ is the activation function, $a_i$ represents input from neuron $i$ in the preceding layer\n",
    "and $w_i$ is the weight to input $i$.  \n",
    "The activation of the neurons in the input layer is just the features (e.g. a pixel value).  \n",
    "\n",
    "The simplest activation function for a neuron is the *Heaviside* function:\n",
    "\n",
    "$$ f(z) = \n",
    "\\begin{cases}\n",
    "1,  &  z > 0\\\\\n",
    "0,  & \\text{otherwise}\n",
    "\\end{cases}\n",
    "$$\n",
    "\n",
    "A feed-forward neural network with this activation is known as a *perceptron*.  \n",
    "For a binary classifier (i.e. two classes, 0 or 1, dog or not-dog) we can also use this in our output layer.  \n",
    "This activation can be generalized to $k$ classes (using e.g. the *one-against-all* strategy), \n",
    "and we call these architectures *multiclass perceptrons*.  \n",
    "\n",
    "However, it is now common to use the terms Single Layer Perceptron (SLP) (1 hidden layer) and  \n",
    "Multilayer Perceptron (MLP) (2 or more hidden layers) to refer to feed-forward neural networks with any activation function.  \n",
    "\n",
    "Typical choices for activation functions include the sigmoid function, hyperbolic tangent, and Rectified Linear Unit (ReLU).  \n",
    "We will be using the sigmoid function $\\sigma(x)$:  \n",
    "\n",
    "$$ f(x) = \\sigma(x) = \\frac{1}{1 + e^{-x}} ,$$\n",
    "\n",
    "which is inspired by probability theory (see logistic regression) and was most commonly used until about 2011. See the discussion below concerning other activation functions.\n",
    "\n",
    "<!-- !split   -->\n",
    "## Layers\n",
    "\n",
    "* Input \n",
    "\n",
    "Since each input image has 8x8 = 64 pixels or features, we have an input layer of 64 neurons.  \n",
    "\n",
    "* Hidden layer\n",
    "\n",
    "We will use 50 neurons in the hidden layer receiving input from the neurons in the input layer.  \n",
    "Since each neuron in the hidden layer is connected to the 64 inputs we have 64x50 = 3200 weights to the hidden layer.  \n",
    "\n",
    "* Output\n",
    "\n",
    "If we were building a binary classifier, it would be sufficient with a single neuron in the output layer,\n",
    "which could output 0 or 1 according to the Heaviside function. This would be an example of a *hard* classifier, meaning it outputs the class of the input directly. However, if we are dealing with noisy data it is often beneficial to use a *soft* classifier, which outputs the probability of being in class 0 or 1.  \n",
    "\n",
    "For a soft binary classifier, we could use a single neuron and interpret the output as either being the probability of being in class 0 or the probability of being in class 1. Alternatively we could use 2 neurons, and interpret each neuron as the probability of being in each class.  \n",
    "\n",
    "Since we are doing multiclass classification, with 10 categories, it is natural to use 10 neurons in the output layer. We number the neurons $j = 0,1,...,9$. The activation of each output neuron $j$ will be according to the *softmax* function:  \n",
    "\n",
    "$$ P(\\text{class $j$} \\mid \\text{input $\\hat{a}$}) = \\frac{\\exp{(\\hat{a}^T \\hat{w}_j)}}\n",
    "{\\sum_{c=0}^{9} \\exp{(\\hat{a}^T \\hat{w}_c)}} ,$$  \n",
    "\n",
    "i.e. each neuron $j$ outputs the probability of being in class $j$ given an input from the hidden layer $\\hat{a}$, with $\\hat{w}_j$ the weights of neuron $j$ to the inputs.  \n",
    "The denominator is a normalization factor to ensure the outputs (probabilities) sum up to 1.  \n",
    "The exponent is just the weighted sum of inputs as before:  \n",
    "\n",
    "$$ z_j = \\sum_{i=1}^n w_ {ij} a_i+b_j.$$  \n",
    "\n",
    "Since each neuron in the output layer is connected to the 50 inputs from the hidden layer we have 50x10 = 500\n",
    "weights to the output layer.\n",
    "\n",
    "<!-- !split   -->\n",
    "## Weights and biases\n",
    "\n",
    "Typically weights are initialized with small values distributed around zero, drawn from a uniform\n",
    "or normal distribution. Setting all weights to zero means all neurons give the same output, making the network useless.  \n",
    "\n",
    "Adding a bias value to the weighted sum of inputs allows the neural network to represent a greater range\n",
    "of values. Without it, any input with the value 0 will be mapped to zero (before being passed through the activation). The bias unit has an output of 1, and a weight to each neuron $j$, $b_j$:  \n",
    "\n",
    "$$ z_j = \\sum_{i=1}^n w_ {ij} a_i + b_j.$$  \n",
    "\n",
    "The bias weights $\\hat{b}$ are often initialized to zero, but a small value like $0.01$ ensures all neurons have some output which can be backpropagated in the first training cycle."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "# building our neural network\n",
    "\n",
    "n_inputs, n_features = X_train.shape\n",
    "n_hidden_neurons = 50\n",
    "n_categories = 10\n",
    "\n",
    "# we make the weights normally distributed using numpy.random.randn\n",
    "\n",
    "# weights and bias in the hidden layer\n",
    "hidden_weights = np.random.randn(n_features, n_hidden_neurons)\n",
    "hidden_bias = np.zeros(n_hidden_neurons) + 0.01\n",
    "\n",
    "# weights and bias in the output layer\n",
    "output_weights = np.random.randn(n_hidden_neurons, n_categories)\n",
    "output_bias = np.zeros(n_categories) + 0.01"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Feed-forward pass\n",
    "\n",
    "Denote $F$ the number of features, $H$ the number of hidden neurons and $C$ the number of categories.  \n",
    "For each input image we calculate a weighted sum of input features (pixel values) to each neuron $j$ in the hidden layer $l$:  \n",
    "\n",
    "$$ z_{j}^{l} = \\sum_{i=1}^{F} w_{ij}^{l} x_i + b_{j}^{l},$$\n",
    "\n",
    "this is then passed through our activation function  \n",
    "\n",
    "$$ a_{j}^{l} = f(z_{j}^{l}) .$$  \n",
    "\n",
    "We calculate a weighted sum of inputs (activations in the hidden layer) to each neuron $j$ in the output layer:  \n",
    "\n",
    "$$ z_{j}^{L} = \\sum_{i=1}^{H} w_{ij}^{L} a_{i}^{l} + b_{j}^{L}.$$  \n",
    "\n",
    "Finally we calculate the output of neuron $j$ in the output layer using the softmax function:  \n",
    "\n",
    "$$ a_{j}^{L} = \\frac{\\exp{(z_j^{L})}}\n",
    "{\\sum_{c=0}^{C-1} \\exp{(z_c^{L})}} .$$  \n",
    "\n",
    "<!-- !split    -->\n",
    "## Matrix multiplications\n",
    "\n",
    "Since our data has the dimensions $X = (n_{inputs}, n_{features})$ and our weights to the hidden\n",
    "layer have the dimensions  \n",
    "$W_{hidden} = (n_{features}, n_{hidden})$,\n",
    "we can easily feed the network all our training data in one go by taking the matrix product  \n",
    "\n",
    "$$ X W^{h} = (n_{inputs}, n_{hidden}),$$ \n",
    "\n",
    "and obtain a matrix that holds the weighted sum of inputs to the hidden layer\n",
    "for each input image and each hidden neuron.    \n",
    "We also add the bias to obtain a matrix of weighted sums to the hidden layer $Z^{h}$:  \n",
    "\n",
    "$$ \\hat{z}^{l} = \\hat{X} \\hat{W}^{l} + \\hat{b}^{l} ,$$\n",
    "\n",
    "meaning the same bias (1D array with size equal number of hidden neurons) is added to each input image.  \n",
    "This is then passed through the activation:  \n",
    "\n",
    "$$ \\hat{a}^{l} = f(\\hat{z}^l) .$$  \n",
    "\n",
    "This is fed to the output layer:  \n",
    "\n",
    "$$ \\hat{z}^{L} = \\hat{a}^{L} \\hat{W}^{L} + \\hat{b}^{L} .$$\n",
    "\n",
    "Finally we receive our output values for each image and each category by passing it through the softmax function:  \n",
    "\n",
    "$$ output = softmax (\\hat{z}^{L}) = (n_{inputs}, n_{categories}) .$$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "probabilities = (n_inputs, n_categories) = (1437, 10)\n",
      "probability that image 0 is in category 0,1,2,...,9 = \n",
      "[2.48443475e-03 1.54597376e-01 5.26957024e-04 3.82351115e-03\n",
      " 4.17164973e-04 3.14102269e-05 3.46868062e-03 6.46863476e-01\n",
      " 5.69978744e-02 1.30789115e-01]\n",
      "probabilities sum up to: 1.0\n",
      "\n",
      "predictions = (n_inputs) = (1437,)\n",
      "prediction for image 0: 7\n",
      "correct label for image 0: 5\n"
     ]
    }
   ],
   "source": [
    "# setup the feed-forward pass, subscript h = hidden layer\n",
    "\n",
    "def sigmoid(x):\n",
    "    return 1/(1 + np.exp(-x))\n",
    "\n",
    "def feed_forward(X):\n",
    "    # weighted sum of inputs to the hidden layer\n",
    "    z_h = np.matmul(X, hidden_weights) + hidden_bias\n",
    "    # activation in the hidden layer\n",
    "    a_h = sigmoid(z_h)\n",
    "    \n",
    "    # weighted sum of inputs to the output layer\n",
    "    z_o = np.matmul(a_h, output_weights) + output_bias\n",
    "    # softmax output\n",
    "    # axis 0 holds each input and axis 1 the probabilities of each category\n",
    "    exp_term = np.exp(z_o)\n",
    "    probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)\n",
    "    \n",
    "    return probabilities\n",
    "\n",
    "probabilities = feed_forward(X_train)\n",
    "print(\"probabilities = (n_inputs, n_categories) = \" + str(probabilities.shape))\n",
    "print(\"probability that image 0 is in category 0,1,2,...,9 = \\n\" + str(probabilities[0]))\n",
    "print(\"probabilities sum up to: \" + str(probabilities[0].sum()))\n",
    "print()\n",
    "\n",
    "# we obtain a prediction by taking the class with the highest likelihood\n",
    "def predict(X):\n",
    "    probabilities = feed_forward(X)\n",
    "    return np.argmax(probabilities, axis=1)\n",
    "\n",
    "predictions = predict(X_train)\n",
    "print(\"predictions = (n_inputs) = \" + str(predictions.shape))\n",
    "print(\"prediction for image 0: \" + str(predictions[0]))\n",
    "print(\"correct label for image 0: \" + str(Y_train[0]))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Choose cost function and optimizer\n",
    "\n",
    "To measure how well our neural network is doing we need to introduce a cost function.  \n",
    "We will call the function that gives the error of a single sample output the *loss* function, and the function\n",
    "that gives the total error of our network across all samples the *cost* function.\n",
    "A typical choice for multiclass classification is the *cross-entropy* loss, also known as the negative log likelihood.  \n",
    "\n",
    "In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector:  \n",
    "\n",
    "$$ y = 5 \\quad \\rightarrow \\quad \\hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$$  \n",
    "\n",
    "\n",
    "$$ y = 1 \\quad \\rightarrow \\quad \\hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$$  \n",
    "\n",
    "\n",
    "i.e. a binary bit string of length $C$, where $C = 10$ is the number of classes in the MNIST dataset.  \n",
    "\n",
    "Let $y_{ic}$ denote the $c$-th component of the $i$-th one-hot vector.  \n",
    "We define the cost function $\\mathcal{C}$ as a sum over the cross-entropy loss for each point $\\hat{x}_i$ in the dataset.\n",
    "\n",
    "In the one-hot representation only one of the terms in the loss function is non-zero, namely the\n",
    "probability of the correct category $c'$  \n",
    "(i.e. the category $c'$ such that $y_{ic'} = 1$). This means that the cross entropy loss only punishes you for how wrong\n",
    "you got the correct label. The probability of category $c$ is given by the softmax function. The vector $\\hat{\\theta}$ represents the parameters of our network, i.e. all the weights and biases.  \n",
    "\n",
    "\n",
    "## Optimizing the cost function\n",
    "\n",
    "The network is trained by finding the weights and biases that minimize the cost function. One of the most widely used classes of methods is *gradient descent* and its generalizations. The idea behind gradient descent\n",
    "is simply to adjust the weights in the direction where the gradient of the cost function is large and negative. This ensures we flow toward a *local* minimum of the cost function.  \n",
    "Each parameter $\\theta$ is iteratively adjusted according to the rule  \n",
    "\n",
    "$$ \\theta_{i+1} = \\theta_i - \\eta \\nabla \\mathcal{C}(\\theta_i) ,$$\n",
    "\n",
    "where $\\eta$ is known as the *learning rate*, which controls how big a step we take towards the minimum.  \n",
    "This update can be repeated for any number of iterations, or until we are satisfied with the result.  \n",
    "\n",
    "A simple and effective improvement is a variant called *Batch Gradient Descent*.  \n",
    "Instead of calculating the gradient on the whole dataset, we calculate an approximation of the gradient\n",
    "on a subset of the data called a *minibatch*.  \n",
    "If there are $N$ data points and we have a minibatch size of $M$, the total number of batches\n",
    "is $N/M$.  \n",
    "We denote each minibatch $B_k$, with $k = 1, 2,...,N/M$. The gradient then becomes:  \n",
    "\n",
    "$$ \\nabla \\mathcal{C}(\\theta) = \\frac{1}{N} \\sum_{i=1}^N \\nabla \\mathcal{L}_i(\\theta) \\quad \\rightarrow \\quad\n",
    "\\frac{1}{M} \\sum_{i \\in B_k} \\nabla \\mathcal{L}_i(\\theta) ,$$\n",
    "\n",
    "i.e. instead of averaging the loss over the entire dataset, we average over a minibatch.  \n",
    "\n",
    "This has two important benefits:  \n",
    "1. Introducing stochasticity decreases the chance that the algorithm becomes stuck in a local minima.  \n",
    "\n",
    "2. It significantly speeds up the calculation, since we do not have to use the entire dataset to calculate the gradient.  \n",
    "\n",
    "The various optmization  methods, with codes and algorithms,  are discussed in our lectures on [Gradient descent approaches](https://compphysics.github.io/MachineLearning/doc/pub/Splines/html/Splines-bs.html).\n",
    "\n",
    "<!-- !split   -->\n",
    "## Regularization\n",
    "\n",
    "It is common to add an extra term to the cost function, proportional\n",
    "to the size of the weights.  This is equivalent to constraining the\n",
    "size of the weights, so that they do not grow out of control.\n",
    "Constraining the size of the weights means that the weights cannot\n",
    "grow arbitrarily large to fit the training data, and in this way\n",
    "reduces *overfitting*.\n",
    "\n",
    "We will measure the size of the weights using the so called *L2-norm*, meaning our cost function becomes:  \n",
    "\n",
    "$$  \\mathcal{C}(\\theta) = \\frac{1}{N} \\sum_{i=1}^N \\mathcal{L}_i(\\theta) \\quad \\rightarrow \\quad\n",
    "\\frac{1}{N} \\sum_{i=1}^N  \\mathcal{L}_i(\\theta) + \\lambda \\lvert \\lvert \\hat{w} \\rvert \\rvert_2^2 \n",
    "= \\frac{1}{N} \\sum_{i=1}^N  \\mathcal{L}(\\theta) + \\lambda \\sum_{ij} w_{ij}^2,$$  \n",
    "\n",
    "i.e. we sum up all the weights squared. The factor $\\lambda$ is known as a regularization parameter.\n",
    "\n",
    "\n",
    "In order to train the model, we need to calculate the derivative of\n",
    "the cost function with respect to every bias and weight in the\n",
    "network.  In total our network has $(64 + 1)\\times 50=3250$ weights in\n",
    "the hidden layer and $(50 + 1)\\times 10=510$ weights to the output\n",
    "layer ($+1$ for the bias), and the gradient must be calculated for\n",
    "every parameter.  We use the *backpropagation* algorithm discussed\n",
    "above. This is a clever use of the chain rule that allows us to\n",
    "calculate the gradient efficently. \n",
    "\n",
    "\n",
    "## Matrix  multiplication\n",
    "\n",
    "To more efficently train our network these equations are implemented using matrix operations.  \n",
    "The error in the output layer is calculated simply as, with $\\hat{t}$ being our targets,  \n",
    "\n",
    "$$ \\delta_L = \\hat{t} - \\hat{y} = (n_{inputs}, n_{categories}) .$$  \n",
    "\n",
    "The gradient for the output weights is calculated as  \n",
    "\n",
    "$$ \\nabla W_{L} = \\hat{a}^T \\delta_L   = (n_{hidden}, n_{categories}) ,$$\n",
    "\n",
    "where $\\hat{a} = (n_{inputs}, n_{hidden})$. This simply means that we are summing up the gradients for each input.  \n",
    "Since we are going backwards we have to transpose the activation matrix.  \n",
    "\n",
    "The gradient with respect to the output bias is then  \n",
    "\n",
    "$$ \\nabla \\hat{b}_{L} = \\sum_{i=1}^{n_{inputs}} \\delta_L = (n_{categories}) .$$  \n",
    "\n",
    "The error in the hidden layer is  \n",
    "\n",
    "$$ \\Delta_h = \\delta_L W_{L}^T \\circ f'(z_{h}) = \\delta_L W_{L}^T \\circ a_{h} \\circ (1 - a_{h}) = (n_{inputs}, n_{hidden}) ,$$  \n",
    "\n",
    "where $f'(a_{h})$ is the derivative of the activation in the hidden layer. The matrix products mean\n",
    "that we are summing up the products for each neuron in the output layer. The symbol $\\circ$ denotes\n",
    "the *Hadamard product*, meaning element-wise multiplication.  \n",
    "\n",
    "This again gives us the gradients in the hidden layer:  \n",
    "\n",
    "$$ \\nabla W_{h} = X^T \\delta_h = (n_{features}, n_{hidden}) ,$$  \n",
    "\n",
    "$$ \\nabla b_{h} = \\sum_{i=1}^{n_{inputs}} \\delta_h = (n_{hidden}) .$$"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Old accuracy on training data: 0.12526096033402923\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/ipykernel_launcher.py:4: RuntimeWarning: overflow encountered in exp\n",
      "  after removing the cwd from sys.path.\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "New accuracy on training data: 0.09812108559498957\n"
     ]
    }
   ],
   "source": [
    "# to categorical turns our integer vector into a onehot representation\n",
    "from sklearn.metrics import accuracy_score\n",
    "\n",
    "# one-hot in numpy\n",
    "def to_categorical_numpy(integer_vector):\n",
    "    n_inputs = len(integer_vector)\n",
    "    n_categories = np.max(integer_vector) + 1\n",
    "    onehot_vector = np.zeros((n_inputs, n_categories))\n",
    "    onehot_vector[range(n_inputs), integer_vector] = 1\n",
    "    \n",
    "    return onehot_vector\n",
    "\n",
    "#Y_train_onehot, Y_test_onehot = to_categorical(Y_train), to_categorical(Y_test)\n",
    "Y_train_onehot, Y_test_onehot = to_categorical_numpy(Y_train), to_categorical_numpy(Y_test)\n",
    "\n",
    "def feed_forward_train(X):\n",
    "    # weighted sum of inputs to the hidden layer\n",
    "    z_h = np.matmul(X, hidden_weights) + hidden_bias\n",
    "    # activation in the hidden layer\n",
    "    a_h = sigmoid(z_h)\n",
    "    \n",
    "    # weighted sum of inputs to the output layer\n",
    "    z_o = np.matmul(a_h, output_weights) + output_bias\n",
    "    # softmax output\n",
    "    # axis 0 holds each input and axis 1 the probabilities of each category\n",
    "    exp_term = np.exp(z_o)\n",
    "    probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)\n",
    "    \n",
    "    # for backpropagation need activations in hidden and output layers\n",
    "    return a_h, probabilities\n",
    "\n",
    "def backpropagation(X, Y):\n",
    "    a_h, probabilities = feed_forward_train(X)\n",
    "    \n",
    "    # error in the output layer\n",
    "    error_output = probabilities - Y\n",
    "    # error in the hidden layer\n",
    "    error_hidden = np.matmul(error_output, output_weights.T) * a_h * (1 - a_h)\n",
    "    \n",
    "    # gradients for the output layer\n",
    "    output_weights_gradient = np.matmul(a_h.T, error_output)\n",
    "    output_bias_gradient = np.sum(error_output, axis=0)\n",
    "    \n",
    "    # gradient for the hidden layer\n",
    "    hidden_weights_gradient = np.matmul(X.T, error_hidden)\n",
    "    hidden_bias_gradient = np.sum(error_hidden, axis=0)\n",
    "\n",
    "    return output_weights_gradient, output_bias_gradient, hidden_weights_gradient, hidden_bias_gradient\n",
    "\n",
    "print(\"Old accuracy on training data: \" + str(accuracy_score(predict(X_train), Y_train)))\n",
    "\n",
    "eta = 0.01\n",
    "lmbd = 0.01\n",
    "for i in range(1000):\n",
    "    # calculate gradients\n",
    "    dWo, dBo, dWh, dBh = backpropagation(X_train, Y_train_onehot)\n",
    "    \n",
    "    # regularization term gradients\n",
    "    dWo += lmbd * output_weights\n",
    "    dWh += lmbd * hidden_weights\n",
    "    \n",
    "    # update weights and biases\n",
    "    output_weights -= eta * dWo\n",
    "    output_bias -= eta * dBo\n",
    "    hidden_weights -= eta * dWh\n",
    "    hidden_bias -= eta * dBh\n",
    "\n",
    "print(\"New accuracy on training data: \" + str(accuracy_score(predict(X_train), Y_train)))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Improving performance\n",
    "\n",
    "As we can see the network does not seem to be learning at all. It seems to be just guessing the label for each image.  \n",
    "In order to obtain a network that does something useful, we will have to do a bit more work.  \n",
    "\n",
    "The choice of *hyperparameters* such as learning rate and regularization parameter is hugely influential for the performance of the network. Typically a *grid-search* is performed, wherein we test different hyperparameters separated by orders of magnitude. For example we could test the learning rates $\\eta = 10^{-6}, 10^{-5},...,10^{-1}$ with different regularization parameters $\\lambda = 10^{-6},...,10^{-0}$.  \n",
    "\n",
    "Next, we haven't implemented minibatching yet, which introduces stochasticity and is though to act as an important regularizer on the weights. We call a feed-forward + backward pass with a minibatch an *iteration*, and a full training period\n",
    "going through the entire dataset ($n/M$ batches) an *epoch*.\n",
    "\n",
    "If this does not improve network performance, you may want to consider altering the network architecture, adding more neurons or hidden layers.  \n",
    "Andrew Ng goes through some of these considerations in this [video](https://youtu.be/F1ka6a13S9I). You can find a summary of the video [here](https://kevinzakka.github.io/2016/09/26/applying-deep-learning/).  \n",
    "\n",
    "## Full object-oriented implementation\n",
    "\n",
    "It is very natural to think of the network as an object, with specific instances of the network\n",
    "being realizations of this object with different hyperparameters. An implementation using Python classes provides a clean structure and interface, and the full implementation of our neural network is given below."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "class NeuralNetwork:\n",
    "    def __init__(\n",
    "            self,\n",
    "            X_data,\n",
    "            Y_data,\n",
    "            n_hidden_neurons=50,\n",
    "            n_categories=10,\n",
    "            epochs=10,\n",
    "            batch_size=100,\n",
    "            eta=0.1,\n",
    "            lmbd=0.0):\n",
    "\n",
    "        self.X_data_full = X_data\n",
    "        self.Y_data_full = Y_data\n",
    "\n",
    "        self.n_inputs = X_data.shape[0]\n",
    "        self.n_features = X_data.shape[1]\n",
    "        self.n_hidden_neurons = n_hidden_neurons\n",
    "        self.n_categories = n_categories\n",
    "\n",
    "        self.epochs = epochs\n",
    "        self.batch_size = batch_size\n",
    "        self.iterations = self.n_inputs // self.batch_size\n",
    "        self.eta = eta\n",
    "        self.lmbd = lmbd\n",
    "\n",
    "        self.create_biases_and_weights()\n",
    "\n",
    "    def create_biases_and_weights(self):\n",
    "        self.hidden_weights = np.random.randn(self.n_features, self.n_hidden_neurons)\n",
    "        self.hidden_bias = np.zeros(self.n_hidden_neurons) + 0.01\n",
    "\n",
    "        self.output_weights = np.random.randn(self.n_hidden_neurons, self.n_categories)\n",
    "        self.output_bias = np.zeros(self.n_categories) + 0.01\n",
    "\n",
    "    def feed_forward(self):\n",
    "        # feed-forward for training\n",
    "        self.z_h = np.matmul(self.X_data, self.hidden_weights) + self.hidden_bias\n",
    "        self.a_h = sigmoid(self.z_h)\n",
    "\n",
    "        self.z_o = np.matmul(self.a_h, self.output_weights) + self.output_bias\n",
    "\n",
    "        exp_term = np.exp(self.z_o)\n",
    "        self.probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)\n",
    "\n",
    "    def feed_forward_out(self, X):\n",
    "        # feed-forward for output\n",
    "        z_h = np.matmul(X, self.hidden_weights) + self.hidden_bias\n",
    "        a_h = sigmoid(z_h)\n",
    "\n",
    "        z_o = np.matmul(a_h, self.output_weights) + self.output_bias\n",
    "        \n",
    "        exp_term = np.exp(z_o)\n",
    "        probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)\n",
    "        return probabilities\n",
    "\n",
    "    def backpropagation(self):\n",
    "        error_output = self.probabilities - self.Y_data\n",
    "        error_hidden = np.matmul(error_output, self.output_weights.T) * self.a_h * (1 - self.a_h)\n",
    "\n",
    "        self.output_weights_gradient = np.matmul(self.a_h.T, error_output)\n",
    "        self.output_bias_gradient = np.sum(error_output, axis=0)\n",
    "\n",
    "        self.hidden_weights_gradient = np.matmul(self.X_data.T, error_hidden)\n",
    "        self.hidden_bias_gradient = np.sum(error_hidden, axis=0)\n",
    "\n",
    "        if self.lmbd > 0.0:\n",
    "            self.output_weights_gradient += self.lmbd * self.output_weights\n",
    "            self.hidden_weights_gradient += self.lmbd * self.hidden_weights\n",
    "\n",
    "        self.output_weights -= self.eta * self.output_weights_gradient\n",
    "        self.output_bias -= self.eta * self.output_bias_gradient\n",
    "        self.hidden_weights -= self.eta * self.hidden_weights_gradient\n",
    "        self.hidden_bias -= self.eta * self.hidden_bias_gradient\n",
    "\n",
    "    def predict(self, X):\n",
    "        probabilities = self.feed_forward_out(X)\n",
    "        return np.argmax(probabilities, axis=1)\n",
    "\n",
    "    def predict_probabilities(self, X):\n",
    "        probabilities = self.feed_forward_out(X)\n",
    "        return probabilities\n",
    "\n",
    "    def train(self):\n",
    "        data_indices = np.arange(self.n_inputs)\n",
    "\n",
    "        for i in range(self.epochs):\n",
    "            for j in range(self.iterations):\n",
    "                # pick datapoints with replacement\n",
    "                chosen_datapoints = np.random.choice(\n",
    "                    data_indices, size=self.batch_size, replace=False\n",
    "                )\n",
    "\n",
    "                # minibatch training data\n",
    "                self.X_data = self.X_data_full[chosen_datapoints]\n",
    "                self.Y_data = self.Y_data_full[chosen_datapoints]\n",
    "\n",
    "                self.feed_forward()\n",
    "                self.backpropagation()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Evaluate model performance on test data\n",
    "\n",
    "To measure the performance of our network we evaluate how well it does it data it has never seen before, i.e. the test data.  \n",
    "We measure the performance of the network using the *accuracy* score.  \n",
    "The accuracy is as you would expect just the number of images correctly labeled divided by the total number of images. A perfect classifier will have an accuracy score of $1$.  \n",
    "\n",
    "$$ \\text{Accuracy} = \\frac{\\sum_{i=1}^n I(\\hat{y}_i = y_i)}{n} ,$$  \n",
    "\n",
    "where $I$ is the indicator function, $1$ if $\\hat{y}_i = y_i$ and $0$ otherwise."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy score on test set:  0.9333333333333333\n"
     ]
    }
   ],
   "source": [
    "epochs = 100\n",
    "batch_size = 100\n",
    "\n",
    "dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size,\n",
    "                    n_hidden_neurons=n_hidden_neurons, n_categories=n_categories)\n",
    "dnn.train()\n",
    "test_predict = dnn.predict(X_test)\n",
    "\n",
    "# accuracy score from scikit library\n",
    "print(\"Accuracy score on test set: \", accuracy_score(Y_test, test_predict))\n",
    "\n",
    "# equivalent in numpy\n",
    "def accuracy_score_numpy(Y_test, Y_pred):\n",
    "    return np.sum(Y_test == Y_pred) / len(Y_test)\n",
    "\n",
    "#print(\"Accuracy score on test set: \", accuracy_score_numpy(Y_test, test_predict))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Adjust hyperparameters\n",
    "\n",
    "We now perform a grid search to find the optimal hyperparameters for the network.  \n",
    "Note that we are only using 1 layer with 50 neurons, and human performance is estimated to be around $98\\%$ ($2\\%$ error rate)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.20555555555555555\n",
      "\n",
      "Learning rate  =  1e-05\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.1527777777777778\n",
      "\n",
      "Learning rate  =  1e-05\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.14722222222222223\n",
      "\n",
      "Learning rate  =  1e-05\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.16666666666666666\n",
      "\n",
      "Learning rate  =  1e-05\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.24444444444444444\n",
      "\n",
      "Learning rate  =  1e-05\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.17222222222222222\n",
      "\n",
      "Learning rate  =  1e-05\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.19444444444444445\n",
      "\n",
      "Learning rate  =  0.0001\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.625\n",
      "\n",
      "Learning rate  =  0.0001\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.5888888888888889\n",
      "\n",
      "Learning rate  =  0.0001\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.5527777777777778\n",
      "\n",
      "Learning rate  =  0.0001\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.6222222222222222\n",
      "\n",
      "Learning rate  =  0.0001\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.5666666666666667\n",
      "\n",
      "Learning rate  =  0.0001\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.6083333333333333\n",
      "\n",
      "Learning rate  =  0.0001\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.8333333333333334\n",
      "\n",
      "Learning rate  =  0.001\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.8472222222222222\n",
      "\n",
      "Learning rate  =  0.001\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.8722222222222222\n",
      "\n",
      "Learning rate  =  0.001\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.8666666666666667\n",
      "\n",
      "Learning rate  =  0.001\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.8583333333333333\n",
      "\n",
      "Learning rate  =  0.001\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.8777777777777778\n",
      "\n",
      "Learning rate  =  0.001\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.9333333333333333\n",
      "\n",
      "Learning rate  =  0.001\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.9277777777777778\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.9083333333333333\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.9361111111111111\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.9361111111111111\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.9472222222222222\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.9527777777777777\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.9277777777777778\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.45\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/ipykernel_launcher.py:4: RuntimeWarning: overflow encountered in exp\n",
      "  after removing the cwd from sys.path.\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.1\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.08333333333333333\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.08333333333333333\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.08611111111111111\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/ipykernel_launcher.py:43: RuntimeWarning: overflow encountered in exp\n",
      "/usr/local/lib/python3.7/site-packages/ipykernel_launcher.py:44: RuntimeWarning: invalid value encountered in true_divide\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1.0\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n"
     ]
    }
   ],
   "source": [
    "eta_vals = np.logspace(-5, 1, 7)\n",
    "lmbd_vals = np.logspace(-5, 1, 7)\n",
    "# store the models for later use\n",
    "DNN_numpy = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)\n",
    "\n",
    "# grid search\n",
    "for i, eta in enumerate(eta_vals):\n",
    "    for j, lmbd in enumerate(lmbd_vals):\n",
    "        dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size,\n",
    "                            n_hidden_neurons=n_hidden_neurons, n_categories=n_categories)\n",
    "        dnn.train()\n",
    "        \n",
    "        DNN_numpy[i][j] = dnn\n",
    "        \n",
    "        test_predict = dnn.predict(X_test)\n",
    "        \n",
    "        print(\"Learning rate  = \", eta)\n",
    "        print(\"Lambda = \", lmbd)\n",
    "        print(\"Accuracy score on test set: \", accuracy_score(Y_test, test_predict))\n",
    "        print()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Visualization"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/ipykernel_launcher.py:4: RuntimeWarning: overflow encountered in exp\n",
      "  after removing the cwd from sys.path.\n"
     ]
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAkIAAAJgCAYAAABmwww9AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4wLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvqOYd8AAAIABJREFUeJzs3Xd4FNUax/HvtjSS0JLQq1KkNxFFuhhAqoCKCl4QC0oX2wUVK4gUsQIK0hGQXi5FULAAioL0YqGHThLSt90/NgaGqpLsutnfx2cfmdmzM+fNmZ09+845sya32+1GREREJACZfV0BEREREV9RR0hEREQCljpCIiIiErDUERIREZGApY6QiIiIBCx1hERERCRgqSMk4kVvvPEG7dq1o127dlSpUoXY2Nis5bS0tL+8nTVr1vDGG29cs8yJEyd44IEHbrTKlxk+fDhVqlTh+PHj2b5tERFvM+k+QiK+0bRpU8aOHUvVqlV9XZW/LD09nUaNGlG/fn2KFCnCoEGDfF0lEZEbooyQyL9IlSpV6NevH7GxsWzfvp0vvviCzp070759e5o0acLMmTMBmD9/Pk888QQAXbt2ZdSoUTz00EM0bdqUZ599FpfLxZEjR6hZsyYA77//Pi+88AKPPvooLVq04MEHH+TEiRMAbNu2jXvvvZc2bdrw9NNP06FDBzZt2nTF+i1btoySJUvyn//8hzlz5pCampr13B9//EHXrl255557aNOmDcuXL7/m+qZNm7J9+/as1/+5fOTIERo1akSPHj2IjY3l5MmTjBs3jk6dOtGmTRvuuusuVq9eDYDD4WDYsGHExsbSqlUrBg8eTEZGBrGxsXz77bdZ2x4yZAhTpkzJljYSkdxFHSGRfxG73U6TJk1YuXIlZcuWZe7cuUyYMIGFCxcyZswY3nnnnSu+7tChQ0ybNo3FixezceNGfvjhh8vKbN68mbFjx7JixQoiIyOZPXs2DoeDPn360K9fP5YsWULXrl3ZvXv3Ves3a9Ys2rZtS9WqVYmOjmbBggVZzw0cOJAWLVqwbNkyJkyYwOjRo0lKSrrq+ms5fvw4Tz31FCtXrsRut/P9998zffp0lixZwoABA3jvvfcAmDlzJjt37mTRokUsXbqU5ORkli9fTpcuXZg7dy4ASUlJrFmzhg4dOlz37y8igcfq6wqIiFGdOnUAyJMnD+PGjWPdunUcOHCAPXv2kJKScsXXNGnSBLPZTHh4OKVKlSIhIYHixYsbytStW5fw8HAAKlWqREJCAvv27QOgUaNGANSrV49y5cpdcR87d+5k9+7dTJgwAYD27dszdepUunTpQkJCAnv27KFz584AFClShC+//JL4+Pgrrr8eq9VKjRo1AChWrBhvv/02S5Ys4eDBg/zyyy8kJycD8P3339OuXTtCQkIAePfddwFITEzkww8/5OzZs6xYsYLGjRsTGRl53f2KSOBRRkjkXyYsLAzwZEXat2/P0aNHqV27Nv3797/qa/7sCACYTCauNPTvSmUsFstlZS0WyxX3MXPmTKxWKx07dqRp06ZMmzaNAwcOsH79eqxWa9Z2//T7779nbevS9X8ODL943xkZGVn/DgoKytrmzp07eeCBB0hKSqJ+/fr07Nkzq9yfZf50+vRpTp48SWRkJC1atGDx4sXMmzePLl26XDEmERF1hET+pXbs2EGBAgV46qmnaNCgAV999RUATqcz2/Zx0003ERQUxPr16wHPeKF9+/YZOi7gybAsW7aMcePGsXbtWtauXcv69etp27YtkydPJjw8nMqVK7Nw4UIA4uLi6NKlC2lpaVdcf/78eQoUKMCOHTsA2Lp1K6dOnbpiHX/88UeqVKlC9+7dqVu3LmvWrMn6G9x+++0sXbqUjIwMXC4XQ4cOZdmyZQA89NBDTJ06FbfbTbVq1bLtbyYiuYsujYn8S9WvX58vvviCFi1aEBoaSrVq1ShQoAAHDx7Mtn1YrVbef/99XnnlFUaPHk3p0qWJiooyZI8AFixYwE033US9evUM63v16sU999zDvn37GDVqFK+++irTpk3DZDLx5ptvEh0dfdX1gwYNYujQocyePZvKlStTuXLlK9axdevWrFq1ilatWmGz2bj99ttJSEggKSmJBx54gKNHj3LvvffidrupW7cuXbt2BaBixYrkzZs3R24hICK5h6bPiwS4t99+m0cffZSoqCji4uJo164dX375pd+PqTl06BBdu3ZlxYoVhIaG+ro6IvIvpYyQSIArVqwY//nPf7Barbjdbt544w2/7wSNHTuWOXPmMHjwYHWCROSalBESERERv/HnZfFx48ZdNjt29+7dDBkyhKSkJOrUqcOrr7562aSKS2mwtIiIiPiFX375hS5dunDgwIEr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gf8NmvnnlBESERGRgKWMkIiIiBgE0g0VlRESERGRgKWMkIiIiBgoIyQiIiISAJQREhEREYMAmjSmjJCIiIgELmWERERExEBjhEREREQCgDJCIiIiYhRAg4SUERIREZGApY6QiIiIBCxdGhMREREDDZYWERERCQDKCImIiIiBW4OlRURERHI/ZYRERETEQGOERERERAKAMkIiIiJipIyQiIiISO6njJCIiIgYaNaYiIiISABQRkhERESMlBESERERyf2UERIRERED3UdIREREJAAoIyQiIiJGGiMkIiIikvupIyQiIiIBS5fGRERExECDpUVEREQCgF9mhEpaI3xdBRHxMrvb4esq+NQeu93XVfCpLuOe83UVfGrXW17eoQZLi4iIiOR+fpkREhERkZykMUIiIiIiuZ4yQiIiImKkMUIiIiIi/y5LliyhVatWNG/enBkzZlz2/O+//07Xrl1p27Ytjz76KAkJCdfdpjpCIiIiYuT24uMvOnHiBGPGjGHmzJksWrSI2bNn8+uvv16osttNr169eOyxx1i8eDG33HILEyZMuO521RESERGRf73vv/+eevXqkS9fPsLCwoiNjWXFihVZz+/cuZOwsDAaNmwIwJNPPslDDz103e1qjJCIiIgYefHO0omJiSQmJl62PjIyksjIyKzlkydPEh0dnbUcExPDtm3bspYPHTpEVFQUzz//PLt27aJ8+fK89NJL192/MkIiIiLiM1OmTKFZs2aXPaZMmWIo53Zffh3NZLrQYXM4HPzwww88/PDDLFmyhBIlSjB8+PDr7l8ZIRERETG4Qp8jxzzyyCN06NDhsvUXZ4MAChUqxObNm7OWT548SUxMTNZydHQ0pUqVomrVqgC0bt2avn37Xnf/ygiJiIiIz0RGRlK8ePHLHpd2hO644w42bNjA2bNnSU1NZdWqVVnjgQBq1qzJ2bNn2bNnDwBr166lcuXK192/MkIiIiJi9C+8j1ChQoUYMGAA3bp1w26306lTJ6pVq8Zjjz1G3759qVq1Kh9++CFDhgwhNTWVwoULM2LEiOtuVx0hERER8Qtt2rShTZs2hnWffPJJ1r+rV6/OF1988be2qUtjIiIiErCUERIREREjL06f9zVlhERERCRgKSMkIiIiBqZ/4WDpnKKMkIiIiAQsZYRERETESBkhERERkdxPGSEREREx0qwxERER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UaN/VnMRkWxQMD+8/ryTZ16xYrdDiaJu3vyvk517TAx9x8LciQ7KlIRHH3TxUC8rLjfUqurmxX6eD/yeD7n475sWOvzHczrt9R8nVSr6R0cob37oNSid0a8H47BDoaJuej+Xzm97zYwbHcQ749MoWsJN+/sdDO4TgssNFau4eLS3Z/xMtycy+GRsEIMe93QEbq3vpFUH/5k+fzY5lSFfrGLMg62xWcwcPpvAi3NXULlYIV7vcBf3fjDjmq//es/vFMobztTHO2M2mTh2LpEh81d7qfY5zD8O4Wxhcrvd1wz38OHD7Nmzh71797J371727NnDsWPHKF68OCtXrvRWPQ1cx8v7ZL8i4jt2t/98wOaEPXb/GHeTU7qMG+jrKvjUrrcGeHV/Zd8d7bV9/d7ft2173YxQiRIlKFGiBM2bN89al5KSwr59+3K0YiIiIuIjAZQR+kc3uwgLC6NGjRrZXRcRERERr/Kf4f0iIiLiFYF0HyH/uP2piIiISA5QRkhERESMlBESERERyf3UERIREZGApUtjIiIiYqRLYyIiIiK5nzJCIiIiYqDp8yIiIiIBQBkhERERMXKbfF0Dr1FGSERERAKWMkIiIiJipDFCIiIiIrmfMkIiIiJioFljIiIiIgFAGSERERExUkZIREREJPdTRkhEREQMNEZIREREJAAoIyQiIiJGygiJiIiI5H7qCImIiEjA0qUxERERMdKlMREREZHcTxkhERERMdD0eREREZEAoI6QiIiIBCx1hERERCRgaYyQiIiIGGmMkIiIiEjup4yQiIiIGGjWmIiIiEgA8MuMUGzR6r6ugviKSX33gOV2+boG4kPFTBt9XQXfesvL+1NGSERERCT388uMkIiIiOQgZYREREREcj9lhERERMRAs8ZEREREAoA6QiIiIhKwdGlMREREjHRpTERERCT3U0ZIREREDDRYWkRERCQAKCMkIiIiRsoIiYiIiOR+ygiJiIiIkTJCIiIiIrmfMkIiIiJioFljIiIiIgFAGSERERExUkZIREREJPdTRkhERESMlBESERERyf2UERIREREDzRoTERERCQDqCImIiEjA0qUxERERMdKlMREREZHcTxkhERERMdBgaREREZEAoIyQiIiIGCkjJCIiIpL7KSMkIiIiRsoIiYiIiOR+ygiJiIiIgcnXFfAiZYREREQkYCkjJCIi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\n",
      "text/plain": [
       "<Figure size 720x720 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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G0P/F7vx5B2TL3j/j2ZuYNArtzPt074YwNyp69mz07/OZDwfX57mf7UyzHNdeekq17bOiPyuQr6xnfCfM0SuiH+4NuJ/ToHg/K5BvskqXTS/q5CvguL/2699s0D+L8fIT6t2vOzT420/5Lu1VHXLHvLZsf4JXQdJRERELJz6qVY9AyIiIiJ5KYMkIiIiFjrNXxkkERERES/KIImIiIiFzmJTBklERETEizJIIiIiYuE0lT/RMyAiIiKShzJIIiIiYuFS/kTPgIiIiEheyiCJiIiIhc5iUwZJRERExIsySCIiImKhs9iUQRIRERHxogGSiIiISB6aYhMRERELlxZpK4MkIiIikpcySCIiImLhVP5Ez4CIiIhIXsogiYiIiIVO81cGSURERMSLMkgiIiJioR+rVQZJRERExIsySCIiImLhNHUdJGWQRERERPJQBklEREQsdB0kZZBEREREvCiDJCIiIhYuXQdJGSQRERGRvJRBEhEREQutQVIGSURERMSLBkgiIiIieWiKTURERCx0oUhlkERERES8+GUG6eAwe35XId9kpkXndxXylZnul132sgkulp7fVcg3maf/220fEBqW31XIVyPqLM/vKuSzl316NP1YrTJIIiIiIl7+21/JRERExItTF4pUBklEREQkL2WQRERExMKFzmJTBklEREQkD2WQRERExEJrkJRBEhEREfGiDJKIiIhY6MdqlUESERER8aIMkoiIiFi49FtsyiCJiIiI5KUMkoiIiFhoDZIySCIiIiJeNEASERERyUNTbCIiImLh0oUilUESERERyUsZJBEREbFw6sdqlUESERERyUsZJBEREbHQGiRlkERERES8KIMkIiIiFlqDpAySiIiIiBdlkERERMRCa5CUQRIRERHxogySiIiIWDiVQVIGSURERCQvZZBERETEwqWz2JRBEhEREclLGSQRERGx0BokZZBEREREvCiDJCIiIhYuU2uQlEESERERyUMDJBEREZE8NMUmIiIiFk7lTzRA+stNJarwdPWWBNns7D59nKHbl5KanWUpUzU8iheuu4VCgcG4TJMR33/GzlNHMICBNVpzU4nKmKbJgZQkRnz/GSez0vInmH+hRalKPFu7OUF2O7tOHmfwNytIcVjjH1q3Je3KxXI6MwOAfckn6PvVEoJsdkbUb8MN0eVIy85i3eHfmbhjE2Z+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+KMpNhEREbnqNW7cmLi4OJKSkkhPT2f16tU0a9bMUsY0TXbu3EmdOnU8+woWLMjMmTP58ccfAZg7dy5t2rS56PGUQRIREREL11V4mn90dDQDBgzgvvvuw+FwcPvtt1OrVi0eeeQRnnrqKWrWrElSUhKBgYEEBwd77me325k4cSIvvvgiGRkZlC9fnjFjxlz0ePqpET+jnxr5b4/p9VMj/136qRH91IgvPfztAz471sx67/nsWP/Ef/vTRkRERLw4fXia/9VKa5BERERE8lAGSURERCz0Y7XKIImIiIh4UQZJRERELHz5UyNXK2WQRERERPJQBklEREQsrsbrIPmaMkgiIiIieSiDJCIiIhZag6QMkoiIiIgXZZBERETEQtdBUgZJRERExIsGSCIiIiJ5aIpNRERELLRIWxkkERERES/KIImIiIiFLhSpDJKIiIiIF2WQRERExEJrkJRBEhEREfGiDJKIiIhYKIOkDJKIiIiIF2WQRERExEIZJGWQRERERLz4ZQbplesW5XcV8k2k/Ux+VyFfObDndxXylcP878YfZsvI7yrkqxqB2fldhXzlwJXfVfhPUQZJGSQRERERL36ZQRIREZErR1fSVgZJRERExIsySCIiImKhNUjKIImIiIh40QBJREREJA9NsYmIiIiFptiUQRIRERHxogySiIiIWCiDpAySiIiIiBdlkERERMRCGSRlkERERES8KIMkIiIiFqYySMogiYiIiOSlDJKIiIhY6MdqlUESERER8aIMkoiIiFjoLDZlkERERES8KIMkIiIiFjqLTRkkERERES/KIImIiIiF1iApgyQiIiLiRQMkERERkTw0xSYiIiIWWqStDJKIiIiIF2WQRERExEKLtJVBEhEREfGiDJKIiIhYmGZ+1yD/KYMkIiIikocySCIiImLhQmuQlEESERERyUMZJBEREbHQdZCUQRIRERHxogxSjl1bnXz+XhbZDihRwcZt/YMoUNA6gt65OZu1cx0YNggpZHBrvyCKlXSPMV/ukUZ48bPlm94WSJ0W/vP07tgCC9+1ke2A0hXggQEuQkKtZbZ/DUs+sGEzoGAhuH+Ai6gYmDrKxvH4s+USj0LVWtD3JZdvg7gEP22BJe+CIyf+ewbgFf8PX8PyD8DIif+eARAZAzNGQUKe+KvUgide8m0Ml2LnFpNl77rIdkBMBbhrgI2Q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OZfLZUMlsMvXX3+tkSNHavLkybriiivsLsdy48ePV3p6uo4dO6Zly5bZXY5lli9frnr16qlDhw52l2KLVq1aae7cuQoJCVHt2rU1aNAgffjhh3aXZZmioiKlp6frmWee0bJly5SRkaFVq1bZXRYswIBUTlFRUcrOzvZsZ2VlOfJyk1Pt3r1bd999tyZOnKgBAwbYXY6lDh06pH379kmSqlevrh49eujAgQM2V2Wd9evX65NPPlG/fv00b948bdmyRU8//bTdZVlm165dSk9P92y73W5HrUWqU6eOOnTooNq1a6tatWrq3r27o64eOBkDUjl17NhR6enpysnJ0dmzZ7Vp0ybFxMTYXRYscOzYMd1///169tlnlZCQYHc5lsvMzNT06dN1/vx5nT9/Xh988IHatGljd1mWWbRokdatW6c1a9Zo/Pjx6tatm6ZNm2Z3WZY5ffq05s6dq/z8fJ05c0arVq1yzA0KktS1a1d9/PHHys3NVVFRkT766CNde+21dpcFCzjn14D/o6ioKCUlJWn48OEqKCjQoEGD1KJFC7vLggXefPNN5efna/bs2Z7nBg8erCFDhthYlXU6d+6sPXv2qH///vL391ePHj0cOSg6VdeuXT3//sXFxRo6dKhatWpld1mWiY6OVmJiooYOHaqCggJ16tRJt956q91lwQIud2mLawAAAByMS2wAAAAmDEgAAAAmDEgAAAAmDEgAAAAmDEgAAAAmDEgAAAAmDEgAAAAmDEgAyqVXr16KiYnR119/bXcpAOBzDEgAymXdunW64oortHHjRrtLAQCfY0ACUC7+/v5q06aNo96oFoBz8V5sAMrl3Llzev/998W7EwFwAhIkAOWSnJysqKgoHTlyRL/88ovd5QCATzEgASjT559/rrS0NL300ksKDQ3VwYMH7S4JAHyKAQnAReXn52vq1Kl64oknFB4erubNm7MOCcB/PAYkABf14osvqlWrVurSpYskqXnz5tq/f7+9RQGAjzEgAbigvXv3Ki0tTdOmTfM8d/XVV5MgAfiP53JzSwoAAIABCRIAAIAJAxIAAIAJAxIAAIAJAxIAAIAJAxIAAIAJAxIAAIAJAxIAAIAJAxIAAIDJ/wC3yaif4ROKsgAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<Figure size 720x720 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# visual representation of grid search\n",
    "# uses seaborn heatmap, you can also do this with matplotlib imshow\n",
    "import seaborn as sns\n",
    "\n",
    "sns.set()\n",
    "\n",
    "train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "\n",
    "for i in range(len(eta_vals)):\n",
    "    for j in range(len(lmbd_vals)):\n",
    "        dnn = DNN_numpy[i][j]\n",
    "        \n",
    "        train_pred = dnn.predict(X_train) \n",
    "        test_pred = dnn.predict(X_test)\n",
    "\n",
    "        train_accuracy[i][j] = accuracy_score(Y_train, train_pred)\n",
    "        test_accuracy[i][j] = accuracy_score(Y_test, test_pred)\n",
    "\n",
    "        \n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(train_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Training Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()\n",
    "\n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(test_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Test Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## scikit-learn implementation\n",
    "\n",
    "**scikit-learn** focuses more\n",
    "on traditional machine learning methods, such as regression,\n",
    "clustering, decision trees, etc. As such, it has only two types of\n",
    "neural networks: Multi Layer Perceptron outputting continuous values,\n",
    "*MPLRegressor*, and Multi Layer Perceptron outputting labels,\n",
    "*MLPClassifier*. We will see how simple it is to use these classes.\n",
    "\n",
    "**scikit-learn** implements a few improvements from our neural network,\n",
    "such as early stopping, a varying learning rate, different\n",
    "optimization methods, etc. We would therefore expect a better\n",
    "performance overall."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.2\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.2111111111111111\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.18333333333333332\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.23333333333333334\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.16111111111111112\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.25277777777777777\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  1e-05\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.2611111111111111\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.0001\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.8833333333333333\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.0001\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.8805555555555555\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.0001\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.8805555555555555\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.0001\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.8777777777777778\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.0001\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.8972222222222223\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.0001\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.9\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.0001\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.8888888888888888\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.001\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.9638888888888889\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.001\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.9666666666666667\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.001\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.9555555555555556\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.001\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.9638888888888889\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.001\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.9666666666666667\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.001\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.9583333333333334\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.001\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.9333333333333333\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.9694444444444444\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.9722222222222222\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.9694444444444444\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/usr/local/lib/python3.7/site-packages/sklearn/neural_network/multilayer_perceptron.py:562: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n",
      "  % self.max_iter, ConvergenceWarning)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate  =  0.01\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.9694444444444444\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.9805555555555555\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.9583333333333334\n",
      "\n",
      "Learning rate  =  0.01\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.9361111111111111\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.9083333333333333\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.9555555555555556\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.9055555555555556\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.8611111111111112\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.8944444444444445\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.9194444444444444\n",
      "\n",
      "Learning rate  =  0.1\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.8222222222222222\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.16944444444444445\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.09166666666666666\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.14444444444444443\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.12222222222222222\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.09722222222222222\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  1.0\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.12222222222222222\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  1e-05\n",
      "Accuracy score on test set:  0.12222222222222222\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.0001\n",
      "Accuracy score on test set:  0.15555555555555556\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.001\n",
      "Accuracy score on test set:  0.20833333333333334\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.01\n",
      "Accuracy score on test set:  0.10555555555555556\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  0.1\n",
      "Accuracy score on test set:  0.10277777777777777\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  1.0\n",
      "Accuracy score on test set:  0.09722222222222222\n",
      "\n",
      "Learning rate  =  10.0\n",
      "Lambda =  10.0\n",
      "Accuracy score on test set:  0.1527777777777778\n",
      "\n"
     ]
    }
   ],
   "source": [
    "from sklearn.neural_network import MLPClassifier\n",
    "# store models for later use\n",
    "DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)\n",
    "\n",
    "for i, eta in enumerate(eta_vals):\n",
    "    for j, lmbd in enumerate(lmbd_vals):\n",
    "        dnn = MLPClassifier(hidden_layer_sizes=(n_hidden_neurons), activation='logistic',\n",
    "                            alpha=lmbd, learning_rate_init=eta, max_iter=epochs)\n",
    "        dnn.fit(X_train, Y_train)\n",
    "        \n",
    "        DNN_scikit[i][j] = dnn\n",
    "        \n",
    "        print(\"Learning rate  = \", eta)\n",
    "        print(\"Lambda = \", lmbd)\n",
    "        print(\"Accuracy score on test set: \", dnn.score(X_test, Y_test))\n",
    "        print()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Visualization"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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pqWlMWTIEObMmUOVKlWYPXs2Tz/9NNOnT//b9ashJCIiIn5zfhfYxRQpUoSvvvoqczoxMZHY2NjM6YSEBMLCwqhSpQoA//3vf5k0adIFyzlfcPcziIiIyAXcGD77+6dq167Ntm3bOHHiBKmpqWzcuJF69eplvl6mTBkOHz7Mr7/+CsCmTZuIi4u75HKVERIREZFrXpEiRRgwYAAdOnTA6XTy0EMPUaVKFbp160bfvn2Ji4tj1KhR9O/fH9M0KVSoEK+88soll6vB0gFGg6WDO4kZzAOGgzl20GBpDZb27WDp7l+399m63qw2z2fryk5wf6qIiIhIUFNDSERERIKWxgiJiIiIhS9vn/e34IlURERE5DzKCImIiIiF51/c1h7olBESERGRoKWMkIiIiFi4ffijq/6mjJCIiIgELWWERERExEJ3jYmIiIgEAWWERERExMKjMUIiIiIiuZ8yQiIiImKh5wiJiIiIBAFlhERERMRCY4REREREgoAyQiIiImKh5wiJiIiIBAE1hERERCRoqWtMRERELDRYWkRERCQIKCMkIiIiFnqgooiIiEgQUEZIRERELDRGSERERCQIKCMkIiIiFsoIiYiIiAQBZYRERETEQhkhERERkSAQkBmhlnlO+bsKIiI+5Tad/q6CX502z/i7CkFFGSERERGRIBCQGSERERHJOXqytIiIiEgQUEZIRERELDRGSERERCQIqCEkIiIiQUtdYyIiImKhrjERERGRIKCMkIiIiFgoIyQiIiISBJQREhEREQtlhERERESCgDJCIiIiYmEqIyQiIiKS+ykjJCIiIhb60VURERGRIKCMkIiIiFjorjERERGRIKCMkIiIiFjorjERERGRIKCMkIiIiFhojJCIiIhIEFBDSERERIKWusZERETEQoOlRURERIKAMkIiIiJiocHSIiIiIkFAGSERERGxME1/18B3lBESERGRoKWMkIiIiFh40BghERERkVxPGSERERGx0HOERERERIKAMkL/kmnCkNEG5cpCpza5Z1j9x9tg4nQbGU4ofz28/LSHqDzWMvOXGixYbhAWBteXNhk6wCR/NCQlw8vjDeJ/NogIh/ubmLR7MPdsm7/k1n3/Tyn+3Bn/lm0Gk2bYz577Ji8+5b7g3F+wzMbC5TbCQ6FsGZMh/d3ki4aTyTBigj3z3L+viYdHHvD4J5DL9Nk2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ar+JSJBx4/F3Ffwq3Qzu+H1Og6VFREREcr+AzAiJiIhITtIYIREREZFcTxkhERERsdIYIREREZFry+rVq2natCkNGzZk/vz5F7z+66+/0r59e1q2bEmXLl04efLkJZephpCIiIhYmT78+4eOHDnChAkTWLBgAStXrmTRokX8/PPPWVU2TXr06EG3bt1YtWoVN910E9OnT7/kctU1JiIiIn6TnJxMcnLyBfOjo6OJjo7OnN66dSs1a9Ykf/78ADRq1Ij169fTu3dvAHbu3ElkZCT16tUDoHv37tku93xqCImIiIiVD58sPWfOHCZPnnzB/N69e9OnT5/M6cTERGJiYjKnY2Nj+f777zOn9+3bR+HChXn66af56aefKF++PMOGDbvk+tUQEhEREb957LHHuP/++y+Yf242CLxdX+czjKwGm8vl4osvvuCdd94hLi6OiRMnMnr0aEaPHv2361dDSERERCyyaXPkmPO7wC6mSJEifPXVV5nTiYmJxMbGZk7HxMRQpkwZ4uLiAGjevDl9+/a95HI1WFpERESuebVr12bbtm2cOHGC1NRUNm7cmDkeCKBq1aqcOHGC+Ph4ADZv3kylSpUuuVxlhERERMTqGnyOUJEiRRgwYAAdOnTA6XTy0EMPUaVKFbp160bfvn2Ji4tjypQpDB06lNTUVIoWLcqYMWMuuVzDzK7T7RrnOVze31UQEfEpp+nydxX86rgnzd9V8KviJQ76dH1lZl66AXG1/N7lKZ+tKzvqGhMREZGgpa4xERERsfLh7fP+poyQiIiIBC1lhERERMTCCLjRw5dPGSEREREJWsoIiYiIiJUyQiIiIiK5nzJCIiIiYqW7xkRERERyP2WERERExEpjhERERERyP2WERERExEoZIREREZHcTxkhERERsVJGSERERCT3U0ZIRERErPQcIREREZHcTw0hERERCVrqGhMRERELQ4OlRURERHI/ZYRERETEKogyQmoI/UumCc+NhnJloXMbf9fGt4I5dlD8ij93xr9lm8GkGXYynFD+epMXn3ITlcdaZsEyGwuX2wgPhbJlTIb0d5MvGk4mw4gJduJ/NogIh/uaeHjkAY9/ArlM2z6389ZbYTgzDK6/3s3gwWnkOS/+ZctCWLEilNAwkzKlPfTrl0Z0tPe1FStDWLc2hPQMKF/ew+BBaYSG+j4OuXzqGvsXftkL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SlKjRo300ksvuTos5CMqQnnkcDhyPGez2VwQCVzlwIED6tatm4YOHaqyZcu6OhzTDRgwQLGxsUpISNCSJUtcHY5pli5dqtKlS6tOnTquDsUlqlWrpgkTJsjPz09BQUHq0KGDNm3a5OqwTJOVlaXY2FhNnDhRS5Ys0e7du7V8+XJXh4V8RCKUR+Hh4Tp9+rRzOTEx0ZKniaxqx44deu655zR48GA9+eSTrg7HVIcOHdKePXskSb6+vmrevLn27dvn4qjMs3r1am3ZskWPP/643n33XW3YsEFjx451dVim2b59u2JjY53LDofDUnOFQkJCVKdOHQUFBalo0aJq0qSJpc4GWAGJUB7VrVtXsbGxSk5O1uXLlxUTE6P69eu7OiyYICEhQS+88IImTZqk1q1buzoc08XFxWnEiBG6cuWKrly5oq+//lo1atRwdVimmTdvnlatWqUVK1ZowIABaty4sYYPH+7qsEyTmpqqCRMmKD09XRcuXNDy5cstc6GAJDVq1EibN29WSkqKsrKy9N133+n+++93dVjIR9ZJ6/+i8PBwDRw4UJ07d1ZGRoY6dOigyMhIV4cFE8yZM0fp6ekaN26c87mOHTvq6aefdmFU5mnQoIF27typJ554Qp6enmrevLklE0KratSokXP87Xa7OnXqpGrVqrk6LNNUqVJFPXr0UKdOnZSRkaF69eqpffv2rg4L+cjmyG3yCwAAgAVwagwAAFgWiRAAALAsEiEAAGBZJEIAAMCySIQAAIBlkQgBAADLIhECAACWRSIEIE9atWql+vXr68CBA64OBQDyDYkQgDxZtWqVypYtq7Vr17o6FADINyRCAPLE09NTNWrUsNQXrgJwf3zXGIA8SUtL05dffim+lQeAO6EiBCBPoqOjFR4eruPHj+vixYuuDgcA8gWJEICb+vnnn7VmzRq999578vf31/79+10dEgDkCxIhADeUnp6uV199VW+88YZKlCihiIgI5gkBcBskQgBuaOrUqapWrZoaNmwoSYqIiNDevXtdGxQA5BMSIQDXtWvXLq1Zs0bDhw93PlepUiUqQgDchs3BJSAAAMCiqAgBAADLIhECAACWRSIEAAAsi0QIAABYFokQAACwLBIhAABgWSRCAADAskiEAACAZf0/pYUXzUFs7ecAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 720x720 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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ywNQuXJlVqxYAcC5c+do06YNQ4cOBeC7776jf//+tGjR4m+vT32QREREJMfbsmULderUoXDhwuTLl4+mTZuydu3aDJedMmUKtWvXplatWoA3QVq+fDktW7bkueee4/Tp03+5PiVIIiIiYuExjaA9kpKSOHToUMAjKSnJ0qbjx48TFRXlm46OjiY+Pj6g7UlJSbz33nt0797dNy8qKooePXqwYsUKSpQowbBhw/7yPdApNhEREck2s2bNYuLEiQHzu3fvTo8ePXzTpmkGLGMYgacCV61aRePGjX39jQDeeust39+dO3emcePGf9kuJUgiIiJiEczrILVv357WrVsHzI+MjLRMx8TEsHPnTt/08ePHiY6ODnjeJ598wpNPPumbPnPmDEuWLKFDhw6AN9FyOP46/dEpNhEREck2kZGRlC5dOuDhnyDVq1ePrVu3kpiYyLlz51i3bh0NGjSwLGOaJnv27KFGjRq+efny5WPatGl8++23AMydO5cmTZr8ZbtUQRIREZEcLyYmht69e/PYY4/hdDp54IEHqFatGl26dOGZZ54hNjaWxMREwsLCiIiI8D3Pbrczfvx4hg4dyvnz5ylbtiwjR478y/UZZkYn9XK4j369IbubkG3cKvrlau5cfPn/wraU7G6CZKPzZlh2NyFbNSn3Y1DX12bLU0Fb1+J6k4O2rn8i9x5tRURERC5Bp9hERETEIideKDLYVEESERER8aMKkoiIiFjoZrWqIImIiIgEUAVJRERELFRBUgVJREREJIAqSCIiImKhCpIqSCIiIiIBQrKCdFue5OxuQrax5fKcNsV0ZncTslUew57dTcg2uX3fTzVd2d2EbJXoyb3H/eygCpIqSCIiIiIBQrKCJCIiIllHV9JWBUlEREQkgCpIIiIiYqE+SKogiYiIiARQgiQiIiLiR6fYRERExEKn2FRBEhEREQmgCpKIiIhYqIKkCpKIiIhIAFWQRERExEIVJFWQRERERAKogiQiIiIWpipIqiCJiIiI+FMFSURERCx0s1pVkEREREQCqIIkIiIiFhrFpgqSiIiISABVkERERMRCo9hUQRIREREJoAqSiIiIWKgPkipIIiIiIgGUIImIiIj40Sk2ERERsVAnbVWQRERERAKogiQiIiIW6qStCpKIiIhIAFWQRERExMI0s7sF2U8VJBERERE/qiCJiIiIhQf1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IiIiYqFBbKogiYiIiARQBUlEREQs1AdJFSQRERGRAKogiYiIiJU6IamCJCIiIuJPCZKIiIiIH51iExEREQt10lYFSURERCSAKkgiIiJiYaqTtipIIiIiIv5UQRIREREL9UFSBUlEREQkgCpIIiIiYqUKkipIIiIiIv5UQRIRERELjWJTBUlEREQkgCpIIiIiYqUKkipIIiIiIv5UQRIRERELXQdJFSQRERGRAKogiYiIiJX6IKmCJCIiIuJPCZKIiIiEhFWrVnHPPffQpEkT5s2bF/D/X375hUcffZSWLVvSqVMnTp8+DcCRI0do164dd999N0899RTJycl/uS4lSCIiImJhmkbQHn9XfHw848aNY/78+axYsYJFixbx008/XdRmk6eeeoouXbqwcuVKKleuzNSpUwF46aWXePjhh1m7di1Vq1Zl0qRJf7k+JUgiIiKSbZKSkjh06FDAIykpybLcli1bqFOnDoULFyZfvnw0bdqUtWvX+v6/Z88e8uXLR4MGDQDo2rUr7dq1w+l0smPHDpo2bQrA/fffb3nepYRkJ21bLs7rbOTuoZf5jLDsboJkk4hcvu1TTVd2NyFb5d6jfjYJYiftWbNmMXHixID53bt3p0ePHr7p48ePExUV5ZuOjo5m9+7dvukDBw5QrFgxnn/+eX744QcqVKjAoEGDOHnyJAUKFMDh8KY8UVFRxMfH/2W7QjJBEhERkf+G9u3b07p164D5kZGRlmkzgxvEGcaFooHL5eLLL79k7ty5xMbGMn78eF577TV69+592eddihIkERER8RO8sxWRkZEByVBGYmJi2Llzp2/6+PHjREdH+6ajoqK45ppriI2NBaBFixY888wzFClShLNnz+J2u7Hb7SQkJFiedymqWoqIiEiOV69ePbZu3UpiYiLnzp1j3bp1vv5GADVq1CAxMZG4uDgANmzYQJUqVQgLC6NWrVqsWbMGgOXLl1uedymqIImIiIhVDrxQZExMDL179+axxx7D6XTywAMPUK1aNbp06cIzzzxDbGwsb731FgMHDuTcuXMUL16ckSNHAjBkyBD69+/P5MmTKVGiBGPHjv3L9RlmRif1crhzR8tldxOyTW7vpO3JiZ9aCYrc3kk7yXMuu5uQrU55cncn9bKljwZ3fbNeD9q6fmv/fNDW9U+ogiQiIiJW+i2qPkgiIiIi/lRBEhEREat/cIXr/ypVkERERET8qIIkIiIiFqE3fCvzqYIkIiIi4kcVJBEREbFSBUkVJBERERF/SpBERERE/OgUm4iIiFhpmL8qSCIiIiL+VEESERERC0OdtFVBEhEREfGnCpKIiIhYqYKkCpKIiIiIP1WQRERExEqj2FRBEhEREfGnCpKIiIhYqQ+SKkgiIiIi/lRBEhEREStVkFRBEhEREfGnCpKIiIhYqYKkCpKIiIiIP1WQRERExErXQVIFSURERMSfEiQRERERPzrFJiIiIhaGOmmrgiQiIiLiTxUkERERsVIFSQnSnzZtNXjzHTtpToPrrzUZ2s9FgfzWZRYstbFwmZ2IcJNrrzEZ0MtNoUh4brCDA4cvLHfkmEHN6iYTXnEFN4grsGmrwYR37KQ5ocK1Ji/1cwfEP3+pjQXLbOQJh3LXmLyYHn+fwXYOHr4w4uHwMahZ3eTNV9xBjuLf0/bP3fF/thXGTYU0J1S8FoY/T0D8c5fAvGWQJwKuvRoG9YbCkeB2w8vjYee33uUa1IG+T4ERIoOAvthqY/K0cNKcUP5aDy/2TQuI/b2lDhYvdxARDmWv8dC3ZxqFIr3/e3+5g5VrHKSmQqUK3ueHhwc/jn9r+zYHM6dF4HRCuWs99H7uHPn94l+xLIyVy8MJj4Crr/bQ7ZlzREZalxk2JC9Fipp0f+Z88BovWcowTTPk8sRzR8tl6uslnoL/6xDGuxOdXFMaxk+xk5wCL/a+8AW/Y5fBiyMczJnkJCYaPlhn47MvbIweZv0S+D7OoO8QBzPfdFI8OlObCYCNzD/qJp6C1h0czJ7o4prSMG6KjeQUGNjb41vmy10GL4ywM3eSi+LRsGqdwadf2Bg7zJoEfR9n8OwQO7PedGVJ/J4s+FkTSts/K4RK/BFGWOa+YLrEU3Bve5j3FpQtDaPfhuQUGNLnwjLbv4bnX4GFk6B4NKz4CDZshgnDYNmH3unpY8BjwsNPQ6eH4O47MredSZ5zmfuCwMlT8NDjeZn65nmuLm0ycUoYKSnQr7fTt8zOXTaGvhLO9EmpxESZrFlnZ9NmO6+9lManm+y8PT2MqW+ep2ABGDA0nBsqeWj/cOYnx6c8WfCapwye6JSfcRNSKFXaw7SpEZw7Z9Cj54Uk55tddka9lpfxE5OJijL55OMwtm52MGjohe3x3sJw3n8vnAYNXVmWIJUtfTRLXvdSyr05Jmjr+rXHs0Fb1z8RtD5Iv/32G/Hx8QAsXryY4cOHs2bNmmCt/rK27rBRpZLJNaW9021auvnwExsXp44/7DW4paaHmPSD/p31PWzcauC8cBzB6YTBrzro2z1rkoOssnWHQdWL4n+wpYc1GcRfp6bpi+vO+maG8Q981U6/7u4Qiz+3b//cHf/mHVC1kjc5AnioFXzwCZb49+yDujXxxdWkAXy6xVtxcnvg3Hnv32lp4HRBRIhUULbvsFO5ooerS3uDvb+Vi7XrHZbY4/bZuLmmh5go78w76rv5YqsdpxPWrLPz8INOCkWCzQb9+6TRrEnoVI6/3mmnYkU3pUp7fwy2aJnGhvVhlvj377dT4yYXUenx33abk+3bHL59/5tddnbucND8Xqf/y0uI+8sEacaMGdx0001Ur16dZs2a0atXLyZPnsyGDRs4dOjQ31rJu+++S6dOnWjbti0DBgxg9erVlCtXjiVLlvDWW29dcRBXKv44FI+68ImIiYKzyQbJKReWqVrZZMcuG0eOeadXfGjD6TQ4lXRhmWVrbEQVNWlUP7SKcseOG38r/i93GZeNf2l6/HeGWPy5ffvn9viPHYcSFyV0GcUfW9lbRTqcHv+yD/HF3/puiCwIDf8PGtwPV5eCO24Nbgz/VnyCQUz0hUpxdJRJsl/sVSp52LnLxtFj3ur1B2sdOJ0Gp5PgwCEbJ08a9OwXQbtOeXjn3TAKFgid7Z+QYKPYRft+VJRJSrJBykXxV6rk5ptvHMTHe+P/6KMwnE6DpCSDP04YvP1WHp5/4Ry2/9iQJ8MM3iOn+ss+SFOmTGHkyJFUq1aNgwcPsm/fPvbu3cumTZvYv38/ANdffz0LFiy45GssWbKENWvWcOLECVq0aMG2bduIiIigTZs2PPDAA3Tr1i3zIvoXPJfYQPaLdvia1U2ebO+mzyAHNgNa3eOhUKRJ2EXv4NzFdgY9Gzr9Lv50qfgv/sDXqm7Stb2bXoMc2AyT++4xM4jfxuBnQ+fX45+0/TOen2vi92Q8/+L9v3Z1eLoD9BjonX9/M3zxv/UuXFUIPl8OqanQ/UWYuQge/18wWn9lzEvEfvG2r1HdQ+fHnDw/OALDMLm3mZvI9NhdLtj+lZ1Rw1OJCIeXXgtn8vQw+nQPjWrKpbb9xfHHVnPzyKOpDBucD8MGTe9Oo2BBDzYDhr+cl67dzlO0aA7+lpd/7S8TpAIFCtCwYUMcDgfR0dHUrFnT8v9Dhw75EqVL8Xg8hIeHU6pUKTp27EhERITvf2539n+hloiG73+80Lfn+AmILGiSN++FZZJToGZ1D62bez9RfyTCpBl2X0fFuP0GbjfUujH0Piglok2++/HCEeHP+PP5xV+rusn9zb1fgH8kwlszbL74f9wPrpCNP7dv/1wefwzs/vHCdPwJKJTB/l+7OjzQ3Dt9IhHemOHtpP3x5zDwGQgP8z7uuxs+2hgaCVJMjMn3F332ExKMDLd9jRs9tGzu7VvzRyJMmRlGZCREFTVpeNuFAR13N3YxY3bW9BXLCtHRJnFxF/b9EycMChQ0yXNR/CkpEFvdxd33eJO+k4kGs2ZGcPSojWPHbEyZnMc33+MBZ1oeej/3H+iorVuN/PUptieeeILFixdf8v+lS5fmjjsu3xvxrrvu4pFHHsHtdtOjRw8A4uLiePjhh2nWrNk/bHLmq1vbw+4fDH5PP2P4/ko7DW+1/rRIOAGde4VxNtk7PXW2nbsbeXwjVXZ+Y3BzDU/IjFy5WN3apiX+xStt3HGr9Yvu+Ano2Mvhi3/KbBvNLPHbuLmGGaLx5/btn7vjv7U2fPsD/JYe/6KV0MjvFNnxE9C+F774J8+G5nd6R6rdcD18+Kl3vtPl7bxd/Ybgtf9K3FLLzfc/2jlwyLvhlq5yUP9W64/WEycMnuoV4Yt9xpww7mrkwjCg0e1u1m+0cz7V22dr02YHlStdoiyTA9Ws5SLuBzuHD3m/ClevCqduPWv1648/bPTrk5/k9PjnzY2gYSMXN1RxM2/hWSZPTWby1GSa3+ukQUPXfyM5EuBvjGKrUaMGTqeTBg0aUL9+fSpXrkzFihXJe/FPjL9hx44d1K5d2zf9yy+/cPDgQW6//fZ/3OjMHsUG8Pk27zBnp9OgdEmT4S+4OHTE4KVRdt6b7q2aLFxqY9FyOx4TasR66N/TTZ70Ytgr4+1EFTHp8ljWHhyyYhQbeOOf8I6342WZkiYjXnBz6IjB0FF2FqfHv2CpjYXLbXhMuCnWZMBF8Y8YbyOqCDyRxfFnxSg2CJ3tn1VCIf6sGsUGsHGbd5i/0wllSsFrL8ChIzBoFCyb7l1m3lKYv4z0/R8G9fIO+T95GkZMgB/2e0+/1b0J+nXDcvoxM2TFKDaAzdtsTHonHJcLSpU0GTIglSNHbYwYFc7cad4v+8XLHLy/3IHHhOpVPTzXM408Ed5LHMyc6+DjTx14PFDxeg/9+wReJiAzZMUoNoAvtzuYMS0ClwtKlPDQt/85jh21MW5MXiZP9WZFK5aHsWpFOKYHqlR10+2Z81x0IgSAObMiOH3a+M+MYrt2/NigreuXXn3+eqFs8JcJ0sGDB4mLi2Pv3r3s3buXuLg4jhw5QunSpfnoo4+C1U6LrEiQQkVWJUihIqsSJMn5sjJBCgVZlSCFiqxKkEKFEqTg+8vfOGXKlKFMmTI0adLENy8lJYV9+/ZlacNEREQkm+i36L+7DlK+fPm48cYbM7stIiIiIjmCbjUiIiIiFjn5+kTB8h+7tJWIiIjIlVMFSURERKxUQVIFSURERMSfEiQRERERPzrFJiIiIlY6xaYKkoiIiIg/VZBERETEQsP8VUESERERCaAKkoiIiGD/zCsAACAASURBVFiZufu+n6AKkoiIiEgAVZBERETESn2QVEESERER8acKkoiIiFhoFJsqSCIiIiIBVEESERERK1WQVEESERER8acKkoiIiFioD5IqSCIiIiIBVEESERERK1WQVEESERER8acESURERMSPTrGJiIiIlU6xqYIkIiIi4k8VJBEREbHQMH9VkEREREQCKEESERER8aMESURERMSP+iCJiIiIlfogqYIkIiIi4k8VJBEREbHQKDZVkEREREQChGQF6Xtn7k1tr3X8f3v3Hd5U2Ydx/JsmKaXQgqWDqUwFVKYWQQQBkVERUVTgfQXZQ0RZMkQZgrKLAxFkCIIoyBLRAsILMqoyFKqCCCgyO1gtdNA2ef8IBk7CKNomLdyf68p19Zw8p+f35JykT+/zJEn3dgletT/d6u0SvOpAeqi3S/CaEpbT3i7Bq4LMt+7rHsDXSdW8XYJXveLpHd7apxugBElERETETZ5MkERERCQHKUFSgiQiIiLiSgmSiIiIGOhdbEqQRERERNxogCQiIiLiQpfYRERExEiX2JQgiYiIiLhSgiQiIiIGmqStBElERETEjQZIIiIiYmT34O0GrFy5kubNm9O4cWMWLFhw1XYbNmygYcOGzuVt27ZRq1YtWrZsScuWLRkyZMh196VLbCIiIpLrxcbGEhkZydKlS/H19aVNmzbUqlWL8uXLG9olJCQwbtw4w7qYmBg6depE9+7ds7w/JUgiIiJi5MEEKTExkSNHjrjdEhMTDSVt3bqVBx54gMKFC+Pv70+TJk2IiopyK33YsGH07t3bsC4mJoYtW7bwxBNP0KNHD44fP37dh0ADJBEREfGauXPn0qhRI7fb3LlzDe3i4uIICQlxLoeGhhIbG2toM2/ePCpXrkzVqlUN6wMCAmjfvj3Lly+nfv369O3b97p16RKbiIiIGHjyXWwdOnSgVatWbusDAwMNy3a7e1Emk8n58759+1izZg0fffQRJ06cMLQbNWqU8+e2bdsyadIkkpKSCAgIuGpdGiCJiIiI1wQGBroNhq4kLCyM7du3O5fj4uIIDQ11LkdFRREfH89TTz1Feno6cXFxtGvXjvnz5zN9+nS6deuG2Wx2trdYrj0E0iU2ERERMcqF72KrU6cO0dHRnDp1ipSUFNasWUO9evWc9/fp04fVq1ezYsUKZsyYQWhoKJ988gk+Pj6sXbuW1atXA7B8+XKqVq1K/vz5r7k/DZBEREQk1wsLC6Nv3760b9+eJ554gscee4wqVarQtWtXYmJirrntuHHjmDdvHhERESxZsoTRo0dfd38m+5Uu6uVy2/4q7e0SvKasJcPbJXjV/nSrt0vwqgPpoddvdJMqYTnt7RK8Ksic7O0SvOrrpHu9XYJXvVL5a4/u7+5BkR7b1y/jrj9h2huUIImIiIi40CRtERERMdB3sSlBEhEREXGjAZKIiIiIC11iExERESNdYlOCJCIiIuJKCZKIiIgYaJK2EiQRERERN0qQRERExEgJkhIkEREREVdKkERERMRICZISJBERERFXSpBERETEwOTtAnIBJUgiIiIiLpQgiYiIiJHmIGmA9Lcfv/dh0Swz6elwexk7Xfpn4F/A2GbNch/WrDDj6wvFb7fz/IsZFAy8dP/JOBjRx5c3p18goJBn6/+3tkSb+WCmL+npUK6sjaED0yjg0v/FSy0sWW4ln6+dO+6wM+ClNAIv9n/Jcgsrv7KQlmbirjsd2/v6er4f/9RP35tYPNtMerqJUmXsdOmXQf4rHP9vvjDj62un+O122vfOdDv+o16yMvqD9Dx3/Pf9kM66uSlkpkNYaTOPv+xPPn9jyL5n6wU2LEjFZIL8BX1o8VJ+goqZAdj2ZRo711wgI81OsfKO7S3WvBPS7/4els2BjHQoUQY69MXt+P+4Bb74GEwm8C8I7ftCaHE4nwgL3oXDB8HXDx58FBq29E4//okd35lZMMuXjHS4vayNXv3T3F77vlpmIWqFFd98dkrcbqfLi2kEBEJaGsx8x5cDv5mx2aFCxUy69LlAvnze6cs/8df2ZLbPP4Ut3c5td/jyUO8QfP2NF1f+/O48Oz89jckE+Qr6ULdXCIHFrGSk2dg6I4GE/WnY7RBSIR91ugVjyaeLMzcDHUUg8Qx8ONHCS69nMHFOOqHF7Hw2yzh2/PUnEys/szBkfDpvTk+nWriNWVMutdm01oc3+vly+mTe+aPwt9NnYMz4fLw5MpVP56VQvJiN92cYRzc7fvRh/kIr70xKZe7MVGrXymTsJMer4IZvzXy+zMo7E1NZMCeFC2nw6edWb3TlH/n7+L/4egbjZ/99/M2GNr/+ZGLVIjODx6Uz+oMMqobbmXPZ8d+81ocx/a158vifP2tjxZRknhlagN4zAilc1Idv5qQY2qSn2Vk2MZlnXy1Aj/cCubOWhagPHG32bLnADyvTaD+mAL2mBZBxAb5bluaNrvwjSWdg7iTo8Rq8MQtCisLS2cY2F9Jg1jjo+Rq8Pg2q1oZPpznuWzQd8uWHkTNgyBT4eRvs/s7z/fgnzp6BqRPzMXB4Ku98lEJYMRsLZhqf+z//5MPyz6wMn5DKxOmp1AjPZHqk47m/dIGVzEyYOCOFSTNSuHDBxLKFeee5n3I2k03vxtHolTBaTy1FQFEL2z4+ZWiTkWZj45Q4HhkURqvIktx+vz/RsxIA+OnzM9ht0CqyJK0iS5J5wc6uJWe80ZVsZ7J77pZbeWWANHbsWG/s9qpidvhQ5k4bRUs6jlSjFplsXeeD/bID98fvPtxT3UaREMfyfXVt/PidDxnpcDoBdmzxYeCYdC9U/+/9sM1MpbsyKXWx/0+2zGDNOouh/7/t8+H+mpmEhjhWPvxQBluiHYnb12sstH0mncBA8PGBgf3SaNY4wxtd+Ud+3uFD2bvsFC3hWG74WCbR643H/8/fTdxd3UbQ38f/QRs/fm9yHP+TsGOrD/1H583jf2BnBiUqmClSwjEovD/Cl5gNF7Bf9gDYbY7EPfW8Y92FVLD4OgaDu9ZfoPaT+cgf4IPJx0RE7/xUaZh34sNfd8Idd0HYxeNf/zH4fj2G42+72P+UZMdyWgpYL44DDv0ODzQCHzNYrHBvOOzY7NEu/GO7dpgpf2cmxS4+95u0yGCTy3P/wD4fqtTIpMjF536tuhls/87x3K9UxUbr/6bj4wNmM5QpbyM+Nu/8k3D0p2SCK+SjUHHHwazUNJAD3ya5n/t2uJBsAyA91e5MR4ve7Ue11oUx+ZjwMZsoUjYf5+LzzmufXFuOX2IbMmSI27r169dz9uxZAN56662cLuG6TsabnAMfgKAQSEk2kZKMM2oud5eNNcusJMRCcBh8u9qHjHQTSYlwWzC8PCLvPili430IC730ghASYuf8eRPJyTgvs1WqaGPxUivHT5goVtTOqigL6ekmziaaOHzEh9OnbfR9JR8JJ32oem8mL3S/4KXe3LiT8RAUcqn/fx//1ORLl1nK3mVnzXIzCbGZjuO/xnH8zyXCbUXgpeF59/gnxtsIDLn0v1JgsA9pyXAhBfL5O9b55jfx2Av+zB5wjvyBJuw26DShIAAnj9o4f8bO/NfOkXTKxu13W2jcKb83uvKPnIqHoOBLy7eFQGqyidRku/P4++WH/74I4/pCgQDHgGnQZMd9ZSrCd+ug3N2OS3Q7N4M5j0xeOBnnQ5HLnvtFQuwku7z2Vaho4+tlVuJjTYSE2fnfasvFc99EtfsyndvGx5pYtdRC975557l/PiGTgkUuHawCRSykJ9tJT7Hje/ESszW/Dw/2CGbl4KP4BZix2aDFW8UBKFnN37ltUlw6v6w8y4M9g7kp5OJkx1NyPEEqXLgwGzZsoGLFioSHhxMeHo6/v7/z59zAbrvyep/LHp2KVey0ei6DyBFWXutlxeQDBQPsWPJOmnxVWel/9ao2OrVPZ8jr+ejU3Q+TCQID7VgtdjIyYNsOM6OHpzH7gxQSk0xMn5V3EgT7VV4I3I7/fzN5e6SF11+wYDJBgQA75pvh+F+l/6bL+h/7ZyYbF6bS64MA+n9ciIee9WPRm+ex2+3YMuHgjxk8PaQA3aYEkJpkZ/28lCv/0lzoquf/ZVdZj/wBXy6AETNgwkJo3hY+eMPx2D3dzTEvaXQvmDYSKtcASx4ZINmycO5XrmLj6fbpjB+ej1d6OZ77BQPsWCyXNj6wz4fXXvajacsM7nsg8wq/MXeyX+Xkv/zcP3XoAj8uOs1T75Si7ew7qNa6MOvGxxq2TTiQxqpXj1GpeSC331/gCr9R8qIcfxoPGjSIevXqMWXKFPr160etWrWYO3curVq1yuldZ1mRUDsH9l6KhU8nOP74+V32T3BKMlSsYuPhZo5X07OnYclHUDDAw8XmgLAwG7/suXQqxMebCAiwk/+y/p9PhurVMmkR4UhKTp2CD+f4EhgIwUXs1Kub4UybmjySwZx5eWfkUCSEKx7/fFc4/vUvP/5zzTfF8S8U4sPR3y4lYIkn7fgVNOHrd+kxObAjndsrm52Tsu+P8GX1hymkJNoJCDJRsY7VOan73ga+fLsw1bOd+BeCQuGPvZeWzySAf0E7+fwurft1O5S/2zEpG6BBC8fco3OJjvlJT3WGAhcn7Ed9BiHFPVf/vxESauP3y577pxJMFLzCa1/lKpk0auY4R86chk8/8nW+QWHz/8zMfCcfnXun8VCjvDM4AigYbCF+36X5cudPZuBb0Aer36UR0tEfkwmr6EdgsYuX4ZoF8v2ck6Ql2fALNHNg0zm2zkigTtdgytUr6PE+SM7xyByk2rVrM336dD755BPGjRtHZmbuehLdW9PG/j0+nDjieIFf96WZGrWN/1aePmlizABfks87lpfPt1C7gQ1T3rncflXh92Xyyx4zhy/2f/lKCw89aLxklJBg4oWX/Th/sf9zPvalccMMTCZoUD+D/220kJbm+I/62y1mKlW8yr/ludC9NW0c2GPixFHH8vorHP8zJ+HNgVZSLvZ/xQLzTXP8y9WwcOS3TE4edTwvt3+VRsUHjAPcYuXN/BmTwbnTjsdl73fpFA7zwb+QD5Ue9OXXzRdIT7Njt9vZ+106xe80u+0nt6pcEw7uhdiLx3/jKqhW29jm9gqwLwYSTzuWf9zquNQeUAi+/RJWzHOsTzwNm76GWg08V/+/UbVmJr/vMXP84nN/zUoL99cxPvdPnTQxvL+f87Xv8/m+1L343I/+1szsqfkYNjY1zw2OAEpU8yduXxpnjznmD+5dncQd4f6GNkXK5uPEL6mknHE8Lod+OE/BUAt+gWb+2HqO72Ym0HR4sZtvcGT34C2XMtmvljHmkMWLF/P1118ze/bs6ze+im1/lc6+gi766XsfFs02k5EOocXt9Hglg7jjJmZOtvDmdMeT5++3edvscNc9djr0zsDX5e2s/22cj2mfp+XY27zLWnJmrsvW78x88KGV9AwTJYrbeH1IGkeP+zB2gi9zZzrSgM+XOd7mb7dDlXsy6f+S4+28mZnw0Xwr6/5nwWaDOyvYGNTP/WMCssP+9JxJpnb9YLp4/E2EFrfTfWAGcSdMzJ5sZvQHjsd87QrH8bfb4c67bbTvnel2/Ns/6svUxTn3MQ8H0kNz5Pf+vu3S2/xvK+ZDq/7+nD5h44u3k+nxniMq+OHLNLatTMNsdbzNv1nP/ITeYcaWaefbz9L45dsL2G1QrJyZx150/5iAf6uE5XS2/r7LxfwAy2ZDRgaEFINOAyH+BMyLdLxrDeB/XzhuFgv4B0C7F6B4aUhNhlnjIf6Y4x+EZm0ck7azW5A5Oft/KbDzezMLZlnJyDARVszGi4PSiD3uwweTfZk43fHc/3q5hagvrNhtUPGeTDq/6Hju9+6Qn+RzJoKCL/1DcdfdNrr2yf55SF8n3ZvtvxPg8A7H2/wz0+0EFrVS/6UQEmMz2Dw1nlaRJQH49auz/PpVImariXwFfajdNZjbbvdlca+/uHDehn/QpRQurKIfdbpn/zykVyp/ne2/81qq9on02L52vdPXY/u6ER4fIGWHnBgg5RU5NUDKK3JqgJRX5NQAKS/IyQFSXpBTA6S8IqcGSHmFpwdI1V703ADpp3dz5wBJn4MkIiIi4iKPvNdCREREPCbPXVvKfkqQRERERFwoQRIRERGD3PwVIJ6iBElERETEhRIkERERMVKCpARJRERExJUSJBERETHQHCQlSCIiIiJulCCJiIiIkRIkJUgiIiIirpQgiYiIiJESJCVIIiIiIq40QBIRERFxoUtsIiIiYqC3+StBEhEREXGjBElERESMlCApQRIRERFxpQRJREREDEx2RUhKkERERERcKEESERERIwVISpBEREREXClBEhEREQN9DpISJBERERE3SpBERETESAmSEiQRERERV0qQRERExEBzkJQgiYiIiLhRgiQiIiJGSpCUIImIiIi40gBJRERExIUusYmIiIiBJmkrQRIRERFxkycTpNfrP+ntErwm49Bhb5fgVZbQEG+X4FX25BRvl+BVmeeTvV2C15jMZm+X4FU+fvm8XYJXvZLo4R0qQVKCJCJ5w608OBIRz8uTCZKIiIjkHM1BUoIkIiIi4kYJkoiIiBjZFSEpQRIRERFxoQRJREREDDQHSQmSiIiIiBslSCIiImKkBEkJkoiIiIgrJUgiIiJiYLJ5uwLvU4IkIiIi4kIJkoiIiBhpDpISJBERERFXGiCJiIiIuNAlNhERETHQB0UqQRIRERFxowRJREREjPRltUqQRERERFwpQRIREREDzUFSgiQiIiLiRgmSiIiIGClBUoIkIiIi4koJkoiIiBhoDpISJBERERE3GiCJiIiIkd3uudsNWLlyJc2bN6dx48YsWLDA7f61a9fSokULIiIiGDx4MBcuXADg2LFj/Oc//6Fp06b07NmT8+fPX3dfGiCJiIhIrhcbG0tkZCSffPIJK1as4LPPPmP//v3O+5OTkxk1ahRz5sxh1apVpKWlsWzZMgBGjhxJu3btiIqK4p577uH999+/7v40QBIREREDk91zt6zaunUrDzzwAIULF8bf358mTZoQFRXlvN/f35/169cTHBxMcnIyJ0+eJDAwkPT0dLZt20aTJk0AePLJJw3bXY0maYuIiIjXJCYmkpiY6LY+MDCQwMBA53JcXBwhISHO5dDQUHbv3m3Yxmq1snHjRl555RVCQ0OpW7cup0+fpmDBglgsjiFPSEgIsbGx161LCZKIiIgY2T13mzt3Lo0aNXK7zZ0711jSFeYrmUwmt3X169fn+++/p0GDBowYMSLL27lSgiQiIiJe06FDB1q1auW2/vL0CCAsLIzt27c7l+Pi4ggNDXUunzlzhp9//pm6desC0KJFC/r27UtQUBDnzp0jMzMTs9lMfHy8YburUYIkIiIiXhMYGEjJkiXdbq4DpDp16hAdHc2pU6dISUlhzZo11KtXz3m/3W5n4MCBHDt2DICvv/6aGjVqYLVaue+++/jqq68AWL58uWG7q1GCJCIiIga58YMiw8LC6Nu3L+3btyc9PZ3WrVtTpUoVunbtSp8+fbj33nt544036N69OyaTifLlyzNy5EgAhg8fzuDBg5k2bRrFihVj8uTJ192fyX6li3O5XLMy/bxdgtdkHDrs7RK8yhIacv1GNzF7coq3S/CazPPJ3i7Bq0xms7dL8Cofv3zeLsGrohLneHR/9VtM8Ni+Nq4c6LF93QglSCIiImJky3PZSbbTAOmi+xtUouMrEVh9Lfyx9xhTBn1G8rm0K7btN6ENh/adYMmHGwB49f0OFLsj2Hl/0ZJBxPxwgJFdZ3ui9H8svHkNOr/ZDms+K3/sPsSkLtNITkrJUpuA2wrS5/2ulKtWmtTzqaz+6H+seM/xuRJ33leOXpHP41fADx+zD5+NX866BZu80cUsu/+Re+g4tKXj+O85ypS+80k+l3rFtv3efo5De4+zZNo3bvcNm9WNk7FnmDZ0UU6XnK3Cm1Sh4/DWWPNZ+OPnI0T2nk1y0pX7339aZ/789ShL3nUcb18/Ky9Meo47a5TBx8fE3u0Hmdr/Yy6kpnuyCzckvHl1Oo9p6zivY/5iUpcPrnDuX7lNwG0F6PN+F8pVLU3q+TRWf7SBFVOjuL1SCYbO7+Pc3sfsQ5l7b2dk60lsXvaDp7v4j4U3q0an0W0c50LMYSZ3m+H22PxtwMzu/PnLET6PXOXhKrPPrXbuS9ZpkjZQKKgA/ca3YXTPj+jaaCwn/jpFx1cec2tXqlwoby3oyUMR1Qzrx/SaS++ISfSOmMQ7QxZxLimFqa8v9VT5/0ih4EAGzO7FqNYT6VTpJY7/EUvnsf/JcpsekzuQcj6VLnf3pU/tVwlvWp1aETUAGP75AOaOWESPGgMZ2nwM3Sd1oET5oh7vY1YVKlKQflOeY3TnGXStO5IThxLoOOwJt3alKhTlrc9f4qEWNa/4e1q/0Jh7HiiX0+Vmu0JFAuj3fmfeeG4qXWoO5fif8XQc+bRbu1J3FmPsyld4qNX9hvVtB7bAbPGhV53X6Vn7NfLlt/Js/whPlX/DCgUHMGBWT0Y9PZlOlfty/GAsnd9ql+U2PSZ3IOVcKl3u6UefOq8S3qwatSJq8Neeo/SoOch527F2N+sXbs5Tg6NCwQEM+LA7o56dQud7Bjie82PauLUrVbE441e/Sr3WD3ihyuxzq537N8SDb/PPrTwyQLr8g5yio6MZO3YsEydOZNeuXZ7Y/XXVeOgu9u0+zLE/EwD4cv4WGrSs4dbusfZ1Wfv5D2xa9dMVf4/Faqb/xLbMGLWChONncrTmf6vmo1XYt+0AR/efAGDltDU0avdQlttUqFmWbz7eiM1mIyM9g++/2km9p2pjzWfl41GL+XFdDAAJR0+RmJBEcMkiHuzdjalRvxL7fjrEsT/iAfhy7rc0ePJ+t3aPdazH2k+j2bRyh9t9VR68k5oNKrNqbu5Oyq6kRqO72bfzD44dcHxw2qpZ62n4tPsfvhbdGrF2wSY2LdtmWB+z5TcWTliJ3W7HZrOzf9dfhJYKdts+t6j5aFX2bb/svP5gLY3a1c1ymwo1yvLN/E3YbHYy0jP5ftVO6j1Vy7D9PXUr8tBTtXi750wP9Cj71Gxchd+2H+TYxX5/Of0bGrZ90K3d4z0eZfW8jXz7+XeeLjFb3WrnvtwYjwyQhg8fDsCCBQt48803KVq0KMHBwbz++uvMnz/fEyVcU3CxwsRfNqBJOHGWAoH58S9onBQ4bfhS1i9z/+P4tybP1OJkbCJb18TkWK3ZJaRUMPFHEpzL8UdOUqCQP/4B+bPUZu8P+3nkufqYLWb8CvhR98kHCCpWmPS0dKJmr3du07zrI+Qv6Mee7373TMf+geDitxF/9LRzOeHYmYvH38/QbtrQRaz/3D0NCAorRI83nmZ8rznY8uB1+5ASQcQfOeVcjj96+uJxNvb//QHzWfdptNv2O9f/wtH9jj8woaWK0KpXYzYt3+bWLrcIKVmE+MMnnctXPPev0WbvD7/zyH8funju56Puk7UIKnabYR/dxv+XOa99etVLU7lVSMkg4o9c3u9Tbo8NwNSXP2Ldgs2eLi/b3Wrn/o3IjV814mkevcS2aNEi5s2bx/PPP8/zzz/PggULcsUAycfnyp+omZl5Y0fuic71WPje2uwoKcddrc+2TFuW2kzvPxfsdqbtHM+IpQPZ+c0u0i9kGNo9O+gJ2o94htceH8uF1AvZV3w2u+rxt9muuP5yZosPgz/oxPTXFnM6zv2j8vMC01XP/+v3/3Llq93BxKghfDFjHT9E5Y50+Er+9bk/4GOww7Qd4xixdAA7v4kxnPuVa99JoeAA1n+yJXsL9wCTz5X/JNhu8FzIK261c19ujEcmaWdkZGCz2ShSpAj+/v7O9b6+vvhc5QnpSXHHznBXtTucy8FFC5F0Jpm0lKz/US9XuQRms5mY7w/kRInZLu6vBCqGV3AuB5cIIvHUOVKT07LUJqRUMB++Mp+k0+cAePaVlhw74Ijlrb4WBs55gdsrl+SlOq8SeyjeQ736Z+KOnuauGqWdy8HFCpN0+jxpydc//hWq3kHR24PpOvIpAG4LDcRs9sE3n5W3+y/IqZKzVfyRU1S879LcqeDit5F0+lyW+v+3+k+F03vyc0wdsIANi3P3ZZe4wwlUrFXeuXzFc/8abUJKFeHDQfNJOn0egGcHPu68JAXw8DO1Wfvxpit+vUFuF384gYrhl50LV3hsbia32rl/Q/Lg+ZvdPDI6ue2226hfvz779+93Xm6Ljo6mTZs2NG3a1BMlXNPOTb9RsfodFC/tuHbcvF0dotf+fEO/495a5dgVnXsvI7nasWYXlR6o4Jw8/ViPR4lesS3LbVr0aEyHUc8CUDi0EM26PML6TxyR+2uL+uMf6M/LDw7L9YMjgJ0bf6VizTIUL+P4jKXm7R8ievXu62zlsHfHH7Sv+Sq9H3mL3o+8xVfzNrNxxY48MzgC2LHuZyreX5bi5cIAiOjUgOhVP2Z5+7ot76Pn+P8w9IlJeeIPxI41u6lU67Lzuntjor/YnuU2Lbo3psPIZ4C/z/1GrF94KS2qUq8yP67P/ZfZr2TH2hgqhVeg+N/97taI6CvMubtZ3GrnvtwYjyRI8+bNA+DgwYPOb+z19fWlT58+PPzww54o4ZrOnjxH5MBPefX957FYzRw/lMDE/gupcG9JXhr7LL0jJl33dxQvE0zsZdeyc7sz8YlM7PQ+ry3uj9XXwrEDsYzv8B531ixLvw970qPGwKu2AVj41jIGzXuRGbsnYTKZ+HjkIvZtP8Ddde6i9uP3cfi3Y0zZPNq5v5mD57N9Te6Mns8mnCPy5Y95dWZXLFYLxw/FM/HFuVSoejsvTfoPvR95y9sl5qizCUlM7jWbYfN6YfG1cPyPOCZ0n0mF6qV5+d2OvFB3+DW37ziiNZhMvPxuR+e6X7//nan9vX/5/ErORim0fgAAFspJREFUxCcysfM0XlvUz3FeHzzB+A5THef+jO70qDnoqm0AFo5dzqB5vZmxayImE3w8ajH7tl9KjotXKErsn7n/H4MrOROfyMSu03nt05ecz/kJnaZRoUYZ+k3vSs/7h3q7xGx1q537NyI3zw3yFH2Sdh6jT9LWJ2nfqvRJ2vok7VuZpz9Ju0GTcR7b1/9WD/LYvm6EPihSREREjPJcdJL9vD9DWkRERCSXUYIkIiIiBqa8N/sm2ylBEhEREXGhAZKIiIiIC11iExEREaOb88PTb4gSJBEREREXSpBERETEQJO0lSCJiIiIuFGCJCIiIkYKkJQgiYiIiLhSgiQiIiJGmoOkBElERETElRIkERERMTApQFKCJCIiIuJKCZKIiIgYaQ6SEiQRERERV0qQRERExMCk72JTgiQiIiLiSgmSiIiIGGkOkhIkEREREVdKkERERMRIAZISJBERERFXGiCJiIiIuNAlNhERETEwaZK2EiQRERERV0qQRERExEgJkhIkEREREVdKkERERMRIXzWiBElERETElRIkERERMdC72JQgiYiIiLhRgiQiIiJGSpCUIImIiIi4ypMJkv3kaW+X4DWW4sW8XYJX2YsU8nYJXmX/7aC3S/Aak9ns7RK8yp6Z6e0SvMoUUNDbJdxalCApQRIRERFxlScTJBEREclB+hwkJUgiIiIirpQgiYiIiIE+B0kJkoiIiIgbDZBEREREXOgSm4iIiBjpEpsSJBERERFXSpBERETESAmSEiQRERERV0qQRERExEgJkhIkEREREVdKkERERMRIXzWiBElERETElRIkERERMdBXjShBEhEREXGjBElERESMlCApQRIRERFxpQRJREREjGxKkJQgiYiIiLhQgiQiIiJGmoOkBElERETElQZIIiIiIi50iU1ERESMdIlNCZKIiIiIKyVIIiIiYqQESQmSiIiIiCslSCIiImKkD4pUgiQiIiLiSgmSiIiIGNlt3q7A65QgiYiIiLhQgiQiIiJGehebEiQRERERV0qQRERExEjvYtMA6W/hTarQcXhrrPks/PHzESJ7zyY5KfWKbftP68yfvx5lybtRAPj6WXlh0nPcWaMMPj4m9m4/yNT+H3MhNd2TXfhX7m9YmY5DWmD1tfDHnmNMGbCQ5HNX7n+/yf/h0G/HWTJ9vXNdRPu6NG1bG18/K/tjDjNlwELSL2R4qvx/LfyhO+nYp7Gj//tOEDliOcnn0wxtGkZUpXWHutjtdtJS05k2bhW//3rMeX+BAD8mzu7M5OHLDOvzgvCm1ej4xrOO8z/mMJE9PiQ5KeWKbft/2J1Dvxzm8ylfGdaHlAxiysaR9AwfQuLJc54oO0eEN6tGp9FtnI/F5G4zrvpYDJjZnT9/OcLnkas8XOW/E968Op3HtMWaz8ofMX8xqcsHbn28WpuA2wrQ5/0ulKtamtTzaaz+aAMrpkZxe6USDJ3fx7m9j9mHMvfezsjWk9i87AdPdzHL7m90Nx0Ht3Ac7z3HmNL/k6u/9kX+l0N7jxle+z7d/SYJJ846l5dMW8f/lm3P8bol5+kSG1CoSAD93u/MG89NpUvNoRz/M56OI592a1fqzmKMXfkKD7W637C+7cAWmC0+9KrzOj1rv0a+/Fae7R/hqfL/tUJBBek3+T+M7jabrvXHcOKvk3Qc0sKtXanyYbz1WW8ealHdsL5Osyo83rEeQ9pOpUfDt/D1s/JE14c9VP2/V+g2f/qNasUb/RfSpeXbHD96mo4vNTa0KXlHMF36NmFYr7m88Oz7LPxwA69Nbuu8//66FXh7QXdKlgn2dPn/WqHgAPrP6MYbbabQpcpATvwRR6fRz7q1K3VXccZFDaXeU7Xc7nvkP3WZuO51gksEeaLkHFMoOIABH3Zn1LNT6HzPAI7/EUvnMW3c2pWqWJzxq1+lXusHvFDlv1MoOIABs3oy6unJdKrcl+MHY+n8Vrsst+kxuQMp51Lpck8/+tR5lfBm1agVUYO/9hylR81BztuOtbtZv3Bzrh4cXXrtm0XXeqM5cSiBjkMfd2tXqnwYby160e21r0S5UJLOptD70XHO200zOLLbPXfLpTw2QNq0aROJiYkALF++nFGjRrFkyRJP7f6aajS6m307/+DYgVgAVs1aT8On3V/4WnRrxNoFm9i0bJthfcyW31g4YSV2ux2bzc7+XX8RWirv/KGsUb8i+3b9xbE/4gH4ct5mGrS6z63dY88/xNpF37Np5Y+G9Y2eCmfpjP9x7kwydrud9wYvYv2SbW7b51Y1apdn389HOfbXKQBWLfqBhs2rGtqkp2cwZeRyTiU4kpF9vx7jtuCCWCxmAFq2q82kYUs5FZfk2eKzQY1H7uW3HQed5/+XH35DwzYPurV7vEdj1sz7lm+XfG9YH1SsMLVb3MdrLSd4pN6cVLNxFX7bfpBj+08A8OX0b2jY9kqPxaOsnreRbz//ztMl/ms1H63Kvu0HOHqxjys/WEujdnWz3KZCjbJ8M38TNpudjPRMvl+1023QfE/dijz0VC3e7jnTAz3657L+2lePtZ995/baV7lmGWyZNsYufpH31w6m3ctN8fExeaR2yXkeucQ2ZswY9uzZQ2RkJFOmTCEmJoZGjRqxdu1a9uzZw7BhwzxRxlWFlAgi/sgp53L80dMUKOSPf4Cf4TLb+wPmA1CtfmXD9jvX/+L8ObRUEVr1aszbL83N4aqzT3DxwsQfO+1cTjh+hgKB+fEv6GeImqcN+xyAag/eadi+ZNlQ9v10iDfm96RIWCA/f3+QWWNWeKb4bBBStBDxsZci8vjYRAoE+OFfIJ/zMlvssTPEHjvjbNN9QDO+2/AbGRmZAAzrNc+zRWejkJJFSLj8/D9y6uL5n99w2WVqX8c5Xa3B3YbtTx0/wxttpnim2BwWUjKI+CMnnctXfSxe/giA6i6PRV4QUrII8Ycv7+NJtz5eq83eH37nkf8+xC9bfsOaz0LdJ2uRefF58Ldu4//LnNc+veqlydwiuPhtWXztWwxAtbp3GbY3W8z8+O1eZo1ega+flZHzepB8LpXlMzd4pP4clYuTHU/xSIK0ZcsW5s6dS0hICBs2bGDatGm0a9eOqVOnsmXLFk+UcE2mq4z4MzNv7IOyyle7g4lRQ/hixjp+iNqVHaV5hI/p3/XfbPWher2KvNVjDn2aTySgsD/PD3osO0vMUaar9d/m3v98+a28OuFZipUKYsrI5Tldmkdc7T/eGz3/bwYmnyu/JNpuosfiasf78j5eq830AR+DHabtGMeIpQPY+U2MYb5h5dp3Uig4gPWfeP+1/Xr+7bkf9clWPnh9CekXMjifmMKyGeup07RKdpYoLlauXEnz5s1p3LgxCxYsuGq7QYMGsXTpUufy8uXLqVu3Li1btqRly5ZERkZed18eGSD5+flx8qTjv5EiRYqQnJwMQEpKChaL9+eJxx85RVDRws7l4OK3kXT6HGnJF7L8O+o/Fc5bKwYwe8TnfDYpb03YjDt2mqDQQs7l4KKFSDpznrSUrPX/VGwiW6N2kXwulYz0TNYv3UbFmqVzqNrsF3/iLEHBAc7l4NAAks4mk5ZinGQfUrQQkXO7kWmzM6jLbM5fZRJ/XhN3+KTx/C8RRNKpc6Qlp11jq5tT/OEEgooZH4vEU+dIvYkei7gs9PFabfwD8/PhoPl0qzqAwU3GYLfZnJckAR5+pjZrP96EPQ8kEHFHTxEUGuhcDi5aiKTTWX/ta/jU/ZSuVNy5bDKZyMi4eQbTuU1sbCyRkZF88sknrFixgs8++4z9+/e7tenRowdRUVGG9TExMQwePJgVK1awYsUK+vbte939eWSA1Lt3b1q3bs24ceMoW7Yszz33HG+++SbPPPMMHTt29EQJ17Rj3c9UvL8sxcuFARDRqQHRq368zlaX1G15Hz3H/4ehT0xiw+K8Nydh58a9VKxxB8XLhADQ/Lm6RK+OyfL2m1f9xEMR1fH1swJQu2kV9u36K0dqzQk7ovdTsUopit/umGAc8XQ40Rv2GtoUDMzPhNmd2bLuV8YOWsSFtLzzDr3r2fFNDBXDy186/7s2IvrLHV6uyjt2rI2hUngFipcvCsBj3RoRvfLmeix2rNlNpVoVKPF3H7s3JvqL7Vlu06J7YzqMfAaAwqGFaNalEesXXkqLqtSrzI/rs/764U2O177Sxte+NVmvvfRdxXhuQAQ+PiZ8/ay0eL4e336xM6fK9axcOEl769atPPDAAxQuXBh/f3+aNGniNhBauXIljRo1olmzZob1MTExLF++nMcff5wBAwZw9uxZrscj8U3Dhg2pUKEC33zzDYcOHaJatWoUKFCAsWPHUqWK9+PIswlJTO41m2HzemHxtXD8jzgmdJ9JheqlefndjrxQd/g1t+84ojWYTLz87qXB3q/f/87U/vNzuvRscfbkOSL7f8Kr0zthsZo5fiiBiS/Pp0KVUrw0oS29m4y/5vZfzt1EwcL+vPvVQHzMJvbHHGHmqLxz+ensqfNMfn0pwya2dfT/yCkmvLqECpWL8/LwJ3jh2fd57JlwQooWok7DStRpWMm57eBuc0g6m7vnWVzP2fhEJnWbzmsLX3Kc/wfjmNB5GhVqlKHvtK70qjXU2yV6zJn4RCZ2nc5rn76E1dfCsQOxTOjkeCz6Te9Kz/vz/mNxJj6RiZ2n8dqifo4+HjzB+A5TubNmWfrN6E6PmoOu2gZg4djlDJrXmxm7JmIywcejFrNv+wHn7y9eoSixf8Z7q3s35OzJc0T2W8CrMzpfeu176WPHa9/EdvR+dNw1t18w+Wt6jXmaaeuGYLaa2fTlT0R9stVD1d88EhMTnW/iulxgYCCBgZcSvri4OEJCQpzLoaGh7N6927BNly5dANixw/iPTUhICN26daNKlSpMnjyZUaNGMWnSpGvWZbLnhRzURdNA76dO3mIKDLh+o5uYvUih6ze6idl/O+jtErzGfot/cJ09M/P6jW5ilqKh3i7Bq74++q5H99es2Ase21fzoRV577333Nb37t2bF1980bn8wQcfkJKS4rw8tnjxYmJiYhg1apTbtoMHDyY8PJwnn3zS7b6zZ8/yyCOPsG3btd9t7f0JQCIiInLL6tChA61atXJbf3l6BBAWFsb27ZcuB8fFxREaev2Bc1JSEkuWLOH5558HwG63Z2n+sz4oUkRERIw8OAcpMDCQkiVLut1cB0h16tQhOjqaU6dOkZKSwpo1a6hXr951u+Lv78/MmTPZtcvx7vL58+fTuHHj62ylBElERETygLCwMPr27Uv79u1JT0+ndevWVKlSha5du9KnTx/uvffeK25nNpuZMmUKI0aMIDU1ldKlSzN+/LXn1oLmIOU5moOkOUi3Ks1B0hykW5nH5yCF9fTYvr6Oneaxfd0IXWITERERcaFLbCIiImJ0iye2oARJRERExI0SJBERETGw2/WVKUqQRERERFwoQRIREREjzUFSgiQiIiLiSgmSiIiIGOW9j0jMdkqQRERERFxogCQiIiLiQpfYRERExMimt/krQRIRERFxoQRJREREjDRJWwmSiIiIiCslSCIiImJg1xwkJUgiIiIirpQgiYiIiJHmIClBEhEREXGlBElERESM9GW1SpBEREREXClBEhERESO73sWmBElERETEhRIkERERMbBrDpISJBERERFXSpBERETESHOQlCCJiIiIuNIASURERMSFLrGJiIiIgSZpK0ESERERcaMESURERIw0SRuT3a6v7BURERG5nC6xiYiIiLjQAElERETEhQZIIiIiIi40QBIRERFxoQGSiIiIiAsNkERERERcaIAkIiIi4kIDJBEREREXGiCJiIiIuNAA6QasXLmS5s2b07hxYxYsWODtcjzu3LlzPPbYYxw5csTbpXjce++9R0REBBEREYwfP97b5Xjc22+/TfPmzYmIiGDOnDneLsdrxo0bx+DBg71dhse1b9+eiIgIWrZsScuWLdm1a5e3S/Ko9evX8+STT9K0aVNGjx7t7XLEQ/RdbFkUGxtLZGQkS5cuxdfXlzZt2lCrVi3Kly/v7dI8YteuXQwbNow///zT26V43NatW9m8eTPLli3DZDLRpUsX1q5dS+PGjb1dmkf88MMPfPfdd3zxxRdkZGTQvHlz6tevT9myZb1dmkdFR0ezbNkyHn74YW+X4lF2u52DBw+yYcMGLJZb70/G4cOHGT58OIsXL6ZIkSJ06NCBjRs3Ur9+fW+XJjlMCVIWbd26lQceeIDChQvj7+9PkyZNiIqK8nZZHrNo0SKGDx9OaGiot0vxuJCQEAYPHoyvry9Wq5Vy5cpx7Ngxb5flMeHh4cybNw+LxcLJkyfJzMzE39/f22V51JkzZ4iMjKRHjx7eLsXjDh48iMlkomvXrjz++OPMnz/f2yV51Nq1a2nevDlFixbFarUSGRlJ1apVvV2WeMCt9+/APxQXF0dISIhzOTQ0lN27d3uxIs8aM2aMt0vwmgoVKjh//vPPP/nqq6/49NNPvViR51mtVt555x1mz55N06ZNCQsL83ZJHvX666/Tt29fjh8/7u1SPC4xMZHatWszYsQIUlNTad++PWXKlOHBBx/0dmkecejQIaxWK507dyY+Pp4GDRrw8ssve7ss8QAlSFlkt9vd1plMJi9UIt7y+++/06lTJwYNGkTp0qW9XY7H9enTh+joaI4fP86iRYu8XY7HLF68mGLFilG7dm1vl+IV1atXZ/z48fj7+xMUFETr1q3ZuHGjt8vymMzMTKKjo5kwYQKLFi0iJiaGZcuWebss8QANkLIoLCyMhIQE53JcXNwtebnpVrVjxw6ef/55+vfvT6tWrbxdjkcdOHCAPXv2AJA/f34effRRfvvtNy9X5TlfffUVW7ZsoWXLlrzzzjusX7+eN99809tlecz27duJjo52Ltvt9ltqLlJwcDC1a9cmKCgIPz8/GjVqdEtdPbiVaYCURXXq1CE6OppTp06RkpLCmjVrqFevnrfLEg84fvw4L7zwAhMnTiQiIsLb5XjckSNHGDZsGBcuXODChQusW7eOmjVrerssj5kzZw5ffvklK1asoE+fPjRs2JChQ4d6uyyPSUpKYvz48aSlpXHu3DmWLVt2y7xBAaBBgwZs3ryZxMREMjMz2bRpE3fffbe3yxIPuHX+DfiXwsLC6Nu3L+3btyc9PZ3WrVtTpUoVb5clHjBr1izS0tIYO3asc12bNm1o27atF6vynPr167Nr1y6eeOIJzGYzjz766C05ULxVNWjQwHn8bTYb7dq1o3r16t4uy2OqVq1Kly5daNeuHenp6Tz44IM89dRT3i5LPMBkv9LkGhEREZFbmC6xiYiIiLjQAElERETEhQZIIiIiIi40QBIRERFxoQGSiIiIiAsNkERERERcaIAkIiIi4kIDJBHJkmbNmlGvXj1+//13b5ciIpLjNEASkSz58ssvKV26NKtXr/Z2KSIiOU4DJBHJErPZTM2aNW+pL6oVkVuXvotNRLIkNTWVVatWoW8nEpFbgRIkEcmSyMhIwsLCOHz4MOfPn/d2OSIiOUoDJBG5rh9//JGoqCjeffddAgIC2Ldvn7dLEhHJURogicg1paWlMWTIEEaOHEnhwoWpWLGi5iGJyE1PAyQRuaa3336b6tWr8/DDDwNQsWJF9u7d692iRERymAZIInJVu3fvJioqiqFDhzrXVapUSQmSiNz0THa9JUVERETEQAmSiIiIiAsNkERERERcaIAkIiIi4kIDJBEREREXGiCJiIiIuNAASURERMSFBkgiIiIiLjRAEhEREXHxfzmh0z446Y3yAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<Figure size 720x720 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# optional\n",
    "# visual representation of grid search\n",
    "# uses seaborn heatmap, could probably do this in matplotlib\n",
    "import seaborn as sns\n",
    "\n",
    "sns.set()\n",
    "\n",
    "train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "\n",
    "for i in range(len(eta_vals)):\n",
    "    for j in range(len(lmbd_vals)):\n",
    "        dnn = DNN_scikit[i][j]\n",
    "        \n",
    "        train_pred = dnn.predict(X_train) \n",
    "        test_pred = dnn.predict(X_test)\n",
    "\n",
    "        train_accuracy[i][j] = accuracy_score(Y_train, train_pred)\n",
    "        test_accuracy[i][j] = accuracy_score(Y_test, test_pred)\n",
    "\n",
    "        \n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(train_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Training Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()\n",
    "\n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(test_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Test Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Building neural networks in Tensorflow and Keras\n",
    "\n",
    "Now we want  to build on the experience gained from our neural network implementation in NumPy and scikit-learn\n",
    "and use it to construct a neural network in Tensorflow. Once we have constructed a neural network in NumPy\n",
    "and Tensorflow, building one in Keras is really quite trivial, though the performance may suffer.  \n",
    "\n",
    "In our previous example we used only one hidden layer, and in this we will use two. From this it should be quite\n",
    "clear how to build one using an arbitrary number of hidden layers, using data structures such as Python lists or\n",
    "NumPy arrays.\n",
    "\n",
    "## Tensorflow\n",
    "\n",
    "Tensorflow is an open source library machine learning library\n",
    "developed by the Google Brain team for internal use. It was released\n",
    "under the Apache 2.0 open source license in November 9, 2015.\n",
    "\n",
    "Tensorflow is a computational framework that allows you to construct\n",
    "machine learning models at different levels of abstraction, from\n",
    "high-level, object-oriented APIs like Keras, down to the C++ kernels\n",
    "that Tensorflow is built upon. The higher levels of abstraction are\n",
    "simpler to use, but less flexible, and our choice of implementation\n",
    "should reflect the problems we are trying to solve.\n",
    "\n",
    "[Tensorflow uses](https://www.tensorflow.org/guide/graphs) so-called graphs to represent your computation\n",
    "in terms of the dependencies between individual operations, such that you first build a Tensorflow *graph*\n",
    "to represent your model, and then create a Tensorflow *session* to run the graph.\n",
    "\n",
    "In this guide we will analyze the same data as we did in our NumPy and\n",
    "scikit-learn tutorial, gathered from the MNIST database of images. We\n",
    "will give an introduction to the lower level Python Application\n",
    "Program Interfaces (APIs), and see how we use them to build our graph.\n",
    "Then we will build (effectively) the same graph in Keras, to see just\n",
    "how simple solving a machine learning problem can be.\n",
    "\n",
    "To install tensorflow on Unix/Linux systems, use pip as"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [],
   "source": [
    "pip3 install tensorflow"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "and/or if you use **anaconda**, just write (or install from the graphical user interface)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [],
   "source": [
    "conda install tensorflow"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Collect and pre-process data"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "inputs = (n_inputs, pixel_width, pixel_height) = (1797, 8, 8)\n",
      "labels = (n_inputs) = (1797,)\n",
      "X = (n_inputs, n_features) = (1797, 64)\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 864x864 with 5 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# import necessary packages\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "from sklearn import datasets\n",
    "\n",
    "\n",
    "# ensure the same random numbers appear every time\n",
    "np.random.seed(0)\n",
    "\n",
    "# display images in notebook\n",
    "%matplotlib inline\n",
    "plt.rcParams['figure.figsize'] = (12,12)\n",
    "\n",
    "\n",
    "# download MNIST dataset\n",
    "digits = datasets.load_digits()\n",
    "\n",
    "# define inputs and labels\n",
    "inputs = digits.images\n",
    "labels = digits.target\n",
    "\n",
    "print(\"inputs = (n_inputs, pixel_width, pixel_height) = \" + str(inputs.shape))\n",
    "print(\"labels = (n_inputs) = \" + str(labels.shape))\n",
    "\n",
    "\n",
    "# flatten the image\n",
    "# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64\n",
    "n_inputs = len(inputs)\n",
    "inputs = inputs.reshape(n_inputs, -1)\n",
    "print(\"X = (n_inputs, n_features) = \" + str(inputs.shape))\n",
    "\n",
    "\n",
    "# choose some random images to display\n",
    "indices = np.arange(n_inputs)\n",
    "random_indices = np.random.choice(indices, size=5)\n",
    "\n",
    "for i, image in enumerate(digits.images[random_indices]):\n",
    "    plt.subplot(1, 5, i+1)\n",
    "    plt.axis('off')\n",
    "    plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest')\n",
    "    plt.title(\"Label: %d\" % digits.target[random_indices[i]])\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "Using TensorFlow backend.\n"
     ]
    }
   ],
   "source": [
    "from keras.utils import to_categorical\n",
    "from sklearn.model_selection import train_test_split\n",
    "\n",
    "# one-hot representation of labels\n",
    "labels = to_categorical(labels)\n",
    "\n",
    "# split into train and test data\n",
    "train_size = 0.8\n",
    "test_size = 1 - train_size\n",
    "X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size,\n",
    "                                                    test_size=test_size)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Using TensorFlow backend\n",
    "\n",
    "1. Define model and architecture\n",
    "\n",
    "2. Choose cost function and optimizer"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [],
   "source": [
    "#import tensorflow as tf\n",
    "import tensorflow.compat.v1 as tf\n",
    "tf.disable_v2_behavior()\n",
    "tf.reset_default_graph()\n",
    "class NeuralNetworkTensorflow:\n",
    "    def __init__(\n",
    "            self,\n",
    "            X_train,\n",
    "            Y_train,\n",
    "            X_test,\n",
    "            Y_test,\n",
    "            n_neurons_layer1=100,\n",
    "            n_neurons_layer2=50,\n",
    "            n_categories=2,\n",
    "            epochs=10,\n",
    "            batch_size=100,\n",
    "            eta=0.1,\n",
    "            lmbd=0.0):\n",
    "        \n",
    "        # keep track of number of steps\n",
    "        self.global_step = tf.Variable(0, dtype=tf.int32, trainable=False, name='global_step')\n",
    "        \n",
    "        self.X_train = X_train\n",
    "        self.Y_train = Y_train\n",
    "        self.X_test = X_test\n",
    "        self.Y_test = Y_test\n",
    "        \n",
    "        self.n_inputs = X_train.shape[0]\n",
    "        self.n_features = X_train.shape[1]\n",
    "        self.n_neurons_layer1 = n_neurons_layer1\n",
    "        self.n_neurons_layer2 = n_neurons_layer2\n",
    "        self.n_categories = n_categories\n",
    "        \n",
    "        self.epochs = epochs\n",
    "        self.batch_size = batch_size\n",
    "        self.iterations = self.n_inputs // self.batch_size\n",
    "        self.eta = eta\n",
    "        self.lmbd = lmbd\n",
    "        \n",
    "        # build network piece by piece\n",
    "        # name scopes (with) are used to enforce creation of new variables\n",
    "        # https://www.tensorflow.org/guide/variables\n",
    "        self.create_placeholders()\n",
    "        self.create_DNN()\n",
    "        self.create_loss()\n",
    "        self.create_optimiser()\n",
    "        self.create_accuracy()\n",
    "    \n",
    "    def create_placeholders(self):\n",
    "        # placeholders are fine here, but \"Datasets\" are the preferred method\n",
    "        # of streaming data into a model\n",
    "        with tf.name_scope('data'):\n",
    "            self.X = tf.placeholder(tf.float32, shape=(None, self.n_features), name='X_data')\n",
    "            self.Y = tf.placeholder(tf.float32, shape=(None, self.n_categories), name='Y_data')\n",
    "    \n",
    "    def create_DNN(self):\n",
    "        with tf.name_scope('DNN'):\n",
    "            # the weights are stored to calculate regularization loss later\n",
    "            \n",
    "            # Fully connected layer 1\n",
    "            self.W_fc1 = self.weight_variable([self.n_features, self.n_neurons_layer1], name='fc1', dtype=tf.float32)\n",
    "            b_fc1 = self.bias_variable([self.n_neurons_layer1], name='fc1', dtype=tf.float32)\n",
    "            a_fc1 = tf.nn.sigmoid(tf.matmul(self.X, self.W_fc1) + b_fc1)\n",
    "            \n",
    "            # Fully connected layer 2\n",
    "            self.W_fc2 = self.weight_variable([self.n_neurons_layer1, self.n_neurons_layer2], name='fc2', dtype=tf.float32)\n",
    "            b_fc2 = self.bias_variable([self.n_neurons_layer2], name='fc2', dtype=tf.float32)\n",
    "            a_fc2 = tf.nn.sigmoid(tf.matmul(a_fc1, self.W_fc2) + b_fc2)\n",
    "            \n",
    "            # Output layer\n",
    "            self.W_out = self.weight_variable([self.n_neurons_layer2, self.n_categories], name='out', dtype=tf.float32)\n",
    "            b_out = self.bias_variable([self.n_categories], name='out', dtype=tf.float32)\n",
    "            self.z_out = tf.matmul(a_fc2, self.W_out) + b_out\n",
    "    \n",
    "    def create_loss(self):\n",
    "        with tf.name_scope('loss'):\n",
    "            softmax_loss = tf.reduce_mean(tf.nn.softmax_cross_entropy_with_logits_v2(labels=self.Y, logits=self.z_out))\n",
    "            \n",
    "            regularizer_loss_fc1 = tf.nn.l2_loss(self.W_fc1)\n",
    "            regularizer_loss_fc2 = tf.nn.l2_loss(self.W_fc2)\n",
    "            regularizer_loss_out = tf.nn.l2_loss(self.W_out)\n",
    "            regularizer_loss = self.lmbd*(regularizer_loss_fc1 + regularizer_loss_fc2 + regularizer_loss_out)\n",
    "            \n",
    "            self.loss = softmax_loss + regularizer_loss\n",
    "\n",
    "    def create_accuracy(self):\n",
    "        with tf.name_scope('accuracy'):\n",
    "            probabilities = tf.nn.softmax(self.z_out)\n",
    "            predictions = tf.argmax(probabilities, axis=1)\n",
    "            labels = tf.argmax(self.Y, axis=1)\n",
    "            \n",
    "            correct_predictions = tf.equal(predictions, labels)\n",
    "            correct_predictions = tf.cast(correct_predictions, tf.float32)\n",
    "            self.accuracy = tf.reduce_mean(correct_predictions)\n",
    "    \n",
    "    def create_optimiser(self):\n",
    "        with tf.name_scope('optimizer'):\n",
    "            self.optimizer = tf.train.GradientDescentOptimizer(learning_rate=self.eta).minimize(self.loss, global_step=self.global_step)\n",
    "            \n",
    "    def weight_variable(self, shape, name='', dtype=tf.float32):\n",
    "        initial = tf.truncated_normal(shape, stddev=0.1)\n",
    "        return tf.Variable(initial, name=name, dtype=dtype)\n",
    "    \n",
    "    def bias_variable(self, shape, name='', dtype=tf.float32):\n",
    "        initial = tf.constant(0.1, shape=shape)\n",
    "        return tf.Variable(initial, name=name, dtype=dtype)\n",
    "    \n",
    "    def fit(self):\n",
    "        data_indices = np.arange(self.n_inputs)\n",
    "\n",
    "        with tf.Session() as sess:\n",
    "            sess.run(tf.global_variables_initializer())\n",
    "            for i in range(self.epochs):\n",
    "                for j in range(self.iterations):\n",
    "                    chosen_datapoints = np.random.choice(data_indices, size=self.batch_size, replace=False)\n",
    "                    batch_X, batch_Y = self.X_train[chosen_datapoints], self.Y_train[chosen_datapoints]\n",
    "            \n",
    "                    sess.run([DNN.loss, DNN.optimizer],\n",
    "                        feed_dict={DNN.X: batch_X,\n",
    "                                   DNN.Y: batch_Y})\n",
    "                    accuracy = sess.run(DNN.accuracy,\n",
    "                        feed_dict={DNN.X: batch_X,\n",
    "                                   DNN.Y: batch_Y})\n",
    "                    step = sess.run(DNN.global_step)\n",
    "    \n",
    "            self.train_loss, self.train_accuracy = sess.run([DNN.loss, DNN.accuracy],\n",
    "                feed_dict={DNN.X: self.X_train,\n",
    "                           DNN.Y: self.Y_train})\n",
    "        \n",
    "            self.test_loss, self.test_accuracy = sess.run([DNN.loss, DNN.accuracy],\n",
    "                feed_dict={DNN.X: self.X_test,\n",
    "                           DNN.Y: self.Y_test})"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Optimizing and using gradient descent"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [],
   "source": [
    "epochs = 100\n",
    "batch_size = 100\n",
    "n_neurons_layer1 = 100\n",
    "n_neurons_layer2 = 50\n",
    "n_categories = 10\n",
    "eta_vals = np.logspace(-5, 1, 7)\n",
    "lmbd_vals = np.logspace(-5, 1, 7)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Learning rate =  1e-05\n",
      "Lambda =  1e-05\n",
      "Test accuracy: 0.092\n",
      "\n",
      "Learning rate =  1e-05\n",
      "Lambda =  0.0001\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  1e-05\n",
      "Lambda =  0.001\n",
      "Test accuracy: 0.075\n",
      "\n",
      "Learning rate =  1e-05\n",
      "Lambda =  0.01\n",
      "Test accuracy: 0.114\n",
      "\n",
      "Learning rate =  1e-05\n",
      "Lambda =  0.1\n",
      "Test accuracy: 0.150\n",
      "\n",
      "Learning rate =  1e-05\n",
      "Lambda =  1.0\n",
      "Test accuracy: 0.078\n",
      "\n",
      "Learning rate =  1e-05\n",
      "Lambda =  10.0\n",
      "Test accuracy: 0.114\n",
      "\n",
      "Learning rate =  0.0001\n",
      "Lambda =  1e-05\n",
      "Test accuracy: 0.108\n",
      "\n",
      "Learning rate =  0.0001\n",
      "Lambda =  0.0001\n",
      "Test accuracy: 0.106\n",
      "\n",
      "Learning rate =  0.0001\n",
      "Lambda =  0.001\n",
      "Test accuracy: 0.122\n",
      "\n",
      "Learning rate =  0.0001\n",
      "Lambda =  0.01\n",
      "Test accuracy: 0.053\n",
      "\n",
      "Learning rate =  0.0001\n",
      "Lambda =  0.1\n",
      "Test accuracy: 0.053\n",
      "\n",
      "Learning rate =  0.0001\n",
      "Lambda =  1.0\n",
      "Test accuracy: 0.078\n",
      "\n",
      "Learning rate =  0.0001\n",
      "Lambda =  10.0\n",
      "Test accuracy: 0.086\n",
      "\n",
      "Learning rate =  0.001\n",
      "Lambda =  1e-05\n",
      "Test accuracy: 0.333\n",
      "\n",
      "Learning rate =  0.001\n",
      "Lambda =  0.0001\n",
      "Test accuracy: 0.175\n",
      "\n",
      "Learning rate =  0.001\n",
      "Lambda =  0.001\n",
      "Test accuracy: 0.222\n",
      "\n",
      "Learning rate =  0.001\n",
      "Lambda =  0.01\n",
      "Test accuracy: 0.283\n",
      "\n",
      "Learning rate =  0.001\n",
      "Lambda =  0.1\n",
      "Test accuracy: 0.150\n",
      "\n",
      "Learning rate =  0.001\n",
      "Lambda =  1.0\n",
      "Test accuracy: 0.108\n",
      "\n",
      "Learning rate =  0.001\n",
      "Lambda =  10.0\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  0.01\n",
      "Lambda =  1e-05\n",
      "Test accuracy: 0.753\n",
      "\n",
      "Learning rate =  0.01\n",
      "Lambda =  0.0001\n",
      "Test accuracy: 0.703\n",
      "\n",
      "Learning rate =  0.01\n",
      "Lambda =  0.001\n",
      "Test accuracy: 0.778\n",
      "\n",
      "Learning rate =  0.01\n",
      "Lambda =  0.01\n",
      "Test accuracy: 0.739\n",
      "\n",
      "Learning rate =  0.01\n",
      "Lambda =  0.1\n",
      "Test accuracy: 0.203\n",
      "\n",
      "Learning rate =  0.01\n",
      "Lambda =  1.0\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  0.01\n",
      "Lambda =  10.0\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  0.1\n",
      "Lambda =  1e-05\n",
      "Test accuracy: 0.975\n",
      "\n",
      "Learning rate =  0.1\n",
      "Lambda =  0.0001\n",
      "Test accuracy: 0.969\n",
      "\n",
      "Learning rate =  0.1\n",
      "Lambda =  0.001\n",
      "Test accuracy: 0.975\n",
      "\n",
      "Learning rate =  0.1\n",
      "Lambda =  0.01\n",
      "Test accuracy: 0.975\n",
      "\n",
      "Learning rate =  0.1\n",
      "Lambda =  0.1\n",
      "Test accuracy: 0.106\n",
      "\n",
      "Learning rate =  0.1\n",
      "Lambda =  1.0\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  0.1\n",
      "Lambda =  10.0\n",
      "Test accuracy: 0.106\n",
      "\n",
      "Learning rate =  1.0\n",
      "Lambda =  1e-05\n",
      "Test accuracy: 0.978\n",
      "\n",
      "Learning rate =  1.0\n",
      "Lambda =  0.0001\n",
      "Test accuracy: 0.983\n",
      "\n",
      "Learning rate =  1.0\n",
      "Lambda =  0.001\n",
      "Test accuracy: 0.972\n",
      "\n",
      "Learning rate =  1.0\n",
      "Lambda =  0.01\n",
      "Test accuracy: 0.761\n",
      "\n",
      "Learning rate =  1.0\n",
      "Lambda =  0.1\n",
      "Test accuracy: 0.078\n",
      "\n",
      "Learning rate =  1.0\n",
      "Lambda =  1.0\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  1.0\n",
      "Lambda =  10.0\n",
      "Test accuracy: 0.078\n",
      "\n",
      "Learning rate =  10.0\n",
      "Lambda =  1e-05\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  10.0\n",
      "Lambda =  0.0001\n",
      "Test accuracy: 0.089\n",
      "\n",
      "Learning rate =  10.0\n",
      "Lambda =  0.001\n",
      "Test accuracy: 0.106\n",
      "\n",
      "Learning rate =  10.0\n",
      "Lambda =  0.01\n",
      "Test accuracy: 0.086\n",
      "\n",
      "Learning rate =  10.0\n",
      "Lambda =  0.1\n",
      "Test accuracy: 0.114\n",
      "\n",
      "Learning rate =  10.0\n",
      "Lambda =  1.0\n",
      "Test accuracy: 0.078\n",
      "\n",
      "Learning rate =  10.0\n",
      "Lambda =  10.0\n",
      "Test accuracy: 0.078\n",
      "\n"
     ]
    }
   ],
   "source": [
    "DNN_tf = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)\n",
    "        \n",
    "for i, eta in enumerate(eta_vals):\n",
    "    for j, lmbd in enumerate(lmbd_vals):\n",
    "        DNN = NeuralNetworkTensorflow(X_train, Y_train, X_test, Y_test,\n",
    "                                      n_neurons_layer1, n_neurons_layer2, n_categories,\n",
    "                                      epochs=epochs, batch_size=batch_size, eta=eta, lmbd=lmbd)\n",
    "        DNN.fit()\n",
    "        \n",
    "        DNN_tf[i][j] = DNN\n",
    "        \n",
    "        print(\"Learning rate = \", eta)\n",
    "        print(\"Lambda = \", lmbd)\n",
    "        print(\"Test accuracy: %.3f\" % DNN.test_accuracy)\n",
    "        print()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAkIAAAJgCAYAAABmwww9AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4wLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvqOYd8AAAIABJREFUeJzs3XmcjfX7x/HXzJwzuxnLLNaIMJaRbI2EKJHIEr+oLIMiS5Y232wVipJJliQpJWUrEomoEC2UFDFZxjLGLGbMDDNjlnN+f0wd7mbGkplzzJz38/GYx8N9znXu+7rOOffxOdf9ue/jYrVarYiIiIg4IVdHJyAiIiLiKBoIiYiIiNPSQEhERESclgZCIiIi4rQ0EBIRERGnpYGQiIiIOC0NhETsaMqUKXTp0oUuXbpQv3592rdvb1vOyMi46vVs3ryZKVOmXDYmNjaWXr16XW/KeUybNo369etz+vTpQl+3iIi9ueg6QiKO0bZtW2bNmkVoaKijU7lqFy5coHXr1rRo0YIKFSrw9NNPOzolEZHroo6QyA2kfv36jBw5kvbt2/P777+zcuVKevbsSdeuXWnTpg1Lly4F4NNPP2Xw4MEA9OnTh9dff51HHnmEtm3b8swzz2CxWDh58iS33XYbALNnz2bs2LEMHDiQDh068PDDDxMbGwvA3r176d69O507d2bYsGF069aNH3/8Md/81q1bx0033UT//v1Zvnw56enptvuOHj1Knz59uP/+++ncuTPr16+/7O1t27bl999/tz3+n+WTJ0/SunVrBgwYQPv27YmLi2P+/Pn06NGDzp07c88997Bp0yYAsrOzeeWVV2jfvj0dO3Zk3LhxZGZm0r59e7Zv325b9/jx41m8eHGhvEYiUrJoICRyA8nKyqJNmzZ89dVXVK9enRUrVrBgwQJWr15NREQEr732Wr6PO378OB9++CGff/45P/zwAz/99FOemF27djFr1iw2bNiAn58fy5YtIzs7mxEjRjBy5EjWrl1Lnz59+PPPPwvM7+OPP+aBBx4gNDSUwMBAPvvsM9t9Y8aMoUOHDqxbt44FCxYwc+ZMzp07V+Dtl3P69GmGDh3KV199RVZWFjt27GDJkiWsXbuW0aNH8+abbwKwdOlS9u3bx5o1a/jiiy84f/4869evp3fv3qxYsQKAc+fOsXnzZrp163bF519EnI/J0QmIiFGTJk0A8PHxYf78+Xz33XdERUVx4MAB0tLS8n1MmzZtcHV1xdfXl6pVq5KcnEzlypUNMc2aNcPX1xeAunXrkpycTGRkJACtW7cGICwsjJo1a+a7jX379vHnn3+yYMECALp27coHH3xA7969SU5O5sCBA/Ts2ROAChUq8PXXX3P27Nl8b78Sk8lEw4YNAahUqRLTp09n7dq1HDt2jN9++43z588DsGPHDrp06YKnpycAb7zxBgApKSnMnTuXxMRENmzYwF133YWfn98VtysizkcdIZEbjLe3N5DbFenatSvR0dE0btyYUaNGFfiYfwYCAC4uLuQ39S+/GDc3tzyxbm5u+W5j6dKlmEwmHnzwQdq2bcuHH35IVFQUW7duxWQy2db7jyNHjtjW9e/b/5kYfum2MzMzbf92d3e3rXPfvn306tWLc+fO0aJFCwYNGmSL+yfmHwkJCcTFxeHn50eHDh34/PPPWbVqFb179863JhERDYREblB//PEHZcuWZejQobRs2ZJvvvkGgJycnELbRo0aNXB3d2fr1q1A7nyhyMhIw8AFcjss69atY/78+WzZsoUtW7awdetWHnjgAd5//318fX2pV68eq1evBiAmJobevXuTkZGR7+2pqamULVuWP/74A4A9e/YQHx+fb44///wz9evXJzw8nGbNmrF582bbc9C8eXO++OILMjMzsVgsvPDCC6xbtw6ARx55hA8++ACr1UqDBg0K7TkTkZJFh8ZEblAtWrRg5cqVdOjQAS8vLxo0aEDZsmU5duxYoW3DZDIxe/ZsJk2axMyZM6lWrRoBAQGG7hHAZ599Ro0aNQgLCzPc/sQTT3D//fcTGRnJ66+/zosvvsiHH36Ii4sLU6dOJTAwsMDbn376aV544QWWLVtGvXr1qFevXr45durUiY0bN9KxY0fMZjPNmzcnOTmZc+fO0atXL6Kjo+nevTtWq5VmzZrRp08fAEJCQvD39y+SSwiISMmh0+dFnNz06dMZOHAgAQEBxMTE0KVLF77++utiP6fm+PHj9OnThw0bNuDl5eXodETkBqWOkIiTq1SpEv3798dkMmG1WpkyZUqxHwTNmjWL5cuXM27cOA2CROSy1BESERGRYuOfw+Lz58/Pc3bsn3/+yfjx4zl37hxNmjThxRdfzHNSxb9psrSIiIgUC7/9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GAjJDaoQB0LFkh0GQjesIhwIFQt2GgjdsErwPLWroYFQ0dEFFUVERMQgx4kuM+g8lYqIiIj8izpCIiIiYqDT50VEREScgDpCIiIiYnAj/PSFvagjJCIiIk5LHSERERExyLE6T5/EeSoVERER+Rd1hERERMTA4kR9EuepVERERORf1BESERERA501JiIiIuIE1BESERERA501JiIiIuIENBASERERp6VDYyIiImJg0WRpERERkZJPHSERERExyHGiPonzVCoiIiLyL+oIiYiIiIFOnxcRERFxAuoIiYiIiIF+dFVERETECagjJCIiIgY5Vl1HSERERKTEU0dIREREDHQdIREREREnoI6QiIiIGFh0HSERERGRkk8dIRERETHQHCERERERJ6CBkIiIiDgtHRoTERERA11QUURERMQJFMuOkDXjgqNTcBgXd3dHp+BYrs49ds85e9bRKTiMS2qqo1NwKFd/P0en4FguztOhuBHoR1dFREREnECx7AiJiIhI0cnRBRVFRERESj51hERERMTAgvPMyVJHSERERJyWOkIiIiJioDlCIiIiIk5AHSEREREx0I+uioiIiDgBdYRERETEwKLfGhMREREp+dQREhEREQPNERIRERFxAhoIiYiIiNPSoTERERExsOiCiiIiIiIlnzpCIiIiYpCjH10VERERKfnUERIREREDzRESERERcQLqCImIiIiB5giJiIiIOAF1hERERMRAc4REREREnIA6QiIiImKQo46QiIiISMmnjpCIiIgYWHTWmIiIiEjJp46QiIiIGGiOkIiIiIgTUEdIREREDCxWzRESERERKfE0EBIRERGnpYGQiIiIGOTgare/a7F27Vo6duxIu3bt+Oijj/Lcv2/fPh588EEeeOABBg8eTEpKyhXX6dRzhJq1v5XwF3tidjdxdN8JIoa+S1pqxlXFuLq6MGxmX0LvrA3Az1/t5Z1xnxgeG1w1gLnbXuR/XV7jr1+j7FVWoWjWLpTwid1z695/kognF+d5bv7x1Jxwog5Es2rORjtneX2a3RtK+MQH/35tTxLx5Pt5X/8CYnxL+zDi9UepEVqFjLQLbPzoez5/ZwsAvqV9GPpqb26qXREPTzOfzFzH5mU/OKLEAjXr2IiBLz+M2cPM0b3HeH3QW6Slpl91zIrYdzkTnWiLXT5jDT+u+4XXv3nRsI5qoTfx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KjOffJ/xiwZjcjcRExXPa0MXUbNhVUZF9GVYm8mOTtGuboRDVvbiYr0RJulco2b9Zzo6BYfxjyw+1+YpChlBHlcOKsFcit3eWni8oovnHLzC4pp4ztEpOJQ1JeXKQSXYhoQFdt1e6OeT7Lat3x940W7byo8uqCgiIiIGuqCiiIiIiBNQR0hEREQMit+kmf9OHSERERFxWuoIiYiIiIEznTWmjpCIiIg4LXWERERExEAdIREREREnoI6QiIiIGDjRSWPqCImIiIjzUkdIREREDDRHSERERMQJqCMkIiIiRk40SUgdIREREXFaGgiJiIiI09KhMRERETHQZGkRERERJ6COkIiIiBhYNVlaREREpORTR0hEREQMNEdIRERExAmoIyQiIiJG6giJiIiIlHzqCImIiIiBzhoTERERcQLqCImIiIiROkIiIiIiJZ86QiIiImKg6wiJiIiIOAENhERERMTIase/a7B27Vo6duxIu3bt+Oijj/Lcf+TIEfr06cMDDzzAwIEDSU5OvuI6NRASERGRG15sbCwREREsXbqUNWvWsGzZMg4dOmS732q18sQTT/DYY4/x+eefU6dOHRYsWHDF9WqOkIiIiDhMSkoKKSkpeW738/PDz8/Ptrxjxw7CwsIoXbo0AO3bt2fDhg0MHz4cgH379uHt7U2rVq0AGDJkSL7r/TcNhERERMTAnpOlFy9ezJw5c/LcPnz4cEaMGGFbjouLIzAw0LYcFBTE3r17bcvHjx8nICCA5557jv3791OrVi0mTJhwxe1rICQiIiIO069fP7p165bn9ku7QZB76OvfXFwuDtiys7P56aefWLJkCaGhobzxxhtMmzaNadOmXXb7xXIg1Gr0j45OwWGi0/0dnYJD1faNdXQKDpWU5e3oFBzm10mNHJ2CQ3lHnXJ0CuJM7HhBxX8fAitIcHAwu3btsi3HxcURFBRkWw4MDKRq1aqEhoYC0KlTJ5588skrrleTpUVEROSGd8cdd7Bz504SExNJT09n48aNtvlAALfddhuJiYkcOHAAgC1btlCvXr0rrrdYdoRERESkKN14F1QMDg5m9OjR9O3bl6ysLHr06EGDBg147LHHePLJJwkNDWXu3LmMHz+e9PR0ypcvz6uvvnrF9WogJCIiIsVC586d6dy5s+G2d955x/bvW2+9lZUrV17TOjUQEhERESP96KqIiIhIyaeOkIiIiBipIyQiIiJS8qkjJCIiIkZ2vLK0o6kjJCIiIk5LHSERERExyOfXLEosdYRERETEaakjJCIiIkbqCImIiIiUfBoIiYiIiNPSoTEREREx0unzIiIiIiWfOkIiIiJi4KLJ0iIiIiIlnzpCIiIiYqSOkIiIiEjJp46QiIiIGOmsMREREZGSTx0hERERMdIcIREREZGSTx0hERERMVJHSERERKTkU0dIREREjNQREhERESn51BESERERI11HSERERKTk00BIREREnJYOjYmIiIiBiyZLi4iIiJR86giJiIiIkRN1hDQQKkDsL8n8uTQGS5YVv6qe3DrkJszeboaYmJ/OcnD5aVxcwOxr4tbBVfAp7+GgjK9P8p4zRK84ijXbglcVH6oOrI2b18W3x5ntp4n76qRtOScth8ykC4RGhGH2dyd+czQJ353GkmnBu5ovVQfWxtVcfBqO0bvP8duSeCzZVkpX9eD2oeXzvN4nfkzl908ScHEFdx83mg0tT6ny7mRfsLBrYSyJhzKwWqyUq+VFk0HBmDyKT/1xvyQT+Uk0liwrpW7yInRwVUyX1B+99QxR6+Jsy9lpOWQkZnLX3FBcTC7sX3iclGPpmDxcqXRXOap2CHJEGf9JWJPqDO7bCrPJjcPH4pn+5gbS0jMNMe3uqkvvbk2xWuHChSxmvbOZg4diAQjvfQdt7wwhx2Ih8nAsM+ZuJDMrxxGlFIpm7UIJH98Ns4eJo/uiiRi5mLRzGfnGPjW7P1EHolk1d5Odsywazly7Mys+n9R2dCElmz3zTtDkqZtpO6sO3kEe/Ln0lCEmJ9PCr7OP0/Tpm2n9WgjBjf34471oB2V8fbJSMjm28CDVR9Sl3vRmeAR6Eb38qCGm3J3lqTO5CXUmNyFkUiPM/maq9LkFs787Sbviidt0iprPNqDuy02wZlkMg6YbXUZyNj/OiaHlM5XoNLs6vsFm9iyJN8RkX7Cwc9YpWj5biftev5lKTX355d3c/wj3rzqDNcfKfa9X476ZN5NzwcL+T884opT/JDMliz/mH+O20dVpFVEP7yAPDn5sfC9XalWOFtPr0GJ6HZpPDcG9tJk64VXwKG3mwAcncfN0o+XrdQmbUpv4PSnE7U52UDXXxt/Pi/892YEJr6zm0aHvEnP6LIP7tTLEVKlUhqH9W/PMCysZOGoxHyzfyZT/dQWgYf0qtG0ZwsDRH9B/xPt4e3nQvVMjR5RSKPzL+TLmzX5MDp/PoLCJxByLJ3xi9zxxVWqWZ9pnY2jZpYkDsiwazly7s7PbQCgqKorY2Nz/OFasWMGUKVNYv369vTZ/TeJ/S6F0DW98K+R2d6rdW47obUlYrRd7hVaLFavVSlZa7je/nAwLrubied2F1D+S8K5eCs/y3gAEtK1I4s5YQ72XOr3uBCY/dwLbVAQg8ftYgjtUxuRrxsXVhSr9alL2jmC75X+9Tv92nnK3eFKqojsAt7QvzbFtKf96vQErZKVZAMi+5PUOrOtNvR4BuLi64OrmQpnqnpxPyLJ7Hf9Vwt5U/Gt441PBE4Aq7QKI2Z5Y4Ot/9PPTePiZuOmeQABSjqRRsWXZ3PpNrgTe5s/pH5Pslv/1aHZbNQ78dZqTMWcBWP3lHtq1rmuIycrKYfqcrziTdB6AA4diKVvaB5PJFVdXF9zNJjzcTZhMrri7u5GZmW33OgpLozZ1idxzjFNHcrt/6977jrY9bs8T13lgGzYt3cG2NbvsnWKRceband0VD40tWrSIOXPmkJOTQ8WKFaldu7btr1atWlSuXPmKG3n//ff58MMPsVgshIWFERMTQ7t27Vi1ahVHjx5l2LBhhVJMYUk/k4VXObNt2bOcO9npFrLTLbbDJSZPNxo8VoXvx/+FuZQbVgvcObmmo1K+LpmJF3Ave/GQnntZDyzpOVgycgyHxwCyU7OI23CSkJcufuu9cDqd7OqZHJqxl8ykTHxr+1Ppoep2y/96pSVk4x1w8fX2LmcmK834epu9XGk6uDybnj+GRyk3LBYr7aZWBaBCQx/bY8/HZRH5RRJNh5S3bxHXIeNMJp7l3G3L/7zfc9IthsNjAJkp2RxdF8cdr4TYbvO/xYdT2xIpU9sXS7aF2J+ScHErHl8KggJKEZeQaluOT0jF18cDby932+Gx03EpnI5LscUMH9iG7386RHa2hV/2HmfXnihWvDuY7Owcjkcn8flXv9m9jsISWLEs8dGJtuX4U0n4+Hnh7etpOEQ0b+zHADRsFZJnHcWVM9eeH2c6a+yKA6G3336bV199lQYNGnDixAkiIyM5ePAgW7du5a+//gKgZs2afPzxxwWuY9WqVaxfv56EhAQ6derEDz/8gIeHBz179qRHjx433EAIS/43u1zSP0s5nk7kytPcNTMEn/IeHFkfz67Xj9Lq1dq4uBSP/wRsCvjmj2veOhK+PYV/o3J4BHpdfHiOlZQ/kqgxqj4uZleOLTjAqZVHqfLILUWVcaEqqPPhckn9Z49l8MeKBDrOuplS5d05uC6R7a9F0+H1arbXO/FwBttePUnN+0pTqYmvXXIvDNYC3u/59YtPbE4gqLE/3kEXB84hfSpxcEk0O8b+iUcZM+VC/Tgbea5oki1kLvm8xwEslrzvCU8PM/8bdR9BAaV45oWVAHS8pz4VgkvTrf88srMsjB3ZgWED2jBrweYizbuoFPR85FgKepOUHM5cu7O74kDI19eXu+66C5PJRFBQEI0bNzbcf/LkSduAqCAWiwV3d3cqVarEgAED8PC4+CGak3PjTSr0CjCTdOi8bTkjMQuzjxsmz4vfjuP3pFK2to9tcvTNHQLYtziazNQcPPyK1xx0c1lPzh+++K04M+kCbj4m3Dzc8sQm/RhP5UeNAxxzaXdKNw6wdY/K3hFMzJpjRZt0IfIOMHPmr4vf+NLPZOPu64rJ8+JIIGbPeQJCvChVPrdzUrNDGX59P872eh/bnsKud07TeFAw1Vr6272G6+EVYCb5kvf7hcTMPO/3f5zemUSd/sYucHa6hVqPVMLdN/f1P7LmNN7BnkWbdCGJjU+lbq0KtuWAcqVISU0n44Lx0GZQQCmmTejOsRNnGDlume3wV6vmtdj03X7S03Pj1361l1GD77ZfAYUsPjqRkMY325YDKpQmNek8F9IyL/OoksGZa8+XfmLjoscff5wVK1YUeH/lypVp06bNZddx77338uijj5KTk8OIESMAOHDgAA8//DD33XffNaZc9AJvLUXSX2mci7kAwLFNCZRvavzPzb+6F2f+PMeFs7kfgDE/JeMd5F7sBkEAfqFlOH84hYzTaQAkbDmF/23l8sRln8/iQmw6vrf4GW4v3TSQpJ/jsWTmYLVaOftLAj43l7JL7oWhQkMfEiLTST2V+4H318YkKjU15l+muifx+9JIP5v7H2D0T6n4BJnx8DNxfGcKu9+N5a4JVYrdIAigXAM/zh46z/mY3MHg8a8TCGqSt46sc9mkxV6gdC1jt+vEpngOLY8B4MLZLE5uOUPFO8sUfeKF4Odfo6hbuyKVK5QGoMt9t7L9x0OGmFK+nsx+pRdbd/7FizO+MMwBijwcS6vmNXH7u5vQqnlN9h+MsV8BhWz3N/sJaVyditVzz/q7v39rdn65x8FZ2Ycz1+7srvi/9rRp08jKymLbtm20bNmSOnXqULt2bby8vK70UJuRI0fy888/4+Z28Rumu7s7I0aMoHXr1v8t8yLk4W+m4RM3sXvmUSzZVryDPbht+E2cPZzGb/OP0/q1EALql6JG5yB2vHgIV5MLZl8TzZ69+corvwGZ/dypOqg2R+fsx5JtxSPIk2qPh3D+aCrHFx2kzuTcsyMuxKZjLu2Oi8k4fg68uyI557I4MOkXrBYr3lV9qRxewxGl/Cee/ibChlVg+4xoLNlWfMubCRtRkTOH0vnprdPc9/rNlA/1IaRLObZMPI6ryQV3XzdaPZfbGfnt7zPMfnrrtG2dgSFeNHmseMwT8vA3EzqkKnsijmLJtuAd7EHosGokHz7PHwuO02J6HQDSYi/gUdqMq8n4TbF61/LsnRvF9qf3A3BLj/L41/DJs50b0dnkNKbN+pKXxnbBbHIj+vRZpkasp/YtwTw7vAMDRy2m630NCQrwo2VYTVqGXZwHOHrCMpas+IFhA9vwwdwBZGXlcCgqnoj5xfd06uSEVGY++T7jFw3G5G4iJiqe14YuombDqoyK6MuwNpMdnWKRceba8+VEc4RcrAVNkPjbiRMnOHDgAAcPHuTgwYMcOHCAU6dOUblyZb766it75Wnw9G8POWS7N4Lo9OLXcShMtX1jHZ2CQyVleTs6BYf5dVLxPS29MHjvuPwUBCnZNiQssOv2qr8x027bOjJqjN22lZ8rdoSqVKlClSpVaNeune22tLQ0IiMjizQxERERcRAn6gj9p+sIeXt707Bhw8LORURERMSuit/MXhERESlSznQdIf3EhoiIiDgtdYRERETESB0hERERkZJPAyERERFxWjo0JiIiIkY6NCYiIiJS8qkjJCIiIgY6fV5ERETECagjJCIiIkZWlyvHlBDqCImIiIjTUkdIREREjDRHSERERKTkU0dIREREDHTWmIiIiIgTUEdIREREjNQREhERESn51BESERERA80REhEREXEC6giJiIiIkTpCIiIiIiWfBkIiIiLitHRoTERERIx0aExERESk5FNHSERERAx0+ryIiIiIE9BASERERJyWBkIiIiLitDRHSERERIw0R0hERESk5FNHSERERAx01piIiIiIEyiWHaFpwbsdnYKIQ6RZMh2d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\n",
      "text/plain": [
       "<Figure size 720x720 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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O27eMJLjzrNqzjrDfhu0qsvYN4bi5eOBOc/Mu899wm/bDhVLm519fa4e9C+EdmvCiBfvweRmIvZkInOf+IhqtQOYMHcw43vMNsRebgoxwHexixjY5NmSmULsU6H49wmE3taIEU/dkf8Znz7H3GdXU62mPxNm9Wd83wWG2H9On3f3cGXsS30JaVkLF5MLP204wPJ535dIOy3RscW2r5I691t0bsyomQNx83AlL9fMytlfsfPrfQWO/2849Ln/1/7tad/pWnY7Vutap+12rMLYrSNUnIqrI1QuFWNHqDwqzo5QeVRSfwzKhRLqCJUXxdkRKo8c+txHHaGSVLYe7iIiIiKlzuxAjxl0nExFRERE/kEVIRERETHQ9HkRERERB6CKkIiIiBiUha++sBdVhERERMRhqSIkIiIiBmar49RJHCdTERERkX9QRUhEREQMLA5UJ3GcTEVERET+QRUhERERMdCsMREREREHoIqQiIiIGGjWmIiIiIgDUEdIREREHJZujYmIiIiBRYOlRURERG58qgiJiIiIgdmB6iSOk6mIiIjIP6giJCIiIgaaPi8iIiLiAFQREhEREQN96aqIiIiIA1BFSERERAzMVj1HSEREROSGp4qQiIiIGOg5QiIiIiIOQBUhERERMbDoOUIiIiIiNz5VhERERMRAY4REREREHIA6QiIiIuKwdGtMREREDPRARREREREHUC4rQk7ubqXdhNJjtZZ2C0qVk5tPaTehVOVFx5R2E0pPfEJpt6BUOXt6lnYTSpU1M6u0m+BQ9KWrIiIiIg6gXFaEREREpOSY9UBFERERkRufKkIiIiJiYEGzxkRERERueKoIiYiIiIHGCImIiIg4AFWERERExEBfuioiIiLiAFQREhEREQOLvmtMRERE5ManipCIiIgYaIyQiIiIiANQR0hEREQclm6NiYiIiIFFD1QUERERufGpIiQiIiIGZn3pqoiIiMiNTxUhERERMdAYIREREREHoIqQiIiIGGiMkIiIiIgDUEVIREREDDRGSERERMQBqCIkIiIiBmZVhERERETKlvXr13PnnXfSo0cPVq5cWeD9gwcPcv/993PPPffw6KOPkpaWdtV9qiMkIiIiBhac7PYqqvj4eObPn88nn3zC2rVrWb16NUePHjXEzJo1iyeeeIJ169ZRt25dPvjgg6vuVx0hERERKfN27NhB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z/f5K/9zzH1yBdVqVWbCnEGMv+N1Q+w/p88v3TaFCr6eJMVdGmf05y8nWDyl+J+NUVzPEWrbuxUjX3kIVzcTMcfimTN8IdVuCmTS+48xpvUzl41JT8nA3dON8QtH0fjWhphcXdj2xU6WTV4FQJ2mtXh84Si8fb2wWCx8+tpXbPu87E0fLo/5F+dzhEJ7NWfktAfy/787kcDro9+lap1Anlw8krHtIy4b8/8H/o6bN4zkuPOsmrPOsN8WnRszauZA3Dxcycs1s3L2V+z8el+B4/8bxfkcodAezQif2h+TmwuxJxJ5fcxSqtWpwsS3RjBb2/fyAAAgAElEQVQu7OXLxmSkXMCnkjdjXx9M/Ra1sZgt7N96iPcmr8acZ6ZKDX/GzR1CtTpVcHJ24qslm/j2w63F0mZ7P0dowq8P2u1YC1qtstuxCqMHKpY35e/jKl56oGJpN0FKiR6o6Nhze9QRKjmOfWaJiIhIARar48wac5xMRURERP5BFSERERExMFP6s7nsRRUhERERcViqCImIiIhBWfgOMHtRRUhEREQcljpCIiIi4rB0a0xEREQMNH1eRERExAGoIiQiIiIGFk2fFxEREbnxqSIkIiIiBmZNnxcRERG58akiJCIiIgaaNSYiIiLiAFQREhEREQN9xYaIiIiIA1BFSERERAz0HCERERERB6CKkIiIiBhojJCIiIiIA1BFSERERAz0HCERERERB6COkIiIiDgs3RoTERERAw2WFhEREXEAqgiJiIiIgR6oKCIiIuIAVBESERERA40REhEREXEAqgiJiIiIgSpCIiIiIg5AFSERERExUEVIRERExAGUy4pQUu/6pd2EUlN5X0ppN6FU5fl5lnYTSlV2aM3SbkKp8fkjsbSbULrS0ku7BaXKmpVd2k1wKKoIiYiIiDiAclkREhERkZKjJ0uLiIiIOABVhERERMRAY4REREREHIA6QiIiIuKwdGtMREREDHRrTERERMQBqCIkIiIiBqoIiYiIiDgAVYRERETEQBUhEREREQegipCIiIgYWFUREhEREbnxqSIkIiIiBvrSVREREREHoIqQiIiIGGjWmIiIiIgDUEVIREREDDRrTERERMQBqCIkIiIiBhojJCIiIuIA1BESERERh6VbYyIiImKgwdIiIiIiDkAVIRERETHQYGkRERERB6CKkIiIiBhYraXdAvtR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RERufKoIiYiIiIHGCImIiIg4AFWERERExEgVIREREZGyZf369dx555306NGDlStXFnj/+PHjDB06lHvuuYdRo0aRmpp61X2qIyQiIiIGVqv9XkUVHx/P/Pnz+eSTT1i7di2rV6/m6NGjf2uzlccee4zRo0ezbt06GjduzHvvvXfV/aojJCIiImXejh07aNeuHX5+fnh5edGrVy82bNhge//gwYN4eXnRuXNnAMaMGcPgwYOvul+NERIREREjOz5HKC0tjbS0tALrfX198fX1tS0nJCRQpUoV23JgYCAHDhywLZ8+fZqAgACee+45/vzzTxo2bEhERMRVj6+KkIiIiJSa5cuX07179wKv5cuXG+KshdxHc3K6NKg7Ly+Pn3/+mSFDhrB+/Xpq1qzJq6++etXjqyIkIiIiBvZ8jtDw4cPp169fgfV/rwYBBAUF8csvv9iWExISCAwMtC1XqVKF2rVr06xZMwD69OnDE088cdXjqyIkIiIipcbX15caNWoUeP2zI9ShQwd27txJcnIyWVlZbNy40TYeCKBVq1YkJycTGRkJwJYtW2jSpMlVj6+KkIiIiBiVwe8aCwoK4sknn2TYsGHk5ubSv39/mjdvzujRo3niiSdo1qwZixYtYsqUKWRlZVG1alXmzJlz1f2qIyQiIiLlwt13383dd99tWPf+++/b/t2iRQu++OKLa9qnbo2JiIiIw1JFSERERAz0pasiIiIiDqBcVoRufuxgaTeh1Jy9ULG0m1CqmvodvXrQDSwu23E//5RJ1Uu7CaXKOT6xtJsgjqQMDpYuKaoIiYiIiMMqlxUhERERKUkaIyQiIiJyw1NFSERERIw0RkhERETkxqeKkIiIiBipIiQiIiJy41NFSERERIz0ZGkRERGRG58qQiIiImJg1RghERERkRufKkIiIiJipIqQiIiIyI1PHSERERFxWLo1JiIiIkaaPi8iIiJy41NFSERERAycNFhaRERE5ManipCIiIgYqSIkIiIicuNTRUhERESMNGtMRERE5ManipCIiIgYaYyQiIiIyI1PFSERERExUkVIRERE5ManipCIiIgYqSIkIiIicuNTRUhERESM9BwhERERkRufOkIiIiLisHRrTERERAycNFhaRERE5ManipCIiIgYOVBFSB2hv6TsT+bMZyex5FrxqunFTaMbYPK89ONJ3B5P7Hcx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\n",
      "text/plain": [
       "<Figure size 720x720 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# optional\n",
    "# visual representation of grid search\n",
    "# uses seaborn heatmap, could probably do this in matplotlib\n",
    "import seaborn as sns\n",
    "\n",
    "sns.set()\n",
    "\n",
    "train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "\n",
    "for i in range(len(eta_vals)):\n",
    "    for j in range(len(lmbd_vals)):\n",
    "        DNN = DNN_tf[i][j]\n",
    "\n",
    "        train_accuracy[i][j] = DNN.train_accuracy\n",
    "        test_accuracy[i][j] = DNN.test_accuracy\n",
    "\n",
    "        \n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(train_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Training Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()\n",
    "\n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(test_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Test Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [],
   "source": [
    "# optional\n",
    "# we can use log files to visualize our graph in Tensorboard\n",
    "writer = tf.summary.FileWriter('logs/')\n",
    "writer.add_graph(tf.get_default_graph())"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Using Keras\n",
    "\n",
    "Keras is a high level [neural network](https://en.wikipedia.org/wiki/Application_programming_interface)\n",
    "that supports Tensorflow, CTNK and Theano as backends.  \n",
    "If you have Tensorflow installed Keras is available through the *tf.keras* module.  \n",
    "If you have Anaconda installed you may run the following command"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [],
   "source": [
    "conda install keras"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Alternatively, if you have Tensorflow or one of the other supported backends install you may use the pip package manager:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {},
   "outputs": [],
   "source": [
    "pip3 install keras"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "or look up the [instructions here](https://keras.io/)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [],
   "source": [
    "from keras.models import Sequential\n",
    "from keras.layers import Dense\n",
    "from keras.regularizers import l2\n",
    "from keras.optimizers import SGD\n",
    "\n",
    "def create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, eta, lmbd):\n",
    "    model = Sequential()\n",
    "    model.add(Dense(n_neurons_layer1, activation='sigmoid', kernel_regularizer=l2(lmbd)))\n",
    "    model.add(Dense(n_neurons_layer2, activation='sigmoid', kernel_regularizer=l2(lmbd)))\n",
    "    model.add(Dense(n_categories, activation='softmax'))\n",
    "    \n",
    "    sgd = SGD(lr=eta)\n",
    "    model.compile(loss='categorical_crossentropy', optimizer=sgd, metrics=['accuracy'])\n",
    "    \n",
    "    return model"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {},
   "outputs": [
    {
     "ename": "AttributeError",
     "evalue": "module 'tensorflow' has no attribute 'get_default_graph'",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mAttributeError\u001b[0m                            Traceback (most recent call last)",
      "\u001b[0;32m<ipython-input-23-f0c6c49743b8>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m      3\u001b[0m \u001b[0;32mfor\u001b[0m \u001b[0mi\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0meta\u001b[0m \u001b[0;32min\u001b[0m \u001b[0menumerate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0meta_vals\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      4\u001b[0m     \u001b[0;32mfor\u001b[0m \u001b[0mj\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mlmbd\u001b[0m \u001b[0;32min\u001b[0m \u001b[0menumerate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mlmbd_vals\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 5\u001b[0;31m         \u001b[0mDNN\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mcreate_neural_network_keras\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mn_neurons_layer1\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mn_neurons_layer2\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mn_categories\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0meta\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0meta\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mlmbd\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mlmbd\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m      6\u001b[0m         \u001b[0mDNN\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfit\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mX_train\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mY_train\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mepochs\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mepochs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mbatch_size\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mbatch_size\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mverbose\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m0\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      7\u001b[0m         \u001b[0mscores\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mDNN\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mevaluate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mX_test\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mY_test\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m<ipython-input-22-a5c8eb5e69c7>\u001b[0m in \u001b[0;36mcreate_neural_network_keras\u001b[0;34m(n_neurons_layer1, n_neurons_layer2, n_categories, eta, lmbd)\u001b[0m\n\u001b[1;32m      5\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      6\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mcreate_neural_network_keras\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mn_neurons_layer1\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mn_neurons_layer2\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mn_categories\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0meta\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mlmbd\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 7\u001b[0;31m     \u001b[0mmodel\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mSequential\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m      8\u001b[0m     \u001b[0mmodel\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0madd\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mDense\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mn_neurons_layer1\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mactivation\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;34m'sigmoid'\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mkernel_regularizer\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0ml2\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mlmbd\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      9\u001b[0m     \u001b[0mmodel\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0madd\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mDense\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mn_neurons_layer2\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mactivation\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;34m'sigmoid'\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mkernel_regularizer\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0ml2\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mlmbd\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/usr/local/lib/python3.7/site-packages/keras/engine/sequential.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, layers, name)\u001b[0m\n\u001b[1;32m     85\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     86\u001b[0m     \u001b[0;32mdef\u001b[0m \u001b[0m__init__\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mlayers\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mNone\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mname\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mNone\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 87\u001b[0;31m         \u001b[0msuper\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mSequential\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__init__\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mname\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mname\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m     88\u001b[0m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_build_input_shape\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;32mNone\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     89\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/usr/local/lib/python3.7/site-packages/keras/legacy/interfaces.py\u001b[0m in \u001b[0;36mwrapper\u001b[0;34m(*args, **kwargs)\u001b[0m\n\u001b[1;32m     89\u001b[0m                 warnings.warn('Update your `' + object_name + '` call to the ' +\n\u001b[1;32m     90\u001b[0m                               'Keras 2 API: ' + signature, stacklevel=2)\n\u001b[0;32m---> 91\u001b[0;31m             \u001b[0;32mreturn\u001b[0m \u001b[0mfunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m*\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m     92\u001b[0m         \u001b[0mwrapper\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_original_function\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mfunc\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     93\u001b[0m         \u001b[0;32mreturn\u001b[0m \u001b[0mwrapper\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/usr/local/lib/python3.7/site-packages/keras/engine/network.py\u001b[0m in \u001b[0;36m__init__\u001b[0;34m(self, *args, **kwargs)\u001b[0m\n\u001b[1;32m     94\u001b[0m         \u001b[0;32melse\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     95\u001b[0m             \u001b[0;31m# Subclassed network\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 96\u001b[0;31m             \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_init_subclassed_network\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m**\u001b[0m\u001b[0mkwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m     97\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     98\u001b[0m     \u001b[0;32mdef\u001b[0m \u001b[0m_base_init\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mname\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mNone\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/usr/local/lib/python3.7/site-packages/keras/engine/network.py\u001b[0m in \u001b[0;36m_init_subclassed_network\u001b[0;34m(self, name)\u001b[0m\n\u001b[1;32m    292\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    293\u001b[0m     \u001b[0;32mdef\u001b[0m \u001b[0m_init_subclassed_network\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mname\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mNone\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 294\u001b[0;31m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_base_init\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mname\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mname\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    295\u001b[0m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_is_graph_network\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;32mFalse\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    296\u001b[0m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_expects_training_arg\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mhas_arg\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mcall\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m'training'\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/usr/local/lib/python3.7/site-packages/keras/engine/network.py\u001b[0m in \u001b[0;36m_base_init\u001b[0;34m(self, name)\u001b[0m\n\u001b[1;32m    107\u001b[0m         \u001b[0;32mif\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0mname\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    108\u001b[0m             \u001b[0mprefix\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__class__\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__name__\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mlower\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 109\u001b[0;31m             \u001b[0mname\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mprefix\u001b[0m \u001b[0;34m+\u001b[0m \u001b[0;34m'_'\u001b[0m \u001b[0;34m+\u001b[0m \u001b[0mstr\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mK\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mget_uid\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mprefix\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    110\u001b[0m         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mname\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mname\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    111\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;32m/usr/local/lib/python3.7/site-packages/keras/backend/tensorflow_backend.py\u001b[0m in \u001b[0;36mget_uid\u001b[0;34m(prefix)\u001b[0m\n\u001b[1;32m     72\u001b[0m     \"\"\"\n\u001b[1;32m     73\u001b[0m     \u001b[0;32mglobal\u001b[0m \u001b[0m_GRAPH_UID_DICTS\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 74\u001b[0;31m     \u001b[0mgraph\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mtf\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mget_default_graph\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m     75\u001b[0m     \u001b[0;32mif\u001b[0m \u001b[0mgraph\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0;32min\u001b[0m \u001b[0m_GRAPH_UID_DICTS\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     76\u001b[0m         \u001b[0m_GRAPH_UID_DICTS\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mgraph\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mdefaultdict\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mint\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;31mAttributeError\u001b[0m: module 'tensorflow' has no attribute 'get_default_graph'"
     ]
    }
   ],
   "source": [
    "DNN_keras = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)\n",
    "        \n",
    "for i, eta in enumerate(eta_vals):\n",
    "    for j, lmbd in enumerate(lmbd_vals):\n",
    "        DNN = create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories,eta=eta, lmbd=lmbd)\n",
    "        DNN.fit(X_train, Y_train, epochs=epochs, batch_size=batch_size, verbose=0)\n",
    "        scores = DNN.evaluate(X_test, Y_test)\n",
    "        \n",
    "        DNN_keras[i][j] = DNN\n",
    "        \n",
    "        print(\"Learning rate = \", eta)\n",
    "        print(\"Lambda = \", lmbd)\n",
    "        print(\"Test accuracy: %.3f\" % scores[1])\n",
    "        print()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "ename": "AttributeError",
     "evalue": "'int' object has no attribute 'evaluate'",
     "output_type": "error",
     "traceback": [
      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
      "\u001b[0;31mAttributeError\u001b[0m                            Traceback (most recent call last)",
      "\u001b[0;32m<ipython-input-13-b1a927878a20>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m     13\u001b[0m         \u001b[0mDNN\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mDNN_keras\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mi\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mj\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     14\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 15\u001b[0;31m         \u001b[0mtrain_accuracy\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mi\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mj\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mDNN\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mevaluate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mX_train\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mY_train\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;36m1\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m     16\u001b[0m         \u001b[0mtest_accuracy\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mi\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mj\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mDNN\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mevaluate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mX_test\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mY_test\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;36m1\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     17\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
      "\u001b[0;31mAttributeError\u001b[0m: 'int' object has no attribute 'evaluate'"
     ]
    }
   ],
   "source": [
    "# optional\n",
    "# visual representation of grid search\n",
    "# uses seaborn heatmap, could probably do this in matplotlib\n",
    "import seaborn as sns\n",
    "\n",
    "sns.set()\n",
    "\n",
    "train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
    "\n",
    "for i in range(len(eta_vals)):\n",
    "    for j in range(len(lmbd_vals)):\n",
    "        DNN = DNN_keras[i][j]\n",
    "\n",
    "        train_accuracy[i][j] = DNN.evaluate(X_train, Y_train)[1]\n",
    "        test_accuracy[i][j] = DNN.evaluate(X_test, Y_test)[1]\n",
    "\n",
    "        \n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(train_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Training Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()\n",
    "\n",
    "fig, ax = plt.subplots(figsize = (10, 10))\n",
    "sns.heatmap(test_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
    "ax.set_title(\"Test Accuracy\")\n",
    "ax.set_ylabel(\"$\\eta$\")\n",
    "ax.set_xlabel(\"$\\lambda$\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<!-- !split  -->\n",
    "## Which activation function should I use?\n",
    "\n",
    "The Back propagation algorithm we derived above works by going from\n",
    "the output layer to the input layer, propagating the error gradient on\n",
    "the way. Once the algorithm has computed the gradient of the cost\n",
    "function with regards to each parameter in the network, it uses these\n",
    "gradients to update each parameter with a Gradient Descent (GD) step.\n",
    "\n",
    "\n",
    "Unfortunately for us, the gradients often get smaller and smaller as the\n",
    "algorithm progresses down to the first hidden layers. As a result, the\n",
    "GD update leaves the lower layer connection weights\n",
    "virtually unchanged, and training never converges to a good\n",
    "solution. This is known in the literature as \n",
    "**the vanishing gradients problem**. \n",
    "\n",
    "In other cases, the opposite can happen, namely the the gradients can grow bigger and\n",
    "bigger. The result is that many of the layers get large updates of the \n",
    "weights the\n",
    "algorithm diverges. This is the **exploding gradients problem**, which is\n",
    "mostly encountered in recurrent neural networks. More generally, deep\n",
    "neural networks suffer from unstable gradients, different layers may\n",
    "learn at widely different speeds\n",
    "\n",
    "<!-- !split  -->\n",
    "## Is the Logistic activation function (Sigmoid)  our choice?\n",
    "\n",
    "Although this unfortunate behavior has been empirically observed for\n",
    "quite a while (it was one of the reasons why deep neural networks were\n",
    "mostly abandoned for a long time), it is only around 2010 that\n",
    "significant progress was made in understanding it.\n",
    "\n",
    "A paper titled [Understanding the Difficulty of Training Deep\n",
    "Feedforward Neural Networks by Xavier Glorot and Yoshua Bengio](http://proceedings.mlr.press/v9/glorot10a.html) found that\n",
    "the problems with the popular logistic\n",
    "sigmoid activation function and the weight initialization technique\n",
    "that was most popular at the time, namely random initialization using\n",
    "a normal distribution with a mean of 0 and a standard deviation of\n",
    "1. \n",
    "\n",
    "They showed that with this activation function and this\n",
    "initialization scheme, the variance of the outputs of each layer is\n",
    "much greater than the variance of its inputs. Going forward in the\n",
    "network, the variance keeps increasing after each layer until the\n",
    "activation function saturates at the top layers. This is actually made\n",
    "worse by the fact that the logistic function has a mean of 0.5, not 0\n",
    "(the hyperbolic tangent function has a mean of 0 and behaves slightly\n",
    "better than the logistic function in deep networks).\n",
    "\n",
    "\n",
    "## The derivative of the Logistic funtion\n",
    "\n",
    "Looking at the logistic activation function, when inputs become large\n",
    "(negative or positive), the function saturates at 0 or 1, with a\n",
    "derivative extremely close to 0. Thus when backpropagation kicks in,\n",
    "it has virtually no gradient to propagate back through the network,\n",
    "and what little gradient exists keeps getting diluted as\n",
    "backpropagation progresses down through the top layers, so there is\n",
    "really nothing left for the lower layers.\n",
    "\n",
    "In their paper, Glorot and Bengio propose a way to significantly\n",
    "alleviate this problem. We need the signal to flow properly in both\n",
    "directions: in the forward direction when making predictions, and in\n",
    "the reverse direction when backpropagating gradients. We don’t want\n",
    "the signal to die out, nor do we want it to explode and saturate. For\n",
    "the signal to flow properly, the authors argue that we need the\n",
    "variance of the outputs of each layer to be equal to the variance of\n",
    "its inputs, and we also need the gradients to have equal variance\n",
    "before and after flowing through a layer in the reverse direction.\n",
    "\n",
    "\n",
    "\n",
    "One of the insights in the 2010 paper by Glorot and Bengio was that\n",
    "the vanishing/exploding gradients problems were in part due to a poor\n",
    "choice of activation function. Until then most people had assumed that\n",
    "if Nature had chosen to use roughly sigmoid activation functions in\n",
    "biological neurons, they must be an excellent choice. But it turns out\n",
    "that other activation functions behave much better in deep neural\n",
    "networks, in particular the ReLU activation function, mostly because\n",
    "it does not saturate for positive values (and also because it is quite\n",
    "fast to compute).\n",
    "\n",
    "\n",
    "## The RELU function family\n",
    "\n",
    "The ReLU activation function suffers from a problem known as the dying\n",
    "ReLUs: during training, some neurons effectively die, meaning they\n",
    "stop outputting anything other than 0.\n",
    "\n",
    "In some cases, you may find that half of your network’s neurons are\n",
    "dead, especially if you used a large learning rate. During training,\n",
    "if a neuron’s weights get updated such that the weighted sum of the\n",
    "neuron’s inputs is negative, it will start outputting 0. When this\n",
    "happen, the neuron is unlikely to come back to life since the gradient\n",
    "of the ReLU function is 0 when its input is negative.\n",
    "\n",
    "To solve this problem, nowadays practitioners use a  variant of the ReLU\n",
    "function, such as the leaky ReLU discussed above or the so-called\n",
    "exponential linear unit (ELU) function"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "$$\n",
    "ELU(z) = \\left\\{\\begin{array}{cc} \\alpha\\left( \\exp{(z)}-1\\right) & z < 0,\\\\  z & z \\ge 0.\\end{array}\\right.\n",
    "$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Which activation function should we use?\n",
    "\n",
    "In general it seems that the ELU activation function is better than\n",
    "the leaky ReLU function (and its variants), which is better than\n",
    "ReLU. ReLU performs better than $\\tanh$ which in turn performs better\n",
    "than the logistic function. \n",
    "\n",
    "If runtime\n",
    "performance is an issue, then you may opt for the  leaky ReLU function  over the \n",
    "ELU function If you don’t\n",
    "want to tweak yet another hyperparameter, you may just use the default\n",
    "$\\alpha$ of $0.01$ for the leaky ReLU, and $1$ for ELU. If you have\n",
    "spare time and computing power, you can use cross-validation or\n",
    "bootstrap to evaluate other activation functions.\n",
    "\n",
    "\n",
    "<!-- !split  -->\n",
    "## A top-down perspective on Neural networks\n",
    "\n",
    "\n",
    "The first thing we would like to do is divide the data into two or three\n",
    "parts. A training set, a validation or dev (development) set, and a\n",
    "test set. The test set is the data on which we want to make\n",
    "predictions. The dev set is a subset of the training data we use to\n",
    "check how well we are doing out-of-sample, after training the model on\n",
    "the training dataset. We use the validation error as a proxy for the\n",
    "test error in order to make tweaks to our model. It is crucial that we\n",
    "do not use any of the test data to train the algorithm. This is a\n",
    "cardinal sin in ML. Then:\n",
    "\n",
    "\n",
    "* Estimate optimal error rate\n",
    "\n",
    "* Minimize underfitting (bias) on training data set.\n",
    "\n",
    "* Make sure you are not overfitting.\n",
    "\n",
    "If the validation and test sets are drawn from the same distributions,\n",
    "then a good performance on the validation set should lead to similarly\n",
    "good performance on the test set. \n",
    "\n",
    "However, sometimes\n",
    "the training data and test data differ in subtle ways because, for\n",
    "example, they are collected using slightly different methods, or\n",
    "because it is cheaper to collect data in one way versus another. In\n",
    "this case, there can be a mismatch between the training and test\n",
    "data. This can lead to the neural network overfitting these small\n",
    "differences between the test and training sets, and a poor performance\n",
    "on the test set despite having a good performance on the validation\n",
    "set. To rectify this, Andrew Ng suggests making two validation or dev\n",
    "sets, one constructed from the training data and one constructed from\n",
    "the test data. The difference between the performance of the algorithm\n",
    "on these two validation sets quantifies the train-test mismatch. This\n",
    "can serve as another important diagnostic when using DNNs for\n",
    "supervised learning.\n",
    "\n",
    "## Limitations of supervised learning with deep networks\n",
    "\n",
    "Like all statistical methods, supervised learning using neural\n",
    "networks has important limitations. This is especially important when\n",
    "one seeks to apply these methods, especially to physics problems. Like\n",
    "all tools, DNNs are not a universal solution. Often, the same or\n",
    "better performance on a task can be achieved by using a few\n",
    "hand-engineered features (or even a collection of random\n",
    "features). \n",
    "\n",
    "Here we list some of the important limitations of supervised neural network based models. \n",
    "\n",
    "\n",
    "\n",
    "* **Need labeled data**. All supervised learning methods, DNNs for supervised learning require labeled data. Often, labeled data is harder to acquire than unlabeled data (e.g. one must pay for human experts to label images).\n",
    "\n",
    "* **Supervised neural networks are extremely data intensive.** DNNs are data hungry. They perform best when data is plentiful. This is doubly so for supervised methods where the data must also be labeled. The utility of DNNs is extremely limited if data is hard to acquire or the datasets are small (hundreds to a few thousand samples). In this case, the performance of other methods that utilize hand-engineered features can exceed that of DNNs.\n",
    "\n",
    "* **Homogeneous data.** Almost all DNNs deal with homogeneous data of one type. It is very hard to design architectures that mix and match data types (i.e. some continuous variables, some discrete variables, some time series). In applications beyond images, video, and language, this is often what is required. In contrast, ensemble models like random forests or gradient-boosted trees have no difficulty handling mixed data types.\n",
    "\n",
    "* **Many problems are not about prediction.** In natural science we are often interested in learning something about the underlying distribution that generates the data. In this case, it is often difficult to cast these ideas in a supervised learning setting. While the problems are related, it is possible to make good predictions with a *wrong* model. The model might or might not be useful for understanding the underlying science.\n",
    "\n",
    "Some of these remarks are particular to DNNs, others are shared by all supervised learning methods. This motivates the use of unsupervised methods which in part circumvent these problems."
   ]
  }
 ],
 "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.8"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}